== Einführung: MQTT bzw. MQTT2 in FHEM ==
Zur Einbindung von Geräten, welche mit einem MQTT-Server (früher: Broker) kommunizieren können, stehen unter FHEM zwei Optionen zur Verfügung. Details sind der [[Kategorie:MQTT|MQTT-Kategorienseite]] zu entnehmen. Hier werden als IO-Devices {{Link2CmdRef|Anker=MQTT2_CLIENT|Lang=en|Label=MQTT2_CLIENT}} bzw. {{Link2CmdRef|Anker=MQTT2_SERVER|Lang=en|Label=MQTT2_SERVER}} genutzt.

Damit erfolgt die Einbindung der eigentlichen Geräte mit {{Link2CmdRef|Anker=MQTT2_DEVICE|Lang=en|Label=MQTT2_DEVICE}}, das u.A. die ''setextensions'' direkt unterstützt, also z.B. ''on-for-timer''.

Die nachfolgenden Beispiele gelingen am einfachsten mit MQTT2_SERVER als Server, für dieser sollte dabei ''autocreate'' aktiviert werden, damit die erforderlichen MQTT2_DEVICES soweit möglich automatisiert erstellt werden.

{{Hinweis|Die nachfolgende Code-Darstellung ist jeweils im RAW-Format zum [[Import von Code Snippets]]. Wer die Attribute direkt und einzeln bearbeitet, muß ggf. die "\" entfernen!}}

Beispiel:
define MQTT2_FHEM_Server MQTT2_SERVER 1883 global
attr MQTT2_FHEM_Server autocreate 1

== zigbee2mqtt ==
[[Bild:MQTT2_zigbee2mqtt_Bulbs.png|400px|thumb|Darstellung in FHEMWEB]]
[https://github.com/Koenkk/zigbee2mqtt zigbee2mqtt] ist ein open-source Projekt, mit dem zigbee-Geräte über MQTT direkt angesprochen werden können, ohne dass hierfür eine Bridge eines Herstellers benötigt wird.
=== Installation von zigbee2mqtt ===
Die Installation ist auf der Homepage des Projekts beschrieben. Ergänzend muß in der configuration.yaml eine ''client_id'' unter ''mqtt'' (z.B. zigbee_pi) vergeben werden.
mqtt:
client_id: 'zigbee_pi'

=== Define eines MQTT2-Devices als "Bridge" ===
Dann kann eine Art "Grund-Device" angelegt werden, über das die gesamte Kommunikation zu allen angeschlossenen Zigbee-Geräten dann läuft. In der Regel sollte dieses automatisch erstellt werden, wenn der zigbee2mqtt-Dienst (oder der betreffende Rechner) neu gestartet wird:

defmod MQTT2_zigbee_pi MQTT2_DEVICE zigbee_pi
attr MQTT2_zigbee_pi IODev MQTT2_FHEM_Server
attr MQTT2_zigbee_pi setList permit_join:true,false zigbee2mqtt/bridge/config/permit_join $EVTPART1\
remove:textField zigbee2mqtt/bridge/config/remove $EVTPART1\
log_level:debug,info,warn,error zigbee2mqtt/bridge/config/log_level $EVTPART1\
rename:textField zigbee2mqtt/bridge/config/rename {"old":"$EVTPART1","new":"$EVTPART2"}\
network_map:raw,graphviz zigbee2mqtt/bridge/networkmap $EVTPART1\
devicelist:noArg zigbee2mqtt/bridge/config/devices

Ist dieses angelegt, kann zigbee2mqtt mit <code>set MQTT2_zigbee_pi permit_join true</code> in den Anlernmodus versetzt werden, anzulernende Geräte müssen dann nach Bedienungsanleitung in den Anlernmodus gebracht werden.

Nach einem Browser-refresh sollte das neue Device zusätzliche Readings in MQTT2_zigbee_pi erzeugt haben.
Wer möchte, kann die Devices dann umbenennen; da diese in FHEM aber nachfolgend sowieso eigene Namen erhalten, kann dieses auch unterbleiben.

=== Vereinzeln der eigentlichen Geräte ===

Anschließend kann man - am einfachsten über die Anpassung der RAW-Definition des "Bridge"-Devices - neue MQTT2_DEVICE-Geräte ableiten (also manuell anlegen), die dann jeweils nur den Teil der readingList abbilden, der zu einem einzelnen pysischen Gerät gehört. Hierfür kann man das Attribut ''bridgeRegexp'' nutzen, siehe commandref dazu:
attr zigbee2mqtt bridgeRegexp zigbee2mqtt/0x00158d0001([^:]*):.* "zigbee_$1"

Beispiele:
==== IKEA-Tradfri-Birne ====
Beispiel eines dimmbaren Tradfri-Leuchtmittels
defmod IKEA_Bulb2 MQTT2_DEVICE
attr IKEA_Bulb2 IODev MQTT2_FHEM_Server
attr IKEA_Bulb2 eventMap on:ON:off off:OFF:on
attr IKEA_Bulb2 icon light_control
attr IKEA_Bulb2 readingList zigbee_pi:zigbee2mqtt/Kueche_Durchgang_A2:.* { json2nameValue($EVENT) }
attr IKEA_Bulb2 setList on zigbee2mqtt/Kueche_Durchgang_A2/set {"state":"ON"}\
off zigbee2mqtt/Kueche_Durchgang_A2/set {"state":"OFF"}\
brightness:colorpicker,BRI,0,15,255 zigbee2mqtt/Kueche_Durchgang_A2/set {"state":"on","$EVTPART0":"$EVTPART1"}

attr IKEA_Bulb2 webCmd brightness

Kann man auch die Farbtemperatur einstellen, wird die setList wie folgt erweitert:
...
color_temp:colorpicker,CT,250,1,454 zigbee2mqtt/ikea_flur_oben/set {"$EVTPART0":"$EVTPART1"}
webCmd muß dann ebenfalls noch ergänzt werden.

Für ein dynamisches Icon, das die Helligkeit wiedergibt, kann man folgenden Code in [[99 myUtils anlegen|myUtils]] verwenden und mit <code>attr IKEA_Bulb2 devStateIcon {devStateIcon255($name)}</code> einbinden:

##############################################
# $Id: myUtils_Color.pm 08-15 2018-10-08 18:31:44Z Beta-User $
#

package main;

use strict;
use warnings;
use POSIX;

sub
myUtils_Color_Initialize($$)
{
my ($hash) = @_;
}

# Enter you functions below _this_ line.

sub devStateIcon255($) {
my $name = shift(@_);
return ".*:off:toggle" if( ReadingsVal($name,"state","ON") eq "OFF" );
my %dim_values = (
0 => "dim06%",
1 => "dim12%",
2 => "dim18%",
3 => "dim25%",
4 => "dim31%",
5 => "dim37%",
6 => "dim43%",
7 => "dim50%",
8 => "dim56%",
9 => "dim62%",
10 => "dim68%",
11 => "dim75%",
12 => "dim81%",
13 => "dim87%",
14 => "dim93%",
);

my $pct = ReadingsVal($name,"brightness","255");
my $s = $dim_values{int($pct/18)};
$s="on" if( $pct > 253 );
return ".*:$s:off";
}

1;

==== Temp/Hum. Sensor ====
tbd

==== Motion Sensor ====
Als MQTT-Server wird hier ''mosquitto'' verwendet, als IO-Device wird daher ein {{Link2CmdRef|Anker=MQTT2_CLIENT|Lang=en|Label=MQTT2_CLIENT}}-Gerät definiert:

defmod mqtt2_client MQTT2_CLIENT 192.168.2.4:1883
attr mqtt2_client autocreate 1
attr mqtt2_client rawEvents zigbee2mqtt/GB_Bewegungsmelder:.*
attr mqtt2_client room test
attr mqtt2_client subscriptions #

Das eigentliche Device sieht dann so aus:
defmod GB_Bewegungsmelder_MQTT2 MQTT2_DEVICE zigbee_158d0001f9d030
attr GB_Bewegungsmelder_MQTT2 IODev mqtt2_client
attr GB_Bewegungsmelder_MQTT2 devStateIcon motion:motion_detector@red off:motion_detector@green no_motion:motion_detector@green
attr GB_Bewegungsmelder_MQTT2 icon motion_detector@blue
attr GB_Bewegungsmelder_MQTT2 readingList mqtt2client:zigbee2mqtt/GB_Bewegungsmelder:.* { json2nameValue($EVENT) }
attr GB_Bewegungsmelder_MQTT2 room MQTT2_DEVICE
attr GB_Bewegungsmelder_MQTT2 stateFormat {\
if(ReadingsVal("$name","occupancy",0) eq "true") {\
sprintf("motion");;\
} else {\
sprintf("no_motion");; \
}\
}

== Tasmota ==
[https://github.com/arendst/Sonoff-Tasmota Tasmota] ist eine open-source Software für ESP8266-Geräte, die z.B. statt der originalen firmware für Sonoff-Geräte verwendet werden kann. {{Randnotiz|RNTyp=r|RNText=Bitte beachten Sie, dass versicherungsrechtliche Probleme entstehen können, wenn die die herstellereigene firmware ersetzt wird!}}

=== MQTT2_DEVICE ===
Dieses sollte bei aktiviertem ''autocreate'' am MQTT2_SERVER-Device automatisch angelegt werden, sobald das betreffende Gerät eingesteckt oder neu gestartet wird oder an einem evtl. vorhandenen Taster geschalten. Hier wurden Tasmota version(en) 6.1.1 und 6.2.1 getestet, Hardware war Sonoff Touch und S20.

=== Anpassungen ===
Die RAW-Definition kann dann beispielsweise wie folgt ergänzt werden:
defmod MQTT2_DVES_9B01BD MQTT2_DEVICE DVES_9B01BD
attr MQTT2_DVES_9B01BD IODev m2server
attr MQTT2_DVES_9B01BD readingList DVES_9B01BD:tele/sonoffkitchen/STATE:.* { json2nameValue($EVENT) }\
DVES_9B01BD:tele/sonoffkitchen/LWT:.* LWT\
DVES_9B01BD:cmnd/sonoffkitchen/POWER:.* POWER\
DVES_9B01BD:tele/sonoffkitchen/UPTIME:.* { json2nameValue($EVENT) }\
DVES_9B01BD:tele/sonoffkitchen/SENSOR:.* { json2nameValue($EVENT) }\
DVES_9B01BD:tele/sonoffkitchen/INFO1:.* { json2nameValue($EVENT) }\
DVES_9B01BD:tele/sonoffkitchen/INFO2:.* { json2nameValue($EVENT) }\
DVES_9B01BD:tele/sonoffkitchen/INFO3:.* { json2nameValue($EVENT) }\
DVES_9B01BD:stat/sonoffkitchen/RESULT:.* { json2nameValue($EVENT) }\
DVES_9B01BD:stat/sonoffkitchen/POWER:.* POWER

attr MQTT2_DVES_9B01BD room MQTT2_DEVICE
attr MQTT2_DVES_9B01BD setList on cmnd/sonoff/POWER on\
off cmnd/sonoff/POWER off\
reboot cmnd/sonoff/Restart 1
attr MQTT2_DVES_9B01BD webCmd on:off:reboot

== Milight-Bridge ==
[[Bild:MQTT2 MiLight.png|400px|thumb|Darstellung in FHEMWEB]]
=== Vorbemerkung ===
Der [https://github.com/sidoh/esp8266_milight_hub esp8266_milight_hub] ist ein open source- Projekt, mit dem auf Basis von ''openmili'' eine Vielzahl von MiLight-Geräten gesteuert werden können. Der MiLight-Hub erstetzt dabei eine beliebige Zahl von Milight-Bridges und ist auch zu verschiedenen Versionen des MiLight-Protokols kompatibel.
Neben MQTT kann dieser auch mit HTTPMOD oder Wifilight (bzw. den MiLight-Modulen) gesteuert werden. Die Hardware entspriche dabei im Wesentlichen einem MySensors-Wifi-Gateway, es wird lediglich ein anderer CS-PIN genutzt, was allerdings in der Web-Oberfläche auch so umgestellt werden kann.
Hier wird vorausgesetzt, dass eine funktionierende Bridge vorhanden ist.
Der Vorteil der MQTT-Lösung liegt darin, dass man bei kompatiblen Fernbedienungen auch direkt Informationen über Schaltvorgänge erhält, die mit diesen ausgelöst werden.

=== Einstellungen am MiLight-Hub ===
Die zum FHEM-Server bzw. dem MQTT2_SERVER passenden Einstellungen sind im Web-Interface des Hub einzustellen. Um auch %-Werte für die Helligkeit zu erhalten, sollten diese ebenfalls als zu sendendes Element ausgewählt werden.

=== FHEM-Devices ===
==== Bridge ====
Danach wird ein zentrales "Bridge-Device" definiert, über das später alle Informationen aller MiLight-Kanäle laufen bzw. zurückgemeldet werden.
define Milight_Bridge MQTT2_DEVICE milight_hub_1370325
attr Milight_Bridge IODev MQTT2_FHEM_Server
attr Milight_Bridge readingList milight_hub_1370325:milight/updates/0xBE59/rgbw/0:.* { json2nameValue($EVENT) }\
milight_hub_1370325:milight/updates/0xBE59/rgbw/1:.* { json2nameValue($EVENT) }\
...
milight_hub_1370325:milight/states/0x..../rgb_cct/1:.* { json2nameValue($EVENT) }

==== Einzelne Leuchtmittel ====
Um dann einzelne Geräte für jedes Leuchtmittel bzw. jede zu schaltende Gruppe zu erhalten, kopiert man dann (am besten über die RAW-Definition) die relevanten Teile aus dem Bridge-Device. Beispiel:
define Licht_Essen MQTT2_DEVICE
attr Licht_Essen IODev MQTT2_FHEM_Server
attr Licht_Essen eventMap /set_white:Weiss/night_mode:Nacht/white_mode:white/on:on/off:off/ON:on/OFF:off/
attr Licht_Essen icon light_control
attr Licht_Essen readingList milight_hub_1370325:milight/states/0xBE59/rgbw/0:.* { json2nameValue($EVENT) }\
milight_hub_1370325:milight/states/0xBE59/rgbw/1:.* { json2nameValue($EVENT) }
attr Licht_Essen room Esszimmer
attr Licht_Essen setList on milight/0xBE59/rgbw/1 {"status":"ON"}\
off milight/0xBE59/rgbw/1 {"status":"OFF"}\
level:colorpicker,BRI,0,1,100 milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\
hue:colorpicker,HUE,0,1,359 milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\
command milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\
brightness milight/0xBE59/rgbw/1 {"$EVTPART0":"$EVTPART1"}\

attr Licht_Essen webCmd level:hue:command
attr Licht_Essen widgetOverride state command:uzsuSelectRadio,Weiss,Nacht

Indem man in der ''readingList'' sowohl den einzelnen Kanal wie die Gruppenadresse (''0'') angibt, erhält man auch Rückmeldungen über Schaltvorgänge, die die Gruppe betreffen.
Wer mag, kann dann noch ein Device anlegen, das nur den ''0''-Kanal abbildet; über dieses werden dann alle Leuchtmittel geschaltet, die zu der betreffenden Gruppenadresse gehören (im obigen Beispiel: 0xBE59).

Für ein dynamisches Icon kann derselbe code verwendet werden wir bei Tradfri beschrieben, dazu muss in der MQTT-Konfiguration des Milight-Hub auch "brightness" mit als zu sendendes Element eingestellt bleiben.

Beispiel für ein RGB-CCT-Device:

defmod Licht_Wz_all MQTT2_DEVICE
attr Licht_Wz_all IODev MQTT2_Broker
attr Licht_Wz_all eventMap /set_white:Weiss/night_mode:Nacht/white_mode:white/on:on/off:off/ON:on/OFF:off/next_mode:Mode/mode_speed_up:Up/mode_speed_down:Down/
attr Licht_Wz_all group Licht
attr Licht_Wz_all icon light_control
attr Licht_Wz_all readingList milight_hub_10693013:milight/0x5D02/rgb_cct/0:.* { json2nameValue($EVENT) }\
milight_hub_10693013:milight/updates/0x5D02/rgb_cct/0:.* { json2nameValue($EVENT) }\
milight_hub_10693013:milight/states/0x5D02/rgb_cct/0:.* { json2nameValue($EVENT) }\

attr Licht_Wz_all room Wohnzimmer
attr Licht_Wz_all setList on milight/0x5D02/rgb_cct/0 {"status":"ON"}\
off milight/0x5D02/rgb_cct/0 {"status":"OFF"}\
level milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
hue:colorpicker,HUE,0,1,359 milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
command:uzsuSelectRadio,Weiss,Nacht,Mode,Up,Down milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
brightness:colorpicker,BRI,0,1,255 milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
next_mode milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
mode_speed_up milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
mode_speed_down milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
saturation:colorpicker,BRI,0,1,100 milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
color_temp:colorpicker,CT,153,1,370 milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
device_id milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
effect milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
mode milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}\
commands milight/0x5D02/rgb_cct/0 {"$EVTPART0":"$EVTPART1"}
attr Licht_Wz_all sortby 1
attr Licht_Wz_all webCmd command:brightness:saturation:color_temp:hue
attr Licht_Wz_all webCmdLabel command\
:brightness:saturation\
:color_temp:hue

== Links ==
* {{Link2Forum|Topic=91394|LinkText=Thread, aus dem diese Anleitung ursprünglich entstanden ist}}
* {{Link2Forum|Topic=91807|LinkText=Thread zum Tasmota-Device}}

== Hinweise ==
<references />
[[Kategorie:HOWTOS]]
[[Kategorie:MQTT]]
[[Kategorie:ZigBee]]
[[Kategorie:IP Components|IP Komponenten]]
[[Kategorie:Other Components]]
[[Kategorie:Interfaces]]

MapleCUN

2018-11-15T07:45:16Z

Gloob: /* Firmware flashen unter Windows 7 - 64bit */

{{Infobox Hardware|
|Bild=MapleCULx4.jpg
|Bildbeschreibung=MAPLE CUL (ohne LAN)
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=CUL
|HWComm=Funk 433MHz oder 868MHz
|HWChannels=N/A
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=
|HWDeviceFHEM=CUL
|HWManufacturer=Eigenbau
}}

== Einleitung ==

Der MapleCUN ist neuartiges CUN oder CUL Interface zum Selbstbau, entwickelt von Telekatz.
Durch den STM32 Mikrocontroller ist die Basis sehr leistungsfähig. Der Controller ist deutlich schneller als ATMega und verfügt über mehr Flash und RAM sowie integriertes USB.
Es können 1-4 Transceiver verbaut werden.

Alle 4 Transceiver werden über ein einziges serielles Device (alternativ LAN) angesprochen als "stackable" Modul ...
Der MAPLE-Mini stellt jedoch noch über zwei UARTs noch zwei Serielle-Interfaces bereit die anderweitig genutzt werden können.

<gallery>
File:MapleCUN.jpg|Schaltplan|alt=alt language
File:MapleCULx4.jpg|Prototypen-Aufbau mit Steck-Transceivern|alt=alt language
File:4-fach-1.3-1280.jpg|4-Fach CUL V1.3|alt=alt language
File:4-fach-1.3-LAN.jpg|4-Fach CUN mit LAN-Modul V1.3|alt=alt language
File:4-fach-produktiv.jpg|4-Fach CUL im offenen Gehäuse|alt=alt language

</gallery>

== Aufbau ==

Benötigt werden dazu folgende Teile:

* [https://de.aliexpress.com/item/leaflabs-Leaf-maple-mini-ARM-STM32-compatibility/32214664071.html Maple Mini Board] 
* [https://de.aliexpress.com/item/CC1101-Wireless-Module-Long-Distance-Transmission-Antenna-868MHZ-M115/32635393463.html CC1101 Funkmodul] 
* [https://de.aliexpress.com/item/Free-shipping-W5100-Ethernet-module-Ethernet-network-module-for-arduino/32341522510.html W5100] oder [https://de.aliexpress.com/item/Free-shipping-W5500-Ethernet-network-module-hardware-TCP-IP-51-STM32-microcontroller-program-over-W5100/32750316619.html W5500] Ethernet Modul (Optional) 
Der Aufbau kann auf Lochraster erfolgen, fertige Platinen siehe Foto sparen jedoch Zeit, reduzieren Fehlerquellen und erhöhen die Zuverlässigkeit.

Die Module werden gemäß Schaltplan miteinander verbunden. Da alle Module mit 3,3V laufen sind keine Bauteile für eine Pegelanpassung notwendig.

== Bestückung der Module / Protokolle ==
Stand 07/2017: Es sind noch nicht alle Protokolle an den zusätzlichen Transceivern verfügbar.
Nach einem Reset der Konfiguration ist die Frequenz von CC0 auf 868MHz und CC1 auf 433MHz voreingestellt. Lässt sich dann aber auch umkonfigurieren.
Ende Juni 2017 wurde die automatische Erkennung der Module überarbeitet. Jetzt ist es auch möglich, einen Slot unbestückt zu lassen und die nachfolgenden Slots trotzdem verwenden zu können.
Wenn alle 4 Slots belegt sind, funktioniert SlowRF an Slot0, Slot1 und Slot2. Ist irgend ein beliebiger Slot unbelegt, funktioniert es an den übrigen 3 Slots.
Allerdings funktioniert das Senden von SlowRF nicht am letzten Slot, da dort kein Output Pin angeschlossen ist.

Neben SlowRF nutzt Intertechno und Somfy 433MHz.

Wegen der fehlenden Out Leitung am vierten Steckplatz kann man dort diese Protokolle aber auch nicht verwenden.
Nutzbar am vierten Steckplatz sind HomeMatic, MAX, RWE, LaCrosse und FastRF (alles 868MHz). Durch die Wahl des Protokolls wird die Frequenz automatisch eingestellt, '''und kann auch nicht geändert werden!'''

Weitere Infos zu [http://culfw.de/culfw.html SlowRF]

== Firmware / Flashen ==
{{Randnotiz|RNTyp=g|RNText=Sofern auf dem Maple bereits der spezielle und zur Firmware passende Bootloader installiert ist, kann über den USB-Port geflasht werden, ansonsten wird noch ein USB/TTL Wandler benötigt. Da der UART1 Anschluss des Controllers 5V-tolerant ist kann auch ein Wandler mit 5V Ausgang verwendet werden. Angeschlossen wird der Wandler an den Debug-Port (DBG).}}
Die Sourcen sind auf [https://github.com/heliflieger/a-culfw github] zu finden, der Link auf die aktuellen binaries sowie auf die aktuelle Flash-Anleitung {{Link2Forum|Topic=60458|msg=518449|LinkText=hier (im ersten Post)}}.
Die Firmware ist in der a-culfw enthalten. Für den MapleCUN gibt es jetzt nur noch zwei verschiedene Firmware-Dateien, je nach verwendetem Wizchip: 
* MapleCUNx4_W5100.bin 
* MapleCUNx4_W5500.bin 
In diesen Versionen sind alle Protokolle enthalten. Für einen MapleCUL (also ohne LAN Modul) kann man beide Versionen verwenden.

Falls kein Netzwerkmodul angeschlossen ist, wird dies automatisch erkannt. Auch die Anzahl der Transceivermodule wird automatisch erkannt.

Anmerkungen zur Firmware:
*Die Umschaltung zwischen den RF Protokollen wurde angepasst. Dies funktioniert mit Ausnahme von KOPP_FC mit allen Protokollen.

*Folgende Einschränkungen gibt es für den Betrieb mit mehreren Transceivern:

*SlowRF funktioniert nur an CC0 und CC1.

*MBUS funktioniert an jedem Transceiver, aber insgesamt nicht an mehr als einem Transceiver gleichzeitig.

*KOPP_FC funktioniert nur an CC0.

*Die restlichen Protokolle funktionieren an allen Transceivern und auch mehrfach gleichzeitig.

*LaCrosse geht seit Firmware (a-culfw) 1.26.03

Zum flashen kann entweder von ST der STM32 Flash loader demonstrator oder das Tool stm32flash benutzt werden. Flashen über den originalen MAPLE Bootloader per USB funktioniert nicht.

Firmware flashen:
-Zuerst den Bootloader tauschen (einmalig)
-per USB das Firmware Binary flashen
Bitte jeweils die aktuelle README der Firmware beachten.

Probleme beim Flashen:

sudo ./stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB1
stm32flash 0.5

http://stm32flash.sourceforge.net/

Using Parser : Raw BINARY
Interface serial_posix: 57600 8E1
Version : 0x22
Option 1 : 0x00
Option 2 : 0x00
Device ID : 0x0410 (STM32F10xxx Medium-density)
- RAM : 20KiB (512b reserved by bootloader)
- Flash : 128KiB (size first sector: 4x1024)
- Option RAM : 16b
- System RAM : 2KiB
Write to memory
Erasing memory
Got NACK from device on command 0x43
Can't initiate chip mass erase!
Failed to erase memory

Lösung:
sudo ./stm32flash -k /dev/ttyUSB1
...
Read-UnProtecting flash

Trick zum USB-Flashen (Code Schnipsel für kleines Skript)
#! /bin/sh
while (true); do
sudo dfu-util --verbose --device 1eaf:0003 --cfg 1 --alt 2 --download MapleCUNx4_W5500_BL.bin
#sudo dfu-util --verbose --device 1eaf:0003 --cfg 1 --alt 2 --download MapleCUNx4_W5100_BL.bin
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit

== Firmware flashen unter Windows 7 - 64bit ==

* Reset des Maple durch drücken des Reset Buttons
* Drücken des "but=32" Buttons direkt nach dem Reset
* Der Maple sollte jetzt im 4 Hz Takt blinken und im DFU Modus sein

C:\tmp\Arduino_STM32-master\Arduino_STM32-master\tools\win>dfu-util --list
dfu-util - (C) 2007-2008 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY
Found DFU: [0x1eaf:0x0003] devnum=1, cfg=0, intf=0, alt=0, name=""
Found DFU: [0x1eaf:0x0003] devnum=1, cfg=0, intf=0, alt=1, name="STM32duino bootloader v1.0 Upload to Flash 0x8005000"
Found DFU: [0x1eaf:0x0003] devnum=1, cfg=0, intf=0, alt=2, name="STM32duino bootloader v1.0 Upload to Flash 0x8002000"

* Treiber für den Maple mit Zadig setzen:
libusbk (v3.0.7.0)

* Firmware flashen:

C:\tmp\Arduino_STM32-master\Arduino_STM32-master\tools\win\dfu-util-0.9-win64>dfu-util --verbose --device 1eaf:0003 --cfg 1 --alt 2 --download MapleCU
Nx4_W5500_BL.bin
dfu-util 0.9

Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/

Invalid DFU suffix signature
A valid DFU suffix will be required in a future dfu-util release!!!
Opening DFU capable USB device...
ID 1eaf:0003
Run-time device DFU version 0110
Claiming USB DFU Interface...
Setting Alternate Setting #2 ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
DFU mode device DFU version 0110
Device returned transfer size 1024
Copying data from PC to DFU device
Download [=========================] 100% 66288 bytes
Download done.
Sent a total of 66288 bytes
state(8) = dfuMANIFEST-WAIT-RESET, status(0) = No error condition is present
Done!

== Einrichtung in FHEM (alt) ==
Per LAN:
define mapleCUN1 CUL 192.168.69.100:2323 1234
#define mapleCUN1 CUL IP:Port=2323 FHTID
Per USB:
define mapleCUL CUL /dev/ttyACM0@38400 4444
#Auf der Konsole "ls -l /dev/ttyACM*"
#define mapleCUL CUL /dev/ttyACMx@BaudRate FHTID
1234 oder 4444 muss oder besser kann durch eine eigene "FHTID" ersetzt werden.

Die zusätzlichen Transceiver werden als STACKABLE_CC angelegt.
define mapleCUN2 STACKABLE_CC mapleCUN1
define mapleCUN3 STACKABLE_CC mapleCUN2
define mapleCUN4 STACKABLE_CC mapleCUN3

== Einrichtung in FHEM (neu) ==
Beispiel 4* ZWAVE Seriell:
define mCUL ZWCUL /dev/serial/by-id/usb-STM32_MapleCUL_71a7e023-if00 00000000 01
attr mCUL dataRate 100k

define SCC1 STACKABLE mCUL
define z100k ZWCUL FHEM:DEVIO:SCC1:9600 00000000 01
attr z100k dataRate 100k

define SCC2 STACKABLE z100k
define z40k ZWCUL FHEM:DEVIO:SCC2:9600 00000000 01
attr z40k dataRate 40k

define SCC3 STACKABLE z40k
define z9k6 ZWCUL FHEM:DEVIO:SCC3:9600 00000000 01
attr z9k6 dataRate 9600

Beispiel 2 fach:
define CULMGrau868 CUL /dev/serial/by-id/usb-STM32_MapleCUL_6bfbb14f-if00@38400 1432
attr CULMGrau868 group Gateways
attr CULMGrau868 icon cul_868
attr CULMGrau868 model CUN
attr CULMGrau868 rfmode SlowRF

define CULMGrau868Stack STACKABLE CULMGrau868

define CULMGrau433 CUL FHEM:DEVIO:CULMGrau868Stack:9600 0000
attr CULMGrau433 group Gateways
attr CULMGrau433 icon cul_cul
attr CULMGrau433 model CUN
attr CULMGrau433 rfmode SlowRF

Beispiel 3:
define MAPLECUL868 CUL 192.168.1.51:2323 4444
attr MAPLECUL868 group Gateways
attr MAPLECUL868 icon cul_868
attr MAPLECUL868 model CUN
attr MAPLECUL868 rfmode SlowRF
attr MAPLECUL868 room TRX
define MAPLECUL868Stack STACKABLE MAPLECUL868
attr MAPLECUL868Stack room TRX
define MAPLECUL433 CUL FHEM:DEVIO:MAPLECUL868Stack:9600 0000
attr MAPLECUL433 group Gateways
attr MAPLECUL433 icon cul_cul
attr MAPLECUL433 model CUN
attr MAPLECUL433 room TRX
define MAPLECUL433Stack STACKABLE MAPLECUL433
attr MAPLECUL433Stack room TRX
define MAPLECUL868HM CUL FHEM:DEVIO:MAPLECUL433Stack:9600 0000
attr MAPLECUL868HM group Gateways
attr MAPLECUL868HM hmId 308393
attr MAPLECUL868HM icon cul_868
attr MAPLECUL868HM rfmode HomeMatic
attr MAPLECUL868HM room 8.00_Zentral,TRX

== Zusätzliche Serielle Schnittstellen ==
Über USB werden zwei weitere Schnittstellen angelegt, der Netzwerkzugriff erfolgt über die Ports 2324 und 2325. 
Zur Einstellung der Baudrate über Netzwerk gibt es folgende Befehle: 

* UART0 Baudrate einstellen: pb0@38400
* UART1 Baudrate einstellen: pb1@9600
* Baudrate im EEPROM speichern: ps
* Baudrate anzeigen: pi

Ein am UART0 angeschlossener HM-MOD-UART kann z.B. mit folgender Definition in FHEM eingebunden werden: 
define myRemoteHmUART HMUARTLGW uart://192.168.42.23:2324

Weiteres:

UART0= 8+9 = PA3+2

UART1= 0+1 = PB11+10

Für die Anbindung des MapleCUL ist die Baudrate egal, da kann man nichts falsch einstellen. Sie wird nicht benötigt, da der MapleCUL nicht über RS232 angebunden ist.
Anders verhält es sich mit den beiden zusätzlichen UART0 und UART1 Ports. Dort ist die Baudrate relevant, da die serielle Schnittstelle dort auch physikalisch existiert.

== Debugging / weiteres ==
* Stromverbrauch der Transceiver: Typischerweise 17 mA für RX und 34 mA für TX pro Modul. (Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA)

* Auf die OUT-Leitung kann bei den meisten FastRF Protokollen verzichtet werden. MAX und HM funktionieren z.B. ohne OUT Leitung

* Beim ersten Transceiver ist der Status nicht "Initialized": Möglicherweise ist die Verdrahtung fehlerhaft

* Der MAPLE-CUN startet ständig neu (Z.B. unter linux zu sehen bei tail -f /var/log/syslog, hier taucht das selbe USB Gerät ständig neu auf): Eventuell wurde eine veraltete Firmware für LAN-Modul aufgespielt, aber kein LAN-Modul erkannt

* Devices auf einem Linux Rechner:
pi@raspberrypi:/dev/serial/by-id $ ls -la
total 0
drwxr-xr-x 2 root root 100 Jul 27 18:52 .
drwxr-xr-x 4 root root 80 Jul 27 18:52 ..
lrwxrwxrwx 1 root root 13 Jul 27 18:52 usb-STM32_MapleCUL_2788282f-if00 -> ../../ttyACM0
lrwxrwxrwx 1 root root 13 Jul 27 18:52 usb-STM32_MapleCUL_2788282f-if02 -> ../../ttyACM1
lrwxrwxrwx 1 root root 13 Jul 27 18:52 usb-STM32_MapleCUL_2788282f-if04 -> ../../ttyACM2

* Wenn gar nicht mehr klar ist wie der MAPLE-CUL eingestellt ist, ggf mal zurücksetzen (statt CUL1 das erste Gerät angeben):
set CUL1 raw e

* Wen keiner der Transceiver erkannt wird an einem beliebigen Modul von Pin8 rückwärts Kurschlüsse suchen bis Pin1. Also messen zwischen 8+7, 7+6, 6+5,... Anschliessend einen Pin auslassen und noch messen 8+6, 7+5, 6+4, ...)

 

*Beispiel für Meldungen am Debug-Port mit 4 Transceivern und LAN-Modul:

-I- Getting new Started Project --
-I- MapleCUNx4
-I- Compiled: Mar 18 2017 15:46:32 --
-I- init Flash
-I- init Timer
-I- init EEprom
-I- init Ethernet
WIZCHIP Initialized success.
-I- Detected CC0: PN 0x00 VER 0x14
-I- Detected CC1: PN 0x00 VER 0x18
-I- Detected CC2: PN 0x00 VER 0x14
-I- Detected CC3: PN 0x00 VER 0x14
-I- Detected ethernet
-I- init USB
-I- init Complete

== Links ==
* {{Link2Forum|Topic=https://forum.fhem.de/index.php/topic,60458.0.html |LinkText=Diskussion im Forum}}
* [https://github.com/heliflieger/a-culfw/branches Sourcecode]
* [[MapleCUX-Platinen|Fertige Platinen mit Erweiterungen wie mySensors, ESP8266, ...]]

[[Kategorie:Interfaces]]
[[Kategorie:CUL]]
[[Kategorie:433MHz]]

MapleCUN

2018-11-15T07:44:38Z

Gloob: /* Firmware / Flashen */

{{Infobox Hardware|
|Bild=MapleCULx4.jpg
|Bildbeschreibung=MAPLE CUL (ohne LAN)
|HWProtocol=diverse
|HWType=Transceiver
|HWCategory=CUL
|HWComm=Funk 433MHz oder 868MHz
|HWChannels=N/A
|HWVoltage=3,3V nach Spannungsregler
|HWPowerConsumption=
|HWPoweredBy=USB
|HWSize=
|HWDeviceFHEM=CUL
|HWManufacturer=Eigenbau
}}

== Einleitung ==

Der MapleCUN ist neuartiges CUN oder CUL Interface zum Selbstbau, entwickelt von Telekatz.
Durch den STM32 Mikrocontroller ist die Basis sehr leistungsfähig. Der Controller ist deutlich schneller als ATMega und verfügt über mehr Flash und RAM sowie integriertes USB.
Es können 1-4 Transceiver verbaut werden.

Alle 4 Transceiver werden über ein einziges serielles Device (alternativ LAN) angesprochen als "stackable" Modul ...
Der MAPLE-Mini stellt jedoch noch über zwei UARTs noch zwei Serielle-Interfaces bereit die anderweitig genutzt werden können.

<gallery>
File:MapleCUN.jpg|Schaltplan|alt=alt language
File:MapleCULx4.jpg|Prototypen-Aufbau mit Steck-Transceivern|alt=alt language
File:4-fach-1.3-1280.jpg|4-Fach CUL V1.3|alt=alt language
File:4-fach-1.3-LAN.jpg|4-Fach CUN mit LAN-Modul V1.3|alt=alt language
File:4-fach-produktiv.jpg|4-Fach CUL im offenen Gehäuse|alt=alt language

</gallery>

== Aufbau ==

Benötigt werden dazu folgende Teile:

* [https://de.aliexpress.com/item/leaflabs-Leaf-maple-mini-ARM-STM32-compatibility/32214664071.html Maple Mini Board] 
* [https://de.aliexpress.com/item/CC1101-Wireless-Module-Long-Distance-Transmission-Antenna-868MHZ-M115/32635393463.html CC1101 Funkmodul] 
* [https://de.aliexpress.com/item/Free-shipping-W5100-Ethernet-module-Ethernet-network-module-for-arduino/32341522510.html W5100] oder [https://de.aliexpress.com/item/Free-shipping-W5500-Ethernet-network-module-hardware-TCP-IP-51-STM32-microcontroller-program-over-W5100/32750316619.html W5500] Ethernet Modul (Optional) 
Der Aufbau kann auf Lochraster erfolgen, fertige Platinen siehe Foto sparen jedoch Zeit, reduzieren Fehlerquellen und erhöhen die Zuverlässigkeit.

Die Module werden gemäß Schaltplan miteinander verbunden. Da alle Module mit 3,3V laufen sind keine Bauteile für eine Pegelanpassung notwendig.

== Bestückung der Module / Protokolle ==
Stand 07/2017: Es sind noch nicht alle Protokolle an den zusätzlichen Transceivern verfügbar.
Nach einem Reset der Konfiguration ist die Frequenz von CC0 auf 868MHz und CC1 auf 433MHz voreingestellt. Lässt sich dann aber auch umkonfigurieren.
Ende Juni 2017 wurde die automatische Erkennung der Module überarbeitet. Jetzt ist es auch möglich, einen Slot unbestückt zu lassen und die nachfolgenden Slots trotzdem verwenden zu können.
Wenn alle 4 Slots belegt sind, funktioniert SlowRF an Slot0, Slot1 und Slot2. Ist irgend ein beliebiger Slot unbelegt, funktioniert es an den übrigen 3 Slots.
Allerdings funktioniert das Senden von SlowRF nicht am letzten Slot, da dort kein Output Pin angeschlossen ist.

Neben SlowRF nutzt Intertechno und Somfy 433MHz.

Wegen der fehlenden Out Leitung am vierten Steckplatz kann man dort diese Protokolle aber auch nicht verwenden.
Nutzbar am vierten Steckplatz sind HomeMatic, MAX, RWE, LaCrosse und FastRF (alles 868MHz). Durch die Wahl des Protokolls wird die Frequenz automatisch eingestellt, '''und kann auch nicht geändert werden!'''

Weitere Infos zu [http://culfw.de/culfw.html SlowRF]

== Firmware / Flashen ==
{{Randnotiz|RNTyp=g|RNText=Sofern auf dem Maple bereits der spezielle und zur Firmware passende Bootloader installiert ist, kann über den USB-Port geflasht werden, ansonsten wird noch ein USB/TTL Wandler benötigt. Da der UART1 Anschluss des Controllers 5V-tolerant ist kann auch ein Wandler mit 5V Ausgang verwendet werden. Angeschlossen wird der Wandler an den Debug-Port (DBG).}}
Die Sourcen sind auf [https://github.com/heliflieger/a-culfw github] zu finden, der Link auf die aktuellen binaries sowie auf die aktuelle Flash-Anleitung {{Link2Forum|Topic=60458|msg=518449|LinkText=hier (im ersten Post)}}.
Die Firmware ist in der a-culfw enthalten. Für den MapleCUN gibt es jetzt nur noch zwei verschiedene Firmware-Dateien, je nach verwendetem Wizchip: 
* MapleCUNx4_W5100.bin 
* MapleCUNx4_W5500.bin 
In diesen Versionen sind alle Protokolle enthalten. Für einen MapleCUL (also ohne LAN Modul) kann man beide Versionen verwenden.

Falls kein Netzwerkmodul angeschlossen ist, wird dies automatisch erkannt. Auch die Anzahl der Transceivermodule wird automatisch erkannt.

Anmerkungen zur Firmware:
*Die Umschaltung zwischen den RF Protokollen wurde angepasst. Dies funktioniert mit Ausnahme von KOPP_FC mit allen Protokollen.

*Folgende Einschränkungen gibt es für den Betrieb mit mehreren Transceivern:

*SlowRF funktioniert nur an CC0 und CC1.

*MBUS funktioniert an jedem Transceiver, aber insgesamt nicht an mehr als einem Transceiver gleichzeitig.

*KOPP_FC funktioniert nur an CC0.

*Die restlichen Protokolle funktionieren an allen Transceivern und auch mehrfach gleichzeitig.

*LaCrosse geht seit Firmware (a-culfw) 1.26.03

Zum flashen kann entweder von ST der STM32 Flash loader demonstrator oder das Tool stm32flash benutzt werden. Flashen über den originalen MAPLE Bootloader per USB funktioniert nicht.

Firmware flashen:
-Zuerst den Bootloader tauschen (einmalig)
-per USB das Firmware Binary flashen
Bitte jeweils die aktuelle README der Firmware beachten.

Probleme beim Flashen:

sudo ./stm32flash -w maple_mini_boot20.bin -v /dev/ttyUSB1
stm32flash 0.5

http://stm32flash.sourceforge.net/

Using Parser : Raw BINARY
Interface serial_posix: 57600 8E1
Version : 0x22
Option 1 : 0x00
Option 2 : 0x00
Device ID : 0x0410 (STM32F10xxx Medium-density)
- RAM : 20KiB (512b reserved by bootloader)
- Flash : 128KiB (size first sector: 4x1024)
- Option RAM : 16b
- System RAM : 2KiB
Write to memory
Erasing memory
Got NACK from device on command 0x43
Can't initiate chip mass erase!
Failed to erase memory

Lösung:
sudo ./stm32flash -k /dev/ttyUSB1
...
Read-UnProtecting flash

Trick zum USB-Flashen (Code Schnipsel für kleines Skript)
#! /bin/sh
while (true); do
sudo dfu-util --verbose --device 1eaf:0003 --cfg 1 --alt 2 --download MapleCUNx4_W5500_BL.bin
#sudo dfu-util --verbose --device 1eaf:0003 --cfg 1 --alt 2 --download MapleCUNx4_W5100_BL.bin
if [ $? -eq 0 ]
then break
fi
sleep 1
done
exit

== Firmware flashen unter Windows 7 - 64bit ==

* Reset des Maple durch drücken des Reset Buttons
* Drücken des "but=32" Buttons direkt nach dem Reset
* Der Maple sollte jetzt im 4 Hz Takt blinken und im DFU Modus sein

C:\tmp\Arduino_STM32-master\Arduino_STM32-master\tools\win>dfu-util --list
dfu-util - (C) 2007-2008 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY
Found DFU: [0x1eaf:0x0003] devnum=1, cfg=0, intf=0, alt=0, name=""
Found DFU: [0x1eaf:0x0003] devnum=1, cfg=0, intf=0, alt=1, name="STM32duino bootloader v1.0 Upload to Flash 0x8005000"
Found DFU: [0x1eaf:0x0003] devnum=1, cfg=0, intf=0, alt=2, name="STM32duino bootloader v1.0 Upload to Flash 0x8002000"

Treiber für den Maple mit Zadig setzen:
libusbk (v3.0.7.0)

Danach die Firmware flashen:

C:\tmp\Arduino_STM32-master\Arduino_STM32-master\tools\win\dfu-util-0.9-win64>dfu-util --verbose --device 1eaf:0003 --cfg 1 --alt 2 --download MapleCU
Nx4_W5500_BL.bin
dfu-util 0.9

Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/

Invalid DFU suffix signature
A valid DFU suffix will be required in a future dfu-util release!!!
Opening DFU capable USB device...
ID 1eaf:0003
Run-time device DFU version 0110
Claiming USB DFU Interface...
Setting Alternate Setting #2 ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
DFU mode device DFU version 0110
Device returned transfer size 1024
Copying data from PC to DFU device
Download [=========================] 100% 66288 bytes
Download done.
Sent a total of 66288 bytes
state(8) = dfuMANIFEST-WAIT-RESET, status(0) = No error condition is present
Done!

== Einrichtung in FHEM (alt) ==
Per LAN:
define mapleCUN1 CUL 192.168.69.100:2323 1234
#define mapleCUN1 CUL IP:Port=2323 FHTID
Per USB:
define mapleCUL CUL /dev/ttyACM0@38400 4444
#Auf der Konsole "ls -l /dev/ttyACM*"
#define mapleCUL CUL /dev/ttyACMx@BaudRate FHTID
1234 oder 4444 muss oder besser kann durch eine eigene "FHTID" ersetzt werden.

Die zusätzlichen Transceiver werden als STACKABLE_CC angelegt.
define mapleCUN2 STACKABLE_CC mapleCUN1
define mapleCUN3 STACKABLE_CC mapleCUN2
define mapleCUN4 STACKABLE_CC mapleCUN3

== Einrichtung in FHEM (neu) ==
Beispiel 4* ZWAVE Seriell:
define mCUL ZWCUL /dev/serial/by-id/usb-STM32_MapleCUL_71a7e023-if00 00000000 01
attr mCUL dataRate 100k

define SCC1 STACKABLE mCUL
define z100k ZWCUL FHEM:DEVIO:SCC1:9600 00000000 01
attr z100k dataRate 100k

define SCC2 STACKABLE z100k
define z40k ZWCUL FHEM:DEVIO:SCC2:9600 00000000 01
attr z40k dataRate 40k

define SCC3 STACKABLE z40k
define z9k6 ZWCUL FHEM:DEVIO:SCC3:9600 00000000 01
attr z9k6 dataRate 9600

Beispiel 2 fach:
define CULMGrau868 CUL /dev/serial/by-id/usb-STM32_MapleCUL_6bfbb14f-if00@38400 1432
attr CULMGrau868 group Gateways
attr CULMGrau868 icon cul_868
attr CULMGrau868 model CUN
attr CULMGrau868 rfmode SlowRF

define CULMGrau868Stack STACKABLE CULMGrau868

define CULMGrau433 CUL FHEM:DEVIO:CULMGrau868Stack:9600 0000
attr CULMGrau433 group Gateways
attr CULMGrau433 icon cul_cul
attr CULMGrau433 model CUN
attr CULMGrau433 rfmode SlowRF

Beispiel 3:
define MAPLECUL868 CUL 192.168.1.51:2323 4444
attr MAPLECUL868 group Gateways
attr MAPLECUL868 icon cul_868
attr MAPLECUL868 model CUN
attr MAPLECUL868 rfmode SlowRF
attr MAPLECUL868 room TRX
define MAPLECUL868Stack STACKABLE MAPLECUL868
attr MAPLECUL868Stack room TRX
define MAPLECUL433 CUL FHEM:DEVIO:MAPLECUL868Stack:9600 0000
attr MAPLECUL433 group Gateways
attr MAPLECUL433 icon cul_cul
attr MAPLECUL433 model CUN
attr MAPLECUL433 room TRX
define MAPLECUL433Stack STACKABLE MAPLECUL433
attr MAPLECUL433Stack room TRX
define MAPLECUL868HM CUL FHEM:DEVIO:MAPLECUL433Stack:9600 0000
attr MAPLECUL868HM group Gateways
attr MAPLECUL868HM hmId 308393
attr MAPLECUL868HM icon cul_868
attr MAPLECUL868HM rfmode HomeMatic
attr MAPLECUL868HM room 8.00_Zentral,TRX

== Zusätzliche Serielle Schnittstellen ==
Über USB werden zwei weitere Schnittstellen angelegt, der Netzwerkzugriff erfolgt über die Ports 2324 und 2325. 
Zur Einstellung der Baudrate über Netzwerk gibt es folgende Befehle: 

* UART0 Baudrate einstellen: pb0@38400
* UART1 Baudrate einstellen: pb1@9600
* Baudrate im EEPROM speichern: ps
* Baudrate anzeigen: pi

Ein am UART0 angeschlossener HM-MOD-UART kann z.B. mit folgender Definition in FHEM eingebunden werden: 
define myRemoteHmUART HMUARTLGW uart://192.168.42.23:2324

Weiteres:

UART0= 8+9 = PA3+2

UART1= 0+1 = PB11+10

Für die Anbindung des MapleCUL ist die Baudrate egal, da kann man nichts falsch einstellen. Sie wird nicht benötigt, da der MapleCUL nicht über RS232 angebunden ist.
Anders verhält es sich mit den beiden zusätzlichen UART0 und UART1 Ports. Dort ist die Baudrate relevant, da die serielle Schnittstelle dort auch physikalisch existiert.

== Debugging / weiteres ==
* Stromverbrauch der Transceiver: Typischerweise 17 mA für RX und 34 mA für TX pro Modul. (Bei Inaktivität: 4 Transceiver, LAN-Modul, MAPLE ca 100mA)

* Auf die OUT-Leitung kann bei den meisten FastRF Protokollen verzichtet werden. MAX und HM funktionieren z.B. ohne OUT Leitung

* Beim ersten Transceiver ist der Status nicht "Initialized": Möglicherweise ist die Verdrahtung fehlerhaft

* Der MAPLE-CUN startet ständig neu (Z.B. unter linux zu sehen bei tail -f /var/log/syslog, hier taucht das selbe USB Gerät ständig neu auf): Eventuell wurde eine veraltete Firmware für LAN-Modul aufgespielt, aber kein LAN-Modul erkannt

* Devices auf einem Linux Rechner:
pi@raspberrypi:/dev/serial/by-id $ ls -la
total 0
drwxr-xr-x 2 root root 100 Jul 27 18:52 .
drwxr-xr-x 4 root root 80 Jul 27 18:52 ..
lrwxrwxrwx 1 root root 13 Jul 27 18:52 usb-STM32_MapleCUL_2788282f-if00 -> ../../ttyACM0
lrwxrwxrwx 1 root root 13 Jul 27 18:52 usb-STM32_MapleCUL_2788282f-if02 -> ../../ttyACM1
lrwxrwxrwx 1 root root 13 Jul 27 18:52 usb-STM32_MapleCUL_2788282f-if04 -> ../../ttyACM2

* Wenn gar nicht mehr klar ist wie der MAPLE-CUL eingestellt ist, ggf mal zurücksetzen (statt CUL1 das erste Gerät angeben):
set CUL1 raw e

* Wen keiner der Transceiver erkannt wird an einem beliebigen Modul von Pin8 rückwärts Kurschlüsse suchen bis Pin1. Also messen zwischen 8+7, 7+6, 6+5,... Anschliessend einen Pin auslassen und noch messen 8+6, 7+5, 6+4, ...)

 

*Beispiel für Meldungen am Debug-Port mit 4 Transceivern und LAN-Modul:

-I- Getting new Started Project --
-I- MapleCUNx4
-I- Compiled: Mar 18 2017 15:46:32 --
-I- init Flash
-I- init Timer
-I- init EEprom
-I- init Ethernet
WIZCHIP Initialized success.
-I- Detected CC0: PN 0x00 VER 0x14
-I- Detected CC1: PN 0x00 VER 0x18
-I- Detected CC2: PN 0x00 VER 0x14
-I- Detected CC3: PN 0x00 VER 0x14
-I- Detected ethernet
-I- init USB
-I- init Complete

== Links ==
* {{Link2Forum|Topic=https://forum.fhem.de/index.php/topic,60458.0.html |LinkText=Diskussion im Forum}}
* [https://github.com/heliflieger/a-culfw/branches Sourcecode]
* [[MapleCUX-Platinen|Fertige Platinen mit Erweiterungen wie mySensors, ESP8266, ...]]

[[Kategorie:Interfaces]]
[[Kategorie:CUL]]
[[Kategorie:433MHz]]