Dieser Text war 2006 noch nicht im Blog, ich habe den 2015 aus dem alten CMS überführt.

... nie wieder den Mauszeiger suchen!

… nie wieder den Mauszeiger suchen!

Das USB-Servo ist, wie der Name schon andeutet ein Servo das per USB angeschlossen und kontrolliert wird. Ein Servo ist ein Elektromotor der zum Beispiel zur Steuerung ferngesteuerter Spielzeuge eingesetzt wird. Ich habe dieses Projekt durchgeführt um eine Spielzeugfigur zu steuern. Die Puppe hat einen Knopf auf der Unterseite, sie fällt in sich zusammen wenn der Knopf gedrückt wird und steht wieder auf wenn losgelassen wird. Wenn der Computer in der Lage ist diesen Knopf zu drücken kann ich mit der Puppe Informationen anzeigen. Beispielsweise ob jemand im Jabber-Netzwerk online ist: wenn der Bekannte online geht steht die Puppe auf, wenn er sich abmeldet fällt sie in sich zusammen.

Servos werden über drei Adern angeschlossen. Über eine rote und eine schwarze Ader werden sie mit Spannung versorgt, über eine gelbe mit dem Signal. Die Versorgungsspannung sollte zwischen 4,8 und 6 Volt liegen, die 5 Volt des USB-Ports liegen also im erlaubten Bereich. Auf der Signalleitung fließen keine großen Ströme, sie kann also direkt an den Controller angeschlossen werden. Der Winkel den das Servo einstellt wird über Pulsweitenmodulation (PWM) gesteuert. Dazu wird ein Signal mit 50Hz (ein Puls alle 20ms) erzeugt, die Länge der Pulse definiert den Winkel.

Ein Problem das ich nicht wirklich gelöst habe ist die Stromaufnahme: Ich weiß nicht, welcher Strom durch den Motor des Servos fließt. Er scheint niedrig genug zu sein um keine Probleme zu verursachen, aber ich habe nicht ausprobiert wie hoch er wird wenn das Servo blockiert wird. ICH HABE ALSO HIERMIT GEWARNT, für USB-Ports die in Flammen aufgehen fühle ich mich nicht mehr verantwortlich… :-/

Die Schaltung umfaßt nur ein paar Standard-Bauteile. Darunter befindet sich kein spezieller USB-Chip.

Die Schaltung umfaßt nur ein paar Standard-Bauteile. Darunter befindet sich kein spezieller USB-Chip.

Das Paket dieses Projektes besteht aus drei Teilen: Der Firmware für einen ATmega8 Mikrocontroller, einen Kommandozeilen-Client der unter Linux läuft und den Schaltungen die für einen Nachbau benötigt werden.

Dieses Projekt basiert auf meinem USB-LED-Fader, der seinerseits auf dem PowerSwitch Beispielprojekt von Objective Development basiert. Wie in diesen beiden Projekten kommt auch hier der Firmware-USB-Treiber zum Einsatz, den Objective Development für die AVR Mikrocontroller von Atmel entwickelt haben.

Dieser Treiber ist eine reine Firmware-Implementierung des USB 1.1 Standards für langsame Geräte. Er läuft auf preiswerten Mikrocontrollern aus Atmels AVR-Serie, wie dem ATtiny2313 oder sogar den noch kleineren 8-Pin-Controllern. Er implementiert den Standard soweit, daß sich sinnvolle Applikationen damit entwickeln lassen. Die Datei „firmware/usbdrv/usbdrv.h“ enthält weitere Informationen zu Möglichkeiten und Grenzen.

Bau und Installation

Die Installation wird in der beiliegenden Dokumentation beschrieben.

Benutzung

Das Gerät wird mit dem USB-Port verbunden. Wenn das Servo noch nicht in der Ausgangsposition steht wird es sich dorthin bewegen.

Das Kommandozeilen-Tool wird wie folgt benutzt:

Parameter

  • angle: Der Winkel in den das Servo gestellt werden soll. 0 ist ganz links, 255 ist ganz rechts.

Beispiele

Den Status des Servo auslesen

Das gibt den Winkel aus, in dem sich das Servo gerade befindet.

Einen neuen Winkel einstellen

Das stellt das Servo auf den Winkel 23. 0 ist ganz links, 255 ist ganz rechts. Mit 23 wird das Servo also fast ganz nach links bewegt.

Das Gerät testen

Diese Funktion sendet eine Menge Zufallszahlen an das Gerät, das die Zahlen wieder zurück schickt. Der Client kontrolliert die gesendeten und Empfangenen Zahlen auf Gleichheit.

Demoanwendung xservopointer

Hinter den Kulissen

Hinter den Kulissen

Dies ist eine reine Spaß-Anwendung die eigentlich niemand braucht. Grund genug, sie zu schreiben…

Um sie zu benutzen wird das Servo mittig über dem Bildschirm (mit kleinen Änderungen an den Quellen sind auch andere Positionen möglich) montiert und mit einem Zeiger ausgerüstet.

Zukünftig muß man dann nie mehr nach seinem Mauszeiger suchen, der Zeiger an dem Servo zeigt einem immer in welcher Richtung er sich befindet.

Probleme

Das Hauptproblem sehe ich wie schon erwähnt in der Stromaufnahme. Ich habe das mit meinem Servo an meinem Notebook ausprobiert, ich bin mir nicht sicher ob das an anderen Systemen funktionieren würde. DIES KANN DEN COMPUTER ZERSTÖREN, und niemand außer demjenigen der es anschließt fühlt sich für eventuelle Schäden verantwortlich.

Ein anderes (kleineres) Problem ist die holperige Implementierung der Pulsweitenmodulation. Ich habe die Timing-Werte mittels Trial and Error ermittelt, die müssen nicht notwendigerweise für jedes Servo stimmen. Andererseits denke ich, daß Servos austauschbar sein sollten. Allerdings ist dies mein erstes und bislang einziges Servo, darüber kann ich also nicht viel sagen.

Danke!

Ich danke Objective Development für die Möglichkeit, den Treiber für mein Projekt zu benutzen. Ohne den Treiber würde dieses Projekt nicht existieren.

Lizenz

Meine Arbeit, also alles außer dem USB-Treiber, fällt unter die GNU General Public License (GPL). Eine Kopie der GPL liegt dem Projekt bei. Der USB-Treiber untersteht einer gesonderten Lizenz von Objective Development. In firmware/usbdrv/License.txt befinden sich weitere Informationen dazu.

Download

Dieser Text war 2006 noch nicht im Blog, den habe ich 2015 aus dem alten CMS übernommen.

Die fertige Schaltung in Aktion.

Die fertige Schaltung in Aktion.

Der USB-LED-Fader ist ein Gerät mit dem mehrere LEDs mittels USB kontrolliert werden können. Ich habe es gebaut um den Status meiner Internet-Verbindung und den Füllstand meiner Festplatte, sowie den aktuellen Zustand meines Videorecorders (VDR) anzuzeigen. Die Anzahl der Einsatzmöglichkeiten ist praktisch unbegrenzt.

Die LEDs werden mittels Pulsweitenmodulation (PWM) gesteuert. So sind sie nicht einfach an oder aus, sondern die Helligkeit kann gesteuert werden. Und genau das ist die Hauptaufgabe des Mikrocontrollers: die Firmware verfügt über mehrere ‚Wellenformen‘, die auf den LEDs wiedergegeben werden können. So kann jede LED eine Art Sinus- oder Dreieckswelle darstellen, ohne daß der Host-Computer eingreifen muß.

Jede der LEDs kann separat eingestellt werden, jede kann ein eigenes Muster zugewiesen kriegen.

Es ist möglich, für jede LED drei ‚Wellen‘ zu definieren: zwei ‚unendliche‘ Wellen (0 & 1), und eine einmalige Welle (2). Die unendlichen Wellen wechseln sich ewig ab, wenn eine komplett angezeigt wurde wird die andere aktiv. Die einmalige Welle wird dagegen nur einmal angezeigt, nach ihrem Ablauf springt die Firmware wieder zu den unendlichen Wellen, falls diese definiert wurden.

Jede Welle wird mit drei Parametern definiert: Die Wellenform, die Dauer einer Wiederholung und die Anzahl der Wiederholungen bevor zur nächsten Welle gewechselt wird.

Die hier gezeigte Version unterstützt vier LEDs, es sollte aber nicht allzu schwer sein diese Zahl zwischen eins und acht zu variieren. Ich habe keine Tests mit mehr als vier LEDs gemacht, aber ich könnte mir vorstellen daß es dabei zu Problemen mit der Last auf dem Controller kommen könnte, das könnte die Kommunikation via USB beeinträchtigen.

Die Distribution besteht aus drei Teilen: Der Firmware für einen ATmega8 Mikrocontroller, einem Kommandozeilen­Tool das unter Linux läuft und den Plänen für die Schaltung.

Dieses Projekt basiert auf dem PowerSwitch Beispielprojekt von Objective Development. Wie dort wird auch hier der Firmware-USB-Treiber verwendet, den Objective Development für Atmels AVR-Mikrocontroller entwickelt hat.

Dieser Treiber ist eine reine Firmware-Implementierung des USB 1.1 (low speed device) Standards für den Einsatz auf billigen Ein-Chip-Systemen wie der AVR-Serie von Atmel. Er kann zum Beispiel auf einem ATtiny2313 oder sogar auf einigen noch kleineren 8-Pin-Devices eingesetzt werden. Er implementiert den Standard, soweit es für einen sinnvollen Einsatz notwendig ist. In der Datei „firmware/usbdrv/usbdrv.h“ der Distribution werden Features und Grenzen beschrieben.

Bau und Installation

Die Schaltung umfaßt nur ein paar Standard-Bauteile. Darunter befindet sich kein spezieller USB-Chip.

Die Schaltung umfaßt nur ein paar Standard-Bauteile. Darunter befindet sich kein spezieller USB-Chip.

Die Installation wird in der beiliegenden Dokumentation beschrieben.

Benutzung

Nachdem das fertige Gerät an USB angeschlossen wurde, sollten alle LEDs kurz aufleuchten, um zu bestätigen daß alles funktioniert.

Dann kann der Kommandozeilen-Client wie folgt zum Einsatz kommen:

Mit der Set-Funktion können mehrere Wellen gleichzeitig definiert werden, indem einfach alle benötigten Parameter angegeben werden. Siehe Beispiele weiter unten.

Parameter

  • ledId: Nummer der LED (0-n, je nachdem wie viele LEDs das Gerät hat)
  • waveId: ID der Welle (0-1: ewige Wellen, 2: einmalige Welle).
  • waveformId: ID der Wellenform (0-31: konstante Helligkeit, 32-37: Muster). Die Form der Welle kann mit der show-Funktion angezeigt werden.
  • periodDuration: Zeit in zehntel Sekunden, die eine Anzeige der Wellenform dauern soll. Mit einem Wert von 0 wird die Welle gelöscht.
  • repetitionCount: Anzahl der Wiederholungen für diese Welle mit einer 0 an dieser Stelle wird die Welle für immer wiederholt.

Beispiele

Den Status aller LEDs anzeigen

Die Ausgabe sieht wie folgt aus:

Die Werte curvalue, curpos, nextupd und updtime dienen zum Debuggen. Sie sollten nur nach einem Blick in den Code von Interesse sein. Die Bedeutung der anderen Werte dürfte klar sein.

Die erste LED auf eine mittlere Helligkeit schalten

So wird die Welle 0 der LED 0 auf die Wellenform 15 (eine mittlere Helligkeit) gesetzt. Sie wird für eine Sekunde angezeigt und nach einmal wiederholt bevor zur nächsten Welle gewechselt wird. Noch ist keine zweite Welle definiert, also bleibt dieser Zustand bis auf weiteres.

Jetzt eine zweite Welle für die erste LED definieren, etwas heller als die erste

Dies ist Welle 1 auf LED 0, die Form 25 ist ebenfalls eine konstante Helligkeit. Nachdem die zweite Welle gesetzt wurde wechselt sie sich mit der ersten im Sekundentakt ab, weil beide Wellen die gleiche Länge und die gleiche Anzahl an Wiederholungen haben.

Eine dritte Welle auf die erste LED legen

Dies setzt die dritte Welle (Nummer 2) auf der ersten LED. Wellenform 36 ist eine schicke Sinus-ähnliche Form, also beginnt die LED zu faden. Eine Wiederholung dauert dabei zwei Sekunden, die Welle wird fünf mal wiederholt. Da dies die dritte Welle ist, kehrt die Schaltung nach diesen Wiederholungen wieder in die Abwechslung zwischen den beiden Helligkeiten zurück, diese Welle wird somit gelöscht.

Mehrere Wellen gleichzeitig definieren

Damit werden alle oben angegebenen Wellen gleichzeitig definiert. Die LED wird also erst fünf mal sinus-artig faden, und danach anfangen im Sekundentakt zwischen den beiden Helligkeitszuständen zu blinken.

Die erste LED löschen

Damit werden alle Wellen auf der ersten LED gelöscht.

Das Gerät zurücksetzen

Alle LEDs leuchten dabei einmal auf, um zu signalisieren daß alles funktioniert.

Eine Wellenform auf dem Bildschirm anzeigen

Die Ausgabe sieht wie folgt aus:

Dabei ist zu beachten, daß die angezeigte Breite der Länge der Wellenform entspricht. Eine einfache konstante Helligkeit (0-31) hat eine Länge von 1. Die Anzeige umfaßt also nur eine Spalte.

Das Gerät testen

Diese Funktion sendet viele zufällige Zahlen an das Gerät. Die Datenpakete werden wieder zurückgegeben und mit den Originalen verglichen, um Unterschiede zwischen den gesendeten und den empfangenen Daten festzustellen.

Schwachpunkte

Ich weiß, man kann das auch schöner anordnen... ;-)

Ich weiß, man kann das auch schöner anordnen… ;-)

Wie schon erwähnt ist die Kontrolle der Pulsweitenmodulation für mehrere LEDs eine Menge Arbeit für den kleinen Controller. Das gleiche gilt für das Sprechen des USB-Protokolls. Beides zusammen ergibt eine hohe Last auf dem Gerät, dadurch ist die Kommunikation mit dem Gerät nicht zu 100% verläßlich. Tests haben aber gezeigt, daß mehr als 99% aller Kommandos ankommen.

ACHTUNG: Man sollte diese Schaltung deshalb nicht benutzen um zum Beispiel den Zustand eines Kernreaktors zu überwachen. Solltest Du das trotz dieser Warnung vorhaben, bitte ich um kleine Nachricht… ;-)

Danke!

Ich möchte der Firma Objective Development für die Möglichkeit danken, ihren Treiber benutzen zu können. Ohne den gäbe es dieses Projekt nicht.

Und ganz besonderer Dank geht an Thomas Stegemann. Er hat das Modul für die PWM-Steuerung geschrieben, und für mich selbst wäre es nahezu unmöglich gewesen, den Rest des Projektes ohne seine Hilfe zu schreiben. C ist halt nicht meine Muttersprache… ;-)

Lizenz

Unsere Arbeit, also alles außer dem USB-Treiber, fällt unter die GNU General Public License (GPL). Eine Kopie der GPL liegt dem Projekt bei. Der USB-Treiber untersteht einer gesonderten Lizenz von Objective Development. In firmware/usbdrv/License.txt befinden sich weitere Informationen dazu.

Download