FHEMWiki - Benutzerbeiträge [de]

HM-ES-TX-WM Zählersensor für Strom- und Gaszähler

2017-01-02T14:48:42Z

Snowyrain: /* Konfiguration */

{{Infobox Hardware
|Bild=HM-EM-TX-WM.jpg
|Bildbeschreibung=HomeMatic Zählersensor
|HWProtocol=HomeMatic
|HWType=Powersensor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=6 V
|HWPowerConsumption=30 mA
|HWPoweredBy=4 Batterien LR6/AA/Mignon
|HWSize=68x105x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der Zählersensor ist ein Datenerfassungssystem, das den Energieverbräuche (Strom, Gas) direkt am Zähler erfasst und in FHEM als laufender Saldo und als Momentanwerte verfügbar macht.

'''Technische Daten:'''

Gewicht: 195 g (inkl. 4 LR6/Mignon/AA-Batterien)

== Anwendungsszenarien ==
Mit den erfassten und gesammelten Daten lassen sich Aktionen beim Erreichen bestimmter Schwellwerte auslösen, Verbrauchs- und Kostenstatistiken erstellen sowie beliebige weitere Abhängigkeiten bilden. Durch die Funkdatenübertragung sowie den Batteriebetrieb (1 bis 2 Jahre Betriebsdauer verspricht der Hersteller mit einem Satz) ist die Installation denkbar einfach und erfordert lediglich beim Anbringen der Leseeinheit Genauigkeit.

Im Februar 2015 hat die Auslieferung der Geräte als (einfacher) Bausatz begonnen, zu dem es
* einen Ferraris-Sensor (für Stromzähler mit den markanten Laufscheiben),
* LED-Sensor (für neue Zähler mit S0-Schnittstelle) sowie
* BK-G4-Gaszähler von Elster-Kromschröder (die an einer Ziffernrolle einen kleinen Magneten haben, der über einen Sensor mit Reedkontakt erfasst wird)
gibt. Es ist laut Hersteller [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html ELV] nur der Bausatz verfügbar. Ein Fertiggerät ist aktuell nicht geplant.

Die Zähler werden mit rückstandslos entfernbaren Klebepads angebracht.

== Parameter ==
'''list: register | range | peer | description'''
0: pairCentral | 0 to 16777215 | | pairing to central
1: mtrConstGas | 0 to 655.36 | | constant gas
1: mtrConstIr | 0 to 65536 | | constant IR
1: mtrConstLed | 0 to 65536 | | constant led
1: mtrSensIr | -99 to 99 | | sensiblity IR
1: mtrType | literal | | type of measurement options:LED,gas,unknown,IR

== Probleme ==
Der HM-ES-TX-WM sendet zyklisch im 3-Minuten Takt die aktuellen Verbrauchsdaten. Dabei ist für das Reading "power" (aktuelle Stromleistung in Watt) zu beachten, dass alle drei Minuten der ''zuletzt bekannte Wert'' gesendet wird. Das heißt im Besonderen:

* Sollten innerhalb der drei Minuten mehrfach Impulse auftreten mit unterschiedlichen Leistungswerten, wird nur der zuletzt bekannte Wert genommen. Es findet keine Aggregation der Impulse (Mittelwert, Summe, …) statt.
* Sollten innerhalb der drei Minuten keinerlei Impulse auftreten, wird dennoch der zuletzt bekannte Leistungswert gesendet, auch wenn er mehrere Minuten/Stunden/Tage alt ist.

Der state des Devices zeigt den letzten Übertragungsstatus an das Device, das Geräte unterstützt keinen Burst. D.h. einen an das Gerät abgesetzten Befehl z.B. getConfig oder einstellen von Zählerkonstanten sollte man möglichst am Geräte bestätigen, sonst könnte es sein, dass ein ACK zu spät zurück kommt und man sich anschließend im state über ein NACK wundert.

Scheinbar gibt es für das reading energy bei 838860.7 einen Zählerüberlauf. [http://forum.fhem.de/index.php/topic,32827.msg270012.html#msg270012]

== Betrieb mit FHEM ==
Der Sensor wird mit einem FHEM im Update-Stand vom (mindestens) 7.2.2015 funktionsfähig eingebunden (getestet in der Variante mit Ferraris-Fühler). Es werden der Fühlertyp und die Fühlerkonstante richtig ausgelesen und im Reading ''energy'' die errechnete Energiemenge ausgegeben (bei Strom: Wattstunden, Wh).

Für die perfekte Konfiguration wird auf die Seite "[[Heizleistung und Gasverbrauch]]" verwiesen, wo eine vollständige Lösung für die Umrechnung von Gasverbrauch in kW/h, Graphen und Hilfsprogramme vorgestellt wird.

=== Readings ===
'''Reading: |Beispiel'''
D-firmware |1.0
D-serialNr |MEQ0025452
battery |ok
boot |off
current |0
eState |E: 6199.9 P: 1713 I: 0 U: 0 f: 50
energy |6199.9
energyOffset |84413.2
frequency |50
power |1713
powerOn |2015-03-26 14:57:48
voltage |0

=== Events Auszug ===
'''Event |Beispielswert'''
battery* |ok
energy |10186.6
power |283
current |0
voltage |0
frequency |50
eState |E: 10186.6 P: 283 I: 0 U: 0 f: 50
boot |off

Ein battery-Event wird nicht zyklisch getriggert. Erst wenn die Batterie tatsächlich leer ist, wird eine entsprechende Meldung vom Gerät selber gesendet und ein battery-Event getriggert (battery: low).

Mit einem Userreading lässt sich die Angabe aus ''energy'' (zum Beispiel für einen Stromzähler (Wh)) in die auf dem Zähler übliche Angabe kWh umrechnen und zugleich mit dem Aufaddieren des Unterschieds beim Start (das Zählermodul beginnt ja mit 0 Wh, während der Zähler meist schon einige Jahre auf der "Rolle" hat) die Angaben gleichziehen:
:<code><nowiki>attr <DeviceName> userReadings kWh {sprintf("%.1f",ReadingsVal("<DeviceName>","energy","???")/1000+72031.5639)}</nowiki></code>

=== Konfiguration ===
Nach dem Erkennen durch [[autocreate]] wird der Zählersensor mit diesen Angaben eingebunden:

define CUL_HM_HM_ES_TX_WM_353594 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594 IODev CUL_0
attr CUL_HM_HM_ES_TX_WM_353594 actCycle 000:10
attr CUL_HM_HM_ES_TX_WM_353594 actStatus alive
attr CUL_HM_HM_ES_TX_WM_353594 expert 2_full
attr CUL_HM_HM_ES_TX_WM_353594 firmware 1.0
attr CUL_HM_HM_ES_TX_WM_353594 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594 subType powerSensor
define CUL_HM_HM_ES_TX_WM_353594_IEC_01 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 icon measure_power
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 peerIDs
define CUL_HM_HM_ES_TX_WM_353594_IEC_02 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594_IEC_02 model HM-ES-TX-WM

Die Übertragung der Messwerte erfolgt in Kanal 01 (hier: "CUL_HM_HM_ES_TX_WM_353594_IEC_01"). Für eine Darstellung als SVG-Plot können die Messwerte mittels folgender Anweisung in einer Datei abgespeichert werden.

define FileLog_CUL_HM_HM_ES_TX_WM_353594_IEC_01 FileLog ./log/Stromverbrauch-%Y-%m.log CUL_HM_HM_ES_TX_WM_353594_IEC_01

Für den Betrieb mit den verschiedenen Zählern muß eines der Readings '''R-mtrConst'''XXX auf den jeweiligen verwendeten Zähler konfiguriert werden. Z.B. kann ein Ferraris-Stromzähler 100, 150 oder 200 Umdrehungen je kWh benötigen. Dies geschieht z.B. für 150 Meldungen je Einheit für einen Ferraris-Zähler mit dem Befehl
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstIr 150</code>

oder für einen Gaszähler auf der 1. Rolle (d.h. 1 Impuls je 0.1 m^3)
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstGas 0.1</code>

In Fhem bis zum Anfang November 2015 war hier ein kleiner Bug enthalten, der diesen Wert nicht akzeptierte. In diesem Fall läßt sich die Anzahl der Impulse direkt am Gerät über das Display einstellen.

== Logging/Graph. Darstellung ==
[[Datei:PlotStromverbrauchProStunde.png|mini|400px|rechts|Beispiel der graph. Darstellung]]
Der Zähler wird fortlaufend aufaddiert. Mit der delta-Funktion von SVG-Plot können die Verbräuche sehr gut visualisiert werden.
Beispiel Stromzähler:

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Stündlicher Stromverbrauch | aktuell: $data{currval1} ($data{min1} / $data{avg1} / $data{max1}) kWh'
set ytics
set y2tics
set grid ytics
set ylabel "kWh/h"
set y2label "kWh/h"
#FileLog 4:CUL_HM_HM_ES_TX_WM_353594.kWh\x3a:0:delta-h
plot "<IN>" using 1:2 axes x1y2 title 'Line 1' ls l0 lw 2 with bars

== Wiki ToDo ==
Seit dem FHEM Update vom 06.03.2016 werden bei Neueinrichtung mit Autocreate 2 Kanäle angelegt. Dies entspricht der Firmware Revision 1.1:
* _IEC_01
Im Gas-Modus werden hier die Werte geliefert.
Im IR-Modus kommen seit R12555 vom 12.11.2016 hier die Zähl-Werte Energiewerte an, die auch im Status von IEC02 gezeigt werden.
state enthält dabei den Wert des readings energy. Möchte man hier z.B. die im letzten Zeitfenster gemessene Leistung anzeigen lassen, reading power, so hilft das Attribut stateformat
<code>{sprintf("P: %.1f W", ReadingsVal($name,"power",0))}</code>

* _IEC_02

== Firmwareupdate ==
Das Gerät lässt sich in den Updatemodus versetzen, im dem die Batterien zunächst entfernt, dann beim Einsetzen die Anlerntaste gedrückt bleibt. die Leuchtdiode blinkt dann rot im schnellen Takt. Das FHEM-Kommando zum Senden der Firmware per <code>set <devicename> fwUpdate <Firmwaredatei.eq3></code> muss vor dem Einlegen der Batterie (+ ">" Taste) aufgegeben werden. Erfolgt zum Zeitpunkt des Anstartens im Updatemodus keine Sendung der Firmware wird der Zählersensor normal gebootet. Die Meldung <code> <devicename> fwUpdate: fail:notInBootLoader</code> im Filelog erscheint, wenn das FHEM fwUpdate Kommando ''zu spät'' gesendet wurde.

Der Update dauert etwa eine Minute. Während des Updates blinkt die Diode rot in kurzen Intervallen.
Nach erfolgreichen Update muss der Sensor auf die Werkseinstellungen zurückgesetzt (">" Taste 4 Sekunden drücken (Display zeigt reS), kurz warten, ">" noch mal 4 Sekunden drücken - Zählersensor rebootet), aus der FHEM Konfiguration entfernt und neu angelernt werden.

Wenn der Reset nicht durchgeführt wird, kommt vom Sensor immer die Fehlermeldung: einmal langes und drei mal kurzes rotes Blinken (Sitz des Auslesekopfes prüfen). Diese Meldung ist in diesem Zusammenhang ziemlich irreführend.

Dieser Vorgang ist im changelog.txt file der Firmware unvollständig beschrieben, da hier ein Update an der CCU vorausgesetzt wird und die CCU die Firmware wohl automatisch sendet.

== Links ==
* Handbuch [http://files.elv.de/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf]
* Produktseite ELV: [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html]
* Forum [http://forum.fhem.de/index.php/topic,32827.msg252161.html#msg252161]
* Forum [http://forum.fhem.de/index.php/topic,30936.msg234877.html#msg234877]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Energieerzeugungsmessung]]

HM-ES-TX-WM Zählersensor für Strom- und Gaszähler

2017-01-02T14:42:05Z

Snowyrain: /* Konfiguration */

{{Infobox Hardware
|Bild=HM-EM-TX-WM.jpg
|Bildbeschreibung=HomeMatic Zählersensor
|HWProtocol=HomeMatic
|HWType=Powersensor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=6 V
|HWPowerConsumption=30 mA
|HWPoweredBy=4 Batterien LR6/AA/Mignon
|HWSize=68x105x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der Zählersensor ist ein Datenerfassungssystem, das den Energieverbräuche (Strom, Gas) direkt am Zähler erfasst und in FHEM als laufender Saldo und als Momentanwerte verfügbar macht.

'''Technische Daten:'''

Gewicht: 195 g (inkl. 4 LR6/Mignon/AA-Batterien)

== Anwendungsszenarien ==
Mit den erfassten und gesammelten Daten lassen sich Aktionen beim Erreichen bestimmter Schwellwerte auslösen, Verbrauchs- und Kostenstatistiken erstellen sowie beliebige weitere Abhängigkeiten bilden. Durch die Funkdatenübertragung sowie den Batteriebetrieb (1 bis 2 Jahre Betriebsdauer verspricht der Hersteller mit einem Satz) ist die Installation denkbar einfach und erfordert lediglich beim Anbringen der Leseeinheit Genauigkeit.

Im Februar 2015 hat die Auslieferung der Geräte als (einfacher) Bausatz begonnen, zu dem es
* einen Ferraris-Sensor (für Stromzähler mit den markanten Laufscheiben),
* LED-Sensor (für neue Zähler mit S0-Schnittstelle) sowie
* BK-G4-Gaszähler von Elster-Kromschröder (die an einer Ziffernrolle einen kleinen Magneten haben, der über einen Sensor mit Reedkontakt erfasst wird)
gibt. Es ist laut Hersteller [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html ELV] nur der Bausatz verfügbar. Ein Fertiggerät ist aktuell nicht geplant.

Die Zähler werden mit rückstandslos entfernbaren Klebepads angebracht.

== Parameter ==
'''list: register | range | peer | description'''
0: pairCentral | 0 to 16777215 | | pairing to central
1: mtrConstGas | 0 to 655.36 | | constant gas
1: mtrConstIr | 0 to 65536 | | constant IR
1: mtrConstLed | 0 to 65536 | | constant led
1: mtrSensIr | -99 to 99 | | sensiblity IR
1: mtrType | literal | | type of measurement options:LED,gas,unknown,IR

== Probleme ==
Der HM-ES-TX-WM sendet zyklisch im 3-Minuten Takt die aktuellen Verbrauchsdaten. Dabei ist für das Reading "power" (aktuelle Stromleistung in Watt) zu beachten, dass alle drei Minuten der ''zuletzt bekannte Wert'' gesendet wird. Das heißt im Besonderen:

* Sollten innerhalb der drei Minuten mehrfach Impulse auftreten mit unterschiedlichen Leistungswerten, wird nur der zuletzt bekannte Wert genommen. Es findet keine Aggregation der Impulse (Mittelwert, Summe, …) statt.
* Sollten innerhalb der drei Minuten keinerlei Impulse auftreten, wird dennoch der zuletzt bekannte Leistungswert gesendet, auch wenn er mehrere Minuten/Stunden/Tage alt ist.

Der state des Devices zeigt den letzten Übertragungsstatus an das Device, das Geräte unterstützt keinen Burst. D.h. einen an das Gerät abgesetzten Befehl z.B. getConfig oder einstellen von Zählerkonstanten sollte man möglichst am Geräte bestätigen, sonst könnte es sein, dass ein ACK zu spät zurück kommt und man sich anschließend im state über ein NACK wundert.

Scheinbar gibt es für das reading energy bei 838860.7 einen Zählerüberlauf. [http://forum.fhem.de/index.php/topic,32827.msg270012.html#msg270012]

== Betrieb mit FHEM ==
Der Sensor wird mit einem FHEM im Update-Stand vom (mindestens) 7.2.2015 funktionsfähig eingebunden (getestet in der Variante mit Ferraris-Fühler). Es werden der Fühlertyp und die Fühlerkonstante richtig ausgelesen und im Reading ''energy'' die errechnete Energiemenge ausgegeben (bei Strom: Wattstunden, Wh).

Für die perfekte Konfiguration wird auf die Seite "[[Heizleistung und Gasverbrauch]]" verwiesen, wo eine vollständige Lösung für die Umrechnung von Gasverbrauch in kW/h, Graphen und Hilfsprogramme vorgestellt wird.

=== Readings ===
'''Reading: |Beispiel'''
D-firmware |1.0
D-serialNr |MEQ0025452
battery |ok
boot |off
current |0
eState |E: 6199.9 P: 1713 I: 0 U: 0 f: 50
energy |6199.9
energyOffset |84413.2
frequency |50
power |1713
powerOn |2015-03-26 14:57:48
voltage |0

=== Events Auszug ===
'''Event |Beispielswert'''
battery* |ok
energy |10186.6
power |283
current |0
voltage |0
frequency |50
eState |E: 10186.6 P: 283 I: 0 U: 0 f: 50
boot |off

Ein battery-Event wird nicht zyklisch getriggert. Erst wenn die Batterie tatsächlich leer ist, wird eine entsprechende Meldung vom Gerät selber gesendet und ein battery-Event getriggert (battery: low).

Mit einem Userreading lässt sich die Angabe aus ''energy'' (zum Beispiel für einen Stromzähler (Wh)) in die auf dem Zähler übliche Angabe kWh umrechnen und zugleich mit dem Aufaddieren des Unterschieds beim Start (das Zählermodul beginnt ja mit 0 Wh, während der Zähler meist schon einige Jahre auf der "Rolle" hat) die Angaben gleichziehen:
:<code><nowiki>attr <DeviceName> userReadings kWh {sprintf("%.1f",ReadingsVal("<DeviceName>","energy","???")/1000+72031.5639)}</nowiki></code>

=== Konfiguration ===
Nach dem Erkennen durch [[autocreate]] wird der Zählersensor mit diesen Angaben eingebunden:

define CUL_HM_HM_ES_TX_WM_353594 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594 IODev CUL_0
attr CUL_HM_HM_ES_TX_WM_353594 actCycle 000:10
attr CUL_HM_HM_ES_TX_WM_353594 actStatus alive
attr CUL_HM_HM_ES_TX_WM_353594 expert 2_full
attr CUL_HM_HM_ES_TX_WM_353594 firmware 1.0
attr CUL_HM_HM_ES_TX_WM_353594 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594 subType powerSensor
define CUL_HM_HM_ES_TX_WM_353594_IEC_01 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 icon measure_power
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 peerIDs
define CUL_HM_HM_ES_TX_WM_353594_IEC_02 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594_IEC_02 model HM-ES-TX-WM

Die Übertragung der Messwerte erfolgt in Kanal 01 (hier: "CUL_HM_HM_ES_TX_WM_353594_IEC_01").

Für den Betrieb mit den verschiedenen Zählern muß eines der Readings '''R-mtrConst'''XXX auf den jeweiligen verwendeten Zähler konfiguriert werden. Z.B. kann ein Ferraris-Stromzähler 100, 150 oder 200 Umdrehungen je kWh benötigen. Dies geschieht z.B. für 150 Meldungen je Einheit für einen Ferraris-Zähler mit dem Befehl
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstIr 150</code>

oder für einen Gaszähler auf der 1. Rolle (d.h. 1 Impuls je 0.1 m^3)
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstGas 0.1</code>

In Fhem bis zum Anfang November 2015 war hier ein kleiner Bug enthalten, der diesen Wert nicht akzeptierte. In diesem Fall läßt sich die Anzahl der Impulse direkt am Gerät über das Display einstellen.

== Logging/Graph. Darstellung ==
[[Datei:PlotStromverbrauchProStunde.png|mini|400px|rechts|Beispiel der graph. Darstellung]]
Der Zähler wird fortlaufend aufaddiert. Mit der delta-Funktion von SVG-Plot können die Verbräuche sehr gut visualisiert werden.
Beispiel Stromzähler:

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Stündlicher Stromverbrauch | aktuell: $data{currval1} ($data{min1} / $data{avg1} / $data{max1}) kWh'
set ytics
set y2tics
set grid ytics
set ylabel "kWh/h"
set y2label "kWh/h"
#FileLog 4:CUL_HM_HM_ES_TX_WM_353594.kWh\x3a:0:delta-h
plot "<IN>" using 1:2 axes x1y2 title 'Line 1' ls l0 lw 2 with bars

== Wiki ToDo ==
Seit dem FHEM Update vom 06.03.2016 werden bei Neueinrichtung mit Autocreate 2 Kanäle angelegt. Dies entspricht der Firmware Revision 1.1:
* _IEC_01
Im Gas-Modus werden hier die Werte geliefert.
Im IR-Modus kommen seit R12555 vom 12.11.2016 hier die Zähl-Werte Energiewerte an, die auch im Status von IEC02 gezeigt werden.
state enthält dabei den Wert des readings energy. Möchte man hier z.B. die im letzten Zeitfenster gemessene Leistung anzeigen lassen, reading power, so hilft das Attribut stateformat
<code>{sprintf("P: %.1f W", ReadingsVal($name,"power",0))}</code>

* _IEC_02

== Firmwareupdate ==
Das Gerät lässt sich in den Updatemodus versetzen, im dem die Batterien zunächst entfernt, dann beim Einsetzen die Anlerntaste gedrückt bleibt. die Leuchtdiode blinkt dann rot im schnellen Takt. Das FHEM-Kommando zum Senden der Firmware per <code>set <devicename> fwUpdate <Firmwaredatei.eq3></code> muss vor dem Einlegen der Batterie (+ ">" Taste) aufgegeben werden. Erfolgt zum Zeitpunkt des Anstartens im Updatemodus keine Sendung der Firmware wird der Zählersensor normal gebootet. Die Meldung <code> <devicename> fwUpdate: fail:notInBootLoader</code> im Filelog erscheint, wenn das FHEM fwUpdate Kommando ''zu spät'' gesendet wurde.

Der Update dauert etwa eine Minute. Während des Updates blinkt die Diode rot in kurzen Intervallen.
Nach erfolgreichen Update muss der Sensor auf die Werkseinstellungen zurückgesetzt (">" Taste 4 Sekunden drücken (Display zeigt reS), kurz warten, ">" noch mal 4 Sekunden drücken - Zählersensor rebootet), aus der FHEM Konfiguration entfernt und neu angelernt werden.

Wenn der Reset nicht durchgeführt wird, kommt vom Sensor immer die Fehlermeldung: einmal langes und drei mal kurzes rotes Blinken (Sitz des Auslesekopfes prüfen). Diese Meldung ist in diesem Zusammenhang ziemlich irreführend.

Dieser Vorgang ist im changelog.txt file der Firmware unvollständig beschrieben, da hier ein Update an der CCU vorausgesetzt wird und die CCU die Firmware wohl automatisch sendet.

== Links ==
* Handbuch [http://files.elv.de/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf]
* Produktseite ELV: [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html]
* Forum [http://forum.fhem.de/index.php/topic,32827.msg252161.html#msg252161]
* Forum [http://forum.fhem.de/index.php/topic,30936.msg234877.html#msg234877]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Energieerzeugungsmessung]]

HM-ES-TX-WM Zählersensor für Strom- und Gaszähler

2017-01-02T14:41:03Z

Snowyrain: Änderung 18234 von Snowyrain (Diskussion) rückgängig gemacht.

{{Infobox Hardware
|Bild=HM-EM-TX-WM.jpg
|Bildbeschreibung=HomeMatic Zählersensor
|HWProtocol=HomeMatic
|HWType=Powersensor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=6 V
|HWPowerConsumption=30 mA
|HWPoweredBy=4 Batterien LR6/AA/Mignon
|HWSize=68x105x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der Zählersensor ist ein Datenerfassungssystem, das den Energieverbräuche (Strom, Gas) direkt am Zähler erfasst und in FHEM als laufender Saldo und als Momentanwerte verfügbar macht.

'''Technische Daten:'''

Gewicht: 195 g (inkl. 4 LR6/Mignon/AA-Batterien)

== Anwendungsszenarien ==
Mit den erfassten und gesammelten Daten lassen sich Aktionen beim Erreichen bestimmter Schwellwerte auslösen, Verbrauchs- und Kostenstatistiken erstellen sowie beliebige weitere Abhängigkeiten bilden. Durch die Funkdatenübertragung sowie den Batteriebetrieb (1 bis 2 Jahre Betriebsdauer verspricht der Hersteller mit einem Satz) ist die Installation denkbar einfach und erfordert lediglich beim Anbringen der Leseeinheit Genauigkeit.

Im Februar 2015 hat die Auslieferung der Geräte als (einfacher) Bausatz begonnen, zu dem es
* einen Ferraris-Sensor (für Stromzähler mit den markanten Laufscheiben),
* LED-Sensor (für neue Zähler mit S0-Schnittstelle) sowie
* BK-G4-Gaszähler von Elster-Kromschröder (die an einer Ziffernrolle einen kleinen Magneten haben, der über einen Sensor mit Reedkontakt erfasst wird)
gibt. Es ist laut Hersteller [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html ELV] nur der Bausatz verfügbar. Ein Fertiggerät ist aktuell nicht geplant.

Die Zähler werden mit rückstandslos entfernbaren Klebepads angebracht.

== Parameter ==
'''list: register | range | peer | description'''
0: pairCentral | 0 to 16777215 | | pairing to central
1: mtrConstGas | 0 to 655.36 | | constant gas
1: mtrConstIr | 0 to 65536 | | constant IR
1: mtrConstLed | 0 to 65536 | | constant led
1: mtrSensIr | -99 to 99 | | sensiblity IR
1: mtrType | literal | | type of measurement options:LED,gas,unknown,IR

== Probleme ==
Der HM-ES-TX-WM sendet zyklisch im 3-Minuten Takt die aktuellen Verbrauchsdaten. Dabei ist für das Reading "power" (aktuelle Stromleistung in Watt) zu beachten, dass alle drei Minuten der ''zuletzt bekannte Wert'' gesendet wird. Das heißt im Besonderen:

* Sollten innerhalb der drei Minuten mehrfach Impulse auftreten mit unterschiedlichen Leistungswerten, wird nur der zuletzt bekannte Wert genommen. Es findet keine Aggregation der Impulse (Mittelwert, Summe, …) statt.
* Sollten innerhalb der drei Minuten keinerlei Impulse auftreten, wird dennoch der zuletzt bekannte Leistungswert gesendet, auch wenn er mehrere Minuten/Stunden/Tage alt ist.

Der state des Devices zeigt den letzten Übertragungsstatus an das Device, das Geräte unterstützt keinen Burst. D.h. einen an das Gerät abgesetzten Befehl z.B. getConfig oder einstellen von Zählerkonstanten sollte man möglichst am Geräte bestätigen, sonst könnte es sein, dass ein ACK zu spät zurück kommt und man sich anschließend im state über ein NACK wundert.

Scheinbar gibt es für das reading energy bei 838860.7 einen Zählerüberlauf. [http://forum.fhem.de/index.php/topic,32827.msg270012.html#msg270012]

== Betrieb mit FHEM ==
Der Sensor wird mit einem FHEM im Update-Stand vom (mindestens) 7.2.2015 funktionsfähig eingebunden (getestet in der Variante mit Ferraris-Fühler). Es werden der Fühlertyp und die Fühlerkonstante richtig ausgelesen und im Reading ''energy'' die errechnete Energiemenge ausgegeben (bei Strom: Wattstunden, Wh).

Für die perfekte Konfiguration wird auf die Seite "[[Heizleistung und Gasverbrauch]]" verwiesen, wo eine vollständige Lösung für die Umrechnung von Gasverbrauch in kW/h, Graphen und Hilfsprogramme vorgestellt wird.

=== Readings ===
'''Reading: |Beispiel'''
D-firmware |1.0
D-serialNr |MEQ0025452
battery |ok
boot |off
current |0
eState |E: 6199.9 P: 1713 I: 0 U: 0 f: 50
energy |6199.9
energyOffset |84413.2
frequency |50
power |1713
powerOn |2015-03-26 14:57:48
voltage |0

=== Events Auszug ===
'''Event |Beispielswert'''
battery* |ok
energy |10186.6
power |283
current |0
voltage |0
frequency |50
eState |E: 10186.6 P: 283 I: 0 U: 0 f: 50
boot |off

Ein battery-Event wird nicht zyklisch getriggert. Erst wenn die Batterie tatsächlich leer ist, wird eine entsprechende Meldung vom Gerät selber gesendet und ein battery-Event getriggert (battery: low).

Mit einem Userreading lässt sich die Angabe aus ''energy'' (zum Beispiel für einen Stromzähler (Wh)) in die auf dem Zähler übliche Angabe kWh umrechnen und zugleich mit dem Aufaddieren des Unterschieds beim Start (das Zählermodul beginnt ja mit 0 Wh, während der Zähler meist schon einige Jahre auf der "Rolle" hat) die Angaben gleichziehen:
:<code><nowiki>attr <DeviceName> userReadings kWh {sprintf("%.1f",ReadingsVal("<DeviceName>","energy","???")/1000+72031.5639)}</nowiki></code>

=== Konfiguration ===
Nach dem Erkennen durch [[autocreate]] wird der Zählersensor mit diesen Angaben eingebunden:

define CUL_HM_HM_ES_TX_WM_353594 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594 IODev CUL_0
attr CUL_HM_HM_ES_TX_WM_353594 actCycle 000:10
attr CUL_HM_HM_ES_TX_WM_353594 actStatus alive
attr CUL_HM_HM_ES_TX_WM_353594 expert 2_full
attr CUL_HM_HM_ES_TX_WM_353594 firmware 1.0
attr CUL_HM_HM_ES_TX_WM_353594 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594 subType powerSensor
define CUL_HM_HM_ES_TX_WM_353594_IEC_01 CUL_HM 4D0DC201
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 icon measure_power
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 peerIDs
define CUL_HM_HM_ES_TX_WM_353594_IEC_02 CUL_HM 4D0DC202
attr CUL_HM_HM_ES_TX_WM_353594_IEC_02 model HM-ES-TX-WM

Die Übertragung der Messwerte erfolgt in Kanal 01 (hier: "CUL_HM_HM_ES_TX_WM_353594_IEC_01").

Für den Betrieb mit den verschiedenen Zählern muß eines der Readings '''R-mtrConst'''XXX auf den jeweiligen verwendeten Zähler konfiguriert werden. Z.B. kann ein Ferraris-Stromzähler 100, 150 oder 200 Umdrehungen je kWh benötigen. Dies geschieht z.B. für 150 Meldungen je Einheit für einen Ferraris-Zähler mit dem Befehl
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstIr 150</code>

oder für einen Gaszähler auf der 1. Rolle (d.h. 1 Impuls je 0.1 m^3)
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstGas 0.1</code>

In Fhem bis zum Anfang November 2015 war hier ein kleiner Bug enthalten, der diesen Wert nicht akzeptierte. In diesem Fall läßt sich die Anzahl der Impulse direkt am Gerät über das Display einstellen.

== Logging/Graph. Darstellung ==
[[Datei:PlotStromverbrauchProStunde.png|mini|400px|rechts|Beispiel der graph. Darstellung]]
Der Zähler wird fortlaufend aufaddiert. Mit der delta-Funktion von SVG-Plot können die Verbräuche sehr gut visualisiert werden.
Beispiel Stromzähler:

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Stündlicher Stromverbrauch | aktuell: $data{currval1} ($data{min1} / $data{avg1} / $data{max1}) kWh'
set ytics
set y2tics
set grid ytics
set ylabel "kWh/h"
set y2label "kWh/h"
#FileLog 4:CUL_HM_HM_ES_TX_WM_353594.kWh\x3a:0:delta-h
plot "<IN>" using 1:2 axes x1y2 title 'Line 1' ls l0 lw 2 with bars

== Wiki ToDo ==
Seit dem FHEM Update vom 06.03.2016 werden bei Neueinrichtung mit Autocreate 2 Kanäle angelegt. Dies entspricht der Firmware Revision 1.1:
* _IEC_01
Im Gas-Modus werden hier die Werte geliefert.
Im IR-Modus kommen seit R12555 vom 12.11.2016 hier die Zähl-Werte Energiewerte an, die auch im Status von IEC02 gezeigt werden.
state enthält dabei den Wert des readings energy. Möchte man hier z.B. die im letzten Zeitfenster gemessene Leistung anzeigen lassen, reading power, so hilft das Attribut stateformat
<code>{sprintf("P: %.1f W", ReadingsVal($name,"power",0))}</code>

* _IEC_02

== Firmwareupdate ==
Das Gerät lässt sich in den Updatemodus versetzen, im dem die Batterien zunächst entfernt, dann beim Einsetzen die Anlerntaste gedrückt bleibt. die Leuchtdiode blinkt dann rot im schnellen Takt. Das FHEM-Kommando zum Senden der Firmware per <code>set <devicename> fwUpdate <Firmwaredatei.eq3></code> muss vor dem Einlegen der Batterie (+ ">" Taste) aufgegeben werden. Erfolgt zum Zeitpunkt des Anstartens im Updatemodus keine Sendung der Firmware wird der Zählersensor normal gebootet. Die Meldung <code> <devicename> fwUpdate: fail:notInBootLoader</code> im Filelog erscheint, wenn das FHEM fwUpdate Kommando ''zu spät'' gesendet wurde.

Der Update dauert etwa eine Minute. Während des Updates blinkt die Diode rot in kurzen Intervallen.
Nach erfolgreichen Update muss der Sensor auf die Werkseinstellungen zurückgesetzt (">" Taste 4 Sekunden drücken (Display zeigt reS), kurz warten, ">" noch mal 4 Sekunden drücken - Zählersensor rebootet), aus der FHEM Konfiguration entfernt und neu angelernt werden.

Wenn der Reset nicht durchgeführt wird, kommt vom Sensor immer die Fehlermeldung: einmal langes und drei mal kurzes rotes Blinken (Sitz des Auslesekopfes prüfen). Diese Meldung ist in diesem Zusammenhang ziemlich irreführend.

Dieser Vorgang ist im changelog.txt file der Firmware unvollständig beschrieben, da hier ein Update an der CCU vorausgesetzt wird und die CCU die Firmware wohl automatisch sendet.

== Links ==
* Handbuch [http://files.elv.de/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf]
* Produktseite ELV: [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html]
* Forum [http://forum.fhem.de/index.php/topic,32827.msg252161.html#msg252161]
* Forum [http://forum.fhem.de/index.php/topic,30936.msg234877.html#msg234877]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Energieerzeugungsmessung]]

HM-ES-TX-WM Zählersensor für Strom- und Gaszähler

2017-01-02T14:40:13Z

Snowyrain: /* Konfiguration */

{{Infobox Hardware
|Bild=HM-EM-TX-WM.jpg
|Bildbeschreibung=HomeMatic Zählersensor
|HWProtocol=HomeMatic
|HWType=Powersensor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=6 V
|HWPowerConsumption=30 mA
|HWPoweredBy=4 Batterien LR6/AA/Mignon
|HWSize=68x105x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der Zählersensor ist ein Datenerfassungssystem, das den Energieverbräuche (Strom, Gas) direkt am Zähler erfasst und in FHEM als laufender Saldo und als Momentanwerte verfügbar macht.

'''Technische Daten:'''

Gewicht: 195 g (inkl. 4 LR6/Mignon/AA-Batterien)

== Anwendungsszenarien ==
Mit den erfassten und gesammelten Daten lassen sich Aktionen beim Erreichen bestimmter Schwellwerte auslösen, Verbrauchs- und Kostenstatistiken erstellen sowie beliebige weitere Abhängigkeiten bilden. Durch die Funkdatenübertragung sowie den Batteriebetrieb (1 bis 2 Jahre Betriebsdauer verspricht der Hersteller mit einem Satz) ist die Installation denkbar einfach und erfordert lediglich beim Anbringen der Leseeinheit Genauigkeit.

Im Februar 2015 hat die Auslieferung der Geräte als (einfacher) Bausatz begonnen, zu dem es
* einen Ferraris-Sensor (für Stromzähler mit den markanten Laufscheiben),
* LED-Sensor (für neue Zähler mit S0-Schnittstelle) sowie
* BK-G4-Gaszähler von Elster-Kromschröder (die an einer Ziffernrolle einen kleinen Magneten haben, der über einen Sensor mit Reedkontakt erfasst wird)
gibt. Es ist laut Hersteller [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html ELV] nur der Bausatz verfügbar. Ein Fertiggerät ist aktuell nicht geplant.

Die Zähler werden mit rückstandslos entfernbaren Klebepads angebracht.

== Parameter ==
'''list: register | range | peer | description'''
0: pairCentral | 0 to 16777215 | | pairing to central
1: mtrConstGas | 0 to 655.36 | | constant gas
1: mtrConstIr | 0 to 65536 | | constant IR
1: mtrConstLed | 0 to 65536 | | constant led
1: mtrSensIr | -99 to 99 | | sensiblity IR
1: mtrType | literal | | type of measurement options:LED,gas,unknown,IR

== Probleme ==
Der HM-ES-TX-WM sendet zyklisch im 3-Minuten Takt die aktuellen Verbrauchsdaten. Dabei ist für das Reading "power" (aktuelle Stromleistung in Watt) zu beachten, dass alle drei Minuten der ''zuletzt bekannte Wert'' gesendet wird. Das heißt im Besonderen:

* Sollten innerhalb der drei Minuten mehrfach Impulse auftreten mit unterschiedlichen Leistungswerten, wird nur der zuletzt bekannte Wert genommen. Es findet keine Aggregation der Impulse (Mittelwert, Summe, …) statt.
* Sollten innerhalb der drei Minuten keinerlei Impulse auftreten, wird dennoch der zuletzt bekannte Leistungswert gesendet, auch wenn er mehrere Minuten/Stunden/Tage alt ist.

Der state des Devices zeigt den letzten Übertragungsstatus an das Device, das Geräte unterstützt keinen Burst. D.h. einen an das Gerät abgesetzten Befehl z.B. getConfig oder einstellen von Zählerkonstanten sollte man möglichst am Geräte bestätigen, sonst könnte es sein, dass ein ACK zu spät zurück kommt und man sich anschließend im state über ein NACK wundert.

Scheinbar gibt es für das reading energy bei 838860.7 einen Zählerüberlauf. [http://forum.fhem.de/index.php/topic,32827.msg270012.html#msg270012]

== Betrieb mit FHEM ==
Der Sensor wird mit einem FHEM im Update-Stand vom (mindestens) 7.2.2015 funktionsfähig eingebunden (getestet in der Variante mit Ferraris-Fühler). Es werden der Fühlertyp und die Fühlerkonstante richtig ausgelesen und im Reading ''energy'' die errechnete Energiemenge ausgegeben (bei Strom: Wattstunden, Wh).

Für die perfekte Konfiguration wird auf die Seite "[[Heizleistung und Gasverbrauch]]" verwiesen, wo eine vollständige Lösung für die Umrechnung von Gasverbrauch in kW/h, Graphen und Hilfsprogramme vorgestellt wird.

=== Readings ===
'''Reading: |Beispiel'''
D-firmware |1.0
D-serialNr |MEQ0025452
battery |ok
boot |off
current |0
eState |E: 6199.9 P: 1713 I: 0 U: 0 f: 50
energy |6199.9
energyOffset |84413.2
frequency |50
power |1713
powerOn |2015-03-26 14:57:48
voltage |0

=== Events Auszug ===
'''Event |Beispielswert'''
battery* |ok
energy |10186.6
power |283
current |0
voltage |0
frequency |50
eState |E: 10186.6 P: 283 I: 0 U: 0 f: 50
boot |off

Ein battery-Event wird nicht zyklisch getriggert. Erst wenn die Batterie tatsächlich leer ist, wird eine entsprechende Meldung vom Gerät selber gesendet und ein battery-Event getriggert (battery: low).

Mit einem Userreading lässt sich die Angabe aus ''energy'' (zum Beispiel für einen Stromzähler (Wh)) in die auf dem Zähler übliche Angabe kWh umrechnen und zugleich mit dem Aufaddieren des Unterschieds beim Start (das Zählermodul beginnt ja mit 0 Wh, während der Zähler meist schon einige Jahre auf der "Rolle" hat) die Angaben gleichziehen:
:<code><nowiki>attr <DeviceName> userReadings kWh {sprintf("%.1f",ReadingsVal("<DeviceName>","energy","???")/1000+72031.5639)}</nowiki></code>

=== Konfiguration ===
Nach dem Erkennen durch [[autocreate]] wird der Zählersensor mit diesen Angaben eingebunden:

define CUL_HM_HM_ES_TX_WM_353594 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594 IODev CUL_0
attr CUL_HM_HM_ES_TX_WM_353594 actCycle 000:10
attr CUL_HM_HM_ES_TX_WM_353594 actStatus alive
attr CUL_HM_HM_ES_TX_WM_353594 expert 2_full
attr CUL_HM_HM_ES_TX_WM_353594 firmware 1.0
attr CUL_HM_HM_ES_TX_WM_353594 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594 subType powerSensor
define CUL_HM_HM_ES_TX_WM_353594_IEC_01 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 icon measure_power
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 peerIDs
define CUL_HM_HM_ES_TX_WM_353594_IEC_02 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594_IEC_02 model HM-ES-TX-WM

Die Übertragung der Messwerte erfolgt in Kanal 01 (hier: "CUL_HM_HM_ES_TX_WM_353594_IEC_01").

Für den Betrieb mit den verschiedenen Zählern muß eines der Readings '''R-mtrConst'''XXX auf den jeweiligen verwendeten Zähler konfiguriert werden. Z.B. kann ein Ferraris-Stromzähler 100, 150 oder 200 Umdrehungen je kWh benötigen. Dies geschieht z.B. für 150 Meldungen je Einheit für einen Ferraris-Zähler mit dem Befehl
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstIr 150</code>

oder für einen Gaszähler auf der 1. Rolle (d.h. 1 Impuls je 0.1 m^3)
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstGas 0.1</code>

In Fhem bis zum Anfang November 2015 war hier ein kleiner Bug enthalten, der diesen Wert nicht akzeptierte. In diesem Fall läßt sich die Anzahl der Impulse direkt am Gerät über das Display einstellen.

== Logging/Graph. Darstellung ==
[[Datei:PlotStromverbrauchProStunde.png|mini|400px|rechts|Beispiel der graph. Darstellung]]
Der Zähler wird fortlaufend aufaddiert. Mit der delta-Funktion von SVG-Plot können die Verbräuche sehr gut visualisiert werden.
Beispiel Stromzähler:

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Stündlicher Stromverbrauch | aktuell: $data{currval1} ($data{min1} / $data{avg1} / $data{max1}) kWh'
set ytics
set y2tics
set grid ytics
set ylabel "kWh/h"
set y2label "kWh/h"
#FileLog 4:CUL_HM_HM_ES_TX_WM_353594.kWh\x3a:0:delta-h
plot "<IN>" using 1:2 axes x1y2 title 'Line 1' ls l0 lw 2 with bars

== Wiki ToDo ==
Seit dem FHEM Update vom 06.03.2016 werden bei Neueinrichtung mit Autocreate 2 Kanäle angelegt. Dies entspricht der Firmware Revision 1.1:
* _IEC_01
Im Gas-Modus werden hier die Werte geliefert.
Im IR-Modus kommen seit R12555 vom 12.11.2016 hier die Zähl-Werte Energiewerte an, die auch im Status von IEC02 gezeigt werden.
state enthält dabei den Wert des readings energy. Möchte man hier z.B. die im letzten Zeitfenster gemessene Leistung anzeigen lassen, reading power, so hilft das Attribut stateformat
<code>{sprintf("P: %.1f W", ReadingsVal($name,"power",0))}</code>

* _IEC_02

== Firmwareupdate ==
Das Gerät lässt sich in den Updatemodus versetzen, im dem die Batterien zunächst entfernt, dann beim Einsetzen die Anlerntaste gedrückt bleibt. die Leuchtdiode blinkt dann rot im schnellen Takt. Das FHEM-Kommando zum Senden der Firmware per <code>set <devicename> fwUpdate <Firmwaredatei.eq3></code> muss vor dem Einlegen der Batterie (+ ">" Taste) aufgegeben werden. Erfolgt zum Zeitpunkt des Anstartens im Updatemodus keine Sendung der Firmware wird der Zählersensor normal gebootet. Die Meldung <code> <devicename> fwUpdate: fail:notInBootLoader</code> im Filelog erscheint, wenn das FHEM fwUpdate Kommando ''zu spät'' gesendet wurde.

Der Update dauert etwa eine Minute. Während des Updates blinkt die Diode rot in kurzen Intervallen.
Nach erfolgreichen Update muss der Sensor auf die Werkseinstellungen zurückgesetzt (">" Taste 4 Sekunden drücken (Display zeigt reS), kurz warten, ">" noch mal 4 Sekunden drücken - Zählersensor rebootet), aus der FHEM Konfiguration entfernt und neu angelernt werden.

Wenn der Reset nicht durchgeführt wird, kommt vom Sensor immer die Fehlermeldung: einmal langes und drei mal kurzes rotes Blinken (Sitz des Auslesekopfes prüfen). Diese Meldung ist in diesem Zusammenhang ziemlich irreführend.

Dieser Vorgang ist im changelog.txt file der Firmware unvollständig beschrieben, da hier ein Update an der CCU vorausgesetzt wird und die CCU die Firmware wohl automatisch sendet.

== Links ==
* Handbuch [http://files.elv.de/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf]
* Produktseite ELV: [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html]
* Forum [http://forum.fhem.de/index.php/topic,32827.msg252161.html#msg252161]
* Forum [http://forum.fhem.de/index.php/topic,30936.msg234877.html#msg234877]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Energieerzeugungsmessung]]

HM-ES-TX-WM Zählersensor für Strom- und Gaszähler

2017-01-02T14:39:48Z

Snowyrain: /* Konfiguration */

{{Infobox Hardware
|Bild=HM-EM-TX-WM.jpg
|Bildbeschreibung=HomeMatic Zählersensor
|HWProtocol=HomeMatic
|HWType=Powersensor
|HWCategory=HomeMatic
|HWComm=868 MHz
|HWChannels=1
|HWVoltage=6 V
|HWPowerConsumption=30 mA
|HWPoweredBy=4 Batterien LR6/AA/Mignon
|HWSize=68x105x30mm
|HWDeviceFHEM=[http://fhem.de/commandref.html#CUL_HM CUL_HM]
|HWManufacturer=ELV / eQ-3
}}

== Features ==
Der Zählersensor ist ein Datenerfassungssystem, das den Energieverbräuche (Strom, Gas) direkt am Zähler erfasst und in FHEM als laufender Saldo und als Momentanwerte verfügbar macht.

'''Technische Daten:'''

Gewicht: 195 g (inkl. 4 LR6/Mignon/AA-Batterien)

== Anwendungsszenarien ==
Mit den erfassten und gesammelten Daten lassen sich Aktionen beim Erreichen bestimmter Schwellwerte auslösen, Verbrauchs- und Kostenstatistiken erstellen sowie beliebige weitere Abhängigkeiten bilden. Durch die Funkdatenübertragung sowie den Batteriebetrieb (1 bis 2 Jahre Betriebsdauer verspricht der Hersteller mit einem Satz) ist die Installation denkbar einfach und erfordert lediglich beim Anbringen der Leseeinheit Genauigkeit.

Im Februar 2015 hat die Auslieferung der Geräte als (einfacher) Bausatz begonnen, zu dem es
* einen Ferraris-Sensor (für Stromzähler mit den markanten Laufscheiben),
* LED-Sensor (für neue Zähler mit S0-Schnittstelle) sowie
* BK-G4-Gaszähler von Elster-Kromschröder (die an einer Ziffernrolle einen kleinen Magneten haben, der über einen Sensor mit Reedkontakt erfasst wird)
gibt. Es ist laut Hersteller [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html ELV] nur der Bausatz verfügbar. Ein Fertiggerät ist aktuell nicht geplant.

Die Zähler werden mit rückstandslos entfernbaren Klebepads angebracht.

== Parameter ==
'''list: register | range | peer | description'''
0: pairCentral | 0 to 16777215 | | pairing to central
1: mtrConstGas | 0 to 655.36 | | constant gas
1: mtrConstIr | 0 to 65536 | | constant IR
1: mtrConstLed | 0 to 65536 | | constant led
1: mtrSensIr | -99 to 99 | | sensiblity IR
1: mtrType | literal | | type of measurement options:LED,gas,unknown,IR

== Probleme ==
Der HM-ES-TX-WM sendet zyklisch im 3-Minuten Takt die aktuellen Verbrauchsdaten. Dabei ist für das Reading "power" (aktuelle Stromleistung in Watt) zu beachten, dass alle drei Minuten der ''zuletzt bekannte Wert'' gesendet wird. Das heißt im Besonderen:

* Sollten innerhalb der drei Minuten mehrfach Impulse auftreten mit unterschiedlichen Leistungswerten, wird nur der zuletzt bekannte Wert genommen. Es findet keine Aggregation der Impulse (Mittelwert, Summe, …) statt.
* Sollten innerhalb der drei Minuten keinerlei Impulse auftreten, wird dennoch der zuletzt bekannte Leistungswert gesendet, auch wenn er mehrere Minuten/Stunden/Tage alt ist.

Der state des Devices zeigt den letzten Übertragungsstatus an das Device, das Geräte unterstützt keinen Burst. D.h. einen an das Gerät abgesetzten Befehl z.B. getConfig oder einstellen von Zählerkonstanten sollte man möglichst am Geräte bestätigen, sonst könnte es sein, dass ein ACK zu spät zurück kommt und man sich anschließend im state über ein NACK wundert.

Scheinbar gibt es für das reading energy bei 838860.7 einen Zählerüberlauf. [http://forum.fhem.de/index.php/topic,32827.msg270012.html#msg270012]

== Betrieb mit FHEM ==
Der Sensor wird mit einem FHEM im Update-Stand vom (mindestens) 7.2.2015 funktionsfähig eingebunden (getestet in der Variante mit Ferraris-Fühler). Es werden der Fühlertyp und die Fühlerkonstante richtig ausgelesen und im Reading ''energy'' die errechnete Energiemenge ausgegeben (bei Strom: Wattstunden, Wh).

Für die perfekte Konfiguration wird auf die Seite "[[Heizleistung und Gasverbrauch]]" verwiesen, wo eine vollständige Lösung für die Umrechnung von Gasverbrauch in kW/h, Graphen und Hilfsprogramme vorgestellt wird.

=== Readings ===
'''Reading: |Beispiel'''
D-firmware |1.0
D-serialNr |MEQ0025452
battery |ok
boot |off
current |0
eState |E: 6199.9 P: 1713 I: 0 U: 0 f: 50
energy |6199.9
energyOffset |84413.2
frequency |50
power |1713
powerOn |2015-03-26 14:57:48
voltage |0

=== Events Auszug ===
'''Event |Beispielswert'''
battery* |ok
energy |10186.6
power |283
current |0
voltage |0
frequency |50
eState |E: 10186.6 P: 283 I: 0 U: 0 f: 50
boot |off

Ein battery-Event wird nicht zyklisch getriggert. Erst wenn die Batterie tatsächlich leer ist, wird eine entsprechende Meldung vom Gerät selber gesendet und ein battery-Event getriggert (battery: low).

Mit einem Userreading lässt sich die Angabe aus ''energy'' (zum Beispiel für einen Stromzähler (Wh)) in die auf dem Zähler übliche Angabe kWh umrechnen und zugleich mit dem Aufaddieren des Unterschieds beim Start (das Zählermodul beginnt ja mit 0 Wh, während der Zähler meist schon einige Jahre auf der "Rolle" hat) die Angaben gleichziehen:
:<code><nowiki>attr <DeviceName> userReadings kWh {sprintf("%.1f",ReadingsVal("<DeviceName>","energy","???")/1000+72031.5639)}</nowiki></code>

=== Konfiguration ===
Nach dem Erkennen durch [[autocreate]] wird der Zählersensor mit diesen Angaben eingebunden:

define CUL_HM_HM_ES_TX_WM_353594 CUL_HM 353594
attr CUL_HM_HM_ES_TX_WM_353594 IODev CUL_0
attr CUL_HM_HM_ES_TX_WM_353594 actCycle 000:10
attr CUL_HM_HM_ES_TX_WM_353594 actStatus alive
attr CUL_HM_HM_ES_TX_WM_353594 expert 2_full
attr CUL_HM_HM_ES_TX_WM_353594 firmware 1.0
attr CUL_HM_HM_ES_TX_WM_353594 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594 subType powerSensor
define CUL_HM_HM_ES_TX_WM_353594_IEC_01 CUL_HM 4D0DC201
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 icon measure_power
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 model HM-ES-TX-WM
attr CUL_HM_HM_ES_TX_WM_353594_IEC_01 peerIDs
define CUL_HM_HM_ES_TX_WM_353594_IEC_02 CUL_HM 4D0DC202
attr CUL_HM_HM_ES_TX_WM_353594_IEC_02 model HM-ES-TX-WM

Die Übertragung der Messwerte erfolgt in Kanal 01 (hier: "CUL_HM_HM_ES_TX_WM_353594_IEC_01").

Für den Betrieb mit den verschiedenen Zählern muß eines der Readings '''R-mtrConst'''XXX auf den jeweiligen verwendeten Zähler konfiguriert werden. Z.B. kann ein Ferraris-Stromzähler 100, 150 oder 200 Umdrehungen je kWh benötigen. Dies geschieht z.B. für 150 Meldungen je Einheit für einen Ferraris-Zähler mit dem Befehl
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstIr 150</code>

oder für einen Gaszähler auf der 1. Rolle (d.h. 1 Impuls je 0.1 m^3)
:<code>set CUL_HM_HM_ES_TX_WM_353594 regSet mtrConstGas 0.1</code>

In Fhem bis zum Anfang November 2015 war hier ein kleiner Bug enthalten, der diesen Wert nicht akzeptierte. In diesem Fall läßt sich die Anzahl der Impulse direkt am Gerät über das Display einstellen.

== Logging/Graph. Darstellung ==
[[Datei:PlotStromverbrauchProStunde.png|mini|400px|rechts|Beispiel der graph. Darstellung]]
Der Zähler wird fortlaufend aufaddiert. Mit der delta-Funktion von SVG-Plot können die Verbräuche sehr gut visualisiert werden.
Beispiel Stromzähler:

set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'Stündlicher Stromverbrauch | aktuell: $data{currval1} ($data{min1} / $data{avg1} / $data{max1}) kWh'
set ytics
set y2tics
set grid ytics
set ylabel "kWh/h"
set y2label "kWh/h"
#FileLog 4:CUL_HM_HM_ES_TX_WM_353594.kWh\x3a:0:delta-h
plot "<IN>" using 1:2 axes x1y2 title 'Line 1' ls l0 lw 2 with bars

== Wiki ToDo ==
Seit dem FHEM Update vom 06.03.2016 werden bei Neueinrichtung mit Autocreate 2 Kanäle angelegt. Dies entspricht der Firmware Revision 1.1:
* _IEC_01
Im Gas-Modus werden hier die Werte geliefert.
Im IR-Modus kommen seit R12555 vom 12.11.2016 hier die Zähl-Werte Energiewerte an, die auch im Status von IEC02 gezeigt werden.
state enthält dabei den Wert des readings energy. Möchte man hier z.B. die im letzten Zeitfenster gemessene Leistung anzeigen lassen, reading power, so hilft das Attribut stateformat
<code>{sprintf("P: %.1f W", ReadingsVal($name,"power",0))}</code>

* _IEC_02

== Firmwareupdate ==
Das Gerät lässt sich in den Updatemodus versetzen, im dem die Batterien zunächst entfernt, dann beim Einsetzen die Anlerntaste gedrückt bleibt. die Leuchtdiode blinkt dann rot im schnellen Takt. Das FHEM-Kommando zum Senden der Firmware per <code>set <devicename> fwUpdate <Firmwaredatei.eq3></code> muss vor dem Einlegen der Batterie (+ ">" Taste) aufgegeben werden. Erfolgt zum Zeitpunkt des Anstartens im Updatemodus keine Sendung der Firmware wird der Zählersensor normal gebootet. Die Meldung <code> <devicename> fwUpdate: fail:notInBootLoader</code> im Filelog erscheint, wenn das FHEM fwUpdate Kommando ''zu spät'' gesendet wurde.

Der Update dauert etwa eine Minute. Während des Updates blinkt die Diode rot in kurzen Intervallen.
Nach erfolgreichen Update muss der Sensor auf die Werkseinstellungen zurückgesetzt (">" Taste 4 Sekunden drücken (Display zeigt reS), kurz warten, ">" noch mal 4 Sekunden drücken - Zählersensor rebootet), aus der FHEM Konfiguration entfernt und neu angelernt werden.

Wenn der Reset nicht durchgeführt wird, kommt vom Sensor immer die Fehlermeldung: einmal langes und drei mal kurzes rotes Blinken (Sitz des Auslesekopfes prüfen). Diese Meldung ist in diesem Zusammenhang ziemlich irreführend.

Dieser Vorgang ist im changelog.txt file der Firmware unvollständig beschrieben, da hier ein Update an der CCU vorausgesetzt wird und die CCU die Firmware wohl automatisch sendet.

== Links ==
* Handbuch [http://files.elv.de/Assets/Produkte/14/1401/140143/Downloads/140143_sensor_um.pdf]
* Produktseite ELV: [http://www.elv.de/homematic-zaehlersensor-strom-gas-bausatz.html]
* Forum [http://forum.fhem.de/index.php/topic,32827.msg252161.html#msg252161]
* Forum [http://forum.fhem.de/index.php/topic,30936.msg234877.html#msg234877]

[[Kategorie:HomeMatic Components]]
[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:Energieerzeugungsmessung]]

WakeOnLan

2013-12-31T16:54:56Z

Snowyrain:

Mittels Wake On Lan können Computer,NAS,... eingeschaltet werden. Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese Pakete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhalb eines Netzwerksegments versendet werden. Das zu weckende Gerät muss Wake on Lan unterstützen und es muss (im BIOS) eingeschaltet werden. Bei einigen Systemen steigt die Energieaufnahme im Standby bei aktiviertem WOL stark.

== Ermitteln der MAC-Adresse ==

Anschließend muss die MAC-Adresse des zu weckenden Gerätes ermittelt werden.
Auf dem Gerät selber:
* Auf einem Windows-PC in einer Shell den Befehl „ipconfig /all“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „ifconfig“ eingeben
Von einem anderen Gerät
* Auf einem Windows-PC in einer Shell den Befehl „arp -a“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „arp -a“ eingeben

== OpenWRT ==

Das Wake on Lan Paket kann mit dem Programm etherwake erzeugt werden.

<nowiki>opkg update
opkg install etherwake</nowiki>

Test: In der Shell folgenden Befehl eingeben. Die MAC-Adresse muss natürlich angepasst werden das Interface (hier br-lan) eventuell auch.
<nowiki>etherwake -i br-lan 00:06:55:5a:53:f3</nowiki>
Das Gerät sollte jetzt einschalten.

Funktion in der Datei myUtils.pm erstellen.

<nowiki>######## WakeOnLan von OpenWRT ############
sub
WakeOnLan
{
my $mac = shift;
my $ret = "";
$ret .= qx(etherwake -i br-lan $mac);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail to $mac: $ret";
}</nowiki>

Test: In dem FHEM-Webinterface { WakeOnLan('00:06:55:5a:53:f3');; } eingeben.

Um auf einen Tasterdruck reagieren zu können, muss die Datei fhem.cfg ergänzt werden:
<nowiki>define HM_Taster_01.ntfy notify HM_Taster_01.* {WakeOnLan('00:17:31:fa:9b:51')}</nowiki>

WakeOnLan

2013-12-31T16:51:59Z

Snowyrain: /* OpenWRT */

Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese Pakete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhalb eines Netzwerksegments versendet werden. Das zu weckende Gerät muss Wake on Lan unterstützen und es muss (im BIOS) eingeschaltet werden.

== Ermitteln der MAC-Adresse ==

Anschließend muss die MAC-Adresse des zu weckenden Gerätes ermittelt werden.
Auf dem Gerät selber:
* Auf einem Windows-PC in einer Shell den Befehl „ipconfig /all“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „ifconfig“ eingeben
Von einem anderen Gerät
* Auf einem Windows-PC in einer Shell den Befehl „arp -a“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „arp -a“ eingeben

== OpenWRT ==

Das Wake on Lan Paket kann mit dem Programm etherwake erzeugt werden.

<nowiki>opkg update
opkg install etherwake</nowiki>

Test: In der Shell folgenden Befehl eingeben. Die MAC-Adresse muss natürlich angepasst werden das Interface (hier br-lan) eventuell auch.
<nowiki>etherwake -i br-lan 00:06:55:5a:53:f3</nowiki>
Das Gerät sollte jetzt einschalten.

Funktion in der Datei myUtils.pm erstellen.

<nowiki>######## WakeOnLan von OpenWRT ############
sub
WakeOnLan
{
my $mac = shift;
my $ret = "";
$ret .= qx(etherwake -i br-lan $mac);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail to $mac: $ret";
}</nowiki>

Test: In dem FHEM-Webinterface { WakeOnLan('00:06:55:5a:53:f3');; } eingeben.

Um auf einen Tasterdruck reagieren zu können, muss die Datei fhem.cfg ergänzt werden:
<nowiki>define HM_Taster_01.ntfy notify HM_Taster_01.* {WakeOnLan('00:17:31:fa:9b:51')}</nowiki>

WakeOnLan

2013-12-31T16:49:21Z

Snowyrain: /* OpenWRT */

WakeOnLan

2013-12-31T12:53:41Z

Snowyrain: /* OpenWRT */

Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese Pakete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhalb eines Netzwerksegments versendet werden. Das zu weckende Gerät muss Wake on Lan unterstützen und es muss (im BIOS) eingeschaltet werden.

== Ermitteln der MAC-Adresse ==

Anschließend muss die MAC-Adresse des zu weckenden Gerätes ermittelt werden.
Auf dem Gerät selber:
* Auf einem Windows-PC in einer Shell den Befehl „ipconfig /all“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „ifconfig“ eingeben
Von einem anderen Gerät
* Auf einem Windows-PC in einer Shell den Befehl „arp -a“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „arp -a“ eingeben

== OpenWRT ==

Das Wake on Lan Paket kann mit dem Programm etherwake erzeugt werden.

<nowiki>opkg update
opkg install etherwake</nowiki>

Test: In der Shell folgenden Befehl eingeben. Die MAC-Adresse muss natürlich angepasst werden.
<nowiki>etherwake 00:06:55:5a:53:f3</nowiki>
Das Gerät sollte jetzt einschalten.

Funktion in der Datei myUtils.pm erstellen.

<nowiki>######## WakeOnLan von OpenWRT ############
sub
WakeOnLan
{
my $mac = shift;
my $ret = "";
$ret .= qx(etherwake $mac);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail to $mac returned: $ret";
}</nowiki>

Test: In dem FHEM-Webinterface { WakeOnLan('00:06:55:5a:53:f3');; } eingeben.

WakeOnLan

2013-12-31T12:46:05Z

Snowyrain:

Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese Pakete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhalb eines Netzwerksegments versendet werden. Das zu weckende Gerät muss Wake on Lan unterstützen und es muss (im BIOS) eingeschaltet werden.

== Ermitteln der MAC-Adresse ==

Anschließend muss die MAC-Adresse des zu weckenden Gerätes ermittelt werden.
Auf dem Gerät selber:
* Auf einem Windows-PC in einer Shell den Befehl „ipconfig /all“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „ifconfig“ eingeben
Von einem anderen Gerät
* Auf einem Windows-PC in einer Shell den Befehl „arp -a“ eingeben
* Auf einem Linux-PC in einer Shell den Befehl „arp -a“ eingeben

== OpenWRT ==

Das Wake on Lan Paket kann mit dem Programm etherwake erzeugt werden.

<nowiki>opkg update
opkg install etherwake</nowiki>

Test:
<nowiki>etherwake 00:06:55:5a:53:f3</nowiki>
Das Gerät sollte jetzt einschalten.

Funktion in der Datei myUtils.pm erstellen.

<nowiki>######## WakeOnLan von OpenWRT ############
sub
WakeOnLan
{
my $mac = shift;
$ret .= qx(etherwake $mac);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail to $mac returned: $ret";
}</nowiki>

WakeOnLan

2013-12-31T12:38:36Z

Snowyrain: /* Ermitteln der MAC-Adresse */

WakeOnLan

2013-12-31T12:37:37Z

Snowyrain:

WakeOnLan

2013-12-31T12:36:58Z

Snowyrain: /* WakeOnLan */

Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese packete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhalb eines Netzwerksegments versendet werden. Das zu weckende Gerät muss Wake on Lan unterstützen und es muss (im BIOS) eingerichtet werden.

== Ermitteln der MAC-Adresse ==

Anschließend muss die MAC-Adresse des zu weckenden Gerätes ermittelt werden.
Auf dem Gerät selber:
- Auf einem Windows-PC in einer Shell den Befehl „ipconfig /all“ eingeben
- Auf einem Linux-PC in einer Shell den Befehl „ifconfig“ eingeben
Von einem anderen Gerät
- Auf einem Windows-PC in einer Shell den Befehl „arp -a“ eingeben
- Auf einem Linux-PC in einer Shell den Befehl „arp -a“ eingeben

== OpenWRT ==

Das Wake on Lan Paket kann mit dem Programm etherwake erzeugt werden.

<nowiki>opkg update
opkg install etherwake</nowiki>

Test:
<nowiki>etherwake 00:06:55:5a:53:f3</nowiki>
Das Gerät sollte jetzt einschalten.

WakeOnLan

2013-12-31T12:36:45Z

Snowyrain: Die Seite wurde neu angelegt: „ = WakeOnLan = Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese packete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhal…“

= WakeOnLan =

Wake on LAN läuft auf der ISO/OSI-Schicht 2. Diese packete werden i.d.R. nicht geroutet. Ein Wake on Lan Paket kann entsprechend nur innerhalb eines Netzwerksegments versendet werden. Das zu weckende Gerät muss Wake on Lan unterstützen und es muss (im BIOS) eingerichtet werden.

== Ermitteln der MAC-Adresse ==

Anschließend muss die MAC-Adresse des zu weckenden Gerätes ermittelt werden.
Auf dem Gerät selber:
- Auf einem Windows-PC in einer Shell den Befehl „ipconfig /all“ eingeben
- Auf einem Linux-PC in einer Shell den Befehl „ifconfig“ eingeben
Von einem anderen Gerät
- Auf einem Windows-PC in einer Shell den Befehl „arp -a“ eingeben
- Auf einem Linux-PC in einer Shell den Befehl „arp -a“ eingeben

== OpenWRT ==

Das Wake on Lan Paket kann mit dem Programm etherwake erzeugt werden.

<nowiki>opkg update
opkg install etherwake</nowiki>

Test:
<nowiki>etherwake 00:06:55:5a:53:f3</nowiki>
Das Gerät sollte jetzt einschalten.

OpenWRT

2013-12-30T18:42:56Z

Snowyrain: /* Netzwerk einrichten */

= Einleitung =

Hier sind zwei alternative Installationswege beschrieben.

* Im ersten Kapitel wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Das zweite Kapitel beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

Zeitzone in der Datei "/etc/config/system" einstellen

<nowiki>config system
...
option timezone 'CET-1CEST,M3.5.0,M10.5.0/3'
...</nowiki>

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN, HM-CFG-LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-digest perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gz
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

Init.d-Script aktivieren:
<nowiki>/etc/init.d/fhem start
/etc/init.d/fhem enable </nowiki>

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von /mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-27T09:57:10Z

Snowyrain: /* PERL installieren */

= Einleitung =

Hier sind zwei alternative Installationswege beschrieben.

* Im ersten Kapitel wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Das zweite Kapitel beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN, HM-CFG-LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-digest perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gz
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

Init.d-Script aktivieren:
<nowiki>/etc/init.d/fhem start
/etc/init.d/fhem enable </nowiki>

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von /mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:52:01Z

Snowyrain: /* Einleitung */

= Einleitung =

Hier sind zwei alternative Installationswege beschrieben.

* Im ersten Kapitel wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Das zweite Kapitel beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gz
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

Init.d-Script aktivieren:
<nowiki>/etc/init.d/fhem start
/etc/init.d/fhem enable </nowiki>

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von /mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:49:44Z

Snowyrain: /* Anmerkungen */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gz
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

Init.d-Script aktivieren:
<nowiki>/etc/init.d/fhem start
/etc/init.d/fhem enable </nowiki>

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von /mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:49:27Z

Snowyrain: /* Start-Script anlegen */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gz
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

Init.d-Script aktivieren:
<nowiki>/etc/init.d/fhem start
/etc/init.d/fhem enable </nowiki>

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:48:46Z

Snowyrain: /* Installation von FHEM */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gz
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

/etc/init.d/fhem start
/etc/init.d/fhem enable

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:48:19Z

Snowyrain: /* Einbinden der Partitionen per UUID */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gzls –l
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

/etc/init.d/fhem start
/etc/init.d/fhem enable

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:48:08Z

Snowyrain: /* PERL installieren */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

== Einbinden der Partitionen per UUID ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gzls –l
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

/etc/init.d/fhem start
/etc/init.d/fhem enable

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:47:25Z

Snowyrain: /* Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

----

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

== Einbinden der Partitionen per UUID ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gzls –l
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

/etc/init.d/fhem start
/etc/init.d/fhem enable

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:46:41Z

Snowyrain: /* Installation von FHEM */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

== Einbinden der Partitionen per UUID ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

== Installation von FHEM ==
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gzls –l
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

/etc/init.d/fhem start
/etc/init.d/fhem enable

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:46:22Z

Snowyrain: /* Start-Script anlegen */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

== Einbinden der Partitionen per UUID ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

= Installation von FHEM =
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gzls –l
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

touch /etc/init.d/fhem
chmod +x /etc/init.d/fhem
vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

/etc/init.d/fhem start
/etc/init.d/fhem enable

Ab jetzt sollte FHEM bei jedem Bootvorgang automatisch gestarten werden.

== Anmerkungen ==
* Es sollte sichergestellt werden, dass keine Dateien außerhalb von
/mnt/opt/ geschrieben werden.
* Die PERL-Version ist leider etwas älter (Version 5.10) an einigen Stellen muss der FHEM-Code angepasst werden. Besonders wenn mit dem „~~“ Operator gearbeitet wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:40:13Z

Snowyrain: /* Einbinden der Partitionen per UUID */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

== Einbinden der Partitionen per UUID ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

= Installation von FHEM =
Die Installation von FHEM ist an vielen Stellen sehr gut beschrieben. Hier nur die Quick&Dirty Variante:
<nowiki>cd /mnt/opt/
wget http://fhem.de/fhem-5.5.tar.gz
opkg update
opkg install tar
tar xfz fhem-5.5.tar.gzls –l
mv fhem-5.5 fhem</nowiki>

== Start-Script anlegen ==

vi /etc/init.d/fhem
<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script

START=11
STOP=15

cd /mnt/opt/fhem/

start() {
if [ -f /mnt/opt/fhem-5.5/log ]; then
mkdir -p /mnt/opt/fhem-5.5/log
fi
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}
stop(){
echo "stopping fhem"
/mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
}
restart(){
echo "restarting"
mnt/opt/fhem/fhem.pl 7072 "shutdown"
#kill -TERM $(cat /var/run/fhem.pid)
/mnt/opt/fhem/fhem.pl /mnt/opt/fhem/fhem.cfg
}</nowiki>

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:33:21Z

Snowyrain: /* Einbinden der Partitionen */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

== Einbinden der Partitionen per UUID ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

Die Konfigurations-Datei /etc/config/fstab muss angepasst werden. Zunächst sind die Mount-Punkte nicht aktiviert und das Verzeichnis für die Datenpartition muss noch angepasst werden. Die Option "uuid" muss unverändert bleiben.

vi /etc/config/fstab
<nowiki>config 'global'
...
config 'mount'
option target '/mnt/opt'
option uuid '...'
option enabled '1'
config 'swap'
option uuid '...'
option enabled '1'</nowiki>

Über einen Neustart oder "/sbin/block mount" werden die Partitionen eingebunden.

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:28:53Z

Snowyrain: /* Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

== Netzwerk einrichten ==

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

== PERL installieren ==

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno \
perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket \
perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

Für die verwendung eines USB-Sticks müssen weitere Pakete installiert werden:

<nowiki>opkg update
opkg install kmod-usb-storage block-mount kmod-fs-ext4</nowiki>

== Einbinden der Partitionen ==

Der USB-Stick benötigt eine Datenpartition, optional kann eine SWAP-Partition zusätzlich eingerichtet werden. Hierfür kann der Abschnitt „Vorbereiten des USB-Sticks“ aus dem vorherigen Kapitel verwendet werden.

Erstellen eines Verzechnisses für den FHEM-Daten-Stick

<nowiki>mkdir /mnt/opt</nowiki>

Mittels des Befehls „block “kann eine brauchbare fstab-Konfiguration erstellt werden. An dieser Stelle wird mit den eindeutigen UUIDs gearbeitet. So ist es bei dem Betrieb von mehreren Datenspeichern unerheblich in welcher Reihenfolge diese eingebunden werden. Dies kann etwas Ärger ersparen.

<nowiki>block detect > /etc/config/fstab</nowiki>

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:20:27Z

Snowyrain: /* Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB */

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
Zunächst wird OpenWRT auf den Router installiert. Auf die Installation des WEB-Interfaces „luci“ kann verzichtet werden.

Der erste Login erfolgt wie „Telnet“ (nicht SSH) auf die IP 192.168.1.1. Mittels vi kann die LAN-IP-Adresse in der Datei /etc/config/network angepasst werden.

<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...</nowiki>

Die Konfiguration wird mit dem Aufruf von "/etc/init.d/network restart" übernommen.

Perl kann wie folgt eingerichtet werden. Je nach verwendetet FHEM-Module müssen weitere PERL-Pakete installiert werden. Für MAX_LAN und ECMD reicht die folgende Auswahl:

<nowiki>opkg update
opkg install perl perl-html-parser perl-html-tagset perl-uri perl-www perlbase-autoloader perlbase-config perlbase-ctime perlbase-dynaloader perlbase-errno perlbase-essential perlbase-fcntl perlbase-file perlbase-integer perlbase-io perlbase-math perlbase-mime perlbase-posix perlbase-selectsaver perlbase-socket perlbase-symbol perlbase-tie perlbase-time perlbase-timelocal perlbase-xsloader</nowiki>

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:16:19Z

Snowyrain:

= Einleitung =
* Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.
* Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

= Alternative Installation aus den Kompilierten Quellen bei einem Speicher größer 6MB =
<nowiki>config interface 'lan'
...
option ipaddr '192.168.178.4'
option netmask '255.255.255.0'
option gateway '192.168.178.1'
option dns '192.168.178.1'
...
</nowiki>

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

OpenWRT

2013-12-25T16:10:03Z

Snowyrain:

OpenWRT

2013-12-25T16:08:45Z

Snowyrain:

= Übersicht
Im ersten Abschnitt wird beschrieben, wie Openwrt auf einem Gerät mit wenig(er) internem Speicher eingerichtet werden kann. Hier wird OpenWRT zuerst aus den Sourcen erstellt und ein Overlay für die PERL-Pakete eingerichtet.

Der zweite Abschnitt beschreibt, wie OpenWRT mit PERL im internen Speicher (6MB) installiert wird. Es werden keine Pakete selbst gebaut, sondern die Nightly-Snapshots verwendet. FHEM wird auf einem USB-Stick eingerichtet.

= Installation von FHEM incl. OpenWRT auf einem Router/Kleinstcomputer z.B. TP-LINK MR3020 =
Wer nicht unbedingt eine Fritz!Box braucht sondern einfach nur FHEM ohne laufenden PC betreiben will, kann auch OpenWRT auf einem Router nutzen, z.B. dem sehr günstigen (25 Euro März 2012) und stromsparenden (ca. 1 Watt) TP-LINK MR3020.

Bitte beachten: Es kann keine Garantie übernommen werden, dass der Router bei Befolgung dieser Anleitung "kaputt" geht, z.B. dadurch, dass er bei Fehlkonfiguration im Netz nicht mehr erreichbar ist. Der Umbau erfolgt auf eigene Gefahr.

== Vorraussetzungen ==
* Der Router (in diesem Howto ist der TP-LINK MR3020 verwendet worden, OpenWRT wird aber prinzipiell immer gleich aufgesetzt
* Ein USB Stick, da die Flash-Speicher der Router zu klein sind
* optional ein passiver USB-Hub (wenn der Router nur einen USB Port hat und ein CUL Stick betrieben werden soll)
* Ein Linux-PC zum Erstellen des Images. Dies kann auch eine virtuelle Maschine sein. Der Autor hat Ubuntu 10.11 verwendet.
== Vorbereiten des USB-Sticks ==
Auf einem USB Stick müssen zwei Partitionen angelegt werden, eine als Auslagerungsspeicher für den RAM und eine für das Dateisystem auf dem später auch Perl und FHEM installiert werden. Das geht am besten mit dem Tool <code>fdisk</code> auf dem vorbereiteten Linux-PC. Dazu den Stick anstöpseln und per Aufruf von <code>fdisk -l</code> die Lister der gefundenen "Festplatten" anzeigen lassen. Eine davon ist der USB-Stick, z.B. an seiner Größe zu erkennen (500Mb reichen locker aus). In der Ausgabe z.B. nach einer Zeile suchen, die sinngemäß so aussieht: <code>Disk /dev/sdc: 484 MB, 484442112 bytes</code>. In diesem Fall ist der USB-Stick das Gerät "/dev/sdc".

Daraufhin kann fdisk für das Gerät aufgerufen werden. Detaillierte ANleitungen für fdisk finden sich im Internet. Vereinfacht ist folgender Vorgang auszuführen (alle Daten gehen auf dem Stick verloren!).

<nowiki>fdisk /dev/sdc
o
n
p
1
1
+64M
n
p
2 (drei mal Enter drücken)
t
1
82
w</nowiki>
Danach ist der Stick partitioniert. Ein erneuter Aufruf von <code>fdisk -l</code> sollte ungefähr folgendes ERgebnis liefern:

<nowiki>Disk /dev/sdc: 484 MB, 484442112 bytes
2 heads, 63 sectors/track, 7509 cylinders
Units = cylinders of 126 * 512 = 64512 bytes
Disk identifier: 0x8c5e341e
Device Boot Start End Blocks Id System
/dev/sdc1 1 993 62527+ 82 Linux swap / Solaris
/dev/sdc2 994 7509 410508 83 Linux</nowiki>
Jetzt müssen die Partitionen noch formatiert werden. Vorsicht: Nur hier heisst der Stick /dev/sdc. Er kann auch anders heissen! Wenn ihr die falschen Namen verwendet, könntet ihr eure Festplatte löschen! /dev/sdc1 ist durch /dev/<euer-sdx>1 zu ersetzen

<nowiki>mkswap /dev/sdc1
mkfs.ext4 /dev/sdc2
sync</nowiki>
Der Stick ist nun fertig vorbereitet und wird im Linux-PC nicht mehr benötigt. Er kann jetzt in den Router

== Bauen des OpenWRT-Images ==
Um OpenWRT zu bauen, müssen die entsprechenden Werkzeuge auf dem Linux-PC installiert sein. Unter Ubuntu geht das so:

<nowiki>sudo apt-get -y install subversion build-essential</nowiki>
OpenWRT kann am besten aus dem Subversion ausgecheckt werden.

<nowiki>svn co svn://svn.openwrt.org/openwrt/trunk openwrt</nowiki>
Das Auschecken dauert eine Weile, aber das ist noch gar nichts, das Bauen dauert noch viel länger. Sobald alles runtergeladen ist, wird in das Verzeichnis gewechselt und die Konfiguration vorgenommen

<nowiki>cd openwrt
make menuconfig</nowiki>
Für die Konfiguration muss die Architektur des Routers bekannt sein. Diese kann auf der [http://www.openwrt.org OpenWRT-Seite] nachgeschlagen werden. der TP-LINK MR3020 hat eine <code>ar71xx</code>-Architektur.

Als erstes also die ARchitektur auswählen (Hier: <code>ar71xxx/ar91xxx</code>)
Zweitens kann beim Target-Profile zumeinst genau der Router ausgewählt werden (Notfalls auf der OpenWRT-Seite nachlesen)

Optional kann nun unter <code>Image-Configuration</code> bereits eine Netzwerkkonfiguration eingestellt werden, die der Router dann nach seinem Hochfahren hat. Wenn der Router in ein bestehendes Netz mit bestehenden DHCP-Server und Adressraum eingebunden wird, ist das sinnvoll. Wer das hat, weiss auch, was hier einzustellen ist. Standardmäßig ist die Adresse 192.168.1.1 vorgegeben. Die Konfiguration kann auch später jederzeit geändert werden.

Nun zu den Kernel-Modules. Hier sollte folgendes aktiviert werden (Einiges ist ggf. nicht nötig, aber so geht es). Die Einträge müssen mit "*" und nicht mit "M" selektiert sein, sonst kommen sie nicht ins Image.

* Block-Devices
** kmod-ide-core
** kmod-ide-generic
** kmod-loop (kann man immer mal brauchen)
** kmod-scsi-generic
</li><li>Filesystems
* kmod-fs-ext4 (davon wollen wir später booten, vom USB-Stick
</li><li>USB-Support
* kmod-usb-acm (für CUL)
* kmod-usb-hid
* kmod-usb-ohci
* kmod-usb-serial
* kmod-usb-serial-ftdi
* kmod-usb-storage-extras
* kmod-usb-uhci
* kmod-usb2
</li></ul>
Unter Utilities noch folgendes aktivieren

* Filesystem
** e2fsprogs
</li><li>disc
* fdisk (für Analysezwecke sinnvoll)
* swap-utils
</li></ul>
Nun kann - in aller Ruhe - alles gebaut werden durch Eingabe von

<nowiki>make</nowiki>
== Vorbereiten des Routers ==
Das ganze kann bis zu mehrere Stunden laufen. Nun ist Zeit, den Router ins Netzwerk einzubinden. Wie genau, hängt von derpersönlichen Konstellation ab. Der TP-Link MR3020 hat standardmäßig die IP-Adresse 192.168.0.254. Viele andere Router haben z.B. 192.168.0.1. Ich empfehle, das Update auf jeden Fall nicht über WLAN sondern ein Netzwerkkabel zu machen. Die meisten Router haben einen aktivierten DHCP-Server. Ein angestöpselter Windows-PC bekommt dann von ihm eine IP-Adresse zugewiesen. Beim MR3020 kann dann die Weboberfläche über [http://192.168.0.254 http://192.168.0.254] erreicht werden. (User/Passwort: admin/admin)

== Installation von OpenWRT auf dem Router ==
In der Weboberfläche des Routers gibt es irgendwo einen Menüpunkt zum Firmware-Upgrade. Beim MR3020 erreichbar unter System Tools / Firmware Upgrade. Sobald das Bauen von OpenWRT fertig ist, liegt das Image im Unterordner bin/<architektur>/. Es sollte das Image genommen werden, was den Namen des Routers sowie "squashfs" sowie "factory" im Dateinamen enthält. Dieses muss jetzt im Webinterface wie beschrieben ausgewählt werden und hochgeladen werden. Alle Bestätigungsmeldungen und "Wollen-Sie-Das-auch-Wirklich"-Fragen natürlich bestätigen.

Nach einer Weile sollte dann der Router unter 192.168.1.1 anpingbar sein (von Linux aus: <code>ping 192.168.1.1</code>) bzw. unter der in der Image Configuration eingestellten IP. Wenn das nicht geht, kann man den Router auch ein 2. mal starten, da sollte man dann aber nach dem Flashen mal 10 Minuten Geduld haben (also Stecker raus/rein). Auf keinen Fall zu früh machen, dann könnte es sein, dass er gar nicht mehr hochfährt!

Zunächst muss man sich nun per telnet verbinden.

<nowiki>telnet 192.168.1.1</nowiki>
Nun ist man schon im OpenWRT eingeloggt. Das erste und einzige, was in diesem Login nun gemacht wird, ist, per

<nowiki>passwd</nowiki>
ein Passwort zu setzen. Danach kann man sich mit

<nowiki>exit</nowiki>
ausloggen. Nun kann man per SSH eine Verbindung herstellen, da ja jetzt ein Passwort gesetzt ist

<nowiki>ssh 192.168.1.1</nowiki>
Für den weiteren Verlauf ist es notwendig, dass der Router Internetzugang hat. Dazu muss man ggf. von Hand in der Datei <code>/etc/config/network</code> die Netzwerkeinstellungen entsprechend anpassen.

<nowiki>vi /etc/config/network</nowiki>
Zur Bedienung von vi z.B. [http://wiki.openwrt.org/doc/uci/network hier]

Wichtig ist die IP-Adresse, die Netzmaske, das Gateway und der DNS-Server. Bitte genau auf Tippfehler achten. Bei einer fehlenden Konfiguration ist der Router nicht mehr erreichbar. Nach abspeichern kann die neue Konfiguration aktiviert werden

<nowiki>/etc/init.d/network restart</nowiki>
Falls sich auch die IP-Adresse geändert hat, mit ssh wie oben neu anmelden. Als nächstes soll der USB-Stick eingebunden werden, dazu sind einige Pakete zu installieren. OpenWRT hat einen eingebauten Paketmanager zur Nachinstallation von Software direkt aus dem Netz. Zunächst wird nur das installiert, was in den internen Speicher des Routers muss. Das Root-Dateisystem soll anschließend durch den USB-Stick erweitert werden, um dann dorthin die meiste Software zu installieren. Viele Details hierzu finden sich [http://wiki.openwrt.org/doc/howto/extroot hier]

<nowiki>opkg update
opkg install block-mount</nowiki>
Bei einem Aufruf von

<nowiki>fdisk -l</nowiki>
sollte der an dem Router angeschlossene Stick bereits zu sehen sein (analog zu oben). Hiermit lässt sich dann auch rausfinden, wie das Gerät auf dem Router heisst. In den meisten Fällen dürfte dies <code>/dev/sda</code> sein. In diesem Fall können wir nun das Dateisystem einbinden und dann die Dateien aus dem internen Speicher dorthin kopieren.

<nowiki>mkdir /mnt/sda2
mount /dev/sda2 /mnt/sda2
tar -C /overlay -cvf - . | tar -C /mnt/sda2 -xf -</nowiki>
Nun kann auch schon die Konfiguration so umgestellt werden, dass beim nächsten Neustart der USB-Stick mit ins Root-Filesystem eingebunden wird. Dazu ist die Konfigurationsdatei <code>/etc/config/fstab</code> zu editieren.

<nowiki>vi /etc/config/fstab</nowiki>
Diese sollte danach ungefähr so aussehen, wobei das von Router zu Router abweichen kann. Der automatische Block für "home" kann bearbeitet werden und der Spap-Block ebenfalls auf (hier) /dev/sda1 angepasst werden

<nowiki>config global automount
option from_fstab 1
option anon_mount 1
config global autoswap
option from_fstab 1
option anon_swap 1
config mount
option target /overlay
option device /dev/sda2
option fstype ext4
option options rw,sync
option enabled 1
option enabled_fsck 1
config swap
option device /dev/sda1
option enabled 1</nowiki>
Nun kann die Konfiguration aktiviert und die Box mit eingestecktem Stick neu gestartet werden

<nowiki>/etc/init.d/fstab enable
reboot</nowiki>
Nun sollte überprüft werden, ob der Stick richtig eingebunden ist

<nowiki>df -h</nowiki>
Die Ausgabe sollte sinngemäß folgende Zeilen enthalten

<nowiki>/dev/sda2 397.7M 19.8M 357.9M 5% /overlay
overlayfs:/overlay 397.7M 19.8M 357.9M 5% /</nowiki>
Ist dies nicht der Fall, kann auf der OpenWRT Seite nach Troubleshooting-Möglichkeiten gesucht werden und dann hier fortgesetzt werden.
Nachdem nun der Stick erfolgreiche eingebunden werden, können die ganzen Pakete installiert werden, die zum Betrieb von FHEM notwendig sind. Da dies eine Vielzahl der perlbase-Pakete ist, sind hier schlichtweg alle verfügbaren perl-Pakete installiert worden. Ebenfalls einige andere nützliche Werkzeuge. Speichermäßig ist das auf dem USB-Stick nicht entscheidend.

<nowiki>opkg update
opkg install usbutils luci ntpclient uhttpd perl perl-compress-bzip2 perl-dbi perl-html-parser perl-html-tagset perl-html-tree perl-lockfile-simple \
perl-net-telnet perl-uri perl-www perl-www-curl perl-www-mechanize perlbase-abbrev perlbase-anydbm-file perlbase-archive perlbase-assert perlbase-attribute \
perlbase-attributes perlbase-attrs perlbase-autoloader perlbase-autosplit perlbase-autouse perlbase-b perlbase-base perlbase-benchmark perlbase-bigfloat \
perlbase-bigint perlbase-bignum perlbase-bigrat perlbase-blib perlbase-bytes perlbase-cacheout perlbase-cgi perlbase-charnames perlbase-class \
perlbase-complete perlbase-compress perlbase-config perlbase-cpan perlbase-cpanplus perlbase-ctime perlbase-cwd perlbase-data perlbase-db \
perlbase-db-file perlbase-dbm-filter perlbase-devel perlbase-diagnostics perlbase-digest perlbase-dirhandle perlbase-dotsh perlbase-dumpvalue \
perlbase-dumpvar perlbase-dynaloader perlbase-encode perlbase-encoding perlbase-english perlbase-env perlbase-errno perlbase-essential perlbase-exceptions \
perlbase-extutils perlbase-fastcwd perlbase-fatal perlbase-fcntl perlbase-feature perlbase-fields perlbase-file perlbase-filecache perlbase-filehandle \
perlbase-filetest perlbase-filter perlbase-find perlbase-findbin perlbase-finddepth perlbase-flush perlbase-gdbm-file perlbase-getcwd perlbase-getopt \
perlbase-getoptpl perlbase-hash perlbase-hostname perlbase-i18n perlbase-if perlbase-importenv perlbase-integer perlbase-io perlbase-ipc perlbase-less \
perlbase-list perlbase-locale perlbase-log perlbase-look perlbase-math perlbase-memoize perlbase-mime perlbase-module perlbase-mro perlbase-net \
perlbase-next perlbase-o perlbase-object perlbase-opcode perlbase-open perlbase-ops perlbase-package perlbase-params perlbase-perl5db perlbase-perlio \
perlbase-pod perlbase-posix perlbase-pwd perlbase-re perlbase-safe perlbase-scalar perlbase-sdbm-file perlbase-search perlbase-selectsaver \
perlbase-selfloader perlbase-shell perlbase-shellwords perlbase-sigtrap perlbase-socket perlbase-sort perlbase-stat perlbase-storable perlbase-switch \
perlbase-symbol perlbase-sys perlbase-syslog perlbase-tainted perlbase-term perlbase-termcap perlbase-test perlbase-text perlbase-thread perlbase-threads \
perlbase-tie perlbase-time perlbase-unicode perlbase-unicore perlbase-user perlbase-xsloader</nowiki>
Das Webinterface "Luci" ist mitinstalliert worden und bietet komfortable Einstellmöglichkeiten für den Router allgemein. Nach einem

<nowiki>/etc/init.d/uhttpd enable
/etc/init.d/uhttpd start</nowiki>
ist es unter <code>[http://192.168.1.1/ http://192.168.1.1/]</code> bzw. der entsprechenden Router-IP erreichbar. Wichtig ist es ggf. den DHCP-Server zu deaktivieren. Die meisten Router können auch als WLAN-Clients konfiguriert werden, sie brauchen also nicht zwangsweise ein Netzwerkkabel. All dies geht über die Weboberfläche.
Nun kann FHEM auf den Router/Stick kopiert werden. In diesem Beispiel benutzen wir das SVN-Repository

<nowiki>opkg install subversion-client make libelf
mkdir /usr/src
cd /usr/src
svn co https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem
cd fhem
make install-pgm2</nowiki>
Die Bearbeitung der <code>/etc/fhem.cfg</code> ist nun so durchzuführen, wie bei jeder anderen FHEM-Installation auch. Wenn ein CUL-Stock am Router verwendet werden soll, dann geht dies über den Umweg ser2net, da das Device::Serial - CPAN Modul für OpenWRT nicht standardmäßig zur Verfügung steht

<nowiki>opkg install ser2net
vi /etc/ser2net.conf</nowiki>
In der Datei kann alles gelöscht werden und dann genau diese Zeile eingefügt werden:

<nowiki>27073:raw:300:/dev/ttyACM0:115200 NONE 1STOPBIT 7DATABITS</nowiki>
In der fhem.cfg ist die Definition des CUL-Sticks dann folgendermaßen:

<nowiki>define MyCUL CUL 127.0.0.1:27073 3333</nowiki>
Wenn man CUL doch per Device::Serial ansprechen oder andere FHEM Module verwenden will, die auf Device::Serial angewiesen sind, kann man das entsprechende OpenWRT Paket auch selber erstellen.
Hinweise dazu gibt es [http://tcb.udarknet.com/dokuwiki/doku.php/projects/securouter/openwrt hier].

Nun muss nur noch der Autostart von ser2net und fhem eingebaut werden und die integrierte, stromsparende FHEM-Kiste ist fertig.

<nowiki>vi /etc/init.d/ser2net</nowiki>
mit folgendem Inhalt

<nowiki>#!/bin/sh /etc/rc.common
# Ser2Net Init Script
START=10
STOP=15
start() {
ser2net
}
stop(){
killall ser2net
}</nowiki>
Danach Ser2Net aktivieren und starten:

<nowiki>chmod +x /etc/init.d/ser2net
/etc/init.d/ser2net enable
/etc/init.d/ser2net start</nowiki>
Nun noch die Konfiguration für fhem selbst

<nowiki>#!/bin/sh /etc/rc.common
# FHEM Init Script
START=11
STOP=15
start() {
/usr/bin/fhem.pl /etc/fhem.cfg
}
stop(){
echo "shutdown" | nc localhost 7072
}</nowiki>
Und auch hier aktivieren:

<nowiki>chmod +x /etc/init.d/fhem
/etc/init.d/fhem enable
/etc/init.d/fhem start</nowiki>
Da das ständige Schreiben 1. langsam und 2. den meisten USB-Sticks nicht gut tut, sollten die Logfiles ins RAM geschrieben werden, also ein Pfad unterhalb von <code>/tmp</code>. Der Speicher ist allerdings begrenzt. Je nach persönlichen Anforderungen muss dann regelmäßig das Log aus dem Speicher gelöscht oder archiviert werden. Z.b. wöchentlich auf den USB Stick oder auf Netzlaufwerke etc. Dies ist mit dem FileLog von alleine möglich -> [http://fhem.de/commandref.html#archivecmd].

[[Kategorie:HOWTOS]]
[[Kategorie:Glossary]]

E-Mail senden

2013-12-24T15:21:36Z

Snowyrain:

Um aus FHEM heraus '''E-Mail senden''' zu können, sind abhängig von der verwendeten Platform unterschiedliche Vorgehensweisen erforderlich.

== Linux ==
=== FritzBox 7170 (non-chroot) ===
Datei 99_email.pm im Modul-Verzeichnis mit folgender Funktion anlegen (oder in bestehende 99_irgendwas.pm kopieren):

<nowiki>sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" | /usr/bin/mail send -i - -s \"$subject\" -t \"$rcpt\"");
}</nowiki>
Aufruf dann mittels
:<code>{ fb_mail('empfaenger@@mail.de','Subject','text 123') }</code>

=== Fritz!Box 7390 ===
Auf der [[AVM Fritz!Box|FritzBox 7390]] ist diese Funktion seit 10/2012 Bestandteil der Fhem Standardauslieferung. Sie ist untergebracht in FritzBoxUtils.pm und heisst dort FB_mail($$$) (Groß-Kleinschreibung beachten).

Da der Dateiname von FritzBoxUtils.pm nicht mit 99_ beginnt, wird diese Programmdatei nicht automatisch beim Start von Fhem geladen. Fhem muss zum Laden dieser Programmdatei aufgefordert werden. Dazu (z. B. in 99_myUtils.pm) die Zeile ''use FritzBoxUtils;'' einfügen.

Mit dem Install von AVM.de wird fhem in einer chroot-Umgebung ausgeführt, die den Zugriff auf die Mailfunktion der Fritzbox nicht zulässt. Daher muss Fhem in der [http://fhem.de/fhem.html#Download Version von fhem.de] installiert sein. Sollte Ihre Fritzbox bisher mit dem install von AVM laufen, kann (nach einem backup!) das image von fhem.de einfach drüberinstalliert werden. Es sollten dabei alle Einstellungen erhalten bleiben.

<nowiki>sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" > /var/tmp/fhem_nachricht.txt");
system("/sbin/mailer send -i '/var/tmp/fhem_nachricht.txt' -s \"$subject\" -t \"$rcpt\"");
system("rm /var/tmp/fhem_nachricht.txt");
}</nowiki>

Aufruf dann mittels
:<code>{ fb_mail('empfaenger@mail.de','Subject','text 123') }</code>
bzw.
:<code>{ FB_mail('empfaenger@mail.de','Subject','text 123') }</code>

'''Hinweis:''' Wenn der Aufruf der Mailfunktion aus einem notify oder at erfolgt, muss das @@ in der Adresse des Mailempfängers verdoppelt werden, da ein einfaches @ sonst durch den Namen des getriggerten Devices ersetzt würde. Bei Verwendung in der fhem-Kommandozeile oder einem eigenen *Utils.pm ist diese Doppelung nicht erforderlich. Bitte bei den ersten Mails ins Log schauen, ob die Mailadresse wie gewünscht verwendet wird.

Dem Mailer können noch weitere Parameter hinzugefügt werden. Mehr dazu siehe: [http://www.wehavemorefun.de/fritzbox/Mailer Mailer]

=== OpenWRT ===
Die Anleitung wurde mit einer frühen Beta von Barrier Breaker (r391xx) mit einem TP_Lind WDR 4900 getestet. Da "sendEmail" nicht als Package vorliegt wird in dieser Anleitung "ssmtp" verwendet.
Die Installation erfolgt mittels:

<pre>
opkg update
opkg install ssmtp_2.64-4_mpc85xx.ipk
</pre>

Hierbei werden die Packete libopenssl und zlib mit installiert. Damit ssmtp funktioniert müssen die Dateien /etc/ssmtp/ssmtp.conf und /etc/ssmtp/revaliases angepasst werden.

/etc/ssmtp/ssmtp.conf
<nowiki>root=arnold@gmx.net
mailhub=mail.gmx.net:465
rewriteDomain=gmx.net
hostname=gmx.net
FromLineOverride=YES
UseTLS=YES
#UseSTARTTLS=YES
AuthUser=arnold@gmx.net
AuthPass=Passwort_von_arnold@gmx.net
</nowiki>

/etc/ssmtp/revaliases
<nowiki>
root:arnold@gmx.net:mail.gmx.net:465</nowiki>

In der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen (von der RPi-Anleitung übernommen):

<nowiki>sub
OpenWRTMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $ret = "";
my $sender = "dockstar\@heye-tammo.de";
Log 1, "sendEmail RCP: $rcpt, Subject: $subject, Text: $text";
$ret .= qx(echo -e 'to:$rcpt\n from:$sender\nsubject:$subject\n$text\n' | ssmtp $rcpt);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}</nowiki>

Ab hier den entsprechenden Abschnitt unter "Raspberry Pi" lesen.

=== Synology DiskStation ===
Beim DSM 3.2 gab es keinen <code>sendmail</code>-Befehl, sondern nur eine Funktion für den Versand der System-Benachrichtigungen. Interessanterweise funktionierte aber der <code>php-mail</code>-Befehl, so dass man mittels folgendem Modul Mails frei versenden kann:

<nowiki>sub sendmail($$$) {
my($empf, $subj, $nachricht) = @_;
system("php -r 'mail(\"$empf\",\"$subj\",\"$nachricht\");'");
undef;
}</nowiki>

=== Raspberry Pi ===
In der weezy-Version, wie sie von busware zur Verfügung gestellt wird, muss auf einem [[Raspberry Pi]] noch sendEmail nachinstalliert werden:

<pre>
sudo apt-get update
sudo apt-get install sendEmail
</pre>

in der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen:

<nowiki>######## DebianMail Mail auf dem RPi versenden ############
sub
DebianMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $ret = "";
my $sender = "absender\@account.de";
my $konto = "kontoname\@account.de";
my $passwrd = "passwrd";
my $provider = "smtp.provider.de";
Log 1, "sendEmail RCP: $rcpt";
Log 1, "sendEmail Subject: $subject";
Log 1, "sendEmail Text: $text";

$ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -s '$provider' -xu '$konto' -xp '$passwrd' -o tls=no);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}</nowiki>

Beim Aufruf der Funktion gibt es zwei unterschiedliche Verhaltensweisen zu beachten. Wird DebianMail durch ein Fhem-Ereignis als Makro mit "Transferzeichen", wie @ oder % aufgerufen, so sind diese innerhalb des Aufrufs von DebianMail zu maskieren.

Siehe auch commandref:
* The character @ will be replaced with the device name. To use @ in the text itself, use the double mode (@@).
* The macro %<parameter> will expand to the current value of the named parameter. This can be either a parameter from the device definition or a parameter from the set or get command.

Beispiel:

<nowiki>define Sonstiges notify Fenster:Window:.*,.*Low.Batt*. {\
DebianMail('email@@email.domain','Subject','Text');;\
}</nowiki>

in allen anderen Fällen muss die Maskierung entfallen:

Beispiel:

<nowiki>define Sonstiges at *01:00:00 {\
DebianMail('email@email.domain','Subject','Text');;\
}</nowiki>

=== BeagleBoard-xM ===
Auf einem [[:Kategorie:BeagleBoard-xM|BeagleBoard-xM]] mit einem [http://en.opensuse.org/HCL:BeagleBoard-xM OpenSUSE 12.2] kann man ebenfalls das Perl-Programm ''sendEmail'' wie beim RPi nutzen. Dies gibt es aber nicht in den Repositories von openSUSE, sondern man muss sich ''sendEmail'' als Source herunterladen. Das geht am einfachsten per ''wget'', welches man ebenfalls erst installieren muss (aber aus einem Repository).

<nowiki>$ zypper in wget
$ cd /opt
$ wget http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v1.56.tar.gz
$ tar xvfz sendEmail-v1.56.tar.gz
$ cd sendEmail-v1.56
$ cp sendMail /usr/local/bin</nowiki>
Dann geht man weiter vor wie unter RPi beschrieben (anlegen der SUB-Routine in 99_myUtils usw.).

'''Hinweis:''' Die Version 1.56 von ''sendEmail'' ist Stand Januar 2013 die aktuelle. Da diese Programmversion von 2009 stammt, ist mit neuen Versionen selten zu rechnen. Vielleicht schauen Sie trotzdem vorher auf der [http://caspian.dotconf.net/menu/Software/SendEmail/ Homepage von sendEmail] nach.

== Windows ==
# Kopiere die Datei sendEmail.exe* in Dein FHEM Verzeichnis (hier c:\fhem-5.0\); Quelle: [http://caspian.dotconf.net/menu/Software/SendEmail/ http://caspian.dotconf.net/menu/Software/SendEmail/]
# Erstelle im FHEM Verzeichnis die Datei wmail.bat mit folgendem Inhalt (eine Zeile): <code>sendEmail -f absender@domain.de -u "%1" -m " " -s SMTP-SERVERAdresse -xu SMTP_USERNAME -xp SMTP_PASSWORT -t empfänger@domain.de -o message-header="X-Message-Flag: FHEM"</code>
# Beispiel fhem.cfg
## Mail wenn sich der Status von Heizung.* oder Hzg.* ändert <code>define Mail_Heizung notify Heizung.*|Hzg.* { system("wmail @:%")}</code>
## Mail bei Signal Aussentemperatur (für dieses Beispiel wird [http://fhem.de/commandref.html#getstate http://fhem.de/commandref.html#getstate getstate] benötigt) <code>define Mail_Aussentemperatur notify Aussentemperatur {\</code> <code>my ($val);;\</code> <code>$val = fhem "getstate @";;\</code> <code>system("wmail \"@: $val\"");;\</code> <code>}</code>

== Probleme ==
=== sendEmail ===
Falls man keine E-Mails verschicken kann, kann man in einem ersten Test prüfen, ob sendEmail als solches funktioniert und die Konfiguration (Benutzer, Passwort, Server-Name usw.) des Mail-Kontos, über das die Mails abgesetzt werden sollen, richtig ist.

Hierzu setzt man in der FHEM-Befehlszeile die folgende Anweisung ab:
:<code>{ SUB-Routinen-Name('EMailAdresse@Mail.Domain','Test','Test-Text');; }</code>
und ersetzt ''SUB-Routinen-Name'' durch den Namen der in 99_myUtils erzeugten Prozedur. Statt ''EMailAdresse@Mail.Domain'' trägt man noch eine gültige E-Mail-Adresse ein und bestätigt den Befehl dann mittels <Enter> (nicht "save"). Empfangen Sie nicht kurzfristig eine entsprechende E-Mail, ist sehr wahrscheinlich an den Zugangsdaten etwas verkehrt.

Vor dem testen der Routine oben kann sendEmail auch über die Konsole (z. B. via Putty) getestet werden:
:<code>sendEmail -f 'fhemsystem@meinedomain.tld' -t 'ich@meinedomain.tld' -u 'subject' -m 'body' -s 'meinmailserver.meinedomain.de' -xu 'fhemmailer' -xp 'geheimespassword' -o tls=no</code>

== Email laut Log gesendet aber nicht angekommen? ==
Dann bitte in der Fritzbox Oberfläche überpüfen, ob unter "System" -> "Push Service" selbiger eingerichtet und aktiviert wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:FritzBox]]
[[Kategorie:BeagleBoard-xM]]
[[Kategorie:Raspberry Pi]]

E-Mail senden

2013-12-24T15:17:38Z

Snowyrain:

Um aus FHEM heraus '''E-Mail senden''' zu können, sind abhängig von der verwendeten Platform unterschiedliche Vorgehensweisen erforderlich.

== Linux ==
=== FritzBox 7170 (non-chroot) ===
Datei 99_email.pm im Modul-Verzeichnis mit folgender Funktion anlegen (oder in bestehende 99_irgendwas.pm kopieren):

<nowiki>sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" | /usr/bin/mail send -i - -s \"$subject\" -t \"$rcpt\"");
}</nowiki>
Aufruf dann mittels
:<code>{ fb_mail('empfaenger@@mail.de','Subject','text 123') }</code>

=== Fritz!Box 7390 ===
Auf der [[AVM Fritz!Box|FritzBox 7390]] ist diese Funktion seit 10/2012 Bestandteil der Fhem Standardauslieferung. Sie ist untergebracht in FritzBoxUtils.pm und heisst dort FB_mail($$$) (Groß-Kleinschreibung beachten).

Da der Dateiname von FritzBoxUtils.pm nicht mit 99_ beginnt, wird diese Programmdatei nicht automatisch beim Start von Fhem geladen. Fhem muss zum Laden dieser Programmdatei aufgefordert werden. Dazu (z. B. in 99_myUtils.pm) die Zeile ''use FritzBoxUtils;'' einfügen.

Mit dem Install von AVM.de wird fhem in einer chroot-Umgebung ausgeführt, die den Zugriff auf die Mailfunktion der Fritzbox nicht zulässt. Daher muss Fhem in der [http://fhem.de/fhem.html#Download Version von fhem.de] installiert sein. Sollte Ihre Fritzbox bisher mit dem install von AVM laufen, kann (nach einem backup!) das image von fhem.de einfach drüberinstalliert werden. Es sollten dabei alle Einstellungen erhalten bleiben.

<nowiki>sub fb_mail {
my $rcpt = $_[0];
my $subject = $_[1];
my $text = $_[2];
system("/bin/echo \"$text\" > /var/tmp/fhem_nachricht.txt");
system("/sbin/mailer send -i '/var/tmp/fhem_nachricht.txt' -s \"$subject\" -t \"$rcpt\"");
system("rm /var/tmp/fhem_nachricht.txt");
}</nowiki>

Aufruf dann mittels
:<code>{ fb_mail('empfaenger@mail.de','Subject','text 123') }</code>
bzw.
:<code>{ FB_mail('empfaenger@mail.de','Subject','text 123') }</code>

'''Hinweis:''' Wenn der Aufruf der Mailfunktion aus einem notify oder at erfolgt, muss das @@ in der Adresse des Mailempfängers verdoppelt werden, da ein einfaches @ sonst durch den Namen des getriggerten Devices ersetzt würde. Bei Verwendung in der fhem-Kommandozeile oder einem eigenen *Utils.pm ist diese Doppelung nicht erforderlich. Bitte bei den ersten Mails ins Log schauen, ob die Mailadresse wie gewünscht verwendet wird.

Dem Mailer können noch weitere Parameter hinzugefügt werden. Mehr dazu siehe: [http://www.wehavemorefun.de/fritzbox/Mailer Mailer]

=== OpenWRT ===
Die Anleitung wurde mit einer frühen Beta von Barrier Breaker (r391xx) mit einem TP_Lind WDR 4900 getestet. Da "sendEmail" nicht als Package vorliegt wird in dieser Anleitung "ssmtp" verwendet.
Die Installation erfolgt mittels:

<pre>
opkg update
opkg install ssmtp_2.64-4_mpc85xx.ipk
</pre>

Hierbei werden die Packete libopenssl und zlib mit installiert. Damit ssmtp funktioniert müssen die Dateien /etc/ssmtp/ssmtp.conf und /etc/ssmtp/revaliases angepasst werden.

/etc/ssmtp/ssmtp.conf
<nowiki>root=arnold@gmx.net
mailhub=mail.gmx.net:465
rewriteDomain=gmx.net
hostname=gmx.net
FromLineOverride=YES
UseTLS=YES
#UseSTARTTLS=YES
AuthUser=arnold@gmx.net
AuthPass=Passwort_von_arnold@gmx.net
</nowiki>

/etc/ssmtp/revaliases
<nowiki>
root:arnold@gmx.net:mail.gmx.net:465</nowiki>

In der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen (von der RPi-Anleitung übernommen):

<nowiki>sub
OpenWRTMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $ret = "";
my $sender = "dockstar\@heye-tammo.de";
Log 1, "sendEmail RCP: $rcpt, Subject: $subject, Text: $text";
$ret .= qx(echo -e 'to:$rcpt\n from:$sender\nsubject:$subject\n$text\n' | ssmtp $rcpt);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}</nowiki>

=== Synology DiskStation ===
Beim DSM 3.2 gab es keinen <code>sendmail</code>-Befehl, sondern nur eine Funktion für den Versand der System-Benachrichtigungen. Interessanterweise funktionierte aber der <code>php-mail</code>-Befehl, so dass man mittels folgendem Modul Mails frei versenden kann:

<nowiki>sub sendmail($$$) {
my($empf, $subj, $nachricht) = @_;
system("php -r 'mail(\"$empf\",\"$subj\",\"$nachricht\");'");
undef;
}</nowiki>

=== Raspberry Pi ===
In der weezy-Version, wie sie von busware zur Verfügung gestellt wird, muss auf einem [[Raspberry Pi]] noch sendEmail nachinstalliert werden:

<pre>
sudo apt-get update
sudo apt-get install sendEmail
</pre>

in der [[99_myUtils_anlegen|99_myUtils]] folgende Unterroutine einfügen:

<nowiki>######## DebianMail Mail auf dem RPi versenden ############
sub
DebianMail
{
my $rcpt = shift;
my $subject = shift;
my $text = shift;
my $ret = "";
my $sender = "absender\@account.de";
my $konto = "kontoname\@account.de";
my $passwrd = "passwrd";
my $provider = "smtp.provider.de";
Log 1, "sendEmail RCP: $rcpt";
Log 1, "sendEmail Subject: $subject";
Log 1, "sendEmail Text: $text";

$ret .= qx(sendEmail -f '$sender' -t '$rcpt' -u '$subject' -m '$text' -s '$provider' -xu '$konto' -xp '$passwrd' -o tls=no);
$ret =~ s,[\r\n]*,,g; # remove CR from return-string
Log 1, "sendEmail returned: $ret";
}</nowiki>

Beim Aufruf der Funktion gibt es zwei unterschiedliche Verhaltensweisen zu beachten. Wird DebianMail durch ein Fhem-Ereignis als Makro mit "Transferzeichen", wie @ oder % aufgerufen, so sind diese innerhalb des Aufrufs von DebianMail zu maskieren.

Siehe auch commandref:
* The character @ will be replaced with the device name. To use @ in the text itself, use the double mode (@@).
* The macro %<parameter> will expand to the current value of the named parameter. This can be either a parameter from the device definition or a parameter from the set or get command.

Beispiel:

<nowiki>define Sonstiges notify Fenster:Window:.*,.*Low.Batt*. {\
DebianMail('email@@email.domain','Subject','Text');;\
}</nowiki>

in allen anderen Fällen muss die Maskierung entfallen:

Beispiel:

<nowiki>define Sonstiges at *01:00:00 {\
DebianMail('email@email.domain','Subject','Text');;\
}</nowiki>

=== BeagleBoard-xM ===
Auf einem [[:Kategorie:BeagleBoard-xM|BeagleBoard-xM]] mit einem [http://en.opensuse.org/HCL:BeagleBoard-xM OpenSUSE 12.2] kann man ebenfalls das Perl-Programm ''sendEmail'' wie beim RPi nutzen. Dies gibt es aber nicht in den Repositories von openSUSE, sondern man muss sich ''sendEmail'' als Source herunterladen. Das geht am einfachsten per ''wget'', welches man ebenfalls erst installieren muss (aber aus einem Repository).

<nowiki>$ zypper in wget
$ cd /opt
$ wget http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v1.56.tar.gz
$ tar xvfz sendEmail-v1.56.tar.gz
$ cd sendEmail-v1.56
$ cp sendMail /usr/local/bin</nowiki>
Dann geht man weiter vor wie unter RPi beschrieben (anlegen der SUB-Routine in 99_myUtils usw.).

'''Hinweis:''' Die Version 1.56 von ''sendEmail'' ist Stand Januar 2013 die aktuelle. Da diese Programmversion von 2009 stammt, ist mit neuen Versionen selten zu rechnen. Vielleicht schauen Sie trotzdem vorher auf der [http://caspian.dotconf.net/menu/Software/SendEmail/ Homepage von sendEmail] nach.

== Windows ==
# Kopiere die Datei sendEmail.exe* in Dein FHEM Verzeichnis (hier c:\fhem-5.0\); Quelle: [http://caspian.dotconf.net/menu/Software/SendEmail/ http://caspian.dotconf.net/menu/Software/SendEmail/]
# Erstelle im FHEM Verzeichnis die Datei wmail.bat mit folgendem Inhalt (eine Zeile): <code>sendEmail -f absender@domain.de -u "%1" -m " " -s SMTP-SERVERAdresse -xu SMTP_USERNAME -xp SMTP_PASSWORT -t empfänger@domain.de -o message-header="X-Message-Flag: FHEM"</code>
# Beispiel fhem.cfg
## Mail wenn sich der Status von Heizung.* oder Hzg.* ändert <code>define Mail_Heizung notify Heizung.*|Hzg.* { system("wmail @:%")}</code>
## Mail bei Signal Aussentemperatur (für dieses Beispiel wird [http://fhem.de/commandref.html#getstate http://fhem.de/commandref.html#getstate getstate] benötigt) <code>define Mail_Aussentemperatur notify Aussentemperatur {\</code> <code>my ($val);;\</code> <code>$val = fhem "getstate @";;\</code> <code>system("wmail \"@: $val\"");;\</code> <code>}</code>

== Probleme ==
=== sendEmail ===
Falls man keine E-Mails verschicken kann, kann man in einem ersten Test prüfen, ob sendEmail als solches funktioniert und die Konfiguration (Benutzer, Passwort, Server-Name usw.) des Mail-Kontos, über das die Mails abgesetzt werden sollen, richtig ist.

Hierzu setzt man in der FHEM-Befehlszeile die folgende Anweisung ab:
:<code>{ SUB-Routinen-Name('EMailAdresse@Mail.Domain','Test','Test-Text');; }</code>
und ersetzt ''SUB-Routinen-Name'' durch den Namen der in 99_myUtils erzeugten Prozedur. Statt ''EMailAdresse@Mail.Domain'' trägt man noch eine gültige E-Mail-Adresse ein und bestätigt den Befehl dann mittels <Enter> (nicht "save"). Empfangen Sie nicht kurzfristig eine entsprechende E-Mail, ist sehr wahrscheinlich an den Zugangsdaten etwas verkehrt.

Vor dem testen der Routine oben kann sendEmail auch über die Konsole (z. B. via Putty) getestet werden:
:<code>sendEmail -f 'fhemsystem@meinedomain.tld' -t 'ich@meinedomain.tld' -u 'subject' -m 'body' -s 'meinmailserver.meinedomain.de' -xu 'fhemmailer' -xp 'geheimespassword' -o tls=no</code>

== Email laut Log gesendet aber nicht angekommen? ==
Dann bitte in der Fritzbox Oberfläche überpüfen, ob unter "System" -> "Push Service" selbiger eingerichtet und aktiviert wurde.

[[Kategorie:HOWTOS]]
[[Kategorie:FritzBox]]
[[Kategorie:BeagleBoard-xM]]
[[Kategorie:Raspberry Pi]]

Junkers Therme Stetigregelung

2013-07-05T10:34:13Z

Snowyrain: /* Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich) */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

==Ethersex==

Die Firmware der AVR-NET-IO-Boards wird durch eine erweiterte Firmware ausgetauscht.

Der Vorgang ist hier beschrieben: [[AVR-NET-IO#Konfiguration_und_Flashen_von_ethersex]]

===Ethersex-Bauen===
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

===Ethersex-Flashen===
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto). Nicht vergessen die Fuses zu setzten.

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

==Integration in FHEM==

In FHEM muss das Setzen der Sollwerte und die Erfassung der aktuellen Sollwerte/Istwerte integriert werden. Wenn der alt Raumtemperaturregler entfällt kann zweites auch entfallen.

===Setzen der Sollwerte===

Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den DAC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINDAC ECMDDevice LTC1257
attr MEINDAC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINDAC setDacValue ".$dacValue);;\
</nowiki>

===Ermitteln der Istwerte===

Der ADC ermittelt den aktuellen Sollwert über einen Spannungsteiler. Dieser Wert wird in einen Prozentwert (0-100) umgerechnet. Hierfür wird eine classdef Datei (adc.classdef)erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
set setDacValue postproc {\
Log 3, "Setze Wert";;\
}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der ADC als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/adc.classdef
</nowiki>

Anschließend den ADC als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

==Möglichkeiten==

Ein Bild sagt mehr als tausend Worte
[[File:ScreenshotFHEMTherme.png|center|thumb|alt=Screenshot FHEM Therme]]

==Kritische Nachbetrachtung==
<ul>
<li>Anschluss der Zusatzplatine nicht über die SUB-D Anschlussplatine sondern über den 10poligen Pfostenstecker. Das würde viel sauberer/professioneller aussehen und ist bei dem verwendeten Platinentyp sehr einfach zu relaisieren.</li>
<li>Spannungsversorgung des AVR-NET-IO-Boards über die 24V Spannung der Therme (irgendwie cooler)</li>
<li>Eventuell ist es auch bei diesen Junkersthermen sinnvoller die Steuerspannung mittels eines Relais/Transistors zwischen 3-22V zu schalten. Unter Verwendung von 2 Relais/Transistoren wären auch 4 Schaltstufen möglich (0%, 25%, 50% und 100%). </li>
<li>Die Zusatzplatine trennt das AVR-NET-IO-Board/Netzwerk und die Heizung nicht. Wenn keine Messung der Steuersignalspannung gewünscht ist, würde ich den LTC1257 galvanisch trennen. Bislang gab es aber keine Probleme diesbezüglich. </li>
</ul>

Datei:ScreenshotFHEMTherme.png

2013-07-05T10:33:22Z

Snowyrain:

Junkers Therme Stetigregelung

2013-07-05T10:05:49Z

Snowyrain: /* Ethersex */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

==Ethersex==

Die Firmware der AVR-NET-IO-Boards wird durch eine erweiterte Firmware ausgetauscht.

Der Vorgang ist hier beschrieben: [[AVR-NET-IO#Konfiguration_und_Flashen_von_ethersex]]

===Ethersex-Bauen===
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

===Ethersex-Flashen===
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto). Nicht vergessen die Fuses zu setzten.

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

==Integration in FHEM==

In FHEM muss das Setzen der Sollwerte und die Erfassung der aktuellen Sollwerte/Istwerte integriert werden. Wenn der alt Raumtemperaturregler entfällt kann zweites auch entfallen.

===Setzen der Sollwerte===

Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den DAC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINDAC ECMDDevice LTC1257
attr MEINDAC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINDAC setDacValue ".$dacValue);;\
</nowiki>

===Ermitteln der Istwerte===

Der ADC ermittelt den aktuellen Sollwert über einen Spannungsteiler. Dieser Wert wird in einen Prozentwert (0-100) umgerechnet. Hierfür wird eine classdef Datei (adc.classdef)erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
set setDacValue postproc {\
Log 3, "Setze Wert";;\
}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der ADC als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/adc.classdef
</nowiki>

Anschließend den ADC als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

==Kritische Nachbetrachtung==
<ul>
<li>Anschluss der Zusatzplatine nicht über die SUB-D Anschlussplatine sondern über den 10poligen Pfostenstecker. Das würde viel sauberer/professioneller aussehen und ist bei dem verwendeten Platinentyp sehr einfach zu relaisieren.</li>
<li>Spannungsversorgung des AVR-NET-IO-Boards über die 24V Spannung der Therme (irgendwie cooler)</li>
<li>Eventuell ist es auch bei diesen Junkersthermen sinnvoller die Steuerspannung mittels eines Relais/Transistors zwischen 3-22V zu schalten. Unter Verwendung von 2 Relais/Transistoren wären auch 4 Schaltstufen möglich (0%, 25%, 50% und 100%). </li>
<li>Die Zusatzplatine trennt das AVR-NET-IO-Board/Netzwerk und die Heizung nicht. Wenn keine Messung der Steuersignalspannung gewünscht ist, würde ich den LTC1257 galvanisch trennen. Bislang gab es aber keine Probleme diesbezüglich. </li>
</ul>

Junkers Therme Stetigregelung

2013-07-05T10:04:51Z

Snowyrain: /* Ethersex-Flashen */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

=Ethersex=

Die Firmware der AVR-NET-IO-Boards wird durch eine erweiterte Firmware ausgetauscht.

Der Vorgang ist hier beschrieben: [[AVR-NET-IO#Konfiguration_und_Flashen_von_ethersex]]

===Ethersex-Bauen===
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

===Ethersex-Flashen===
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto). Nicht vergessen die Fuses zu setzten.

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

==Integration in FHEM==

In FHEM muss das Setzen der Sollwerte und die Erfassung der aktuellen Sollwerte/Istwerte integriert werden. Wenn der alt Raumtemperaturregler entfällt kann zweites auch entfallen.

===Setzen der Sollwerte===

Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den DAC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINDAC ECMDDevice LTC1257
attr MEINDAC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINDAC setDacValue ".$dacValue);;\
</nowiki>

===Ermitteln der Istwerte===

Der ADC ermittelt den aktuellen Sollwert über einen Spannungsteiler. Dieser Wert wird in einen Prozentwert (0-100) umgerechnet. Hierfür wird eine classdef Datei (adc.classdef)erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
set setDacValue postproc {\
Log 3, "Setze Wert";;\
}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der ADC als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/adc.classdef
</nowiki>

Anschließend den ADC als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

==Kritische Nachbetrachtung==
<ul>
<li>Anschluss der Zusatzplatine nicht über die SUB-D Anschlussplatine sondern über den 10poligen Pfostenstecker. Das würde viel sauberer/professioneller aussehen und ist bei dem verwendeten Platinentyp sehr einfach zu relaisieren.</li>
<li>Spannungsversorgung des AVR-NET-IO-Boards über die 24V Spannung der Therme (irgendwie cooler)</li>
<li>Eventuell ist es auch bei diesen Junkersthermen sinnvoller die Steuerspannung mittels eines Relais/Transistors zwischen 3-22V zu schalten. Unter Verwendung von 2 Relais/Transistoren wären auch 4 Schaltstufen möglich (0%, 25%, 50% und 100%). </li>
<li>Die Zusatzplatine trennt das AVR-NET-IO-Board/Netzwerk und die Heizung nicht. Wenn keine Messung der Steuersignalspannung gewünscht ist, würde ich den LTC1257 galvanisch trennen. Bislang gab es aber keine Probleme diesbezüglich. </li>
</ul>

Junkers Therme Stetigregelung

2013-07-05T10:04:15Z

Snowyrain: /* Ethersex-Bauen */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

=Ethersex=

Die Firmware der AVR-NET-IO-Boards wird durch eine erweiterte Firmware ausgetauscht.

Der Vorgang ist hier beschrieben: [[AVR-NET-IO#Konfiguration_und_Flashen_von_ethersex]]

===Ethersex-Bauen===
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

==Ethersex-Flashen==
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto).

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

==Integration in FHEM==

In FHEM muss das Setzen der Sollwerte und die Erfassung der aktuellen Sollwerte/Istwerte integriert werden. Wenn der alt Raumtemperaturregler entfällt kann zweites auch entfallen.

===Setzen der Sollwerte===

Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den DAC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINDAC ECMDDevice LTC1257
attr MEINDAC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINDAC setDacValue ".$dacValue);;\
</nowiki>

===Ermitteln der Istwerte===

Der ADC ermittelt den aktuellen Sollwert über einen Spannungsteiler. Dieser Wert wird in einen Prozentwert (0-100) umgerechnet. Hierfür wird eine classdef Datei (adc.classdef)erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
set setDacValue postproc {\
Log 3, "Setze Wert";;\
}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der ADC als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/adc.classdef
</nowiki>

Anschließend den ADC als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

==Kritische Nachbetrachtung==
<ul>
<li>Anschluss der Zusatzplatine nicht über die SUB-D Anschlussplatine sondern über den 10poligen Pfostenstecker. Das würde viel sauberer/professioneller aussehen und ist bei dem verwendeten Platinentyp sehr einfach zu relaisieren.</li>
<li>Spannungsversorgung des AVR-NET-IO-Boards über die 24V Spannung der Therme (irgendwie cooler)</li>
<li>Eventuell ist es auch bei diesen Junkersthermen sinnvoller die Steuerspannung mittels eines Relais/Transistors zwischen 3-22V zu schalten. Unter Verwendung von 2 Relais/Transistoren wären auch 4 Schaltstufen möglich (0%, 25%, 50% und 100%). </li>
<li>Die Zusatzplatine trennt das AVR-NET-IO-Board/Netzwerk und die Heizung nicht. Wenn keine Messung der Steuersignalspannung gewünscht ist, würde ich den LTC1257 galvanisch trennen. Bislang gab es aber keine Probleme diesbezüglich. </li>
</ul>

Junkers Therme Stetigregelung

2013-07-05T09:50:51Z

Snowyrain: /* Ermitteln der Stellwerte */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

==Ethersex-Bauen==
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

==Ethersex-Flashen==
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto).

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

==Integration in FHEM==

In FHEM muss das Setzen der Sollwerte und die Erfassung der aktuellen Sollwerte/Istwerte integriert werden. Wenn der alt Raumtemperaturregler entfällt kann zweites auch entfallen.

===Setzen der Sollwerte===

Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den DAC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINDAC ECMDDevice LTC1257
attr MEINDAC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINDAC setDacValue ".$dacValue);;\
</nowiki>

===Ermitteln der Istwerte===

Der ADC ermittelt den aktuellen Sollwert über einen Spannungsteiler. Dieser Wert wird in einen Prozentwert (0-100) umgerechnet. Hierfür wird eine classdef Datei (adc.classdef)erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
set setDacValue postproc {\
Log 3, "Setze Wert";;\
}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der ADC als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/adc.classdef
</nowiki>

Anschließend den ADC als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

==Kritische Nachbetrachtung==
<ul>
<li>Anschluss der Zusatzplatine nicht über die SUB-D Anschlussplatine sondern über den 10poligen Pfostenstecker. Das würde viel sauberer/professioneller aussehen und ist bei dem verwendeten Platinentyp sehr einfach zu relaisieren.</li>
<li>Spannungsversorgung des AVR-NET-IO-Boards über die 24V Spannung der Therme (irgendwie cooler)</li>
<li>Eventuell ist es auch bei diesen Junkersthermen sinnvoller die Steuerspannung mittels eines Relais/Transistors zwischen 3-22V zu schalten. Unter Verwendung von 2 Relais/Transistoren wären auch 4 Schaltstufen möglich (0%, 25%, 50% und 100%). </li>
<li>Die Zusatzplatine trennt das AVR-NET-IO-Board/Netzwerk und die Heizung nicht. Wenn keine Messung der Steuersignalspannung gewünscht ist, würde ich den LTC1257 galvanisch trennen. Bislang gab es aber keine Probleme diesbezüglich. </li>
</ul>

Junkers Therme Stetigregelung

2013-07-05T09:41:48Z

Snowyrain: /* Ermitteln der Stellwerte */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

==Ethersex-Bauen==
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

==Ethersex-Flashen==
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto).

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

Integration in FHEM
Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den ADC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINADC setDacValue ".$dacValue);;\
</nowiki>

Junkers Therme Stetigregelung

2013-07-05T09:40:29Z

Snowyrain: /* Inbetriebnahme */

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung auf 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==

[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.


==Vorbereitung 3==

Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)


==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

==Ethersex-Bauen==
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

==Ethersex-Flashen==
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto).

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. (Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen: 
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list 
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden. 
Befehl: 1w list 
Ausgabe: 1069ad4d020800d8 
Ausgabe: 10884e5b0208002d 
Ausgabe: OK 
</li>
<li>
Temperatur einlesen: 
Befehl: 1w get 1069ad4d020800d8 
Ausgabe: 26.4 
</li>
<li>
Steuersignal der Heizung abfragen 
Befehl: adc get 0 
Ausgabe: 04D 
Befehl: adc get 3 
Ausgabe: 04F 
</li>
<li>
Steuersignal auf Maximum stellen 
Befehl: ltc1257_set 2000 
Ausgabe: OK 
</li>
<li>
Steuersignal der Heizung erneut abfragen 
Befehl: adc get 0 
Ausgabe: 0BF 
Befehl: adc get 3 
Ausgabe: 0C9 
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

Junkers Therme Stetigregelung

2013-07-05T09:29:19Z

Snowyrain: /* Teileliste */

Junkers Therme Stetigregelung

2013-07-05T09:23:10Z

Snowyrain: /* Vorbereitung 3 */

Junkers Therme Stetigregelung

2013-07-05T09:22:16Z

Snowyrain:

Junkers Therme Stetigregelung

2013-07-05T09:10:58Z

Snowyrain:

Datei:Junkers Therme Stetigregelung Prototyp.jpg

2013-07-05T09:09:57Z

Snowyrain:

Datei:Junkers Therme Stetigregelung 2MP.png

2013-07-05T09:04:57Z

Snowyrain:

Datei:Junkers Therme Stetigregelung 1MP.jpg

2013-07-05T09:04:43Z

Snowyrain:

Datei:Junkers Therme Stetigregelung 0MP.png

2013-07-05T09:03:39Z

Snowyrain: