FHEMWiki - Benutzerbeiträge [de]

HM-LC-Sw1PBU-FM Alternative Firmware

2017-12-07T07:45:32Z

Klinki:

{{Randnotiz|RNTyp=r|RNText=Bei den hier gezeigten Modifikationen geht die Garantie verloren und das Gerät verliert seine Zertifizierungen!}}
Um die alternative Firmware auf den [[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach‎|HM-LC-Sw1PBU-FM]] flashen zu können, muss das Gerät geöffnet und ein Programmer angelötet werden.

== Neue Funktionen ==
* Der Taster kann mit anderen Geräten [[Homematic Peering Beispiele|gepeert]] werden. Das ist mit der Originalfirmware nicht möglich.
* Die alternative Firmware hat eine Stromerkennung, die hardwaretechnisch immer vorhanden ist, aber von der eQ-3 Firmware nicht benutzt wird. Es ist möglich, damit eine Wechselschaltung zu implementieren.

Folgende Kanäle sind jetzt verfügbar
{| class="wikitable"
! Kanal
! Bezeichnung
|-
| Button_1
| Taster oben
|-
| Button_2
| Taster unten
|-
| Switch_1
| der Switch_01 (Kanal 3 des Aktors) ist der virtuellen Kanal. Wenn man den einschaltet, brennt das Licht, er berücksichtigt also einen ggf. schon bestehenden Stromfluss. Wenn man den Ausschaltet, geht das Licht aus, wenn es nicht schon aus war. Er zeigt weiterhin an, ob das Licht gerade an oder aus ist.
|-
| Switch_2
| der Switch_02 ist das Relais und funktioniert so , wie die HM-eigene Firmware vorher auch funktioniert hat. Relais an/aus. Den braucht man also "eigentlich nicht".
|}
== Hinweis zum Einbau ==
Bei Einsatz in einer Wechselschaltung (oder Kreuz- und Wechselschaltung) ist der HM Schaltaktor immer auf der Seite der Verkabelung einzubauen, wo die ungeschaltete Phase zugeführt wird. Bei Einbau auf der Seite, die zur Lampe abgeht, funktioniert es nicht, da in diesem Fall im ausgeschalteten Zustand der HM-Switch stromlos ist. Es ist also nicht gleichgültig, an welchem Ende einer (Kreuz- und) Wechselschalter-Kette der HM-Switch eingebaut werden muss.

== Integration des Schalters in FHEM ==
===Vorbereitungen===
Für die alternative Firmware existiert ein eigenes Modul. Dieses ist als Erstes zu installieren bzw nach ./FHEM zu kopieren:
:[https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM/blob/master/fhem/99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm 99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm]

=== Anlernen ===
In FHEM ist der HomeMatic-[[CUL]] in den Anlernmodus zu bringen. Der ConfigButton des Schalters ist nun länger als vier Sekunden zu drücken. Wichtig: die LED darf nach Loslassen des Button nicht aufblinken; sie gibt keine Rückmeldung über den Status des Anlernvorgangs.

Nach dem Anlernen sollte nochmal die aktuelle Config ausgelesen werden. Das kann ein paar Sekunden dauern und ist abgeschlossen, sobald der "state" = "cmds done" ist.
set <HM-LC-SW1PBU-FM_Device> getConfig

Möchte man erneut pairen, so geht dies am einfachsten mit:
set <HM-LC-SW1PBU-FM_Device> regSet pairCentral <123456>

Um den Schalter wie einen "normalen" Schalter wirken zu lassen, müssen noch die Buttons mit dem Switch [[Peering (HomeMatic)|gepeert]] werden. Danach bewirkt ein Tastendruck nach oben ein Einschalten, und ein Druck nach unten ein Ausschalten. Unterlässt man diesen Schritt, passiert bei einem Tastendruck am angeschlossenen Verbraucher nichts.
set <HM-LC-SW1PBU-FM_Btn_01 peerChan 0 <HM-LC-SW1PBU-FM_Sw_01 dual set

Das erzeugt automatisch ein Peering zwischen deinen beiden internen Tastern und dem Kanal 3 (Sw_01). Damit sollte der Schalter eigentlich schon funktionieren

Falls nicht, dann setzt man im Device das Register intKeyVisib auf "visib" und macht ein getConfig auf Kanal 3. Dort sieht man dann die Listen der Peers und erkennt, was dort ein Tastendruck bewirkt. In den Jump Targets (z.B . R-self01-shSwJtDlyOff) usw. muss dann bei dem Button, mit dem man '''AUS'''schalten will überall OFF stehen, und bei dem anderen Button entsprechend On.

Noch einfacher wäre es, falls vorhanden, ein Registerset von einem schon wie gewünscht konfigurierten Schalter (das kann auch einer mit Standard-FW sein) zu kopieren. Das geht mit dem Modul hminfo.

=== Reset ===
Um den Schalter zu resetten ist der ConfigButton 2x hintereinander für > 4sek zu drücken. Auch hier liefert die LED keinerlei Rückmeldung über den Status. Blinks die LED trotzdem auf, so wurde das Drücken des Buttons nicht als "lang" erkannt.
Alternativ kann ein Reset über FHEM ausgelöst werden:
set <HM-LC-SW1PBU-FM_Device> reset

=== Advanced settings ===
Interne Peers
Ein Kanal kann interne Peers haben. Beispiele sind die meisten Schalter oder Dimmer an welchen direkt ein mechanischer Schalter angeschlossen werden kann, oder ein Bedienschalter direkt eingebaut ist. Die Firmware (FW) des Kanals behandelt diesen wie einen externen Peer, nur ist er automatisch eingerichtet. Es stehen die identischen Register wie bei 'normalen' Peers zu Verfügung. Diese Peers sind nicht automatisch sichtbar, können aber sichtbar geschaltet werden. Hierzu ist das
Register '''intKeyVisib''' auf ''visib'' zu setzen (siehe HM-Konfiguration)-siehe auch getConfig. Danach kann man das Verhalten der „eingebauten Peers“ auslesen und verändern wie von jedem anderen Peer auch. Die internen Peers werden '''selfxx''' benannt (self01, self02,...).

regSet <HM-LC-SW1PBU-FM_Sw_01> intKeyVisib visib
set <HM-LC-SW1PBU-FM_SW_01> getConfig

Beispiel: Schaut man in die Readings des Devices und sieht ein: '''R-self01-shActionType off''' bedeutet dies, dass der Button 1 (der nach "oben") deaktiviert ist für diesen Peer und somit keine Funktion hat. Dieser ist auf "jmpToTarget" zu setzen und dann noch die folgenden auf "on":

* R-self01-shSwJtDlyOff
* R-self01-shSwJtDlyOn
* R-self01-shSwJtOff
* R-self01-shSwJtOn

Für Button 2 das selbe, aber eben nicht "on" sondern off.
Natürlich kann man es auch anders nutzen. Z.b. einen Button als Toggle und den anderen Button für etwas völlig anderes. Das ist ja das schöne, dass dies bei der CustomFW möglich ist.

Beispiel das ein kurzer Tastendruck - oben oder unten - ein Toggle bewirkt:
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shActionType jmpToTarget self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOn dlyOff self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOff dlyOn self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOn on self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOff off self01;

set <HM_LC_Sw1PBU_FM_Sw_01> regSet shActionType jmpToTarget self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOn dlyOff self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOff dlyOn self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOn on self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOff off self02;

== Vorgehen zum Flashen ==
=== Anpassung des Strom-Schwellwertes bei LowCurrent Verbrauchern ===
Werden am Schalter nur sehr schwache Verbraucher angeschlossen, so kann u.U. die Statuserkennung (Verbraucher an/aus) nicht korrekt funktionieren. Ändern kann man das in Asksin_HM_LC_Sw1PBU_FM.ino, und zwar hier:
const unsigned long minImpulsLength = 5000;
Dabei entsprechen anscheinend die 5000 dem Schwellwert 500, die kann man jetzt z.B. auf 500 setzen, also Schwellwert 50.

Man muss ein wenig aufpassen, das nicht zu niedrig zu setzen, damit es zu keinen Fehlerkennungen bei Spannungsspitzen im Hausnetz kommt... Beim Autor ist im ausgeschalteten Zustand der Lampe der Wert aber deutlich unter 50...

=== Vorbereitung der Platine des Schalters ===
An der fertigen Platine sind an den folgenden Kontakten Kabel zum Anschluss an das Programmiergerät anzulöten. 
Wenn man den HM-LC-SW1PBU-FM vor sich liegen hat, liegen die Pins in folgender Reihenfolge:
:Reihe 1: MP3 / MP5 / MP6
:Reihe 2: MP15 / MP4 / MP2

=== Anschluss der einzelnen PINs bei Verwendung der GPIO-Ports des Raspberry PI ===
[[Raspberry Pi|Raspberry]] PIN | Beschreibung | HM-LC-Sw1PBU-FM
--------------|--------------|----------------
Pin #17 | 3,3V | MP2
Pin #19 | MOSI | MP4
Pin #21 | MISO | MP5
Pin #23 | SCLK | MP6
Pin #24 | Reset | MP3
Pin #25 | GND | MP15

=== Anschluss der einzelnen PIns bei Nutzung eines ISP-Programmers ===
Bei Nutzung eines "MySmartUSB light" ist dieser vorher mittels mitgeliefertem Windowsprogramm auf 3V zu umzustellen.
ISP-6 PIN | Beschreibung | HM-LC-Sw1PBU-FM
-------------|--------------|----------------
Pin #2 | 3,3V | MP2
Pin #4 | MOSI | MP4
Pin #1 | MISO | MP5
Pin #3 | SCLK | MP6
Pin #5 | Reset | MP3
Pin #6 | GND | MP15

Wichtig beim [[Raspberry Pi]] ist, dass man nicht die von Raspbian ausgelieferte Version des 'avrdude' nutzen kann, sondern eine adaptierte Version verwendet werden muss.
Alle notwendigen Dateien zum Flashen (bereits alles fertig und lauffähig) inkl. einem kleinen HowTo sind im unten stehenden Link 'Flashen mit RaspberryPi' vorhanden.

=== Vorwort zum flashen per avrdude ===
Alle folgenden avrdude befehle beziehen sich in der Reihenfolge auf folgende Programmer. Es ist für den jeweiligen Programmer nur der betreffende Befehle abzusetzen
* Raspberry Pi
* MySmartUSB light (MyAVR)

Die aktuelle Konfiguration der Fuses kann jederzeit ausgelesen werden mit folgendem Befehl:
avrdude -p m644 -P gpio -c gpio -v
avrdude -p m644 -c stk500v2 -P /dev/ttyUSB0 -v

=== Bootloader bauen ===
1) Dirks bootloader-umgebung clonen/downloaden https://github.com/kc-GitHub/Asksin_OTA_Bootloader 
 
2) devicedaten des Schalters (Serial, HMID) in devices/HM-LC-Sw1PBU-FM.h mit den Originaldaten ersetzen und typ=0xF0A9 setzen (modelnummer des schalters mit alternativer firmware). Damit sind die Daten im flash verewigt und man braucht sich eigentlich nicht mehr darum zu kümmern. Bei einem nächsten Bootloader update kann man ein beliebiges bootloader.eq3 file ota flashen. Trotzdem behält der Bootloader seine daten. 
 
3) Bootloader bauen: 
make clean HM_LC_Sw1PBU_FM_8k

=== Bootloader flashen ===
Anschließend muss man nun die Fuses korrekt mit unlock(wichtig) setzen:

avrdude -p m644 -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m
avrdude -p m644 -c stk500v2 -P /dev/ttyUSB0 -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m

und final den Bootloader flashen
avrdude -p m644 -P gpio -c gpio -U flash:w:bootloader_HM-LC-Sw1PBU-FM_8k.hex
avrdude -p m644 -c stk500v2 -P /dev/ttyUSB0 -U flash:w:bootloader_HM-LC-Sw1PBU-FM_8k.hex

=== Firmware bauen ===
==== 1. Firmware mit arduino-IDE ====
''Hinweis:'' Die folgenden Schritte wurden auf einem Raspberry Pi 2 mit Debian Jessie durchgeführt und folgen größtenteils der howtoBuild.txt von Mr.P aus [https://owncloud.isengard.at/index.php/s/8992affb68e8c1dcbe532152628ad9a5]
* In manchen Adruino-IDE Umgebungen werden Builds gelöscht, bevor sie auf die Hardware gespielt werden. Das muss verhindert werden! Bei Raspbian Jessie und dem User pi befinden sich die Voreinstellungen der IDE in /home/pi/.arduino/preferences.txt. Dort folgende Änderungen machen, bzw. Einträge hinzufügen
<pre>
...
build.path=/home/pi/build
...
export.delete_target_folder=false
...
preproc.save_build_files=true
...
</pre>
* Auf den raspi in den Ordner ''/usr/share/arduino/hardware'' wechseln. Hardware-Board für den ATMega644 laden
<pre>
git clone https://github.com/jabdoa2/jabduino
</pre>
* Arduino im grafischen Frontend (oder X-Terminal) starten. unter <File>/<Preferences> findet man den Sketchbook-Ordner
* Über die Konsole in den Sketchbook-Ordner wechseln. Für User "pi" idR ''/home/pi/sketchbook''
* Dort die Firmware-Quellen einfügen
<pre>
git clone https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM.git
</pre>
* Wieder in die Arduino-Umgebung wechseln, unter <File>/<Sketchbook>/<Asksin_HM_LC_Sw1PBU_FM> öffnen
* unter <Tools>/<Board> "Jabduino ATmega644A" auswählen
* In der Datei ''Asksin_HM_LC_Sw1PBU_FM'' den Wert in Zeile 64 eventuell "const unsigned long minImpulsLength = 5000;" ändern. Der dort eingetragene Wert gilt als Schwellwert, wann der Schalter erkennen soll, dass ein angeschlossener Wechselschalter gedrückt wurde und somit erkannt wird, dass Strom fließt.
* in der Datei ''Register.h'' in Zeile 22 den Wert von HMID[3] ändern. Z.B.: "const uint8_t HMID[3] = { 0x20, 0x85, 0x57 }; // 208557"
Zusätzlich kann die eigene Zentrale bereits als Default-Wert in den Schalter eingetragen werden. Dadurch entfällt ein unter Umständen notwendiges Peering. Dafür muss die Zeile 347 von '//#define firstLoad' in '#define firstLoad' geändert werden
In den Zeilen 354 bis 356 die Werte für die FHEM-Zentral-ID einfügen (Reading: D-HMIdOriginal 2CC71D)
reg.ch_0.pairCentral[0] = 0x2C;
reg.ch_0.pairCentral[1] = 0xC7;
reg.ch_0.pairCentral[2] = 0x1D;
Auch andere Default-Werte wie Peerings und Schaltverhalten können an dieser Stelle verändert werden. Sollte das nicht gewünscht sein, sind diese Zeilen entweder auszukommentieren oder einfach zu löschen.
* Alle Dateien speichern
* <Sketch>/<Verifiy/Compile> alles kompilieren
* Im oben definierten Build-Path (/home/pi/build) sollte jetzt eine Datei ''Asksin_HM_LC_Sw1PBU_FM.cpp.hex'' stehen. Das ist unsere fertige Firmware, die auf den Schalter geflasht werden muss

=== Firmware über Raspberry Pi flashen ===
* Hinweis: In älteren Beschreibungen findet man häufig die Ziel-Plattform m644. Diese unterscheidet sich praktisch in der Stromaufnahme des Chips, führt beim avrdude aber zu '''Fehlermeldungen''', deshalb auf '''m6444p''' achten
* 1. '''Fuses''' setzen
''avrdude -p m644p -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: reading input file "0xFD"
avrdude: writing lfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of lfuse written
avrdude: verifying lfuse memory against 0xFD:
avrdude: load data lfuse data from input file 0xFD:
avrdude: input file 0xFD contains 1 bytes
avrdude: reading on-chip lfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of lfuse verified
avrdude: reading input file "0xD8"
avrdude: writing hfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of hfuse written
avrdude: verifying hfuse memory against 0xD8:
avrdude: load data hfuse data from input file 0xD8:
avrdude: input file 0xD8 contains 1 bytes
avrdude: reading on-chip hfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of hfuse verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* 2. '''Bootloader''' flashen (falls noch nicht geschehen, wie [[HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen|oben]] beschrieben)
''avrdude -p m644p -P gpio -c gpio -U flash:w:bootloader_HM-LC-Sw1PBU-FM.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "bootloader_HM-LC-Sw1PBU-FM.hex"
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: writing flash (61372 bytes):
Writing | ################################################## | 100% 30.86s
avrdude: 61372 bytes of flash written
avrdude: verifying flash memory against bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: load data flash data from input file bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex contains 61372 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 28.95s
avrdude: verifying ...
avrdude: 61372 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* 3. '''Firmware''' flashen (aus der Arduino-IDE)
''avrdude -p m644p -P gpio -c gpio -U flash:w:Asksin_HM_LC_Sw1PBU_FM.cpp.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "Asksin_HM_LC_Sw1PBU_FM.cpp.hex"
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: writing flash (19042 bytes):
Writing | ################################################## | 100% 9.79s
avrdude: 19042 bytes of flash written
avrdude: verifying flash memory against Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: load data flash data from input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex contains 19042 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 9.28s
avrdude: verifying ...
avrdude: 19042 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>

Oder man flasht die Firmware, wie im folgenden Abschnitt beschrieben, OTA (over the air). Das funktioniert mit dem Bootloader natürlich nicht. Dieser kann nur über einen Programmer oder Raspberry Pi auf den Schalter geflasht werden.
Der Vorteil bei OTA ist, dass für ein Update der Firmware der Schalter nicht mehr ausgebaut werden müsste.

=== Firmware OTA flashen ===
====1. Konvertieren in das eq3 Format====
Konvertieren der Hex-Datei in das eq3 format mittels [https://github.com/kc-GitHub/Wettersensor/blob/master/Contrib/hex2eq3.php hex2eq3.php] (die php-cli muss installiert sein)

php hex2eq3.php --inFile Asksin_HM_LC_Sw1PBU_FM.cpp.hex --outFile HM_LC_Sw1PBU_FM.eq3 --spmPageSize 256 --hexEndAddress 0xDFFE --outFormat eq3 --withCrcCheck --pathTo-srec_cat /usr/bin/srec_cat

====2. Flashvorgang starten====
Im flash-ota Tool eq3 das Device, die File- und Seriennummer eingeben 
Solltet ihr mittels CUL, COC oder HM-CFG-USB-2 direkt auf eurem Raspberry flashen, könnt ihr das bereitgestellte [https://owncloud.isengard.at/public.php?service=files&t=8992affb68e8c1dcbe532152628ad9a5&path=%2F&files=flash-ota&download flash-ota Binary] verwenden. Ansonsten einfach [https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb herunterladen] und für euer System selbst kompilieren:

Wenn ihr einen HM-CFG-USB-2 verwendet, wird flash-ota mittels:
flash-ota -f firmware_HM-LC-Sw1PBU-FM.eq3 -s <SerialNr>
gestartet. Bei Verwendung eines CUL oder COC, muss das Device mit angegeben werden:
flash-ota -f firmware_HM-LC-Sw1PBU-FM.eq3 -s <SerialNr> -c /dev/ttyAMA0 # für den COC
flash-ota -f firmware_HM-LC-Sw1PBU-FM.eq3 -s <SerialNr> -c /dev/ttyACM0 # für den CUL

====3. Bootloader aktivieren====
Zum Abschluss muss der Bootloader im Device/Schalter aktiviert werden. Dazu ist das Device zu resetten: 
* Netzversorgung vom schalter ausschalten, config taster drücken und halten, spannung einschalten und weiterhin gedrückt halten bis erstes blinken erscheint. 
oder falls das Device bereits in FHEM angelegt und gepaired ist: 
* Device in fhem ein "set <device> reset" absetzen, danach innerhalb von 10sek die ConfigTaste für ???-sek drücken
* Dies funktioniert mit der Firmware ohne Änderungen definitiv nicht. Es löst ausschließlich einen Werksreset im Schalter aus
Um den Bootloader am Schalter selbst zu aktivieren, ohne den Schalter stromlos zu machen, muss die Firmware, hier '''Asksin_HM_LC_Sw1PBU_FM.ino''' und '''register.h''', gemäß {{Link2Forum|Topic=18071|Message=275891|LinkText=Forum}} ('''Danke''' Frank!) angepasst werden.

Nach diesen Änderungen hat der Schalter unter anderem ein Bootmenü mit 3 Menüoptionen:
* Option 1: Manueller Reboot '''-> diese ist zu wählen'''
* Option 2: enable software reboot (fhem kann durch set fwupdate das Booten einleiten, weiterführende Lektüre {{Link2Forum|Topic=23329|LinkText=hier}}.
* Option 3: disable software reboot (das automatische Booten wird verhindert, default)
Man gelangt in das Menü, indem man das lange Drücken des Config-Tasters über die ersten 3 Sekunden verlängert. Alle 3 Sekunden erfolgt ein Umschalten in die nächste Bootmenüoption.

Die augenblickliche Option wird durch Blinken angezeigt:
* Option 1 1x blinken
* Option 2 2x blinken
* Option 3 3x blinken
Nach der 3. Option gelangt man wieder zur 1. Option, usw ... 
Wird der Config-Taster nach dem jeweiligen Blinken losgelassen, wird die entsprechende Menüoption ausgeführt.

Jetzt sollte man beim Flashtool etwas sehen. Während des flashens blinkt auch die LED auf dem Schalter analog den übertragenen Datenblöcken

===Bootloader OTA flashen===
Soll später ein neuer Bootloader mit neuen Features installiert werden, so kann dieser ebenfalls OTA geflashed werden ohne Schalter ausbauen und Löten.

Der Bootloader ist zu bauen wie im Abschnitt zuvor erklärt. Anschließend mit dem hex2eq3 Tool konvertiert:
php contrib\hex2eq3.php --inFile Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.hex --outFile Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.eq3 --spmPageSize 256 --hexEndAddress 0xDFFE --outFormat eq3 --markAsBootloaderUpdate --withCrcCheck --pathTo-srec_cat /usr/bin/srec_cat
Der anschließende OTA Flashvorgang erfolgt analog dem Firmware-OTA-Flash wie weiter oben beschrieben

=== UART nutzen ===
Für Debuggingausgaben für Entwickler: Statt /dev/ttyXXX das eigene Interface einfügen:
* /dev/ttyUSB0 (USB Interface)
* /dev/ttyAMA0 (Raspberry PI)
* /dev/ttyS0 (normaler Serieller Port)

Öffnen
* Direkt in der Arduino IDE (Tools -> Serial Monitor)
* Mit ''screen''
screen /dev/ttyXXX 57600,CS8,ixon,ixoff
* Mit ''minicom''
sudo apt-get install minicom
minicom -b 57600 -o -D /dev/ttyXXX -w

== Links ==
* Firmware: [https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM]
* Bootloader: [https://github.com/jabdoa2/Asksin_OTA_Bootloader]
* Arduino Port für Atmega 644: [https://github.com/jabdoa2/jabduino]
* Firmware bauen und flashen mit dem RaspberryPi: [https://owncloud.isengard.at/public.php?service=files&t=8992affb68e8c1dcbe532152628ad9a5]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]
[[Kategorie:Schalter (Empfänger)]]

HM-LC-Sw1PBU-FM Alternative Firmware am Raspi bauen u. flashen

2016-11-11T11:36:29Z

Klinki:

= 1fach Schaltaktor HM-LC-Sw1PBU-FM mit alternativer Firmware =
* Sinn und Zweck: Der Schalter bietet mit der alternativen Firmware die Möglichkeit ihn in Wechselschaltungen zu integrieren. In einer normalen Wechselschaltung ist es nicht möglich, den Schaltzustand der Lampe zu erkennen. Das Funktioniert nur wenn der Schaltzustand(Leistungsaufnahme) von Funkschalter erkannt werden kann.
* Vorwort: Dieser Artikel ist eigentlich nur eine Zusammenfassung dessen, was bereits in [[HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen | HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen]] steht! Dort stammen auch alle Tools, Hilfsprogramme und Informationen her.
Ich habe ledigleich alles auf das Flashen am Raspberry Pi ausgerichtet. Mein Dank gilt den Programmierern der Firmware und allen Leuten, die das Projekt mit- und weiterentwickelt haben.

== Vorbereitung ==
* Windows 7 Desktop-Rechner mit Browser, Text-Editor, puTTY und WinSCP. Man kann zwar alle Schritte auch direkt auf dem Raspi durchführen - ich finde den Windows-Rechner aber praktischer
* Raspbian Jessie mit Pixel downloaden [https://www.raspberrypi.org/downloads/raspbian/]. Kernel 4.4 Release 2016 09 23
** Mit WinDiskImager auf min. 8GB SD-Karte spielen, s. auch [http://www.raspberry-projects.com/pi/pi-operating-systems/win32diskimager]
* Raspberry Pi 2B
** Die Pins des Raspi müssen nach folgendem Schema mit den Lötpads des HM-LC-Sw1PBU-FM verbunden werden. Die Messpunkte (MP) befinden sich auf der inneren, festgeschraubten, Platine des HM-Schalters
[[Raspberry Pi|Raspberry]] PIN | Beschreibung | HM-LC-Sw1PBU-FM
--------------|--------------|----------------
Pin #17 | 3,3V | MP2
Pin #19 | MOSI | MP4
Pin #21 | MISO | MP5
Pin #23 | SCLK | MP6
Pin #24 | Reset | MP3
Pin #25 | GND | MP15
** Hinweis: Den Schalter während des gesamten Prozesses '''nicht mit 230V verbinden'''. Während des gesamtem Flash-Vorgangs kann die Spannungsvorsorgung aus dem Raspi genutzt werden
* Nachdem Raspbian sich installiert hat, geht man auf die Linux-Konsole. Entweder direkt oder per puTTY über SSH. Auf dem Raspi arbeite ich gerne als User root, deswegen vergebe ich diesem ein Passwort:
<pre>
sudo passwd root
// user root werden
su - root
</pre>
* Raspi OS updaten
<pre>
apt-get update && apt-get upgrade && apt-get dist-upgrade
</pre>
* Software installieren: C-Compiler, arduino-IDE
<pre>
apt-get install arduino gcc-avr
</pre>

* (Optional) Über ''raspi-config -> Internationialisation Options'' Keyboard-Layout, Locale, Timezone anpassen
* Über ''raspi-config -> Advanced Options'' SPI, Serial, I2C ausschalten (falls aktiv)
* reboot
* Verzeichnis für Downloads auf dem Raspi erstellen und dorthin wechseln
<pre>
mkdir /root/hm_switch
mkdir /root/hm_switch/flash
cd /root/hm_switch
</pre>
* Bootloader-Umgebung herunterladen
<pre>
git clone https://github.com/jabdoa2/Asksin_OTA_Bootloader
</pre>
* Firmware herunterladen
<pre>
git clone https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM
</pre>
* Dateien aus [https://seafile.partec.org/d/b6590a5a45/] herunterladen und auf dem Raspi in's erstellte Verzeichnis ''/root/hm_switch'' kopieren. Da ich nicht weiß, wie man per wget Dateien eines Cloud-Servers auf einer Linux-Maschine kopiert, führe ich diesen Vorgang mit WinSCP durch.
** Das Modul 99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm muss in die fhem-Installation (/opt/fehm/FHEM) kopiert werden. Ansonsten wird der Schalter beim '''Anlernen nicht erkannt'''
* Da die Programming-Software aus dem original Repository nicht verwendet werden kann, muss die Version aus dem Dowload installiert werden
<pre>
dpkg -i avrdude_5.10-4_armhf.deb
</pre>
* In der .conf steht die Definition der Anschlüsse für den Raspi. Diese entpacken und nach /etc kopieren
<pre>
gunzip avrdude.conf.gz && cp avrdude.conf /etc/
</pre>
==Arduino-IDE einrichten /Firmware bauen==
* Die IDE wird zum späteren Kompilieren der Firmware benötigt - es ist keine Arduino-Hardware erforderlich!
* Build-Pfad für Arduino-IDE erstellen:
<pre>
mkdir /home/pi/build && chmod -R 777 /home/pi/build
</pre>
* In den Ordner ''/usr/share/arduino/hardware'' wechseln und Hardware-Board für den ATMega644 laden
<pre>
cd /usr/share/arduino/hardware
git clone https://github.com/jabdoa2/jabduino
</pre>
* Um alle Pfade und Dateien zu erzeugen, muss die Arduino-IDE aufgerufen und anschließend direkt wieder geschlossen werden. Das kann man in der grafischen Umgebung des Raspis, oder über ein entferntes X-Terminal tun.
* In manchen Adruino-IDE Umgebungen werden Builds gelöscht, bevor sie auf die Hardware gespielt werden. Das muss verhindert werden! Bei Raspbian Jessie und dem User pi befinden sich die Voreinstellungen der IDE in ''/home/pi/.arduino/preferences.txt''. Über die Konsole dort folgende Änderungen machen, bzw. Einträge hinzufügen
<pre>
...
build.path=/home/pi/build
...
export.delete_target_folder=false
...
preproc.save_build_files=true
...
</pre>
* Firmware-Quellen in den Sketchbook-Ordner von User ''pi'' kopieren und Rechte für alle setzen
<pre>
cp -R /root/hm_switch/Asksin_HM_LC_Sw1PBU_FM/ /home/pi/sketchbook/ && chmod -R 777 /home/pi/sketchbook/
</pre>
* Wieder in die grafische IDE wechseln
** ''Tools -> Board ->'' "Jabduino ATmega644A" auswählen
** ''File -> Sketchbook -> '' "Asksin_HM_LC_Sw1PBU_FM" öffnen
** In der Datei Asksin_HM_LC_Sw1PBU_FM den Wert in Zeile 64 eventuell "const unsigned long minImpulsLength = 5000;" ändern. Der dort eingetragene Wert gilt als Schwellwert, wann der Schalter erkennen soll, dass ein angeschlossener Wechselschalter gedrückt wurde und somit erkannt wird, dass Strom fließt.
** In der Datei ''Register.h'' in Zeile 22 den Wert von HMID[3] ändern.
Zusätzlich kann die eigene Zentrale bereits als Default-Wert in den Schalter eingetragen werden. Dadurch entfällt ein unter Umständen notwendiges Peering. Dafür muss die Zeile 347 von //#define firstLoad' in '#define firstLoad' geändert werden In den Zeilen 354 bis 356 die Werte für die FHEM-Zentral-ID einfügen (Reading: D-HMIdOriginal 2CC71D) reg.ch_0.pairCentral[0] = 0x2C; reg.ch_0.pairCentral[1] = 0xC7; reg.ch_0.pairCentral[2] = 0x1D; Auch andere Default-Werte wie Peerings und Schaltverhalten können an dieser Stelle verändert werden. Sollte das nicht gewünscht sein, sind diese Zeilen entweder auszukommentieren oder einfach zu löschen.
** Beispiel (Auszug aus Register.h mit Zeilenangaben)
<pre>
<16>/* Serial ID 10 byte */ 'K','E','Q','0','0','0','0','0','0','7', // serial ID, needed for pairing
<22> const uint8_t HMID[3] = { 0x08, 0x15, 0x07 }; // 081507
</pre>
** Die beiden geänderten Dateien speichern und mit ''Sketch -> Überprüfen / Kompilieren'' kompilieren. Im unteren Fenster auf Fehlermeldungen achten!
** Wenn dies funktioniert hat, sollte im Ordner ''/home/pi/build'' die Datei ''Asksin_HM_LC_Sw1PBU_FM.cpp.hex'' mit aktuellem Datum erzeugt worden sein.

== Bootloader ==
* Datei /root/hm_switch/Asksin_OTA_Bootloader/devices/HM-LC-Sw1PBU-FM.h editieren und dabei Seriennummer, HMID und die Typ setzen. Seriennummer und HMID müssen in eurer Umgebung eindeutig sein, Typ ist: '''0xF0A9'''
<pre>
nano /root/hm_switch/Asksin_OTA_Bootloader/devices/HM-LC-Sw1PBU-FM.h
</pre>
** Beispiel: HMID -> 081507, Seriennummer: KEQ0000007
<pre>
/ The model type (not used from bootloader)
#define HM_TYPE 0xF0, 0xA9
// 10 bytes serial number. Must be unique for each device
#define HM_SERIAL 'K', 'E', 'Q', '0', '0', '0', '0', '0', '0', '7'
// 3 bytes The device address (hm_id)
#define HM_ID 0x08, 0x15, 0x07
</pre>
* Eine Verzeichnisebene höher und Bootloader bauen:
<pre>
cd /root/hm_switch/Asksin_OTA_Bootloader/
make clean HM_LC_Sw1PBU_FM_8k
</pre>
Dabei sollte die Datei ''bootloader_HM-LC-Sw1PBU-FM.hex'' herauskommen. Diese wird später auf den Schalter geflasht

== Flashen ==
* Erzeugte Bootloader-Datei und Firmware in ein Verzeichnis kopieren:
<pre>
cp /home/pi/build/Asksin_HM_LC_Sw1PBU_FM.cpp.hex /root/hm_switch/flash/firmware.hex && cp /root/hm_switch/Asksin_OTA_Bootloader/Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.hex /root/hm_switch/flash/bootloader.hex
cd /root/hm_switch/flash/
</pre>
* Hinweis: In älteren Beschreibungen findet man häufig die Ziel-Plattform m644. Diese Unterscheidet sich praktisch in der Stromaufnahme des Chips, führt beim avrdude aber zu '''Fehlermeldungen''', deshalb auf '''m6444p''' achten
* '''Fuses''' setzen
''avrdude -p m644p -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: reading input file "0xFD"
avrdude: writing lfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of lfuse written
avrdude: verifying lfuse memory against 0xFD:
avrdude: load data lfuse data from input file 0xFD:
avrdude: input file 0xFD contains 1 bytes
avrdude: reading on-chip lfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of lfuse verified
avrdude: reading input file "0xD8"
avrdude: writing hfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of hfuse written
avrdude: verifying hfuse memory against 0xD8:
avrdude: load data hfuse data from input file 0xD8:
avrdude: input file 0xD8 contains 1 bytes
avrdude: reading on-chip hfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of hfuse verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* '''Bootloader''' flashen
''avrdude -p m644p -P gpio -c gpio -U flash:w:bootloader.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "bootloader_HM-LC-Sw1PBU-FM.hex"
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: writing flash (61372 bytes):
Writing | ################################################## | 100% 30.86s
avrdude: 61372 bytes of flash written
avrdude: verifying flash memory against bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: load data flash data from input file bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex contains 61372 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 28.95s
avrdude: verifying ...
avrdude: 61372 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* '''Firmware''' flashen (aus der Arduino-IDE)
''avrdude -p m644p -P gpio -c gpio -U flash:w:firmware.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "Asksin_HM_LC_Sw1PBU_FM.cpp.hex"
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: writing flash (19042 bytes):
Writing | ################################################## | 100% 9.79s
avrdude: 19042 bytes of flash written
avrdude: verifying flash memory against Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: load data flash data from input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex contains 19042 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 9.28s
avrdude: verifying ...
avrdude: 19042 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]
[[Kategorie:Schalter (Empfänger)]]

HM-LC-Sw1PBU-FM Alternative Firmware am Raspi bauen u. flashen

2016-11-11T11:33:23Z

Klinki: /* Arduino-IDE einrichten /Firmware bauen */

= 1fach Schaltaktor HM-LC-Sw1PBU-FM mit alternativer Firmware =
* Sinn und Zweck: Der Schalter bietet mit der alternativen Firmware die Möglichkeit ihn in Wechselschaltungen zu integrieren. In einer normalen Wechselschaltung ist es nicht möglich, den Schaltzustand der Lampe zu erkennen. Das Funktioniert nur wenn der Schaltzustand(Leistungsaufnahme) von Funkschalter erkannt werden kann.
* Vorwort: Dieser Artikel ist eigentlich nur eine Zusammenfassung dessen, was bereits in [[HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen | HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen]] steht! Dort stammen auch alle Tools, Hilfsprogramme und Informationen her.
Ich habe ledigleich alles auf das Flashen am Raspberry Pi ausgerichtet. Mein Dank gilt den Programmierern der Firmware und allen Leuten, die das Projekt mit- und weiterentwickelt haben.

== Vorbereitung ==
* Windows 7 Desktop-Rechner mit Browser, Text-Editor, puTTY und WinSCP. Man kann zwar alle Schritte auch direkt auf dem Raspi durchführen - ich finde den Windows-Rechner aber praktischer
* Raspbian Jessie mit Pixel downloaden [https://www.raspberrypi.org/downloads/raspbian/]. Kernel 4.4 Release 2016 09 23
** Mit WinDiskImager auf min. 8GB SD-Karte spielen, s. auch [http://www.raspberry-projects.com/pi/pi-operating-systems/win32diskimager]
* Raspberry Pi 2B
** Die Pins des Raspi müssen nach folgendem Schema mit den Lötpads des HM-LC-Sw1PBU-FM verbunden werden. Die Messpunkte (MP) befinden sich auf der inneren, festgeschraubten, Platine des HM-Schalters
[[Raspberry Pi|Raspberry]] PIN | Beschreibung | HM-LC-Sw1PBU-FM
--------------|--------------|----------------
Pin #17 | 3,3V | MP2
Pin #19 | MOSI | MP4
Pin #21 | MISO | MP5
Pin #23 | SCLK | MP6
Pin #24 | Reset | MP3
Pin #25 | GND | MP15
** Hinweis: Den Schalter während des gesamten Prozesses '''nicht mit 230V verbinden'''. Während des gesamtem Flash-Vorgangs kann die Spannungsvorsorgung aus dem Raspi genutzt werden
* Nachdem Raspbian sich installiert hat, geht man auf die Linux-Konsole. Entweder direkt oder per puTTY über SSH. Auf dem Raspi arbeite ich gerne als User root, deswegen vergebe ich diesem ein Passwort:
<pre>
sudo passwd root
// user root werden
su - root
</pre>
* Raspi OS updaten
<pre>
apt-get update && apt-get upgrade && apt-get dist-upgrade
</pre>
* Software installieren: C-Compiler, arduino-IDE
<pre>
apt-get install arduino gcc-avr
</pre>

* (Optional) Über ''raspi-config -> Internationialisation Options'' Keyboard-Layout, Locale, Timezone anpassen
* Über ''raspi-config -> Advanced Options'' SPI, Serial, I2C ausschalten (falls aktiv)
* reboot
* Verzeichnis für Downloads auf dem Raspi erstellen und dorthin wechseln
<pre>
mkdir /root/hm_switch
mkdir /root/hm_switch/flash
cd /root/hm_switch
</pre>
* Bootloader-Umgebung herunterladen
<pre>
git clone https://github.com/jabdoa2/Asksin_OTA_Bootloader
</pre>
* Firmware herunterladen
<pre>
git clone https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM
</pre>
* Dateien aus [https://seafile.partec.org/d/b6590a5a45/] herunterladen und auf dem Raspi in's erstellte Verzeichnis ''/root/hm_switch'' kopieren. Da ich nicht weiß, wie man per wget Dateien eines Cloud-Servers auf einer Linux-Maschine kopiert, führe ich diesen Vorgang mit WinSCP durch.
** Das Modul 99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm muss in die fhem-Installation (/opt/fehm/FHEM) kopiert werden. Ansonsten wird der Schalter beim '''Anlernen nicht erkannt'''
* Da die Programming-Software aus dem original Repository nicht verwendet werden kann, muss die Version aus dem Dowload installiert werden
<pre>
dpkg -i avrdude_5.10-4_armhf.deb
</pre>
* In der .conf steht die Definition der Anschlüsse für den Raspi. Diese entpacken und nach /etc kopieren
<pre>
gunzip avrdude.conf.gz && cp avrdude.conf /etc/
</pre>
==Arduino-IDE einrichten /Firmware bauen==
* Die IDE wird zum späteren Kompilieren der Firmware benötigt - es ist keine Arduino-Hardware erforderlich!
* Build-Pfad für Arduino-IDE erstellen:
<pre>
mkdir /home/pi/build && chmod -R 777 /home/pi/build
</pre>
* In den Ordner ''/usr/share/arduino/hardware'' wechseln und Hardware-Board für den ATMega644 laden
<pre>
cd /usr/share/arduino/hardware
git clone https://github.com/jabdoa2/jabduino
</pre>
* Um alle Pfade und Dateien zu erzeugen, muss die Arduino-IDE aufgerufen und anschließend direkt wieder geschlossen werden. Das kann man in der grafischen Umgebung des Raspis, oder über ein entferntes X-Terminal tun.
* In manchen Adruino-IDE Umgebungen werden Builds gelöscht, bevor sie auf die Hardware gespielt werden. Das muss verhindert werden! Bei Raspbian Jessie und dem User pi befinden sich die Voreinstellungen der IDE in ''/home/pi/.arduino/preferences.txt''. Über die Konsole dort folgende Änderungen machen, bzw. Einträge hinzufügen
<pre>
...
build.path=/home/pi/build
...
export.delete_target_folder=false
...
preproc.save_build_files=true
...
</pre>
* Firmware-Quellen in den Sketchbook-Ordner von User ''pi'' kopieren und Rechte für alle setzen
<pre>
cp -R Asksin_HM_LC_Sw1PBU_FM/ /home/pi/sketchbook/ && chmod -R 777 /home/pi/sketchbook/
</pre>
* Wieder in die grafische IDE wechseln
** ''Tools -> Board ->'' "Jabduino ATmega644A" auswählen
** ''File -> Sketchbook -> '' "Asksin_HM_LC_Sw1PBU_FM" öffnen
** In der Datei Asksin_HM_LC_Sw1PBU_FM den Wert in Zeile 64 eventuell "const unsigned long minImpulsLength = 5000;" ändern. Der dort eingetragene Wert gilt als Schwellwert, wann der Schalter erkennen soll, dass ein angeschlossener Wechselschalter gedrückt wurde und somit erkannt wird, dass Strom fließt.
** In der Datei ''Register.h'' in Zeile 22 den Wert von HMID[3] ändern.
Zusätzlich kann die eigene Zentrale bereits als Default-Wert in den Schalter eingetragen werden. Dadurch entfällt ein unter Umständen notwendiges Peering. Dafür muss die Zeile 347 von //#define firstLoad' in '#define firstLoad' geändert werden In den Zeilen 354 bis 356 die Werte für die FHEM-Zentral-ID einfügen (Reading: D-HMIdOriginal 2CC71D) reg.ch_0.pairCentral[0] = 0x2C; reg.ch_0.pairCentral[1] = 0xC7; reg.ch_0.pairCentral[2] = 0x1D; Auch andere Default-Werte wie Peerings und Schaltverhalten können an dieser Stelle verändert werden. Sollte das nicht gewünscht sein, sind diese Zeilen entweder auszukommentieren oder einfach zu löschen.
** Beispiel (Auszug aus Register.h mit Zeilenangaben)
<pre>
<16>/* Serial ID 10 byte */ 'K','E','Q','0','0','0','0','0','0','7', // serial ID, needed for pairing
<22> const uint8_t HMID[3] = { 0x08, 0x15, 0x07 }; // 081507
</pre>
** Die beiden geänderten Dateien speichern und mit ''Sketch -> Überprüfen / Kompilieren'' kompilieren. Im unteren Fenster auf Fehlermeldungen achten!
** Wenn dies funktioniert hat, sollte im Ordner ''/home/pi/build'' die Datei ''Asksin_HM_LC_Sw1PBU_FM.cpp.hex'' mit aktuellem Datum erzeugt worden sein.

== Bootloader ==
* Datei /root/hm_switch/Asksin_OTA_Bootloader/devices/HM-LC-Sw1PBU-FM.h editieren und dabei Seriennummer, HMID und die Typ setzen. Seriennummer und HMID müssen in eurer Umgebung eindeutig sein, Typ ist: '''0xF0A9'''
<pre>
nano /root/hm_switch/Asksin_OTA_Bootloader/devices/HM-LC-Sw1PBU-FM.h
</pre>
** Beispiel: HMID -> 081507, Seriennummer: KEQ0000007
<pre>
/ The model type (not used from bootloader)
#define HM_TYPE 0xF0, 0xA9
// 10 bytes serial number. Must be unique for each device
#define HM_SERIAL 'K', 'E', 'Q', '0', '0', '0', '0', '0', '0', '7'
// 3 bytes The device address (hm_id)
#define HM_ID 0x08, 0x15, 0x07
</pre>
* Eine Verzeichnisebene höher und Bootloader bauen:
<pre>
cd /root/hm_switch/Asksin_OTA_Bootloader/
make clean HM_LC_Sw1PBU_FM_8k
</pre>
Dabei sollte die Datei ''bootloader_HM-LC-Sw1PBU-FM.hex'' herauskommen. Diese wird später auf den Schalter geflasht

== Flashen ==
* Erzeugte Bootloader-Datei und Firmware in ein Verzeichnis kopieren:
<pre>
cp /home/pi/build/Asksin_HM_LC_Sw1PBU_FM.cpp.hex /root/hm_switch/flash/firmware.hex && cp /root/hm_switch/Asksin_OTA_Bootloader/Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.hex /root/hm_switch/flash/bootloader.hex
cd /root/hm_switch/flash/
</pre>
* Hinweis: In älteren Beschreibungen findet man häufig die Ziel-Plattform m644. Diese Unterscheidet sich praktisch in der Stromaufnahme des Chips, führt beim avrdude aber zu '''Fehlermeldungen''', deshalb auf '''m6444p''' achten
* '''Fuses''' setzen
''avrdude -p m644p -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: reading input file "0xFD"
avrdude: writing lfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of lfuse written
avrdude: verifying lfuse memory against 0xFD:
avrdude: load data lfuse data from input file 0xFD:
avrdude: input file 0xFD contains 1 bytes
avrdude: reading on-chip lfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of lfuse verified
avrdude: reading input file "0xD8"
avrdude: writing hfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of hfuse written
avrdude: verifying hfuse memory against 0xD8:
avrdude: load data hfuse data from input file 0xD8:
avrdude: input file 0xD8 contains 1 bytes
avrdude: reading on-chip hfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of hfuse verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* '''Bootloader''' flashen
''avrdude -p m644p -P gpio -c gpio -U flash:w:bootloader.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "bootloader_HM-LC-Sw1PBU-FM.hex"
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: writing flash (61372 bytes):
Writing | ################################################## | 100% 30.86s
avrdude: 61372 bytes of flash written
avrdude: verifying flash memory against bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: load data flash data from input file bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex contains 61372 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 28.95s
avrdude: verifying ...
avrdude: 61372 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* '''Firmware''' flashen (aus der Arduino-IDE)
''avrdude -p m644p -P gpio -c gpio -U flash:w:firmware.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "Asksin_HM_LC_Sw1PBU_FM.cpp.hex"
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: writing flash (19042 bytes):
Writing | ################################################## | 100% 9.79s
avrdude: 19042 bytes of flash written
avrdude: verifying flash memory against Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: load data flash data from input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex contains 19042 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 9.28s
avrdude: verifying ...
avrdude: 19042 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]
[[Kategorie:Schalter (Empfänger)]]

HM-LC-Sw1PBU-FM Alternative Firmware am Raspi bauen u. flashen

2016-11-11T11:24:41Z

Klinki: Die Seite wurde neu angelegt: „= 1fach Schaltaktor HM-LC-Sw1PBU-FM mit alternativer Firmware = * Sinn und Zweck: Der Schalter bietet mit der alternativen Firmware die Möglichkeit ihn in Wec…“

= 1fach Schaltaktor HM-LC-Sw1PBU-FM mit alternativer Firmware =
* Sinn und Zweck: Der Schalter bietet mit der alternativen Firmware die Möglichkeit ihn in Wechselschaltungen zu integrieren. In einer normalen Wechselschaltung ist es nicht möglich, den Schaltzustand der Lampe zu erkennen. Das Funktioniert nur wenn der Schaltzustand(Leistungsaufnahme) von Funkschalter erkannt werden kann.
* Vorwort: Dieser Artikel ist eigentlich nur eine Zusammenfassung dessen, was bereits in [[HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen | HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen]] steht! Dort stammen auch alle Tools, Hilfsprogramme und Informationen her.
Ich habe ledigleich alles auf das Flashen am Raspberry Pi ausgerichtet. Mein Dank gilt den Programmierern der Firmware und allen Leuten, die das Projekt mit- und weiterentwickelt haben.

== Vorbereitung ==
* Windows 7 Desktop-Rechner mit Browser, Text-Editor, puTTY und WinSCP. Man kann zwar alle Schritte auch direkt auf dem Raspi durchführen - ich finde den Windows-Rechner aber praktischer
* Raspbian Jessie mit Pixel downloaden [https://www.raspberrypi.org/downloads/raspbian/]. Kernel 4.4 Release 2016 09 23
** Mit WinDiskImager auf min. 8GB SD-Karte spielen, s. auch [http://www.raspberry-projects.com/pi/pi-operating-systems/win32diskimager]
* Raspberry Pi 2B
** Die Pins des Raspi müssen nach folgendem Schema mit den Lötpads des HM-LC-Sw1PBU-FM verbunden werden. Die Messpunkte (MP) befinden sich auf der inneren, festgeschraubten, Platine des HM-Schalters
[[Raspberry Pi|Raspberry]] PIN | Beschreibung | HM-LC-Sw1PBU-FM
--------------|--------------|----------------
Pin #17 | 3,3V | MP2
Pin #19 | MOSI | MP4
Pin #21 | MISO | MP5
Pin #23 | SCLK | MP6
Pin #24 | Reset | MP3
Pin #25 | GND | MP15
** Hinweis: Den Schalter während des gesamten Prozesses '''nicht mit 230V verbinden'''. Während des gesamtem Flash-Vorgangs kann die Spannungsvorsorgung aus dem Raspi genutzt werden
* Nachdem Raspbian sich installiert hat, geht man auf die Linux-Konsole. Entweder direkt oder per puTTY über SSH. Auf dem Raspi arbeite ich gerne als User root, deswegen vergebe ich diesem ein Passwort:
<pre>
sudo passwd root
// user root werden
su - root
</pre>
* Raspi OS updaten
<pre>
apt-get update && apt-get upgrade && apt-get dist-upgrade
</pre>
* Software installieren: C-Compiler, arduino-IDE
<pre>
apt-get install arduino gcc-avr
</pre>

* (Optional) Über ''raspi-config -> Internationialisation Options'' Keyboard-Layout, Locale, Timezone anpassen
* Über ''raspi-config -> Advanced Options'' SPI, Serial, I2C ausschalten (falls aktiv)
* reboot
* Verzeichnis für Downloads auf dem Raspi erstellen und dorthin wechseln
<pre>
mkdir /root/hm_switch
mkdir /root/hm_switch/flash
cd /root/hm_switch
</pre>
* Bootloader-Umgebung herunterladen
<pre>
git clone https://github.com/jabdoa2/Asksin_OTA_Bootloader
</pre>
* Firmware herunterladen
<pre>
git clone https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM
</pre>
* Dateien aus [https://seafile.partec.org/d/b6590a5a45/] herunterladen und auf dem Raspi in's erstellte Verzeichnis ''/root/hm_switch'' kopieren. Da ich nicht weiß, wie man per wget Dateien eines Cloud-Servers auf einer Linux-Maschine kopiert, führe ich diesen Vorgang mit WinSCP durch.
** Das Modul 99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm muss in die fhem-Installation (/opt/fehm/FHEM) kopiert werden. Ansonsten wird der Schalter beim '''Anlernen nicht erkannt'''
* Da die Programming-Software aus dem original Repository nicht verwendet werden kann, muss die Version aus dem Dowload installiert werden
<pre>
dpkg -i avrdude_5.10-4_armhf.deb
</pre>
* In der .conf steht die Definition der Anschlüsse für den Raspi. Diese entpacken und nach /etc kopieren
<pre>
gunzip avrdude.conf.gz && cp avrdude.conf /etc/
</pre>
==Arduino-IDE einrichten /Firmware bauen==
* Die IDE wird zum späteren Kompilieren der Firmware benötigt - es ist keine Arduino-Hardware erforderlich!
* Build-Pfad für Arduino-IDE erstellen:
<pre>
mkdir /root/hm_switch/Asksin_HM_LC_Sw1PBU_FM/build && chmod -R 777 /root/hm_switch/Asksin_HM_LC_Sw1PBU_FM/build
</pre>
* In den Ordner ''/usr/share/arduino/hardware'' wechseln und Hardware-Board für den ATMega644 laden
<pre>
cd /usr/share/arduino/hardware
git clone https://github.com/jabdoa2/jabduino
</pre>
* Um alle Pfade und Dateien zu erzeugen, muss die Arduino-IDE aufgerufen und anschließend direkt wieder geschlossen werden. Das kann man in der grafischen Umgebung des Raspis, oder über ein entferntes X-Terminal tun.
* In manchen Adruino-IDE Umgebungen werden Builds gelöscht, bevor sie auf die Hardware gespielt werden. Das muss verhindert werden! Bei Raspbian Jessie und dem User pi befinden sich die Voreinstellungen der IDE in ''/home/pi/.arduino/preferences.txt''. Über die Konsole dort folgende Änderungen machen, bzw. Einträge hinzufügen
<pre>
...
build.path=/home/pi/build
...
export.delete_target_folder=false
...
preproc.save_build_files=true
...
</pre>
* Firmware-Quellen in den Sketchbook-Ordner von User ''pi'' kopieren und Rechte für alle setzen
<pre>
cp -R Asksin_HM_LC_Sw1PBU_FM/ /home/pi/sketchbook/ && chmod -R 777 /home/pi/sketchbook/
</pre>
* Wieder in die grafische IDE wechseln
** ''Tools -> Board ->'' "Jabduino ATmega644A" auswählen
** ''File -> Sketchbook -> '' "Asksin_HM_LC_Sw1PBU_FM" öffnen
** In der Datei Asksin_HM_LC_Sw1PBU_FM den Wert in Zeile 64 eventuell "const unsigned long minImpulsLength = 5000;" ändern. Der dort eingetragene Wert gilt als Schwellwert, wann der Schalter erkennen soll, dass ein angeschlossener Wechselschalter gedrückt wurde und somit erkannt wird, dass Strom fließt.
** In der Datei ''Register.h'' in Zeile 22 den Wert von HMID[3] ändern.
Zusätzlich kann die eigene Zentrale bereits als Default-Wert in den Schalter eingetragen werden. Dadurch entfällt ein unter Umständen notwendiges Peering. Dafür muss die Zeile 347 von //#define firstLoad' in '#define firstLoad' geändert werden In den Zeilen 354 bis 356 die Werte für die FHEM-Zentral-ID einfügen (Reading: D-HMIdOriginal 2CC71D) reg.ch_0.pairCentral[0] = 0x2C; reg.ch_0.pairCentral[1] = 0xC7; reg.ch_0.pairCentral[2] = 0x1D; Auch andere Default-Werte wie Peerings und Schaltverhalten können an dieser Stelle verändert werden. Sollte das nicht gewünscht sein, sind diese Zeilen entweder auszukommentieren oder einfach zu löschen.
** Beispiel (Auszug aus Register.h mit Zeilenangaben)
<pre>
<16>/* Serial ID 10 byte */ 'K','E','Q','0','0','0','0','0','0','7', // serial ID, needed for pairing
<22> const uint8_t HMID[3] = { 0x08, 0x15, 0x07 }; // 081507
</pre>
** Die beiden geänderten Dateien speichern und mit ''Sketch -> Überprüfen / Kompilieren'' kompilieren. Im unteren Fenster auf Fehlermeldungen achten!
** Wenn dies funktioniert hat, sollte im Ordner ''/home/pi/build'' die Datei ''Asksin_HM_LC_Sw1PBU_FM.cpp.hex'' mit aktuellem Datum erzeugt worden sein.

== Bootloader ==
* Datei /root/hm_switch/Asksin_OTA_Bootloader/devices/HM-LC-Sw1PBU-FM.h editieren und dabei Seriennummer, HMID und die Typ setzen. Seriennummer und HMID müssen in eurer Umgebung eindeutig sein, Typ ist: '''0xF0A9'''
<pre>
nano /root/hm_switch/Asksin_OTA_Bootloader/devices/HM-LC-Sw1PBU-FM.h
</pre>
** Beispiel: HMID -> 081507, Seriennummer: KEQ0000007
<pre>
/ The model type (not used from bootloader)
#define HM_TYPE 0xF0, 0xA9
// 10 bytes serial number. Must be unique for each device
#define HM_SERIAL 'K', 'E', 'Q', '0', '0', '0', '0', '0', '0', '7'
// 3 bytes The device address (hm_id)
#define HM_ID 0x08, 0x15, 0x07
</pre>
* Eine Verzeichnisebene höher und Bootloader bauen:
<pre>
cd /root/hm_switch/Asksin_OTA_Bootloader/
make clean HM_LC_Sw1PBU_FM_8k
</pre>
Dabei sollte die Datei ''bootloader_HM-LC-Sw1PBU-FM.hex'' herauskommen. Diese wird später auf den Schalter geflasht

== Flashen ==
* Erzeugte Bootloader-Datei und Firmware in ein Verzeichnis kopieren:
<pre>
cp /home/pi/build/Asksin_HM_LC_Sw1PBU_FM.cpp.hex /root/hm_switch/flash/firmware.hex && cp /root/hm_switch/Asksin_OTA_Bootloader/Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.hex /root/hm_switch/flash/bootloader.hex
cd /root/hm_switch/flash/
</pre>
* Hinweis: In älteren Beschreibungen findet man häufig die Ziel-Plattform m644. Diese Unterscheidet sich praktisch in der Stromaufnahme des Chips, führt beim avrdude aber zu '''Fehlermeldungen''', deshalb auf '''m6444p''' achten
* '''Fuses''' setzen
''avrdude -p m644p -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: reading input file "0xFD"
avrdude: writing lfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of lfuse written
avrdude: verifying lfuse memory against 0xFD:
avrdude: load data lfuse data from input file 0xFD:
avrdude: input file 0xFD contains 1 bytes
avrdude: reading on-chip lfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of lfuse verified
avrdude: reading input file "0xD8"
avrdude: writing hfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of hfuse written
avrdude: verifying hfuse memory against 0xD8:
avrdude: load data hfuse data from input file 0xD8:
avrdude: input file 0xD8 contains 1 bytes
avrdude: reading on-chip hfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of hfuse verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* '''Bootloader''' flashen
''avrdude -p m644p -P gpio -c gpio -U flash:w:bootloader.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "bootloader_HM-LC-Sw1PBU-FM.hex"
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: writing flash (61372 bytes):
Writing | ################################################## | 100% 30.86s
avrdude: 61372 bytes of flash written
avrdude: verifying flash memory against bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: load data flash data from input file bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex contains 61372 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 28.95s
avrdude: verifying ...
avrdude: 61372 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* '''Firmware''' flashen (aus der Arduino-IDE)
''avrdude -p m644p -P gpio -c gpio -U flash:w:firmware.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "Asksin_HM_LC_Sw1PBU_FM.cpp.hex"
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: writing flash (19042 bytes):
Writing | ################################################## | 100% 9.79s
avrdude: 19042 bytes of flash written
avrdude: verifying flash memory against Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: load data flash data from input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex contains 19042 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 9.28s
avrdude: verifying ...
avrdude: 19042 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]
[[Kategorie:Schalter (Empfänger)]]

HM-LC-Sw1PBU-FM Alternative Firmware

2016-11-09T10:18:05Z

Klinki:

{{Randnotiz|RNTyp=r|RNText=Bei den hier gezeigten Modifikationen geht die Garantie verloren und das Gerät verliert seine Zertifizierungen!}}
Um die alternative Firmware auf den [[HM-LC-Sw1PBU-FM Unterputz-Schaltaktor 1-fach‎|HM-LC-Sw1PBU-FM]] flashen zu können, muss das Gerät geöffnet und ein Programmer angelötet werden.

== Neue Funktionen ==
* Der Taster kann mit anderen Geräten [[Homematic Peering Beispiele|gepeert]] werden. Das ist mit der Originalfirmware nicht möglich.
* Die alternative Firmware hat eine Stromerkennung, die hardwaretechnisch immer vorhanden ist, aber von der eQ-3 Firmware nicht benutzt wird. Es ist möglich, damit eine Wechselschaltung zu implementieren.

Folgende Kanäle sind jetzt verfügbar
{| class="wikitable"
! Kanal
! Bezeichnung
|-
| Button_1
| Taster oben
|-
| Button_2
| Taster unten
|-
| Switch_1
| der Switch_01 (Kanal 3 des Aktors) ist der virtuellen Kanal. Wenn man den einschaltet, brennt das Licht, er berücksichtigt also einen ggf. schon bestehenden Stromfluss. Wenn man den Ausschaltet, geht das Licht aus, wenn es nicht schon aus war. Er zeigt weiterhin an, ob das Licht gerade an oder aus ist.
|-
| Switch_2
| der Switch_02 ist das Relais und funktioniert so , wie die HM-eigene Firmware vorher auch funktioniert hat. Relais an/aus. Den braucht man also "eigentlich nicht".
|}
== Hinweis zum Einbau ==
Bei Einsatz in einer Wechselschaltung (oder Kreuz- und Wechselschaltung) ist der HM Schaltaktor immer auf der Seite der Verkabelung einzubauen, wo die ungeschaltete Phase zugeführt wird. Bei Einbau auf der Seite, die zur Lampe abgeht, funktioniert es nicht, da in diesem Fall im ausgeschalteten Zustand der HM-Switch stromlos ist. Es ist also nicht gleichgültig, an welchem Ende einer (Kreuz- und) Wechselschalter-Kette der HM-Switch eingebaut werden muss.

== Integration des Schalters in FHEM ==
===Vorbereitungen===
Für die alternative Firmware existiert ein eigenes Modul. Dieses ist als Erstes zu installieren bzw nach ./FHEM zu kopieren:
:[https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM/blob/master/fhem/99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm 99_Asksin_HM_LC_Sw1PBU_FM_CustomFW.pm]

=== Anlernen ===
In FHEM ist der HomeMatic-[[CUL]] in den Anlernmodus zu bringen. Der ConfigButton des Schalters ist nun länger als vier Sekunden zu drücken. Wichtig: die LED darf nach Loslassen des Button nicht aufblinken; sie gibt keine Rückmeldung über den Status des Anlernvorgangs.

Nach dem Anlernen sollte nochmal die aktuelle Config ausgelesen werden. Das kann ein paar Sekunden dauern und ist abgeschlossen, sobald der "state" = "cmds done" ist.
set <HM-LC-SW1PBU-FM_Device> getConfig

Möchte man erneut pairen, so geht dies am einfachsten mit:
set <HM-LC-SW1PBU-FM_Device> regSet pairCentral <123456>

Um den Schalter wie einen "normalen" Schalter wirken zu lassen, müssen noch die Buttons mit dem Switch [[Peering (HomeMatic)|gepeert]] werden. Danach bewirkt ein Tastendruck nach oben ein Einschalten, und ein Druck nach unten ein Ausschalten. Unterlässt man diesen Schritt, passiert bei einem Tastendruck am angeschlossenen Verbraucher nichts.
set <HM-LC-SW1PBU-FM_Btn_01 peerChan 0 <HM-LC-SW1PBU-FM_Sw_01 dual set

Das erzeugt automatisch ein Peering zwischen deinen beiden internen Tastern und dem Kanal 3 (Sw_01). Damit sollte der Schalter eigentlich schon funktionieren

Falls nicht, dann setzt man im Device das Register intKeyVisib auf "visib" und macht ein getConfig auf Kanal 3. Dort sieht man dann die Listen der Peers und erkennt, was dort ein Tastendruck bewirkt. In den Jump Targets (z.B . R-self01-shSwJtDlyOff) usw. muss dann bei dem Button, mit dem man '''AUS'''schalten will überall OFF stehen, und bei dem anderen Button entsprechend On.

Noch einfacher wäre es, falls vorhanden, ein Registerset von einem schon wie gewünscht konfigurierten Schalter (das kann auch einer mit Standard-FW sein) zu kopieren. Das geht mit dem Modul hminfo.

=== Reset ===
Um den Schalter zu resetten ist der ConfigButton 2x hintereinander für > 4sek zu drücken. Auch hier liefert die LED keinerlei Rückmeldung über den Status. Blinks die LED trotzdem auf, so wurde das Drücken des Buttons nicht als "lang" erkannt.
Alternativ kann ein Reset über FHEM ausgelöst werden:
set <HM-LC-SW1PBU-FM_Device> reset

=== Advanced settings ===
Interne Peers
Ein Kanal kann interne Peers haben. Beispiele sind die meisten Schalter oder Dimmer an welchen direkt ein mechanischer Schalter angeschlossen werden kann, oder ein Bedienschalter direkt eingebaut ist. Die Firmware (FW) des Kanals behandelt diesen wie einen externen Peer, nur ist er automatisch eingerichtet. Es stehen die identischen Register wie bei 'normalen' Peers zu Verfügung. Diese Peers sind nicht automatisch sichtbar, können aber sichtbar geschaltet werden. Hierzu ist das
Register '''intKeyVisib''' auf ''visib'' zu setzen (siehe HM-Konfiguration)-siehe auch getConfig. Danach kann man das Verhalten der „eingebauten Peers“ auslesen und verändern wie von jedem anderen Peer auch. Die internen Peers werden '''selfxx''' benannt (self01, self02,...).

set <HM-LC-SW1PBU-FM_Sw_01> intKeyVisib visib
set <HM-LC-SW1PBU-FM_SW_01> getConfig

Beispiel: Schaut man in die Readings des Devices und sieht ein: '''R-self01-shActionType off''' bedeutet dies, dass der Button 1 (der nach "oben") deaktiviert ist für diesen Peer und somit keine Funktion hat. Dieser ist auf "jmpToTarget" zu setzen und dann noch die folgenden auf "on":

* R-self01-shSwJtDlyOff
* R-self01-shSwJtDlyOn
* R-self01-shSwJtOff
* R-self01-shSwJtOn

Für Button 2 das selbe, aber eben nicht "on" sondern off.
Natürlich kann man es auch anders nutzen. Z.b. einen Button als Toggle und den anderen Button für etwas völlig anderes. Das ist ja das schöne, dass dies bei der CustomFW möglich ist.

Beispiel das ein kurzer Tastendruck - oben oder unten - ein Toggle bewirkt:
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shActionType jmpToTarget self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOn dlyOff self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOff dlyOn self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOn on self01;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOff off self01;

set <HM_LC_Sw1PBU_FM_Sw_01> regSet shActionType jmpToTarget self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOn dlyOff self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtOff dlyOn self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOn on self02;
set <HM_LC_Sw1PBU_FM_Sw_01> regSet shSwJtDlyOff off self02;

== Vorgehen zum Flashen ==
=== Anpassung des Strom-Schwellwertes bei LowCurrent Verbrauchern ===
Werden am Schalter nur sehr schwache Verbraucher angeschlossen, so kann u.U. die Statuserkennung (Verbraucher an/aus) nicht korrekt funktionieren. Ändern kann man das in Asksin_HM_LC_Sw1PBU_FM.ino, und zwar hier:
const unsigned long minImpulsLength = 5000;
Dabei entsprechen anscheinend die 5000 dem Schwellwert 500, die kann man jetzt z.B. auf 500 setzen, also Schwellwert 50.

Man muss ein wenig aufpassen, das nicht zu niedrig zu setzen, damit es zu keinen Fehlerkennungen bei Spannungsspitzen im Hausnetz kommt... Beim Autor ist im ausgeschalteten Zustand der Lampe der Wert aber deutlich unter 50...

=== Vorbereitung der Platine des Schalters ===
An der fertigen Platine sind an den folgenden Kontakten Kabel zum Anschluss an das Programmiergerät anzulöten. 
Wenn man den HM-LC-SW1PBU-FM vor sich liegen hat, liegen die Pins in folgender Reihenfolge:
:Reihe 1: MP3 / MP5 / MP6
:Reihe 2: MP15 / MP4 / MP2

=== Anschluss der einzelnen PINs bei Verwendung der GPIO-Ports des Raspberry PI ===
[[Raspberry Pi|Raspberry]] PIN | Beschreibung | HM-LC-Sw1PBU-FM
--------------|--------------|----------------
Pin #17 | 3,3V | MP2
Pin #19 | MOSI | MP4
Pin #21 | MISO | MP5
Pin #23 | SCLK | MP6
Pin #24 | Reset | MP3
Pin #25 | GND | MP15

=== Anschluss der einzelnen PIns bei Nutzung eines ISP-Programmers ===
Bei Nutzung eines "MySmartUSB light" ist dieser vorher mittels mitgeliefertem Windowsprogramm auf 3V zu umzustellen.
ISP-6 PIN | Beschreibung | HM-LC-Sw1PBU-FM
-------------|--------------|----------------
Pin #2 | 3,3V | MP2
Pin #4 | MOSI | MP4
Pin #1 | MISO | MP5
Pin #3 | SCLK | MP6
Pin #5 | Reset | MP3
Pin #6 | GND | MP15

Wichtig beim [[Raspberry Pi]] ist, dass man nicht die von Raspbian ausgelieferte Version des 'avrdude' nutzen kann, sondern eine adaptierte Version verwendet werden muss.
Alle notwendigen Dateien zum Flashen (bereits alles fertig und lauffähig) inkl. einem kleinen HowTo sind im unten stehenden Link 'Flashen mit RaspberryPi' vorhanden.

=== Vorwort zum flashen per avrdude ===
Alle folgenden avrdude befehle beziehen sich in der Reihenfolge auf folgende Programmer. Es ist für den jeweiligen Programmer nur der betreffende Befehle abzusetzen
* Raspberry Pi
* MySmartUSB light (MyAVR)

Die aktuelle Konfiguration der Fuses kann jederzeit ausgelesen werden mit folgendem Befehl:
avrdude -p m644 -P gpio -c gpio -v
avrdude -p m644 -c stk500v2 -P /dev/ttyUSB0 -v

=== Bootloader bauen ===
1) Dirks bootloader-umgebung clonen/downloaden https://github.com/kc-GitHub/Asksin_OTA_Bootloader 
 
2) devicedaten des Schalters (Serial, HMID) in devices/HM-LC-Sw1PBU-FM.h mit den Originaldaten ersetzen und typ=0xF0A9 setzen (modelnummer des schalters mit alternativer firmware). Damit sind die Daten im flash verewigt und man braucht sich eigentlich nicht mehr darum zu kümmern. Bei einem nächsten Bootloader update kann man ein beliebiges bootloader.eq3 file ota flashen. Trotzdem behält der Bootloader seine daten. 
 
3) Bootloader bauen: 
make clean HM_LC_Sw1PBU_FM_8k

=== Bootloader flashen ===
Anschließend muss man nun die Fuses korrekt mit unlock(wichtig) setzen:

avrdude -p m644 -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m
avrdude -p m644 -c stk500v2 -P /dev/ttyUSB0 -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m -U lock:w:0x3F:m

und final den Bootloader flashen
avrdude -p m644 -P gpio -c gpio -U flash:w:bootloader_HM-LC-Sw1PBU-FM_8k.hex
avrdude -p m644 -c stk500v2 -P /dev/ttyUSB0 -U flash:w:bootloader_HM-LC-Sw1PBU-FM_8k.hex

=== Firmware bauen ===
==== 1. Firmware mit arduino-IDE ====
''Hinweis:'' Die folgenden Schritte wurden auf einem Raspberry Pi 2 mit Debian Jessie durchgeführt und folgen größtenteils der howtoBuild.txt von Mr.P aus [https://owncloud.isengard.at/index.php/s/8992affb68e8c1dcbe532152628ad9a5]
* In manchen Adruino-IDE Umgebungen werden Builds gelöscht, bevor sie auf die Hardware gespielt werden. Das muss verhindert werden! Bei Raspbian Jessie und dem User pi befinden sich die Voreinstellungen der IDE in /home/pi/.arduino/preferences.txt. Dort folgende Änderungen machen, bzw. Einträge hinzufügen
<pre>
...
build.path=/home/pi/build
...
export.delete_target_folder=false
...
preproc.save_build_files=true
...
</pre>
* Auf den raspi in den Ordner ''/usr/share/arduino/hardware'' wechseln. Hardware-Board für den ATMega644 laden
<pre>
git clone https://github.com/jabdoa2/jabduino
</pre>
* Arduino im grafischen Frontend (oder X-Terminal) starten. unter <File>/<Preferences> findet man den Sketchbook-Ordner
* Über die Konsole in den Sketchbook-Ordner wechseln. Für User "pi" idR ''/home/pi/sketchbook''
* Dort die Firmware-Quellen einfügen
<pre>
git clone https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM.git
</pre>
* Wieder in die Arduino-Umgebung wechseln, unter <File>/<Sketchbook>/<Asksin_HM_LC_Sw1PBU_FM> öffnen
* unter <Tools>/<Board> "Jabduino ATmega644A" auswählen
* In der Datei ''Asksin_HM_LC_Sw1PBU_FM'' den Wert in Zeile 64 eventuell "const unsigned long minImpulsLength = 5000;" ändern. Der dort eingetragene Wert gilt als Schwellwert, wann der Schalter erkennen soll, dass ein angeschlossener Wechselschalter gedrückt wurde und somit erkannt wird, dass Strom fließt.
* in der Datei ''Register.h'' in Zeile 22 den Wert von HMID[3] ändern. Z.B.: "const uint8_t HMID[3] = { 0x20, 0x85, 0x57 }; // 208557"
Zusätzlich kann die eigene Zentrale bereits als Default-Wert in den Schalter eingetragen werden. Dadurch entfällt ein unter Umständen notwendiges Peering. Dafür muss die Zeile 347 von '//#define firstLoad' in '#define firstLoad' geändert werden
In den Zeilen 354 bis 356 die Werte für die FHEM-Zentral-ID einfügen (Reading: D-HMIdOriginal 2CC71D)
reg.ch_0.pairCentral[0] = 0x2C;
reg.ch_0.pairCentral[1] = 0xC7;
reg.ch_0.pairCentral[2] = 0x1D;
Auch andere Default-Werte wie Peerings und Schaltverhalten können an dieser Stelle verändert werden. Sollte das nicht gewünscht sein, sind diese Zeilen entweder auszukommentieren oder einfach zu löschen.
* Alle Dateien speichern
* <Sketch>/<Verifiy/Compile> alles kompilieren
* Im oben definierten Build-Path (/home/pi/build) sollte jetzt eine Datei ''Asksin_HM_LC_Sw1PBU_FM.cpp.hex'' stehen. Das ist unsere fertige Firmware, die auf den Schalter geflasht werden muss

=== Firmware über Raspberry Pi flashen ===
* Hinweis: In älteren Beschreibungen findet man häufig die Ziel-Plattform m644. Diese unterscheidet sich praktisch in der Stromaufnahme des Chips, führt beim avrdude aber zu '''Fehlermeldungen''', deshalb auf '''m6444p''' achten
* 1. '''Fuses''' setzen
''avrdude -p m644p -P gpio -c gpio -U lfuse:w:0xFD:m -U hfuse:w:0xD8:m''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: reading input file "0xFD"
avrdude: writing lfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of lfuse written
avrdude: verifying lfuse memory against 0xFD:
avrdude: load data lfuse data from input file 0xFD:
avrdude: input file 0xFD contains 1 bytes
avrdude: reading on-chip lfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of lfuse verified
avrdude: reading input file "0xD8"
avrdude: writing hfuse (1 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 1 bytes of hfuse written
avrdude: verifying hfuse memory against 0xD8:
avrdude: load data hfuse data from input file 0xD8:
avrdude: input file 0xD8 contains 1 bytes
avrdude: reading on-chip hfuse data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 1 bytes of hfuse verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* 2. '''Bootloader''' flashen (falls noch nicht geschehen, wie [[HM-LC-Sw1PBU-FM_Alternative_Firmware#Bootloader_flashen|oben]] beschrieben)
''avrdude -p m644p -P gpio -c gpio -U flash:w:bootloader_HM-LC-Sw1PBU-FM.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "bootloader_HM-LC-Sw1PBU-FM.hex"
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: writing flash (61372 bytes):
Writing | ################################################## | 100% 30.86s
avrdude: 61372 bytes of flash written
avrdude: verifying flash memory against bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: load data flash data from input file bootloader_HM-LC-Sw1PBU-FM.hex:
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex auto detected as Intel Hex
avrdude: input file bootloader_HM-LC-Sw1PBU-FM.hex contains 61372 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 28.95s
avrdude: verifying ...
avrdude: 61372 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>
* 3. '''Firmware''' flashen (aus der Arduino-IDE)
''avrdude -p m644p -P gpio -c gpio -U flash:w:Asksin_HM_LC_Sw1PBU_FM.cpp.hex''
<pre>
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.00s
avrdude: Device signature = 0x1e960a
avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
To disable this feature, specify the -D option.
avrdude: erasing chip
avrdude: reading input file "Asksin_HM_LC_Sw1PBU_FM.cpp.hex"
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: writing flash (19042 bytes):
Writing | ################################################## | 100% 9.79s
avrdude: 19042 bytes of flash written
avrdude: verifying flash memory against Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: load data flash data from input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex:
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex auto detected as Intel Hex
avrdude: input file Asksin_HM_LC_Sw1PBU_FM.cpp.hex contains 19042 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 9.28s
avrdude: verifying ...
avrdude: 19042 bytes of flash verified
avrdude: safemode: Fuses OK
avrdude done. Thank you.
</pre>

Oder man flasht die Firmware, wie im folgenden Abschnitt beschrieben, OTA (over the air). Das funktioniert mit dem Bootloader natürlich nicht. Dieser kann nur über einen Programmer oder Raspberry Pi auf den Schalter geflasht werden.
Der Vorteil bei OTA ist, dass für ein Update der Firmware der Schalter nicht mehr ausgebaut werden müsste.

=== Firmware OTA flashen ===
====1. Konvertieren in das eq3 Format====
Konvertieren der Hex-Datei in das eq3 format mittels [https://github.com/kc-GitHub/Wettersensor/blob/master/Contrib/hex2eq3.php hex2eq3.php] (die php-cli muss installiert sein)

php hex2eq3.php --inFile Asksin_HM_LC_Sw1PBU_FM.cpp.hex --outFile HM_LC_Sw1PBU_FM.eq3 --spmPageSize 256 --hexEndAddress 0xDFFE --outFormat eq3 --withCrcCheck --pathTo-srec_cat /usr/bin/srec_cat

====2. Flashvorgang starten====
Im flash-ota Tool eq3 das Device, die File- und Seriennummer eingeben 
Solltet ihr mittels CUL, COC oder HM-CFG-USB-2 direkt auf eurem Raspberry flashen, könnt ihr das bereitgestellte [https://owncloud.isengard.at/public.php?service=files&t=8992affb68e8c1dcbe532152628ad9a5&path=%2F&files=flash-ota&download flash-ota Binary] verwenden. Ansonsten einfach [https://git.zerfleddert.de/cgi-bin/gitweb.cgi/hmcfgusb herunterladen] und für euer System selbst kompilieren:

Wenn ihr einen HM-CFG-USB-2 verwendet, wird flash-ota mittels:
flash-ota -f firmware_HM-LC-Sw1PBU-FM.eq3 -s <SerialNr>
gestartet. Bei Verwendung eines CUL oder COC, muss das Device mit angegeben werden:
flash-ota -f firmware_HM-LC-Sw1PBU-FM.eq3 -s <SerialNr> -c /dev/ttyAMA0 # für den COC
flash-ota -f firmware_HM-LC-Sw1PBU-FM.eq3 -s <SerialNr> -c /dev/ttyACM0 # für den CUL

====3. Bootloader aktivieren====
Zum Abschluss muss der Bootloader im Device/Schalter aktiviert werden. Dazu ist das Device zu resetten: 
* Netzversorgung vom schalter ausschalten, config taster drücken und halten, spannung einschalten und weiterhin gedrückt halten bis erstes blinken erscheint. 
oder falls das Device bereits in FHEM angelegt und gepaired ist: 
* Device in fhem ein "set <device> reset" absetzen, danach innerhalb von 10sek die ConfigTaste für ???-sek drücken
* Dies funktioniert mit der Firmware ohne Änderungen definitiv nicht. Es löst ausschließlich einen Werksreset im Schalter aus
Um den Bootloader am Schalter selbst zu aktivieren, ohne den Schalter stromlos zu machen, muss die Firmware, hier '''Asksin_HM_LC_Sw1PBU_FM.ino''' und '''register.h''', gemäß {{Link2Forum|Topic=18071|Message=275891|LinkText=Forum}} ('''Danke''' Frank!) angepasst werden.

Nach diesen Änderungen hat der Schalter unter anderem ein Bootmenü mit 3 Menüoptionen:
* Option 1: Manueller Reboot '''-> diese ist zu wählen'''
* Option 2: enable software reboot (fhem kann durch set fwupdate das Booten einleiten, weiterführende Lektüre {{Link2Forum|Topic=23329|LinkText=hier}}.
* Option 3: disable software reboot (das automatische Booten wird verhindert, default)
Man gelangt in das Menü, indem man das lange Drücken des Config-Tasters über die ersten 3 Sekunden verlängert. Alle 3 Sekunden erfolgt ein Umschalten in die nächste Bootmenüoption.

Die augenblickliche Option wird durch Blinken angezeigt:
* Option 1 1x blinken
* Option 2 2x blinken
* Option 3 3x blinken
Nach der 3. Option gelangt man wieder zur 1. Option, usw ... 
Wird der Config-Taster nach dem jeweiligen Blinken losgelassen, wird die entsprechende Menüoption ausgeführt.

Jetzt sollte man beim Flashtool etwas sehen. Während des flashens blinkt auch die LED auf dem Schalter analog den übertragenen Datenblöcken

===Bootloader OTA flashen===
Soll später ein neuer Bootloader mit neuen Features installiert werden, so kann dieser ebenfalls OTA geflashed werden ohne Schalter ausbauen und Löten.

Der Bootloader ist zu bauen wie im Abschnitt zuvor erklärt. Anschließend mit dem hex2eq3 Tool konvertiert:
php contrib\hex2eq3.php --inFile Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.hex --outFile Bootloader-AskSin-OTA-HM_LC_Sw1PBU_FM_8k.eq3 --spmPageSize 256 --hexEndAddress 0xDFFE --outFormat eq3 --markAsBootloaderUpdate --withCrcCheck --pathTo-srec_cat /usr/bin/srec_cat
Der anschließende OTA Flashvorgang erfolgt analog dem Firmware-OTA-Flash wie weiter oben beschrieben

=== UART nutzen ===
Für Debuggingausgaben für Entwickler: Statt /dev/ttyXXX das eigene Interface einfügen:
* /dev/ttyUSB0 (USB Interface)
* /dev/ttyAMA0 (Raspberry PI)
* /dev/ttyS0 (normaler Serieller Port)

Öffnen
* Direkt in der Arduino IDE (Tools -> Serial Monitor)
* Mit ''screen''
screen /dev/ttyXXX 57600,CS8,ixon,ixoff
* Mit ''minicom''
sudo apt-get install minicom
minicom -b 57600 -o -D /dev/ttyXXX -w

== Links ==
* Firmware: [https://github.com/jabdoa2/Asksin_HM_LC_Sw1PBU_FM]
* Bootloader: [https://github.com/jabdoa2/Asksin_OTA_Bootloader]
* Arduino Port für Atmega 644: [https://github.com/jabdoa2/jabduino]
* Firmware bauen und flashen mit dem RaspberryPi: [https://owncloud.isengard.at/public.php?service=files&t=8992affb68e8c1dcbe532152628ad9a5]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]
[[Kategorie:Schalter (Empfänger)]]

Einrichten knxd mit MDT SCN-IP000.02

2016-04-12T09:30:39Z

Klinki: Die Seite wurde neu angelegt: „= Vorwort = Im Rahmen einer Machbarkeitsstudie ging es um das Thema Zählererfassung im betrieblichen Umfeld. Dazu sollten diverse Techniken und Bus-Systeme m…“

= Vorwort =
Im Rahmen einer Machbarkeitsstudie ging es um das Thema Zählererfassung im betrieblichen Umfeld. Dazu sollten diverse Techniken und Bus-Systeme mit einbezogen werden.
Als eine Art (halb privates) Nebenprojekt kam auch die Verknüpfung zwischen fhem und einem KNX-Zählerbaustein zum Einsatz.
Es gibt hier im Wiki zwar schon die Beschreibung [[Einrichten_von_eibd_für_das_Weinzierl_IP_730_Interface]], aber diese beschäftigt sich mit anderer Hardware und dem eib-daemon.

= Voraussetzungen =
==Hardware==
** MDT IP-Interface SCN-IP000.02. Wird später als IP-Tunneling-Device verwendet. Adresse wird über DHCP bezogen. '''Sollte geändert werden'''
** MDT 4fach Binäreingang BE-04000.01. Dient als Zählermodul
** MDT Spannungsversorgung STV-0160.01. Achtung! Es kann keine Standard 24V Spannungsversorgung verwendet werden, da diese nicht die für KNX benötigte Drossel enthält
==Software==
** fhem 5.7 Installation auf Raspberry Pi 3, gemäß Anleitung (folgt!), '''Raspian Jessie'''
** ETS 5.0 wird für die Konfiguration der KNX-Komponenten benötigt. Kostenfreie Demo-Lizenz. Beschränkt auf 5 Geräte. Download von [https://knx.org/knx-de/software/ets/herunterladen/index.php KNX.org]
** Katalog-Datei für die ETS vom Binär-Eingang. Quelle: [http://www.mdt.de/Downloads_Produktdatenbanken.html MDT-Homepage]

=Installation=
* KNX-Daemon für Linux. Als Leitfaden diente [http://www.fhemwiki.de/wiki/Knxd Fhem-Wiki]
** Zusätzliche Pakete installieren (als root oder sudo benutzen)
<pre>
apt-get install debhelper cdbs automake libtool libusb-1.0-0-dev git-core build-essential libsystemd-daemon-dev dh-systemd
</pre>
** lib pthsem herunterladen und installieren
<pre>
wget https://www.auto.tuwien.ac.at/~mkoegler/pth/pthsem_2.0.8.tar.gz
tar xzf pthsem_2.0.8.tar.gz
cd pthsem-2.0.8
dpkg-buildpackage -b -uc
cd ..
sudo dpkg -i libpthsem*.deb
</pre>
** KNXD herunterladen und installieren
<pre>
git clone https://github.com/knxd/knxd.git
cd knxd
dpkg-buildpackage -b -uc
cd ..
sudo dpkg -i knxd_*.deb knxd-tools_*.deb
</pre>
** ''/etc/knxd.conf'' anlegen. Relevant ist nur die letzte Zeile. Die originale Datei enthält eine für das System nicht funktionierende Konfiguration. Daher wird der gesamte Inhalt der Datei hier dokumentiert.
<pre>
# configuration for knxd.service
#KNXD_OPTS="-u /tmp/eib -b ip:"

# The default options are "-u /tmp/eib -b ip:"
# which tell knxd to route between all of
# /tmp/eib (legacy socket (-u))
# multicast client (-b ip:).
# The knxd.socket file also tells knxd to listen to
# /run/eib (socket activation via systemd)
# TCP port 6720 (socket activation via systemd)

# *** DO NOT use "-u" / "-u /run/knx" or "-i" / "-i 6720" here.
# Systemd already does that on behalf of knxd, via 'knx.socket'.

# If you have KNX hardware on a serial port or USB, add the appropriate
# "-b TYPE:…" option. In this case, you probably want to set up a multicast
# server, not a client (i.e. use "-D -T -R -S", not "-b ip:").
# DO NOT use both.
#
# If your KNX hardware is a KNX/IP gateway that doesn't do multicast,
# use "-b ipt:192.168.1.2" (or its DNS name) to talk to it.
#
# KNX MUST NOT have more than one path between any two devices. Thus,
# you need to make sure that the KNX/IP gateway does not route multicast
# before you use both "-S" and "-b ipt:".

# The default bus address of knxd is 0.0.1. If that's in use in your KNX
# network (or if you run more than one knxd on your network), set a
# different address (-e 15.0.99).

# Run `knxd --help` to get a complete list of available options and drivers.

## DO NOT use the following options:
## -i -- /lib/systemd/system/knxd.socket does this for us
## -u /run/knx -- likewise
## -d -- /lib/systemd/system/knxd.service expects knxd to run in the foreground

###############################################################################
# This file is ignored when NOT using systemd: edit /etc/default/knxd instead #
###############################################################################
KNXD_OPTS="-e 1.0.240 -b ipt:192.168.0.88"
</pre>

Die ''192.168.0.88'' ist exemplarisch für die IP-Adresse eures KNX-Gateways.

** Der Daemon sollte auch einem Jessie-System mit dem System starten.
Der Status des KNX-Dienstes kann mit ''systemctl status knxd.service'' geprüft werden. Die Ausgabe sollte so ähnlich aussehen:
<pre>
root@rasspi-fhem99:~# systemctl status knxd.service
● knxd.service - KNX Daemon
Loaded: loaded (/lib/systemd/system/knxd.service; enabled)
Active: active (running) since Mo 2016-04-11 13:35:53 CEST; 14s ago
Main PID: 1258 (knxd)
CGroup: /system.slice/knxd.service
└─1258 /usr/bin/knxd -e 1.0.240 -b ipt:192.168.0.88
</pre>
Wichtig ist, dass die IP-Adresse des Gateways und die eib-Adresse (1.0.240) in der letzten Zeile stehen.

Der Dienst kann auch manuell gestartet und gestoppt werden:
Start:
<pre>
systemctl start knxd.service
</pre>
Beenden:
<pre>
systemctl stop knxd.service
systemctl stop knxd.socket
</pre>
Achtung! wird der Dienst beendet während fhem in benutzt, '''hängt sich fhem auf''' und muss neu gestartet werden.

* Definition des IP-Gateways in fhem:
<pre>
define KNX TUL eibd:192.168.0.1 1.0.240
</pre>
''192.168.0.1'' Adresse des KNX-Daemons, i.d.R. localhost

''1.0.240'' EIB-Adresse für FHEM/KNXD

Nach dem fhem-Neustart sollte das neue Device "KNX" den Status "Initialized" haben.

= Installation/Konfiguration ETS=
Die ETS wird benötigt um KNX-Sensoren/Aktoren zu parametrieren und ihnen EIB-konforme Adressen zuzuweisen.
Ich empfehle an dieser Stelle das Dokument "Grundlagenwissen zum KNX Standard", welches von [https://www.google.de/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&ved=0ahUKEwi9w-O74ojMAhVBfxoKHeXKByAQFggkMAA&url=http%3A%2F%2Fwww.knx.org%2Ffileadmin%2Fdownloads%2F08%2520-%2520KNX%2520Flyers%2FGrundlagenwissen%2520zum%2520KNX%2520Standard%2FGrundlagenwissen_zum_KNX_Standard_German.pdf&usg=AFQjCNETdgrIp23RbSTx-E8Q0qFuNH1hBw&cad=rja KNX.org] heruntergeladen werden kann.

==Einrichtung des Binäreingangs BE-04000-01 in ETS==
* Bevor der Binär-Eingang benutzt werden kann, muss dieser in ETS konfiguriert werden.
Dazu wird in ETS zunächst ein Projekt angelegt. Als "Linientyp" wird TP (Twisted Pair) definiert.
Das IP-Gateway wird von der ETS selbstständig gefunden.
* Bevor das Gerät selbst in ETS angezeigt werden kann, muss eine Struktur für das Gerät erzeugt werden:
[[Datei:Ets struktur.png]]

1 Gebäudestruktur: Haus -> Keller -> Unterverteilung

2 Adressstruktur: "1 Haupt" -> "1/1 Mittel" -> "1/1/1 Schalter" 1.1.1 ist demnach die spätere Adresse für Schalteingang A des 4fach Geräts

3 Katalog-Import: Hier wird der Katalog für das Gerät importiert. Dieser wird dann per DragNDrop auf die erstellte Struktur "Unterverteilung" gezogen

* Jetzt kann das Gerät "Binäreingang 4-fach..." parametriert werden. Dazu im mittleren Fenster den Reiter "Parameter" wählen
[[Datei:Geraet parametrieren.png]]

Hier kann jetzt für jeden Eingang des Bausteins die entsprechende Funktion eingestellt werden, z.B. Schalter, Zähler, usw.
* Aus dem unteren Fenster werden nun per Drag N Drop die erstellten Gruppenadressen auf die jeweiligen Eingänge des Geräts gezogen. Damit wird auch die EIB-Adresse für jeden Eingang festgelegt.
* Jetzt muss das Gerät noch programmiert werden. Dazu Programmieren -> Physikalische Adresse und Applikationsprogramm

== Installation/Konfiguration fhem==
* In fhem sollten jetzt die neu erzeugten EIB-Geräte angezeigt werden. Voraussetzung ist ein aktiviertes AutoCreate in ''fhem.cfg''
<pre>
define autocreate autocreate
</pre>
*[[Datei:Fhem eib.png]]

* Der Schalteingang wird als Glühbirne dargestellt
* Beim Zählereingang steht nur der Zählerstand als HEX-Zahl. In der ETS lässt sich für den Zähleingang festlegen, wie oft er Counter-Werte übertragen soll, z.B. alle 30 Impulse sollen übermittelt werden

[[Kategorie: Examples]]
[[Kategorie:EIB/KNX]]

Datei:Fhem eib.png

2016-04-12T09:24:53Z

Klinki: EIB-Devices in fhem

EIB-Devices in fhem

Datei:Geraet parametrieren.png

2016-04-12T09:24:12Z

Klinki: Gerät in ETS parametrieren

Gerät in ETS parametrieren

Datei:Ets struktur.png

2016-04-12T09:21:48Z

Klinki: Überblick über die Struktur der ETS-Software

Überblick über die Struktur der ETS-Software