FHEMWiki - Benutzerbeiträge [de]

Datei:Maple bestueckung gedreht.jpg

2026-01-23T20:26:11Z

Ralf9: Ralf9 lud eine neue Version von Datei:Maple bestueckung gedreht.jpg hoch

Maple Bestückung gedreht

ESP32-SignalDuino

2023-02-18T12:55:36Z

Ralf9:

=== Einleitung ===
Der ESP32-SignalDuino ist ein I/O Gerät zur Funkübertragung basierend auf dem ESP32

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
[[Maple-SignalDuino#Neuerungen]]

==== Kompilieren ====
[https://forum.fhem.de/index.php/topic,83273.msg755123.html#msg755123 fhem Forum]

==== Firmware flashen ====
Für den ESP32 gibt's von meiner (Ralf9) SIGNALduinoAdv Firmware die Version V 4.2.2. Die bin-Dateien wurden für das "Esp32 devkit v1" kompiliert.

[https://github.com/Ralf9/SIGNALDuino/tree/dev-r422_cc1101 github V 4.2.2]

[https://github.com/Ralf9/SIGNALDuino/releases/tag/V4.2.2-dev220712 github releases]

Das bin File kann z.B. mit dem Flash Download Tools geflasht werden

https://www.espressif.com/en/support/download/other-tools

https://www.aeq-web.com/esp32-flash-tool-exported-program-upload-bin-hex-file/

=== Hardware ===
[[Datei:ESP32 sduino.png|mini]]
==== Aufbau der Hardware ====
Es werden bis zu vier cc1101 Module (A-D) unterstützt
=== Erste Schritte ===
[[Datei:ESP32DuinoWlanConfig.jpg|mini|rechts]]
Der ESP32 ist am Anfang ein AP und kann z.B. mit dem Handy über WLAN verbunden werden
* und dann auf verwalten des Routers klicken
* und dann auf configure WiFi klicken
* und dann SSID und Passwort eingeben

Wenn sich der ESP32 mit dem wlan verbunden hat, kann zum Testen mit telnet verbunden werden,
mit V wird dann die Version angezeigt

Es kann auch schon ohne cc1101 Modul getestet werden

Wenn der ESP32 mit dem Seriellen Monitor verbunden wird, gibts debugausgaben vom WifiManager.

Es gibt auch ein kleines serielles config Menü

Wenn beim booten innerhalb von 2.5 Sek 'cmd' eingegeben wird

<code>serial menue? (enter 'cmd') Timeout:2500</code>

Kommt ein Menü

<code>serial command menue 
i - printDiag 
c - change DHCP <> StaticIP, act: static 
R - resetWifiSettings 
q - quit </code>

=== Nutzung in FHEM ===
[[Maple-SignalDuino#Nutzung in FHEM]]

Datei:ESP32 sduino.png

2023-02-18T12:40:18Z

Ralf9:

ESP32-SignalDuino Belegung der cc1101 Module

Maple-SignalDuino

2023-02-18T12:21:09Z

Ralf9: /* Kompilieren */ github Link aktualisiert

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini und ESP32 gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

[https://github.com/Ralf9/SIGNALDuino/tree/dev-r422_cc1101 github V 4.2.2]

[https://github.com/Ralf9/SIGNALDuino/releases/tag/V4.2.2-dev220712 github releases]

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN und WLAN (ESP32) ====
Ist der Maple-SDuino per LAN oder ESP32-SDuino per WLAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen des Maple-SDuino und ESP32-SDuino können über FHEM mit Hilfe der '''''raw''''' Befehle oder über eine Telnet Verbindung ausgelesen und geändert werden, siehe [[Maple-ESP32-SignalDuino Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.

In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv.

Wenn mehrere CC1101 Module verwendet werden, dann gelten die "set ..." und "get cc.." Befehle nur für das selektierte cc1101 Modul. Das selektierte cc1101 Modul ist an dem * bei "get version " und bei "get cmdbank s", "get cmdBank r" erkennbar.

Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.
[https://ralf9.github.io/SD_rfmode.html rfmode Übersicht]

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2023-02-18T12:14:40Z

Ralf9: /* Inbetriebnahme/Konfiguration */ rfmode Übersicht ergänzt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini und ESP32 gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN und WLAN (ESP32) ====
Ist der Maple-SDuino per LAN oder ESP32-SDuino per WLAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen des Maple-SDuino und ESP32-SDuino können über FHEM mit Hilfe der '''''raw''''' Befehle oder über eine Telnet Verbindung ausgelesen und geändert werden, siehe [[Maple-ESP32-SignalDuino Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.

In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv.

Wenn mehrere CC1101 Module verwendet werden, dann gelten die "set ..." und "get cc.." Befehle nur für das selektierte cc1101 Modul. Das selektierte cc1101 Modul ist an dem * bei "get version " und bei "get cmdbank s", "get cmdBank r" erkennbar.

Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.
[https://ralf9.github.io/SD_rfmode.html rfmode Übersicht]

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

ESP32-SignalDuino

2023-02-18T11:44:06Z

Ralf9: /* Erste Schritte */ Bild zugefügt

=== Einleitung ===
Der ESP32-SignalDuino ist ein I/O Gerät zur Funkübertragung basierend auf dem ESP32

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
[[Maple-SignalDuino#Neuerungen]]

==== Kompilieren ====
[https://forum.fhem.de/index.php/topic,83273.msg755123.html#msg755123 fhem Forum]

==== Firmware flashen ====
Für den ESP32 gibt's von meiner (Ralf9) SIGNALduinoAdv Firmware die Version V 4.2.2,

[https://github.com/Ralf9/SIGNALDuino/tree/dev-r422_cc1101 github V 4.2.2]

[https://github.com/Ralf9/SIGNALDuino/releases/tag/V4.2.2-dev220712 github releases]

Das bin File kann z.B. mit dem Flash Download Tools geflasht werden

https://www.espressif.com/en/support/download/other-tools

https://www.aeq-web.com/esp32-flash-tool-exported-program-upload-bin-hex-file/

[[Datei:ESP32DuinoWlanConfig.jpg|mini|rechts]]
==== Erste Schritte ====
Der ESP32 ist am Anfang ein AP und kann z.B. mit dem Handy über WLAN verbunden werden
* und dann auf verwalten des Routers klicken
* und dann auf configure WiFi klicken
* und dann SSID und Passwort eingeben

Wenn sich der ESP32 mit dem wlan verbunden hat, kann zum Testen mit telnet verbunden werden,
mit V wird dann die Version angezeigt

Es kann auch schon ohne cc1101 Modul getestet werden

=== Nutzung in FHEM ===
[[Maple-SignalDuino#Nutzung in FHEM]]

Datei:ESP32DuinoWlanConfig.jpg

2023-02-18T11:42:35Z

Ralf9:

ESP32-SignalDuino erste WLAN Konfig

ESP32-SignalDuino

2023-02-18T11:27:00Z

Ralf9: Neue Seite "ESP32-SignalDuino"

=== Einleitung ===
Der ESP32-SignalDuino ist ein I/O Gerät zur Funkübertragung basierend auf dem ESP32

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
[[Maple-SignalDuino#Neuerungen]]

==== Kompilieren ====
[https://forum.fhem.de/index.php/topic,83273.msg755123.html#msg755123 fhem Forum]

==== Firmware flashen ====
Für den ESP32 gibt's von meiner (Ralf9) SIGNALduinoAdv Firmware die Version V 4.2.2,

[https://github.com/Ralf9/SIGNALDuino/tree/dev-r422_cc1101 github V 4.2.2]

[https://github.com/Ralf9/SIGNALDuino/releases/tag/V4.2.2-dev220712 github releases]

Das bin File kann z.B. mit dem Flash Download Tools geflasht werden

https://www.espressif.com/en/support/download/other-tools

https://www.aeq-web.com/esp32-flash-tool-exported-program-upload-bin-hex-file/

==== Erste Schritte ====
Der ESP32 ist am Anfang ein AP und kann z.B. mit dem Handy über WLAN verbunden werden
* und dann auf verwalten des Routers klicken
* und dann auf configure WiFi klicken
* und dann SSID und Passwort eingeben

Wenn sich der ESP32 mit dem wlan verbunden hat, kann zum Testen mit telnet verbunden werden,
mit V wird dann die Version angezeigt

Es kann auch schon ohne cc1101 Modul getestet werden

=== Nutzung in FHEM ===
[[Maple-SignalDuino#Nutzung in FHEM]]

Maple-SignalDuino

2023-02-18T00:13:21Z

Ralf9: /* LAN und WLAN (ESP32) */ Link zugefügt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini und ESP32 gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN und WLAN (ESP32) ====
Ist der Maple-SDuino per LAN oder ESP32-SDuino per WLAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen des Maple-SDuino und ESP32-SDuino können über FHEM mit Hilfe der '''''raw''''' Befehle oder über eine Telnet Verbindung ausgelesen und geändert werden, siehe [[Maple-ESP32-SignalDuino Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.

In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv.

Wenn mehrere CC1101 Module verwendet werden, dann gelten die "set ..." und "get cc.." Befehle nur für das selektierte cc1101 Modul. Das selektierte cc1101 Modul ist an dem * bei "get version " und bei "get cmdbank s", "get cmdBank r" erkennbar.

Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-ESP32-SignalDuino Netzwerk einrichten

2023-02-18T00:08:54Z

Ralf9: Die Seite wurde neu angelegt: „=== Einleitung === Im Normalfall findet der Maple-SignalDuino nach dem Flashen und dem Anschließen an Strom und Netzwerk seine IP Adresse über DHCP. Es kan…“

=== Einleitung ===
Im Normalfall findet der Maple-SignalDuino nach dem Flashen und dem Anschließen an Strom und Netzwerk seine IP Adresse über DHCP.

Es kann auch sinnvoll sein, eine IP-Adresse manuell einzustellen.

=== Befehle ===
* IP Adresse auslesen: <code>ri </code>z.B. <code>mac = 00:80:41:34:EE:FF ip = 192.168.0.10 gw = 192.168.0.1 nm = 255.255.255.0</code>
* IP-Adresse setzen (xy ersetzen): <code>Wiax.x.x.y Wia192.168.0.2</code> DHCP wird verwendet, wenn die letzte Stelle (y) der IP-Adresse 0 ist
* Gateway setzen: z.B.<code><nowiki>Wig192.168.0.1</nowiki></code>
* Netmask definieren: z.B. <code><nowiki>Win255.255.255.0</nowiki></code>

Maple-SignalDuino

2023-02-17T19:39:58Z

Ralf9: /*Inbetriebnahme/Konfiguration*/ Hinweis bei mehreren Modulen ergänzt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini und ESP32 gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN und WLAN (ESP32) ====
Ist der Maple-SDuino per LAN oder ESP32-SDuino per WLAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen des Maple-SDuino und ESP32-SDuino können über FHEM mit Hilfe der '''''raw''''' Befehle oder über eine Telnet Verbindung ausgelesen und geändert werden, siehe ToDo Link zu neuer Seite

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.

In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv.

Wenn mehrere CC1101 Module verwendet werden, dann gelten die "set ..." und "get cc.." Befehle nur für das selektierte cc1101 Modul. Das selektierte cc1101 Modul ist an dem * bei "get version " und bei "get cmdbank s", "get cmdBank r" erkennbar.

Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2023-02-17T19:12:33Z

Ralf9: /*Define in FHEM*/ bei LAN ESP32 zugefügt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini und ESP32 gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN und WLAN (ESP32) ====
Ist der Maple-SDuino per LAN oder ESP32-SDuino per WLAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen des Maple-SDuino und ESP32-SDuino können über FHEM mit Hilfe der '''''raw''''' Befehle oder über eine Telnet Verbindung ausgelesen und geändert werden, siehe ToDo Link zu neuer Seite

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2023-02-17T18:40:11Z

Ralf9: Bei Firmware ESP32 zugefügt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini und ESP32 gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2023-02-17T18:37:13Z

Ralf9: /* Firmware */ Info über Firmware geändert

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dies ist eine erweiterte inoffizielle SIGNALduino Firmware für den STM32 (Maple Mini) und ESP32, sie ist nicht zu verwechseln mit dem Originalprojekt [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden, indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt und dann den Modulen zugeordnet werden.

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, Radio C Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2022-11-20T10:41:57Z

Ralf9: /* Inbetriebnahme/Konfiguration */ cmdbank in cmdBank geändert

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dieses Projekt ist '''NICHT''' zu verwechseln mit dem Originalprojekt. Es handelt sich hierbei um einen Clone von [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt werden und dann den Modulen zugeordnet werden

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank B1 #selektiert Radio B und aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdBank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdBank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdBank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdBank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdBank A1 #selektiert Radio A und aktiviert Speicherbank 1
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank (wenn die Bank vorher leer war, wird sie automatisch mit SlowRf initialisiert)
set <dein Maple-SDuino> cc1101_freq 868.35
get <dein Maple-SDuino> cmdBank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdBank C2 #selektiert Radio C und aktiviert Speicherbank 2
set <dein Maple-SDuino> rfmode LaCrosse_... #speichert rfmode LaCrosse_... in aktivierter Speicherbank
get <dein Maple-SDuino> cmdBank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, RadionC Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2022-11-19T23:31:34Z

Ralf9: /* Austausch des FHEM Moduls 00_SIGNALduino.pm */ aktuelle Version ergänzt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dieses Projekt ist '''NICHT''' zu verwechseln mit dem Originalprojekt. Es handelt sich hierbei um einen Clone von [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
die aktuelle Version ist<syntaxhighlight lang="text">
update all https://raw.githubusercontent.com/Ralf9/RFFHEM/dev/controls_dev_ralf9_signalduino.txt
</syntaxhighlight>'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt werden und dann den Modulen zugeordnet werden

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank B #selektiert Radio B
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdbank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdbank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdbank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank A #selektiert Radio A
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank
set <dein Maple-SDuino> cc1101_freq 868.3
get <dein Maple-SDuino> cmdbank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdbank C #selektiert Radio C
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse_mode_17241 #speichert rfmode LaCrosse_17241 in aktivierter Speicherbank
get <dein Maple-SDuino> cmdbank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, RadionC Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2022-11-19T23:24:23Z

Ralf9: /* Aufbau der Hardware */änderung beim Kommentar bei send

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dieses Projekt ist '''NICHT''' zu verwechseln mit dem Originalprojekt. Es handelt sich hierbei um einen Clone von [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send)
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw und WMBUS

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt werden und dann den Modulen zugeordnet werden

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank B #selektiert Radio B
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdbank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdbank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdbank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank A #selektiert Radio A
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank
set <dein Maple-SDuino> cc1101_freq 868.3
get <dein Maple-SDuino> cmdbank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdbank C #selektiert Radio C
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse_mode_17241 #speichert rfmode LaCrosse_17241 in aktivierter Speicherbank
get <dein Maple-SDuino> cmdbank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, RadionC Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2022-11-19T23:17:53Z

Ralf9: */Inbetriebnahme/Konfiguration*/Korrektur

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dieses Projekt ist '''NICHT''' zu verwechseln mit dem Originalprojekt. Es handelt sich hierbei um einen Clone von [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send), optional für die a-culw
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt werden und dann den Modulen zugeordnet werden

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank B #selektiert Radio B
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdbank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdbank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdbank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank A #selektiert Radio A
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank
set <dein Maple-SDuino> cc1101_freq 868.3
get <dein Maple-SDuino> cmdbank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdbank C #selektiert Radio C
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse_mode_17241 #speichert rfmode LaCrosse_17241 in aktivierter Speicherbank
get <dein Maple-SDuino> cmdbank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, RadionC Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2022-11-19T23:14:27Z

Ralf9: /*Inbetriebnahme/Konfiguration*/weiteres Beispiel ergänzt

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dieses Projekt ist '''NICHT''' zu verwechseln mit dem Originalprojekt. Es handelt sich hierbei um einen Clone von [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send), optional für die a-culw
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Danach müssen die zusätzlichen cc1101 Module noch einer Speicherbank zugeordnet werden. Dies kann z.B. gemacht werden indem zuerst die benötigten Speicherbänke mit "set rfmode" belegt werden und dann den Modulen zugeordnet werden

Beispiel1:

Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Modul A auf Speicherbank 1 mit LaCrosse, Modul B auf Speicherbank 0 mit SlowRf und Modul C auf Speicherbank 2 mit Bresser.<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank B #selektiert Radio B
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse.. #speichert rfmode LaCrosse.. in aktivierter Speicherbank 1
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode Bresser.. #speichert rfmode Bresser.. in aktivierter Speicherbank 2
get <dein Maple-SDuino> cmdbank 0 #Radio B wieder Speicherbank 0 zuordnen

get <dein Maple-SDuino> cmdbank A1W #Radio A die Speicherbank1 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
get <dein Maple-SDuino> cmdbank C2W #Radio C die Speicherbank2 zuordnen. Durch das Anhängen von W bleibt die Zuordnung, durch das Speichern im EEPROM, nach einem Reset erhalten.
</syntaxhighlight>Ein "get version" ergibt dann: "(R: A1 B0 *C2)"

Beispiel2:
Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank A #selektiert Radio A
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank
set <dein Maple-SDuino> cc1101_freq 868.3
get <dein Maple-SDuino> cmdbank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdbank C #selektiert Radio C
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse_mode_17241 #speichert rfmode LaCrosse_17241 in aktivierter Speicherbank
get <dein Maple-SDuino> cmdbank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, RadionC Speicherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2022-11-19T21:17:59Z

Ralf9: /* Inbetriebnahme/Konfiguration */ Ergänzungen und Änderungen am Beispiel

{{Infobox Hardware
|Bild=Maple-SDuino-Photo1.jpg
|Bildbeschreibung=Maple-SignalDuino, links als LAN-, rechts als USB-Version
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=
|HWComm=Funk, 433MHz oder 868MHz
|HWChannels=f
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=79 x 27 mm
|HWDeviceFHEM=modifiziertes [[SIGNALduino]]
|HWManufacturer=Eigenbau}}
=== Einleitung ===
Der Maple-SignalDuino (Maple-SDuino) ist ein I/O Gerät zur Funkübertragung basierend auf dem [https://www.heise.de/developer/artikel/Maple-Mini-ein-weiteres-STM32F103-Board-4010625.html Maple-Mini], der ursprüglich von LeafLabs entwickelt wurde. Der STM32F103 bietet deutlich mehr Ressourcen als die Atmel/Microchip Mega-328 Mikrocontroller der bisherigen Arduino Plattformen.

=== Einfacher SIGNALduino mit nur einem cc1101 Modul (alternativ) ===
Es wird dabei nur das CC1101_1 (Radio B) - für OOK/ASK verwendet.

Schaltplan siehe [[Maple-SignalDuino#Aufbau der Hardware]]. Es kann auch die Platine von @Ranseyer verwendet werden, wenn nur das zweite cc1101 Modul bestückt wird.
[[Datei:MapleSduino_Schaltplan_nur_Modul_B.png|200px|thumb|right|Beispielschaltplan Maple-SIGNALduino]]

Es ist keine cc1101 Modul Konfiguration notwendig, das Modul/Radio B wird automatisch initialisiert.

Zur Inbetriebnahme ist folgendes notwendig:
* [[Maple-SignalDuino#Bootloader flashen|Bootloader 2.0 über USB flashen]]
* [[Maple-SignalDuino#Firmware flashen|Firmware flashen]]
* [[Maple-SignalDuino#Nutzung in FHEM|evtl. angepasstes 00_SIGNALduino Modul installieren]]

=== Firmware ===
Dieses Projekt ist '''NICHT''' zu verwechseln mit dem Originalprojekt. Es handelt sich hierbei um einen Clone von [https://github.com/RFD-FHEM/RFFHEM RFFHEM] und [https://github.com/RFD-FHEM/SIGNALDuino SIGNALduino].

==== Neuerungen ====
'''Bei dieser Version für den Maple Mini gibt es u.a. die folgenden Neuerungen:'''
* Das Sendekommando kann eine maximale Länge von 600 Zeichen haben.
* Der Messagepuffer hat nun eine maximale Größe von 1500 Pulsen Es gibt nun zwei neue Konfigurationsvariabl
** ::''CSmaxMsgSizex256'' - damit kann die Größe des Messagepuffers konfiguriert werden. Der Wert wird mit 256 multipliziert, d.h. 4 ergibt eine Messagepuffergröße von 1024
** ::''CSmaxMuPrintx256'' - damit kann die maximale Länge von MU-Nachrichten konfiguriert werden. Der Wert wird mit 256 multipliziert

* Die zweite und folgenden MS-Nachrichten werden nun mit der vorherigen MS-Nachricht verglichen; sind sie gleich, wird am Ende ein "Q" ausgegeben. Werden drei gleiche MS-Nachrichten in Folge empfangen, so werden die folgenden MS-Nachrichten nicht mehr ausgegeben. Per default werden vier MS-Nachrichten ausgegeben, dies kann z.B. mit CSmscnt=8 auf acht erhöht werden. Wenn aktiviert, dann steht bei get config (CG): MSEQ=1; CEQ - aktivieren, dann werden die folgenden gleichen MS-Nachrichten nicht mehr ausgegeben CDQ - deaktivieren
* Befehl '''CR''' - configRadio
** '''CRE<A-D>''' aktiviert ein cc1101 Modul z.B. CREA aktiviert das erste cc1101 Modul A
** '''CRD<A-D>''' deaktiviert ein cc1101 Modul z.B. CRDA deaktiviert das erste cc1101 Modul A
* Der Befehl '''b''' wurde erweitert:
** '''b<A-D><0-9>''' initialisiert ein cc1101 Modul (A-D) mit einer Speicherbank (0-9) z.B. bA3 initialisiert das erste cc1101 Modul A mit der Speicherbank 3
** '''b<A-D>''' selektiert ein cc1101 Modul (A-D) z.B. selektiert bA das erste cc1101 Modul A. Die Befehle zum lesen und schreiben vom EEPROM und cc1101 Registern werden auf das selektierte cc1101 angewendet.
** '''mit nachgestelltem W''' wird es im EEPROM gespeichert z.B. bA1'''W'''
** '''br''' - damit wird von allen cc1101 eine Bankinfo ausgegeben
** '''bs''' - damit wird eine Übersicht von allen Bänken ausgegeben
* Mit '''V''' (get Version) bekommt man eine Übersicht über die Module z.B. (R: A1 B0*). Mit * wird das selektierte cc1101 Modul markiert. Ein "-" hinter dem Modul (A-D), bedeutet, dass dieses Modul nicht richtig erkannt wurde, ein "i" bedeutet, dass das Modul zwar korrekt erkannt wurde, aber noch keiner Bank zugeordnet wurde. Wenn ein Modul nicht aufgeführt ist, dann ist es noch deaktiviert.
* '''XQ''' - deaktiviert Empfang aller cc1101 Module
** '''XQ<A-D>''' - deaktiviert Empfang einzelner cc1101 Module
* '''XE''' - aktiviert Empfang aller cc1101Module
** '''XE<A-D>''' - aktiviert Empfang einzelner cc1101 Module
Bei der '''USB Version''' ist durch anhängen von W ein '''XQW''' zu empfehlen. Mit XQW wird nach einem Reset der Empfang des cc1101 nicht automatisch aktiviert. Dies kann in einigen Fällen zur Optimierung der Initialisierung beim Fhem Modul nötig sein und ist an "irx0" in der Version erkennbar.
* Die Datenkomprimierung für MS- und MU-Nachrichten (config: Mred=1) ist nun nicht mehr notwendig.

==== Kompilieren ====
Wer es selber compilieren will: https://github.com/Ralf9/SIGNALDuino/tree/dev-r41x_cc1101 ({{Link2Forum|Topic=106278|Message=1027914|LinkText=siehe auch diesen Forenbeitrag}}) Außerdem besteht jetzt auch die Möglichkeit mit platformio zu kompilieren. Weiter Infos dazu [https://forum.fhem.de/index.php/topic,106278.msg1165616.html#msg1165616 hier].

=== Flashen ===
Es empfiehlt sich, sowohl den Bootloader als auch die Firmware im zunächst unbestückten Zustand des MapleSduino auf selbigen zu flashen. Im Forum wird immer wieder mal von nicht funktionierenden Bauteilen wie Maple, LAN Modul oder auch nicht korrekt funktionierenden CC1101 Modulen berichtet. Sind alle Bauteile auf entsprechenden Platinen erst einmal verlötet, ist es sehr schwierig defekte Bauteile zu entlöten bzw. auszutauschen. Außerdem ist eine stabile Spannungsversorgung vom Maple während der Flashvorgänge zwingend erforderlich.

==== Bootloader flashen ====
Ab der Version 4.1.0-dev200427 ist für die .bin Files der Bootloader2.0 erforderlich. Es kann durchaus möglich sein das auf einem frisch gelieferten Maple bereits der Bootloader 2.0 drauf ist. Daher empfiehlt es sich zunächst den Versuch zu starten direkt die [[Maple-SignalDuino#Firmware flashen|Firmware zu flashen]]. Ist der benötigte Bootloader 2.0 nicht auf dem Maple so muss dieser einmalig auf dem Maple installiert werden. Ist das erfolgt so kann die Firmware beliebig oft geflasht werden.

Um den Flashvorgang zu vereinfachen dient folgendes kleine Skript:
<syntaxhighlight lang="bash">
#! /bin/sh
while (true); do
echo "Debug-Port des MAPLE per FTDI-USB2Seriell Wandler anschliessen (RX+TX gekreuzt)!, Bot-Taste halten und erst dann MAPLE mit Spannung versorgen. "
sudo stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB0
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit
</syntaxhighlight>
Der Bootloader als .bin Datei steht [https://github.com/rogerclarkmelbourne/STM32duino-bootloader/blob/master/binaries/maple_mini_boot20.bin hier] zum Download bereit. Weitere Details zum Flashen des Bootloaders
* [[MapleCUN#Bootloader_flashen|MapleCUN]]
* {{Link2Forum|Topic=106278|Message=1073244|LinkText=Bootloader 2.0 über USB flashen}}
* https://github.com/heliflieger/a-culfw/tree/master/culfw/Devices/MapleCUN

==== Firmware flashen ====
Ist der benötigte Bootloader erst einmal auf dem MapleSduino drauf, kann die Firmware des MapleSduino geflasht werden. Abhängig davon, wie der MapleSduino in das System eingebunden werden soll, (USB, LAN oder WIFI) gibt es momentan jeweilige Binaries für '''USB''', '''LAN''' und '''Wifi/serial''' (tx/rx vom DBG Anschluss)
* LAN gibt es momentan nur für den MapleSduino; siehe dazu {{Link2Forum|Topic=106278|Message=1049877|LinkText=diesen Forenbeitrag}}.
* serial ist z.B. für eine wifi-serial bridge mit dem ESP (z.B. ESP-link)
Es gibt für den MapleSduino und den MapleCul verschiedene Binaries:

Die "Maple_sduino....bin" ist für den MapleSduino

Die "Maple_cul_....bin" ist für den MapleCUL und [[MapleCUN]].
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_sduino_USB_411dev200627.bin -R</code>
oder
:<code>sudo dfu-util -d 1eaf:0003 -a 2 -D Maple_cul_USB_411dev200627.bin -R</code>

[[MapleCUN#Trick zum USB-Flashen (Code Schnipsel für kleines Skript)|Hier]] steht ein kleines Script zur Verfügung welches den Flashvorgang sehr vereinfacht und hier ist die Firmware zu finden: https://github.com/Ralf9/SIGNALDuino/releases

Die verfügbare '''a-culw''' Firmware ist in diesem {{Link2Forum|Topic=106278|Message=1037726|LinkText=Forenbeitrag}} beschrieben und herunterladbar.

=== Hardware ===
Als Hardware wird der STM32F103CBT6 Maple Mini verwendet:
* 128 Kbytes Flash
* 20 Kbytes SRAM
* 2 SPI
* Als optionales [https://www.usriot.com/download/ES1/USR-ES1-EN%20V1.3.pdf LAN Modul den USR-ES1 W5500].

==== Aufbau der Hardware ====
[[Datei:MapleMini-Ralf9_Schaltplan_%281%29.jpg|mini|rechts|Schaltplan]]
Ab der Version 4.1.0 werden bis zu vier cc1101 Module (A-D) unterstützt

Beim MapleSduino sind die cc1101 Module an SPI2 angeschlossen:
* 28 MOSI
* 29 MISO
* 30 SCLK
'''CC1101'''_0 ('''A''')
* 31 CSN (Chip Select)
* 11 GD02 (Receive)
* 10 GD00 (send), optional für die a-culw
'''CC1101'''_1 ('''B''') - 433 MHz für OOK/ASK
* 12 CSN (Chip Select)
* 18 GD02 (Receive)
* 17 GD00 (send)
'''CC1101'''_2 ('''C''')
* 15 CSN (Chip Select)
* 16 GD02 (Receive)
* 13 GD00 (send), optional für die a-culw

===== Platine =====
Es gibt von {{Link2FU|12535|Ranseyer}} eine {{Link2Forum|Topic=109220|LinkText=Platine}}. Auf dieser Platine kann der Maple-Mini auf zwei unterschiedliche Arten bestückt werden:
#normal (die USB Buchse und reset/but Taste sind oben, somit sind die beiden Taster direkt zu betätigen)[[Datei:Maple bestueckung gedreht.jpg|mini|2. Maple Bestückung gedreht]]
#gedreht (USB Buchse ist unten in der Aussparung und kann zB. mit Heisskleber fixiert werden, reset/but Taster sind durch entsprechende Löcher/Langloch in der Platine zu betätigen)
Zur Orientierung ist Pin 31 auf der Platine beschriftet.

Es können bis zu 3 CC1101 Module/Stamps an der Platine betrieben werden. 2 Module 868MHz und 433MHz werden direkt auf die Platine gelötet. Das dritte Modul/Stamp wird Mithilfe einzelner Adern an die Platine (Lötaugen CC3A-VCC,GND,MOSI,SCK und CC3B-CS2,Out2,IN2,MISO2) angeschlossen

'''Wichtig: Bei den V0.1 und V0.2 Platinen ist die Beschriftung 433 und 868 MHz manuell zu ändern!'''

===== Teile =====
* Maple Mini / STM32F103CBT6: https://de.aliexpress.com/item/1400667476.html oder auch schneller bei Amazon

Funkmodule nach Wahl:
* CC1101 868MHZ: https://de.aliexpress.com/item/32635393463.html, https://de.aliexpress.com/item/4000594832541.html
* CC1101 433 Mhz: https://de.aliexpress.com/item/32472259186.html

Empfohlen:
* Puffer-Kondensator 10-500uF. Z.B. als C5 mit 10uF: Conrad Artikelnummer 457966

Optional:
* LAN Modul USR-ES1 W5500: https://de.aliexpress.com/item/32598945210.html
* Abblock-Kondensator mit ein paar pF bis nF an VCC des Maple. Z.B. als C6 mit 22PF: Conrad Artikelnummer 445432
* Koaxbuchsen: https://de.aliexpress.com/item/4000009303962.html

Antennen: Infos dazu gibt es reichlich im Internet, auch im {{Link2Forum|Topic=93021|LinkText=Antennenthread im FHEM-Forum}}

== Nutzung in FHEM ==

=== <big>Austausch des FHEM Moduls 00_SIGNALduino.pm</big> ===
Für die komfortable Bedienung und für FSK ( Empfang/Dekodierung vom LaCrosse Protokoll benötigt FSK) ist ein {{Link2Forum|Topic=111653|Message=1058900|LinkText=angepasstes 00_SIGNALduino Modul}} notwendig.

Wird die ursprüngliche 00_SIGNALduino.pm genutzt, ist das dekodieren von LaCrosse Sensoren nicht möglich und es bedarf recht umständlicher Zeichenfolgen, um z.B den jeweiligen Sendemodus eines CC1101 Moduls zu konfigurieren. So lautet z.B. die Zeichenfolge für die Konfiguration des Sendemodus ''Mode 1 - IT+ 17.241 kbps (LaCrosse)''
<syntaxhighlight lang="text">
get sduino raw CW0001,0246,0302,042D,05D4,06FF,0700,0802,0D21,0E65,0F6A,1089,115C,1206,1322,14F8,1556,1700,1818,1916,1B43,1C68,1D91,2211,23E9,242A,2500,2611,3D00,3E04,404d,4131,425f,4349,4454,452b,4600
</syntaxhighlight>
Wird die angepasste 00_SIGNALduino.pm genutzt so steht für den obigen Befehl folgender Befehl im FHEM Device zur Verfügung
<syntaxhighlight lang="text">
set sduino rfmode Lacrosse_mode1_17241
</syntaxhighlight>

Die Bestückung der Platine (CC1101 Module/Stamps 868MHz / 433MHz) kann bei der Verwendung des angepassten SIGNALduino Moduls frei gewählt werden. Es gilt lediglich die Beschränkung das slowrf nur bei Modul A und B möglich ist.

Ein '''update auf die angepasste 00_SIGNALduino.pm''' kann gemacht werden mit
<code>update all <nowiki>https://raw.githubusercontent.com/Ralf9/RFFHEM/master/controls_ralf9_signalduino.txt</nowiki></code>
'''oder''' die Datei [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/00_SIGNALduino.pm 00_SIGNALduino.pm] ins FHEM Verzeichnis und die [https://raw.githubusercontent.com/Ralf9/RFFHEM/master/FHEM/lib/signalduino_protocols.pm signalduino_protocols.pm] ins lib Verzeichnis kopieren, dann fhem neu starten.

Hier gibt es noch weitere Details zu dem Thema:
* {{Link2Forum|Topic=106278|Message=1032098|LinkText=Erste Schritte}}
* {{Link2Forum|Topic=58396|Message=497921|LinkText=allgemeine Befehlsübersicht}}
* Beschreibung {{Link2Forum|Topic=106594|Message=1004463|LinkText="FSK mit dem SIGNALDuino"}}

Wenn gewünscht kann jederzeit mit dem Befehl
:<code>update all https://raw.githubusercontent.com/RFD-FHEM/RFFHEM/master/controls_signalduino.txt </code>
auf die ursprüngliche 00_SIGNALduino.pm zurück gewechslt werden.

=== Define in FHEM ===
==== USB ====
Ist der Maple-SDuino per USB in FHEM eingebunden muss zunächst die USB-ID des FTDI Chip vom Maple ermittelt werden. {{Randnotiz|RNTyp=g|RNText=Weitere Hintergrundinformationen zu dieser Art der Adressierung von USB-Geräten allgemein sind in [[Mehrere USB-Geräte einbinden|diesem Beitrag]] zu finden.}}Dazu im Terminal den folgenden Befehl ausführen:
<syntaxhighlight lang="bash">
ls -l /dev/serial/by-id
</syntaxhighlight>
Das ergibt z.B. diese Ausgabe:
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 root root 13 28. Jun 19:13 usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXXX-if00 -> ../../ttyACM0
</syntaxhighlight>

Der define Befehl in FHEM ist nun folgender
:<code>define <eigener-SIGNALduino-Name> SIGNALduino /dev/serial/by-id/'''''usb-STMicroelectronics_MAPLEMINI_F103CB_CDC_in_FS_Mode_XXXXXXXX-if00'''''@115200</code>

==== LAN ====
Ist der Maple-SDuino per LAN in FHEM eingebunden so lautet das define
:<code>define <eigener-SIGNALduino-Name> SIGNALduino 192.168.0.244:23 </code>

Bei der LAN Version ist in der Grundeinstellung DHCP vom Maple-SignalDuino aktiviert. In älteren bereits kompilierten .bin Files ist die LAN Config voreingestellt auf IP=192.168.0.244 Gateway=192.168.0.1 Netzwerk-Maske=255.255.255.0

Die Netzwerkeinstellungen können z.B mit Hilfe einer Telnet Verbindung geändert werden. [[CUN Netzwerk einrichten]]

Eine weitere Möglichkeit zur Konfiguration der Netzwerkeinstellungen des Maple-SDuino ist die Konfiguration über FHEM mit Hilfe der '''''raw''''' Befehle. Weiter Infos dazu hier [[CUN Netzwerk einrichten#Befehle|CUN Netzwerk einrichten]]

=== Inbetriebnahme/Konfiguration ===
Ist der Maple-SDuino in Fhem definiert, so müssen je nach Bestückung die jeweiligen CC1101 Module konfiguriert werden.
In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Weitere cc1101 Module müssen erst aktiviert werden. z.B. Modul A: <syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
</syntaxhighlight>Antwort (die Version kann abweichen):<syntaxhighlight lang="text">
detect A: Partn=0 Ver=0x14
</syntaxhighlight>Beispiel:
Beispielhaft hier die Konfiguration eines Maple-SDuino mit 3 CC1101 Modulen/Stamps. Das erste Modul (868 MHz) empfängt/dekodiert Slow/RF, das zweite Modul (433 MHz) ist für IT und das dritte (868 MHz) Modul ist für LaCrosse. In der Grundeinstellung ist zunächst nur das zweite Modul (433MHz - Radio B) auf Speicherbank 0 aktiv. Module 1 und 3 (Radio A und Radio C) sind deaktiviert. Deshalb müssen zunächst die beiden Radios aktiviert werden, danach werden die jeweiligen Radios mit den in den Speicherbänken hinterlegten RFmodes initialisiert:
<syntaxhighlight lang="text">
get <dein Maple-SDuino> raw CREA #aktiviert Radio A
get <dein Maple-SDuino> raw CREC #aktiviert Radio C

get <dein Maple-SDuino> cmdbank A #selektiert Radio A
get <dein Maple-SDuino> cmdbank 1 #aktiviert Speicherbank 1 des Maple-SDuino
set <dein Maple-SDuino> rfmode SlowRF_CCFactoryReset #speichert rfmode SlowRF in aktivierter Speicherbank
set <dein Maple-SDuino> cc1101_freq 868.3
get <dein Maple-SDuino> cmdbank A1W #Zuordnung Radio A mit Speicherbank 1 im EEPROM speichern

get <dein Maple-SDuino> cmdbank C #selektiert Radio C
get <dein Maple-SDuino> cmdbank 2 #aktiviert Speicherbank 2 des Maple-SDuino
set <dein Maple-SDuino> rfmode LaCrosse_mode_17241 #speichert rfmode LaCrosse_17241 in aktivierter Speicherbank
get <dein Maple-SDuino> cmdbank C2W #Zuordnung Radio C mit Speicherbank 2 im EEPROM speichern
</syntaxhighlight>

Als Ergebnis steht dann nach dem Befehl '''''get version''''' im Reading '''version''' unter anderem <syntaxhighlight lang="text">
(R: A1* B0 C2) # RadioA Speicherbank1, Radio B Speicherbank0, RadionC Specherbank2
</syntaxhighlight>

Nach dem Befehl '''''get cmdbank r''''' steht dann in den Internals des Maple-Sduino sinngemäß folgendes
<syntaxhighlight lang="text">
a_ccconf b=1 freq:868.350MHz bWidth:464KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0100*]

b_ccconf b=0 freq:433.920MHz bWidth:325KHz rAmpl:42dB sens:4dB (DataRate:5603.79Baud,Modulation:ASK/OOK) [boffs=0140]

c_ccconf b=2 freq:868.300MHz bWidth:203KHz rAmpl:33dB sens:8dB (DataRate:17257.69Baud) [boffs=0000]
</syntaxhighlight>

=== Fehlersuche, Diverse ===
Der Stromverbrauch der Transceiver ist typischerweise 17 mA für RX und 34 mA für TX pro Modul. Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA.

Wenn der SlowRF nicht mehr funktioniert: Per Default ist das cc1101 Modul der Bank 0 zugeordnet, dies kann mit get Version kontrolliert werden. Es muß in Version "B0" stehen z.B. (R: B0). Es kann auch ein Factory Reset vom Modul B versucht werden, dazu muß das Modul B selektiert sein (R: B0*)
get sduino raw e
Antwort:
ccFactoryReset done
r=B b=0 rx=0 ccmode=0 sync=D391 ccconf=10B07157C43023B900070018146C070090 boffs=0000

Wenn es immer noch nicht funktioniert kann auch mit "eC" ein factory Reset der Konfigeinstellungen im EEPROM durchgeführt werden.
get sduino raw eC
Antwort:
Init eeprom to defaults
detect B: Partn=0 Ver=0x14

Wenn ein nativer Mode (FSK) nicht mehr funktioniert: Dazu muss das entsprechende cc1101 Modul selektiert sein. Mit "get Version" kann dies kontrolliert werden. Ein "-" bedeutet, daß das Modul nicht erkannt wurde z.B. (A-). Ein "i" bedeutet, das dem Modul keine Bank zugeordnet wurde z.B.(Ai).

Es kann versucht werden mit den raw Befehlen "e" und "CW..." die Bank neu zu konfigurieren.
Wenn dies alles nicht hilft, kann mit dem raw Befehl "eC" ein factory Reset der Konfigeinstellungen gemacht werden.

== Links ==
* Forenthema: {{Link2Forum|Topic=106278|LinkText=Entwicklung SIGNALDuino Empfänger Firm- und Hardware V 4.x.x auch auf Maple Mini}}

[[Kategorie:Arduino]]
[[Kategorie:Interfaces]]
[[Kategorie:CUL]]

Maple-SignalDuino

2020-07-23T16:25:26Z

Ralf9: /* Einfacher SIGNALduino mit nur einem cc1101 Modul*/

Maple-SignalDuino

2020-07-23T15:54:05Z

Ralf9: /* Bootloader */

Maple-SignalDuino

2020-07-23T15:51:33Z

Ralf9: /* Bootloader */

Maple-SignalDuino

2020-07-06T19:01:40Z

Ralf9: /* Flashen */ überarbeitet

Maple-SignalDuino

2020-07-06T18:06:46Z

Ralf9: Neuerungen: Befehle XQ und XE zugefügt