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

Subversion Repositories usb_fpga_2_13

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

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 2 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 
<!-- Generated by javadoc (build 1.6.0_18) on Wed Oct 30 21:18:14 CET 2013 -->
6 
<TITLE>
7 
ztex
8 
</TITLE>
9 
 
10 
<META NAME="date" CONTENT="2013-10-30">
11 
 
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/ConfigData.html" title="class in ztex">ConfigData</A></B></TD>
98 
<TD>This class represents the configuration data space of ZTEX FPGA Boards that support it.</TD>
99 
</TR>
100 
<TR BGCOLOR="white" CLASS="TableRowColor">
101 
<TD WIDTH="15%"><B><A HREF="../ztex/EzUsb.html" title="class in ztex">EzUsb</A></B></TD>
102 
<TD>Provides methods for uploading firmware to Cypress EZ-USB devices.</TD>
103 
</TR>
104 
<TR BGCOLOR="white" CLASS="TableRowColor">
105 
<TD WIDTH="15%"><B><A HREF="../ztex/IhxFile.html" title="class in ztex">IhxFile</A></B></TD>
106 
<TD>A class representing a firmware image loaded from an ihx (Intel Hex format) file.</TD>
107 
</TR>
108 
<TR BGCOLOR="white" CLASS="TableRowColor">
109 
<TD WIDTH="15%"><B><A HREF="../ztex/JInputStream.html" title="class in ztex">JInputStream</A></B></TD>
110 
<TD>Creates an input stream from a regular file or a system resource file (i.e. a file from the current jar file).</TD>
111 
</TR>
112 
<TR BGCOLOR="white" CLASS="TableRowColor">
113 
<TD WIDTH="15%"><B><A HREF="../ztex/Ztex1.html" title="class in ztex">Ztex1</A></B></TD>
114 
<TD>This class implements the interface-independent part of the communication protocol for the interaction with the ZTEX firmware.</TD>
115 
</TR>
116 
<TR BGCOLOR="white" CLASS="TableRowColor">
117 
<TD WIDTH="15%"><B><A HREF="../ztex/Ztex1v1.html" title="class in ztex">Ztex1v1</A></B></TD>
118 
<TD>This class implements the communication protocol of the interface version 1 for the interaction with the ZTEX firmware.</TD>
119 
</TR>
120 
<TR BGCOLOR="white" CLASS="TableRowColor">
121 
<TD WIDTH="15%"><B><A HREF="../ztex/ZtexDevice1.html" title="class in ztex">ZtexDevice1</A></B></TD>
122 
<TD>A class representing an EZ-USB device that supports the ZTEX descriptor 1 or an unconfigured EZ-USB device.</TD>
123 
</TR>
124 
<TR BGCOLOR="white" CLASS="TableRowColor">
125 
<TD WIDTH="15%"><B><A HREF="../ztex/ZtexIhxFile1.html" title="class in ztex">ZtexIhxFile1</A></B></TD>
126 
<TD>Represents a firmware image with ZTEX descriptor 1 loaded from an ihx (Intel Hex format) file.</TD>
127 
</TR>
128 
<TR BGCOLOR="white" CLASS="TableRowColor">
129 
<TD WIDTH="15%"><B><A HREF="../ztex/ZtexScanBus1.html" title="class in ztex">ZtexScanBus1</A></B></TD>
130 
<TD>A class used for finding the EZ-USB devices on the USB.</TD>
131 
</TR>
132 
</TABLE>
133 
&nbsp;
134 
 
135 
<P>
136 
 
137 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
138 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
139 
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
140 
<B>Exception Summary</B></FONT></TH>
141 
</TR>
142 
<TR BGCOLOR="white" CLASS="TableRowColor">
143 
<TD WIDTH="15%"><B><A HREF="../ztex/AlreadyConfiguredException.html" title="class in ztex">AlreadyConfiguredException</A></B></TD>
144 
<TD>Thrown if the FPGA is already configured.</TD>
145 
</TR>
146 
<TR BGCOLOR="white" CLASS="TableRowColor">
147 
<TD WIDTH="15%"><B><A HREF="../ztex/BitstreamReadException.html" title="class in ztex">BitstreamReadException</A></B></TD>
148 
<TD>Signals that an error occurred while attempting to read a bitstream.</TD>
149 
</TR>
150 
<TR BGCOLOR="white" CLASS="TableRowColor">
151 
<TD WIDTH="15%"><B><A HREF="../ztex/BitstreamUploadException.html" title="class in ztex">BitstreamUploadException</A></B></TD>
152 
<TD>Signals that an error occurred while attempting to upload the bitstream.</TD>
153 
</TR>
154 
<TR BGCOLOR="white" CLASS="TableRowColor">
155 
<TD WIDTH="15%"><B><A HREF="../ztex/CapabilityException.html" title="class in ztex">CapabilityException</A></B></TD>
156 
<TD>Thrown is a required capability is not available.</TD>
157 
</TR>
158 
<TR BGCOLOR="white" CLASS="TableRowColor">
159 
<TD WIDTH="15%"><B><A HREF="../ztex/DeviceLostException.html" title="class in ztex">DeviceLostException</A></B></TD>
160 
<TD>Thrown if a device went lost after renumeration.</TD>
161 
</TR>
162 
<TR BGCOLOR="white" CLASS="TableRowColor">
163 
<TD WIDTH="15%"><B><A HREF="../ztex/DeviceNotSupportedException.html" title="class in ztex">DeviceNotSupportedException</A></B></TD>
164 
<TD>Thrown if a device is not supported, i.e. has the wrong USB ID's.</TD>
165 
</TR>
166 
<TR BGCOLOR="white" CLASS="TableRowColor">
167 
<TD WIDTH="15%"><B><A HREF="../ztex/FirmwareUploadException.html" title="class in ztex">FirmwareUploadException</A></B></TD>
168 
<TD>Signals that an error occured while attempting to upload the firmware.</TD>
169 
</TR>
170 
<TR BGCOLOR="white" CLASS="TableRowColor">
171 
<TD WIDTH="15%"><B><A HREF="../ztex/IhxFileDamagedException.html" title="class in ztex">IhxFileDamagedException</A></B></TD>
172 
<TD>Signals that an ihx file is corrupt.</TD>
173 
</TR>
174 
<TR BGCOLOR="white" CLASS="TableRowColor">
175 
<TD WIDTH="15%"><B><A HREF="../ztex/IhxParseException.html" title="class in ztex">IhxParseException</A></B></TD>
176 
<TD>Signals that an error occurred while attempting to decode the ihx file.</TD>
177 
</TR>
178 
<TR BGCOLOR="white" CLASS="TableRowColor">
179 
<TD WIDTH="15%"><B><A HREF="../ztex/IncompatibleFirmwareException.html" title="class in ztex">IncompatibleFirmwareException</A></B></TD>
180 
<TD>Thrown while attempting to overwrite an existing firmware with an incompatible one.</TD>
181 
</TR>
182 
<TR BGCOLOR="white" CLASS="TableRowColor">
183 
<TD WIDTH="15%"><B><A HREF="../ztex/InvalidFirmwareException.html" title="class in ztex">InvalidFirmwareException</A></B></TD>
184 
<TD>Thrown if a device runs with no or the wrong firmware, i.e. if the ZTEX descriptor is not found or damaged.</TD>
185 
</TR>
186 
<TR BGCOLOR="white" CLASS="TableRowColor">
187 
<TD WIDTH="15%"><B><A HREF="../ztex/UsbException.html" title="class in ztex">UsbException</A></B></TD>
188 
<TD>Signals an USB error.</TD>
189 
</TR>
190 
</TABLE>
191 
&nbsp;
192 
 
193 
<P>
194 
<A NAME="package_description"><!-- --></A><H2>
195 
Package ztex Description
196 
</H2>
197 
 
198 
<P>
199 
The Java API of the <a href="http://www.ztex.de/firmware-kit/index.e.html">ZTEX EZ-USB SDK</a>.
200 
<p>
201 
This API is the host-side counterpart of the Firmware-Kit and allows user software to interact with
202 
EZ-USB devices running with such firmware. It uses <a href="../ch/ntb/usb/package-summary.html">libusbJava</a>, a Java wrapper
203 
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
204 
system which supports libusb and Java.
205 
<p>
206 
<h2>Features</h2>
207 
The main features are:
208 
<ul>
209 
    <li> Platform independent host software. It is possible to pack all necessary files (libusb libraries, firmware, bitstream) into
210 
         one single jar archive which runs on both, Linux and Windows (and other OS's that support libusb and Java) </li>
211 
    <li> Licensed as Open Source under GPLv3 </li>
212 
    <li> Firmware upload directly into the EZ-USB Microcontroller</li>
213 
    <li> Access to EEPROM memory</li>
214 
    <li> Firmware upload to EEPROM</li>
215 
    <li> Support of Flash memory </li>
216 
    <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>
217 
    <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>
218 
</ul>
219 
 
220 
<p>
221 
<h2>Interaction with the firmware</h2>
222 
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
223 
identifies the device and firmware, provides compatibility information (e.g. to avoid that a device is loaded with the wrong firmware)
224 
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>.
225 
<p>
226 
The communication protocol defines how the functions provided by the firmware (see main features above)
227 
can be accessed. Currently there is only one protocol implemented, the so called interface 1.
228 
A description of the interface is given in <A HREF="../ztex/Ztex1v1.html" title="class in ztex"><CODE>Ztex1v1</CODE></A>.
229 
<p>
230 
The most importand classes for the interaction with the EZ-USB device / firmware are
231 
<p>
232 
<table bgcolor="#404040" cellspacing=1 cellpadding=4>
233 
  <tr>
234 
     <td bgcolor="#ffffff" valign="top"><A HREF="../ztex/ZtexDevice1.html" title="class in ztex"><CODE>ZtexDevice1</CODE></A></td>
235 
     <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>
236 
  </tr>
237 
  <tr>
238 
     <td bgcolor="#ffffff" valign="top"><A HREF="../ztex/Ztex1.html" title="class in ztex"><CODE>Ztex1</CODE></A></td>
239 
     <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>
240 
  </tr>
241 
  <tr>
242 
     <td bgcolor="#ffffff" valign="top"><A HREF="../ztex/Ztex1v1.html" title="class in ztex"><CODE>Ztex1v1</CODE></A></td>
243 
     <td bgcolor="#ffffff" valign="top">Implemenetaion of the Interface 1, i.e. the interface dependent part of the communication protocol.</td>
244 
  </tr>
245 
</table>
246 
 
247 
<p>
248 
<h2>SDK overview</h2>
249 
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>.
250 
<p>
251 
<img src="../../imgs/ztex_firmware_kit-diagram.png" width="660" height="600" alt="ZTEX EZ-USB SDK overview for Linux and Windows">
252 
<p>
253 
The host software usually consists of a single jar archive which contains
254 
<ul>
255 
    <li> all necessary Java bytecode;  </li>
256 
    <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>
257 
    <li> the firmware for the EZ-USB device (unless not installed in EEPROM); </li>
258 
    <li> Bitstream for the FPGA (if required). </li>
259 
</ul>
260 
This single jar archive runs on both, Linux and Windows (or other OS's that support libusb and Java).
261 
<p>
262 
On Linux this jar archive has no additional software requirements. The libusb(Java) library communicates directly with the EZ-USB device using kernel routines.
263 
<p>
264 
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.
265 
 
266 
<h2>Related Resources</h2>
267 
For more information about this project visit the
268 
<a href="http://www.ztex.de/firmware-kit/index.e.html">ZTEX EZ-USB SDK</a> page.
269 
<P>
270 
 
271 
<P>
272 
<DL>
273 
</DL>
274 
<HR>
275 
 
276 
 
277 
<!-- ======= START OF BOTTOM NAVBAR ====== -->
278 
<A NAME="navbar_bottom"><!-- --></A>
279 
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
280 
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
281 
<TR>
282 
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
283 
<A NAME="navbar_bottom_firstrow"><!-- --></A>
284 
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
285 
  <TR ALIGN="center" VALIGN="top">
286 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
287 
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
288 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
289 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
290 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
291 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
292 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
293 
  </TR>
294 
</TABLE>
295 
</TD>
296 
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
297 
</EM>
298 
</TD>
299 
</TR>
300 
 
301 
<TR>
302 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
303 
&nbsp;<A HREF="../ch/ntb/usb/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
304 
&nbsp;NEXT PACKAGE</FONT></TD>
305 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
306 
  <A HREF="../index.html?ztex/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
307 
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
308 
&nbsp;<SCRIPT type="text/javascript">
309 
  <!--
310 
  if(window==top) {
311 
    document.writeln('<A HREF="../allclasses-noframe.html"><B>All Classes</B></A>');
312 
  }
313 
  //-->
314 
</SCRIPT>
315 
<NOSCRIPT>
316 
  <A HREF="../allclasses-noframe.html"><B>All Classes</B></A>
317 
</NOSCRIPT>
318 
 
319 
 
320 
</FONT></TD>
321 
</TR>
322 
</TABLE>
323 
<A NAME="skip-navbar_bottom"></A>
324 
<!-- ======== END OF BOTTOM NAVBAR ======= -->
325 
 
326 
<HR>
327 
 
328 
</BODY>
329 
</HTML>

powered by: WebSVN 2.1.0

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