Inhalt
- Installation
- Linux (Ubuntu, Debian, RaspberryPi etc.)
- macOS
- Windows
- Update
- Bedienung
- Versionen
Der SpaßCAN Konfigurator dient zur plattformunabhängigen Programmierung der Meldermodule am Bus.
Derzeit erfolgt die Programmierung über die RocNet Schnittstelle, wodurch ein SpaßCAN Interface 2 mit NodeMCU (ESP8266) und WLAN-Anbindung erforderlich wird. Zur Programmierung der Module über das Interface 1.1 und die serielle RASCII-Schnittstelle muss SpaßCAN Basic genutzt werden.
Installation
Der SpaßCAN Konfigurator steht auf GitLab zum Download bereit. Zur Installation kann das Repository direkt geclont werden (setzt eine lokale Git Installation voraus). Zum Betrieb ist eine installierte Python3 Umgebung erforderlich. (Download)
Linux (Ubuntu, Debian, RaspberryPi etc.)
Installation von Python, Virtualenv und Git:
Im Terminalfenster (auf dem RaspberryPi im bash, oder unter Ubuntu Strg + Akt + T) können die erforderlichen Pakete installiert werden:
sudo apt-get install python3 virtualenv git
Im Anschluss wird das konfigurator-repository lokal geclont (Download der Sourcen) und in das Verzeichnis gewechselt
git clone https://gitlab.com/spasscan/konfigurator.git cd konfigurator
Um Fehler durch andere Programme in der Python-Umgebung zu verhindern, kann eine virtuelle Umgebung angelegt und aktiviert werden (Beispiel: my_env – kann nach eigenem Geschmack auch anders genannt werden)
virtualenv -p python3 my_env . my_env/bin/activate
Setup.py ausführen
pip3 install .
Der SpaßCAN Konfigurator kann jetzt gestartet werden
konfigurator
macOS
Gewünschtes Installationsverzeichnis im Finder öffnen und im Kontextmenü „Im Terminal öffnen“ auswählen. In diesem Verzeichnis wird ein neuer Ordner ‚konfigurator‘ angelegt, in dem sich nach dem clonen die Sourcen befinden.
git clone https://gitlab.com/spasscan/konfigurator.git cd konfigurator
Virtuelle Umgebung erstellen und aktivieren (zum beispiel: my_env)
python3 -m venv my_env source my_env/bin/activate
Setup.py ausführen und konfigurator Installieren
pip3 install .
Der SpaßCAN Konfigurator kann jetzt gestartet werden
konfigurator
Windows
Anleitung folgt.
Update
Da sich der SpaßCAN Konfigurator ständig weiter entwickelt, lohnt es sich von Zeit zu Zeit ein Update zu machen. Dafür öffnet man das Installationsverzeichnis ‚konfigurator‘ im Terminal und läd die aktuellen Sourcen herunter.
git pull
Wie oben für das jeweilige System beschrieben muss die virtuelle Umgebung aktiviert werden. Im Anschluss kann die Installation aktuallisiert werden.
pip3 install --upgrade .
Bedienung
Befehle:
<h> – Hilfe: Zeigt alle Befehle an und gibt eine kurze Erklärung aus
<q> – Beenden: schließt den SpaßCAN Konfigurator und kehrt zum Terminal zurück
<c> – CV Programmieren: Setzt eine CV mit einem zuzuweisenden Wert zum Programmieren auf die Warteliste. Nachdem <c> gedrückt wurde, wird als erster zur Eingabe der CV und nachdem Drücken von ENTER zur Eingabe des neues Wertes aufgefordert.
<s> – Senden: Sendet alle neuen Werte aus der Warteliste an das Angezeigte Modul.
<d> – Löschen: Setzt die Warteliste zurück
<D> – Debugmodus: on/off: Zeigt alle erkannten UDP Befehle an.
<l> – bekannte Module anzeigen: Gibt eine Liste aller bekannten Module am CAN-Bus aus (Module müssen eine Übertragung gesendet haben, seit das Programm gestartet wurde)
<i> – Statusänderungen: on/off: Zeigt alle eingehenden Statusänderungen am CAN-Bus aus.
<M> – Moduladresse programmieren: Setzt die CV10 des erkannten Moduls auf den gewünschten Wert.
Versionen
- Rev: 12 – Installationsroutine hinzu
- Rev. 15 – Fehlerbehebung