Gecko3 - CCC Event Weblog

7. Hostsoftware
Funktioniert genau so wie die open() Funktion mit dem Unterschied, dass das Administrationsinterface
geöffnet wird.
• bool admClose()
Schliesst eine geöffnete Administrationsverbindung mit dem Gecko Board, falls eine
existiert.
• bool admConfigure(QFile &configData)
Funktion um den FPGA auf dem Gecko Board zu konfigurieren. Das File muss eine
korrekte Konfigurationsdatei ohne Header Informationen sein. Das File muss existieren
und geöffnet sein.
Um den FPGA zu konfigurieren muss zuerst der entsprechende Vendor Request gesendet
werden (siehe dazu Unterkapitel 6.8) und im Anschluss die Konfigurationsdaten.
Nach dem alle Daten der Konfigurationsdatei gesendet sind, muss ein Vendorrequest
gesendet werden, der den Abschluss bestätigt.
• bool admDownload(QFile &configData, int place)
Funktion zum Download von FPGA Konfigurationsdateien für den stand-alone Betrieb
des Gecko Boards. Das File muss eine korrekte Konfigurationsdatei ohne Header
Informationen sein. Das File muss existieren und geöffnet sein. Der Parameter place
gibt an, welcher Konfigurationsplatz beschrieben werden soll. Auf dem Gecko Board
können mehrere Konfigurationen parallel gespeichert werden und per Schalter ausgewählt
werden, welche geladen werden soll. Die Konstante GECKO MAX CONFIGS
die in dieser Library definiert ist, gibt an wie viele Plätze zur Verfügung stehen.
Der Ablauf ist der selbe wie bei der Konfiguration des FPGA, es werden nur andere
Vendor Requests gesendet.
• bool admFirmware(QFile &configData)
Funktion um eine neue Firmware für den EZ-USB FX2 auf das Gecko Board zu laden.
Die Firmware wird in das EEPROM geschrieben und wird nach einem Reset des EZ-
USB FX2 gestartet. Das File muss ein korrektes Firmware File im Format *.iic sein
(siehe dazu Unterkapitel 6.5). Wie bei den anderen Funktionen muss das File existieren
und geöffnet sein.
Die Funktion sendet den Vendor Request zum Senden einer Firmware, danach werden
die Daten aus dem Firmware File gesendet und am Schluss der Vendor Request zur
Bestätigung, dass alle Daten gesendet wurden.
• bool admGetFwVersion(QString *version)
Funktion zum Abfragen der Versionsnummer der EZ-USB FX2 Firmware. Der QString
muss existieren. Die Versionsnummer ist im Format X.XX und wird dem String angehängt.
Die Versionsnummer wird gelesen indem ein Vendor Request gesendet wird, der den
EZ-USB FX2 auffordert vier Bytes zurück zu senden. Dazu wird der Vendor Request
mit der Bitmaske verknüpft die das Bit für eine Lesetransaktion setzt.
Diese Funktionsbibliothek sollte später als dynamische Library kompiliert werden und
systemweit verfügbar gemacht werden.
40 Christoph Zimmermann