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

Subversion Repositories usb_fpga_1_2

[/] [usb_fpga_1_2/] [trunk/] [docs/] [java/] [ztex/] [package-summary.html] - Blame information for rev 9

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 3 ZTEX 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 
<!--NewPage-->
3 
<HTML>
4 
<HEAD>
5 9 ZTEX 
<!-- Generated by javadoc (build 1.6.0_18) on Thu Apr 12 22:51:27 CEST 2012 -->
6 3 ZTEX 
<TITLE>
7 
ztex
8 
</TITLE>
9 
 
10 9 ZTEX 
<META NAME="date" CONTENT="2012-04-12">
11 3 ZTEX 
 
12 
<LINK REL ="stylesheet" TYPE="text/css" HREF="../stylesheet.css" TITLE="Style">
13 
 
14 
<SCRIPT type="text/javascript">
15 
function windowTitle()
16 
{
17 
    if (location.href.indexOf('is-external=true') == -1) {
18 
        parent.document.title="ztex";
19 
    }
20 
}
21 
</SCRIPT>
22 
<NOSCRIPT>
23 
</NOSCRIPT>
24 
 
25 
</HEAD>
26 
 
27 
<BODY BGCOLOR="white" onload="windowTitle();">
28 
<HR>
29 
 
30 
 
31 
<!-- ========= START OF TOP NAVBAR ======= -->
32 
<A NAME="navbar_top"><!-- --></A>
33 
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
34 
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
35 
<TR>
36 
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
37 
<A NAME="navbar_top_firstrow"><!-- --></A>
38 
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
39 
  <TR ALIGN="center" VALIGN="top">
40 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
41 
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
42 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
43 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
44 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
45 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
46 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
47 
  </TR>
48 
</TABLE>
49 
</TD>
50 
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
51 
</EM>
52 
</TD>
53 
</TR>
54 
 
55 
<TR>
56 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57 
&nbsp;<A HREF="../ch/ntb/usb/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
58 
&nbsp;NEXT PACKAGE</FONT></TD>
59 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
60 
  <A HREF="../index.html?ztex/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
61 
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
62 
&nbsp;<SCRIPT type="text/javascript">
63 
  <!--
64 
  if(window==top) {
65 
    document.writeln('<A HREF="../allclasses-noframe.html"><B>All Classes</B></A>');
66 
  }
67 
  //-->
68 
</SCRIPT>
69 
<NOSCRIPT>
70 
  <A HREF="../allclasses-noframe.html"><B>All Classes</B></A>
71 
</NOSCRIPT>
72 
 
73 
 
74 
</FONT></TD>
75 
</TR>
76 
</TABLE>
77 
<A NAME="skip-navbar_top"></A>
78 
<!-- ========= END OF TOP NAVBAR ========= -->
79 
 
80 
<HR>
81 
<H2>
82 
Package ztex
83 
</H2>
84 
The Java API of the <a href="http://www.ztex.de/firmware-kit/index.e.html">ZTEX EZ-USB SDK</a>.
85 
<P>
86 
<B>See:</B>
87 
<BR>
88 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#package_description"><B>Description</B></A>
89 
<P>
90 
 
91 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
92 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
93 
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
94 
<B>Class Summary</B></FONT></TH>
95 
</TR>
96 
<TR BGCOLOR="white" CLASS="TableRowColor">
97 
<TD WIDTH="15%"><B><A HREF="../ztex/EzUsb.html" title="class in ztex">EzUsb</A></B></TD>
98 
<TD>Provides methods for uploading firmware to Cypress EZ-USB devices.</TD>
99 
</TR>
100 
<TR BGCOLOR="white" CLASS="TableRowColor">
101 
<TD WIDTH="15%"><B><A HREF="../ztex/IhxFile.html" title="class in ztex">IhxFile</A></B></TD>
102 
<TD>A class representing a firmware image loaded from an ihx (Intel Hex format) file.</TD>
103 
</TR>
104 
<TR BGCOLOR="white" CLASS="TableRowColor">
105 
<TD WIDTH="15%"><B><A HREF="../ztex/JInputStream.html" title="class in ztex">JInputStream</A></B></TD>
106 
<TD>Creates an input stream from a regular file or a system resource file (i.e. a file from the current jar file).</TD>
107 
</TR>
108 
<TR BGCOLOR="white" CLASS="TableRowColor">
109 
<TD WIDTH="15%"><B><A HREF="../ztex/Ztex1.html" title="class in ztex">Ztex1</A></B></TD>
110 
<TD>This class implements the interface-independent part of the communication protocol for the interaction with the ZTEX firmware.</TD>
111 
</TR>
112 
<TR BGCOLOR="white" CLASS="TableRowColor">
113 
<TD WIDTH="15%"><B><A HREF="../ztex/Ztex1v1.html" title="class in ztex">Ztex1v1</A></B></TD>
114 
<TD>This class implements the communication protocol of the interface version 1 for the interaction with the ZTEX firmware.</TD>
115 
</TR>
116 
<TR BGCOLOR="white" CLASS="TableRowColor">
117 
<TD WIDTH="15%"><B><A HREF="../ztex/ZtexDevice1.html" title="class in ztex">ZtexDevice1</A></B></TD>
118 
<TD>A class representing an EZ-USB device that supports the ZTEX descriptor 1 or an unconfigured EZ-USB device.</TD>
119 
</TR>
120 
<TR BGCOLOR="white" CLASS="TableRowColor">
121 
<TD WIDTH="15%"><B><A HREF="../ztex/ZtexIhxFile1.html" title="class in ztex">ZtexIhxFile1</A></B></TD>
122 
<TD>Represents a firmware image with ZTEX descriptor 1 loaded from an ihx (Intel Hex format) file.</TD>
123 
</TR>
124 
<TR BGCOLOR="white" CLASS="TableRowColor">
125 
<TD WIDTH="15%"><B><A HREF="../ztex/ZtexScanBus1.html" title="class in ztex">ZtexScanBus1</A></B></TD>
126 
<TD>A class used for finding the EZ-USB devices on the USB.</TD>
127 
</TR>
128 
</TABLE>
129 
&nbsp;
130 
 
131 
<P>
132 
 
133 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
134 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
135 
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
136 
<B>Exception Summary</B></FONT></TH>
137 
</TR>
138 
<TR BGCOLOR="white" CLASS="TableRowColor">
139 
<TD WIDTH="15%"><B><A HREF="../ztex/AlreadyConfiguredException.html" title="class in ztex">AlreadyConfiguredException</A></B></TD>
140 
<TD>Thrown if the FPGA is already configured.</TD>
141 
</TR>
142 
<TR BGCOLOR="white" CLASS="TableRowColor">
143 
<TD WIDTH="15%"><B><A HREF="../ztex/BitstreamReadException.html" title="class in ztex">BitstreamReadException</A></B></TD>
144 
<TD>Signals that an error occurred while attempting to read a bitstream.</TD>
145 
</TR>
146 
<TR BGCOLOR="white" CLASS="TableRowColor">
147 
<TD WIDTH="15%"><B><A HREF="../ztex/BitstreamUploadException.html" title="class in ztex">BitstreamUploadException</A></B></TD>
148 
<TD>Signals that an error occurred while attempting to upload the bitstream.</TD>
149 
</TR>
150 
<TR BGCOLOR="white" CLASS="TableRowColor">
151 
<TD WIDTH="15%"><B><A HREF="../ztex/CapabilityException.html" title="class in ztex">CapabilityException</A></B></TD>
152 
<TD>Thrown is a required capability is not available.</TD>
153 
</TR>
154 
<TR BGCOLOR="white" CLASS="TableRowColor">
155 
<TD WIDTH="15%"><B><A HREF="../ztex/DeviceLostException.html" title="class in ztex">DeviceLostException</A></B></TD>
156 
<TD>Thrown if a device went lost after renumeration.</TD>
157 
</TR>
158 
<TR BGCOLOR="white" CLASS="TableRowColor">
159 8 ZTEX 
<TD WIDTH="15%"><B><A HREF="../ztex/DeviceNotSupportedException.html" title="class in ztex">DeviceNotSupportedException</A></B></TD>
160 
<TD>Thrown if a device is not supported, i.e. has the wrong USB ID's.</TD>
161 
</TR>
162 
<TR BGCOLOR="white" CLASS="TableRowColor">
163 3 ZTEX 
<TD WIDTH="15%"><B><A HREF="../ztex/FirmwareUploadException.html" title="class in ztex">FirmwareUploadException</A></B></TD>
164 
<TD>Signals that an error occured while attempting to upload the firmware.</TD>
165 
</TR>
166 
<TR BGCOLOR="white" CLASS="TableRowColor">
167 
<TD WIDTH="15%"><B><A HREF="../ztex/IhxFileDamagedException.html" title="class in ztex">IhxFileDamagedException</A></B></TD>
168 
<TD>Signals that an ihx file is corrupt.</TD>
169 
</TR>
170 
<TR BGCOLOR="white" CLASS="TableRowColor">
171 
<TD WIDTH="15%"><B><A HREF="../ztex/IhxParseException.html" title="class in ztex">IhxParseException</A></B></TD>
172 
<TD>Signals that an error occurred while attempting to decode the ihx file.</TD>
173 
</TR>
174 
<TR BGCOLOR="white" CLASS="TableRowColor">
175 
<TD WIDTH="15%"><B><A HREF="../ztex/IncompatibleFirmwareException.html" title="class in ztex">IncompatibleFirmwareException</A></B></TD>
176 
<TD>Thrown while attempting to overwrite an existing firmware with an incompatible one.</TD>
177 
</TR>
178 
<TR BGCOLOR="white" CLASS="TableRowColor">
179 
<TD WIDTH="15%"><B><A HREF="../ztex/InvalidFirmwareException.html" title="class in ztex">InvalidFirmwareException</A></B></TD>
180 
<TD>Thrown if a device runs with no or the wrong firmware, i.e. if the ZTEX descriptor is not found or damaged.</TD>
181 
</TR>
182 
<TR BGCOLOR="white" CLASS="TableRowColor">
183 
<TD WIDTH="15%"><B><A HREF="../ztex/UsbException.html" title="class in ztex">UsbException</A></B></TD>
184 
<TD>Signals an USB error.</TD>
185 
</TR>
186 
</TABLE>
187 
&nbsp;
188 
 
189 
<P>
190 
<A NAME="package_description"><!-- --></A><H2>
191 
Package ztex Description
192 
</H2>
193 
 
194 
<P>
195 
The Java API of the <a href="http://www.ztex.de/firmware-kit/index.e.html">ZTEX EZ-USB SDK</a>.
196 
<p>
197 
This API is the host-side counterpart of the Firmware-Kit and allows user software to interact with
198 
EZ-USB devices running with such firmware. It uses <a href="../ch/ntb/usb/package-summary.html">libusbJava</a>, a Java wrapper
199 
for the libusb 0.1 and the libusb-win32 USB libraries. This API is known to run on Linux and Windows, but should work on every operating
200 
system which supports libusb and Java.
201 
<p>
202 
<h2>Features</h2>
203 
The main features are:
204 
<ul>
205 
    <li> Platform independent host software. It is possible to pack all necessary files (libusb libraries, firmware, bitstream) into
206 
         one single jar archive which runs on both, Linux and Windows (and other OS's that support libusb and Java) </li>
207 
    <li> Licensed as Open Source under GPLv3 </li>
208 
    <li> Firmware upload directly into the EZ-USB Microcontroller</li>
209 
    <li> Access to EEPROM memory</li>
210 
    <li> Firmware upload to EEPROM</li>
211 
    <li> Support of Flash memory </li>
212 
    <li> Bitstream upload directly to the FPGA (for <a href="http://www.ztex.de/usb-fpga-1/usb-fpga-1.2.e.html">ZTEX USB-FPGA-Modules</a>)</li>
213 
    <li> Bitstream upload to Flash memory (for <a href="http://www.ztex.de/usb-fpga-1/usb-fpga-1.2.e.html">ZTEX USB-FPGA-Modules</a>)</li>
214 
</ul>
215 
 
216 
<p>
217 
<h2>Interaction with the firmware</h2>
218 
Firmware built using the <a href="http://www.ztex.de/firmware-kit/index.e.html">Firmware Development Kit</a> supports an additional descriptor, the ZTEX descriptor 1. This descriptor
219 
identifies the device and firmware, provides compatibility information (e.g. to avoid that a device is loaded with the wrong firmware)
220 
and specifies the communication protocol. A description of the descriptor is given in <A HREF="../ztex/ZtexDevice1.html" title="class in ztex"><CODE>ZtexDevice1</CODE></A>.
221 
<p>
222 
The communication protocol defines how the functions provided by the firmware (see main features above)
223 
can be accessed. Currently there is only one protocol implemented, the so called interface 1.
224 
A description of the interface is given in <A HREF="../ztex/Ztex1v1.html" title="class in ztex"><CODE>Ztex1v1</CODE></A>.
225 
<p>
226 
The most importand classes for the interaction with the EZ-USB device / firmware are
227 
<p>
228 
<table bgcolor="#404040" cellspacing=1 cellpadding=4>
229 
  <tr>
230 
     <td bgcolor="#ffffff" valign="top"><A HREF="../ztex/ZtexDevice1.html" title="class in ztex"><CODE>ZtexDevice1</CODE></A></td>
231 
     <td bgcolor="#ffffff" valign="top">Represents an EZ-USB device that supports ZTEX descriptor 1. These devices can be found using <A HREF="../ztex/ZtexScanBus1.html" title="class in ztex"><CODE>ZtexScanBus1</CODE></A>. </td>
232 
  </tr>
233 
  <tr>
234 
     <td bgcolor="#ffffff" valign="top"><A HREF="../ztex/Ztex1.html" title="class in ztex"><CODE>Ztex1</CODE></A></td>
235 
     <td bgcolor="#ffffff" valign="top">Implementation of interface-independent part of the communication protocol, e.g. uploading the firmware to the EZ-USB and renumeration management.</td>
236 
  </tr>
237 
  <tr>
238 
     <td bgcolor="#ffffff" valign="top"><A HREF="../ztex/Ztex1v1.html" title="class in ztex"><CODE>Ztex1v1</CODE></A></td>
239 
     <td bgcolor="#ffffff" valign="top">Implemenetaion of the Interface 1, i.e. the interface dependent part of the communication protocol.</td>
240 
  </tr>
241 
</table>
242 
 
243 
<p>
244 4 ZTEX 
<h2>SDK overview</h2>
245 3 ZTEX 
The following diagram gives an overview about the usage of the different parts of the <a href="http://www.ztex.de/firmware-kit/index.e.html">ZTEX EZ-USB SDK</a>.
246 
<p>
247 
<img src="../../imgs/ztex_firmware_kit-diagram.png" width="660" height="600" alt="ZTEX EZ-USB SDK overview for Linux and Windows">
248 
<p>
249 
The host software usually consists of a single jar archive which contains
250 
<ul>
251 
    <li> all necessary Java bytecode;  </li>
252 
    <li> the libusb Java wrapper libraries for Linux (libusbJava.so) and Windows (libusbJava.dll), which are statically linked against libusb (no libusb installation required); </li>
253 
    <li> the firmware for the EZ-USB device (unless not installed in EEPROM); </li>
254 
    <li> Bitstream for the FPGA (if required). </li>
255 
</ul>
256 
This single jar archive runs on both, Linux and Windows (or other OS's that support libusb and Java).
257 
<p>
258 
On Linux this jar archive has no additional software requirements. The libusb(Java) library communicates directly with the EZ-USB device using kernel routines.
259 
<p>
260 
On Windows a libusb driver is required. (This driver is a part of the ZTEX SDK package). The libusb(Java) library communicates with the EZ-USB device using that driver.
261 
 
262 
<h2>Related Resources</h2>
263 
For more information about this project visit the
264 
<a href="http://www.ztex.de/firmware-kit/index.e.html">ZTEX EZ-USB SDK</a> page.
265 
<P>
266 
 
267 
<P>
268 
<DL>
269 
</DL>
270 
<HR>
271 
 
272 
 
273 
<!-- ======= START OF BOTTOM NAVBAR ====== -->
274 
<A NAME="navbar_bottom"><!-- --></A>
275 
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
276 
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
277 
<TR>
278 
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
279 
<A NAME="navbar_bottom_firstrow"><!-- --></A>
280 
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
281 
  <TR ALIGN="center" VALIGN="top">
282 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
283 
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
284 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
285 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
286 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
287 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
288 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
289 
  </TR>
290 
</TABLE>
291 
</TD>
292 
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
293 
</EM>
294 
</TD>
295 
</TR>
296 
 
297 
<TR>
298 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
299 
&nbsp;<A HREF="../ch/ntb/usb/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
300 
&nbsp;NEXT PACKAGE</FONT></TD>
301 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
302 
  <A HREF="../index.html?ztex/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
303 
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
304 
&nbsp;<SCRIPT type="text/javascript">
305 
  <!--
306 
  if(window==top) {
307 
    document.writeln('<A HREF="../allclasses-noframe.html"><B>All Classes</B></A>');
308 
  }
309 
  //-->
310 
</SCRIPT>
311 
<NOSCRIPT>
312 
  <A HREF="../allclasses-noframe.html"><B>All Classes</B></A>
313 
</NOSCRIPT>
314 
 
315 
 
316 
</FONT></TD>
317 
</TR>
318 
</TABLE>
319 
<A NAME="skip-navbar_bottom"></A>
320 
<!-- ======== END OF BOTTOM NAVBAR ======= -->
321 
 
322 
<HR>
323 
 
324 
</BODY>
325 
</HTML>

powered by: WebSVN 2.1.0

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