panStamp Programmierung
An dieser Seite wird momentan noch gearbeitet. |
Programmierung eines panStamp
unter Windows
Installation panStick
Für die Installation des panStick unter Windows gibt es mehrere Möglichkeiten.
- Installiert man eine Arduino IDE, kann dabei auch der Treiber für den panStick mitinstalliert werden.
- Treiber von der offiziellen Homepage herunterladen und installieren [[1]]. Die Treiber befinden sich ebenfalls im Unterordner drivers der Arduino IDE.
Bei der Installation kann es sein, dass kein Treiber gefunden wird. Dann muss der entsprechende Treiber manuell ausgewählt werden entsprechend dieser Anleitung [[2]].
Arduino IDE vorbereiten
Zum Flashen der panStamps wird die Arduino IDE benötigt. Eine Installationsanleitung für Arduino IDE 1.0 ist unter folgendem Link zu finden:
Eine Installationsanleitung für Arduino IDE 1.6.4 ist unter folgendem Link zu finden:
Die IDE 1.5.x oder höher ist zwar mit den AVRs und NRGs kompatibel, wichtig zu wissen ist allerdings, dass mit dem Wechsel von 1.0.x zu 1.5.x oder höher es größere Änderungen der APIs gegeben hat. Dadurch lassen sich einige der bislang zur Verfügung stehenden Sketches (derzeit) nicht unter 1.5.x oder höher kompilieren (z.B. der RGB-Sketch). Für die IDE 1.0.x gibt es keine passenden Arduino Lib für den NRG [[3]], die daher nur mit den AVRs kompatibel sind. Im Folgenden wird sich für die Programmierung unter Windows daher auf die letzte 1.0.x IDE bezogen.
- Man lädt die Arduino IDE 1.0.x für Windows [[4]].
- Für bestimmte Sketches müssen noch die entsprechenden Libs hinzugefügt werden (siehe explizite Anwendung).
- Unter Tools/Board wird das passende Board ausgewählt, dass dem Chip auf dem PanStamp entspricht. Für den AVR: Arduino Pro or Pro Mini (3,3V, 8 MHz) /w ATmega328. Wenn man das boards.txt file von hier installiert, kann man in der IDE auch direkt panStamp als Plattform auswählen.
- Nun muss unter Tools/Serieller Port noch der richtigen Com-Port auswählen werden, unter dem der panStick eingebunden worden ist (entsprechend Gerätemanager).
- Als letztes unter Tools/Programmer noch den AVRISP mkII auswählen.
Sketch vorbereiten, kompilieren und hochladen
- Den Sketch lädt man von der entsprechenden Quelle und entpackt die Dateien in einen Unterordner z.B. parallel zum libraries-Ordner (unter "Eigene Dateien"). Der Ordner darf nicht im libraries-Ordner liegen, da die Arduino IDE dort das Speichern nicht zulässt. Innerhalb des Unterordners erwartet die IDE die Dateien in einen Unterordner namens "sketch".
- sketch.ino oder ähnlich in der Arduino IDE öffnen.
- Nun entsprechend den Bedürfnissen auf dem geöffneten Reiter in den config.h die nicht benötigten Zeilen mit "//" auskommentieren bzw. anpassen.
- Nun sollte über Sketch/Überprüften/Kompilieren die Erstellung des Sketches möglich sein.
- Falls erfolgreich unter Datei/Hochladen (ohne Programmer) den Sketch auf den panStamp laden.
Bezüglich der Anpassung des Sketches sind einige spezifische Informationen unten bei den expliziten Anwendungen ergänzt.
Hexfile hochladen mit XLoader
Um ein fertig kompiliertes HEX-File hochzuladen, soll dieses über ein Programm namens XLoader möglich sein. [[5]]
unter Linux
Installation panStick
Zum einen kann es sein, dass der panStick automatisch unter /dev/ttyUSBx eingebunden wird. "x" steht für eine freie fortlaufende Nummer.
Falls er nicht automatisch angelegt worden ist, kann man zunächst prüfen, ob dieser überhaupt eingebunden und richtig erkannt wurde.
lsusb
Sollte etwas Ähnliches zurückmelden:
Bus 003 Device 002: ID 0403:0000 Future Technology Devices International, Ltd H4SMK 7 Port Hub
Falls das Device nicht automatisch angelegt worden ist, muss dieses ggf. von Hand erledigen.
Mit dem folgenden Befehl sollte in der Liste ein ttyUSB auftauchen. Normalerweise mit der Nummer 188.
cat /proc/devices
Das Device wird dann angelegt mit:
sudo mknod /dev/ttyUSB0 c 188 0
Zusätzlich muss für den Betrieb des panStick das ftdi_sio Modul zur Verfügung stehen. Dieses lässt sich prüfen mit
lsmod
Diese Voraussetzung könnte den Betrieb an einer Fritzbox erschweren, da nicht sicher ist, ob dieses Modul standardmäßig immer installiert ist.
Legt man das Device von Hand an, kann es sein, dass die Berechtigungen nicht richtig gesetzt sind.
2015.04.23 22:20:06 3: Opening panStick device /dev/ttyUSB0 2015.04.23 22:20:06 3: Can't open /dev/ttyUSB0: Permission denied
Das Device sollte für die Gruppe dialout Lese-/Schreibberechtigungen haben. Ist dieses nicht der Fall, lassen sich diese über diesen Befehlt setzen.
sudo chown root:dialout ttyUSBx
Damit wird der "Besitz" festgelegt.
sudo chmod a+rw /dev/ttyUSBx
Hiermit werden die Berechtigungen gesetzt.
Der Benutzer "fhem" sollte selbstverständlich der Gruppe "dialout" angehören. Ist dieses nicht der Fall:
sudo adduser fhem dialout
Falls dem nicht so sein sollte, hilft ggf. einer dieser beiden Links weiter:
[[7]] [[8]] bzw. die Installation des Moduls.
IDE unter MacOS
Da für den RGB-Sketch die IDE 1.0.x benötigt wird und diese Java SE 6 eine Voraussetzung ist, stellt die IDE und MacOS keine Optimale Konfigurationsumgebung dar. Wer es trotzdem probieren möchte Beitrag [9]
INO
Der RGB-Sketch wurde mit Hilfe des Tools INO entwickelt. Beitrag [10]
Die Installation erfolgt am leichtesten mit Hilfe des Tools pip.
Voraussetzungen für das Tool sind darüber hinaus picocom für die Kommunikation mit der seriellen Schnittstelle und die Arduino. Im gleichen Zuge lässt sich pip installieren. Die benötigten Pakete werden über folgenden Aufruf installiert
sudo apt-get install picocom python-pip arduino
Die Installation erfolgt im Anschluss über
sudo pip install ino
Die für einen Sketch erforderlichen libs werden in den entsprechenden lib Ordner kopiert (dort in entsprechenden Unterordnern).
Die Pfade im Zip sind an dieses Tool angepasst. Beitrag [11]
Der serielle Port in der ino.ini muss selbstverständlich an die passende dev-Schnittstelle angepasst werden.
Als letztes sind die Parameter für das Board noch in die board.txt unter /usr/share/arduino/hardware/arduino einzutragen. Die Parameter lassen sich von hier extrahieren [12] bzw. lauten für den AVR
############################################################## panstamp.name=PanStamp v2.0 (3.3V, 8 MHz) w/ ATmega328 panstamp.upload.protocol=arduino panstamp.upload.maximum_size=30720 panstamp.upload.speed=57600 panstamp.bootloader.low_fuses=0xE2 panstamp.bootloader.high_fuses=0xD8 panstamp.bootloader.extended_fuses=0x07 panstamp.bootloader.path=atmega panstamp.bootloader.file=ATmegaBOOT_168_atmega328_pro_8MHz.hex panstamp.bootloader.unlock_bits=0x3F panstamp.bootloader.lock_bits=0x0F panstamp.build.mcu=atmega328p panstamp.build.f_cpu=8000000L panstamp.build.core=arduino panstamp.build.variant=standard ##############################################################
Wichtig zu wissen: Jedes Mal, wenn die Arduino ein Update erhält, wird vermutlich diese Datei überschrieben, so dass die Eintragung wiederholt werden muss.
Hier sind die grundlegendsten Befehle beschrieben [13].
Wechselt man nun in das Verzeichnis z.B. des RGBdriver, lässt die der Sketch kompilieren über
ino build
Und hochladen über
sudo ino upload
- Troubeshooting
over-the-air (derzeit) nur NRG
Die neueren panStamp NRGs können seit einiger Zeit auch over-the-air geflasht werden, wie hier im zugehörigen Forumthread beschrieben [[15]].
Was überlebt das Flashen
Bestimmte Konfigurationen überstehen das Flashen, dieses sind zumindest Adresse und Intervall, die nicht neu gesetzt werden müssen [16].
EEPROM löschen
Das EEPROM lässt sich komplett löschen, indem man in der setup() dieses hier einträgt [17].
eepromToFactoryDefaults()