Gecko3 - CCC Event Weblog

7.3. Gecko Library
bisher Root Rechte nötig sind. Es existieren unter Linux mehrere Möglichkeiten um die
Zugriffsrechte von USB Geräten zu beeinflussen. Die derzeit aktuelle und flexibelste Lösung
in diesem Zusammenhang ist der udev Dämon, der alle zur Laufzeit hinzugefügten bzw.
entfernten Geräte verwaltet. Einer der nächsten Schritte in der Entwicklung der Hostsoftware
unter Linux sollte es sein, udev so zu konfigurieren, dass alle Studenten auf den Gecko
zugreiffen können.
7.3. Gecko Library
In diesem Unterkapitel werden die von der Gecko Library zur Verfügung gestellten Funktionen
beschrieben und erklärt wie sie das Gecko Board ansteuern. Die Namen der Funktionen
sind so gewählt, dass man sofort sieht ob sie zur Kommunikation oder Administration (beginnen
immer mit adm) dienen. Alle Funktionen liefern als Rückgabewert einen Binärwert
zurück der aussagt, ob die Funktion erfolgreich war oder nicht.
• bool open()
Diese Funktion öffnet eine Kommunikationsverbindung zum Gecko Board.
Sie entspricht mehrheitlich dem Beispiel in der libusb Dokumentation zum Suchen und
Öffnen eines USB Gerätes. Als erstes werden alle USB Busse und dann alle Geräte neu
eingelesen. Danach wird mit den so erhaltenen Informationen nach der Vendor und
Product ID des Gecko Boards gesucht. Bei Erfolg wird ein allfälliger Linux Kernel
Treiber entfernt und das Interface zur Kommunikation geöffnet. Die Funktion bricht
nach dem ersten Fund ab, es ist mit dieser Funktion nicht möglich mehrere Gecko
Boards am gleichen Rechner parallel zu betreiben.
• bool close()
Schliesst eine geöffnete Kommunikationsverbindung mit dem Gecko Board, wenn eine
solche existiert.
• bool read(QByteArray *readData, int byteCount)
Funktion um die im Parameter byteCount angegebene Anzahl Bytes vom Gecko Board
zu lesen und setzt diese Daten ans Ende des zur Verfügung gestellten QByteArrays.
Das ByteArray muss existieren.
Die Funktion führt einen einfachen Bulkread auf dem Kommunikationsinterface aus.
• bool write(QByteArray data)
Funktion um die Daten in einem QByteArray an das Gecko Board zu senden.
Die Funktion führt einen einfachen Bulkwrite auf dem Kommunikationsinterface aus.
• bool write(QFile &data)
Funktion um den Inhalt eines ganzen Files an das Gecko Board zu übertragen. Das
File muss existieren und geöffnet sein. Am Ende der Funktion zeigt der Filepointer auf
das Ende des Files.
Da die Bulkwrite Funktion der libusb nur einen Integerwert für die Anzahl Bytes
benutzt, muss die Übertragung eines ganzen Files in mehrere Transaktionen aufgeteilt
werden.
• bool admOpen()
Funktion zum Öffnen einer Administrationsverbindung zum Gecko Board.
Project Report 39