Das SDK ist speziell für die ZTEX-Module entwickelt, funktioniert aber auch mit anderer EZ-USB basierter Hardware. Das SDK besteht aus einem Firmware-Entwicklungskit mit dazugehörigem API zur Entwicklung der Host-Software.

Das Paket ist quelloffen und wird wird unter GPLv3 vertrieben.

Das Paket wurde unter Linux und Windows getestet, sollte aber auch auf jeder anderen Plattform laufen, welche libusb und Java unterstützt. Die Java-Treiber-API ermöglicht die Entwicklung von plattformübergreifenden Geräte-Treibern.

Eigenschaften

Die Haupteigenschaften sind:

Firmware-Kit (für EZ-USB Mikrocontroller) in C geschrieben (erfordert SDCC-Compiler).
Zusammenbau der Firmware erfolgt mittels eines leistungsstarkem Makro-Prozessors, welcher es ermöglicht mit wenigen Makros alle erforderlichen Einstellungen festzulegen. Die benötigten USB-Deskriptoren und die dazugehörigen Routinen werden automatisch generiert.
Hostsoftware-API ist in Java geschrieben und ermöglicht Plattform-unabhängige Geräte-Treiber.
Als Open-Source unter GPLv3 lizenziert
Hauptfunktionen des Firmware-Kits / Treiber-API's:
- Hochladen der Firmware direkt in den EZ-USB Mikrocontroller
- EEPROM-Interface zum Lesen / Scheiben von Daten in den / aus dem EEPROM-Speicher
- Hochladen der Firmware in den EEPROM
- Zugriff auf microSD/*SD/MMC Flash-Speicherkarten im SPI-Modus
- Hochladen des Bitstreams in das FPGA für ZTEX USB-FPGA-Module
- Hochladen des Bitstreams in den Flash-Speicher und autonome FPGA-Konfiguration aus dem Flash-Speicher ZTEX USB-FPGA-Module

SDK Übersicht

Das folgende Diagramm gibt einen Überblick über den Einsatz der verschiedenen Bestandteile des ZTEX EZ-USB SDK.

ZTEX EZ-USB SDK Übersicht unter Linux und Windows

Die Firmware des EZ-USB-Gerätes wird mit dem Firmware-Entwicklungskit erstellt. Sie kann entweder mittels eines Hilfsprogramms oder durch die Hostsoftware durch Verwendung der Java API hochgeladen werden.

Die Hostsoftware besteht meistens aus einem einzigem jar-Archiv mit folgendem Inhalt:

Aller notwendiger Java-Bytecode
Die libusb Java Wrapper-Bibliotheken für Linux (libusbJava.so) und Windows (libusbJava.dll), welche statisch gegen libusb (d.h. keine libusb Installation erforderlich)
Die Firmware für das EZ-USB-Gerät (sofern nicht bereits im EEPROM installiert)
Der Bitstream für das FPGA (sofern erforderlich)

Dieses eine jar-Archiv läuft sowohl unter Linux als auch unter Windows (oder allen anderen Betriebssystemen welche libusb und Java unterstützen.)

Unter Linux hat dieses jar-Archiv keine weiteren Abhängigkeiten, da libusb(Java) direkt unter Zuhilfenahme von Kernel-Routinen mit dem EZ-USB-Gerät kommuniziert.

Unter Windows ist der libusb-Treiber erforderlich. (Dieser Treiber ist Bestandteil des ZTEX SDK-Paketes). Die libusb(Java)-Bibliothek kommuniziert mit dem EZ-USB-Gerät über diesen Treiber.

Andere Programmiersprachen

Geräte mit ZTEX-Firmware können generell relativ einfach mit Hilfe aller Programmiersprachen angesprochen werden, für die es eine libusb-Portierung gibt. Im Gegensatz zu Java stehen dann allerdings die Funktionen zum Hochladen der Firmware und des Bitstreams nicht mehr zur Verfügung, sodass hierfür das im SDK enthaltenen Werkzeug FWLoader verwendet werden muss.

Ein Beispiel mit C-Hostsoftware ist im SDK und auf der Beispiele-Seite enthalten.

Systemvoraussetzungen

Die Systemvoraussetzungen für das Kompilieren der Firmware und der Treiber sind

Java JDK 6 oder später
SDCC
MSys (nur für Windows, direkter Download)

Die Systemvoraussetzungen für das Ausführen der Beispiele bzw. der selbst erstellten Software sind

Java JRE 6 oder später

[Home] [Impressum]