OpenCores
URL https://opencores.org/ocsvn/usb_fpga_2_14/usb_fpga_2_14/trunk

Subversion Repositories usb_fpga_2_14

[/] [usb_fpga_2_14/] [trunk/] [java/] [ztex/] [Ztex1v1.java] - Rev 2

Compare with Previous | Blame | View Log

/*%
   Java host software API of ZTEX SDK
   Copyright (C) 2009-2017 ZTEX GmbH.
   http://www.ztex.de
 
   This Source Code Form is subject to the terms of the Mozilla Public
   License, v. 2.0. If a copy of the MPL was not distributed with this file,
   You can obtain one at http://mozilla.org/MPL/2.0/.
 
   Alternatively, the contents of this file may be used under the terms
   of the GNU General Public License Version 3, as described below:
 
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License version 3 as
   published by the Free Software Foundation.
 
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
   General Public License for more details.
 
   You should have received a copy of the GNU General Public License
   along with this program; if not, see http://www.gnu.org/licenses/.
%*/
 
/*
    Functions for USB devices with ZTEX descriptor 1, Interface 1
    Interface capabilities and vendor requests (VR) / commands (VC):
    0.0  : EEPROM support
	VR 0x38 : read from EEPROM
	    Returns:
		EEPROM data
	VC 0x39 : write to EEPROM
	VR 0x3a : EEPROM state
	    Returns:
	        Offs	Description
		0-1   	bytes written
		2	checksum
		3	0:idle, 1:busy or error
 
    0.1  : FPGA Configuration
	VR 0x30 : get FPGA state
	    Returns:
	        Offs	Description
		0	1: unconfigured, 0:configured
	        1	checksum
		2-5	transferred bytes
		6  	INIT_B state
		7	Flash configuration result
		8	Flash bitstream bit order (1=swapped)
 
	VC 0x31 : reset FPGA
	VC 0x32 : send FPGA configuration data (Bitstream)
 
    0.2  : Flash memory support
	VR 0x40 : read Flash state
	    Returns:
	        Offs	Description
		0	1:enabled, 0:disabled
		1-2	Sector size <sector size> = MSB==0 : flash_sector_size and 0x7fff ? 1<<(flash_sector_size and 0x7fff)
		3-6	Number of sectors
		7	Error code
	VR 0x41 : read from Flash
	VC 0x42 : write to Flash
    0.3  : Debug helper support
	VR 0x28 : read debug data
	    Returns:
	        Offs	Description
		0-1	number of messages
		2	stack size in messages
		3       message size in bytes
		>=4	message stack
    0.4  : XMEGA support
	VR 0x48 : read XMEGA status information
	    Returns:
	        Offs	Description
		0	error code
                1-2     Flash size in pages
                3-4     EEPROM size in pages
                5	Flash page size as power of two	(e.g. 9 means 512 bytes)
                6	EEPROM page size as power of two
	VC 0x49 : reset XMEGA
	VR 0x4A,0x4B,0x4C,0x4D : read XMEGA NVM using PDI address space / relative to Flash address base / EEPROM address base / Fuse address base
	VC 0x4B,0x4C : write exactly one Flash / EEPROM page
	VC 0x4D : write Fuse
 
    0.5  : High speed FPGA configuration support
	VR 0x33 : Return Endpoint settings
	    Returns:
	        Offs	Description
		0	Endpoint number
		1	Interface number
	VC 0x34 : Start high speed FPGA configuration
	VC 0x35 : Finish high speed FPGA configuration
 
    0.6  : MAC EEPROM support
	VR 0x3B : read from MAC EEPROM
	    Returns:
		MAC EEPROM data
	VC 0x3C : write to MAC EEPROM
	VR 0x3D : MAC EEPROM state
	    Returns:
	        Offs	Description
		0	0:idle, 1:busy or error
 
    0.7  : Multi-FPGA support
	VR 0x50 : Return multi-FPGA information
	    Returns:
	        Offs	Description
	        0	Number of FPGA's - 1
	        1       Selected FPGA - 1 
	        2       Parallel configuration support (0:no, 1:yes)
	VC 0x51 : set CS
	    Parameters:
	        index: Select command
	    	    0 : select single FPGA
	    	    1 : select all FPGA's for configuration
	        value: FPGA to select - 1
 
    1.0  : Temperature sensor
	VR 0x58 : Return temperature data
	    Returns:
	        Offs	Description
	        0	Protocol number
	        1..n    Data
 
    1.1  : Flash 2 support
	VR 0x44 : read Flash state
	    Returns:
	        Offs	Description
		0	1:enabled, 0:disabled
		1-2	Sector size <sector size> = MSB==0 : flash_sector_size and 0x7fff ? 1<<(flash_sector_size and 0x7fff)
		3-6	Number of sectors
		7	Error code
	VR 0x45 : read from Flash
	VC 0x46 : write to Flash
 
    1.2  : FX3 extensions 
	indicates an FX3 firmware
 
    1.3  : Debug helper 2 support
	VR 0x28 : read a debug message given by index (value<<16 | index)
	    Returns:
	        Offs	Description
		0 	Error code (!= 0 if fatal error occurred)
		1..4    Index of last message in buffer
		5..6    Number of messages in buffer
		7..8	Size if the message
		9	Type of the message
		>=10	Message data
	VR 0x29 : returns USB 3.0 errors
	    Returns:
	        Offs	Description
		0..1 	Send errors
		2..3 	Receive errors
 
    1.4  : Default firmware interface
	VC 0x60: Reset 
	VR 0x61: Write/read GPIO's
	    Returns:
	        Offs	Description
	        1	GPIO state (bits 0..3)
	VC 0x62: Write to low speed interface
	VR 0x63: Read from low speed interface
	VR 0x64: Default interface information
	    Returns:
	        Offs	Description
	        1	Version
	        2	Output Endpoint of the high speed interface
	        3	Input Endpoint of the high speed interface
*/
 
package ztex;
 
import java.io.*;
import java.util.*;
import java.nio.*;
 
import org.usb4java.*;
 
/**
  * This class implements the communication protocol of the interface version 1 for the interaction with the ZTEX firmware.
  * <p>
  * The features supported by this interface can be accessed via vendor commands and vendor requests via Endpoint 0.
  * Each feature can be enabled or disabled by the firmware and also depends from the hardware.
  * The presence of a feature is indicated by a 1 in the corresponding feature bit of the ZTEX descriptor 1, see {@link ZtexDevice1}.
  * The following table gives an overview about the features
  * <table bgcolor="#404040" cellspacing=1 cellpadding=10>
  *   <tr>
  *     <td bgcolor="#d0d0d0" valign="bottom"><b>Capability bit</b></td>
  *     <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.0</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *	  EEPROM support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x38</td>
  *           <td bgcolor="#ffffff" valign="top">Read from EEPROM</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x39</td>
  *           <td bgcolor="#ffffff" valign="top">Write to EEPROM</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x3a</td>
  *           <td bgcolor="#ffffff" valign="top">Get EEPROM state. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0-1</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of bytes written.</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">2</td>
  *                 <td bgcolor="#ffffff" valign="top">Checksum</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">3</td>
  *                 <td bgcolor="#ffffff" valign="top">0:idle, 1:busy or error</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *	</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.1</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       FPGA Configuration<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x30</td>
  *           <td bgcolor="#ffffff" valign="top">Get FPGA state. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">1: unconfigured, 0:configured</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1</td>
  *                 <td bgcolor="#ffffff" valign="top">Checksum</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">2-5</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of bytes transferred.</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">6</td>
  *                 <td bgcolor="#ffffff" valign="top">INIT_B states.</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">7</td>
  *                 <td bgcolor="#ffffff" valign="top">Flash configuration result.</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">8</td>
  *                 <td bgcolor="#ffffff" valign="top">Flash Bitstreambit order (1=swapped).</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x31</td>
  *           <td bgcolor="#ffffff" valign="top">Reset FPGA</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x32</td>
  *           <td bgcolor="#ffffff" valign="top">Send Bitstream</td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.2</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       Flash memory support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x40</td>
  *           <td bgcolor="#ffffff" valign="top">Get Flash state. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">1:enabled, 0:disabled</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1-2</td>
  *                 <td bgcolor="#ffffff" valign="top">Sector size</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">3-6</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of sectors</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">7</td>
  *                 <td bgcolor="#ffffff" valign="top">Error code</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x41</td>
  *           <td bgcolor="#ffffff" valign="top">Read one sector from Flash</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x42</td>
  *           <td bgcolor="#ffffff" valign="top">Write one sector to Flash</td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.3</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       Debug helper support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x28</td>
  *           <td bgcolor="#ffffff" valign="top">Get debug data. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0-1</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of the last message</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">2</td>
  *                 <td bgcolor="#ffffff" valign="top">Stack size in messages</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">3</td>
  *                 <td bgcolor="#ffffff" valign="top">Message size in bytes</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">&ge;4</td>
  *                 <td bgcolor="#ffffff" valign="top">Message stack</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.4</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       XMEGA support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x48</td>
  *           <td bgcolor="#ffffff" valign="top">Read XMEGA status information. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">Error code</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1-2</td>
  *                 <td bgcolor="#ffffff" valign="top">Flash size in pages</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">3-4</td>
  *                 <td bgcolor="#ffffff" valign="top">EEPROM sie in pages</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">5</td>
  *                 <td bgcolor="#ffffff" valign="top">Flash page size as power of two	(e.g. 9 means 512 bytes)</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">6</td>
  *                 <td bgcolor="#ffffff" valign="top">EEPROM page size as power of two</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x49</td>
  *           <td bgcolor="#ffffff" valign="top">Reset XMEGA</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VRs 0x4A, 0x4B, 0x4C, 0x4D</td>
  *           <td bgcolor="#ffffff" valign="top">Read XMEGA NVM using PDI address space / relative to Flash address base / EEPROM address base / Fuse address base</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VCs 0x4B, 0x4C</td>
  *           <td bgcolor="#ffffff" valign="top">Write exactly one Flash / EEPROM page</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VCs 0x4D</td>
  *           <td bgcolor="#ffffff" valign="top">Write Fuse</td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.5</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *	  High speed FPGA configuration support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x33</td>
  *           <td bgcolor="#ffffff" valign="top">Read Endpoint settings. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">Endpoint number</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1</td>
  *                 <td bgcolor="#ffffff" valign="top">Interface number</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x34</td>
  *           <td bgcolor="#ffffff" valign="top">Start FPGA configuration</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x35</td>
  *           <td bgcolor="#ffffff" valign="top">Finish FPGA configuration</td>
  *         </tr>
  *       </table>
  *	</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.6</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *	  MAC EEPROM support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x3B</td>
  *           <td bgcolor="#ffffff" valign="top">Read from MAC EEPROM</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x3C</td>
  *           <td bgcolor="#ffffff" valign="top">Write to MAC EEPROM</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x3D</td>
  *           <td bgcolor="#ffffff" valign="top">Get MAC EEPROM state. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">0:idle, 1:busy or error</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *	</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0.7</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *	  Multi-FPGA support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x50</td>
  *           <td bgcolor="#ffffff" valign="top">Return multi-FPGA information:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of FPGA's - 1</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1</td>
  *                 <td bgcolor="#ffffff" valign="top">Selected FPGA - 1</td>
  *               </tr>
  *               <tr>
  *		    <td bgcolor="#ffffff" valign="top">2</td>
  *		    <td bgcolor="#ffffff" valign="top">Parallel configuration support (0:no, 1:yes)</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x51</td>
  *           <td bgcolor="#ffffff" valign="top">Parameters:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Parameter</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">index</td>
  *                 <td bgcolor="#ffffff" valign="top">Select command<br> 0: Select single FPGA <br> 1: Select all FPGA's for configuration</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">value</td>
  *                 <td bgcolor="#ffffff" valign="top">FPGA to select - 1</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *	</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">1.0</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *	  Temperature sensor support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x58</td>
  *           <td bgcolor="#ffffff" valign="top">Return temperature data:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">Protocol</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1..n</td>
  *                 <td bgcolor="#ffffff" valign="top">Data</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *	</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">1.1</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       Flash 2 support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x40</td>
  *           <td bgcolor="#ffffff" valign="top">Get Flash state. Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">1:enabled, 0:disabled</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1-2</td>
  *                 <td bgcolor="#ffffff" valign="top">Sector size</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">3-6</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of sectors</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">7</td>
  *                 <td bgcolor="#ffffff" valign="top">Error code</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x41</td>
  *           <td bgcolor="#ffffff" valign="top">Read one sector from Flash</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x42</td>
  *           <td bgcolor="#ffffff" valign="top">Write one sector to Flash</td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">1.2</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>Indicates an FX3 firmware</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">1.3</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       Debug helper support<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x28</td>
  *           <td bgcolor="#ffffff" valign="top">Read debug message given by index (value<<16 | index) Returns:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">Error code (!= 0 if fatal error occurred)</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1..4</td>
  *                 <td bgcolor="#ffffff" valign="top">Index of last message in buffer</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">5..6</td>
  *                 <td bgcolor="#ffffff" valign="top">Number of messages in buffer</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">7..8</td>
  *                 <td bgcolor="#ffffff" valign="top">Size if the message</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">9</td>
  *                 <td bgcolor="#ffffff" valign="top">Type of the message</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">10..</td>
  *                 <td bgcolor="#ffffff" valign="top">Message data</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x29</td>
  *           <td bgcolor="#ffffff" valign="top">Return USB 3.0 errors
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0..1</td>
  *                 <td bgcolor="#ffffff" valign="top">Send errors</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">2..3</td>
  *                 <td bgcolor="#ffffff" valign="top">Receive errors</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">1.4</td>
  *     <td bgcolor="#ffffff" valign="top" colspan=2>
  *       Default firmware interface<p>
  *       <table bgcolor="#404040" cellspacing=1 cellpadding=6>
  *         <tr>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Vendor request (VR)<br> or command (VC)</b></td>
  *           <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x60</td>
  *           <td bgcolor="#ffffff" valign="top">Reset</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x61</td>
  *           <td bgcolor="#ffffff" valign="top">Read/write GPIO's:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">GPIO state (bits 0..3)</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x62</td>
  *           <td bgcolor="#ffffff" valign="top">Write to low speed interface</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VC 0x63</td>
  *           <td bgcolor="#ffffff" valign="top">Read from low speed interface</td>
  *         </tr>
  *         <tr>
  *           <td bgcolor="#ffffff" valign="top">VR 0x64</td>
  *           <td bgcolor="#ffffff" valign="top">Return Default Interface information:
  *             <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *               <tr>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *                 <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">0</td>
  *                 <td bgcolor="#ffffff" valign="top">Version</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">1</td>
  *                 <td bgcolor="#ffffff" valign="top">Output Endpoint of the high speed interface</td>
  *               </tr>
  *               <tr>
  *                 <td bgcolor="#ffffff" valign="top">2</td>
  *                 <td bgcolor="#ffffff" valign="top">Input Endpoint of the high speed interface</td>
  *               </tr>
  *             </table>
  *           </td>
  *         </tr>
  *       </table>
  *     </td>
  *   </tr>
  * </table>
  * @see ZtexDevice1
  * @see Ztex1
  */
 
public class Ztex1v1 extends Ztex1 {
    /** * Capability index for EEPROM support. */
    public static final int CAPABILITY_EEPROM = 0;
    /** * Capability index for FPGA configuration support. */
    public static final int CAPABILITY_FPGA = 1;
    /** * Capability index for FLASH memory support. */
    public static final int CAPABILITY_FLASH = 2;
    /** * Capability index for DEBUG helper support. */
    public static final int CAPABILITY_DEBUG = 3;
    /** * Capability index for AVR XMEGA support. */
    public static final int CAPABILITY_XMEGA = 4;
    /** * Capability index for AVR XMEGA support. */
    public static final int CAPABILITY_HS_FPGA = 5;
    /** * Capability index for AVR XMEGA support. */
    public static final int CAPABILITY_MAC_EEPROM = 6;
    /** * Capability index for multi FPGA support */
    public static final int CAPABILITY_MULTI_FPGA = 7;
    /** * Capability index for Temperature sensor support */
    public static final int CAPABILITY_TEMP_SENSOR = 8+0;
    /** * Capability index for 2nd FLASH memory support. */
    public static final int CAPABILITY_FLASH2 = 8+1;
    /** * Capability index for FX3 firmware */
    public static final int CAPABILITY_FX3 = 8+2;
    /** * Capability index for debug helper 2 */
    public static final int CAPABILITY_DEBUG2 = 8+3;
    /** * Capability index for default firmware interface */
    public static final int CAPABILITY_DEFAULT = 8+4;
 
    /** * The names of the capabilities */
    public static final String capabilityStrings[] = {
	"EEPROM read/write" ,
	"FPGA configuration" ,
	"Flash memory support",
	"Debug helper",
	"XMEGA support", 
	"High speed FPGA configuration",
	"MAC EEPROM read/write",
	"Multi FPGA support",
 
	"Temperature Sensor support" ,
	"2nd Flash memory support", 
	"FX3 firmware",
	"Debug helper 2",
	"Default firmware interface"
    };
 
    /** * Enables extra FPGA configuration checks. Certain Bistream settings may cause false warnings.  */
    public boolean enableExtraFpgaConfigurationChecks = false;
 
    private boolean fpgaConfigured = false;
    private int fpgaChecksum = 0;
    private int fpgaBytes = 0;
    private int fpgaInitB = 0;
    private int fpgaFlashResult = 255;
    private int fpgaFlash2Result = 255;
    private boolean fpgaFlashBitSwap = false;
 
    /** * Number of bytes written to EEPROM. (Obtained by {@link #eepromState()}.) */
    public int eepromBytes = 0;
    /** * Checksum of the last EEPROM transfer. (Obtained by {@link #eepromState()}.) */
    public int eepromChecksum = 0;
 
    private int flashEnabled = -1;
    private int flashSectorSize = -1;
    private int flashSectors = -1;
 
    private int flash2Enabled = -1;
    private int flash2SectorSize = -1;
    private int flash2Sectors = -1;
 
    /** * Last Flash error code obtained by {@link #flashState()}. See FLASH_EC_* for possible error codes. */
    public int flashEC = 0;
    /** * Last 2nd Flash error code obtained by {@link #flashState()}. See FLASH_EC_* for possible error codes. */
    public int flash2EC = 0;
    /** * Means no error. */
    public static final int FLASH_EC_NO_ERROR = 0;
    /** * Signals an error while attempting to execute a command. */
    public static final int FLASH_EC_CMD_ERROR = 1;
    /** * Signals that a timeout occurred. */
    public static final int FLASH_EC_TIMEOUT = 2;
    /** * Signals that Flash memory it busy. */
    public static final int FLASH_EC_BUSY = 3;
    /** * Signals that another Flash operation is pending. */
    public static final int FLASH_EC_PENDING = 4;
    /** * Signals an error while attempting to read from Flash. */
    public static final int FLASH_EC_READ_ERROR = 5;
    /** * Signals an error while attempting to write to Flash. */
    public static final int FLASH_EC_WRITE_ERROR = 6;
    /** * Signals the installed Flash memory is not supported. */
    public static final int FLASH_EC_NOTSUPPORTED = 7;
    /** * Signals a runtime error of the firmware. */
    public static final int FLASH_EC_RUNTIME = 8;
 
    private int debugStackSize = -1;
    private int debugMsgSize = -1;
    private int debugLastMsg = 0;
    /** * Is set by {@link #debugReadMessages(boolean,byte[])} and contains the number of new messages. */
    public int debugNewMessages = 0;
 
    private int xmegaFlashPages = -1;
    private int xmegaEepromPages = -1;
    private int xmegaFlashPageSize;
    private int xmegaEepromPageSize;
 
    /** * Last ATxmega error code obtained by {@link #xmegaState()}. See XMEGA_EC_* for possible error codes. */
    public int xmegaEC = 0;
    /** * Means no error. */
    public static final int XMEGA_EC_NO_ERROR = 0;
    /** * Signals a PDI read error. */
    public static final int XMEGA_EC_PDI_READ_ERROR = 1;
    /** * Signals that an NVM timeout occurred. */
    public static final int XMEGA_EC_NVM_TIMEOUT = 2;
    /** * Signals that the ATxmega controller is not supported. */
    public static final int XMEGA_EC_INVALID_DEVICE = 3;
    /** * Signals an address error (invalid address or wrong page size). */
    public static final int XMEGA_EC_ADDRESS_ERROR = 4;
    /** * Signals that the NVM is busy. */
    public static final int XMEGA_EC_NVM_BUSY = 5;
 
    private int numberOfFpgas = -1;
    private int selectedFpga = -1;
    private boolean parallelConfigSupport = false;
 
    private long lastTempSensorReadTime = 0;
    private byte[] tempSensorBuf = new byte[9];
    /** * smallest temperature sensor update interval in ms */
    public int tempSensorUpdateInterval = 100;
 
    private int debug2LastIdx = -1;
    private int debug2EC = -1;
    private int debug2Cnt = -1;
    /** * Index of next log entry (messages of type 1 and 2) to be read. */
    public int debug2LogIdx = 0;
    /** * USB 3.0 send error count. This variable is set by {@link #getUsb3Errors()}. */
    public int usb3SndErrors = 0;
    /** * USB 3.0 receive error count. This variable is set by {@link #getUsb3Errors()}. */
    public int usb3RcvErrors = 0;
 
    // default interface stuff
    private int defaultVersion = -1;   // 0 means not present, <0 mean unchecked
    private int defaultSubVersion = -1;
    private int defaultInEP = -1;	
    private int defaultOutEP = -1;
    /** * disable update warnings. */
    public boolean defaultDisableWarnings = false;
    /** * version number of the latest default interface. */
    public final int defaultLatestVersion = 1;
    /** * sub-version number of the latest default interface. */
    public final int defaultLatestSubVersion = 4;
 
/** 
  * The configuration data structure 
  * is initialized if this kind of data is present in MAC EEPROM.
  * In this case MAC EEPROM writes to addresses 0 to 79 are disabled, see {@link #macEepromWrite(int,byte[],int)}.
  * In order to override this behavior set this variable to null.
  * If no configuration data is present {@link #config} is null.
  */ 
    public ConfigData config;
 
// ******* Ztex1v1 *************************************************************
/** 
  * Constructs an instance from a given device.
  * @param pDev The given device.
  * @throws UsbException if an communication error occurred.
  */
    public Ztex1v1 ( ZtexDevice1 pDev ) throws UsbException {
	super ( pDev );
    }
 
// ******* init ****************************************************************
/** 
  * Initializates the class.
  * @throws UsbException if an communication error occurred.
  */
    protected void init () throws UsbException {
	super.init();
	config = new ConfigData ();
	try {
	    if ( ! config.connect( this ) ) 
		config = null;
	}
	catch ( Exception e ) {
	    config = null;
	}
    }
 
// ******* valid ***************************************************************
/** 
  * Returns true if ZTEX interface 1 is available.
  * @return true if ZTEX interface 1 is available.
  */
    public boolean valid ( ) {
	return dev().valid() && dev().interfaceVersion()==1;
    }
 
/** 
  * Returns true if ZTEX interface 1 and capability i.j are available.
  * @param i byte index of the capability
  * @param j bit index of the capability
  * @return true if ZTEX interface 1 and capability i.j are available.
  */
    public boolean valid ( int i, int j) {
	return dev().valid() && dev().interfaceVersion()==1 && dev().interfaceCapabilities(i,j);
    }
 
// ******* compatible **********************************************************
/** 
  * Checks whether the given product ID is compatible to the device corresponding to this class and whether interface 1 is supported.<br>
  * The given product ID is compatible
  * <pre>if ( this.productId(0)==0 || productId0<=0 || this.productId(0)==productId0 ) && 
   ( this.productId(0)==0 || productId1<=0 || this.productId(1)==productId1 ) && 
   ( this.productId(2)==0 || productId2<=0 || this.productId(2)==productId2 ) && 
   ( this.productId(3)==0 || productId3<=0 || this.productId(3)==productId3 ) </pre>
  * @param productId0 Byte 0 of the given product ID
  * @param productId1 Byte 1 of the given product ID
  * @param productId2 Byte 2 of the given product ID
  * @param productId3 Byte 3 of the given product ID
  * @return true if the given product ID is compatible and interface 1 is supported.
  */
    public boolean compatible ( int productId0, int productId1, int productId2, int productId3 ) {
	return dev().valid() && dev().compatible ( productId0, productId1, productId2, productId3 ) && dev().interfaceVersion()==1;
    }
 
// ******* checkValid **********************************************************
/** 
  * Checks whether ZTEX descriptor 1 is available and interface 1 is supported.
  * @throws InvalidFirmwareException if ZTEX descriptor 1 is not available or interface 1 is not supported.
  */
    public void checkValid () throws InvalidFirmwareException {
	super.checkValid();
	if ( dev().interfaceVersion() != 1 )
	    throw new InvalidFirmwareException(this, "Wrong interface: " + dev().interfaceVersion() + ", expected: 1" );
    }
 
// ******* checkCapability *****************************************************
/** 
  * Checks whether ZTEX descriptor 1 is available and interface 1 and a given capability are supported.
  * @param i byte index of the capability
  * @param j bit index of the capability
  * @throws InvalidFirmwareException if ZTEX descriptor 1 is not available or interface 1 is not supported.
  * @throws CapabilityException if the given capability is not supported.
  */
    public void checkCapability ( int i, int j ) throws InvalidFirmwareException, CapabilityException {
	checkValid();
	if ( ! dev().interfaceCapabilities(i,j) ) {
	    int k = i*8 + j;
	    if ( k>=0 && k<capabilityStrings.length )
	    throw new CapabilityException( this, ( k>=0 && k<=capabilityStrings.length ) ? capabilityStrings[k] : ("Capabilty " + i + "," + j) ); 
	}
    }
 
/** 
  * Checks whether ZTEX descriptor 1 is available and interface 1 and a given capability are supported.
  * @param i capability index (0..47)
  * @throws InvalidFirmwareException if ZTEX descriptor 1 is not available or interface 1 is not supported.
  * @throws CapabilityException if the given capability is not supported.
  */
    public void checkCapability ( int i ) throws InvalidFirmwareException, CapabilityException {
	checkCapability(i/8, i%8);
    }
 
// ******* InterfaceCapabilities ***********************************************
/** 
  * Returns interface capability bit.
  * @return interface capability bit.
  * @param i capability index (0..47)
  */
    public boolean InterfaceCapabilities ( int i ) {
	return dev().interfaceCapabilities(i/8, i%8);
    }
 
// ******* checkCompatible *****************************************************
/**
  * Checks whether the given product ID is compatible to the device corresponding to this class and whether interface 1 is supported.
  * See {@link #compatible(int,int,int,int)}.
  * @param productId0 Byte 0 of the given product ID
  * @param productId1 Byte 1 of the given product ID
  * @param productId2 Byte 2 of the given product ID
  * @param productId3 Byte 3 of the given product ID
  * @throws InvalidFirmwareException if the given product ID is not compatible or interface 1 is not supported.
  */
    public void checkCompatible ( int productId0, int productId1, int productId2, int productId3 ) throws InvalidFirmwareException {
	checkValid();
	if ( ! dev().compatible ( productId0, productId1, productId2, productId3 ) )
	    throw new InvalidFirmwareException(this, "Incompatible Product ID");
    }
 
// ******* getFpgaState ********************************************************
    private void getFpgaState () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buffer = new byte[9];
	checkCapability(CAPABILITY_FPGA);
	vendorRequest2(0x30, "getFpgaState", buffer, 9);
	fpgaConfigured = buffer[0] == 0;
	fpgaChecksum = buffer[1] & 0xff;
	fpgaBytes = ((buffer[5] & 0xff)<<24) | ((buffer[4] & 0xff)<<16) | ((buffer[3] & 0xff)<<8) | (buffer[2] & 0xff);
	fpgaInitB = buffer[6] & 0xff;
	fpgaFlashResult = buffer[7];
	fpgaFlashBitSwap = buffer[8] != 0;
    }
 
// ******* printFpgaState ******************************************************
/**
  * Prints out the FPGA state.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public void printFpgaState () throws UsbException, InvalidFirmwareException, CapabilityException {
 
	final String flashResultStr[] = {
	 "Configuration successful",
	 "FPGA already configured",
	 "Flash error",
	 "No bitstream found",
	 "Configuration error"
	};
 
	getFpgaState();
	System.out.println( "size=" + fpgaBytes + ";  checksum=" + fpgaChecksum + "; INIT_B_HIST=" + fpgaInitB +"; flash_configuration_result=" + fpgaFlashResult + 
	  (fpgaFlashResult>=0 && fpgaFlashResult<flashResultStr.length ? " ("+flashResultStr[fpgaFlashResult]+")" : "" ) 
	);
    }
 
// ******* getFpgaConfiguration ************************************************
/**
  * Returns true if the FPGA is configured.
  * @return true if the FPGA is configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public boolean getFpgaConfiguration () throws UsbException, InvalidFirmwareException, CapabilityException {
	getFpgaState ();
	return fpgaConfigured;
    }
 
// ******* getFpgaConfigurationStr *********************************************
/**
  * Returns a string that indicates the FPGA configuration status.
  * @return a string that indicates the FPGA configuration status.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public String getFpgaConfigurationStr () throws UsbException, InvalidFirmwareException, CapabilityException {
	getFpgaState ();
	return fpgaConfigured ? "FPGA configured" : "FPGA unconfigured";
    }
 
// ******* resetFGPA ***********************************************************
/**
  * Resets the FPGA.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public void resetFpga () throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_FPGA);
	vendorCommand(0x31, "resetFpga" );
    }
 
 
// ******* detectBitstreamBitOrder *********************************************
    private int detectBitstreamBitOrder ( byte[] buf ) {
	for ( int i=0; i<buf.length-3; i++ ) {
	    if ( ((buf[i] & 255)==0xaa) && ((buf[i+1] & 255)==0x99) && ((buf[i+2] & 255)==0x55) && ((buf[i+3] & 255)==0x66) )
		return 1;
	    if ( ((buf[i] & 255)==0x55) && ((buf[i+1] & 255)==0x99) && ((buf[i+2] & 255)==0xaa) && ((buf[i+3] & 255)==0x66) )
		return 0;
	} 
	System.err.println("Warning: Unable to determine bitstream bit order: no signature found");
	return 0;
    }
 
// ******* detectBitstreamStart ************************************************
    private int detectBitstreamStart ( byte[] buf ) {
	int l=0;
	for ( int i=0; i<buf.length-3; i++ ) {
	    if ( (l>=4) && ((buf[i+1] & 255)==0x99) && ((buf[i+3] & 255)==0x66) ) {
		if ( ((buf[i] & 255)==0xaa) && ((buf[i+2] & 255)==0x55) )
		    return i-l;
		if ( ((buf[i] & 255)==0x55) && ((buf[i+2] & 255)==0xaa) )
		    return i-l;
	    }
	    l = buf[i]==-1 ? l+1 : 0;
	} 
	System.err.println("Warning: Unable to determine start of raw bitstream");
	return 0;
    }
 
// ******* swapBits ************************************************************
    private void swapBits ( byte[] buf, int length ) {
	for (int i=0; i<length; i++ ) {
	    byte b = buf[i];
	    buf[i] = (byte) ( ((b & 128) >> 7) |
 		     	      ((b &  64) >> 5) |
		     	      ((b &  32) >> 3) |
		     	      ((b &  16) >> 1) |
		     	      ((b &   8) << 1) |
		     	      ((b &   4) << 3) |
		     	      ((b &   2) << 5) |
		     	      ((b &   1) << 7) );
	}
    }
 
// ******* configureFpgaLS *****************************************************
/**
  * Upload a Bitstream to the FPGA using low speed mode.
  * @param inputStream for reading the Bitstream.
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public long configureFpgaLS ( InputStream inputStream, boolean force, int bs ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException {
	final int transactionBytes = 2048;
	long t0 = 0;
 
	checkCapability(CAPABILITY_FPGA);
 
	if ( !force && getFpgaConfiguration() )
	    throw new AlreadyConfiguredException(); 
 
// read the Bitstream file	
        ByteBuffer[] buffers = new ByteBuffer[64*1024*1024/transactionBytes];
        byte[] buf = new byte[transactionBytes]; 
	int size = 0;
	int cs = 0;
	try {
	    int j = transactionBytes;
	    for ( int i=0; i<buffers.length && j==transactionBytes; i++ ) {
		int k;
		j = 0;	
		do {
		    k = inputStream.read( buf, j, transactionBytes-j );
		    if ( k < 0 ) k = 0;
		    j += k;
		}
		while ( j<transactionBytes && k>0 );
 
		if ( j < transactionBytes && j % 64 == 0 )	// ensures size % 64 != 0
		    j+=1;
 
		if ( (i==0) && ( bs<0 || bs>1 ) ) {
		    bs = detectBitstreamBitOrder ( buf );
//		    System.out.println(bs);
		}
 
		if ( bs == 1 ) swapBits(buf, j);
 
		buffers[i] = allocateByteBuffer(buf, 0, j);
 
		for ( k=0; k<j; k++ ) 
		    cs = ( cs + (buf[k] & 0xff) ) & 0xff;
 
		size += j;
	    }
 
	    try {
		inputStream.close();
	    }
	    catch ( Exception e ) {
	    }
	}
	catch (IOException e) {
	    throw new BitstreamReadException(e.getLocalizedMessage());
	}
	if ( size < 64 || size % 64 == 0 ) 
	    throw new BitstreamReadException("Invalid file size: " + size );
 
 
// upload the Bitstream file	
	for ( int tries=10; tries>0; tries-- ) {
 
	    resetFpga();
 
	    try {
		t0 = -new Date().getTime();
		bs = 0;
 
	    	for ( int i=0; i<buffers.length && i*transactionBytes < size; i++ ) {
		    int j = size-i*transactionBytes;
		    if (j>transactionBytes) 
			j = transactionBytes;
		    vendorCommand2(0x32, "sendFpgaData", 0,0, buffers[i]);
		    bs+=j;
		}
 
 		getFpgaState();
//		System.err.println("fpgaConfigred=" + fpgaConfigured + "   fpgaBytes="+fpgaBytes + " ("+bs+")   fpgaChecksum="+fpgaChecksum + " ("+cs+")   fpgaInitB="+fpgaInitB );
		if ( ! fpgaConfigured ) {
		    throw new BitstreamUploadException( "FPGA configuration failed: DONE pin does not go high (size=" + fpgaBytes + " ,  " + (bs - fpgaBytes) + " bytes got lost;  checksum=" 
			+ fpgaChecksum + " , should be " + cs + ";  INIT_B_HIST=" + fpgaInitB +")" );
		}
		if ( enableExtraFpgaConfigurationChecks ) {
	    	    if ( fpgaBytes!=0 && fpgaBytes!=bs )
			System.err.println("Warning: Possible FPGA configuration data loss: " + (bs - fpgaBytes) + " bytes got lost");
		    if ( fpgaInitB!=222 )
			System.err.println("Warning: Possible Bitstream CRC error: INIT_B_HIST=" + fpgaInitB );
		}
//		System.out.println( "FPGA configuration: size=" + fpgaBytes + " ,  " + (bs - fpgaBytes) + " bytes got lost;  checksum=" + fpgaChecksum + " , should be " + cs + ";  INIT_B_HIST=" + fpgaInitB );
 
		tries = 0;
		t0 += new Date().getTime();
 
	    } 
	    catch ( BitstreamUploadException e ) {
		if ( tries>1 ) 
		    System.err.println("Warning: " + e.getLocalizedMessage() +": Retrying it ...");
		else 
		    throw e;
	    }
	}
 
    	try {
    	    Thread.sleep( 100 );
    	}
	catch ( InterruptedException e) {
        } 
 
	return t0;
    } 
 
 
/**
  * Upload a Bitstream to the FPGA using low speed mode.
  * @param fwFileName The file name of the Bitstream. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public long configureFpgaLS ( String fwFileName, boolean force, int bs ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException {
	try {
	    return configureFpgaLS( JInputStream.getInputStream( fwFileName ), force, bs );
	}
	catch (IOException e) {
	    throw new BitstreamReadException(e.getLocalizedMessage());
	}
    }
 
// ******* eepromState *********************************************************
// returns true if EEPROM is ready
/**
  * Reads the current EEPROM status.
  * This method also sets the varibles {@link #eepromBytes} and {@link #eepromChecksum}.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @return true if EEPROM is ready.
  */
    public boolean eepromState ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[4];
	checkCapability(CAPABILITY_EEPROM);
	vendorRequest2(0x3A, "EEPROM State", 0, 0, buf, 4);
	eepromBytes = (buf[0] & 255) | (buf[1] & 255)<<8;
	eepromChecksum = buf[2] & 255;
	return buf[3] == 0;
    }
 
// ******* eepromWrite *********************************************************
/**
  * Writes data to the EEPROM.
  * @param addr The destination address of the EEPROM.
  * @param buf The data.
  * @param length The amount of bytes to be sent.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  */
    public void eepromWrite ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_EEPROM);
	if ( (addr & 63) != 0 ) {
	    int i = Math.min(length, 64-(addr & 63));
	    vendorCommand2( 0x39, "EEPROM Write", addr, 0, buf, i );
    	    try {
    		Thread.sleep( 10 );
	    }
	    catch ( InterruptedException e) {
    	    } 
    	    addr+=i;
    	    length-=i;
    	    if ( length > 0 ) {
    		byte[] buf2 = new byte[length];
    		for (int j=0; j<length; j++ ) 
    		    buf2[j] = buf[i+j];
    		vendorCommand2( 0x39, "EEPROM Write", addr, 0, buf2, length );
    	    }
	}
	else {
	    vendorCommand2( 0x39, "EEPROM Write", addr, 0, buf, length );
	}
 
        try {
		Thread.sleep( 10 );
	}
	    catch ( InterruptedException e) {
    	} 
    }
 
// ******* eepromRead **********************************************************
/**
  * Reads data from the EEPROM.
  * @param addr The source address of the EEPROM.
  * @param buf A buffer for the storage of the data.
  * @param length The amount of bytes to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  */
    public void eepromRead ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_EEPROM);
	vendorRequest2( 0x38, "EEPROM Read", addr, 0, buf, length );		// sometimes a little bit slow
    	try {
    	    Thread.sleep( 10 );
    	}
	catch ( InterruptedException e) {
        } 
    }
 
 
// ******* eepromUploadFirmware ********************************************************
//  returns upload time in ms
/**
  * Upload the firmware to the EEPROM.
  * In order to start the uploaded firmware the device must be reset.
  * @param imgFile The firmware image.
  * @param force Skips the compatibility check if true.
  * @throws IncompatibleFirmwareException if the given firmware is not compatible to the installed one, see {@link #compatible(int,int,int,int)} (Upload can be enforced using the <tt>force</tt> parameter.)
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to upload the firmware.
  */
    private long eepromUploadFirmware ( ImgFile imgFile, boolean force ) throws IncompatibleFirmwareException, FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	final int pagesMax = 256;
	final int pageSize = 256;
	int pages = 0;
	byte[][] buffer = new byte[pagesMax][];
 
	checkCapability(CAPABILITY_EEPROM);
 
//	imgFile.dataInfo(System.out);
//	System.out.println(imgFile);
 
// check for compatibility
	if ( (imgFile instanceof ZtexImgFile1) && (!force) && dev().valid() ) {
	    if ( ((ZtexImgFile1)imgFile).interfaceVersion() != 1 )
		throw new IncompatibleFirmwareException("Wrong interface version: Expected 1, got " + ((ZtexImgFile1)imgFile).interfaceVersion() );
 
	    if ( ! dev().compatible ( ((ZtexImgFile1)imgFile).productId(0), ((ZtexImgFile1)imgFile).productId(1), ((ZtexImgFile1)imgFile).productId(2), ((ZtexImgFile1)imgFile).productId(3) ) )
		throw new IncompatibleFirmwareException("Incompatible productId's: Current firmware: " + ZtexDevice1.byteArrayString(dev().productId()) 
		    + "  Img File: " + ZtexDevice1.byteArrayString(((ZtexImgFile1)imgFile).productId()) );
	}
 
	int vid = dev().usbVendorId();
	int pid = dev().usbProductId();
 
	buffer[0] = new byte[pageSize];
	buffer[0][0] = (byte) 0xc2;
	buffer[0][1] = (byte) (vid & 255);
	buffer[0][2] = (byte) ((vid >> 8) & 255);
	buffer[0][3] = (byte) (pid & 255);
	buffer[0][4] = (byte) ((pid >> 8) & 255);
	buffer[0][5] = 0;
	buffer[0][6] = 0;
	buffer[0][7] = 65;
 
	int ptr = 8, i = 0;
 
	while ( i < imgFile.data.length ) {
	    if ( imgFile.data[i]>=0 && imgFile.data[i]<256 ) {			// new data block
		int j = 1;
		while ( i+j<imgFile.data.length && imgFile.data[i+j]>=0 && imgFile.data[i+j]<256 ) 
		    j++;
 
		for (int k=ptr/pageSize + 1; k < (ptr+j+9)/pageSize + 1; k++ )	// also considers 5 bytes for the last data block
		    buffer[k] = new byte[pageSize];
 
		buffer[(ptr+0)/pageSize][(ptr+0) % pageSize] = (byte) ((j >> 8) & 255);	
		buffer[(ptr+1)/pageSize][(ptr+1) % pageSize] = (byte) (j & 255);		// length
		buffer[(ptr+2)/pageSize][(ptr+2) % pageSize] = (byte) ((i >> 8) & 255);
		buffer[(ptr+3)/pageSize][(ptr+3) % pageSize] = (byte) (i & 255);		// address
		ptr+=4;
		for ( int k=0; k<j; k++ )  					// data
		    buffer[(ptr+k)/pageSize][(ptr+k) % pageSize] = (byte) imgFile.data[i+k];
		ptr+=j;
		i+=j;
	    }
	    else {
		i+=1;
	    }
	}
 
	buffer[(ptr+0)/pageSize][(ptr+0) % pageSize] = (byte) 0x80;		// last data block
	buffer[(ptr+1)/pageSize][(ptr+1) % pageSize] = (byte) 0x01;
	buffer[(ptr+2)/pageSize][(ptr+2) % pageSize] = (byte) 0xe6;
	buffer[(ptr+3)/pageSize][(ptr+3) % pageSize] = (byte) 0x00;
	buffer[(ptr+3)/pageSize][(ptr+4) % pageSize] = (byte) 0x00;
	ptr+=5;
 
 
	long t0 = new Date().getTime();
	byte[] rbuf = new byte[pageSize];
 
	for ( i=(ptr-1)/pageSize; i>=0; i-- ) {
 
	    int k = (i+1)*pageSize < ptr ? pageSize : ptr-i*pageSize;
	    int cs = 0;
	    for (int j=0; j<k; j++ ) {
		cs = ( cs + (buffer[i][j] & 255) ) & 255;
	    }
 
	    for ( int tries=3; tries>0; tries-- ) {
	    	try {
		    eepromWrite(i*pageSize, buffer[i], k);
		    eepromState();
		    if ( eepromBytes!=k )
			throw new FirmwareUploadException("Error writing data to EEPROM: Wrote " + eepromBytes + " bytes instead of "  + k + " bytes" );
		    if ( eepromChecksum!=cs )
			throw new FirmwareUploadException("Error writing data to EEPROM: Checksum error");
 
    		    eepromRead(i*pageSize, rbuf, k);
		    for (int j=0; j<k; j++ ) {
			if ( rbuf[j] != buffer[i][j] )
			    throw new FirmwareUploadException("Error writing data to EEPROM: Verification failed");
		    }
		    tries = 0;
		}
		catch ( Exception e ) {
		    if ( tries > 1 ) {
			System.err.println("Warning: " + e.getLocalizedMessage() +": Retrying it ...");
		    }
		    else {
			throw new FirmwareUploadException(e.getLocalizedMessage());
		    }
		}
	    } 
	}
 
	return new Date().getTime() - t0;
    }
 
 
// ******* nvUploadFirmware ********************************************************
/**
  * Upload the firmware to the non-volatile memory.
  * In order to start the uploaded firmware the device must be reset.
  * @param imgFile The firmware image.
  * @param force Skips the compatibility check if true.
  * @return Upload time in ms.
  * @throws IncompatibleFirmwareException if the given firmware is not compatible to the installed one, see {@link #compatible(int,int,int,int)} (Upload can be enforced using the <tt>force</tt> parameter.)
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to upload the firmware.
  * @see #nvDisableFirmware()
  */
    public long nvUploadFirmware ( ImgFile imgFile, boolean force ) throws IncompatibleFirmwareException, FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	return dev().fx3() ? flashUploadFirmware(imgFile, force) : eepromUploadFirmware(imgFile, force);
    }
 
/**
  * @deprecated Replaced by {@link #nvUploadFirmware(ZtexImgFile1,boolean)}
  */
    @Deprecated public long eepromUpload ( ImgFile imgFile, boolean force ) throws IncompatibleFirmwareException, FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	return nvUploadFirmware(imgFile,force);
    }
 
//  returns upload time in ms
/**
  * Upload the firmware to the non-volatile memory.
  * In order to start the uploaded firmware the device must be reset.
  * @param imgFileName The file name of the firmware image in ihx or img format. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @param force Skips the compatibility check if true.
  * @return Upload time in ms.
  * @throws IncompatibleFirmwareException if the given firmware is not compatible to the installed one, see {@link #compatible(int,int,int,int)} (Upload can be enforced using the <tt>force</tt> parameter.)
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to upload the firmware.
  * @see #nvDisableFirmware()
  */
    public long nvUploadFirmware ( String imgFileName, boolean force ) throws IncompatibleFirmwareException, FirmwareUploadException, InvalidFirmwareException, CapabilityException {
// load the firmware file
	ImgFile imgFile;
	try {
	    try {
		imgFile = new ZtexImgFile1( imgFileName );
	    }
	    catch ( IncompatibleFirmwareException e ) {
		if ( !force ) throw e;
		imgFile = new ImgFile( imgFileName );
	    }
	}
	catch ( IOException e ) {
	    throw new FirmwareUploadException( e.getLocalizedMessage() );
	}
	catch ( ImgFileDamagedException e ) {
	    throw new FirmwareUploadException( e.getLocalizedMessage() );
	}
 
	return nvUploadFirmware( imgFile, force );
    }
 
/**
  * @deprecated Replaced by {@link #nvUploadFirmware(String,boolean)}
  */
    @Deprecated public long eepromUpload ( String imgFileName, boolean force ) throws IncompatibleFirmwareException, FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	return nvUploadFirmware(imgFileName,force);
    }
 
 
// ******* eepromDisable ********************************************************
/**
  * Disables the firmware stored in the EEPROM.
  * This is achived by writing a "0" to the address 0 of the EEPROM.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to disable the firmware.
  */
    private void eepromDisableFirmware ( ) throws FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	byte[] buf = { 0 };
 
	for ( int tries=3; tries>0; tries-- ) {
	    try {
	        eepromWrite(0, buf, 1);
 
    		eepromRead(0, buf, 1);
		if ( buf[0] != 0 )
		    throw new FirmwareUploadException("Error disabling EEPROM firmware: Verification failed");
		tries = 0;
 
    	    }
	    catch ( Exception e ) {
	        if ( tries > 1 ) {
	    	    System.err.println("Warning: " + e.getLocalizedMessage() +": Retrying it ...");
		}
		else {
		    throw new FirmwareUploadException(e.getLocalizedMessage());
		}
	    } 
	}
    } 
 
/**
  * @deprecated Replaced by {@link #nvDisableFirmware()}
  */
    @Deprecated public void eepromDisable ( ) throws FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	nvDisableFirmware();
    }
 
// ******* nvDisableFirmware ***************************************************
/**
  * Disables the firmware stored in the non-volatile memory.
  * This is achived by writing a "0" to the address 0 of the memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to disable the firmware.
  */
    public void nvDisableFirmware ( ) throws FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	if ( dev().fx3() ) {
	    flashDisableFirmware();
	} 
	else {
	     eepromDisableFirmware();
	}
    }
 
 
// ******* flashStrError *******************************************************
/** 
  * Converts a given error code into a String.
  * @param errNum The error code.
  * @return an error message.
  */
    public static String flashStrError ( int errNum ) {
	switch ( errNum ) {
	    case FLASH_EC_NO_ERROR:
		return "USB error";
	    case FLASH_EC_CMD_ERROR:
		return "Command error";
	    case FLASH_EC_TIMEOUT:
		return "Timeout error";
	    case FLASH_EC_BUSY:
		return "Busy";
	    case FLASH_EC_PENDING:
		return "Another operation is pending";
	    case FLASH_EC_READ_ERROR:
		return "Read error";
	    case FLASH_EC_WRITE_ERROR:
		return "Write error";
	    case FLASH_EC_NOTSUPPORTED:
		return "Not supported";
	    case FLASH_EC_RUNTIME:
		return "Firmware runtime error";
	}
	return "Error " + errNum;
    }
 
/** 
  * Gets the last Flash error from the device.
  * @return an error message.
  */
    public String flashStrError ( ) {
	try {
	    return flashStrError( getFlashEC() );
	}
	catch ( Exception e ) {
	    return "Unknown error (Error receiving errorcode: "+e.getLocalizedMessage() +")";
	}
    }
 
/** 
  * Gets the last 2nd Flash error from the device.
  * @return an error message.
  */
    public String flash2StrError ( ) {
	try {
	    return flashStrError( getFlash2EC() );
	}
	catch ( Exception e ) {
	    return "Unknown error (Error receiving errorcode: "+e.getLocalizedMessage() +")";
	}
    }
 
// ******* flashState **********************************************************
/**
  * Reads the the Flash memory status and information.
  * This method also sets the variables {@link #flashEnabled()}, {@link #flashSectorSize()} and {@link #flashSectors()}.
  * @return true if Flash memory is installed.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public boolean flashState () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[8];
	checkCapability(CAPABILITY_FLASH);
 
	// device may be busy due to initialization, we try it up to up to 4s
	vendorRequest2(0x40, "Flash State", 0, 0, buf, 8);
    	flashEC = buf[7] & 255;
	int tries=20;	
	while ( flashEC==FLASH_EC_BUSY && tries>0 )
	{
	    try {
    		Thread.sleep( 200 );
    	    }
	    catch ( InterruptedException e) {
    	    } 
	    tries-=1;
	    vendorRequest2(0x40, "Flash State", 0, 0, buf, 8);
    	    flashEC = buf[7] & 255;
	}
	flashEnabled = buf[0] & 255;
	flashSectorSize = flashEnabled == 1 ? ((buf[2] & 255) << 8) | (buf[1] & 255) : 0;
	if ( (flashSectorSize & 0x8000) != 0 ) 
	    flashSectorSize = 1 << (flashSectorSize & 0x7fff);
	flashSectors = flashEnabled == 1 ? ((buf[6] & 255) << 24) | ((buf[5] & 255) << 16) | ((buf[4] & 255) << 8) | (buf[3] & 255) : 0;
	return flashEnabled == 1;
    }
 
// ******* flash2State *********************************************************
/**
  * Reads the the 2nd Flash memory status and information.
  * This method also sets the variables {@link #flash2Enabled()}, {@link #flash2SectorSize()} and {@link #flash2Sectors()}.
  * @return true if 2nd Flash memory is installed.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not supported by the firmware.
  */
    public boolean flash2State () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[8];
	checkCapability(CAPABILITY_FLASH2);
 
	// device may be busy due to initialization, we try it up to up to 4s
	vendorRequest2(0x44, "Flash 2 State", 0, 0, buf, 8);
    	flash2EC = buf[7] & 255;
	int tries=20;	
	while ( flash2EC==FLASH_EC_BUSY && tries>0 )
	{
	    try {
    		Thread.sleep( 200 );
    	    }
	    catch ( InterruptedException e) {
    	    } 
	    tries-=1;
	    vendorRequest2(0x44, "Flash 2 State", 0, 0, buf, 8);
    	    flash2EC = buf[7] & 255;
	}
	flash2Enabled = buf[0] & 255;
	flash2SectorSize = flash2Enabled == 1 ? ((buf[2] & 255) << 8) | (buf[1] & 255) : 0;
	if ( (flash2SectorSize & 0x8000) != 0 ) 
	    flash2SectorSize = 1 << (flash2SectorSize & 0x7fff);
	flash2Sectors = flash2Enabled == 1 ? ((buf[6] & 255) << 24) | ((buf[5] & 255) << 16) | ((buf[4] & 255) << 8) | (buf[3] & 255) : 0;
	return flash2Enabled == 1;
    }
 
// ******* getFlashEC **********************************************************
// reads the current error code
/**
  * Gets the last Flash error from the device.
  * @return The last error code.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public int getFlashEC () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[8];
	checkCapability(CAPABILITY_FLASH);
	vendorRequest2(0x40, "Flash State", 0, 0, buf, 8);
    	flashEC = buf[7] & 255;
	return flashEC;
    }
 
// ******* getFlash2EC *********************************************************
// reads the current error code
/**
  * Gets the last 2nd Flash memory error from the device.
  * @return The last error code.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not supported by the firmware.
  */
    public int getFlash2EC () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[8];
	checkCapability(CAPABILITY_FLASH2);
	vendorRequest2(0x44, "Flash 2 State", 0, 0, buf, 8);
    	flash2EC = buf[7] & 255;
	return flash2EC;
    }
 
 
// ******* flashReadSector ****************************************************
// read a integer number of sectors
/**
  * Reads a integer number of sectors from the Flash.
  * @param sector The number of the first sector to be read.
  * @param num The number of sectors to be read.
  * @param buf A buffer for the storage of the data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is to small.
  */
    public void flashReadSector ( int sector, int num, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException  {
	if ( num<1 ) return;
 
	if ( buf.length < flashSectorSize() ) 
	    throw new IndexOutOfBoundsException( "Buffer is to small: " + buf.length + " < " + (num*flashSectorSize()) );
 
	checkCapability(CAPABILITY_FLASH);
	if ( ! flashEnabled() )
	    throw new CapabilityException(this, "No Flash memory installed or");
 
	try {
	    if ( flashSectorSize()>2048 ) {
		byte[] buf2 = new byte[2048];
		int iz = (flashSectorSize-1) >> 11;
		for (int sn=0; sn<num; sn++ ) {
		    for (int i=0; i<iz; i++) {
//			System.out.println("r: "+i);
			vendorRequest2( 0x41, "Flash Read", sector, i==0 ? 0 : 256, buf2, 2048 );
			System.arraycopy(buf2,0, buf, sn*flashSectorSize + i*2048, 2048);
		    }
		    int len = flashSectorSize-iz*2048;
		    vendorRequest2( 0x41, "Flash Read", sector, 512, buf2,  len);
		    System.arraycopy(buf2,0, buf, sn*flashSectorSize + iz*2048, len);
		}
	    }
	    else {
		int nz = Math.max(1, 2048 / flashSectorSize);
		byte[] buf2 = new byte[nz * flashSectorSize];
		int bp = 0;
		while ( num>0 ) {
		    int n2 = Math.min(num,nz);
		    vendorRequest2( 0x41, "Flash Read", sector, sector >> 16, buf2, flashSectorSize*n2 );
		    System.arraycopy(buf2,0, buf, bp, flashSectorSize*n2);
		    bp += flashSectorSize*n2;
		    sector += n2;
		}
	    }
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "Flash Read: " + flashStrError() ); 
	}
    }
 
// read one sector
/**
  * Reads one sector from the Flash.
  * @param sector The sector number to be read.
  * @param buf A buffer for the storage of the data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is smaller than the Flash sector size.
  */
    public void flashReadSector ( int sector, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException  {
	flashReadSector ( sector, 1, buf );
    }
 
// ******* flash2ReadSector ***************************************************
// read a integer number of sectors
/**
  * Reads a integer number of sectors from the 2nd Flash memory.
  * @param sector The number of the first sector to be read.
  * @param num The number of sectors to be read.
  * @param buf A buffer for the storage of the data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is to small.
  */
    public void flash2ReadSector ( int sector, int num, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException  {
	if ( num<1 ) return;
 
	if ( buf.length < flash2SectorSize() ) 
	    throw new IndexOutOfBoundsException( "Buffer is to small: " + buf.length + " < " + (num*flash2SectorSize()) );
 
	checkCapability(CAPABILITY_FLASH2);
	if ( ! flash2Enabled() )
	    throw new CapabilityException(this, "No 2nd Flash installed or");
 
	try {
	    if ( flash2SectorSize()>2048 ) {
		byte[] buf2 = new byte[2048];
		int iz = (flash2SectorSize-1) >> 11;
		for (int sn=0; sn<num; sn++ ) {
		    for (int i=0; i<iz; i++) {
//			System.out.println("r: "+i);
			vendorRequest2( 0x45, "Flash 2 Read", sector, i==0 ? 0 : 256, buf2, 2048 );
			System.arraycopy(buf2,0, buf, sn*flash2SectorSize + i*2048, 2048);
		    }
		    int len = flash2SectorSize-iz*2048;
		    vendorRequest2( 0x45, "Flash 2 Read", sector, 512, buf2,  len);
		    System.arraycopy(buf2,0, buf, sn*flash2SectorSize + iz*2048, len);
		}
	    }
	    else {
		int nz = Math.max(1, 2048 / flash2SectorSize);
		byte[] buf2 = new byte[nz * flash2SectorSize];
		int bp = 0;
		while ( num>0 ) {
		    int n2 = Math.min(num,nz);
		    vendorRequest2( 0x45, "Flash 2 Read", sector, sector >> 16, buf2, flash2SectorSize*n2 );
		    System.arraycopy(buf2,0, buf, bp, flash2SectorSize*n2);
		    bp += flash2SectorSize*n2;
		    sector += n2;
		    num -= n2;
		}
	    }
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "Flash 2 Read: " + flash2StrError() ); 
	}
    }
 
// read one sector
/**
  * Reads one sector from the 2nd Flash memory.
  * @param sector The sector number to be read.
  * @param buf A buffer for the storage of the data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is smaller than the 2nd Flash sector size.
  */
    public void flash2ReadSector ( int sector, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException  {
	flash2ReadSector ( sector, 1, buf );
    }
 
 
// ******* flashWriteSector ***************************************************
// write integer number of sectors
/**
  * Writes a integer number of sectors to the Flash.
  * @param sector The sector number to be written.
  * @param num The number of sectors to be read.
  * @param buf The data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is to small.
  */
    public void flashWriteSector ( int sector, int num, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	if ( num<1 ) return;
 
	if ( buf.length < flashSectorSize()*num ) 
	    throw new IndexOutOfBoundsException( "Buffer to small: " + buf.length + " < " + (num*flashSectorSize()));
 
	checkCapability(CAPABILITY_FLASH);
	if ( ! flashEnabled() )
	    throw new CapabilityException(this, "No Flash memory installed or");
 
	int oto = controlMsgTimeout;
	controlMsgTimeout = 5000; // 5s timeout
 
	try {
	    if ( flashSectorSize()>2048 ) {
	        byte[] buf2 = new byte[2048];
	        int iz = (flashSectorSize-1) >> 11;
		for (int sn=0; sn<num; sn++ ) {
 
		    controlMsgTimeout = 12000; // 12s timeout for erase
 
		    System.arraycopy(buf,sn*flashSectorSize, buf2,0, 2048);
		    vendorCommand2( 0x42, "Flash Write", sector, 0, buf, 2048 );
 
		    controlMsgTimeout = 5000;
 
		    for (int i=1; i<iz; i++) {
//			System.out.println("w: "+i);
			System.arraycopy(buf,sn*flashSectorSize+i*2048, buf2,0, 2048);
		        vendorCommand2( 0x42, "Flash Write", sector, 256, buf2, 2048 );
		    }
 
		    int len = flashSectorSize-iz*2048;
		    System.arraycopy(buf,sn*flashSectorSize+iz*2048, buf2,0, len);
	    	    vendorCommand2( 0x42, "Flash Write", sector, 512, buf2, len );
	    	}
	    }
	    else {
		int nz = Math.max(1, 2048 / flashSectorSize);
		byte[] buf2 = new byte[nz * flashSectorSize];
		int bp = 0;
		while ( num>0 ) {
		    int n2 = Math.min(num,nz);
		    System.arraycopy(buf,bp, buf2,0, flashSectorSize*n2);
		    vendorCommand2( 0x41, "Flash Write", sector, sector >> 16, buf2, flashSectorSize*n2 );
		    bp += flash2SectorSize*n2;
		    sector += n2;
		    num -= n2;
		}
	    }
	}
	catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "Flash Write: " + flashStrError() );
	}
 
	controlMsgTimeout = oto;
    }
 
/**
  * Writes one sector to the Flash.
  * @param sector The sector number to be written.
  * @param buf The data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is smaller than the Flash sector size.
  */
    public void flashWriteSector ( int sector, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	flashWriteSector(sector,1,buf);
    }
 
// ******* flash2WriteSector **************************************************
// write integer number of sectors
/**
  * Writes a integer number of sectors to the 2nd Flash.
  * @param sector The sector number to be written.
  * @param num The number of sectors to be read.
  * @param buf The data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is to small.
  */
    public void flash2WriteSector ( int sector, int num, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	if ( num<1 ) return;
 
	if ( buf.length < flash2SectorSize()*num ) 
	    throw new IndexOutOfBoundsException( "Buffer to small: " + buf.length + " < " + (num*flash2SectorSize()));
 
	checkCapability(CAPABILITY_FLASH2);
	if ( ! flash2Enabled() )
	    throw new CapabilityException(this, "No 2nd Flash memory installed or");
 
	int oto = controlMsgTimeout;
	controlMsgTimeout = 5000; // 5s timeout
 
	try {
	    if ( flash2SectorSize()>2048 ) {
	        byte[] buf2 = new byte[2048];
	        int iz = (flash2SectorSize-1) >> 11;
		for (int sn=0; sn<num; sn++ ) {
 
		    controlMsgTimeout = 12000; // 12s timeout for erase
 
		    System.arraycopy(buf,sn*flash2SectorSize, buf2,0, 2048);
		    vendorCommand2( 0x46, "Flash 2 Write", sector, 0, buf, 2048 );
 
		    controlMsgTimeout = 5000;
 
		    for (int i=1; i<iz; i++) {
//			System.out.println("w: "+i);
			System.arraycopy(buf,sn*flash2SectorSize+i*2048, buf2,0, 2048);
		        vendorCommand2( 0x46, "Flash 2 Write", sector, 256, buf2, 2048 );
		    }
 
		    int len = flash2SectorSize-iz*2048;
		    System.arraycopy(buf,sn*flash2SectorSize+iz*2048, buf2,0, len);
	    	    vendorCommand2( 0x46, "Flash 2 Write", sector, 512, buf2, len );
	    	}
	    }
	    else {
		int nz = Math.max(1, 2048 / flash2SectorSize);
		byte[] buf2 = new byte[nz * flash2SectorSize];
		int bp = 0;
		while ( num>0 ) {
		    int n2 = Math.min(num,nz);
		    System.arraycopy(buf,bp, buf2,0, flash2SectorSize*n2);
		    vendorCommand2( 0x46, "Flash 2 Write", sector, sector >> 16, buf2, flash2SectorSize*n2 );
		    bp += flash2SectorSize*n2;
		    sector += n2;
		    num -= n2;
		}
	    }
	}
	catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "Flash 2 Write: " + flash2StrError() );
	}
 
	controlMsgTimeout = oto;
    }
 
// write one sector
/**
  * Writes one sector to the 2nd Flash memory.
  * @param sector The sector number to be written.
  * @param buf The data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash access is not possible.
  * @throws IndexOutOfBoundsException If the buffer is smaller than the 2nd Flash sector size.
  */
    public void flash2WriteSector ( int sector, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	flash2WriteSector(sector,1,buf);
    }
 
// ******* flashEnabled ********************************************************
// returns enabled / disabled state 
/**
  * Returns true if Flash memory is installed.
  * @return true if Flash memory is installed.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public boolean flashEnabled () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( flashEnabled < 0 ) // init variable
	    flashState();
	return flashEnabled == 1;
    }
 
// ******* flash2Enabled *******************************************************
// returns enabled / disabled state 
/**
  * Returns true if 2nd Flash memory is installed.
  * @return true if 2nd Flash memory is installed.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not supported by the firmware.
  */
    public boolean flash2Enabled () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( flash2Enabled < 0 ) // init variable
	    flash2State();
	return flash2Enabled == 1;
    }
 
// ******* flashSectorSize *****************************************************
// returns sector size of Flash memory, if available
/**
  * Returns the sector size of the Flash memory or 0, if no Flash is installed.
  * If required, the sector size is determined form the device first.
  * @return the sector size of the Flash memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public int flashSectorSize () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( flashSectorSize < 0 ) // init variable
	    flashState();
	return flashSectorSize;
    }
 
// ******* flash2SectorSize ****************************************************
// returns sector size of Flash 2 memory, if available
/**
  * Returns the sector size of the 2nd Flash memory or 0, if no 2nd Flash is installed.
  * If required, the sector size is determined form the device first.
  * @return the sector size of the 2nd Flash.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash access is not supported by the firmware.
  */
    public int flash2SectorSize () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( flash2SectorSize < 0 ) // init variable
	    flash2State();
	return flash2SectorSize;
    }
 
// ******* flashSectors ********************************************************
// returns number of sectors of Flash memory, if available
/**
  * Returns the number of sectors of the Flash memory or 0, if no Flash memory is installed.
  * If required, the number of sectors is determined form the device first.
  * @return the number of sectors of the Flash memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public int flashSectors () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( flashSectors < 0 ) // init variable
	    flashState();
	return flashSectors;
    }
 
// ******* flash2Sectors *******************************************************
// returns number of sectors of 2nd Flash memory, if available
/**
  * Returns the number of sectors of the 2nd Flash memory or 0, if no 2nd Flash is installed.
  * If required, the number of sectors is determined form the device first.
  * @return the number of sectors of the 2nd Flash memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not supported by the firmware.
  */
    public int flash2Sectors () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( flash2Sectors < 0 ) // init variable
	    flash2State();
	return flash2Sectors;
    }
 
// ******* flashSize ***********************************************************
// returns size of Flash memory, if available
/**
  * Returns the size of Flash memory or 0, if no Flash memory is installed.
  * If required, the Flash size is determined form the device first.
  * @return the size of Flash memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public long flashSize () throws UsbException, InvalidFirmwareException, CapabilityException {
	return flashSectorSize() * (long)flashSectors();
    }
 
// ******* flash2Size **********************************************************
// returns size of 2nd Flash memory, if available
/**
  * Returns the size of 2nd Flash memory or 0, if no 2nd Flash memory is installed.
  * If required, the 2nd Flash size is determined form the device first.
  * @return the size of Flash memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not supported by the firmware.
  */
    public long flash2Size () throws UsbException, InvalidFirmwareException, CapabilityException {
	return flash2SectorSize() * (long)flash2Sectors();
    }
 
// ******* printMmcState *******************************************************
// returns true if Flash is available
/**
  * Prints out some debug information about *SD/MMC Flash cards in SPI mode.<br>
  * <b>Only use this method if such kind of Flash is installed.</b>
  * @return True if flash is installed and enabled.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  */
    public boolean printMmcState ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[23];
	checkCapability(CAPABILITY_FLASH);
	vendorRequest2(0x43, "MMC State", 0, 0, buf, 23);
	System.out.println("status=" + Integer.toBinaryString(256+(buf[0] & 255)).substring(1) + "." + Integer.toBinaryString(256+(buf[1] & 255)).substring(1) + 
		"   lastCmd=" + buf[3] + 
		"   lastCmdResponse=" + Integer.toBinaryString(256+(buf[4] & 255)).substring(1) + 
		"   ec=" + buf[2] +
		"   BUSY=" + buf[22] + 
		"   SDHC=" + buf[5] + 
		"   buf=" + (buf[6] & 255)+" "+(buf[7] & 255)+" "+(buf[8] & 255)+" "+(buf[9] & 255)+" "+(buf[10] & 255)+" "+(buf[11] & 255)+"  "+(buf[12] & 255)); // +" "+(buf[13] & 255)+" "+(buf[14] & 255)+" "+(buf[15] & 255)+" "+(buf[16] & 255)+" "+(buf[17] & 255));
 
	return flashEnabled == 1;
    }
 
// ******* printMmc2State *******************************************************
// returns true if 2nd Flash is available
/**
  * Prints out some debug information about *SD/MMC Flash cards in SPI mode.<br>
  * <b>Only use this method if such kind of Flash is installed as 2nd Flash memory.</b>
  * @return True if flash is installed and enabled.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if 2nd Flash memory access is not supported by the firmware.
  */
    public boolean printMmc2State ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[23];
	checkCapability(CAPABILITY_FLASH2);
	vendorRequest2(0x47, "MMC 2 State", 0, 0, buf, 23);
	System.out.println("status=" + Integer.toBinaryString(256+(buf[0] & 255)).substring(1) + "." + Integer.toBinaryString(256+(buf[1] & 255)).substring(1) + 
		"   lastCmd=" + buf[3] + 
		"   lastCmdResponse=" + Integer.toBinaryString(256+(buf[4] & 255)).substring(1) + 
		"   ec=" + buf[2] +
		"   BUSY=" + buf[22] + 
		"   SDHC=" + buf[5] + 
		"   buf=" + (buf[6] & 255)+" "+(buf[7] & 255)+" "+(buf[8] & 255)+" "+(buf[9] & 255)+" "+(buf[10] & 255)+" "+(buf[11] & 255)+"  "+(buf[12] & 255)); // +" "+(buf[13] & 255)+" "+(buf[14] & 255)+" "+(buf[15] & 255)+" "+(buf[16] & 255)+" "+(buf[17] & 255));
 
	return flash2Enabled == 1;
    }
 
// ******* flashUploadBitstream ************************************************
/* 
    Returns configuration time in ms.
    The format of the boot sector (sector 0 of the Flash memory) is
	0..7	ID
	8..9	Number of BS sectors, or 0 is disabled
	10..11  Number of bytes in the last sector, i.e. the total size of Bitstream is ((bs[8] | (bs[9]<<8) - 1) * flash_sector_size + ((bs[10] | (bs[11]<<8))
*/	
/**
  * Uploads a Bitstream to the Flash.
  * This allows the firmware to load the Bitstream from Flash. Together with installation of the firmware in EEPROM
  * it is possible to construct fully autonomous devices.
  * <p>
  * If configuration data is present information about bitstream are stored there and Bitstream starts
  * at sector 0.
  * <p>
  * On all other devices the information about the bitstream is stored in sector 0.
  * This so called boot sector has the following format:
  * <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *   <tr>
  *     <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *     <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0..7</td>
  *     <td bgcolor="#ffffff" valign="top">ID, must be "ZTEXBS",1,1</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">8..9</td>
  *     <td bgcolor="#ffffff" valign="top">The number of sectors used to store the Bitstream. 0 means no Bitstream.</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">10..11</td>
  *     <td bgcolor="#ffffff" valign="top">The number of bytes in the last sector.</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">12..sectorSize-1</td>
  *     <td bgcolor="#ffffff" valign="top">This data is reserved for future use and preserved by this method.</td>
  *   </tr>
  * </table>
  * <p>
  * The total size of the Bitstream is computed as ((bs[8] | (bs[9]<<8) - 1) * flash_sector_size + ((bs[10] | (bs[11]<<8))
  * where bs[i] denotes byte i of the boot sector.
  * <p>
  * The first sector of the Bitstream is sector 1.
  * @param inputStream for reading the Bitstream.
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @see #flashResetBitstream()
  */
    public long flashUploadBitstream ( InputStream inputStream, int bs ) throws BitstreamReadException, UsbException, InvalidFirmwareException, CapabilityException {
	int secNum = Math.max(1, 2048 / flashSectorSize());
	final int bufferSize = secNum * flashSectorSize;
	checkCapability(CAPABILITY_FPGA);
	checkCapability(CAPABILITY_FLASH);
	if ( ! flashEnabled() )
	    throw new CapabilityException(this, "No Flash memory installed or");
	getFpgaState();
 
// read the Bitstream file	
        byte[][] buffer = new byte[32768][];
	byte[] buf1 = new byte[flashSectorSize()];
 
	int i,j,k,l;
	try {
	    j = bufferSize;
	    for ( i=0; i<buffer.length && j==bufferSize; i++ ) {
		buffer[i] = new byte[bufferSize]; 
		j = 0;	
		do {
		    k = inputStream.read( buffer[i], j, bufferSize-j );
		    if ( k < 0 ) 
		        k = 0;
		    j += k;
 
		    // remove header because S6 FPGA's does not support bitstream start word detection
		    if ( i==0 && !dev().fx3() && j==bufferSize && (l=detectBitstreamStart(buffer[0]))>0 ) {
			for (int m=0; m<bufferSize-l; m++ )
			    buffer[0][m]=buffer[0][m+l];
			j-=l;
		    } 
		}
		while ( j<bufferSize && k>0 );
 
		// detect bitstream bit order and swap bits if necessary 
		if ( (i==0) && ( bs<0 || bs>1 ) ) {
		    bs = detectBitstreamBitOrder ( buffer[0] );
//		    System.out.println(bs + "   " + (fpgaFlashBitSwap != (bs==1)));
		}
 
		if ( fpgaFlashBitSwap != (bs==1) ) swapBits(buffer[i], j);
	    }
 
	    try {
		inputStream.close();
	    }
	    catch ( Exception e ) {
	    }
	}
	catch (IOException e) {
	    throw new BitstreamReadException(e.getLocalizedMessage());
	}
 
 
// upload the Bitstream file	
	int startSector = 0;
	long t0 = new Date().getTime();
 
	if ( config!=null && config.getMaxBitstreamSize()>0 ) {
	    config.setBitstreamSize( ((i-1)*secNum + (j-1)/flashSectorSize + 1)*flashSectorSize );
	    startSector = (config.getBitstreamStart()+flashSectorSize-1) / flashSectorSize;
	}
	else {
	    byte[] sector = new byte[flashSectorSize];
	    byte[] ID = new String("ZTEXBS").getBytes(); 
 
	    flashReadSector(0,sector);				// read the boot sector (only the first 16 bytes are overwritten if boot sector is valid)
	    boolean b = true;
	    for (k=0; k<6; k++) {
		b = b && (sector[k] == ID[k]);
		sector[k]=ID[k];
	    }
	    if ( ! b )
	    sector[6] = 1;
	    sector[7] = 1;
	    k = (i-1)*secNum + (j-1)/flashSectorSize + 1;
	    sector[8] = (byte) (k & 255);
	    sector[9] = (byte) ((k>>8) & 255);
	    k = ((j-1) % flashSectorSize) + 1;
	    sector[10] = (byte) (k & 255);
	    sector[11] = (byte) ((k>>8) & 255);
	    if ( ! b ) {
		for ( k=12; k<flashSectorSize; k++ )
		    sector[k]=0;
	    }
	    System.out.print("\rWriting boot sector");
	    flashWriteSector(0,sector);				// write the boot sector
 
	    startSector = 1;
	}
 
	for (k=0; k<i-1; k++) {
	    System.out.print("\rWriting sector " + (k+1)*secNum + " of " + i*secNum);
	    flashWriteSector( startSector+k*secNum, secNum, buffer[k] );	// write the Bitstream sectors
	}
	System.out.println("\rWriting sector " + i*secNum + " of " + i*secNum);
	flashWriteSector( startSector+k*secNum, (j-1)/flashSectorSize + 1, buffer[k] );
 
	return new Date().getTime() - t0;
    } 
 
/**
  * Uploads a Bitstream to the Flash.
  * This allows the firmware to load the Bitstream from Flash. Together with installation of the firmware in EEPROM
  * it is possible to construct fully autonomous devices.
  * See {@link #flashUploadBitstream(InputStream,int)} for further details.
  * @param fwFileName The file name of the Bitstream. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @see #flashResetBitstream()
  */
    public long flashUploadBitstream ( String fwFileName, int bs ) throws BitstreamReadException, UsbException, InvalidFirmwareException, CapabilityException {
	try {
	    return flashUploadBitstream ( JInputStream.getInputStream( fwFileName ), bs );
	}
	catch (IOException e) {
	    throw new BitstreamReadException(e.getLocalizedMessage());
	}
    }  
 
/**
  * Uploads a Bitstream to the Flash.
  * This allows the firmware to load the Bitstream from Flash. Together with installation of the firmware in EEPROM
  * it is possible to construct fully autonomous devices.
  * See {@link #flashUploadBitstream(InputStream,int)} for further details.
  * @param fwFileName The file name of the Bitstream. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @return Configuration time in ms.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @see #flashResetBitstream()
  */
    public long flashUploadBitstream ( String fwFileName ) throws BitstreamReadException, UsbException, InvalidFirmwareException, CapabilityException {
	return flashUploadBitstream(fwFileName, -1);
    }
 
// ******* flashResetBitstream *************************************************
// Clears a Bitstream from the Flash.
/**
  * Clears a Bitstream from the Flash.
  * This is achieved by writing 0 to bytes 8..9 of the boot sector, see {@link #flashUploadBitstream(String)}.
  * If no boot sector is installed the method returns without any write action.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  */
    public void flashResetBitstream ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_FLASH);
	if ( ! flashEnabled() )
	    throw new CapabilityException(this, "Flash memory not installed or");
 
	if ( config!=null && config.getMaxBitstreamSize()>0 ) {
	    config.setBitstreamSize(0);
	    return;
	}
 
	byte[] sector = new byte[flashSectorSize()];
	byte[] ID = new String("ZTEXBS").getBytes(); 
 
	flashReadSector(0,sector);			// read the boot sector
	for (int k=0; k<6; k++)
	    if ( sector[k] != ID[k] )
		return;
	if (sector[6]!=1 || sector[7]!=1 )
	    return;
	sector[8] = 0;
	sector[9] = 0;
	flashWriteSector(0,sector);			// write the boot sector
    } 
 
// ******* flashFirstFreeSector ************************************************
 
// Returns the first free sector of the Flash memory, i.e. the first sector behind the Bitstream
/**
  * Returns the first free sector of the Flash memory.
  * This is the first sector behind the Bitstream, or 0 if no boot sector is installed (or 1 if a boot sector but no Bitstream is installed).
  * @return the first free sector of the Flash memory.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  */
    public int flashFirstFreeSector ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_FLASH);
	if ( ! flashEnabled() )
	    throw new CapabilityException(this, "No Flash memory installed or");
 
	if ( config!=null && config.getMaxBitstreamSize()>0 ) {
	    return (config.getBitstreamStart()+flashSectorSize()-1) / flashSectorSize()  +  (Math.max(config.getMaxBitstreamSize(), config.getBitstreamSize())+flashSectorSize()-1) / flashSectorSize();
	}
 
	byte[] sector = new byte[flashSectorSize()];
	byte[] ID = new String("ZTEXBS").getBytes(); 
 
	flashReadSector(0,sector);			// read the boot sector
	for (int k=0; k<6; k++)
	    if ( sector[k] != ID[k] )
		return 0;
	if (sector[6]!=1 || sector[7]!=1 )
	    return 0;
	return (sector[8] & 255) + ((sector[9] & 255) << 8) + 1;
    }
 
// ******* toHumanStr **********************************************************
/**
  * Converts an integer into a base 1024 formatted string. 
  * E.g. the number 1234567890 is converted to 1G153M384K722.
  * @param i an integer which may be large.
  * @return a human readable string representation.
  */
    public String toHumanStr ( long i ) {
	if ( i==0 ) return "0";
	StringBuilder sb = new StringBuilder();
	int k = 0;
	if ( i<0 ) {
	    sb.append("-");
	    i=-i;
	    k=1;
	}
	if ( (i & 1023) != 0 ) sb.insert(k, i & 1023); i=i>>10;
	if ( (i & 1023) != 0 ) sb.insert(k, (i & 1023) + "K"); i=i>>10;
	if ( (i & 1023) != 0 ) sb.insert(k, (i & 1023) + "M"); i=i>>10;
	if ( i != 0 ) sb.insert(k, i + "G");;
	return sb.toString();
    }
 
// ******* flashInfo ***********************************************************
/**
  * Returns information about Flash memory. 
  * The result contains the size and how much of the Flash is us used / reserved for / by the Bitstream.
  * If no Flash memeory is suppported an empty string is returned.
  * @return Information about Flash memory.
  */
    public String flashInfo ( ) {
	StringBuilder sb = new StringBuilder();
	try { 
	    if ( flashSize() > 0 ) {
		sb.append( "Size: " + toHumanStr(flashSize()) + " Bytes" );
		if ( config!=null && config.getMaxBitstreamSize()>0 ) {
		    sb.append( ";  Bitstream (start / used / reserved): " + toHumanStr(config.getBitstreamStart()) + " / "  + toHumanStr(config.getBitstreamSize()) + " / "  + toHumanStr(config.getMaxBitstreamSize()) + " Bytes" );
		}
		else {
		    sb.append( ";  Bitstream (used): " + toHumanStr(flashFirstFreeSector()*flashSectorSize()) + " Bytes" );
		}
	    }
	}
	catch ( Exception e ) {
	}
	return sb.toString();
    }
 
// ******* flash2Info *********************************************************=
/**
  * Returns information about 2nd Flash memory. 
  * The result contains the size and how much of the Flash available.
  * If no 2nd Flash memeory is suppported an empty string is returned.
  * @return Information about 2nd Flash memory.
  */
    public String flash2Info ( ) {
	String s = "";
	try { 
	    if ( flash2Size() > 0 ) {
		s="Size: " + toHumanStr(flash2Size()) + " Bytes";
	    }
	}
	catch ( Exception e ) {
	}
	return s;
    }
 
// ******* debugStackSize ******************************************************
/**
  * Returns the size of message stack in messages.
  * @return the size of message stack in messages.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  */
    public int debugStackSize ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_DEBUG);
	if ( debugStackSize<=0 || debugMsgSize<=0 ) {
	    byte[] buf = new byte[7];
	    vendorRequest2(0x28, "Read debug data", 0, 0, buf, 4);
	    debugStackSize = buf[2] & 255;
	    debugMsgSize = buf[3] & 255;
	}
	return debugStackSize;
    }
 
// ******* debugMsgSize ********************************************************
/**
  * Returns the size of messages in bytes.
  * @return the size of messages in bytes.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  */
    public int debugMsgSize ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_DEBUG);
	if ( debugMsgSize<=0 ) 
	    debugStackSize();
 
	return debugMsgSize;
    }
 
// ******* debugLastMsg ********************************************************
/**
  * Returns the number of the last message read out by {@link #debugReadMessages(boolean,byte[])}
  * @return the number of the last message read out by {@link #debugReadMessages(boolean,byte[])}
  */
    public final int debugLastMsg ( )  {
	return debugLastMsg;
    }
 
// ******* debugReadMessages ***************************************************
/**
  * Reads debug messages from message stack.
  * The number of messages stored in buf is returned. The total number of new messages is stored in {@link #debugNewMessages}.
  * The number of the latest message is returned by {@link #debugLastMsg()}.
  * @param all If true, all messages from stack are written to buf. If it is false, only the new messages are written to buf.
  * @param buf The buffer to store the messages.
  * @return the size of messages stored in buffer.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not possible.
  */
    public int debugReadMessages ( boolean all, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_DEBUG);
	byte buf2[] = new byte[ debugStackSize()*debugMsgSize() + 4 ];
	vendorRequest2(0x28, "Read debug data", 0, 0, buf2, buf2.length);
	int lm = (buf2[0] & 255) | ((buf2[1] & 255) << 8);
	debugNewMessages = lm - debugLastMsg;
 
	int r = Math.min( Math.min( buf.length/debugMsgSize() , debugStackSize ), lm);
	if ( !all ) r = Math.min(r,debugNewMessages);
	for (int i = 0; i<r; i++) {
	    int k=(lm-r+i) % debugStackSize;
	    for (int j=0; j<debugMsgSize; j++ )
		buf[i*debugMsgSize+j] = buf2[k*debugMsgSize+j+4];
	}
 
	debugLastMsg = lm;
	return r;
    }
 
// ******* xmegaStrError *******************************************************
/** 
  * Converts a given error code into a String.
  * @param errNum The error code.
  * @return an error message.
  */
    public String xmegaStrError ( int errNum ) {
	switch ( errNum ) {
	    case XMEGA_EC_NO_ERROR:
		return "USB error";
	    case XMEGA_EC_PDI_READ_ERROR:
		return "PDI read error";
	    case XMEGA_EC_NVM_TIMEOUT:
		return "NVM timeout error";
	    case XMEGA_EC_INVALID_DEVICE:
		return "Invalid or unsupported ATxmega";
	    case XMEGA_EC_ADDRESS_ERROR:
		return "Address error (invalid address or wrong page size)";
	    case XMEGA_EC_NVM_BUSY:
		return "NVM busy";
	}
	return "Error " + errNum;
    }
 
/** 
  * Gets the last ATxmega error from the device.
  * @return an error message.
  */
    public String xmegaStrError ( ) {
	try {
	    return xmegaStrError( xmegaState() );
	}
	catch ( Exception e ) {
	    return "Unknown error (Error receiving error code: "+e.getLocalizedMessage() +")";
	}
    }
 
// ******* xmegaState **********************************************************
/**
  * Read ATxmega error and status information from the device.
  * @return The last error code.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if ATxmega controllers are not supported by the firmware.
  */
    public int xmegaState () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[7];
	checkCapability(CAPABILITY_XMEGA);
	vendorRequest2(0x48, "Xmega state", 0, 0, buf, 7);
    	xmegaEC = buf[0] & 255;
 
    	xmegaFlashPages = ((buf[2] & 255) << 8) | (buf[1] & 255);
    	xmegaEepromPages = ((buf[4] & 255) << 8) | (buf[3] & 255);
    	xmegaFlashPageSize = 1 << (buf[5] & 15);
    	xmegaEepromPageSize = 1 << (buf[6] & 15);
	return xmegaEC;
    }
 
// ******* xmegaEnabled ********************************************************
/**
  * Returns true if ATxmega controller is available.
  * @return true if ATxmega controller is available.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if ATxmega controllers are not supported by the firmware.
  */
    public boolean xmegaEnabled () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( xmegaFlashPages < 0 || xmegaEepromPages < 0 ) // init variables
	    xmegaState();
	return xmegaFlashPages > 0 && xmegaEepromPages > 0;
    }
 
// ******* xmegaFlashPages *****************************************************
/**
  * Returns the number of the ATxmega Flash pages.
  * @return The number of the ATxmega Flash pages.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if ATxmega controllers are not supported by the firmware.
  */
    public int xmegaFlashPages () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( xmegaFlashPages < 0 || xmegaEepromPages < 0 ) // init variables
	    xmegaState();
	return xmegaFlashPages;
    }
 
// ******* xmegaEepromPages ****************************************************
/**
  * Returns the number of the ATxmega EEPROM pages.
  * @return The number of the ATxmega EEPROM pages.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if ATxmega controllers are not supported by the firmware.
  */
    public int xmegaEepromPages () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( xmegaFlashPages < 0 || xmegaEepromPages < 0 ) // init variables
	    xmegaState();
	return xmegaEepromPages;
    }
 
// ******* xmegaFlashPageSize **************************************************
/**
  * Returns the size of the ATxmega Flash pages.
  * @return The size of the ATxmega Flash pages.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if ATxmega controllers are not supported by the firmware.
  */
    public int xmegaFlashPageSize () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( xmegaFlashPages < 0 || xmegaEepromPages < 0 ) // init variables
	    xmegaState();
	return xmegaFlashPageSize;
    }
 
// ******* xmegaEEpromPageSize *************************************************
/**
  * Returns the size of the ATXmega EEPROM pages.
  * @return The size of the ATXmega EEPROM pages.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if ATXmega controllers are not supported by the firmware.
  */
    public int xmegaEepromPageSize () throws UsbException, InvalidFirmwareException, CapabilityException {
	if ( xmegaFlashPages < 0 || xmegaEepromPages < 0 ) // init variables
	    xmegaState();
	return xmegaEepromPageSize;
    }
 
// ******* xmegaReset **********************************************************
/**
  * Resets the ATxmega.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
  */
    public void xmegaReset () throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_XMEGA);
	try {
	    vendorCommand( 0x49, "XMEGA Reset" );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "NVM Reset: " + xmegaStrError() ); 
	}
    }
 
 
// ******* xmegaNvmRead ********************************************************
/**
  * Reads data from the NVM of ATxmega.
  * @param addr The source address of the NVM (PDI address space).
  * @param buf A buffer for the storage of the data.
  * @param length The amount of bytes to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
  */
    public void xmegaNvmRead ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_XMEGA);
 
	try {
	    vendorRequest2( 0x4a, "XMEGA NVM Read", addr, addr>> 16, buf, length );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "NVM Read: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
 
// ******* xmegaFlashRead ******************************************************
/**
  * Reads data from Flash memory of ATxmega.
  * @param addr The source address relative to the Flash memory base.
  * @param buf A buffer for the storage of the data.
  * @param length The amount of bytes to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException If a communication error occurs.
  * @throws CapabilityException If NVRAM access to ATxmega is not supported by the firmware.
  */
    public void xmegaFlashRead ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_XMEGA);
 
	try {
	    vendorRequest2( 0x4b, "XMEGA Flash Read", addr, addr>> 16, buf, length );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA Flash Read: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
 
 
// ******* xmegaEepromRead *****************************************************
/**
  * Reads data from EEPROM memory of ATxmega.
  * @param addr The source address relative to the EEPROM memory base.
  * @param buf A buffer for the storage of the data.
  * @param length The amount of bytes to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException If a communication error occurs.
  * @throws CapabilityException If NVRAM access to ATxmega is not supported by the firmware.
  */
    public void xmegaEepromRead ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_XMEGA);
 
	try {
	    vendorRequest2( 0x4c, "XMEGA EEPROM Read", addr, addr>> 16, buf, length );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA EEPROM Read: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
 
// ******* xmegaFuseRead *******************************************************
/**
  * Reads data from Fuse memory of ATxmega.
  * @param addr The source address relative to the Fuse memory base.
  * @param buf A buffer for the storage of the data.
  * @param length The amount of bytes to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException If a communication error occurs.
  * @throws CapabilityException If NVRAM access to ATxmega is not supported by the firmware.
  */
    public void xmegaFuseRead ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_XMEGA);
 
	try {
	    vendorRequest2( 0x4d, "XMEGA Fuse Read", addr, addr>> 16, buf, length );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA Fuse Read: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
/**
  * Reads data one Fuse of ATxmega.
  * @param addr The index of th Fuse.
  * @return The Fuse read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException If a communication error occurs.
  * @throws CapabilityException If NVRAM access to ATxmega is not supported by the firmware.
  */
    public int xmegaFuseRead ( int addr ) throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[1];
	checkCapability(CAPABILITY_XMEGA);
	try {
	    vendorRequest2( 0x4d, "XMEGA Fuse Read", addr, 0, buf, 1 );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA Fuse Read: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    	return buf[0] & 255;
    }
 
 
// ******* xmegaFlashPageWrite *************************************************
/**
  * Writes data to Flash memory of ATxmega.
  * @param addr The source address relative to the Flash memory base.
  * @param buf A buffer that stores the data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
  * @throws IndexOutOfBoundsException If the buffer is smaller than the Flash page size.
*/
    public void xmegaFlashPageWrite ( int addr, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	checkCapability(CAPABILITY_XMEGA);
 
	if ( buf.length < xmegaFlashPageSize() ) 
	    throw new IndexOutOfBoundsException( "Buffer smaller than the Flash page size: " + buf.length + " < " + xmegaFlashPageSize);
 
	try {
	    vendorCommand2( 0x4b, "XMEGA Flash page write", addr, addr>> 16, buf, xmegaFlashPageSize );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA Flash page write: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
// ******* xmegaEpromPageWrite *************************************************
/**
  * Writes data to EEPROM memory of ATxmega.
  * @param addr The source address relative to the EEPROM memory base.
  * @param buf A buffer that stores the data.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
  * @throws IndexOutOfBoundsException If the buffer is smaller than the EEPROM page size.
*/
    public void xmegaEepromPageWrite ( int addr, byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	checkCapability(CAPABILITY_XMEGA);
 
	if ( buf.length < xmegaEepromPageSize() ) 
	    throw new IndexOutOfBoundsException( "Buffer smaller than the EEPROM page size: " + buf.length + " < " + xmegaEepromPageSize);
 
	try {
	    vendorCommand2( 0x4c, "XMEGA EEPROM page write", addr, addr>> 16, buf, xmegaEepromPageSize );
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA EEPROM page write: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
// ******* xmegaFuseWrite ******************************************************
/**
  * Writes one Fuse of the ATxmega.
  * @param addr The index of th Fuse.
  * @param val The value of th Fuse.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
*/
    public void xmegaFuseWrite ( int addr, int val ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_XMEGA);
 
	try {
	    vendorCommand( 0x4d, "XMEGA Fuse write", val, addr);
        }
        catch ( UsbException e ) {
	    throw new UsbException( dev().dev(), "XMEGA Fuse write: " + xmegaStrError() ); 
	}
	try {
    	    Thread.sleep( 3 );
    	}
	catch ( InterruptedException e) {
    	} 
    }
 
// ******* xmegaImgWrite *******************************************************
/**
  * Uploads data to NVM
*/
    private long xmegaImgWrite ( boolean toFlash, ImgFile imgFile ) throws UsbException, InvalidFirmwareException, CapabilityException, FirmwareUploadException { 
	final int maxTries = 3;  // maximum amount of tries
	int pageSize = toFlash ? xmegaFlashPageSize() : xmegaEepromPageSize();
	checkCapability(CAPABILITY_XMEGA);
 
	long t0 = new Date().getTime();
 
	byte buf1[] = new byte[pageSize];
	byte buf2[] = new byte[pageSize];
 
	for (int i = 0; i<65536; i+=pageSize ) {
 
	    boolean b = false;
	    boolean c = true;
	    for ( int j=0; (j < pageSize ) && ( i+j < 65536 ); j++ ) {
		boolean d = (imgFile.data[i+j]>=0) && (imgFile.data[i+j]<=255);	// data vaild ?
		b |= d;
		c &= d;
	    }
	    if ( b ) {	 // page contains data ==> has to be written
//		System.out.print("Page " + i +": " );
 
		// read page, if firmware image contains undefined bytes
		if ( ! c ) {
//		    System.out.print("R");
		    if ( toFlash ) 
			xmegaFlashRead ( i, buf1, pageSize );
		    else
	                xmegaEepromRead ( i, buf1, pageSize );
		}
 
		// prepare the page buffer
    		for ( int j=0; (j < pageSize ) && ( i+j < 65536 ); j++ ) {
		    if ( (imgFile.data[i+j]>=0) && (imgFile.data[i+j]<=255) )
			buf1[j]= (byte) imgFile.data[i+j];
		}
 
		for ( int k=1; b ; k++ ) {
		    // write the page
//		    System.out.print("W");
		    if ( toFlash ) 
	    		xmegaFlashPageWrite ( i, buf1 );
	    	    else
	    		xmegaEepromPageWrite ( i, buf1 );
 
		    // verify it
//		    System.out.print("V");
		    if ( toFlash ) 
	    		xmegaFlashRead ( i, buf2, pageSize );
	    	    else
	    		xmegaEepromRead ( i, buf2, pageSize );
	    	    b=false;
    		    for ( int j=0; (j < pageSize) && (! b ); j++ ) {
    			b |= buf1[j] != buf2[j];
    		    }
    		    if ( b ) {
    			if ( k<maxTries ) {
    			    System.err.println("Warning: xmegaWriteFirmware: Verification of " + ( toFlash ? "Flash" : "EEPROM" ) + " page" + i + " failed (try " + k +")" );
    			}
    			else {
    			    System.err.println("Warning: xmegaWriteFirmware: Verification of " + ( toFlash ? "Flash" : "EEPROM" ) + " page " + i + " failed");
    			}
    		    }
    		    b = false;
 
//		    System.out.println();
		}
	    }
	}
 
	return new Date().getTime() - t0;
    }
 
 
 
// ******* xmegaWriteFirmware **************************************************
/**
  * Uploads firmware to the flash memory
  * @param imgFile The firmware / data image.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
  * @throws FirmwareUploadException if the verification fails.
  * @return the upload time in ms.
*/
    public long xmegaWriteFirmware ( ImgFile imgFile ) throws UsbException, InvalidFirmwareException, CapabilityException, FirmwareUploadException { 
	return xmegaImgWrite( true, imgFile);
    }
 
 
// ******* xmegaWriteEeprom ****************************************************
/**
  * Uploads data to the EEPROM memory
  * @param imgFile The firmware / data image.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if NVRAM access to ATxmega is not supported by the firmware.
  * @throws FirmwareUploadException if the verification fails.
  * @return the upload time in ms.
*/
    public long xmegaWriteEeprom ( ImgFile imgFile ) throws UsbException, InvalidFirmwareException, CapabilityException, FirmwareUploadException { 
	return xmegaImgWrite( false, imgFile);
    }
 
 
// ******* toString ************************************************************
/** 
  * Returns a lot of useful information about the corresponding device.
  * @return a lot of useful information about the corresponding device.
  */
    public String toString () {
	String str = dev().toString();
	try {
	    str += "\n   " + getFpgaConfigurationStr();
	}
	catch ( Exception e ) {
	}
	return str;
    }
 
// ******* capabilityInfo ******************************************************
/**
  * Creates a String with capability information.
  * @param pf A separator between the single capabilities, e.g. ", "
  * @return a string of the supported capabilities.
  */
    public String capabilityInfo ( String pf ) {
	String str = "";
	for ( int i=0; i<6; i++ ) 
	    for (int j=0; j<8; j++ ) 
		if ( dev().interfaceCapabilities(i,j) ) {
		    if ( ! str.equals("") ) 
			str+=pf;
		    if (i*8+j < capabilityStrings.length) 
			str+=capabilityStrings[i*8+j];
		    else
			str+=i+"."+j;
		}
	return str;
    }
// ******* configureFpgaHS *****************************************************
//  returns configuration time in ms
/**
  * Upload a Bitstream to the FPGA using high speed mode.
  * @param inputStream for reading the Bitstream.
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public long configureFpgaHS ( InputStream inputStream, boolean force, int bs ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException {
	final int transactionBytes = 64*1024;
	long t0 = 0;
	byte[] settings = new byte[2];
	boolean releaseIF;
 
	checkCapability(CAPABILITY_HS_FPGA);
	vendorRequest2(0x33, "getHSFpgaSettings", settings, 2);
 
	if ( !force && getFpgaConfiguration() )
	    throw new AlreadyConfiguredException(); 
 
	releaseIF = ! getInterfaceClaimed(settings[1] & 255);
//	System.out.println("EP "+ settings[0] + "    IF "+settings[1]+ "   claim " + releaseIF);
 
// read the Bitstream file	
        ByteBuffer[] buffers = new ByteBuffer[64*1024*1024/transactionBytes];
	byte[] buf = new byte[transactionBytes]; 
 
	int size = 0;
	try {
	    int j = transactionBytes;
	    for ( int i=0; i<buffers.length && j==transactionBytes; i++ ) {
		int k;
		// 512 bytes dummy data
		if ( i== 0 ) {
		    for (int l=0; l<512; l++ ) buf[l]=0;
		    j=512;
		} 
		else  {
		    j = 0;	
		}
		do {
		    k = inputStream.read( buf, j, transactionBytes-j );
		    if ( k < 0 ) k = 0;
		    j += k;
		}
		while ( j<transactionBytes && k>0 );
 
		if ( (i==0) && ( bs<0 || bs>1 ) ) {
		    bs = detectBitstreamBitOrder ( buf );
//		    System.out.println(bs);
		}
 
		if ( bs == 1 ) swapBits(buf, j);
 
		buffers[i] = allocateByteBuffer(buf, 0, j);
		size += j;
	    }
 
	    try {
		inputStream.close();
	    }
	    catch ( Exception e ) {
	    }
	}
	catch (IOException e) {
	    throw new BitstreamReadException(e.getLocalizedMessage());
	}
 
	if ( size < 64 ) 
	    throw new BitstreamReadException("Invalid file size: " + size );
 
// remove NOP's from the end
/*	System.out.println(size);
	while ( size-2>=0 && buffer[(size-2) / transactionBytes][(size-2) % transactionBytes] == 4 && buffer[(size-1) / transactionBytes][(size-1) % transactionBytes]==0 )
	    size-=2;
	System.out.println(size);
*/	
 
// claim interface if required
	if ( releaseIF ) claimInterface( settings[1] & 255 );
 
//	System.out.println(size & 127);
 
// upload the Bitstream file	
	for ( int tries=3; tries>0; tries-- ) {	    
    	    vendorCommand(0x34, "initHSFPGAConfiguration" );
 
	    try {
		t0 = -new Date().getTime();
	    	for ( int i=0; i<buffers.length && i*transactionBytes < size; i++ ) {
		    int j = size-i*transactionBytes;
		    if (j>transactionBytes) 
			j = transactionBytes;
 
		    if ( j>0 ) {
			int l = bulkWrite(settings[0] & 255, buffers[i], 1000);
			if ( l < 0 ) l = bulkWrite(settings[0] & 255, buffers[i], 1000);   // one retry
			if ( l < 0 )
			    throw new UsbException("Error sending Bitstream: " + l + ": " + LibUsb.strError(l));
			else if ( l != j )
			    throw new UsbException("Error sending Bitstream: Sent " + l +" of " + j + " bytes");
		    }
		}
 
		try {
    		    Thread.sleep( (size % transactionBytes) / 1000 + 10 );
    		}
		catch ( InterruptedException e) {
    		} 
 
		vendorCommand(0x35, "finishHSFPGAConfiguration" );
		t0 += new Date().getTime();
 
 		getFpgaState();
//		System.err.println("fpgaConfigred=" + fpgaConfigured + "   fpgaBytes="+fpgaBytes + " ("+size+")   fpgaInitB="+fpgaInitB + "  time=" + t0);
		if ( ! fpgaConfigured ) {
		    throw new BitstreamUploadException( "FPGA configuration failed: DONE pin does not go high, possible USB transfer errors (INIT_B_HIST=" + fpgaInitB + (fpgaBytes==0 ? "" : "; " + (size - fpgaBytes) + " bytes got lost") + ")" );
		}
 
		if ( enableExtraFpgaConfigurationChecks ) {
	    	    if ( fpgaBytes!=0 && fpgaBytes!=size )
			System.err.println("Warning: Possible FPGA configuration data loss: " + (size - fpgaBytes) + " bytes got lost");
		    if ( fpgaInitB!=222 )
			System.err.println("Warning: Possible Bitstream CRC error: INIT_B_HIST=" + fpgaInitB );
		}
 
		tries = 0;
	    } 
	    catch ( BitstreamUploadException e ) {
		if (tries == 1)
		    throw e;
		else if ( tries<3 || enableExtraFpgaConfigurationChecks )  
		    System.err.println("Warning: " + e.getLocalizedMessage() +": Retrying it ...");
	    }
	}
 
	if ( releaseIF ) releaseInterface( settings[1] & 255 );
 
    	try {
    	    Thread.sleep( 25 );
    	}
	catch ( InterruptedException e) {
        } 
 
	return t0;
    } 
 
/**
  * Upload a Bitstream to the FPGA using high speed mode.
  * @param fwFileName The file name of the Bitstream. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public long configureFpgaHS ( String fwFileName, boolean force, int bs ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException {
	try {
	    return configureFpgaHS( JInputStream.getInputStream( fwFileName ), force, bs );
	}
	catch (IOException e) {
	    throw new BitstreamReadException(e.getLocalizedMessage());
	}
    }
 
// ******* configureFpga *****************************************************
//  returns configuration time in ms
/**
  * Upload a Bitstream to the FPGA using high speed mode (if available) or low speed mode.
  * @param inputStream for reading the Bitstream.
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  * @throws IOException if mark/reset is not supported
  */
    public long configureFpga ( InputStream inputStream, boolean force, int bs ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException, IOException {
	try {
	    inputStream.mark(64*1024*1024);
	    return configureFpgaHS( inputStream, force, bs );
	}
	catch ( CapabilityException e ) {
	    return configureFpgaLS( inputStream, force, bs );
	}
	catch ( UsbException e ) {
	    System.err.println("Warning: High speed FPGA configuration failed, trying low speed mode:" + e.getLocalizedMessage() +": Trying low speed mode");
	    inputStream.reset();
	    return configureFpgaLS( inputStream, force, bs );
	}
	catch ( BitstreamUploadException e ) {
	    System.err.println("Warning: High speed FPGA configuration failed, trying low speed mode:" + e.getLocalizedMessage() +": Trying low speed mode");
	    inputStream.reset();
	    return configureFpgaLS( inputStream, force, bs );
	}
    }
 
/**
  * Upload a Bitstream to the FPGA using high speed mode (if available) or low speed mode.
  * @param fwFileName The file name of the Bitstream. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @param bs 0: disable bit swapping, 1: enable bit swapping, all other values: automatic detection of bit order.
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public long configureFpga ( String fwFileName, boolean force, int bs ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException {
	try {
	    return configureFpgaHS( fwFileName, force, bs );
	}
	catch ( CapabilityException e ) {
	    return configureFpgaLS( fwFileName, force, bs );
	}
	catch ( UsbException e ) {
	    System.err.println("Warning: High speed FPGA configuration failed, trying low speed mode:" + e.getLocalizedMessage() +": Trying low speed mode");
	    return configureFpgaLS( fwFileName, force, bs );
	}
	catch ( BitstreamUploadException e ) {
	    System.err.println("Warning: High speed FPGA configuration failed, trying low speed mode:" + e.getLocalizedMessage() +": Trying low speed mode");
	    return configureFpgaLS( fwFileName, force, bs );
	}
    }
 
/**
  * Upload a Bitstream to the FPGA using high speed mode (if available) or low speed mode.
  * @param fwFileName The file name of the Bitstream. The file can be a regular file or a system resource (e.g. a file from the current jar archive).
  * @param force If set to true existing configurations will be overwritten. (By default an {@link AlreadyConfiguredException} is thrown).
  * @return Configuration time in ms.
  * @throws BitstreamReadException if an error occurred while attempting to read the Bitstream.
  * @throws BitstreamUploadException if an error occurred while attempting to upload the Bitstream.
  * @throws AlreadyConfiguredException if the FPGA is already configured.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if FPGA configuration is not supported by the firmware.
  */
    public long configureFpga ( String fwFileName, boolean force ) throws BitstreamReadException, UsbException, BitstreamUploadException, AlreadyConfiguredException, InvalidFirmwareException, CapabilityException {
	return configureFpga(fwFileName, force, -1);
    }
 
// ******* macEepromWrite ******************************************************
/**
  * Writes data to the MAC EEPROM.
  * @param addr The destination address of the MAC EEPROM.
  * @param buf The data.
  * @param length The amount of bytes to be sent.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if MAC EEPROM access is not supported by the firmware or if configuration data is present and there is a write to addresses 0 to 79. In order to override this behavior set {@link #config} variable to null.
  */
    public void macEepromWrite ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_MAC_EEPROM);
	if ( ( config != null ) && ( addr<80 ))
	    throw new CapabilityException(this, "Overwriting configuration data in MAC EEPROM");
	vendorCommand2( 0x3C, "MAC EEPROM Write", addr, 0, buf, length );
        try {
    	    Thread.sleep( 10 );
	}
	catch ( InterruptedException e) {
    	} 
    }
 
// ******* macEepromRead *******************************************************
/**
  * Reads data from the MAC EEPROM.
  * @param addr The source address of the MAC EEPROM.
  * @param buf A buffer for the storage of the data.
  * @param length The amount of bytes to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if MAC EEPROM access is not supported by the firmware.
  */
    public void macEepromRead ( int addr, byte[] buf, int length ) throws UsbException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_MAC_EEPROM);
	vendorRequest2( 0x3B, "MAC EEPROM Read", addr, 0, buf, length );
    	try {
    	    Thread.sleep( 10 );
    	}
	catch ( InterruptedException e) {
        } 
    }
 
// ******* macEepromState ******************************************************
// returns true if MAC EEPROM is ready
/**
  * Reads the current MAC EEPROM status.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if MAC EEPROM access is not supported by the firmware.
  * @return true if MAC EEPROM is ready.
  */
    public boolean macEepromState ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[1];
	checkCapability(CAPABILITY_MAC_EEPROM);
	vendorRequest2(0x3D, "MAC EEPROM State", 0, 0, buf, 1);
	return buf[0] == 0;
    }
 
// ******* macRead *************************************************************
/**
  * Reads MAC address from MAC EEPROM.
  * @param buf A buffer with a minimum size of 6 bytes.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if MAC EEPROM access is not supported by the firmware.
  * @throws IndexOutOfBoundsException If the buffer is smaller than 6 bytes.
  */
    public void macRead ( byte[] buf ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	if ( buf.length < 6 ) 
    	    throw new IndexOutOfBoundsException( "macRead: Buffer smaller than 6 Bytes" );
    	macEepromRead(250, buf, 6);
    }
 
// ******* numberOfFpgas *******************************************************
/**
  * Returns the number of FPGA's
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @return number of FPGA's
  */
    public int numberOfFpgas ( ) throws UsbException, InvalidFirmwareException {
	if ( numberOfFpgas < 0 ) {
	    try {
		byte[] buffer = new byte[3];
		checkCapability(CAPABILITY_MULTI_FPGA);
		vendorRequest2(0x50, "getMultiFpgaInfo", buffer, 3);
		numberOfFpgas = (buffer[0] & 255)+1;
		selectedFpga = buffer[1] & 255;
		parallelConfigSupport = buffer[2]==1;
	    }
	    catch ( CapabilityException e ) {
		numberOfFpgas = 1;
		selectedFpga = 0;
		parallelConfigSupport = false;
	    }
	}
	return numberOfFpgas;
    }
 
// ******* selectFpga **********************************************************
/**
  * Select a FPGA
  * @param num FPGA to select. Valid values are 0 to {@link #numberOfFpgas()}-1
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws IndexOutOfBoundsException If FPGA number is not in range.
  */
    public void selectFpga ( int num ) throws UsbException, InvalidFirmwareException, IndexOutOfBoundsException {
	numberOfFpgas();
	if ( num<0 || num>=numberOfFpgas )
    	    throw new IndexOutOfBoundsException( "selectFPGA: Invalid FPGA number" );
 
	if ( numberOfFpgas != 1 ) {
	    try {
		checkCapability(CAPABILITY_MULTI_FPGA);
		vendorCommand( 0x51, "selectFPGA", num, 0);
	    }
	    catch ( CapabilityException e ) {
		// should'nt occur
	    }
	}
	selectedFpga = num;
    }
 
// ******* TempSensorRead ******************************************************
/**
  * Read temperature sensor data.
  * @param idx Temperature sensor index
  * @return Temperature in deg. C
  * @throws InvalidFirmwareException If interface 1 or temperature sensor protocol is not supported.
  * @throws UsbException If a communication error occurs.
  * @throws CapabilityException If NVRAM access to ATxmega is not supported by the firmware.
  * @throws IndexOutOfBoundsException If idx is not in range.
  */
    public double tempSensorRead ( int idx ) throws UsbException, InvalidFirmwareException, CapabilityException, IndexOutOfBoundsException {
	int[] xIdx = { 3, 4, 1, 2 };
 
	checkCapability(CAPABILITY_TEMP_SENSOR);
 
	int len = 0;
 
	if ( tempSensorUpdateInterval < 40 ) 
	    tempSensorUpdateInterval = 40;
 
	if ( new Date().getTime() > lastTempSensorReadTime+tempSensorUpdateInterval ) {
	    len = vendorRequest( 0x58, "Temperature Sensor Read", 0, 0, tempSensorBuf, tempSensorBuf.length );
	    lastTempSensorReadTime = new Date().getTime();
 
	    if ( len != 5 || tempSensorBuf[0] != 1 )
		throw new InvalidFirmwareException("tempSensorRead: Invalid temperature sensor protocol");
	}
 
	if ( idx<0 || idx>3 ) 
	    throw new IndexOutOfBoundsException( "tempSensorRead: Invalid temperature sensor index" );
 
	return ((tempSensorBuf[xIdx[idx]] & 255)-77.2727)/1.5454;	
    }
 
// ******* printSpiState *******************************************************
// returns true if Flash is available
/**
  * Prints out some debug information about SPI Flash.<br>
  * <b>Only use this method if such kind of Flash is installed.</b>
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException if Flash memory access is not supported by the firmware.
  * @return true if flash is enabled
  */
    public boolean printSpiState ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[10];
	checkCapability(CAPABILITY_FLASH);
	vendorRequest2(0x43, "SPI State", 0, 0, buf, 10);
	System.out.println("ec=" + buf[0] +
	        "   vendor=" + Integer.toHexString(buf[1] & 255).toUpperCase() + "h" +
	        "   device=" + Integer.toHexString(buf[2] & 255).toUpperCase() + "h" +
	        "   memType=" + Integer.toHexString(buf[3] & 255).toUpperCase() + "h" +
	        "   eraseCmd=" + Integer.toHexString(buf[4] & 255).toUpperCase() + "h" +
	        "   lastCmd=" + Integer.toHexString(buf[5] & 255).toUpperCase() + "h" +
		"   buf=" + (buf[6] & 255)+" "+(buf[7] & 255)+" "+(buf[8] & 255)+" "+(buf[9] & 255)
	    );
	return flashEnabled == 1;
    }
 
// ******* debug2GetMessage *******************************************************
/**
  * Reads a debug message with given Index in raw format.
  * Valid indixes are {@link #debug2LastIdx()}-{@link #debug2Cnt()} to {@link #debug2LastIdx()}-1.
  * Data format is:
  * <table bgcolor="#404040" cellspacing=1 cellpadding=4>
  *   <tr>
  *     <td bgcolor="#d0d0d0" valign="bottom"><b>Bytes</b></td>
  *     <td bgcolor="#d0d0d0" valign="bottom"><b>Description</b></td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">0</td>
  *     <td bgcolor="#ffffff" valign="top">Type</td>
  *   </tr>
  *   <tr>
  *     <td bgcolor="#ffffff" valign="top">1..length</td>
  *     <td bgcolor="#ffffff" valign="top">Message</td>
  *   </tr>
  * </table>
  * @return A buffer with the raw message. (Length of the message is result.length-1)
  * @param idx Index of message.
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws CapabilityException Debug2 feature is not supported by firmware.
  * @throws UsbException if a communication error occurs.
  */
    public byte[] debug2GetMessage ( int idx ) throws UsbException, InvalidFirmwareException, CapabilityException {
	int length = idx < 0 ? 10 : 4096;
	byte[] buf = new byte[length];
	checkCapability(CAPABILITY_DEBUG2);
	length = vendorRequest(0x28, "Read Debug 2 Message", idx>>16, idx & 65535, buf, length);
	if ( length<10 ) throw new InvalidFirmwareException(this, "Invalid result from VR 0x28");
	debug2EC = (buf[0] & 255);
	debug2LastIdx = (buf[1] & 255) | ((buf[2] & 255) << 8) | ((buf[3] & 255) << 16) | ((buf[4] & 255) << 24);
	debug2Cnt = (buf[5] & 255) | ((buf[6] & 255)<<8);
	if ( idx < 0 ) {
	    buf[9] = -1;
	}
	return Arrays.copyOfRange(buf,9,length);
    }
 
// ******* debug2LastIdx **********************************************************
/**
  * Returns index of last message + 1
  * @return index of last message + 1
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws CapabilityException Debug2 feature is not supported by firmware.
  * @throws UsbException if a communication error occurs.
  */
    public int debug2LastIdx ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	debug2GetMessage(-1);
	return debug2LastIdx;
    }
 
// ******* debug2EC ************************************************************
/**
  * Returns an error code if a fatal error occurred (0 if no error occurred)
  * @return error code.
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws CapabilityException Debug2 feature is not supported by firmware.
  * @throws UsbException if a communication error occurs.
  */
    public int debug2EC ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	debug2GetMessage(-1);
	return debug2EC;
    }
 
// ******* debug2Cnt ************************************************************
/**
  * Returns the number of messages in buffer.
  * @return Returns the number of buffered messages.
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws CapabilityException Debug2 feature is not supported by firmware.
  * @throws UsbException if a communication error occurs.
  */
    public int debug2Cnt ( ) throws UsbException, InvalidFirmwareException, CapabilityException {
	debug2GetMessage(-1);
	return debug2Cnt;
    }
 
 
// ******* debug2GetNextLogMessage *********************************************
/**
  * Reads the next log message in string format.
  * The message index is {@link #debug2LogIdx} which is incremented by this function.
  * null is returned if no log message is available.
  * @return The log message.
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws CapabilityException Debug2 feature is not supported by firmware.
  * @throws UsbException if a communication error occurs.
  */
    public String debug2GetNextLogMessage () throws UsbException, InvalidFirmwareException, CapabilityException {
        byte[] buf;
        int i;
	do {
	    buf = debug2GetMessage(debug2LogIdx);
	    if ( debug2LogIdx >= debug2LastIdx ) {
		return null;
	    }
	    debug2LogIdx++;
	} while ( buf[0]!=1 && buf[0]!=2 );
 
	return buf[0]==1 ? new String(buf,1,buf.length-1) : ( "Runtime error " + ( i = ((buf[1]&255) | ((buf[2]&255)<<8)) ) + " occured at line " + ( (buf[3]&255) | ((buf[4]&255)<<8) ) + " of " + new String(buf,5,buf.length-5)+": "+Fx3Errors.errStr(i));
    }
 
// ******* debug2PrintNextLogMessages ******************************************
/**
  * Prints new log message. Index if the first message is {@link #debug2LogIdx} which is incremented by this function.
  * Returns quietly if debug2 functionality is not supported.
  * @param out destination for printing the messages.
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws UsbException if a communication error occurs.
  */
    public void debug2PrintNextLogMessages ( PrintStream out ) throws UsbException, InvalidFirmwareException {
	try {
	    String str;
	    do {
		str = debug2GetNextLogMessage();
		if ( str != null ) out.println(str);
	    } while ( str != null );
	} catch ( CapabilityException e ) {
	}
    }
 
 
// ******* getUsb3Errors *******************************************************
/**
  * Reads USB 3.0 errors and stores them in {@link #usb3SndErrors} {@link #usb3RcvErrors}.
  * @throws InvalidFirmwareException if interface 1 is not supported or invalid result is returned.
  * @throws UsbException if a communication error occurs.
  * @throws CapabilityException Debug2 feature is not supported by firmware.
  */
    public void getUsb3Errors () throws UsbException, InvalidFirmwareException, CapabilityException {
	byte[] buf = new byte[4];
	checkCapability(CAPABILITY_DEBUG2);
	vendorRequest2(0x29, "Read Debug 2 Message", 0, 0, buf, 4);
	usb3SndErrors = (buf[0] & 255) | ((buf[1] & 255) << 8);
	usb3RcvErrors = (buf[2] & 255) | ((buf[3] & 255) << 8);
    }
 
 
// ******* flashUploadFirmware *************************************************
//  returns upload time in ms
/**
  * Upload the firmware to the Flash.
  * In order to start the uploaded firmware the device must be reset.
  * @param imgFile The firmware image.
  * @param force Skips the compatibility check if true.
  * @throws IncompatibleFirmwareException if the given firmware is not compatible to the installed one, see {@link #compatible(int,int,int,int)} (Upload can be enforced using the <tt>force</tt> parameter.)
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if EEPROM access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to upload the firmware.
  */
    private long flashUploadFirmware (ImgFile imgFile, boolean force ) throws IncompatibleFirmwareException, FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_FLASH);
	checkCapability(CAPABILITY_FX3);
	if ( !imgFile.isFx3 ) throw new IncompatibleFirmwareException("FX3 firmware required");
 
	final int pagesMax = 16*1024;
	int pages = 0;
	byte[][] buffer = new byte[pagesMax][];
 
	int pageSize;
	try {
	    pageSize = flashSectorSize();
	}
	catch ( UsbException e ) {
	    throw new FirmwareUploadException(e.getLocalizedMessage());
	}
 
 
// check for compatibility
	if ( (imgFile instanceof ZtexImgFile1) && (!force) && dev().valid() ) {
	    if ( ((ZtexImgFile1)imgFile).interfaceVersion() != 1 )
		throw new IncompatibleFirmwareException("Wrong interface version: Expected 1, got " + ((ZtexImgFile1)imgFile).interfaceVersion() );
 
	    if ( ! dev().compatible ( ((ZtexImgFile1)imgFile).productId(0), ((ZtexImgFile1)imgFile).productId(1), ((ZtexImgFile1)imgFile).productId(2), ((ZtexImgFile1)imgFile).productId(3) ) )
		throw new IncompatibleFirmwareException("Incompatible productId's: Current firmware: " + ZtexDevice1.byteArrayString(dev().productId()) 
		    + "  Img File: " + ZtexDevice1.byteArrayString(((ZtexImgFile1)imgFile).productId()) );
	}
 
	buffer[0] = new byte[pageSize];
	buffer[0][0]='C';
	buffer[0][1]='Y';
	buffer[0][2]=32; 	// execution binary, 30MHz SPI speed
	buffer[0][3]=(byte) (0xb0 & 255);
 
	int ptr = 4, i = 0, cs = 0;
 
	while ( i < imgFile.data.length ) {
	    while (i<imgFile.data.length && (imgFile.data[i]<0 || imgFile.data[i]>255) )
		i+=1;
 
	    int j=0;
	    while ( i+j*4+3<imgFile.data.length && 
	            (  (imgFile.data[i+j*4+0]>=0 && imgFile.data[i+j*4+0]<256)
		    || (imgFile.data[i+j*4+1]>=0 && imgFile.data[i+j*4+1]<256) 
		    || (imgFile.data[i+j*4+2]>=0 && imgFile.data[i+j*4+2]<256) 
		    || (imgFile.data[i+j*4+3]>=0 && imgFile.data[i+j*4+3]<256) ) )
		j+=1;
	    if ( j > 0 ) {
		for (int k=ptr/pageSize + 1; k <= (ptr + 8+j*4+11)/pageSize; k++ )	// also considers 12 bytes for the last data block
		    buffer[k] = new byte[pageSize];
 
		buffer[(ptr+0)/pageSize][(ptr+0) % pageSize] = (byte) (j & 255);		// length
		buffer[(ptr+1)/pageSize][(ptr+1) % pageSize] = (byte) ((j >> 8) & 255);	
		buffer[(ptr+2)/pageSize][(ptr+2) % pageSize] = (byte) ((j >> 16) & 255);	
		buffer[(ptr+3)/pageSize][(ptr+3) % pageSize] = (byte) ((j >> 24) & 255);	
 
		long a = ImgFile.uncompressAddr(i);
//		System.out.println(i+"  "+Long.toHexString(a));	    	    
		if ( (a & 3) !=0 ) throw new InvalidFirmwareException("Invalid address alignment");
		buffer[(ptr+4)/pageSize][(ptr+4) % pageSize] = (byte) (a & 255);		// address
		buffer[(ptr+5)/pageSize][(ptr+5) % pageSize] = (byte) ((a >> 8) & 255);	
		buffer[(ptr+6)/pageSize][(ptr+6) % pageSize] = (byte) ((a >> 16) & 255);	
		buffer[(ptr+7)/pageSize][(ptr+7) % pageSize] = (byte) ((a >> 24) & 255);	
 
		ptr+=8;
		for ( int k=0; k<j*4; k++ )  							// data
		    buffer[(ptr+k)/pageSize][(ptr+k) % pageSize] = (byte) imgFile.data[i+k];
		for ( int k=0; k<j*4; k+=4 )  							// data
	    	    cs += (imgFile.data[i+k] & 255) | ((imgFile.data[i+k+1] & 255)<<8) | ((imgFile.data[i+k+2] & 255)<<16) | ((imgFile.data[i+k+3] & 255) << 24);
		ptr+=j*4;
		i+=j*4;
	    }
	}
 
	buffer[(ptr+0)/pageSize][(ptr+0) % pageSize] = 0;						// last record
	buffer[(ptr+1)/pageSize][(ptr+1) % pageSize] = 0;
	buffer[(ptr+2)/pageSize][(ptr+2) % pageSize] = 0;
	buffer[(ptr+3)/pageSize][(ptr+3) % pageSize] = 0;
 
	buffer[(ptr+4)/pageSize][(ptr+4) % pageSize] = (byte) (imgFile.startVector & 255);		// start vector
	buffer[(ptr+5)/pageSize][(ptr+5) % pageSize] = (byte) ((imgFile.startVector >> 8) & 255);	
	buffer[(ptr+6)/pageSize][(ptr+6) % pageSize] = (byte) ((imgFile.startVector >> 16) & 255);	
	buffer[(ptr+7)/pageSize][(ptr+7) % pageSize] = (byte) ((imgFile.startVector >> 24) & 255);	
 
	buffer[(ptr+8)/pageSize][(ptr+8) % pageSize] = (byte) (cs & 255);				// check sum
	buffer[(ptr+9)/pageSize][(ptr+9) % pageSize] = (byte) ((cs >> 8) & 255);	
	buffer[(ptr+10)/pageSize][(ptr+10) % pageSize] = (byte) ((cs >> 16) & 255);	
	buffer[(ptr+11)/pageSize][(ptr+11) % pageSize] = (byte) ((cs >> 24) & 255);	
 
	if ( config!=null && (ptr+11>config.getBitstreamStart()) ) {
	    throw new FirmwareUploadException("Firmware to large for the reserved area: " + toHumanStr(ptr+11) + " Bytes > " + toHumanStr(config.getBitstreamStart()) + " Bytes" );
	}
 
/*	try {
	    FileOutputStream out = new FileOutputStream("test.img");
	    for (int k=0; k<=(ptr+11)/pageSize; k++ )
		out.write(buffer[k], 0, Math.min(pageSize,ptr+12-k*pageSize));
	    out.close();
	}
	catch (Exception e) {
	    System.out.println("Error: "+e.getLocalizedMessage() );
	} */
 
	// write firmware
	long t0 = new Date().getTime();
	try {
	    int j=(ptr+11)/pageSize;
	    for (int k=0; k<=j; k++) {
		System.out.print("\rWriting sector " + (k+1) + " of " + (j+1));
		flashWriteSector( k, 1, buffer[k] );	// write the Bitstream sectors
	    }
	    System.out.println();
	}
	catch ( UsbException e ) {
	    throw new FirmwareUploadException(e.getLocalizedMessage());
	}
 
 
	return new Date().getTime() - t0;
    }
 
 
// ******* flashDisableFirmware *************************************************
/**
  * Disables the firmware stored in the Flash.
  * This is achieved by writing a "0" to the address 0.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if Flash access is not supported by the firmware.
  * @throws FirmwareUploadException if an error occurred while attempting to disable the firmware.
  */
    private void flashDisableFirmware ( ) throws FirmwareUploadException, InvalidFirmwareException, CapabilityException {
	checkCapability(CAPABILITY_FLASH);
	checkCapability(CAPABILITY_FX3);
 
	int pageSize;
	try {
	    pageSize = flashSectorSize();
	}
	catch ( UsbException e ) {
	    throw new FirmwareUploadException(e.getLocalizedMessage());
	}
 
	byte[] buf = new byte[pageSize];
 
	if ( config!=null && (config.getBitstreamStart()==0) ) {
	    System.err.println("Warning: No space reserved for firmware: firmware is not disabled");
	    return;
	}
 
	try {
	    flashReadSector(0, 1, buf);
	    buf[0] = 0;
	    buf[1] = 0;
	    flashWriteSector(0, 1, buf);
	}
	catch ( UsbException e ) {
	    throw new FirmwareUploadException(e.getLocalizedMessage());
	}
    }
 
 
// ******* defaultVersion *******************************************************
/**
  * Returns version of the default interface or 0 if default interface is not present.
  * @return version of the default interface
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbExcption if an error occurred while attempting to read default interface information.
  */
    public int defaultVersion ( ) throws InvalidFirmwareException, UsbException {
	byte[] buf = new byte[4];
 
	if ( defaultVersion >= 0 ) return defaultVersion;
	try {
	    checkCapability(CAPABILITY_DEFAULT);
	    vendorRequest2(0x64, "getDefaultInfo", buf, 4);
	    defaultVersion =  buf[0] & 255;
	    defaultOutEP =  buf[1] & 255;
	    defaultInEP =  buf[2] & 255;
	    defaultSubVersion =  buf[3] & 255;
	}
	catch ( CapabilityException e ) {
	    defaultVersion = 0;
	}
	return defaultVersion;
    }
 
 
// ******* defaultCheckVersion **************************************************
/**
  * Checks version of the default interface. 
  * If version number is less than required an exception it thrown. 
  * If the firmware is not up-to-date a warning is issued.
  * @param version The minimum required version. Minimum valid version is 1.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if an error occurred while attempting to read default interface information.
  */
    public void defaultCheckVersion ( int version ) throws InvalidFirmwareException, UsbException, CapabilityException {
        defaultVersion();
	if ( defaultVersion < 1 ) throw new CapabilityException("Default interface not supported: Udpdate Default Firmware");
	else if ( defaultVersion < version ) throw new CapabilityException("Invalid default interface version. Found: " + defaultVersion + ". Required: " + version + ". Update default firmware.");
	if ( !defaultDisableWarnings && ((defaultVersion<defaultLatestVersion) || ((defaultVersion==defaultLatestVersion) && (defaultSubVersion<defaultLatestSubVersion)) ) ) {
	    System.err.println("Waning: Default interface is outdated. Update recommended.");
	    defaultDisableWarnings = true;
	}
    }
 
 
// ******* defaultOutEP *********************************************************
/**
  * Returns output Endpoint of default interface 
  * used for high speed communication. The direction is seen from the host.
  * @return output Endpoint for high speed communication of the default interface 
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if an error occurred while attempting to read default interface information.
  */
    public int defaultOutEP() throws InvalidFirmwareException, UsbException, CapabilityException {
	defaultCheckVersion(1);
	return defaultOutEP;
    }
 
 
// ******* defaultInEP **********************************************************
/**
  * Returns input Endpoint of default interface 
  * used for high speed communication. The direction is seen from the host. The result is or'ed with 128.
  * @return input Endpoint for high speed communication of the default interface 
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if an error occurred while attempting to read default interface information.
  */
    public int defaultInEP() throws InvalidFirmwareException, UsbException, CapabilityException {
	defaultCheckVersion(1);
	return defaultInEP | 128;
    }
 
 
// ******* defaultSubVersion ***************************************************
/**
  * Returns sub-version of the default interface.
  * @return sub-version of the default interface
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws UsbExcption if an error occurred while attempting to read default interface information.
  */
    public int defaultSubVersion ( ) throws InvalidFirmwareException, UsbException, CapabilityException {
	defaultCheckVersion(1);
	return defaultSubVersion;
    }
 
// ******* defaultReset *********************************************************
/**
  * Assert the reset signal.
  * @param leave if true, the signal is left active. Otherwise only a short impulse is sent.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  */
    public void defaultReset( boolean leave ) throws InvalidFirmwareException, UsbException, CapabilityException {
	defaultCheckVersion(1);
	vendorCommand (0x60, "Send reset signal", leave ? 1 : 0, 0);
    }
 
// ******* defaultReset *********************************************************
/**
  * Assert the reset signal.
  * Equvalent to defaultReset(false), see {@link #defaultReset(boolean)}
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  */
    public void defaultReset () throws InvalidFirmwareException, UsbException, CapabilityException {
	defaultReset(false);
    }
 
// ******* defaultGpioCtl *******************************************************
/**
  * Reads and modifies the 4 GPIO pins.
  * @param mask Bitmask for the pins which are modified. 1 means a bit is set. Only the lowest 4 bits are significant.
  * @param value The bit values which are to be set. Only the lowest 4 bits are significant.
  * @return current values of the GPIO's
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  */
    public int defaultGpioCtl (int mask, int value) throws InvalidFirmwareException, UsbException, CapabilityException {
	defaultCheckVersion(1);
	byte[] buf = { 0 };
	vendorRequest2 (0x61, "Set/get GPIO's", value, mask, buf, 1);
	return buf[0];
    }
 
 
// ******* defaultLsiSet *******************************************************
/**
  * Send data to the low speed interface of default firmwares.
  * It's implemented as a SRAM-like interface and is typically used used to read/write configuration data, debug information or other things.
  * This function sets one register.
  * @param addr The address. Valid values are 0 to 255.
  * @param val The register data with a width of 32 Bit.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  * @throws IndexOutOfBoundsException If the address is out of range.
  */
    public void defaultLsiSet (int addr, int val) throws InvalidFirmwareException, UsbException, CapabilityException, IndexOutOfBoundsException {
	defaultCheckVersion(1);
	if ((addr<0) || (addr>255)) throw new IndexOutOfBoundsException("LSI register address out of range: "+addr+". Valid values are 0..255");
	byte[] buf = { (byte)(val), (byte)(val>>8), (byte)(val>>16), (byte)(val>>24), (byte)(addr & 255) };
	vendorCommand2 (0x62, "Set lsi registers", 0,0, buf, 5);
    }
 
 
// ******* defaultLsiSet *******************************************************
/**
  * Send data to the low speed interface of default firmwares.
  * It's implemented as a SRAM-like interface and is typically used used to read/write configuration data, debug information or other things.
  * This function sets a sequential set of registers.
  * @param addr The starting address address. Valid values are 0 to 255. Address is wrapped from 255 to 0.
  * @param val The register data array with a word width of 32 Bit.
  * @param length The length of the data array.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  * @throws IndexOutOfBoundsException If the address is out of range or length is > 256
  */
    public void defaultLsiSet (int addr, int[] val, int length) throws InvalidFirmwareException, UsbException, CapabilityException, IndexOutOfBoundsException {
	defaultCheckVersion(1);
	if ((addr<0) || (addr>255)) throw new IndexOutOfBoundsException("LSI register address out of range: "+addr+". Valid values are 0..255");
	if (length>256) throw new IndexOutOfBoundsException("LSI register set length to large: "+length+". Valid values are 1..256");
	byte buf[] = new byte[length*5];
	for (int i=0; i<length; i++) {
	    buf[i*5+0]=(byte)(val[i]);
	    buf[i*5+1]=(byte)(val[i]>>8);
	    buf[i*5+2]=(byte)(val[i]>>16);
	    buf[i*5+3]=(byte)(val[i]>>24);
	    buf[i*5+4]=(byte)(addr+i);
	}
	vendorCommand2 (0x62, "Write lsi registers", 0,0, buf, length*5);
    }
 
 
// ******* defaultLsiSet *******************************************************
/**
  * Send data to the low speed interface of default firmwares.
  * It's implemented as a SRAM-like interface and is typically used used to read/write configuration data, debug information or other things.
  * This function sets a random set of registers.
  * @param addr The register addresses. Valid values are 0 to 255.
  * @param val The register data array with a word width of 32 Bit.
  * @param length The length of the data array.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  * @throws IndexOutOfBoundsException If the address is out of range or length is > 256
  */
    public void defaultLsiSet (int[] addr, int[] val, int length) throws InvalidFirmwareException, UsbException, CapabilityException, IndexOutOfBoundsException {
	defaultCheckVersion(1);
	if (length>256) throw new IndexOutOfBoundsException("LSI register set length to large: "+addr+". Valid values are 1..256");
	byte buf[] = new byte[length*5];
	for (int i=0; i<length; i++) {
	    if ((addr[i]<0) || (addr[i]>255)) throw new IndexOutOfBoundsException("LSI register address out of range: "+addr[i]+". Valid values are 0..255");
	    buf[i*5+0]=(byte)(val[i]);
	    buf[i*5+1]=(byte)(val[i]>>8);
	    buf[i*5+2]=(byte)(val[i]>>16);
	    buf[i*5+3]=(byte)(val[i]>>24);
	    buf[i*5+4]=(byte)(addr[i]);
	}
	vendorCommand2 (0x62, "Write lsi registers", 0,0, buf, length*5);
    }
 
// ******* defaultLsiGet *******************************************************
/**
  * Read data from the low speed interface of default firmwares.
  * It's implemented as a SRAM-like interface and is typically used used to read/write configuration data, debug information or other things.
  * This function reads one register.
  * @param addr The address. Valid values are 0 to 255.
  * @return The register value with a width of 32 Bit.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  * @throws IndexOutOfBoundsException If the address is out of range.
  */
    public int defaultLsiGet (int addr) throws InvalidFirmwareException, UsbException, CapabilityException, IndexOutOfBoundsException {
	byte buf[] = new byte[4];
	defaultCheckVersion(1);
	if ((addr<0) || (addr>255)) throw new IndexOutOfBoundsException("LSI register address out of range: "+addr+". Valid values are 0..255");
	vendorRequest2 (0x63, "Read lsi registers", 0,addr, buf, 4);
	return (buf[0] & 255) | ((buf[1] & 255)<<8) | ((buf[2] & 255)<<16) | ((buf[3] & 255)<<24);
    }
 
// ******* defaultLsiGet *******************************************************
/**
  * Read data from the low speed interface of default firmwares.
  * It's implemented as a SRAM-like interface and is typically used used to read/write configuration data, debug information or other things.
  * This function reads a sequencial set of registers.
  * @param addr The start address. Valid values are 0 to 255. Address is wrapped from 255 to 0.
  * @param val The array where to store the register data with a word width of 32 Bit.
  * @param length The amount of register to be read.
  * @throws InvalidFirmwareException if interface 1 is not supported.
  * @throws CapabilityException if default interface if not present or version number is lower than required
  * @throws UsbExcption if a communication error occurred.
  * @throws IndexOutOfBoundsException If the address is out of range or length is > 256
  */
    public void defaultLsiGet (int addr, int[] val, int length) throws InvalidFirmwareException, UsbException, CapabilityException, IndexOutOfBoundsException {
	byte buf[] = new byte[length*4];
	defaultCheckVersion(1);
	if ((addr<0) || (addr>255)) throw new IndexOutOfBoundsException("LSI register address out of range: "+addr+". Valid values are 0..255");
	if (length>256) throw new IndexOutOfBoundsException("LSI register set length to large: "+addr+". Valid values are 1..256");
	vendorRequest2 (0x63, "Read lsi registers", 0,addr, buf, length*4);
	for (int i=0; i<length; i++)
	    val[i] = (buf[i*4+0] & 255) | ((buf[i*4+1] & 255)<<8) | ((buf[i*4+2] & 255)<<16) | ((buf[i*4+3] & 255)<<24);
    }
 
}    
 

Compare with Previous | Blame | View Log

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.