SIGNALduino Compilieren

SIGNALduino in die Arduino Entwicklungsumgebung einbinden

Zur Inbetriebnahme von SIGNALduino auf der Arduino IDE (getestet mit auf Arduino V1.6.7) müssen die Quelltexte von GitHub (Stand Feb. 2017) geladen werden.

Dort Clone or download und danach Download ZIP klicken und das ZIP-Archiv auspacken oder auf der Kommandozeile git clone https://github.com/RFD-FHEM/SIGNALDuino.git ausführen.

Es werden folgende Dateien benötigt:

• Die Datei RF_Receiver.ino in einen Ordner RF_Receiver, am besten direkt ins Arduino Verzeichnis der IDE kopieren.
• Im libraries Ordner der Arduino IDE am besten einen Ordner mit Namen SIGNALduino anlegen, dort müssen dann die Dateien bitstore, output, signalDecoder, SimpleFIFO und TimerOne (jeweils .cpp und .h Datei) abgelegt werden.
• In diesem SIGNALduino Verzeichnis ist dann noch ein Unterverzeichnis config anzulegen, dort muss die Datei known_16bit_timers.h abgelegt werden.

Struktur der SIGNALduino libraries:

In der Arduino Entwicklungsumgebung unter Werkzeuge → Board "Arduino Nano" und unter Werkzeuge → Prozessor "ATmega328" angeben. Nach Einstecken des SIGNALduinos in die USB Buchse noch den entsprechenden COM-Port unter Werkzeuge → Port angeben, danach sollte sich der Scetch RF_Receiver.ino übersetzen und auf den SIGNALduino laden lassen.

SIGNALduino mit Makefile unter Linux

Wer lieber auf der Kommandozeile arbeitet kann SIGNALduino auch mit einem Makefile übersetzen und laden. Benötigt werden dazu:

• Der Cross-Compiler und alle Werkzeuge für Arduino bzw. AVR. Bei Ubuntu und Debian Systemen:

# Arduino Pakete installieren:
sudo apt-get install arduino arduino-core arduino-mighty-1284p arduino-mk
# AVR
sudo apt-get install flashrom gcc-avr avrdude avr-libc binutils-avr
# Die Unterstützung der Braillezeile kann zu Konflikten um den seriellen Port führen
sudo apt-get remove brltty brltty-x11
# Arduino-Makefile verwendet YAML und serialport in Perl
sudo apt-get libdevice-serialport-perl libyaml-perl

In den Paketen sind die Arduino Quellen und Arduino-Makefile enthalten. Bei wem das aber nicht klappt, der sollte wie hier beschrieben die neuesten Versionen verwenden.

• SIGNALDuino Quelltexte

# Hier kann man natürlich jedes beliebige Verzeichnis nehmen.
mkdir -p ~/src/arduino; cd ~/src/arduino
# SIGNALDuino von github clonen
git clone https://github.com/RFD-FHEM/SIGNALDuino.git

• Die Arduino Quellen (optional)

# siehe https://www.arduino.cc/en/Main/Software für neueste Version
wget https://downloads.arduino.cc/arduino-1.8.5-linux64.tar.xz
tar xvJf arduino-1.8.5-linux64.tar.xz

• Die neueste Version Arduino-Makefile (optional)

# Neueste Version von github clonen
git clone https://github.com/sudar/Arduino-Makefile.git

Jetzt muss in SIGNALDuino/RF_Receiver noch ein Makefile erstellt werden:

# Verzeichnis in dem die Arduino-Quellen liegen
ARDUINO_DIR=$(HOME)/src/arduino/arduino-1.8.5
# Verzeichnis mit dem Arduino-Makefile
ARDMK_DIR=$(HOME)/src/arduino/Arduino-Makefile
# Basisverzeichnis unter dem die AVR-Werkzeuge liegen
AVR_TOOLS_DIR=/usr
AVRDUDE_OPTS = -v
# Ab Arduino 1.5 sollte man die Architektur angeben.
ARCHITECTURE  = avr
BOARD_TAG = nano
BOARD_SUB = atmega328
USER_LIB_PATH += $(realpath ../src/_micro-api/libraries)
ARDUINO_LIBS += bitstore output signalDecoder SimpleFIFO TimerOne EEPROM
# Device des Arduino nano
MONITOR_PORT  = /dev/ttyUSB0
# AVRDUDE      = /usr/bin/avrdude
AVRDUDE_CONF = /etc/avrdude.conf
include $(ARDMK_DIR)/Arduino.mk

Wer die Arduino Quellen und Arduino-Makefile aus der Paketverwaltung verwenden möchte, kann folgendes ändern:

ARDUINO_DIR=/usr/share/arduino
ARDMK_DIR=$(ARDUINO_DIR)

Mit Stand vom 17.02.2018 müssen jetzt noch ein paar kleine Fehler beseitigt werden: Präprozessor-Direktiven werden nicht mit Semikolon abgeschlossen

• in RF_Receiver/RF_Receiver.ino

• #define CMP_NEWSD statt #define CMP_NEWSD;

Linux unterscheidet Groß- und Kleinschreibung bei Dateien:

• in src/_micro-api/libraries/output/src/output.h
• und in src/_micro-api/libraries/signalDecoder/src/signalDecoder.h

• #include "Arduino.h" statt #include "arduino.h"

Das Makefile ignoriert Bibliotheken ohne library.properties

• in src/_micro-api/libraries/signalDecoder fehlt library.properties.

cd src/_micro-api/libraries/signalDecoder
cp ../bitstore/library.properties .
sed -i 's/bitstore/signalDecoder/g' library.properties

Danach kann SIGNALDuino für den Arduino Nano übersetzt werden:

cd RF_Receiver
make
# Auf den Arduino laden (flashen)
make upload
# Aufräumen mit
make clean

SIGNALDuino konfigurieren und testen

FHEMduino bzw. SIGNALDuino Schaltplan

In der Datei RF_Receiver.ino sind u.a. folgende Einstellungen:

• BAUDRATE Die Datenrate mit der SIGNALDuino mit dem PC kommuniziert (Voreinstellung 57600). Man kann also z.B. mit minicom -D /dev/ttyUSB0 -8 -b 57600 die Kommunikation testen.
• PIN_LED Der Pin an dem die LED zur Signalisierung von Nachrichten angeschlossen ist (Voreinstellung D13 = LED L auf dem Nano).
• PIN_RECEIVE Der Pin zum Empfang von Daten (Voreinstellung D2).
• PIN_SEND Der Pin zum Senden von Daten (Voreinstellung D11).

Öffnet man ein Terminal (z.B. minicom siehe oben) so kann man die Kommandoschnittstelle des SIGNALDuino probieren:

• Eingabe "? Enter" listet die verfügbaren Kommandos: Use one of V i R t X F S P C G

• V: Zeigt die Version der Software
• i: Präfix für ein Intertechno-Kommando.
• R: Zeigt den freien Arbeitsspeicher (RAM) in Bytes
• t: Zeigt die Dauer des Betriebs seit dem letzten Start in Sekunden (uptime).
• XQ: Empfänger abschalten (RX Quit)
• XE: Empfänger einschalten (RX Enable)
• F: Filter wechseln (derzeit ohne Funktion)
• S: Präfix für das Aussenden von Nachrichten.
• P: Prüft die Kommunikation (Ping). Antwortet mit "OK".
• CG: Abfrage der Konfiguration (Config Get) aus dem EEPROM.
• CES: Aktiviere Nachrichten mit Sync Puls (Config Enable Sync).
• CEC: Aktiviere Nachrichten mit Manchester Code (Config Enable Manchester Code).
• CEU: Aktiviere nicht synchronisierte Nachrichten (Config Enable Unsync).
• CD[SCU]: Deaktivieren den entsprechenden Nachrichtentyp (z.B. CDU deaktiviert asynchron).
• G: Veraltete Abfrage der Konfiguration, sollte mit CG gemacht werden.

Als erstes sollte man mit dem Terminalprogramm ein großes "P" gefolgt von den Eingabetaste eingeben. Bei korrekter Verbindung sollte der SIGNALDuino mit "OK" antworten.

Foren Links

• SIGNALDuino Empfänger Firm- und Hardware
• Signalduino Entwicklung Version 3.3.1
• Beschreibung zu diversen Empfängern und Verbesserung der Empfangsleistung