Skip to content

Simples PC-Programm zur Ansteuerung des USB-Gerätes das mit "f1usb" erstellt wurde, auf Basis von libusb

License

Notifications You must be signed in to change notification settings

Erlkoenig90/usbclient

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

usbclient

Dies ist ein simples PC-Programm zur Ansteuerung des USB-Gerätes welches im Projekt f1usb entwickelt wurde. Es basiert auf libusb und funktioniert unter Linux und Windows. Auf der Releases-Seite können fertig kompilierte Dateien heruntergeladen werden.

Kompilieren

Das Projekt nutzt CMake als Build-System. Unter Linux kann es so kompiliert werden:

cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release
make

Statt "Release" kann auch "Debug" angegeben werden um Optimierungen aus- und Debuginformationen einzuschalten.

Unter Windows kann mit CMake ein Visual Studio-Projekt für 64bit erzeugt werden:

cmake -G "Visual Studio 15 2017 Win64"

Alternativ für 32bit:

cmake -G "Visual Studio 15 2017"

Das Visual Studio-Projekt enthält vier Konfigurationen:

Name Beschreibung
Debug Unoptimierte Debug-Version, dynamisch gelinkt (libusb-DLL wird zur Ausführung gebraucht)
Release Optimiertes Programm mit statisch gelinkten Bibliotheken (keine DLLs benötigt)
MinSizeRel Auf Größe optimiertes Programm mit dynamisch gelinkten Bibliotheken (libusb-DLL wird zur Ausführung gebraucht)
RelWithDebInfo Wie Release, mit Debug-Informationen

Unter Linux wird pkg-config genutzt, um libusb zu finden, welches per Paketmanager installiert werden muss. Für Windows enthält das Projekt fertig kompilierte Binaries im "libusb-msvc"-Verzeichnis, die automatisch mit gelinkt werden. Diese wurden mit und für Visual Studio 15 2017 erstellt. Für ältere Versionen können die Bibliotheksdateien von der libusb-Website heruntergeladen werden. Die statische Version davon funktioniert dann aber nicht mit der aktuellen Visual Studio-Version.

Tip: Alle Dateien, die nicht zum git-Repository gehören, können so gelöscht werden:

git clean -fdx

So kann man die große Zahl an durch CMake und Visual Studio angelegten Dateien aufräumen, ohne den Source-Code zu löschen.

Funktion

Das Programm greift via libusb direkt auf ein am PC angeschlossenes Gerät zu, welches mit dem "USB-Hello-World" f1usb erstellt sein sollte. Es zeigt zunächst die Adressen und ID's aller angeschlossenen Geräte an, öffnet falls möglich das mit der passenden ID, und zeigt dessen String-Deskriptoren an. Es fragt den aktuellen Zustand der LED's ab, und erlaubt das Setzen der LED's auf die über zwei Kommandozeilen-Argumente anzugebenden Zustände, welche 1 oder 0 sein müssen. Außerdem sendet es eine zufällige Folge an Bytes an den Bulk Endpoint 1, empfängt die gleich lange Antwort, zeigt beide an und prüft, ob in der Antwort wie gewünscht jedes Byte umgedreht wurde. Ein Beispiel-Lauf des Programms ist (gekürzt):

$ ./usbclient 0 1
Angeschlossene Geräte:
2:8:5 04f2:b336
2:5:9 04ca:300b
2:2:10 dead:beef
2:4:6 046d:0a1f
[...]
Manufacturer: ACME Corp.
Product: Fluxkompensator
Serial: 42-1337-47/11
LED1: 1
LED2: 0
Sende Daten     : de, c8, 1d, a0, 7b, 33, 65, f0 [...]
Empfangene Daten: 7b, 13, b8, 05, de, cc, a6, 0f [...]
Daten stimmen überein: true

Lizenz

Dieser Code steht unter der BSD-Lizenz, siehe dazu die Datei LICENSE.

About

Simples PC-Programm zur Ansteuerung des USB-Gerätes das mit "f1usb" erstellt wurde, auf Basis von libusb

Resources

License

Stars

Watchers

Forks

Packages

No packages published