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.
• Im 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 neusten 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 neuste Version
wget https://downloads.arduino.cc/arduino-1.8.5-linux64.tar.xz
tar xvJf arduino-1.8.5-linux64.tar.xz

• Die neuste Version Arduino-Makefile (optional)

# Neuste 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

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

Foren Links

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