http://wiki.fhem.de/w/api.php?action=feedcontributions&feedformat=atom&user=Stephan FHEMWiki - Benutzerbeiträge [de] 2026-04-12T14:53:53Z Benutzerbeiträge MediaWiki 1.43.6 http://wiki.fhem.de/w/index.php?title=Victron&diff=40054 Victron 2025-03-10T10:34:22Z <p>Stephan: /* Multiplus II */</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> === Multiplus II ===<br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:Charger and Inverter,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading Device_Status<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0033-set 1<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack N<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack N<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack N<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack N<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack N<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack N<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack N<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === Cerbo GX mit Unit ID 100 ===<br /> &lt;syntaxhighlight&gt;<br /> defmod Cerbo_100 ModbusAttr 100 5 192.168.243.38:502 TCP<br /> attr Cerbo_100 dev-h-defPoll 1<br /> attr Cerbo_100 obj-h0800-len 6<br /> attr Cerbo_100 obj-h0800-reading system_serial<br /> attr Cerbo_100 obj-h0800-unpack Z12<br /> attr Cerbo_100 obj-h0806-map 0:Open,1:Closed<br /> attr Cerbo_100 obj-h0806-reading CCGX_relay_state_1<br /> attr Cerbo_100 obj-h0806-unpack n<br /> attr Cerbo_100 obj-h0807-map 0:Open,1:Closed<br /> attr Cerbo_100 obj-h0807-reading CCGX_relay_state_2<br /> attr Cerbo_100 obj-h0807-unpack n<br /> attr Cerbo_100 obj-h0808-reading PV_AC_Coupled_output_L1<br /> attr Cerbo_100 obj-h0808-unpack n<br /> attr Cerbo_100 obj-h0809-reading PV_AC_Coupled_output_L2<br /> attr Cerbo_100 obj-h0809-unpack n<br /> attr Cerbo_100 obj-h0810-reading PV_AC_Coupled_output_L3<br /> attr Cerbo_100 obj-h0810-unpack n<br /> attr Cerbo_100 obj-h0811-reading PV_AC_Coupled_input_L1<br /> attr Cerbo_100 obj-h0811-unpack n<br /> attr Cerbo_100 obj-h0812-reading PV_AC_Coupled_input_L2<br /> attr Cerbo_100 obj-h0812-unpack n<br /> attr Cerbo_100 obj-h0813-reading PV_AC_Coupled_input_L3<br /> attr Cerbo_100 obj-h0813-unpack n<br /> attr Cerbo_100 obj-h0814-reading PV_AC_Coupled_generator_L1<br /> attr Cerbo_100 obj-h0814-unpack n<br /> attr Cerbo_100 obj-h0815-reading PV_AC_Coupled_generator_L2<br /> attr Cerbo_100 obj-h0815-unpack n<br /> attr Cerbo_100 obj-h0816-reading PV_AC_Coupled_generator_L3<br /> attr Cerbo_100 obj-h0816-unpack n<br /> attr Cerbo_100 obj-h0817-reading AC_consumption_L1<br /> attr Cerbo_100 obj-h0817-unpack n<br /> attr Cerbo_100 obj-h0818-reading AC_consumption_L2<br /> attr Cerbo_100 obj-h0818-unpack n<br /> attr Cerbo_100 obj-h0819-reading AC_consumption_L3<br /> attr Cerbo_100 obj-h0819-unpack n<br /> attr Cerbo_100 obj-h0820-reading grid_L1<br /> attr Cerbo_100 obj-h0820-unpack s&gt;<br /> attr Cerbo_100 obj-h0821-reading grid_L2<br /> attr Cerbo_100 obj-h0821-unpack s&gt;<br /> attr Cerbo_100 obj-h0822-reading grid_L3<br /> attr Cerbo_100 obj-h0822-unpack s&gt;<br /> attr Cerbo_100 obj-h0823-reading genset_L1<br /> attr Cerbo_100 obj-h0823-unpack s&gt;<br /> attr Cerbo_100 obj-h0824-reading genset_L2<br /> attr Cerbo_100 obj-h0824-unpack s&gt;<br /> attr Cerbo_100 obj-h0825-reading genset_L3<br /> attr Cerbo_100 obj-h0825-unpack s&gt;<br /> attr Cerbo_100 obj-h0826-map 0:Unknown,1:Grid,2:Generator,3:Shore power,240:Not connected<br /> attr Cerbo_100 obj-h0826-reading active_input_source<br /> attr Cerbo_100 obj-h0826-unpack s&gt;<br /> attr Cerbo_100 obj-h0830-len 4<br /> attr Cerbo_100 obj-h0830-reading system_UTC_time<br /> attr Cerbo_100 obj-h0830-unpack Q<br /> attr Cerbo_100 obj-h0840-expr $val / 10<br /> attr Cerbo_100 obj-h0840-reading battery_voltage_system<br /> attr Cerbo_100 obj-h0840-unpack n<br /> attr Cerbo_100 obj-h0841-expr $val / 10<br /> attr Cerbo_100 obj-h0841-reading battery_current_system<br /> attr Cerbo_100 obj-h0841-unpack s&gt;<br /> attr Cerbo_100 obj-h0842-reading battery_power_system<br /> attr Cerbo_100 obj-h0842-unpack s&gt;<br /> attr Cerbo_100 obj-h0843-reading battery_soc_system<br /> attr Cerbo_100 obj-h0843-unpack n<br /> attr Cerbo_100 obj-h0844-map 0:idle,1:charging,2:discharging<br /> attr Cerbo_100 obj-h0844-reading battery_state_system<br /> attr Cerbo_100 obj-h0844-unpack n<br /> attr Cerbo_100 obj-h0845-expr $val /-10<br /> attr Cerbo_100 obj-h0845-reading battery_consumed_amphours_system<br /> attr Cerbo_100 obj-h0845-unpack n<br /> attr Cerbo_100 obj-h0846-expr $val * 100<br /> attr Cerbo_100 obj-h0846-reading battery_timetogo_system<br /> attr Cerbo_100 obj-h0846-unpack n<br /> attr Cerbo_100 obj-h0850-reading PV_DC_Coupled_power<br /> attr Cerbo_100 obj-h0850-unpack n<br /> attr Cerbo_100 obj-h0851-expr $val /10<br /> attr Cerbo_100 obj-h0851-reading PV_DC_Coupled_current<br /> attr Cerbo_100 obj-h0851-unpack s&gt;<br /> attr Cerbo_100 obj-h0855-reading charger_power<br /> attr Cerbo_100 obj-h0855-unpack n<br /> attr Cerbo_100 obj-h0860-reading dc_system_power<br /> attr Cerbo_100 obj-h0860-unpack s&gt;<br /> attr Cerbo_100 obj-h0865-expr $val /10<br /> attr Cerbo_100 obj-h0865-reading vebus_charge_current_system<br /> attr Cerbo_100 obj-h0865-unpack s&gt;<br /> attr Cerbo_100 obj-h0866-reading vebus_charge_power_system<br /> attr Cerbo_100 obj-h0866-unpack s&gt;<br /> attr Cerbo_100 obj-h0867-reading RESERVED<br /> attr Cerbo_100 obj-h0867-unpack n<br /> attr Cerbo_100 obj-h0868-expr $val /10<br /> attr Cerbo_100 obj-h0868-reading inverter_charger_current<br /> attr Cerbo_100 obj-h0868-unpack f&gt;<br /> attr Cerbo_100 obj-h0870-len 2<br /> attr Cerbo_100 obj-h0870-reading inverter_charger_power<br /> attr Cerbo_100 obj-h0870-unpack f&gt;<br /> attr Cerbo_100 obj-h0872-len 2<br /> attr Cerbo_100 obj-h0872-reading power_between_meter_and_charger_L1<br /> attr Cerbo_100 obj-h0872-unpack f&gt;<br /> attr Cerbo_100 obj-h0874-len 2<br /> attr Cerbo_100 obj-h0874-reading power_between_meter_and_charger_L2<br /> attr Cerbo_100 obj-h0874-unpack f&gt;<br /> attr Cerbo_100 obj-h0876-len 2<br /> attr Cerbo_100 obj-h0876-reading power_between_meter_and_charger_L3<br /> attr Cerbo_100 obj-h0876-unpack f&gt;<br /> attr Cerbo_100 obj-h0878-len 2<br /> attr Cerbo_100 obj-h0878-reading power_output_inverter_charger_L1<br /> attr Cerbo_100 obj-h0878-unpack f&gt;<br /> attr Cerbo_100 obj-h0880-len 2<br /> attr Cerbo_100 obj-h0880-reading power_output_inverter_charger_L2<br /> attr Cerbo_100 obj-h0880-unpack f&gt;<br /> attr Cerbo_100 obj-h0882-len 2<br /> attr Cerbo_100 obj-h0882-reading power_output_inverter_charger_L3<br /> attr Cerbo_100 obj-h0882-unpack f&gt;<br /> attr Cerbo_100 room Solar-&gt;Victron<br /> <br /> &lt;/syntaxhighlight&gt;<br /> <br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Victron&diff=40053 Victron 2025-03-10T10:30:35Z <p>Stephan: Doppel-Paste gelöscht</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> === Multiplus II ===<br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:On,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading switch_position<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack N<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack N<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack N<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack N<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack N<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack N<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack N<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === Cerbo GX mit Unit ID 100 ===<br /> &lt;syntaxhighlight&gt;<br /> defmod Cerbo_100 ModbusAttr 100 5 192.168.243.38:502 TCP<br /> attr Cerbo_100 dev-h-defPoll 1<br /> attr Cerbo_100 obj-h0800-len 6<br /> attr Cerbo_100 obj-h0800-reading system_serial<br /> attr Cerbo_100 obj-h0800-unpack Z12<br /> attr Cerbo_100 obj-h0806-map 0:Open,1:Closed<br /> attr Cerbo_100 obj-h0806-reading CCGX_relay_state_1<br /> attr Cerbo_100 obj-h0806-unpack n<br /> attr Cerbo_100 obj-h0807-map 0:Open,1:Closed<br /> attr Cerbo_100 obj-h0807-reading CCGX_relay_state_2<br /> attr Cerbo_100 obj-h0807-unpack n<br /> attr Cerbo_100 obj-h0808-reading PV_AC_Coupled_output_L1<br /> attr Cerbo_100 obj-h0808-unpack n<br /> attr Cerbo_100 obj-h0809-reading PV_AC_Coupled_output_L2<br /> attr Cerbo_100 obj-h0809-unpack n<br /> attr Cerbo_100 obj-h0810-reading PV_AC_Coupled_output_L3<br /> attr Cerbo_100 obj-h0810-unpack n<br /> attr Cerbo_100 obj-h0811-reading PV_AC_Coupled_input_L1<br /> attr Cerbo_100 obj-h0811-unpack n<br /> attr Cerbo_100 obj-h0812-reading PV_AC_Coupled_input_L2<br /> attr Cerbo_100 obj-h0812-unpack n<br /> attr Cerbo_100 obj-h0813-reading PV_AC_Coupled_input_L3<br /> attr Cerbo_100 obj-h0813-unpack n<br /> attr Cerbo_100 obj-h0814-reading PV_AC_Coupled_generator_L1<br /> attr Cerbo_100 obj-h0814-unpack n<br /> attr Cerbo_100 obj-h0815-reading PV_AC_Coupled_generator_L2<br /> attr Cerbo_100 obj-h0815-unpack n<br /> attr Cerbo_100 obj-h0816-reading PV_AC_Coupled_generator_L3<br /> attr Cerbo_100 obj-h0816-unpack n<br /> attr Cerbo_100 obj-h0817-reading AC_consumption_L1<br /> attr Cerbo_100 obj-h0817-unpack n<br /> attr Cerbo_100 obj-h0818-reading AC_consumption_L2<br /> attr Cerbo_100 obj-h0818-unpack n<br /> attr Cerbo_100 obj-h0819-reading AC_consumption_L3<br /> attr Cerbo_100 obj-h0819-unpack n<br /> attr Cerbo_100 obj-h0820-reading grid_L1<br /> attr Cerbo_100 obj-h0820-unpack s&gt;<br /> attr Cerbo_100 obj-h0821-reading grid_L2<br /> attr Cerbo_100 obj-h0821-unpack s&gt;<br /> attr Cerbo_100 obj-h0822-reading grid_L3<br /> attr Cerbo_100 obj-h0822-unpack s&gt;<br /> attr Cerbo_100 obj-h0823-reading genset_L1<br /> attr Cerbo_100 obj-h0823-unpack s&gt;<br /> attr Cerbo_100 obj-h0824-reading genset_L2<br /> attr Cerbo_100 obj-h0824-unpack s&gt;<br /> attr Cerbo_100 obj-h0825-reading genset_L3<br /> attr Cerbo_100 obj-h0825-unpack s&gt;<br /> attr Cerbo_100 obj-h0826-map 0:Unknown,1:Grid,2:Generator,3:Shore power,240:Not connected<br /> attr Cerbo_100 obj-h0826-reading active_input_source<br /> attr Cerbo_100 obj-h0826-unpack s&gt;<br /> attr Cerbo_100 obj-h0830-len 4<br /> attr Cerbo_100 obj-h0830-reading system_UTC_time<br /> attr Cerbo_100 obj-h0830-unpack Q<br /> attr Cerbo_100 obj-h0840-expr $val / 10<br /> attr Cerbo_100 obj-h0840-reading battery_voltage_system<br /> attr Cerbo_100 obj-h0840-unpack n<br /> attr Cerbo_100 obj-h0841-expr $val / 10<br /> attr Cerbo_100 obj-h0841-reading battery_current_system<br /> attr Cerbo_100 obj-h0841-unpack s&gt;<br /> attr Cerbo_100 obj-h0842-reading battery_power_system<br /> attr Cerbo_100 obj-h0842-unpack s&gt;<br /> attr Cerbo_100 obj-h0843-reading battery_soc_system<br /> attr Cerbo_100 obj-h0843-unpack n<br /> attr Cerbo_100 obj-h0844-map 0:idle,1:charging,2:discharging<br /> attr Cerbo_100 obj-h0844-reading battery_state_system<br /> attr Cerbo_100 obj-h0844-unpack n<br /> attr Cerbo_100 obj-h0845-expr $val /-10<br /> attr Cerbo_100 obj-h0845-reading battery_consumed_amphours_system<br /> attr Cerbo_100 obj-h0845-unpack n<br /> attr Cerbo_100 obj-h0846-expr $val * 100<br /> attr Cerbo_100 obj-h0846-reading battery_timetogo_system<br /> attr Cerbo_100 obj-h0846-unpack n<br /> attr Cerbo_100 obj-h0850-reading PV_DC_Coupled_power<br /> attr Cerbo_100 obj-h0850-unpack n<br /> attr Cerbo_100 obj-h0851-expr $val /10<br /> attr Cerbo_100 obj-h0851-reading PV_DC_Coupled_current<br /> attr Cerbo_100 obj-h0851-unpack s&gt;<br /> attr Cerbo_100 obj-h0855-reading charger_power<br /> attr Cerbo_100 obj-h0855-unpack n<br /> attr Cerbo_100 obj-h0860-reading dc_system_power<br /> attr Cerbo_100 obj-h0860-unpack s&gt;<br /> attr Cerbo_100 obj-h0865-expr $val /10<br /> attr Cerbo_100 obj-h0865-reading vebus_charge_current_system<br /> attr Cerbo_100 obj-h0865-unpack s&gt;<br /> attr Cerbo_100 obj-h0866-reading vebus_charge_power_system<br /> attr Cerbo_100 obj-h0866-unpack s&gt;<br /> attr Cerbo_100 obj-h0867-reading RESERVED<br /> attr Cerbo_100 obj-h0867-unpack n<br /> attr Cerbo_100 obj-h0868-expr $val /10<br /> attr Cerbo_100 obj-h0868-reading inverter_charger_current<br /> attr Cerbo_100 obj-h0868-unpack f&gt;<br /> attr Cerbo_100 obj-h0870-len 2<br /> attr Cerbo_100 obj-h0870-reading inverter_charger_power<br /> attr Cerbo_100 obj-h0870-unpack f&gt;<br /> attr Cerbo_100 obj-h0872-len 2<br /> attr Cerbo_100 obj-h0872-reading power_between_meter_and_charger_L1<br /> attr Cerbo_100 obj-h0872-unpack f&gt;<br /> attr Cerbo_100 obj-h0874-len 2<br /> attr Cerbo_100 obj-h0874-reading power_between_meter_and_charger_L2<br /> attr Cerbo_100 obj-h0874-unpack f&gt;<br /> attr Cerbo_100 obj-h0876-len 2<br /> attr Cerbo_100 obj-h0876-reading power_between_meter_and_charger_L3<br /> attr Cerbo_100 obj-h0876-unpack f&gt;<br /> attr Cerbo_100 obj-h0878-len 2<br /> attr Cerbo_100 obj-h0878-reading power_output_inverter_charger_L1<br /> attr Cerbo_100 obj-h0878-unpack f&gt;<br /> attr Cerbo_100 obj-h0880-len 2<br /> attr Cerbo_100 obj-h0880-reading power_output_inverter_charger_L2<br /> attr Cerbo_100 obj-h0880-unpack f&gt;<br /> attr Cerbo_100 obj-h0882-len 2<br /> attr Cerbo_100 obj-h0882-reading power_output_inverter_charger_L3<br /> attr Cerbo_100 obj-h0882-unpack f&gt;<br /> attr Cerbo_100 room Solar-&gt;Victron<br /> <br /> &lt;/syntaxhighlight&gt;<br /> <br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Victron&diff=40052 Victron 2025-03-09T18:32:52Z <p>Stephan: ModbusAttr für Cerbo GX hinzugefügt</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> === Multiplus II ===<br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:On,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading switch_position<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack N<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack N<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack N<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack N<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack N<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack N<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack N<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 obj-h10-expr $val / 100<br /> attr MultiPlusII_227 obj-h10-len 1<br /> attr MultiPlusII_227 obj-h10-reading AC_Input_Frequency_L 2<br /> attr MultiPlusII_227 obj-h10-unpack s&gt;<br /> attr MultiPlusII_227 obj-h100-len 1<br /> attr MultiPlusII_227 obj-h100-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h100-unpack s&gt;<br /> attr MultiPlusII_227 obj-h102-len 1<br /> attr MultiPlusII_227 obj-h102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h102-unpack s&gt;<br /> attr MultiPlusII_227 obj-h103-len 1<br /> attr MultiPlusII_227 obj-h103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h103-unpack s&gt;<br /> attr MultiPlusII_227 obj-h104-len 1<br /> attr MultiPlusII_227 obj-h104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h104-unpack s&gt;<br /> attr MultiPlusII_227 obj-h105-len 1<br /> attr MultiPlusII_227 obj-h105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h105-unpack s&gt;<br /> attr MultiPlusII_227 obj-h106-expr $val / 100<br /> attr MultiPlusII_227 obj-h106-len 1<br /> attr MultiPlusII_227 obj-h106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h106-unpack s&gt;<br /> attr MultiPlusII_227 obj-h107-expr $val / 100<br /> attr MultiPlusII_227 obj-h107-len 1<br /> attr MultiPlusII_227 obj-h107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h107-unpack s&gt;<br /> attr MultiPlusII_227 obj-h108-len 1<br /> attr MultiPlusII_227 obj-h108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h108-unpack s&gt;<br /> attr MultiPlusII_227 obj-h109-len 1<br /> attr MultiPlusII_227 obj-h109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h109-unpack s&gt;<br /> attr MultiPlusII_227 obj-h11-expr $val / 100<br /> attr MultiPlusII_227 obj-h11-len 1<br /> attr MultiPlusII_227 obj-h11-reading AC_Input_Frequency_L 3<br /> attr MultiPlusII_227 obj-h11-unpack s&gt;<br /> attr MultiPlusII_227 obj-h12-expr $val * 10<br /> attr MultiPlusII_227 obj-h12-len 1<br /> attr MultiPlusII_227 obj-h12-reading AC_Input_Power_L 1<br /> attr MultiPlusII_227 obj-h12-unpack s&gt;<br /> attr MultiPlusII_227 obj-h13-expr $val * 10<br /> attr MultiPlusII_227 obj-h13-len 1<br /> attr MultiPlusII_227 obj-h13-reading AC_Input_Power_L 2<br /> attr MultiPlusII_227 obj-h13-unpack s&gt;<br /> attr MultiPlusII_227 obj-h14-expr $val * 10<br /> attr MultiPlusII_227 obj-h14-len 1<br /> attr MultiPlusII_227 obj-h14-reading AC_Input_Power_L 3<br /> attr MultiPlusII_227 obj-h14-unpack s&gt;<br /> attr MultiPlusII_227 obj-h15-expr $val / 10<br /> attr MultiPlusII_227 obj-h15-len 1<br /> attr MultiPlusII_227 obj-h15-reading AC_Output_Voltage_L 1<br /> attr MultiPlusII_227 obj-h15-unpack s&gt;<br /> attr MultiPlusII_227 obj-h16-expr $val / 10<br /> attr MultiPlusII_227 obj-h16-len 1<br /> attr MultiPlusII_227 obj-h16-reading AC_Output_Voltage_L 2<br /> attr MultiPlusII_227 obj-h16-unpack s&gt;<br /> attr MultiPlusII_227 obj-h17-expr $val / 10<br /> attr MultiPlusII_227 obj-h17-len 1<br /> attr MultiPlusII_227 obj-h17-reading AC_Output_Voltage_L 3<br /> attr MultiPlusII_227 obj-h17-unpack s&gt;<br /> attr MultiPlusII_227 obj-h18-expr $val / 10<br /> attr MultiPlusII_227 obj-h18-len 1<br /> attr MultiPlusII_227 obj-h18-reading AC_Output_Current_L 1<br /> attr MultiPlusII_227 obj-h18-unpack s&gt;<br /> attr MultiPlusII_227 obj-h19-expr $val / 10<br /> attr MultiPlusII_227 obj-h19-len 1<br /> attr MultiPlusII_227 obj-h19-reading AC_Output_Current_L 2<br /> attr MultiPlusII_227 obj-h19-unpack s&gt;<br /> attr MultiPlusII_227 obj-h20-expr $val / 10<br /> attr MultiPlusII_227 obj-h20-len 1<br /> attr MultiPlusII_227 obj-h20-reading AC_Output_Current_L 3<br /> attr MultiPlusII_227 obj-h20-unpack s&gt;<br /> attr MultiPlusII_227 obj-h21-expr $val / 100<br /> attr MultiPlusII_227 obj-h21-len 1<br /> attr MultiPlusII_227 obj-h21-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h21-unpack s&gt;<br /> attr MultiPlusII_227 obj-h22-expr $val / 10<br /> attr MultiPlusII_227 obj-h22-len 1<br /> attr MultiPlusII_227 obj-h22-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h22-unpack s&gt;<br /> attr MultiPlusII_227 obj-h23-expr $val * 10<br /> attr MultiPlusII_227 obj-h23-len 1<br /> attr MultiPlusII_227 obj-h23-reading AC_Output_Power_L 1<br /> attr MultiPlusII_227 obj-h23-unpack s&gt;<br /> attr MultiPlusII_227 obj-h24-expr $val * 10<br /> attr MultiPlusII_227 obj-h24-len 1<br /> attr MultiPlusII_227 obj-h24-reading AC_Output_Power_L 2<br /> attr MultiPlusII_227 obj-h24-unpack s&gt;<br /> attr MultiPlusII_227 obj-h25-expr $val * 10<br /> attr MultiPlusII_227 obj-h25-len 1<br /> attr MultiPlusII_227 obj-h25-reading AC_Output_Power_L 3<br /> attr MultiPlusII_227 obj-h25-unpack s&gt;<br /> attr MultiPlusII_227 obj-h26-expr $val / 100<br /> attr MultiPlusII_227 obj-h26-len 1<br /> attr MultiPlusII_227 obj-h26-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h26-unpack s&gt;<br /> attr MultiPlusII_227 obj-h27-expr $val / 10<br /> attr MultiPlusII_227 obj-h27-len 1<br /> attr MultiPlusII_227 obj-h27-reading Battery_Current<br /> attr MultiPlusII_227 obj-h27-unpack s&gt;<br /> attr MultiPlusII_227 obj-h28-len 1<br /> attr MultiPlusII_227 obj-h28-reading Phase_Count<br /> attr MultiPlusII_227 obj-h28-unpack s&gt;<br /> attr MultiPlusII_227 obj-h29-len 1<br /> attr MultiPlusII_227 obj-h29-reading Active_Input<br /> attr MultiPlusII_227 obj-h29-unpack s&gt;<br /> attr MultiPlusII_227 obj-h3-expr $val / 10<br /> attr MultiPlusII_227 obj-h3-len 1<br /> attr MultiPlusII_227 obj-h3-reading AC_Input_Voltage_L 1<br /> attr MultiPlusII_227 obj-h3-unpack n<br /> attr MultiPlusII_227 obj-h30-expr $val / 10<br /> attr MultiPlusII_227 obj-h30-len 1<br /> attr MultiPlusII_227 obj-h30-reading vebus_soc<br /> attr MultiPlusII_227 obj-h30-unpack s&gt;<br /> attr MultiPlusII_227 obj-h31-len 1<br /> attr MultiPlusII_227 obj-h31-reading vebus_state<br /> attr MultiPlusII_227 obj-h31-unpack s&gt;<br /> attr MultiPlusII_227 obj-h32-len 1<br /> attr MultiPlusII_227 obj-h32-reading vebus_error<br /> attr MultiPlusII_227 obj-h32-unpack s&gt;<br /> attr MultiPlusII_227 obj-h33-len 1<br /> attr MultiPlusII_227 obj-h33-reading switch_position<br /> attr MultiPlusII_227 obj-h33-unpack s&gt;<br /> attr MultiPlusII_227 obj-h34-len 1<br /> attr MultiPlusII_227 obj-h34-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h34-unpack s&gt;<br /> attr MultiPlusII_227 obj-h35-len 1<br /> attr MultiPlusII_227 obj-h35-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h35-unpack s&gt;<br /> attr MultiPlusII_227 obj-h36-len 1<br /> attr MultiPlusII_227 obj-h36-reading overload_alarm<br /> attr MultiPlusII_227 obj-h36-unpack s&gt;<br /> attr MultiPlusII_227 obj-h37-len 1<br /> attr MultiPlusII_227 obj-h37-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h37-unpack s&gt;<br /> attr MultiPlusII_227 obj-h38-len 1<br /> attr MultiPlusII_227 obj-h38-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h38-unpack s&gt;<br /> attr MultiPlusII_227 obj-h39-len 1<br /> attr MultiPlusII_227 obj-h39-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h39-unpack s&gt;<br /> attr MultiPlusII_227 obj-h4-expr $val / 10<br /> attr MultiPlusII_227 obj-h4-len 1 2<br /> attr MultiPlusII_227 obj-h4-reading AC_Input_Voltage_L 2<br /> attr MultiPlusII_227 obj-h4-unpack s&gt;<br /> attr MultiPlusII_227 obj-h40-len 1<br /> attr MultiPlusII_227 obj-h40-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h40-unpack s&gt;<br /> attr MultiPlusII_227 obj-h41-len 1<br /> attr MultiPlusII_227 obj-h41-reading ESS_Power_setpoint_L 3<br /> attr MultiPlusII_227 obj-h41-unpack s&gt;<br /> attr MultiPlusII_227 obj-h42-len 1<br /> attr MultiPlusII_227 obj-h42-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h42-unpack s&gt;<br /> attr MultiPlusII_227 obj-h43-len 1<br /> attr MultiPlusII_227 obj-h43-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h43-unpack s&gt;<br /> attr MultiPlusII_227 obj-h44-len 1<br /> attr MultiPlusII_227 obj-h44-reading temperature_alarm_L 1<br /> attr MultiPlusII_227 obj-h44-unpack s&gt;<br /> attr MultiPlusII_227 obj-h45-len 1<br /> attr MultiPlusII_227 obj-h45-reading low_battery_alarm_L 1<br /> attr MultiPlusII_227 obj-h45-unpack s&gt;<br /> attr MultiPlusII_227 obj-h46-len 1<br /> attr MultiPlusII_227 obj-h46-reading overload_alarm_L 1<br /> attr MultiPlusII_227 obj-h46-unpack s&gt;<br /> attr MultiPlusII_227 obj-h47-len 1<br /> attr MultiPlusII_227 obj-h47-reading ripple_alarm_L 1<br /> attr MultiPlusII_227 obj-h47-unpack s&gt;<br /> attr MultiPlusII_227 obj-h48-len 1<br /> attr MultiPlusII_227 obj-h48-reading temperature_alarm_L 2<br /> attr MultiPlusII_227 obj-h48-unpack s&gt;<br /> attr MultiPlusII_227 obj-h49-len 1<br /> attr MultiPlusII_227 obj-h49-reading low_battery_alarm_L 2<br /> attr MultiPlusII_227 obj-h49-unpack s&gt;<br /> attr MultiPlusII_227 obj-h5-expr $val / 10<br /> attr MultiPlusII_227 obj-h5-len 1<br /> attr MultiPlusII_227 obj-h5-reading AC_Input_Voltage_L 3<br /> attr MultiPlusII_227 obj-h5-unpack s&gt;<br /> attr MultiPlusII_227 obj-h50-len 1<br /> attr MultiPlusII_227 obj-h50-reading overload_alarm_L 2<br /> attr MultiPlusII_227 obj-h50-unpack s&gt;<br /> attr MultiPlusII_227 obj-h51-len 1<br /> attr MultiPlusII_227 obj-h51-reading ripple_alarm_L 2<br /> attr MultiPlusII_227 obj-h51-unpack s&gt;<br /> attr MultiPlusII_227 obj-h52-len 1<br /> attr MultiPlusII_227 obj-h52-reading temperature_alarm_L 3<br /> attr MultiPlusII_227 obj-h52-unpack s&gt;<br /> attr MultiPlusII_227 obj-h53-len 1<br /> attr MultiPlusII_227 obj-h53-reading low_battery_alarm_L 3<br /> attr MultiPlusII_227 obj-h53-unpack s&gt;<br /> attr MultiPlusII_227 obj-h54-len 1<br /> attr MultiPlusII_227 obj-h54-reading overload_alarm_L 3<br /> attr MultiPlusII_227 obj-h54-unpack s&gt;<br /> attr MultiPlusII_227 obj-h55-len 1<br /> attr MultiPlusII_227 obj-h55-reading ripple_alarm_L 3<br /> attr MultiPlusII_227 obj-h55-unpack s&gt;<br /> attr MultiPlusII_227 obj-h56-len 1<br /> attr MultiPlusII_227 obj-h56-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h56-unpack s&gt;<br /> attr MultiPlusII_227 obj-h57-len 1<br /> attr MultiPlusII_227 obj-h57-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h57-unpack s&gt;<br /> attr MultiPlusII_227 obj-h58-len 1<br /> attr MultiPlusII_227 obj-h58-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h58-unpack s&gt;<br /> attr MultiPlusII_227 obj-h59-len 1<br /> attr MultiPlusII_227 obj-h59-reading bms_expected<br /> attr MultiPlusII_227 obj-h59-unpack s&gt;<br /> attr MultiPlusII_227 obj-h6-expr $val / 10<br /> attr MultiPlusII_227 obj-h6-len 1<br /> attr MultiPlusII_227 obj-h6-reading AC_Input_Current_L 1<br /> attr MultiPlusII_227 obj-h6-unpack s&gt;<br /> attr MultiPlusII_227 obj-h60-len 1<br /> attr MultiPlusII_227 obj-h60-reading bms_error<br /> attr MultiPlusII_227 obj-h60-unpack s&gt;<br /> attr MultiPlusII_227 obj-h61-expr $val / 10<br /> attr MultiPlusII_227 obj-h61-len 1<br /> attr MultiPlusII_227 obj-h61-reading temperature_battery<br /> attr MultiPlusII_227 obj-h61-unpack s&gt;<br /> attr MultiPlusII_227 obj-h62-len 1<br /> attr MultiPlusII_227 obj-h62-reading vebus_reset<br /> attr MultiPlusII_227 obj-h62-unpack s&gt;<br /> attr MultiPlusII_227 obj-h63-len 1<br /> attr MultiPlusII_227 obj-h63-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h63-unpack s&gt;<br /> attr MultiPlusII_227 obj-h64-len 1<br /> attr MultiPlusII_227 obj-h64-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h64-unpack s&gt;<br /> attr MultiPlusII_227 obj-h65-len 1<br /> attr MultiPlusII_227 obj-h65-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h65-unpack s&gt;<br /> attr MultiPlusII_227 obj-h66-expr $val * 100<br /> attr MultiPlusII_227 obj-h66-len 1<br /> attr MultiPlusII_227 obj-h66-reading maximum_overvoltage_feedin_power_L 1<br /> attr MultiPlusII_227 obj-h66-unpack s&gt;<br /> attr MultiPlusII_227 obj-h67-expr $val * 100<br /> attr MultiPlusII_227 obj-h67-len 1<br /> attr MultiPlusII_227 obj-h67-reading maximum_overvoltage_feedin_power_L 2<br /> attr MultiPlusII_227 obj-h67-unpack s&gt;<br /> attr MultiPlusII_227 obj-h68-expr $val * 100<br /> attr MultiPlusII_227 obj-h68-len 1<br /> attr MultiPlusII_227 obj-h68-reading maximum_overvoltage_feedin_power_L 3<br /> attr MultiPlusII_227 obj-h68-unpack s&gt;<br /> attr MultiPlusII_227 obj-h69-len 1<br /> attr MultiPlusII_227 obj-h69-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h69-unpack s&gt;<br /> attr MultiPlusII_227 obj-h7-expr $val / 10<br /> attr MultiPlusII_227 obj-h7-len 1<br /> attr MultiPlusII_227 obj-h7-reading AC_Input_Current_L 2<br /> attr MultiPlusII_227 obj-h7-unpack s&gt;<br /> attr MultiPlusII_227 obj-h70-len 1<br /> attr MultiPlusII_227 obj-h70-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h70-unpack s&gt;<br /> attr MultiPlusII_227 obj-h71-len 1<br /> attr MultiPlusII_227 obj-h71-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h71-unpack s&gt;<br /> attr MultiPlusII_227 obj-h72-len 1<br /> attr MultiPlusII_227 obj-h72-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h72-unpack s&gt;<br /> attr MultiPlusII_227 obj-h73-len 1<br /> attr MultiPlusII_227 obj-h73-reading sustain_active<br /> attr MultiPlusII_227 obj-h73-unpack s&gt;<br /> attr MultiPlusII_227 obj-h74-expr $val / 100<br /> attr MultiPlusII_227 obj-h74-len 1<br /> attr MultiPlusII_227 obj-h74-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h74-unpack s&gt;<br /> attr MultiPlusII_227 obj-h76-expr $val / 100<br /> attr MultiPlusII_227 obj-h76-len 1<br /> attr MultiPlusII_227 obj-h76-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h76-unpack s&gt;<br /> attr MultiPlusII_227 obj-h78-expr $val / 100<br /> attr MultiPlusII_227 obj-h78-len 1<br /> attr MultiPlusII_227 obj-h78-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h78-unpack s&gt;<br /> attr MultiPlusII_227 obj-h8-expr $val / 10<br /> attr MultiPlusII_227 obj-h8-len 1<br /> attr MultiPlusII_227 obj-h8-reading AC_Input_Current_L 3<br /> attr MultiPlusII_227 obj-h8-unpack s&gt;<br /> attr MultiPlusII_227 obj-h80-expr $val / 100<br /> attr MultiPlusII_227 obj-h80-len 1<br /> attr MultiPlusII_227 obj-h80-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h80-unpack s&gt;<br /> attr MultiPlusII_227 obj-h82-expr $val / 100<br /> attr MultiPlusII_227 obj-h82-len 1<br /> attr MultiPlusII_227 obj-h82-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h82-unpack s&gt;<br /> attr MultiPlusII_227 obj-h84-expr $val / 100<br /> attr MultiPlusII_227 obj-h84-len 1<br /> attr MultiPlusII_227 obj-h84-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h84-unpack s&gt;<br /> attr MultiPlusII_227 obj-h86-expr $val / 100<br /> attr MultiPlusII_227 obj-h86-len 1<br /> attr MultiPlusII_227 obj-h86-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h86-unpack s&gt;<br /> attr MultiPlusII_227 obj-h88-expr $val / 100<br /> attr MultiPlusII_227 obj-h88-len 1<br /> attr MultiPlusII_227 obj-h88-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h88-unpack s&gt;<br /> attr MultiPlusII_227 obj-h9-expr $val / 100<br /> attr MultiPlusII_227 obj-h9-len 1<br /> attr MultiPlusII_227 obj-h9-reading AC_Input_Frequency_L 1<br /> attr MultiPlusII_227 obj-h9-unpack s&gt;<br /> attr MultiPlusII_227 obj-h90-expr $val / 100<br /> attr MultiPlusII_227 obj-h90-len 1<br /> attr MultiPlusII_227 obj-h90-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h90-unpack s&gt;<br /> attr MultiPlusII_227 obj-h92-expr $val / 100<br /> attr MultiPlusII_227 obj-h92-len 1<br /> attr MultiPlusII_227 obj-h92-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h92-unpack s&gt;<br /> attr MultiPlusII_227 obj-h94-len 1<br /> attr MultiPlusII_227 obj-h94-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h94-unpack s&gt;<br /> attr MultiPlusII_227 obj-h95-len 1<br /> attr MultiPlusII_227 obj-h95-reading charge_state<br /> attr MultiPlusII_227 obj-h95-unpack s&gt;<br /> attr MultiPlusII_227 obj-h96-len 1<br /> attr MultiPlusII_227 obj-h96-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h96-unpack s&gt;<br /> attr MultiPlusII_227 obj-h98-len 1<br /> attr MultiPlusII_227 obj-h98-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h98-unpack s&gt;<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> <br /> <br /> === Cerbo GX mit Unit ID 100 ===<br /> &lt;syntaxhighlight&gt;<br /> defmod Cerbo_100 ModbusAttr 100 5 192.168.243.38:502 TCP<br /> attr Cerbo_100 dev-h-defPoll 1<br /> attr Cerbo_100 obj-h0800-len 6<br /> attr Cerbo_100 obj-h0800-reading system_serial<br /> attr Cerbo_100 obj-h0800-unpack Z12<br /> attr Cerbo_100 obj-h0806-map 0:Open,1:Closed<br /> attr Cerbo_100 obj-h0806-reading CCGX_relay_state_1<br /> attr Cerbo_100 obj-h0806-unpack n<br /> attr Cerbo_100 obj-h0807-map 0:Open,1:Closed<br /> attr Cerbo_100 obj-h0807-reading CCGX_relay_state_2<br /> attr Cerbo_100 obj-h0807-unpack n<br /> attr Cerbo_100 obj-h0808-reading PV_AC_Coupled_output_L1<br /> attr Cerbo_100 obj-h0808-unpack n<br /> attr Cerbo_100 obj-h0809-reading PV_AC_Coupled_output_L2<br /> attr Cerbo_100 obj-h0809-unpack n<br /> attr Cerbo_100 obj-h0810-reading PV_AC_Coupled_output_L3<br /> attr Cerbo_100 obj-h0810-unpack n<br /> attr Cerbo_100 obj-h0811-reading PV_AC_Coupled_input_L1<br /> attr Cerbo_100 obj-h0811-unpack n<br /> attr Cerbo_100 obj-h0812-reading PV_AC_Coupled_input_L2<br /> attr Cerbo_100 obj-h0812-unpack n<br /> attr Cerbo_100 obj-h0813-reading PV_AC_Coupled_input_L3<br /> attr Cerbo_100 obj-h0813-unpack n<br /> attr Cerbo_100 obj-h0814-reading PV_AC_Coupled_generator_L1<br /> attr Cerbo_100 obj-h0814-unpack n<br /> attr Cerbo_100 obj-h0815-reading PV_AC_Coupled_generator_L2<br /> attr Cerbo_100 obj-h0815-unpack n<br /> attr Cerbo_100 obj-h0816-reading PV_AC_Coupled_generator_L3<br /> attr Cerbo_100 obj-h0816-unpack n<br /> attr Cerbo_100 obj-h0817-reading AC_consumption_L1<br /> attr Cerbo_100 obj-h0817-unpack n<br /> attr Cerbo_100 obj-h0818-reading AC_consumption_L2<br /> attr Cerbo_100 obj-h0818-unpack n<br /> attr Cerbo_100 obj-h0819-reading AC_consumption_L3<br /> attr Cerbo_100 obj-h0819-unpack n<br /> attr Cerbo_100 obj-h0820-reading grid_L1<br /> attr Cerbo_100 obj-h0820-unpack s&gt;<br /> attr Cerbo_100 obj-h0821-reading grid_L2<br /> attr Cerbo_100 obj-h0821-unpack s&gt;<br /> attr Cerbo_100 obj-h0822-reading grid_L3<br /> attr Cerbo_100 obj-h0822-unpack s&gt;<br /> attr Cerbo_100 obj-h0823-reading genset_L1<br /> attr Cerbo_100 obj-h0823-unpack s&gt;<br /> attr Cerbo_100 obj-h0824-reading genset_L2<br /> attr Cerbo_100 obj-h0824-unpack s&gt;<br /> attr Cerbo_100 obj-h0825-reading genset_L3<br /> attr Cerbo_100 obj-h0825-unpack s&gt;<br /> attr Cerbo_100 obj-h0826-map 0:Unknown,1:Grid,2:Generator,3:Shore power,240:Not connected<br /> attr Cerbo_100 obj-h0826-reading active_input_source<br /> attr Cerbo_100 obj-h0826-unpack s&gt;<br /> attr Cerbo_100 obj-h0830-len 4<br /> attr Cerbo_100 obj-h0830-reading system_UTC_time<br /> attr Cerbo_100 obj-h0830-unpack Q<br /> attr Cerbo_100 obj-h0840-expr $val / 10<br /> attr Cerbo_100 obj-h0840-reading battery_voltage_system<br /> attr Cerbo_100 obj-h0840-unpack n<br /> attr Cerbo_100 obj-h0841-expr $val / 10<br /> attr Cerbo_100 obj-h0841-reading battery_current_system<br /> attr Cerbo_100 obj-h0841-unpack s&gt;<br /> attr Cerbo_100 obj-h0842-reading battery_power_system<br /> attr Cerbo_100 obj-h0842-unpack s&gt;<br /> attr Cerbo_100 obj-h0843-reading battery_soc_system<br /> attr Cerbo_100 obj-h0843-unpack n<br /> attr Cerbo_100 obj-h0844-map 0:idle,1:charging,2:discharging<br /> attr Cerbo_100 obj-h0844-reading battery_state_system<br /> attr Cerbo_100 obj-h0844-unpack n<br /> attr Cerbo_100 obj-h0845-expr $val /-10<br /> attr Cerbo_100 obj-h0845-reading battery_consumed_amphours_system<br /> attr Cerbo_100 obj-h0845-unpack n<br /> attr Cerbo_100 obj-h0846-expr $val * 100<br /> attr Cerbo_100 obj-h0846-reading battery_timetogo_system<br /> attr Cerbo_100 obj-h0846-unpack n<br /> attr Cerbo_100 obj-h0850-reading PV_DC_Coupled_power<br /> attr Cerbo_100 obj-h0850-unpack n<br /> attr Cerbo_100 obj-h0851-expr $val /10<br /> attr Cerbo_100 obj-h0851-reading PV_DC_Coupled_current<br /> attr Cerbo_100 obj-h0851-unpack s&gt;<br /> attr Cerbo_100 obj-h0855-reading charger_power<br /> attr Cerbo_100 obj-h0855-unpack n<br /> attr Cerbo_100 obj-h0860-reading dc_system_power<br /> attr Cerbo_100 obj-h0860-unpack s&gt;<br /> attr Cerbo_100 obj-h0865-expr $val /10<br /> attr Cerbo_100 obj-h0865-reading vebus_charge_current_system<br /> attr Cerbo_100 obj-h0865-unpack s&gt;<br /> attr Cerbo_100 obj-h0866-reading vebus_charge_power_system<br /> attr Cerbo_100 obj-h0866-unpack s&gt;<br /> attr Cerbo_100 obj-h0867-reading RESERVED<br /> attr Cerbo_100 obj-h0867-unpack n<br /> attr Cerbo_100 obj-h0868-expr $val /10<br /> attr Cerbo_100 obj-h0868-reading inverter_charger_current<br /> attr Cerbo_100 obj-h0868-unpack f&gt;<br /> attr Cerbo_100 obj-h0870-len 2<br /> attr Cerbo_100 obj-h0870-reading inverter_charger_power<br /> attr Cerbo_100 obj-h0870-unpack f&gt;<br /> attr Cerbo_100 obj-h0872-len 2<br /> attr Cerbo_100 obj-h0872-reading power_between_meter_and_charger_L1<br /> attr Cerbo_100 obj-h0872-unpack f&gt;<br /> attr Cerbo_100 obj-h0874-len 2<br /> attr Cerbo_100 obj-h0874-reading power_between_meter_and_charger_L2<br /> attr Cerbo_100 obj-h0874-unpack f&gt;<br /> attr Cerbo_100 obj-h0876-len 2<br /> attr Cerbo_100 obj-h0876-reading power_between_meter_and_charger_L3<br /> attr Cerbo_100 obj-h0876-unpack f&gt;<br /> attr Cerbo_100 obj-h0878-len 2<br /> attr Cerbo_100 obj-h0878-reading power_output_inverter_charger_L1<br /> attr Cerbo_100 obj-h0878-unpack f&gt;<br /> attr Cerbo_100 obj-h0880-len 2<br /> attr Cerbo_100 obj-h0880-reading power_output_inverter_charger_L2<br /> attr Cerbo_100 obj-h0880-unpack f&gt;<br /> attr Cerbo_100 obj-h0882-len 2<br /> attr Cerbo_100 obj-h0882-reading power_output_inverter_charger_L3<br /> attr Cerbo_100 obj-h0882-unpack f&gt;<br /> attr Cerbo_100 room Solar-&gt;Victron<br /> <br /> &lt;/syntaxhighlight&gt;<br /> <br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Victron&diff=40051 Victron 2025-03-09T18:15:46Z <p>Stephan: /* Einbindung über ModbusAttr */</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> === Multiplus II ===<br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:On,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading switch_position<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack N<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack N<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack N<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack N<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack N<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack N<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack N<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 obj-h10-expr $val / 100<br /> attr MultiPlusII_227 obj-h10-len 1<br /> attr MultiPlusII_227 obj-h10-reading AC_Input_Frequency_L 2<br /> attr MultiPlusII_227 obj-h10-unpack s&gt;<br /> attr MultiPlusII_227 obj-h100-len 1<br /> attr MultiPlusII_227 obj-h100-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h100-unpack s&gt;<br /> attr MultiPlusII_227 obj-h102-len 1<br /> attr MultiPlusII_227 obj-h102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h102-unpack s&gt;<br /> attr MultiPlusII_227 obj-h103-len 1<br /> attr MultiPlusII_227 obj-h103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h103-unpack s&gt;<br /> attr MultiPlusII_227 obj-h104-len 1<br /> attr MultiPlusII_227 obj-h104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h104-unpack s&gt;<br /> attr MultiPlusII_227 obj-h105-len 1<br /> attr MultiPlusII_227 obj-h105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h105-unpack s&gt;<br /> attr MultiPlusII_227 obj-h106-expr $val / 100<br /> attr MultiPlusII_227 obj-h106-len 1<br /> attr MultiPlusII_227 obj-h106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h106-unpack s&gt;<br /> attr MultiPlusII_227 obj-h107-expr $val / 100<br /> attr MultiPlusII_227 obj-h107-len 1<br /> attr MultiPlusII_227 obj-h107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h107-unpack s&gt;<br /> attr MultiPlusII_227 obj-h108-len 1<br /> attr MultiPlusII_227 obj-h108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h108-unpack s&gt;<br /> attr MultiPlusII_227 obj-h109-len 1<br /> attr MultiPlusII_227 obj-h109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h109-unpack s&gt;<br /> attr MultiPlusII_227 obj-h11-expr $val / 100<br /> attr MultiPlusII_227 obj-h11-len 1<br /> attr MultiPlusII_227 obj-h11-reading AC_Input_Frequency_L 3<br /> attr MultiPlusII_227 obj-h11-unpack s&gt;<br /> attr MultiPlusII_227 obj-h12-expr $val * 10<br /> attr MultiPlusII_227 obj-h12-len 1<br /> attr MultiPlusII_227 obj-h12-reading AC_Input_Power_L 1<br /> attr MultiPlusII_227 obj-h12-unpack s&gt;<br /> attr MultiPlusII_227 obj-h13-expr $val * 10<br /> attr MultiPlusII_227 obj-h13-len 1<br /> attr MultiPlusII_227 obj-h13-reading AC_Input_Power_L 2<br /> attr MultiPlusII_227 obj-h13-unpack s&gt;<br /> attr MultiPlusII_227 obj-h14-expr $val * 10<br /> attr MultiPlusII_227 obj-h14-len 1<br /> attr MultiPlusII_227 obj-h14-reading AC_Input_Power_L 3<br /> attr MultiPlusII_227 obj-h14-unpack s&gt;<br /> attr MultiPlusII_227 obj-h15-expr $val / 10<br /> attr MultiPlusII_227 obj-h15-len 1<br /> attr MultiPlusII_227 obj-h15-reading AC_Output_Voltage_L 1<br /> attr MultiPlusII_227 obj-h15-unpack s&gt;<br /> attr MultiPlusII_227 obj-h16-expr $val / 10<br /> attr MultiPlusII_227 obj-h16-len 1<br /> attr MultiPlusII_227 obj-h16-reading AC_Output_Voltage_L 2<br /> attr MultiPlusII_227 obj-h16-unpack s&gt;<br /> attr MultiPlusII_227 obj-h17-expr $val / 10<br /> attr MultiPlusII_227 obj-h17-len 1<br /> attr MultiPlusII_227 obj-h17-reading AC_Output_Voltage_L 3<br /> attr MultiPlusII_227 obj-h17-unpack s&gt;<br /> attr MultiPlusII_227 obj-h18-expr $val / 10<br /> attr MultiPlusII_227 obj-h18-len 1<br /> attr MultiPlusII_227 obj-h18-reading AC_Output_Current_L 1<br /> attr MultiPlusII_227 obj-h18-unpack s&gt;<br /> attr MultiPlusII_227 obj-h19-expr $val / 10<br /> attr MultiPlusII_227 obj-h19-len 1<br /> attr MultiPlusII_227 obj-h19-reading AC_Output_Current_L 2<br /> attr MultiPlusII_227 obj-h19-unpack s&gt;<br /> attr MultiPlusII_227 obj-h20-expr $val / 10<br /> attr MultiPlusII_227 obj-h20-len 1<br /> attr MultiPlusII_227 obj-h20-reading AC_Output_Current_L 3<br /> attr MultiPlusII_227 obj-h20-unpack s&gt;<br /> attr MultiPlusII_227 obj-h21-expr $val / 100<br /> attr MultiPlusII_227 obj-h21-len 1<br /> attr MultiPlusII_227 obj-h21-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h21-unpack s&gt;<br /> attr MultiPlusII_227 obj-h22-expr $val / 10<br /> attr MultiPlusII_227 obj-h22-len 1<br /> attr MultiPlusII_227 obj-h22-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h22-unpack s&gt;<br /> attr MultiPlusII_227 obj-h23-expr $val * 10<br /> attr MultiPlusII_227 obj-h23-len 1<br /> attr MultiPlusII_227 obj-h23-reading AC_Output_Power_L 1<br /> attr MultiPlusII_227 obj-h23-unpack s&gt;<br /> attr MultiPlusII_227 obj-h24-expr $val * 10<br /> attr MultiPlusII_227 obj-h24-len 1<br /> attr MultiPlusII_227 obj-h24-reading AC_Output_Power_L 2<br /> attr MultiPlusII_227 obj-h24-unpack s&gt;<br /> attr MultiPlusII_227 obj-h25-expr $val * 10<br /> attr MultiPlusII_227 obj-h25-len 1<br /> attr MultiPlusII_227 obj-h25-reading AC_Output_Power_L 3<br /> attr MultiPlusII_227 obj-h25-unpack s&gt;<br /> attr MultiPlusII_227 obj-h26-expr $val / 100<br /> attr MultiPlusII_227 obj-h26-len 1<br /> attr MultiPlusII_227 obj-h26-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h26-unpack s&gt;<br /> attr MultiPlusII_227 obj-h27-expr $val / 10<br /> attr MultiPlusII_227 obj-h27-len 1<br /> attr MultiPlusII_227 obj-h27-reading Battery_Current<br /> attr MultiPlusII_227 obj-h27-unpack s&gt;<br /> attr MultiPlusII_227 obj-h28-len 1<br /> attr MultiPlusII_227 obj-h28-reading Phase_Count<br /> attr MultiPlusII_227 obj-h28-unpack s&gt;<br /> attr MultiPlusII_227 obj-h29-len 1<br /> attr MultiPlusII_227 obj-h29-reading Active_Input<br /> attr MultiPlusII_227 obj-h29-unpack s&gt;<br /> attr MultiPlusII_227 obj-h3-expr $val / 10<br /> attr MultiPlusII_227 obj-h3-len 1<br /> attr MultiPlusII_227 obj-h3-reading AC_Input_Voltage_L 1<br /> attr MultiPlusII_227 obj-h3-unpack n<br /> attr MultiPlusII_227 obj-h30-expr $val / 10<br /> attr MultiPlusII_227 obj-h30-len 1<br /> attr MultiPlusII_227 obj-h30-reading vebus_soc<br /> attr MultiPlusII_227 obj-h30-unpack s&gt;<br /> attr MultiPlusII_227 obj-h31-len 1<br /> attr MultiPlusII_227 obj-h31-reading vebus_state<br /> attr MultiPlusII_227 obj-h31-unpack s&gt;<br /> attr MultiPlusII_227 obj-h32-len 1<br /> attr MultiPlusII_227 obj-h32-reading vebus_error<br /> attr MultiPlusII_227 obj-h32-unpack s&gt;<br /> attr MultiPlusII_227 obj-h33-len 1<br /> attr MultiPlusII_227 obj-h33-reading switch_position<br /> attr MultiPlusII_227 obj-h33-unpack s&gt;<br /> attr MultiPlusII_227 obj-h34-len 1<br /> attr MultiPlusII_227 obj-h34-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h34-unpack s&gt;<br /> attr MultiPlusII_227 obj-h35-len 1<br /> attr MultiPlusII_227 obj-h35-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h35-unpack s&gt;<br /> attr MultiPlusII_227 obj-h36-len 1<br /> attr MultiPlusII_227 obj-h36-reading overload_alarm<br /> attr MultiPlusII_227 obj-h36-unpack s&gt;<br /> attr MultiPlusII_227 obj-h37-len 1<br /> attr MultiPlusII_227 obj-h37-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h37-unpack s&gt;<br /> attr MultiPlusII_227 obj-h38-len 1<br /> attr MultiPlusII_227 obj-h38-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h38-unpack s&gt;<br /> attr MultiPlusII_227 obj-h39-len 1<br /> attr MultiPlusII_227 obj-h39-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h39-unpack s&gt;<br /> attr MultiPlusII_227 obj-h4-expr $val / 10<br /> attr MultiPlusII_227 obj-h4-len 1 2<br /> attr MultiPlusII_227 obj-h4-reading AC_Input_Voltage_L 2<br /> attr MultiPlusII_227 obj-h4-unpack s&gt;<br /> attr MultiPlusII_227 obj-h40-len 1<br /> attr MultiPlusII_227 obj-h40-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h40-unpack s&gt;<br /> attr MultiPlusII_227 obj-h41-len 1<br /> attr MultiPlusII_227 obj-h41-reading ESS_Power_setpoint_L 3<br /> attr MultiPlusII_227 obj-h41-unpack s&gt;<br /> attr MultiPlusII_227 obj-h42-len 1<br /> attr MultiPlusII_227 obj-h42-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h42-unpack s&gt;<br /> attr MultiPlusII_227 obj-h43-len 1<br /> attr MultiPlusII_227 obj-h43-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h43-unpack s&gt;<br /> attr MultiPlusII_227 obj-h44-len 1<br /> attr MultiPlusII_227 obj-h44-reading temperature_alarm_L 1<br /> attr MultiPlusII_227 obj-h44-unpack s&gt;<br /> attr MultiPlusII_227 obj-h45-len 1<br /> attr MultiPlusII_227 obj-h45-reading low_battery_alarm_L 1<br /> attr MultiPlusII_227 obj-h45-unpack s&gt;<br /> attr MultiPlusII_227 obj-h46-len 1<br /> attr MultiPlusII_227 obj-h46-reading overload_alarm_L 1<br /> attr MultiPlusII_227 obj-h46-unpack s&gt;<br /> attr MultiPlusII_227 obj-h47-len 1<br /> attr MultiPlusII_227 obj-h47-reading ripple_alarm_L 1<br /> attr MultiPlusII_227 obj-h47-unpack s&gt;<br /> attr MultiPlusII_227 obj-h48-len 1<br /> attr MultiPlusII_227 obj-h48-reading temperature_alarm_L 2<br /> attr MultiPlusII_227 obj-h48-unpack s&gt;<br /> attr MultiPlusII_227 obj-h49-len 1<br /> attr MultiPlusII_227 obj-h49-reading low_battery_alarm_L 2<br /> attr MultiPlusII_227 obj-h49-unpack s&gt;<br /> attr MultiPlusII_227 obj-h5-expr $val / 10<br /> attr MultiPlusII_227 obj-h5-len 1<br /> attr MultiPlusII_227 obj-h5-reading AC_Input_Voltage_L 3<br /> attr MultiPlusII_227 obj-h5-unpack s&gt;<br /> attr MultiPlusII_227 obj-h50-len 1<br /> attr MultiPlusII_227 obj-h50-reading overload_alarm_L 2<br /> attr MultiPlusII_227 obj-h50-unpack s&gt;<br /> attr MultiPlusII_227 obj-h51-len 1<br /> attr MultiPlusII_227 obj-h51-reading ripple_alarm_L 2<br /> attr MultiPlusII_227 obj-h51-unpack s&gt;<br /> attr MultiPlusII_227 obj-h52-len 1<br /> attr MultiPlusII_227 obj-h52-reading temperature_alarm_L 3<br /> attr MultiPlusII_227 obj-h52-unpack s&gt;<br /> attr MultiPlusII_227 obj-h53-len 1<br /> attr MultiPlusII_227 obj-h53-reading low_battery_alarm_L 3<br /> attr MultiPlusII_227 obj-h53-unpack s&gt;<br /> attr MultiPlusII_227 obj-h54-len 1<br /> attr MultiPlusII_227 obj-h54-reading overload_alarm_L 3<br /> attr MultiPlusII_227 obj-h54-unpack s&gt;<br /> attr MultiPlusII_227 obj-h55-len 1<br /> attr MultiPlusII_227 obj-h55-reading ripple_alarm_L 3<br /> attr MultiPlusII_227 obj-h55-unpack s&gt;<br /> attr MultiPlusII_227 obj-h56-len 1<br /> attr MultiPlusII_227 obj-h56-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h56-unpack s&gt;<br /> attr MultiPlusII_227 obj-h57-len 1<br /> attr MultiPlusII_227 obj-h57-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h57-unpack s&gt;<br /> attr MultiPlusII_227 obj-h58-len 1<br /> attr MultiPlusII_227 obj-h58-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h58-unpack s&gt;<br /> attr MultiPlusII_227 obj-h59-len 1<br /> attr MultiPlusII_227 obj-h59-reading bms_expected<br /> attr MultiPlusII_227 obj-h59-unpack s&gt;<br /> attr MultiPlusII_227 obj-h6-expr $val / 10<br /> attr MultiPlusII_227 obj-h6-len 1<br /> attr MultiPlusII_227 obj-h6-reading AC_Input_Current_L 1<br /> attr MultiPlusII_227 obj-h6-unpack s&gt;<br /> attr MultiPlusII_227 obj-h60-len 1<br /> attr MultiPlusII_227 obj-h60-reading bms_error<br /> attr MultiPlusII_227 obj-h60-unpack s&gt;<br /> attr MultiPlusII_227 obj-h61-expr $val / 10<br /> attr MultiPlusII_227 obj-h61-len 1<br /> attr MultiPlusII_227 obj-h61-reading temperature_battery<br /> attr MultiPlusII_227 obj-h61-unpack s&gt;<br /> attr MultiPlusII_227 obj-h62-len 1<br /> attr MultiPlusII_227 obj-h62-reading vebus_reset<br /> attr MultiPlusII_227 obj-h62-unpack s&gt;<br /> attr MultiPlusII_227 obj-h63-len 1<br /> attr MultiPlusII_227 obj-h63-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h63-unpack s&gt;<br /> attr MultiPlusII_227 obj-h64-len 1<br /> attr MultiPlusII_227 obj-h64-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h64-unpack s&gt;<br /> attr MultiPlusII_227 obj-h65-len 1<br /> attr MultiPlusII_227 obj-h65-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h65-unpack s&gt;<br /> attr MultiPlusII_227 obj-h66-expr $val * 100<br /> attr MultiPlusII_227 obj-h66-len 1<br /> attr MultiPlusII_227 obj-h66-reading maximum_overvoltage_feedin_power_L 1<br /> attr MultiPlusII_227 obj-h66-unpack s&gt;<br /> attr MultiPlusII_227 obj-h67-expr $val * 100<br /> attr MultiPlusII_227 obj-h67-len 1<br /> attr MultiPlusII_227 obj-h67-reading maximum_overvoltage_feedin_power_L 2<br /> attr MultiPlusII_227 obj-h67-unpack s&gt;<br /> attr MultiPlusII_227 obj-h68-expr $val * 100<br /> attr MultiPlusII_227 obj-h68-len 1<br /> attr MultiPlusII_227 obj-h68-reading maximum_overvoltage_feedin_power_L 3<br /> attr MultiPlusII_227 obj-h68-unpack s&gt;<br /> attr MultiPlusII_227 obj-h69-len 1<br /> attr MultiPlusII_227 obj-h69-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h69-unpack s&gt;<br /> attr MultiPlusII_227 obj-h7-expr $val / 10<br /> attr MultiPlusII_227 obj-h7-len 1<br /> attr MultiPlusII_227 obj-h7-reading AC_Input_Current_L 2<br /> attr MultiPlusII_227 obj-h7-unpack s&gt;<br /> attr MultiPlusII_227 obj-h70-len 1<br /> attr MultiPlusII_227 obj-h70-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h70-unpack s&gt;<br /> attr MultiPlusII_227 obj-h71-len 1<br /> attr MultiPlusII_227 obj-h71-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h71-unpack s&gt;<br /> attr MultiPlusII_227 obj-h72-len 1<br /> attr MultiPlusII_227 obj-h72-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h72-unpack s&gt;<br /> attr MultiPlusII_227 obj-h73-len 1<br /> attr MultiPlusII_227 obj-h73-reading sustain_active<br /> attr MultiPlusII_227 obj-h73-unpack s&gt;<br /> attr MultiPlusII_227 obj-h74-expr $val / 100<br /> attr MultiPlusII_227 obj-h74-len 1<br /> attr MultiPlusII_227 obj-h74-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h74-unpack s&gt;<br /> attr MultiPlusII_227 obj-h76-expr $val / 100<br /> attr MultiPlusII_227 obj-h76-len 1<br /> attr MultiPlusII_227 obj-h76-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h76-unpack s&gt;<br /> attr MultiPlusII_227 obj-h78-expr $val / 100<br /> attr MultiPlusII_227 obj-h78-len 1<br /> attr MultiPlusII_227 obj-h78-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h78-unpack s&gt;<br /> attr MultiPlusII_227 obj-h8-expr $val / 10<br /> attr MultiPlusII_227 obj-h8-len 1<br /> attr MultiPlusII_227 obj-h8-reading AC_Input_Current_L 3<br /> attr MultiPlusII_227 obj-h8-unpack s&gt;<br /> attr MultiPlusII_227 obj-h80-expr $val / 100<br /> attr MultiPlusII_227 obj-h80-len 1<br /> attr MultiPlusII_227 obj-h80-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h80-unpack s&gt;<br /> attr MultiPlusII_227 obj-h82-expr $val / 100<br /> attr MultiPlusII_227 obj-h82-len 1<br /> attr MultiPlusII_227 obj-h82-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h82-unpack s&gt;<br /> attr MultiPlusII_227 obj-h84-expr $val / 100<br /> attr MultiPlusII_227 obj-h84-len 1<br /> attr MultiPlusII_227 obj-h84-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h84-unpack s&gt;<br /> attr MultiPlusII_227 obj-h86-expr $val / 100<br /> attr MultiPlusII_227 obj-h86-len 1<br /> attr MultiPlusII_227 obj-h86-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h86-unpack s&gt;<br /> attr MultiPlusII_227 obj-h88-expr $val / 100<br /> attr MultiPlusII_227 obj-h88-len 1<br /> attr MultiPlusII_227 obj-h88-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h88-unpack s&gt;<br /> attr MultiPlusII_227 obj-h9-expr $val / 100<br /> attr MultiPlusII_227 obj-h9-len 1<br /> attr MultiPlusII_227 obj-h9-reading AC_Input_Frequency_L 1<br /> attr MultiPlusII_227 obj-h9-unpack s&gt;<br /> attr MultiPlusII_227 obj-h90-expr $val / 100<br /> attr MultiPlusII_227 obj-h90-len 1<br /> attr MultiPlusII_227 obj-h90-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h90-unpack s&gt;<br /> attr MultiPlusII_227 obj-h92-expr $val / 100<br /> attr MultiPlusII_227 obj-h92-len 1<br /> attr MultiPlusII_227 obj-h92-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h92-unpack s&gt;<br /> attr MultiPlusII_227 obj-h94-len 1<br /> attr MultiPlusII_227 obj-h94-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h94-unpack s&gt;<br /> attr MultiPlusII_227 obj-h95-len 1<br /> attr MultiPlusII_227 obj-h95-reading charge_state<br /> attr MultiPlusII_227 obj-h95-unpack s&gt;<br /> attr MultiPlusII_227 obj-h96-len 1<br /> attr MultiPlusII_227 obj-h96-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h96-unpack s&gt;<br /> attr MultiPlusII_227 obj-h98-len 1<br /> attr MultiPlusII_227 obj-h98-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h98-unpack s&gt;<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Victron&diff=40050 Victron 2025-03-09T18:08:25Z <p>Stephan: /* Multiplus II */</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> === Multiplus II ===<br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-combine 5<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:On,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading switch_position<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack N<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack N<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack N<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack N<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack N<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack N<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack N<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 obj-h10-expr $val / 100<br /> attr MultiPlusII_227 obj-h10-len 1<br /> attr MultiPlusII_227 obj-h10-reading AC_Input_Frequency_L 2<br /> attr MultiPlusII_227 obj-h10-unpack s&gt;<br /> attr MultiPlusII_227 obj-h100-len 1<br /> attr MultiPlusII_227 obj-h100-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h100-unpack s&gt;<br /> attr MultiPlusII_227 obj-h102-len 1<br /> attr MultiPlusII_227 obj-h102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h102-unpack s&gt;<br /> attr MultiPlusII_227 obj-h103-len 1<br /> attr MultiPlusII_227 obj-h103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h103-unpack s&gt;<br /> attr MultiPlusII_227 obj-h104-len 1<br /> attr MultiPlusII_227 obj-h104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h104-unpack s&gt;<br /> attr MultiPlusII_227 obj-h105-len 1<br /> attr MultiPlusII_227 obj-h105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h105-unpack s&gt;<br /> attr MultiPlusII_227 obj-h106-expr $val / 100<br /> attr MultiPlusII_227 obj-h106-len 1<br /> attr MultiPlusII_227 obj-h106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h106-unpack s&gt;<br /> attr MultiPlusII_227 obj-h107-expr $val / 100<br /> attr MultiPlusII_227 obj-h107-len 1<br /> attr MultiPlusII_227 obj-h107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h107-unpack s&gt;<br /> attr MultiPlusII_227 obj-h108-len 1<br /> attr MultiPlusII_227 obj-h108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h108-unpack s&gt;<br /> attr MultiPlusII_227 obj-h109-len 1<br /> attr MultiPlusII_227 obj-h109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h109-unpack s&gt;<br /> attr MultiPlusII_227 obj-h11-expr $val / 100<br /> attr MultiPlusII_227 obj-h11-len 1<br /> attr MultiPlusII_227 obj-h11-reading AC_Input_Frequency_L 3<br /> attr MultiPlusII_227 obj-h11-unpack s&gt;<br /> attr MultiPlusII_227 obj-h12-expr $val * 10<br /> attr MultiPlusII_227 obj-h12-len 1<br /> attr MultiPlusII_227 obj-h12-reading AC_Input_Power_L 1<br /> attr MultiPlusII_227 obj-h12-unpack s&gt;<br /> attr MultiPlusII_227 obj-h13-expr $val * 10<br /> attr MultiPlusII_227 obj-h13-len 1<br /> attr MultiPlusII_227 obj-h13-reading AC_Input_Power_L 2<br /> attr MultiPlusII_227 obj-h13-unpack s&gt;<br /> attr MultiPlusII_227 obj-h14-expr $val * 10<br /> attr MultiPlusII_227 obj-h14-len 1<br /> attr MultiPlusII_227 obj-h14-reading AC_Input_Power_L 3<br /> attr MultiPlusII_227 obj-h14-unpack s&gt;<br /> attr MultiPlusII_227 obj-h15-expr $val / 10<br /> attr MultiPlusII_227 obj-h15-len 1<br /> attr MultiPlusII_227 obj-h15-reading AC_Output_Voltage_L 1<br /> attr MultiPlusII_227 obj-h15-unpack s&gt;<br /> attr MultiPlusII_227 obj-h16-expr $val / 10<br /> attr MultiPlusII_227 obj-h16-len 1<br /> attr MultiPlusII_227 obj-h16-reading AC_Output_Voltage_L 2<br /> attr MultiPlusII_227 obj-h16-unpack s&gt;<br /> attr MultiPlusII_227 obj-h17-expr $val / 10<br /> attr MultiPlusII_227 obj-h17-len 1<br /> attr MultiPlusII_227 obj-h17-reading AC_Output_Voltage_L 3<br /> attr MultiPlusII_227 obj-h17-unpack s&gt;<br /> attr MultiPlusII_227 obj-h18-expr $val / 10<br /> attr MultiPlusII_227 obj-h18-len 1<br /> attr MultiPlusII_227 obj-h18-reading AC_Output_Current_L 1<br /> attr MultiPlusII_227 obj-h18-unpack s&gt;<br /> attr MultiPlusII_227 obj-h19-expr $val / 10<br /> attr MultiPlusII_227 obj-h19-len 1<br /> attr MultiPlusII_227 obj-h19-reading AC_Output_Current_L 2<br /> attr MultiPlusII_227 obj-h19-unpack s&gt;<br /> attr MultiPlusII_227 obj-h20-expr $val / 10<br /> attr MultiPlusII_227 obj-h20-len 1<br /> attr MultiPlusII_227 obj-h20-reading AC_Output_Current_L 3<br /> attr MultiPlusII_227 obj-h20-unpack s&gt;<br /> attr MultiPlusII_227 obj-h21-expr $val / 100<br /> attr MultiPlusII_227 obj-h21-len 1<br /> attr MultiPlusII_227 obj-h21-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h21-unpack s&gt;<br /> attr MultiPlusII_227 obj-h22-expr $val / 10<br /> attr MultiPlusII_227 obj-h22-len 1<br /> attr MultiPlusII_227 obj-h22-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h22-unpack s&gt;<br /> attr MultiPlusII_227 obj-h23-expr $val * 10<br /> attr MultiPlusII_227 obj-h23-len 1<br /> attr MultiPlusII_227 obj-h23-reading AC_Output_Power_L 1<br /> attr MultiPlusII_227 obj-h23-unpack s&gt;<br /> attr MultiPlusII_227 obj-h24-expr $val * 10<br /> attr MultiPlusII_227 obj-h24-len 1<br /> attr MultiPlusII_227 obj-h24-reading AC_Output_Power_L 2<br /> attr MultiPlusII_227 obj-h24-unpack s&gt;<br /> attr MultiPlusII_227 obj-h25-expr $val * 10<br /> attr MultiPlusII_227 obj-h25-len 1<br /> attr MultiPlusII_227 obj-h25-reading AC_Output_Power_L 3<br /> attr MultiPlusII_227 obj-h25-unpack s&gt;<br /> attr MultiPlusII_227 obj-h26-expr $val / 100<br /> attr MultiPlusII_227 obj-h26-len 1<br /> attr MultiPlusII_227 obj-h26-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h26-unpack s&gt;<br /> attr MultiPlusII_227 obj-h27-expr $val / 10<br /> attr MultiPlusII_227 obj-h27-len 1<br /> attr MultiPlusII_227 obj-h27-reading Battery_Current<br /> attr MultiPlusII_227 obj-h27-unpack s&gt;<br /> attr MultiPlusII_227 obj-h28-len 1<br /> attr MultiPlusII_227 obj-h28-reading Phase_Count<br /> attr MultiPlusII_227 obj-h28-unpack s&gt;<br /> attr MultiPlusII_227 obj-h29-len 1<br /> attr MultiPlusII_227 obj-h29-reading Active_Input<br /> attr MultiPlusII_227 obj-h29-unpack s&gt;<br /> attr MultiPlusII_227 obj-h3-expr $val / 10<br /> attr MultiPlusII_227 obj-h3-len 1<br /> attr MultiPlusII_227 obj-h3-reading AC_Input_Voltage_L 1<br /> attr MultiPlusII_227 obj-h3-unpack n<br /> attr MultiPlusII_227 obj-h30-expr $val / 10<br /> attr MultiPlusII_227 obj-h30-len 1<br /> attr MultiPlusII_227 obj-h30-reading vebus_soc<br /> attr MultiPlusII_227 obj-h30-unpack s&gt;<br /> attr MultiPlusII_227 obj-h31-len 1<br /> attr MultiPlusII_227 obj-h31-reading vebus_state<br /> attr MultiPlusII_227 obj-h31-unpack s&gt;<br /> attr MultiPlusII_227 obj-h32-len 1<br /> attr MultiPlusII_227 obj-h32-reading vebus_error<br /> attr MultiPlusII_227 obj-h32-unpack s&gt;<br /> attr MultiPlusII_227 obj-h33-len 1<br /> attr MultiPlusII_227 obj-h33-reading switch_position<br /> attr MultiPlusII_227 obj-h33-unpack s&gt;<br /> attr MultiPlusII_227 obj-h34-len 1<br /> attr MultiPlusII_227 obj-h34-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h34-unpack s&gt;<br /> attr MultiPlusII_227 obj-h35-len 1<br /> attr MultiPlusII_227 obj-h35-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h35-unpack s&gt;<br /> attr MultiPlusII_227 obj-h36-len 1<br /> attr MultiPlusII_227 obj-h36-reading overload_alarm<br /> attr MultiPlusII_227 obj-h36-unpack s&gt;<br /> attr MultiPlusII_227 obj-h37-len 1<br /> attr MultiPlusII_227 obj-h37-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h37-unpack s&gt;<br /> attr MultiPlusII_227 obj-h38-len 1<br /> attr MultiPlusII_227 obj-h38-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h38-unpack s&gt;<br /> attr MultiPlusII_227 obj-h39-len 1<br /> attr MultiPlusII_227 obj-h39-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h39-unpack s&gt;<br /> attr MultiPlusII_227 obj-h4-expr $val / 10<br /> attr MultiPlusII_227 obj-h4-len 1 2<br /> attr MultiPlusII_227 obj-h4-reading AC_Input_Voltage_L 2<br /> attr MultiPlusII_227 obj-h4-unpack s&gt;<br /> attr MultiPlusII_227 obj-h40-len 1<br /> attr MultiPlusII_227 obj-h40-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h40-unpack s&gt;<br /> attr MultiPlusII_227 obj-h41-len 1<br /> attr MultiPlusII_227 obj-h41-reading ESS_Power_setpoint_L 3<br /> attr MultiPlusII_227 obj-h41-unpack s&gt;<br /> attr MultiPlusII_227 obj-h42-len 1<br /> attr MultiPlusII_227 obj-h42-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h42-unpack s&gt;<br /> attr MultiPlusII_227 obj-h43-len 1<br /> attr MultiPlusII_227 obj-h43-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h43-unpack s&gt;<br /> attr MultiPlusII_227 obj-h44-len 1<br /> attr MultiPlusII_227 obj-h44-reading temperature_alarm_L 1<br /> attr MultiPlusII_227 obj-h44-unpack s&gt;<br /> attr MultiPlusII_227 obj-h45-len 1<br /> attr MultiPlusII_227 obj-h45-reading low_battery_alarm_L 1<br /> attr MultiPlusII_227 obj-h45-unpack s&gt;<br /> attr MultiPlusII_227 obj-h46-len 1<br /> attr MultiPlusII_227 obj-h46-reading overload_alarm_L 1<br /> attr MultiPlusII_227 obj-h46-unpack s&gt;<br /> attr MultiPlusII_227 obj-h47-len 1<br /> attr MultiPlusII_227 obj-h47-reading ripple_alarm_L 1<br /> attr MultiPlusII_227 obj-h47-unpack s&gt;<br /> attr MultiPlusII_227 obj-h48-len 1<br /> attr MultiPlusII_227 obj-h48-reading temperature_alarm_L 2<br /> attr MultiPlusII_227 obj-h48-unpack s&gt;<br /> attr MultiPlusII_227 obj-h49-len 1<br /> attr MultiPlusII_227 obj-h49-reading low_battery_alarm_L 2<br /> attr MultiPlusII_227 obj-h49-unpack s&gt;<br /> attr MultiPlusII_227 obj-h5-expr $val / 10<br /> attr MultiPlusII_227 obj-h5-len 1<br /> attr MultiPlusII_227 obj-h5-reading AC_Input_Voltage_L 3<br /> attr MultiPlusII_227 obj-h5-unpack s&gt;<br /> attr MultiPlusII_227 obj-h50-len 1<br /> attr MultiPlusII_227 obj-h50-reading overload_alarm_L 2<br /> attr MultiPlusII_227 obj-h50-unpack s&gt;<br /> attr MultiPlusII_227 obj-h51-len 1<br /> attr MultiPlusII_227 obj-h51-reading ripple_alarm_L 2<br /> attr MultiPlusII_227 obj-h51-unpack s&gt;<br /> attr MultiPlusII_227 obj-h52-len 1<br /> attr MultiPlusII_227 obj-h52-reading temperature_alarm_L 3<br /> attr MultiPlusII_227 obj-h52-unpack s&gt;<br /> attr MultiPlusII_227 obj-h53-len 1<br /> attr MultiPlusII_227 obj-h53-reading low_battery_alarm_L 3<br /> attr MultiPlusII_227 obj-h53-unpack s&gt;<br /> attr MultiPlusII_227 obj-h54-len 1<br /> attr MultiPlusII_227 obj-h54-reading overload_alarm_L 3<br /> attr MultiPlusII_227 obj-h54-unpack s&gt;<br /> attr MultiPlusII_227 obj-h55-len 1<br /> attr MultiPlusII_227 obj-h55-reading ripple_alarm_L 3<br /> attr MultiPlusII_227 obj-h55-unpack s&gt;<br /> attr MultiPlusII_227 obj-h56-len 1<br /> attr MultiPlusII_227 obj-h56-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h56-unpack s&gt;<br /> attr MultiPlusII_227 obj-h57-len 1<br /> attr MultiPlusII_227 obj-h57-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h57-unpack s&gt;<br /> attr MultiPlusII_227 obj-h58-len 1<br /> attr MultiPlusII_227 obj-h58-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h58-unpack s&gt;<br /> attr MultiPlusII_227 obj-h59-len 1<br /> attr MultiPlusII_227 obj-h59-reading bms_expected<br /> attr MultiPlusII_227 obj-h59-unpack s&gt;<br /> attr MultiPlusII_227 obj-h6-expr $val / 10<br /> attr MultiPlusII_227 obj-h6-len 1<br /> attr MultiPlusII_227 obj-h6-reading AC_Input_Current_L 1<br /> attr MultiPlusII_227 obj-h6-unpack s&gt;<br /> attr MultiPlusII_227 obj-h60-len 1<br /> attr MultiPlusII_227 obj-h60-reading bms_error<br /> attr MultiPlusII_227 obj-h60-unpack s&gt;<br /> attr MultiPlusII_227 obj-h61-expr $val / 10<br /> attr MultiPlusII_227 obj-h61-len 1<br /> attr MultiPlusII_227 obj-h61-reading temperature_battery<br /> attr MultiPlusII_227 obj-h61-unpack s&gt;<br /> attr MultiPlusII_227 obj-h62-len 1<br /> attr MultiPlusII_227 obj-h62-reading vebus_reset<br /> attr MultiPlusII_227 obj-h62-unpack s&gt;<br /> attr MultiPlusII_227 obj-h63-len 1<br /> attr MultiPlusII_227 obj-h63-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h63-unpack s&gt;<br /> attr MultiPlusII_227 obj-h64-len 1<br /> attr MultiPlusII_227 obj-h64-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h64-unpack s&gt;<br /> attr MultiPlusII_227 obj-h65-len 1<br /> attr MultiPlusII_227 obj-h65-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h65-unpack s&gt;<br /> attr MultiPlusII_227 obj-h66-expr $val * 100<br /> attr MultiPlusII_227 obj-h66-len 1<br /> attr MultiPlusII_227 obj-h66-reading maximum_overvoltage_feedin_power_L 1<br /> attr MultiPlusII_227 obj-h66-unpack s&gt;<br /> attr MultiPlusII_227 obj-h67-expr $val * 100<br /> attr MultiPlusII_227 obj-h67-len 1<br /> attr MultiPlusII_227 obj-h67-reading maximum_overvoltage_feedin_power_L 2<br /> attr MultiPlusII_227 obj-h67-unpack s&gt;<br /> attr MultiPlusII_227 obj-h68-expr $val * 100<br /> attr MultiPlusII_227 obj-h68-len 1<br /> attr MultiPlusII_227 obj-h68-reading maximum_overvoltage_feedin_power_L 3<br /> attr MultiPlusII_227 obj-h68-unpack s&gt;<br /> attr MultiPlusII_227 obj-h69-len 1<br /> attr MultiPlusII_227 obj-h69-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h69-unpack s&gt;<br /> attr MultiPlusII_227 obj-h7-expr $val / 10<br /> attr MultiPlusII_227 obj-h7-len 1<br /> attr MultiPlusII_227 obj-h7-reading AC_Input_Current_L 2<br /> attr MultiPlusII_227 obj-h7-unpack s&gt;<br /> attr MultiPlusII_227 obj-h70-len 1<br /> attr MultiPlusII_227 obj-h70-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h70-unpack s&gt;<br /> attr MultiPlusII_227 obj-h71-len 1<br /> attr MultiPlusII_227 obj-h71-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h71-unpack s&gt;<br /> attr MultiPlusII_227 obj-h72-len 1<br /> attr MultiPlusII_227 obj-h72-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h72-unpack s&gt;<br /> attr MultiPlusII_227 obj-h73-len 1<br /> attr MultiPlusII_227 obj-h73-reading sustain_active<br /> attr MultiPlusII_227 obj-h73-unpack s&gt;<br /> attr MultiPlusII_227 obj-h74-expr $val / 100<br /> attr MultiPlusII_227 obj-h74-len 1<br /> attr MultiPlusII_227 obj-h74-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h74-unpack s&gt;<br /> attr MultiPlusII_227 obj-h76-expr $val / 100<br /> attr MultiPlusII_227 obj-h76-len 1<br /> attr MultiPlusII_227 obj-h76-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h76-unpack s&gt;<br /> attr MultiPlusII_227 obj-h78-expr $val / 100<br /> attr MultiPlusII_227 obj-h78-len 1<br /> attr MultiPlusII_227 obj-h78-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h78-unpack s&gt;<br /> attr MultiPlusII_227 obj-h8-expr $val / 10<br /> attr MultiPlusII_227 obj-h8-len 1<br /> attr MultiPlusII_227 obj-h8-reading AC_Input_Current_L 3<br /> attr MultiPlusII_227 obj-h8-unpack s&gt;<br /> attr MultiPlusII_227 obj-h80-expr $val / 100<br /> attr MultiPlusII_227 obj-h80-len 1<br /> attr MultiPlusII_227 obj-h80-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h80-unpack s&gt;<br /> attr MultiPlusII_227 obj-h82-expr $val / 100<br /> attr MultiPlusII_227 obj-h82-len 1<br /> attr MultiPlusII_227 obj-h82-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h82-unpack s&gt;<br /> attr MultiPlusII_227 obj-h84-expr $val / 100<br /> attr MultiPlusII_227 obj-h84-len 1<br /> attr MultiPlusII_227 obj-h84-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h84-unpack s&gt;<br /> attr MultiPlusII_227 obj-h86-expr $val / 100<br /> attr MultiPlusII_227 obj-h86-len 1<br /> attr MultiPlusII_227 obj-h86-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h86-unpack s&gt;<br /> attr MultiPlusII_227 obj-h88-expr $val / 100<br /> attr MultiPlusII_227 obj-h88-len 1<br /> attr MultiPlusII_227 obj-h88-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h88-unpack s&gt;<br /> attr MultiPlusII_227 obj-h9-expr $val / 100<br /> attr MultiPlusII_227 obj-h9-len 1<br /> attr MultiPlusII_227 obj-h9-reading AC_Input_Frequency_L 1<br /> attr MultiPlusII_227 obj-h9-unpack s&gt;<br /> attr MultiPlusII_227 obj-h90-expr $val / 100<br /> attr MultiPlusII_227 obj-h90-len 1<br /> attr MultiPlusII_227 obj-h90-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h90-unpack s&gt;<br /> attr MultiPlusII_227 obj-h92-expr $val / 100<br /> attr MultiPlusII_227 obj-h92-len 1<br /> attr MultiPlusII_227 obj-h92-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h92-unpack s&gt;<br /> attr MultiPlusII_227 obj-h94-len 1<br /> attr MultiPlusII_227 obj-h94-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h94-unpack s&gt;<br /> attr MultiPlusII_227 obj-h95-len 1<br /> attr MultiPlusII_227 obj-h95-reading charge_state<br /> attr MultiPlusII_227 obj-h95-unpack s&gt;<br /> attr MultiPlusII_227 obj-h96-len 1<br /> attr MultiPlusII_227 obj-h96-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h96-unpack s&gt;<br /> attr MultiPlusII_227 obj-h98-len 1<br /> attr MultiPlusII_227 obj-h98-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h98-unpack s&gt;<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Victron&diff=40049 Victron 2025-03-09T17:22:34Z <p>Stephan: /* Einbindung über ModbusAttr */ Überschrift eingefügt</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> === Multiplus II ===<br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-combine 5<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:On,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading switch_position<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 obj-h10-expr $val / 100<br /> attr MultiPlusII_227 obj-h10-len 1<br /> attr MultiPlusII_227 obj-h10-reading AC_Input_Frequency_L 2<br /> attr MultiPlusII_227 obj-h10-unpack s&gt;<br /> attr MultiPlusII_227 obj-h100-len 1<br /> attr MultiPlusII_227 obj-h100-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h100-unpack s&gt;<br /> attr MultiPlusII_227 obj-h102-len 1<br /> attr MultiPlusII_227 obj-h102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h102-unpack s&gt;<br /> attr MultiPlusII_227 obj-h103-len 1<br /> attr MultiPlusII_227 obj-h103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h103-unpack s&gt;<br /> attr MultiPlusII_227 obj-h104-len 1<br /> attr MultiPlusII_227 obj-h104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h104-unpack s&gt;<br /> attr MultiPlusII_227 obj-h105-len 1<br /> attr MultiPlusII_227 obj-h105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h105-unpack s&gt;<br /> attr MultiPlusII_227 obj-h106-expr $val / 100<br /> attr MultiPlusII_227 obj-h106-len 1<br /> attr MultiPlusII_227 obj-h106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h106-unpack s&gt;<br /> attr MultiPlusII_227 obj-h107-expr $val / 100<br /> attr MultiPlusII_227 obj-h107-len 1<br /> attr MultiPlusII_227 obj-h107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h107-unpack s&gt;<br /> attr MultiPlusII_227 obj-h108-len 1<br /> attr MultiPlusII_227 obj-h108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h108-unpack s&gt;<br /> attr MultiPlusII_227 obj-h109-len 1<br /> attr MultiPlusII_227 obj-h109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h109-unpack s&gt;<br /> attr MultiPlusII_227 obj-h11-expr $val / 100<br /> attr MultiPlusII_227 obj-h11-len 1<br /> attr MultiPlusII_227 obj-h11-reading AC_Input_Frequency_L 3<br /> attr MultiPlusII_227 obj-h11-unpack s&gt;<br /> attr MultiPlusII_227 obj-h12-expr $val * 10<br /> attr MultiPlusII_227 obj-h12-len 1<br /> attr MultiPlusII_227 obj-h12-reading AC_Input_Power_L 1<br /> attr MultiPlusII_227 obj-h12-unpack s&gt;<br /> attr MultiPlusII_227 obj-h13-expr $val * 10<br /> attr MultiPlusII_227 obj-h13-len 1<br /> attr MultiPlusII_227 obj-h13-reading AC_Input_Power_L 2<br /> attr MultiPlusII_227 obj-h13-unpack s&gt;<br /> attr MultiPlusII_227 obj-h14-expr $val * 10<br /> attr MultiPlusII_227 obj-h14-len 1<br /> attr MultiPlusII_227 obj-h14-reading AC_Input_Power_L 3<br /> attr MultiPlusII_227 obj-h14-unpack s&gt;<br /> attr MultiPlusII_227 obj-h15-expr $val / 10<br /> attr MultiPlusII_227 obj-h15-len 1<br /> attr MultiPlusII_227 obj-h15-reading AC_Output_Voltage_L 1<br /> attr MultiPlusII_227 obj-h15-unpack s&gt;<br /> attr MultiPlusII_227 obj-h16-expr $val / 10<br /> attr MultiPlusII_227 obj-h16-len 1<br /> attr MultiPlusII_227 obj-h16-reading AC_Output_Voltage_L 2<br /> attr MultiPlusII_227 obj-h16-unpack s&gt;<br /> attr MultiPlusII_227 obj-h17-expr $val / 10<br /> attr MultiPlusII_227 obj-h17-len 1<br /> attr MultiPlusII_227 obj-h17-reading AC_Output_Voltage_L 3<br /> attr MultiPlusII_227 obj-h17-unpack s&gt;<br /> attr MultiPlusII_227 obj-h18-expr $val / 10<br /> attr MultiPlusII_227 obj-h18-len 1<br /> attr MultiPlusII_227 obj-h18-reading AC_Output_Current_L 1<br /> attr MultiPlusII_227 obj-h18-unpack s&gt;<br /> attr MultiPlusII_227 obj-h19-expr $val / 10<br /> attr MultiPlusII_227 obj-h19-len 1<br /> attr MultiPlusII_227 obj-h19-reading AC_Output_Current_L 2<br /> attr MultiPlusII_227 obj-h19-unpack s&gt;<br /> attr MultiPlusII_227 obj-h20-expr $val / 10<br /> attr MultiPlusII_227 obj-h20-len 1<br /> attr MultiPlusII_227 obj-h20-reading AC_Output_Current_L 3<br /> attr MultiPlusII_227 obj-h20-unpack s&gt;<br /> attr MultiPlusII_227 obj-h21-expr $val / 100<br /> attr MultiPlusII_227 obj-h21-len 1<br /> attr MultiPlusII_227 obj-h21-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h21-unpack s&gt;<br /> attr MultiPlusII_227 obj-h22-expr $val / 10<br /> attr MultiPlusII_227 obj-h22-len 1<br /> attr MultiPlusII_227 obj-h22-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h22-unpack s&gt;<br /> attr MultiPlusII_227 obj-h23-expr $val * 10<br /> attr MultiPlusII_227 obj-h23-len 1<br /> attr MultiPlusII_227 obj-h23-reading AC_Output_Power_L 1<br /> attr MultiPlusII_227 obj-h23-unpack s&gt;<br /> attr MultiPlusII_227 obj-h24-expr $val * 10<br /> attr MultiPlusII_227 obj-h24-len 1<br /> attr MultiPlusII_227 obj-h24-reading AC_Output_Power_L 2<br /> attr MultiPlusII_227 obj-h24-unpack s&gt;<br /> attr MultiPlusII_227 obj-h25-expr $val * 10<br /> attr MultiPlusII_227 obj-h25-len 1<br /> attr MultiPlusII_227 obj-h25-reading AC_Output_Power_L 3<br /> attr MultiPlusII_227 obj-h25-unpack s&gt;<br /> attr MultiPlusII_227 obj-h26-expr $val / 100<br /> attr MultiPlusII_227 obj-h26-len 1<br /> attr MultiPlusII_227 obj-h26-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h26-unpack s&gt;<br /> attr MultiPlusII_227 obj-h27-expr $val / 10<br /> attr MultiPlusII_227 obj-h27-len 1<br /> attr MultiPlusII_227 obj-h27-reading Battery_Current<br /> attr MultiPlusII_227 obj-h27-unpack s&gt;<br /> attr MultiPlusII_227 obj-h28-len 1<br /> attr MultiPlusII_227 obj-h28-reading Phase_Count<br /> attr MultiPlusII_227 obj-h28-unpack s&gt;<br /> attr MultiPlusII_227 obj-h29-len 1<br /> attr MultiPlusII_227 obj-h29-reading Active_Input<br /> attr MultiPlusII_227 obj-h29-unpack s&gt;<br /> attr MultiPlusII_227 obj-h3-expr $val / 10<br /> attr MultiPlusII_227 obj-h3-len 1<br /> attr MultiPlusII_227 obj-h3-reading AC_Input_Voltage_L 1<br /> attr MultiPlusII_227 obj-h3-unpack n<br /> attr MultiPlusII_227 obj-h30-expr $val / 10<br /> attr MultiPlusII_227 obj-h30-len 1<br /> attr MultiPlusII_227 obj-h30-reading vebus_soc<br /> attr MultiPlusII_227 obj-h30-unpack s&gt;<br /> attr MultiPlusII_227 obj-h31-len 1<br /> attr MultiPlusII_227 obj-h31-reading vebus_state<br /> attr MultiPlusII_227 obj-h31-unpack s&gt;<br /> attr MultiPlusII_227 obj-h32-len 1<br /> attr MultiPlusII_227 obj-h32-reading vebus_error<br /> attr MultiPlusII_227 obj-h32-unpack s&gt;<br /> attr MultiPlusII_227 obj-h33-len 1<br /> attr MultiPlusII_227 obj-h33-reading switch_position<br /> attr MultiPlusII_227 obj-h33-unpack s&gt;<br /> attr MultiPlusII_227 obj-h34-len 1<br /> attr MultiPlusII_227 obj-h34-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h34-unpack s&gt;<br /> attr MultiPlusII_227 obj-h35-len 1<br /> attr MultiPlusII_227 obj-h35-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h35-unpack s&gt;<br /> attr MultiPlusII_227 obj-h36-len 1<br /> attr MultiPlusII_227 obj-h36-reading overload_alarm<br /> attr MultiPlusII_227 obj-h36-unpack s&gt;<br /> attr MultiPlusII_227 obj-h37-len 1<br /> attr MultiPlusII_227 obj-h37-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h37-unpack s&gt;<br /> attr MultiPlusII_227 obj-h38-len 1<br /> attr MultiPlusII_227 obj-h38-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h38-unpack s&gt;<br /> attr MultiPlusII_227 obj-h39-len 1<br /> attr MultiPlusII_227 obj-h39-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h39-unpack s&gt;<br /> attr MultiPlusII_227 obj-h4-expr $val / 10<br /> attr MultiPlusII_227 obj-h4-len 1 2<br /> attr MultiPlusII_227 obj-h4-reading AC_Input_Voltage_L 2<br /> attr MultiPlusII_227 obj-h4-unpack s&gt;<br /> attr MultiPlusII_227 obj-h40-len 1<br /> attr MultiPlusII_227 obj-h40-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h40-unpack s&gt;<br /> attr MultiPlusII_227 obj-h41-len 1<br /> attr MultiPlusII_227 obj-h41-reading ESS_Power_setpoint_L 3<br /> attr MultiPlusII_227 obj-h41-unpack s&gt;<br /> attr MultiPlusII_227 obj-h42-len 1<br /> attr MultiPlusII_227 obj-h42-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h42-unpack s&gt;<br /> attr MultiPlusII_227 obj-h43-len 1<br /> attr MultiPlusII_227 obj-h43-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h43-unpack s&gt;<br /> attr MultiPlusII_227 obj-h44-len 1<br /> attr MultiPlusII_227 obj-h44-reading temperature_alarm_L 1<br /> attr MultiPlusII_227 obj-h44-unpack s&gt;<br /> attr MultiPlusII_227 obj-h45-len 1<br /> attr MultiPlusII_227 obj-h45-reading low_battery_alarm_L 1<br /> attr MultiPlusII_227 obj-h45-unpack s&gt;<br /> attr MultiPlusII_227 obj-h46-len 1<br /> attr MultiPlusII_227 obj-h46-reading overload_alarm_L 1<br /> attr MultiPlusII_227 obj-h46-unpack s&gt;<br /> attr MultiPlusII_227 obj-h47-len 1<br /> attr MultiPlusII_227 obj-h47-reading ripple_alarm_L 1<br /> attr MultiPlusII_227 obj-h47-unpack s&gt;<br /> attr MultiPlusII_227 obj-h48-len 1<br /> attr MultiPlusII_227 obj-h48-reading temperature_alarm_L 2<br /> attr MultiPlusII_227 obj-h48-unpack s&gt;<br /> attr MultiPlusII_227 obj-h49-len 1<br /> attr MultiPlusII_227 obj-h49-reading low_battery_alarm_L 2<br /> attr MultiPlusII_227 obj-h49-unpack s&gt;<br /> attr MultiPlusII_227 obj-h5-expr $val / 10<br /> attr MultiPlusII_227 obj-h5-len 1<br /> attr MultiPlusII_227 obj-h5-reading AC_Input_Voltage_L 3<br /> attr MultiPlusII_227 obj-h5-unpack s&gt;<br /> attr MultiPlusII_227 obj-h50-len 1<br /> attr MultiPlusII_227 obj-h50-reading overload_alarm_L 2<br /> attr MultiPlusII_227 obj-h50-unpack s&gt;<br /> attr MultiPlusII_227 obj-h51-len 1<br /> attr MultiPlusII_227 obj-h51-reading ripple_alarm_L 2<br /> attr MultiPlusII_227 obj-h51-unpack s&gt;<br /> attr MultiPlusII_227 obj-h52-len 1<br /> attr MultiPlusII_227 obj-h52-reading temperature_alarm_L 3<br /> attr MultiPlusII_227 obj-h52-unpack s&gt;<br /> attr MultiPlusII_227 obj-h53-len 1<br /> attr MultiPlusII_227 obj-h53-reading low_battery_alarm_L 3<br /> attr MultiPlusII_227 obj-h53-unpack s&gt;<br /> attr MultiPlusII_227 obj-h54-len 1<br /> attr MultiPlusII_227 obj-h54-reading overload_alarm_L 3<br /> attr MultiPlusII_227 obj-h54-unpack s&gt;<br /> attr MultiPlusII_227 obj-h55-len 1<br /> attr MultiPlusII_227 obj-h55-reading ripple_alarm_L 3<br /> attr MultiPlusII_227 obj-h55-unpack s&gt;<br /> attr MultiPlusII_227 obj-h56-len 1<br /> attr MultiPlusII_227 obj-h56-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h56-unpack s&gt;<br /> attr MultiPlusII_227 obj-h57-len 1<br /> attr MultiPlusII_227 obj-h57-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h57-unpack s&gt;<br /> attr MultiPlusII_227 obj-h58-len 1<br /> attr MultiPlusII_227 obj-h58-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h58-unpack s&gt;<br /> attr MultiPlusII_227 obj-h59-len 1<br /> attr MultiPlusII_227 obj-h59-reading bms_expected<br /> attr MultiPlusII_227 obj-h59-unpack s&gt;<br /> attr MultiPlusII_227 obj-h6-expr $val / 10<br /> attr MultiPlusII_227 obj-h6-len 1<br /> attr MultiPlusII_227 obj-h6-reading AC_Input_Current_L 1<br /> attr MultiPlusII_227 obj-h6-unpack s&gt;<br /> attr MultiPlusII_227 obj-h60-len 1<br /> attr MultiPlusII_227 obj-h60-reading bms_error<br /> attr MultiPlusII_227 obj-h60-unpack s&gt;<br /> attr MultiPlusII_227 obj-h61-expr $val / 10<br /> attr MultiPlusII_227 obj-h61-len 1<br /> attr MultiPlusII_227 obj-h61-reading temperature_battery<br /> attr MultiPlusII_227 obj-h61-unpack s&gt;<br /> attr MultiPlusII_227 obj-h62-len 1<br /> attr MultiPlusII_227 obj-h62-reading vebus_reset<br /> attr MultiPlusII_227 obj-h62-unpack s&gt;<br /> attr MultiPlusII_227 obj-h63-len 1<br /> attr MultiPlusII_227 obj-h63-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h63-unpack s&gt;<br /> attr MultiPlusII_227 obj-h64-len 1<br /> attr MultiPlusII_227 obj-h64-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h64-unpack s&gt;<br /> attr MultiPlusII_227 obj-h65-len 1<br /> attr MultiPlusII_227 obj-h65-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h65-unpack s&gt;<br /> attr MultiPlusII_227 obj-h66-expr $val * 100<br /> attr MultiPlusII_227 obj-h66-len 1<br /> attr MultiPlusII_227 obj-h66-reading maximum_overvoltage_feedin_power_L 1<br /> attr MultiPlusII_227 obj-h66-unpack s&gt;<br /> attr MultiPlusII_227 obj-h67-expr $val * 100<br /> attr MultiPlusII_227 obj-h67-len 1<br /> attr MultiPlusII_227 obj-h67-reading maximum_overvoltage_feedin_power_L 2<br /> attr MultiPlusII_227 obj-h67-unpack s&gt;<br /> attr MultiPlusII_227 obj-h68-expr $val * 100<br /> attr MultiPlusII_227 obj-h68-len 1<br /> attr MultiPlusII_227 obj-h68-reading maximum_overvoltage_feedin_power_L 3<br /> attr MultiPlusII_227 obj-h68-unpack s&gt;<br /> attr MultiPlusII_227 obj-h69-len 1<br /> attr MultiPlusII_227 obj-h69-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h69-unpack s&gt;<br /> attr MultiPlusII_227 obj-h7-expr $val / 10<br /> attr MultiPlusII_227 obj-h7-len 1<br /> attr MultiPlusII_227 obj-h7-reading AC_Input_Current_L 2<br /> attr MultiPlusII_227 obj-h7-unpack s&gt;<br /> attr MultiPlusII_227 obj-h70-len 1<br /> attr MultiPlusII_227 obj-h70-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h70-unpack s&gt;<br /> attr MultiPlusII_227 obj-h71-len 1<br /> attr MultiPlusII_227 obj-h71-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h71-unpack s&gt;<br /> attr MultiPlusII_227 obj-h72-len 1<br /> attr MultiPlusII_227 obj-h72-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h72-unpack s&gt;<br /> attr MultiPlusII_227 obj-h73-len 1<br /> attr MultiPlusII_227 obj-h73-reading sustain_active<br /> attr MultiPlusII_227 obj-h73-unpack s&gt;<br /> attr MultiPlusII_227 obj-h74-expr $val / 100<br /> attr MultiPlusII_227 obj-h74-len 1<br /> attr MultiPlusII_227 obj-h74-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h74-unpack s&gt;<br /> attr MultiPlusII_227 obj-h76-expr $val / 100<br /> attr MultiPlusII_227 obj-h76-len 1<br /> attr MultiPlusII_227 obj-h76-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h76-unpack s&gt;<br /> attr MultiPlusII_227 obj-h78-expr $val / 100<br /> attr MultiPlusII_227 obj-h78-len 1<br /> attr MultiPlusII_227 obj-h78-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h78-unpack s&gt;<br /> attr MultiPlusII_227 obj-h8-expr $val / 10<br /> attr MultiPlusII_227 obj-h8-len 1<br /> attr MultiPlusII_227 obj-h8-reading AC_Input_Current_L 3<br /> attr MultiPlusII_227 obj-h8-unpack s&gt;<br /> attr MultiPlusII_227 obj-h80-expr $val / 100<br /> attr MultiPlusII_227 obj-h80-len 1<br /> attr MultiPlusII_227 obj-h80-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h80-unpack s&gt;<br /> attr MultiPlusII_227 obj-h82-expr $val / 100<br /> attr MultiPlusII_227 obj-h82-len 1<br /> attr MultiPlusII_227 obj-h82-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h82-unpack s&gt;<br /> attr MultiPlusII_227 obj-h84-expr $val / 100<br /> attr MultiPlusII_227 obj-h84-len 1<br /> attr MultiPlusII_227 obj-h84-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h84-unpack s&gt;<br /> attr MultiPlusII_227 obj-h86-expr $val / 100<br /> attr MultiPlusII_227 obj-h86-len 1<br /> attr MultiPlusII_227 obj-h86-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h86-unpack s&gt;<br /> attr MultiPlusII_227 obj-h88-expr $val / 100<br /> attr MultiPlusII_227 obj-h88-len 1<br /> attr MultiPlusII_227 obj-h88-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h88-unpack s&gt;<br /> attr MultiPlusII_227 obj-h9-expr $val / 100<br /> attr MultiPlusII_227 obj-h9-len 1<br /> attr MultiPlusII_227 obj-h9-reading AC_Input_Frequency_L 1<br /> attr MultiPlusII_227 obj-h9-unpack s&gt;<br /> attr MultiPlusII_227 obj-h90-expr $val / 100<br /> attr MultiPlusII_227 obj-h90-len 1<br /> attr MultiPlusII_227 obj-h90-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h90-unpack s&gt;<br /> attr MultiPlusII_227 obj-h92-expr $val / 100<br /> attr MultiPlusII_227 obj-h92-len 1<br /> attr MultiPlusII_227 obj-h92-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h92-unpack s&gt;<br /> attr MultiPlusII_227 obj-h94-len 1<br /> attr MultiPlusII_227 obj-h94-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h94-unpack s&gt;<br /> attr MultiPlusII_227 obj-h95-len 1<br /> attr MultiPlusII_227 obj-h95-reading charge_state<br /> attr MultiPlusII_227 obj-h95-unpack s&gt;<br /> attr MultiPlusII_227 obj-h96-len 1<br /> attr MultiPlusII_227 obj-h96-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h96-unpack s&gt;<br /> attr MultiPlusII_227 obj-h98-len 1<br /> attr MultiPlusII_227 obj-h98-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h98-unpack s&gt;<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Victron&diff=40048 Victron 2025-03-09T17:21:50Z <p>Stephan: fertiges, funktionsfähiges Modbusattr für einen Multiplus II hinzugefügt.</p> <hr /> <div>==Übersicht==<br /> Die Familie der Solarlade und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, daß die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [https://de.wikipedia.org/wiki/MQTT MQTT] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.<br /> <br /> Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information<br /> <br /> ==Einbindung in fhem als MQTT2_DEVICE==<br /> Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt. (Hier ist die IP noch anzupasssen.)<br /> defmod venus MQTT2_CLIENT 10.1.x.x:1883<br /> attr venus autocreate complex<br /> attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE<br /> attr venus room MQTT2_DEVICE<br /> attr venus verbose 4<br /> <br /> Das Wechselrichter wird dann als MQTT2_DEVICE angelegt: <br /> defmod MQTT2_mp2 MQTT2_DEVICE venus<br /> attr MQTT2_mp2 IODev venus<br /> <br /> ===== Aufbau der Topics von Victron =====<br /> Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als &lt;vrm_ID&gt; auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen. <br /> <br /> Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden. <br /> * system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte<br /> * solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485) , Wartung per Bluetooth und App<br /> * grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler] , Anschluß über RS-485 / wahlweise Ethernet <br /> * vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll<br /> <br /> N/&lt;vrm_ID&gt;/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }<br /> N/&lt;vrm_ID&gt;/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }<br /> <br /> ===== Topics zum Schreiben =====<br /> Einige Enstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann <br /> * An- und Abschalten<br /> * Inverter- und Charger Mode<br /> * Mode: Betriebszustand<br /> * CurrentLimit: max. Strom aus/in das Netz<br /> * MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt<br /> * Relay[0|1]: Schalte interne Relais<br /> Eine einfache Setlist:<br /> <br /> off W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:4}<br /> on W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:3}<br /> inv W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:2}<br /> chg W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:1}<br /> Mode W/&lt;vrm_ID&gt;/vebus/288/Mode {&quot;value&quot;:$EVTPART1}<br /> GridCurrentLimit W/&lt;vrm_ID&gt;/vebus/288/Ac/In/1/CurrentLimit {&quot;value&quot;:$EVTPART1}<br /> MinSOC W/&lt;vrm_ID&gt;/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {&quot;value&quot;:$EVTPART1}<br /> Relay0 W/&lt;vrm_ID&gt;/system/0/Relay/0/State:.* {&quot;value&quot;:$EVTPART1}<br /> Relay1 W/&lt;vrm_ID&gt;/system/0/Relay/1/State:.* {&quot;value&quot;:$EVTPART1}<br /> <br /> <br /> ==Einbindung über ModbusAttr== <br /> Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt. <br /> Dies kann man dem Excel &quot;Modbus-TCP Register List unter Link 1 entnehmen. <br /> <br /> Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.<br /> <br /> <br /> &lt;syntaxhighlight&gt;<br /> defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP<br /> attr MultiPlusII_227 dev-h-combine 5<br /> attr MultiPlusII_227 dev-h-defPoll 1<br /> attr MultiPlusII_227 obj-h0003-expr $val / 10<br /> attr MultiPlusII_227 obj-h0003-len 2<br /> attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1<br /> attr MultiPlusII_227 obj-h0003-unpack n<br /> attr MultiPlusII_227 obj-h0004-expr $val / 10<br /> attr MultiPlusII_227 obj-h0004-len 2<br /> attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2<br /> attr MultiPlusII_227 obj-h0004-unpack n<br /> attr MultiPlusII_227 obj-h0005-expr $val / 10<br /> attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3<br /> attr MultiPlusII_227 obj-h0005-unpack n<br /> attr MultiPlusII_227 obj-h0006-expr $val / 10<br /> attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1<br /> attr MultiPlusII_227 obj-h0006-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0007-expr $val / 10<br /> attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0007-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0008-expr $val / 10<br /> attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3<br /> attr MultiPlusII_227 obj-h0008-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0009-expr $val / 100<br /> attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1<br /> attr MultiPlusII_227 obj-h0009-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0010-expr $val / 100<br /> attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2<br /> attr MultiPlusII_227 obj-h0010-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0011-expr $val / 100<br /> attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3<br /> attr MultiPlusII_227 obj-h0011-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0012-expr $val * 10<br /> attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1<br /> attr MultiPlusII_227 obj-h0012-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0013-expr $val * 10<br /> attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2<br /> attr MultiPlusII_227 obj-h0013-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0014-expr $val * 10<br /> attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3<br /> attr MultiPlusII_227 obj-h0014-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0015-expr $val / 10<br /> attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1<br /> attr MultiPlusII_227 obj-h0015-unpack n<br /> attr MultiPlusII_227 obj-h0016-expr $val / 10<br /> attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2<br /> attr MultiPlusII_227 obj-h0016-unpack n<br /> attr MultiPlusII_227 obj-h0017-expr $val / 10<br /> attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3<br /> attr MultiPlusII_227 obj-h0017-unpack n<br /> attr MultiPlusII_227 obj-h0018-expr $val / 10<br /> attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1<br /> attr MultiPlusII_227 obj-h0018-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0019-expr $val / 10<br /> attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2<br /> attr MultiPlusII_227 obj-h0019-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0020-expr $val / 10<br /> attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3<br /> attr MultiPlusII_227 obj-h0020-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0021-expr $val / 100<br /> attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h0021-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0022-expr $val / 10<br /> attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h0022-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0023-expr $val * 10<br /> attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1<br /> attr MultiPlusII_227 obj-h0023-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0024-expr $val * 10<br /> attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2<br /> attr MultiPlusII_227 obj-h0024-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0025-expr $val * 10<br /> attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3<br /> attr MultiPlusII_227 obj-h0025-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0026-expr $val / 100<br /> attr MultiPlusII_227 obj-h0026-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h0026-unpack n<br /> attr MultiPlusII_227 obj-h0027-expr $val / 10<br /> attr MultiPlusII_227 obj-h0027-reading Battery_Current<br /> attr MultiPlusII_227 obj-h0027-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0028-reading Phase_Count<br /> attr MultiPlusII_227 obj-h0028-unpack n<br /> attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected<br /> attr MultiPlusII_227 obj-h0029-reading Active_Input<br /> attr MultiPlusII_227 obj-h0029-unpack n<br /> attr MultiPlusII_227 obj-h0030-expr $val / 10<br /> attr MultiPlusII_227 obj-h0030-reading vebus_soc<br /> attr MultiPlusII_227 obj-h0030-unpack n<br /> attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL<br /> attr MultiPlusII_227 obj-h0031-reading vebus_state<br /> attr MultiPlusII_227 obj-h0031-unpack n<br /> attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error<br /> attr MultiPlusII_227 obj-h0032-reading vebus_error<br /> attr MultiPlusII_227 obj-h0032-unpack n<br /> attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:On,4:Off<br /> attr MultiPlusII_227 obj-h0033-reading switch_position<br /> attr MultiPlusII_227 obj-h0033-unpack n<br /> attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0034-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h0034-unpack n<br /> attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0035-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h0035-unpack n<br /> attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0036-reading overload_alarm<br /> attr MultiPlusII_227 obj-h0036-unpack n<br /> attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0037-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled<br /> attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h0038-unpack n<br /> attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled<br /> attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h0039-unpack n<br /> attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0040-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3<br /> attr MultiPlusII_227 obj-h0041-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h0042-unpack n<br /> attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h0043-unpack n<br /> attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1<br /> attr MultiPlusII_227 obj-h0044-unpack n<br /> attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1<br /> attr MultiPlusII_227 obj-h0045-unpack n<br /> attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1<br /> attr MultiPlusII_227 obj-h0046-unpack n<br /> attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1<br /> attr MultiPlusII_227 obj-h0047-unpack n<br /> attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2<br /> attr MultiPlusII_227 obj-h0048-unpack n<br /> attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2<br /> attr MultiPlusII_227 obj-h0049-unpack n<br /> attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2<br /> attr MultiPlusII_227 obj-h0050-unpack n<br /> attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2<br /> attr MultiPlusII_227 obj-h0051-unpack n<br /> attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3<br /> attr MultiPlusII_227 obj-h0052-unpack n<br /> attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3<br /> attr MultiPlusII_227 obj-h0053-unpack n<br /> attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3<br /> attr MultiPlusII_227 obj-h0054-unpack n<br /> attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm<br /> attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3<br /> attr MultiPlusII_227 obj-h0055-unpack n<br /> attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled<br /> attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h0056-unpack n<br /> attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0057-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h0057-unpack n<br /> attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h0058-unpack n<br /> attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0059-reading bms_expected<br /> attr MultiPlusII_227 obj-h0059-unpack n<br /> attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes<br /> attr MultiPlusII_227 obj-h0060-reading bms_error<br /> attr MultiPlusII_227 obj-h0060-unpack n<br /> attr MultiPlusII_227 obj-h0061-expr $val / 10<br /> attr MultiPlusII_227 obj-h0061-reading temperature_battery<br /> attr MultiPlusII_227 obj-h0061-unpack s&gt;<br /> attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset<br /> attr MultiPlusII_227 obj-h0062-reading vebus_reset<br /> attr MultiPlusII_227 obj-h0062-unpack n<br /> attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning<br /> attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h0063-unpack n<br /> attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm<br /> attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h0064-unpack n<br /> attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage<br /> attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h0065-unpack n<br /> attr MultiPlusII_227 obj-h0066-expr $val * 100<br /> attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1<br /> attr MultiPlusII_227 obj-h0066-unpack n<br /> attr MultiPlusII_227 obj-h0067-expr $val * 100<br /> attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2<br /> attr MultiPlusII_227 obj-h0067-unpack n<br /> attr MultiPlusII_227 obj-h0068-expr $val * 100<br /> attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3<br /> attr MultiPlusII_227 obj-h0068-unpack n<br /> attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h0069-unpack n<br /> attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored<br /> attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h0070-unpack n<br /> attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit<br /> attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h0071-unpack n<br /> attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset<br /> attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h0072-unpack n<br /> attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active<br /> attr MultiPlusII_227 obj-h0073-reading sustain_active<br /> attr MultiPlusII_227 obj-h0073-unpack n<br /> attr MultiPlusII_227 obj-h0074-expr $val / 100<br /> attr MultiPlusII_227 obj-h0074-len 2<br /> attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h0074-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0076-expr $val / 100<br /> attr MultiPlusII_227 obj-h0076-len 2<br /> attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h0076-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0078-expr $val / 100<br /> attr MultiPlusII_227 obj-h0078-len 2<br /> attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h0078-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0080-expr $val / 100<br /> attr MultiPlusII_227 obj-h0080-len 2<br /> attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h0080-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0082-expr $val / 100<br /> attr MultiPlusII_227 obj-h0082-len 2<br /> attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h0082-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0084-expr $val / 100<br /> attr MultiPlusII_227 obj-h0084-len 2<br /> attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h0084-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0086-expr $val / 100<br /> attr MultiPlusII_227 obj-h0086-len 2<br /> attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h0086-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0088-expr $val / 100<br /> attr MultiPlusII_227 obj-h0088-len 2<br /> attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h0088-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0090-expr $val / 100<br /> attr MultiPlusII_227 obj-h0090-len 2<br /> attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h0090-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0092-expr $val / 100<br /> attr MultiPlusII_227 obj-h0092-len 2<br /> attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h0092-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning<br /> attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h0094-unpack n<br /> attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown<br /> attr MultiPlusII_227 obj-h0095-reading charge_state<br /> attr MultiPlusII_227 obj-h0095-unpack n<br /> attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1<br /> attr MultiPlusII_227 obj-h0096-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0098-len 2<br /> attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0098-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0100-len 2<br /> attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2<br /> attr MultiPlusII_227 obj-h0100-unpack f&gt;<br /> attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred<br /> attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h0102-unpack n<br /> attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h0103-unpack n<br /> attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected<br /> attr MultiPlusII_227 obj-h0104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h0104-unpack n<br /> attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System<br /> attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h0105-unpack n<br /> attr MultiPlusII_227 obj-h0106-expr $val / 100<br /> attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h0106-unpack n<br /> attr MultiPlusII_227 obj-h0107-expr $val / 100<br /> attr MultiPlusII_227 obj-h0107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h0107-unpack n<br /> attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h0108-unpack n<br /> attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled<br /> attr MultiPlusII_227 obj-h0109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h0109-unpack n<br /> attr MultiPlusII_227 obj-h10-expr $val / 100<br /> attr MultiPlusII_227 obj-h10-len 1<br /> attr MultiPlusII_227 obj-h10-reading AC_Input_Frequency_L 2<br /> attr MultiPlusII_227 obj-h10-unpack s&gt;<br /> attr MultiPlusII_227 obj-h100-len 1<br /> attr MultiPlusII_227 obj-h100-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h100-unpack s&gt;<br /> attr MultiPlusII_227 obj-h102-len 1<br /> attr MultiPlusII_227 obj-h102-reading prefer_renewable_energy<br /> attr MultiPlusII_227 obj-h102-unpack s&gt;<br /> attr MultiPlusII_227 obj-h103-len 1<br /> attr MultiPlusII_227 obj-h103-reading select_remote_generator<br /> attr MultiPlusII_227 obj-h103-unpack s&gt;<br /> attr MultiPlusII_227 obj-h104-len 1<br /> attr MultiPlusII_227 obj-h104-reading remote_generator_selected<br /> attr MultiPlusII_227 obj-h104-unpack s&gt;<br /> attr MultiPlusII_227 obj-h105-len 1<br /> attr MultiPlusII_227 obj-h105-reading redetect_vebus_system<br /> attr MultiPlusII_227 obj-h105-unpack s&gt;<br /> attr MultiPlusII_227 obj-h106-expr $val / 100<br /> attr MultiPlusII_227 obj-h106-len 1<br /> attr MultiPlusII_227 obj-h106-reading powerAssist_boost_factor<br /> attr MultiPlusII_227 obj-h106-unpack s&gt;<br /> attr MultiPlusII_227 obj-h107-expr $val / 100<br /> attr MultiPlusII_227 obj-h107-len 1<br /> attr MultiPlusII_227 obj-h107-reading configured_output_voltage<br /> attr MultiPlusII_227 obj-h107-unpack s&gt;<br /> attr MultiPlusII_227 obj-h108-len 1<br /> attr MultiPlusII_227 obj-h108-reading powerAssist_enabled<br /> attr MultiPlusII_227 obj-h108-unpack s&gt;<br /> attr MultiPlusII_227 obj-h109-len 1<br /> attr MultiPlusII_227 obj-h109-reading ups_function_enabled<br /> attr MultiPlusII_227 obj-h109-unpack s&gt;<br /> attr MultiPlusII_227 obj-h11-expr $val / 100<br /> attr MultiPlusII_227 obj-h11-len 1<br /> attr MultiPlusII_227 obj-h11-reading AC_Input_Frequency_L 3<br /> attr MultiPlusII_227 obj-h11-unpack s&gt;<br /> attr MultiPlusII_227 obj-h12-expr $val * 10<br /> attr MultiPlusII_227 obj-h12-len 1<br /> attr MultiPlusII_227 obj-h12-reading AC_Input_Power_L 1<br /> attr MultiPlusII_227 obj-h12-unpack s&gt;<br /> attr MultiPlusII_227 obj-h13-expr $val * 10<br /> attr MultiPlusII_227 obj-h13-len 1<br /> attr MultiPlusII_227 obj-h13-reading AC_Input_Power_L 2<br /> attr MultiPlusII_227 obj-h13-unpack s&gt;<br /> attr MultiPlusII_227 obj-h14-expr $val * 10<br /> attr MultiPlusII_227 obj-h14-len 1<br /> attr MultiPlusII_227 obj-h14-reading AC_Input_Power_L 3<br /> attr MultiPlusII_227 obj-h14-unpack s&gt;<br /> attr MultiPlusII_227 obj-h15-expr $val / 10<br /> attr MultiPlusII_227 obj-h15-len 1<br /> attr MultiPlusII_227 obj-h15-reading AC_Output_Voltage_L 1<br /> attr MultiPlusII_227 obj-h15-unpack s&gt;<br /> attr MultiPlusII_227 obj-h16-expr $val / 10<br /> attr MultiPlusII_227 obj-h16-len 1<br /> attr MultiPlusII_227 obj-h16-reading AC_Output_Voltage_L 2<br /> attr MultiPlusII_227 obj-h16-unpack s&gt;<br /> attr MultiPlusII_227 obj-h17-expr $val / 10<br /> attr MultiPlusII_227 obj-h17-len 1<br /> attr MultiPlusII_227 obj-h17-reading AC_Output_Voltage_L 3<br /> attr MultiPlusII_227 obj-h17-unpack s&gt;<br /> attr MultiPlusII_227 obj-h18-expr $val / 10<br /> attr MultiPlusII_227 obj-h18-len 1<br /> attr MultiPlusII_227 obj-h18-reading AC_Output_Current_L 1<br /> attr MultiPlusII_227 obj-h18-unpack s&gt;<br /> attr MultiPlusII_227 obj-h19-expr $val / 10<br /> attr MultiPlusII_227 obj-h19-len 1<br /> attr MultiPlusII_227 obj-h19-reading AC_Output_Current_L 2<br /> attr MultiPlusII_227 obj-h19-unpack s&gt;<br /> attr MultiPlusII_227 obj-h20-expr $val / 10<br /> attr MultiPlusII_227 obj-h20-len 1<br /> attr MultiPlusII_227 obj-h20-reading AC_Output_Current_L 3<br /> attr MultiPlusII_227 obj-h20-unpack s&gt;<br /> attr MultiPlusII_227 obj-h21-expr $val / 100<br /> attr MultiPlusII_227 obj-h21-len 1<br /> attr MultiPlusII_227 obj-h21-reading AC_Output_Frequency<br /> attr MultiPlusII_227 obj-h21-unpack s&gt;<br /> attr MultiPlusII_227 obj-h22-expr $val / 10<br /> attr MultiPlusII_227 obj-h22-len 1<br /> attr MultiPlusII_227 obj-h22-reading Active_Input_current_Limit<br /> attr MultiPlusII_227 obj-h22-unpack s&gt;<br /> attr MultiPlusII_227 obj-h23-expr $val * 10<br /> attr MultiPlusII_227 obj-h23-len 1<br /> attr MultiPlusII_227 obj-h23-reading AC_Output_Power_L 1<br /> attr MultiPlusII_227 obj-h23-unpack s&gt;<br /> attr MultiPlusII_227 obj-h24-expr $val * 10<br /> attr MultiPlusII_227 obj-h24-len 1<br /> attr MultiPlusII_227 obj-h24-reading AC_Output_Power_L 2<br /> attr MultiPlusII_227 obj-h24-unpack s&gt;<br /> attr MultiPlusII_227 obj-h25-expr $val * 10<br /> attr MultiPlusII_227 obj-h25-len 1<br /> attr MultiPlusII_227 obj-h25-reading AC_Output_Power_L 3<br /> attr MultiPlusII_227 obj-h25-unpack s&gt;<br /> attr MultiPlusII_227 obj-h26-expr $val / 100<br /> attr MultiPlusII_227 obj-h26-len 1<br /> attr MultiPlusII_227 obj-h26-reading Battery_Voltage<br /> attr MultiPlusII_227 obj-h26-unpack s&gt;<br /> attr MultiPlusII_227 obj-h27-expr $val / 10<br /> attr MultiPlusII_227 obj-h27-len 1<br /> attr MultiPlusII_227 obj-h27-reading Battery_Current<br /> attr MultiPlusII_227 obj-h27-unpack s&gt;<br /> attr MultiPlusII_227 obj-h28-len 1<br /> attr MultiPlusII_227 obj-h28-reading Phase_Count<br /> attr MultiPlusII_227 obj-h28-unpack s&gt;<br /> attr MultiPlusII_227 obj-h29-len 1<br /> attr MultiPlusII_227 obj-h29-reading Active_Input<br /> attr MultiPlusII_227 obj-h29-unpack s&gt;<br /> attr MultiPlusII_227 obj-h3-expr $val / 10<br /> attr MultiPlusII_227 obj-h3-len 1<br /> attr MultiPlusII_227 obj-h3-reading AC_Input_Voltage_L 1<br /> attr MultiPlusII_227 obj-h3-unpack n<br /> attr MultiPlusII_227 obj-h30-expr $val / 10<br /> attr MultiPlusII_227 obj-h30-len 1<br /> attr MultiPlusII_227 obj-h30-reading vebus_soc<br /> attr MultiPlusII_227 obj-h30-unpack s&gt;<br /> attr MultiPlusII_227 obj-h31-len 1<br /> attr MultiPlusII_227 obj-h31-reading vebus_state<br /> attr MultiPlusII_227 obj-h31-unpack s&gt;<br /> attr MultiPlusII_227 obj-h32-len 1<br /> attr MultiPlusII_227 obj-h32-reading vebus_error<br /> attr MultiPlusII_227 obj-h32-unpack s&gt;<br /> attr MultiPlusII_227 obj-h33-len 1<br /> attr MultiPlusII_227 obj-h33-reading switch_position<br /> attr MultiPlusII_227 obj-h33-unpack s&gt;<br /> attr MultiPlusII_227 obj-h34-len 1<br /> attr MultiPlusII_227 obj-h34-reading temperature_alarm<br /> attr MultiPlusII_227 obj-h34-unpack s&gt;<br /> attr MultiPlusII_227 obj-h35-len 1<br /> attr MultiPlusII_227 obj-h35-reading low_battery_alarm<br /> attr MultiPlusII_227 obj-h35-unpack s&gt;<br /> attr MultiPlusII_227 obj-h36-len 1<br /> attr MultiPlusII_227 obj-h36-reading overload_alarm<br /> attr MultiPlusII_227 obj-h36-unpack s&gt;<br /> attr MultiPlusII_227 obj-h37-len 1<br /> attr MultiPlusII_227 obj-h37-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h37-unpack s&gt;<br /> attr MultiPlusII_227 obj-h38-len 1<br /> attr MultiPlusII_227 obj-h38-reading ESS_disable_charge_flag_phase<br /> attr MultiPlusII_227 obj-h38-unpack s&gt;<br /> attr MultiPlusII_227 obj-h39-len 1<br /> attr MultiPlusII_227 obj-h39-reading ESS_disable_feedback_flag_phase<br /> attr MultiPlusII_227 obj-h39-unpack s&gt;<br /> attr MultiPlusII_227 obj-h4-expr $val / 10<br /> attr MultiPlusII_227 obj-h4-len 1 2<br /> attr MultiPlusII_227 obj-h4-reading AC_Input_Voltage_L 2<br /> attr MultiPlusII_227 obj-h4-unpack s&gt;<br /> attr MultiPlusII_227 obj-h40-len 1<br /> attr MultiPlusII_227 obj-h40-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h40-unpack s&gt;<br /> attr MultiPlusII_227 obj-h41-len 1<br /> attr MultiPlusII_227 obj-h41-reading ESS_Power_setpoint_L 3<br /> attr MultiPlusII_227 obj-h41-unpack s&gt;<br /> attr MultiPlusII_227 obj-h42-len 1<br /> attr MultiPlusII_227 obj-h42-reading temperature_sensor_alarm<br /> attr MultiPlusII_227 obj-h42-unpack s&gt;<br /> attr MultiPlusII_227 obj-h43-len 1<br /> attr MultiPlusII_227 obj-h43-reading voltage_sensor_alarm<br /> attr MultiPlusII_227 obj-h43-unpack s&gt;<br /> attr MultiPlusII_227 obj-h44-len 1<br /> attr MultiPlusII_227 obj-h44-reading temperature_alarm_L 1<br /> attr MultiPlusII_227 obj-h44-unpack s&gt;<br /> attr MultiPlusII_227 obj-h45-len 1<br /> attr MultiPlusII_227 obj-h45-reading low_battery_alarm_L 1<br /> attr MultiPlusII_227 obj-h45-unpack s&gt;<br /> attr MultiPlusII_227 obj-h46-len 1<br /> attr MultiPlusII_227 obj-h46-reading overload_alarm_L 1<br /> attr MultiPlusII_227 obj-h46-unpack s&gt;<br /> attr MultiPlusII_227 obj-h47-len 1<br /> attr MultiPlusII_227 obj-h47-reading ripple_alarm_L 1<br /> attr MultiPlusII_227 obj-h47-unpack s&gt;<br /> attr MultiPlusII_227 obj-h48-len 1<br /> attr MultiPlusII_227 obj-h48-reading temperature_alarm_L 2<br /> attr MultiPlusII_227 obj-h48-unpack s&gt;<br /> attr MultiPlusII_227 obj-h49-len 1<br /> attr MultiPlusII_227 obj-h49-reading low_battery_alarm_L 2<br /> attr MultiPlusII_227 obj-h49-unpack s&gt;<br /> attr MultiPlusII_227 obj-h5-expr $val / 10<br /> attr MultiPlusII_227 obj-h5-len 1<br /> attr MultiPlusII_227 obj-h5-reading AC_Input_Voltage_L 3<br /> attr MultiPlusII_227 obj-h5-unpack s&gt;<br /> attr MultiPlusII_227 obj-h50-len 1<br /> attr MultiPlusII_227 obj-h50-reading overload_alarm_L 2<br /> attr MultiPlusII_227 obj-h50-unpack s&gt;<br /> attr MultiPlusII_227 obj-h51-len 1<br /> attr MultiPlusII_227 obj-h51-reading ripple_alarm_L 2<br /> attr MultiPlusII_227 obj-h51-unpack s&gt;<br /> attr MultiPlusII_227 obj-h52-len 1<br /> attr MultiPlusII_227 obj-h52-reading temperature_alarm_L 3<br /> attr MultiPlusII_227 obj-h52-unpack s&gt;<br /> attr MultiPlusII_227 obj-h53-len 1<br /> attr MultiPlusII_227 obj-h53-reading low_battery_alarm_L 3<br /> attr MultiPlusII_227 obj-h53-unpack s&gt;<br /> attr MultiPlusII_227 obj-h54-len 1<br /> attr MultiPlusII_227 obj-h54-reading overload_alarm_L 3<br /> attr MultiPlusII_227 obj-h54-unpack s&gt;<br /> attr MultiPlusII_227 obj-h55-len 1<br /> attr MultiPlusII_227 obj-h55-reading ripple_alarm_L 3<br /> attr MultiPlusII_227 obj-h55-unpack s&gt;<br /> attr MultiPlusII_227 obj-h56-len 1<br /> attr MultiPlusII_227 obj-h56-reading disable_pv_inverter<br /> attr MultiPlusII_227 obj-h56-unpack s&gt;<br /> attr MultiPlusII_227 obj-h57-len 1<br /> attr MultiPlusII_227 obj-h57-reading bms_allow_charge<br /> attr MultiPlusII_227 obj-h57-unpack s&gt;<br /> attr MultiPlusII_227 obj-h58-len 1<br /> attr MultiPlusII_227 obj-h58-reading bms_allow_discharge<br /> attr MultiPlusII_227 obj-h58-unpack s&gt;<br /> attr MultiPlusII_227 obj-h59-len 1<br /> attr MultiPlusII_227 obj-h59-reading bms_expected<br /> attr MultiPlusII_227 obj-h59-unpack s&gt;<br /> attr MultiPlusII_227 obj-h6-expr $val / 10<br /> attr MultiPlusII_227 obj-h6-len 1<br /> attr MultiPlusII_227 obj-h6-reading AC_Input_Current_L 1<br /> attr MultiPlusII_227 obj-h6-unpack s&gt;<br /> attr MultiPlusII_227 obj-h60-len 1<br /> attr MultiPlusII_227 obj-h60-reading bms_error<br /> attr MultiPlusII_227 obj-h60-unpack s&gt;<br /> attr MultiPlusII_227 obj-h61-expr $val / 10<br /> attr MultiPlusII_227 obj-h61-len 1<br /> attr MultiPlusII_227 obj-h61-reading temperature_battery<br /> attr MultiPlusII_227 obj-h61-unpack s&gt;<br /> attr MultiPlusII_227 obj-h62-len 1<br /> attr MultiPlusII_227 obj-h62-reading vebus_reset<br /> attr MultiPlusII_227 obj-h62-unpack s&gt;<br /> attr MultiPlusII_227 obj-h63-len 1<br /> attr MultiPlusII_227 obj-h63-reading phase_rotation_warning<br /> attr MultiPlusII_227 obj-h63-unpack s&gt;<br /> attr MultiPlusII_227 obj-h64-len 1<br /> attr MultiPlusII_227 obj-h64-reading grid_lost_alarm<br /> attr MultiPlusII_227 obj-h64-unpack s&gt;<br /> attr MultiPlusII_227 obj-h65-len 1<br /> attr MultiPlusII_227 obj-h65-reading feed_dc_overvoltage_into_grid<br /> attr MultiPlusII_227 obj-h65-unpack s&gt;<br /> attr MultiPlusII_227 obj-h66-expr $val * 100<br /> attr MultiPlusII_227 obj-h66-len 1<br /> attr MultiPlusII_227 obj-h66-reading maximum_overvoltage_feedin_power_L 1<br /> attr MultiPlusII_227 obj-h66-unpack s&gt;<br /> attr MultiPlusII_227 obj-h67-expr $val * 100<br /> attr MultiPlusII_227 obj-h67-len 1<br /> attr MultiPlusII_227 obj-h67-reading maximum_overvoltage_feedin_power_L 2<br /> attr MultiPlusII_227 obj-h67-unpack s&gt;<br /> attr MultiPlusII_227 obj-h68-expr $val * 100<br /> attr MultiPlusII_227 obj-h68-len 1<br /> attr MultiPlusII_227 obj-h68-reading maximum_overvoltage_feedin_power_L 3<br /> attr MultiPlusII_227 obj-h68-unpack s&gt;<br /> attr MultiPlusII_227 obj-h69-len 1<br /> attr MultiPlusII_227 obj-h69-reading ac_input_1_ignored<br /> attr MultiPlusII_227 obj-h69-unpack s&gt;<br /> attr MultiPlusII_227 obj-h7-expr $val / 10<br /> attr MultiPlusII_227 obj-h7-len 1<br /> attr MultiPlusII_227 obj-h7-reading AC_Input_Current_L 2<br /> attr MultiPlusII_227 obj-h7-unpack s&gt;<br /> attr MultiPlusII_227 obj-h70-len 1<br /> attr MultiPlusII_227 obj-h70-reading ac_input_2_ignored<br /> attr MultiPlusII_227 obj-h70-unpack s&gt;<br /> attr MultiPlusII_227 obj-h71-len 1<br /> attr MultiPlusII_227 obj-h71-reading ac_power_setpoint_acts_as_feedin_limit<br /> attr MultiPlusII_227 obj-h71-unpack s&gt;<br /> attr MultiPlusII_227 obj-h72-len 1<br /> attr MultiPlusII_227 obj-h72-reading solar_offset_voltage<br /> attr MultiPlusII_227 obj-h72-unpack s&gt;<br /> attr MultiPlusII_227 obj-h73-len 1<br /> attr MultiPlusII_227 obj-h73-reading sustain_active<br /> attr MultiPlusII_227 obj-h73-unpack s&gt;<br /> attr MultiPlusII_227 obj-h74-expr $val / 100<br /> attr MultiPlusII_227 obj-h74-len 1<br /> attr MultiPlusII_227 obj-h74-reading energy_from_acIn1_to_acOut<br /> attr MultiPlusII_227 obj-h74-unpack s&gt;<br /> attr MultiPlusII_227 obj-h76-expr $val / 100<br /> attr MultiPlusII_227 obj-h76-len 1<br /> attr MultiPlusII_227 obj-h76-reading energy_from_acIn1_to_battery<br /> attr MultiPlusII_227 obj-h76-unpack s&gt;<br /> attr MultiPlusII_227 obj-h78-expr $val / 100<br /> attr MultiPlusII_227 obj-h78-len 1<br /> attr MultiPlusII_227 obj-h78-reading energy_from_acIn2_to_acOut<br /> attr MultiPlusII_227 obj-h78-unpack s&gt;<br /> attr MultiPlusII_227 obj-h8-expr $val / 10<br /> attr MultiPlusII_227 obj-h8-len 1<br /> attr MultiPlusII_227 obj-h8-reading AC_Input_Current_L 3<br /> attr MultiPlusII_227 obj-h8-unpack s&gt;<br /> attr MultiPlusII_227 obj-h80-expr $val / 100<br /> attr MultiPlusII_227 obj-h80-len 1<br /> attr MultiPlusII_227 obj-h80-reading energy_from_acIn2_to_battery<br /> attr MultiPlusII_227 obj-h80-unpack s&gt;<br /> attr MultiPlusII_227 obj-h82-expr $val / 100<br /> attr MultiPlusII_227 obj-h82-len 1<br /> attr MultiPlusII_227 obj-h82-reading energy_from_acOut_to_acIn1<br /> attr MultiPlusII_227 obj-h82-unpack s&gt;<br /> attr MultiPlusII_227 obj-h84-expr $val / 100<br /> attr MultiPlusII_227 obj-h84-len 1<br /> attr MultiPlusII_227 obj-h84-reading energy_from_acOut_to_acIn2<br /> attr MultiPlusII_227 obj-h84-unpack s&gt;<br /> attr MultiPlusII_227 obj-h86-expr $val / 100<br /> attr MultiPlusII_227 obj-h86-len 1<br /> attr MultiPlusII_227 obj-h86-reading energy_from_battery_to_AcIn1<br /> attr MultiPlusII_227 obj-h86-unpack s&gt;<br /> attr MultiPlusII_227 obj-h88-expr $val / 100<br /> attr MultiPlusII_227 obj-h88-len 1<br /> attr MultiPlusII_227 obj-h88-reading energy_from_battery_to_AcIn2<br /> attr MultiPlusII_227 obj-h88-unpack s&gt;<br /> attr MultiPlusII_227 obj-h9-expr $val / 100<br /> attr MultiPlusII_227 obj-h9-len 1<br /> attr MultiPlusII_227 obj-h9-reading AC_Input_Frequency_L 1<br /> attr MultiPlusII_227 obj-h9-unpack s&gt;<br /> attr MultiPlusII_227 obj-h90-expr $val / 100<br /> attr MultiPlusII_227 obj-h90-len 1<br /> attr MultiPlusII_227 obj-h90-reading energy_from_battery_to_AcOut<br /> attr MultiPlusII_227 obj-h90-unpack s&gt;<br /> attr MultiPlusII_227 obj-h92-expr $val / 100<br /> attr MultiPlusII_227 obj-h92-len 1<br /> attr MultiPlusII_227 obj-h92-reading energy_from_AcOut_to_battery<br /> attr MultiPlusII_227 obj-h92-unpack s&gt;<br /> attr MultiPlusII_227 obj-h94-len 1<br /> attr MultiPlusII_227 obj-h94-reading low_cell_voltage_imminent<br /> attr MultiPlusII_227 obj-h94-unpack s&gt;<br /> attr MultiPlusII_227 obj-h95-len 1<br /> attr MultiPlusII_227 obj-h95-reading charge_state<br /> attr MultiPlusII_227 obj-h95-unpack s&gt;<br /> attr MultiPlusII_227 obj-h96-len 1<br /> attr MultiPlusII_227 obj-h96-reading ESS_Power_setpoint_L 1<br /> attr MultiPlusII_227 obj-h96-unpack s&gt;<br /> attr MultiPlusII_227 obj-h98-len 1<br /> attr MultiPlusII_227 obj-h98-reading ESS_Power_setpoint_L 2<br /> attr MultiPlusII_227 obj-h98-unpack s&gt;<br /> attr MultiPlusII_227 room Solar-&gt;Victron<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==Visualisierung==<br /> '''stateFormat''' kann so aussehen:<br /> SSOC Batteries_value_1_soc, <br /> SOC: Batteries_value_1_soc % (MinimumSocLimit_value), <br /> Bat: Batteries_value_1_power W,<br /> PV: PVPower_value W,<br /> ACin: GridPower_value W, <br /> ACout2: P_value W,<br /> State: State_value,<br /> Mode: Mode_value<br /> SSOC wird später für das devStateIcon genutzt.<br /> <br /> Das '''devStateIcon''' bietet einen ersten Blick auf den Ladestand:<br /> SSOC\s[2|3|4].+:measure_battery_25<br /> SSOC\s[5|6].+:measure_battery_50<br /> SSOC\s[7|8].+:measure_battery_75<br /> SSOC\s[9].+:measure_battery_100<br /> <br /> Derzeit existiert noch kein Template, aber das kann sich ja ändern.<br /> <br /> ==Externe Links==<br /> *[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]<br /> *[https://vrm-api-docs.victronenergy.com/#/ VRm API]<br /> *[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]</div> Stephan http://wiki.fhem.de/w/index.php?title=Stromb%C3%B6rse&diff=39601 Strombörse 2024-10-07T12:02:16Z <p>Stephan: /* Vorausetzungen */ Abruf der homeID und des Access-Token hinzugefügt</p> <hr /> <div>[[Bild:Screenshot 2024-01-23 122115.png|mini|400px|rechts|EVU_Tibber_connect]]<br /> Diese Seite beinhaltet Informationen für die Anbindung von Energieversorgungsunternehmen (EVU), die ihre Preise nach der Strombörse z.B. im Stundenrhythmus anbieten.<br /> <br /> Als Beispiel wären da:<br /> # {{Link2Forum|Topic=130407|LinkText=Tibber - im Forum}}<br /> # {{Link2Forum|Topic=135906|LinkText=aWATTar - im Forum}}<br /> <br /> Diese Wiki Seite ist noch in Bearbeitung!!!<br /> <br /> == 1. Tibber mit Tibber Pulse ==<br /> Eine momentan verbreitete Methode zur Anbindung an Tibber ist ein Lesekopf auf dem EVU Zähler, der als &quot;Tibber Pulse&quot; vertrieben wird. Damit wird ein bestehender digitaler EVU Zähler ausgelesen und die Werte per LAN zu Tibber gesendet. Über eine API bei Tibber können dann die Verbrauchswerte und Kosten, sowie ein Live Stream (WebSocket) abgefragt werden.<br /> <br /> Die im Folgenden beschriebenen Beispieldevices bieten die oben genannte Abfrage der API mit WebSocket und HTTPMOD. Das EVU_Tibber Device dient der Darstellung und Steuerung.<br /> <br /> === Vorausetzungen ===<br /> * FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)<br /> * KeyValue() (wird hier beschrieben)<br /> * homeID und personal Token/Access Token/Connect Token<br /> * Tibber Pulse Lesekopf auf dem digitalen EVU Zähler<br /> * Man sollte bereits Tibber Kunde sein, da ansonsten nur Demo Daten abgrufen werden können<br /> <br /> === Token ===<br /> Der Token wird leider unterschiedlich bezeichnet, aber egal ob er personal Token, Access Token oder Connect Token heisst, es bezieht sich auf den gleichen. <br /> <br /> Erhältlich ist dieser aktuell (Oktober 24) unter https://developer.tibber.com/ <br /> <br /> Dort bitte mit deinen Zugangsdaten einloggen (&quot;Sign In&quot;, oben rechts) und man bekommt den Access Token direkt angezeigt.<br /> <br /> === homeID ===<br /> Um eine HomeID zu erhalten, muss zuerst der Pulse mit dem Internet bzw. tibber verbunden werden. Wenn die App glücklich ist, gehts hier weiter: <br /> <br /> Man loggt sich wieder ein unter https://developer.tibber.com/. Dort geht man dann zum API Explorer. <br /> <br /> Leider ist keine der Demo-Abfragen geeignet, die homeID zu erfahren. Dafür gibt man ins linke fenster folgenden Code ein: &lt;syntaxhighlight&gt;<br /> {<br /> viewer {<br /> homes {<br /> id<br /> address {<br /> address1<br /> postalCode<br /> }<br /> }<br /> }<br /> }<br /> &lt;/syntaxhighlight&gt;Dann startet man mit dem Play-Pfeil und bekommt auf der rechten Seite etwa folgende Ausgabe: <br /> <br /> &lt;syntaxhighlight&gt;<br /> {<br /> &quot;data&quot;: {<br /> &quot;viewer&quot;: {<br /> &quot;homes&quot;: [<br /> {<br /> &quot;id&quot;: &quot;1234abcd-12ab-34cd-56ef-1234abcd12ab<br /> &quot;address&quot;: {<br /> &quot;address1&quot;: &quot;Musterstr.1&quot;,<br /> &quot;postalCode&quot;: &quot;12345&quot;<br /> }<br /> }<br /> ]<br /> }<br /> }<br /> }<br /> &lt;/syntaxhighlight&gt;Diese ID ist die homeID und kann unten verwendet werden.<br /> <br /> === EVU_Tibber_connect ===<br /> Das EVU_Tibber_connect fragt mit HTTPMOD Statistiken auf der Tibber API Webseite ab. Zusätzlich wurde in den userReadings die WebSocket Verbindung für die Live Daten integriert.<br /> * Die WebSocket Verbindung wurde leicht angepasst '''[[Websocket|von hier]]''' übernommen<br /> * Im Forum wurde dies '''{{Link2Forum|Topic=130407|Message=1298863|LinkText=ab hier}}''' bearbeitet<br /> <br /> ==== Verwendete Module ====<br /> * HTTPMOD<br /> * DbLog<br /> * DbRep<br /> * DOIF<br /> * KeyValue()<br /> <br /> ==== Ablage der homeID und des Tokens ====<br /> Eine Verbindung zur Tibber API mit den '''tatsächlichen Preisen bekommen nur Kunden''', ansonsten kann man eine Demo mit Kosten in Schwedischen Kronen testweise abfragen.<br /> <br /> In diesem Beispiel Device kann man seine homeID und sein Token entweder als Attribut ablegen oder man macht einen Eintrag im KeyStore von FHEM, wodurch man nicht so leicht versehentlich seine Daten im Forum postet.<br /> <br /> Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im Datensystem oder im Konfigurationsfile zu finden sind.<br /> Die Funktion befindet sich in der 99_myUtils.pm .<br /> <br /> ===== Beispiel KeyValue() =====<br /> '''Achtung, der KeyValue ist kein Schutz für Passwort oder Keys!'''<br /> Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im FHEM Device oder im Konfigurationsfile zu finden sind.<br /> Die Funktion befindet sich in der 99_myUtils .<br /> <br /> ====== KeyValue() Funktion in der ~/FHEM/99_myUtils.pm ======<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> sub KeyValue {<br /> my ($step, $index, $value) = @_;<br /> my $key = getUniqueId().$index;<br /> my $e_value = &quot;&quot;;<br /> my $error;<br /> <br /> if (eval &quot;use Digest::MD5;1&quot;) {<br /> $key = Digest::MD5::md5_hex(unpack &quot;H*&quot;, $key);<br /> $key .= Digest::MD5::md5_hex($key);<br /> }<br /> <br /> if ($step eq &quot;read&quot;) {<br /> ($error, $value) = getKeyValue($index);<br /> <br /> if ( defined($error) ) {<br /> Log3 $index,3, &quot;$index, can't read key from FhemUtils/uniqueID: $error&quot;;<br /> return undef;<br /> }<br /> <br /> if ( defined($value) ) {<br /> my $dec_value = '';<br /> <br /> for my $char (map { pack('C', hex($_)) } ($value =~ /(..)/g)) {<br /> my $decode = chop($key);<br /> $dec_value .= chr(ord($char)^ord($decode));<br /> $key = $decode.$key;<br /> }<br /> return $dec_value;<br /> }<br /> else {<br /> Log3 $index,3,&quot;$index, no key found in FhemUtils/uniqueID&quot;;<br /> return undef;<br /> }<br /> }<br /> <br /> if ($step eq &quot;store&quot;) {<br /> for my $char (split //, $value) {<br /> my $encode = chop($key);<br /> $e_value .= sprintf(&quot;%.2x&quot;,ord($char)^ord($encode));<br /> $key = $encode.$key;<br /> }<br /> $error = setKeyValue($index, $e_value);<br /> return &quot;error while saving key : $error&quot; if(defined($error));<br /> return &quot;Key successfully saved in FhemUtils/uniqueID Key $index&quot;;<br /> }<br /> <br /> };<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ====== Ablegen der homeID und des Token ======<br /> In der FHEM Kommandozeile legt man seinen Daten wie folgt im KeyValue ab. Hier wären als Beispiel der Demo Zugang von Tibber.<br /> Das &quot;read&quot; ist dann auch direkt der erste Test, bevor man weiter macht.<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> {KeyValue(&quot;store&quot;,&quot;EVU_Tibber_connect_token&quot;,&quot;5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE&quot;)}<br /> {KeyValue(&quot;store&quot;,&quot;EVU_Tibber_connect_homeID&quot;,&quot;96a14971-525a-4420-aae9-e5aedaa129ff&quot;)}<br /> <br /> {KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_token&quot;)}<br /> {KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_homeID&quot;)}<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== Beispiel Attribut für homeID und Token =====<br /> Oder, sobald das EVU_Tibber_connect Device erstellt wurde, als Attribut.<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> attr EVU_Tibber_connect ws_homeId 96a14971-525a-4420-aae9-e5aedaa129ff<br /> attr EVU_Tibber_connect ws_myId 96a14971-525a-4420-aae9-e5aedaa129ff &lt;&lt;&lt;&lt; Dies kann wohl eine frei gewählte ID sein, was hier der Einfachheithalber gleich der homeId gesetzt wurde.<br /> attr EVU_Tibber_connect ws_token 5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== EVU_Tibber_connect RAW Device====<br /> Das Device EVU_Tibber_connect dient der Verbindung zur Tibber API. Zusätzlich wird für die Abfrege der Live Daten innerhalb der userReadings eine WebSocket Verbindung zu Tibber aufgebaut. Tibber stellt jeweils gegen 14:00 Uhr die Daten für den nächsten Tag bereit, wodurch von 00:00 - 14:00 Uhr diese Information im EVU_Tibber_connect noch nicht angezeigt werden kann.<br /> Das Device arbeitet über die userReadings mit einem MySQL DbRep Device, was somit eine MySQL DbLog Verwendung im FHEM voraussetzt. '''Die Verwendung von FileLog ist nicht unterstützt!'''<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> defmod EVU_Tibber_connect HTTPMOD https://api.tibber.com/v1-beta/gql 0<br /> attr EVU_Tibber_connect userattr ws_homeId ws_minInterval ws_myId ws_token ws_websocketURL<br /> attr EVU_Tibber_connect DbLogExclude .*<br /> attr EVU_Tibber_connect DbLogInclude total_cost_.*,fc0_trigger.*<br /> attr EVU_Tibber_connect comment Version 2024.01.22 14:00 \<br /> https://developer.tibber.com/explorer\<br /> \<br /> In der FHEM Kommandozeile könnt Ihr das token und die homeID im KeyStore ablegen.\<br /> Bitte lest dazu das Thema KeyStore im Wiki und legt die Funktion in Eure 99_myUtils.\<br /> \<br /> {KeyValue(&quot;store&quot;,&quot;EVU_Tibber_connect_token&quot;,&quot;5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE&quot;)}\<br /> {KeyValue(&quot;store&quot;,&quot;EVU_Tibber_connect_homeID&quot;,&quot;96a14971-525a-4420-aae9-e5aedaa129ff&quot;)}\<br /> \<br /> Hierduch kann man einen wirtschaftlicheren trigger_price berechnen lassen:\<br /> setreading EVU_Tibber compensation_grid &lt;Eure Einspeisevergütung&gt;\<br /> \<br /> # Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\<br /> (fc_avg - fc_min) /2 + fc_min\<br /> \<br /> # Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\<br /> # compensation_grid kann auch auf einen für Euch passenden Wert gesetzt werden\<br /> (fc_avg - compensation_grid) *0.85<br /> attr EVU_Tibber_connect disable 0<br /> attr EVU_Tibber_connect enableControlSet 1<br /> attr EVU_Tibber_connect get01-1Name current_currency<br /> attr EVU_Tibber_connect get01-2Name current_level<br /> attr EVU_Tibber_connect get01-3Name current_date<br /> attr EVU_Tibber_connect get01-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get01-4Name current_price<br /> attr EVU_Tibber_connect get01-4OExpr $val *100<br /> attr EVU_Tibber_connect get01Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {currentSubscription {priceInfo {current {total startsAt currency level}}}}}}&quot; }<br /> attr EVU_Tibber_connect get01Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get01Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get01JSON data_viewer_home_currentSubscription_priceInfo_current<br /> attr EVU_Tibber_connect get01Name 01_priceInfo<br /> attr EVU_Tibber_connect get01URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect get02-10Name fc0_03_total<br /> attr EVU_Tibber_connect get02-11Name fc0_04_startsAt<br /> attr EVU_Tibber_connect get02-11OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-12Name fc0_04_total<br /> attr EVU_Tibber_connect get02-13Name fc0_05_startsAt<br /> attr EVU_Tibber_connect get02-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-14Name fc0_05_total<br /> attr EVU_Tibber_connect get02-15Name fc0_06_startsAt<br /> attr EVU_Tibber_connect get02-15OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-16Name fc0_06_total<br /> attr EVU_Tibber_connect get02-17Name fc0_07_startsAt<br /> attr EVU_Tibber_connect get02-17OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-18Name fc0_07_total<br /> attr EVU_Tibber_connect get02-19Name fc0_08_startsAt<br /> attr EVU_Tibber_connect get02-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-1Name current_date<br /> attr EVU_Tibber_connect get02-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-20Name fc0_08_total<br /> attr EVU_Tibber_connect get02-21Name fc0_09_startsAt<br /> attr EVU_Tibber_connect get02-21OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-22Name fc0_09_total<br /> attr EVU_Tibber_connect get02-23Name fc0_10_startsAt<br /> attr EVU_Tibber_connect get02-23OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-24Name fc0_10_total<br /> attr EVU_Tibber_connect get02-25Name fc0_11_startsAt<br /> attr EVU_Tibber_connect get02-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-26Name fc0_11_total<br /> attr EVU_Tibber_connect get02-27Name fc0_12_startsAt<br /> attr EVU_Tibber_connect get02-27OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-28Name fc0_12_total<br /> attr EVU_Tibber_connect get02-29Name fc0_13_startsAt<br /> attr EVU_Tibber_connect get02-29OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-2Name current_price<br /> attr EVU_Tibber_connect get02-2OExpr $val *100<br /> attr EVU_Tibber_connect get02-30Name fc0_13_total<br /> attr EVU_Tibber_connect get02-31Name fc0_14_startsAt<br /> attr EVU_Tibber_connect get02-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-32Name fc0_14_total<br /> attr EVU_Tibber_connect get02-33Name fc0_15_startsAt<br /> attr EVU_Tibber_connect get02-33OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-34Name fc0_15_total<br /> attr EVU_Tibber_connect get02-35Name fc0_16_startsAt<br /> attr EVU_Tibber_connect get02-35OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-36Name fc0_16_total<br /> attr EVU_Tibber_connect get02-37Name fc0_17_startsAt<br /> attr EVU_Tibber_connect get02-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-38Name fc0_17_total<br /> attr EVU_Tibber_connect get02-39Name fc0_18_startsAt<br /> attr EVU_Tibber_connect get02-39OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-3Name fc0_00_startsAt<br /> attr EVU_Tibber_connect get02-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-40Name fc0_18_total<br /> attr EVU_Tibber_connect get02-41Name fc0_19_startsAt<br /> attr EVU_Tibber_connect get02-41OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-42Name fc0_19_total<br /> attr EVU_Tibber_connect get02-43Name fc0_20_startsAt<br /> attr EVU_Tibber_connect get02-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-44Name fc0_20_total<br /> attr EVU_Tibber_connect get02-45Name fc0_21_startsAt<br /> attr EVU_Tibber_connect get02-45OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-46Name fc0_21_total<br /> attr EVU_Tibber_connect get02-47Name fc0_22_startsAt<br /> attr EVU_Tibber_connect get02-47OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-48Name fc0_22_total<br /> attr EVU_Tibber_connect get02-49Name fc0_23_startsAt<br /> attr EVU_Tibber_connect get02-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-4Name fc0_00_total<br /> attr EVU_Tibber_connect get02-50Name fc0_23_total<br /> attr EVU_Tibber_connect get02-51Name fc1_00_startsAt<br /> attr EVU_Tibber_connect get02-51OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-52Name fc1_00_total<br /> attr EVU_Tibber_connect get02-53Name fc1_01_startsAt<br /> attr EVU_Tibber_connect get02-53OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-54Name fc1_01_total<br /> attr EVU_Tibber_connect get02-55Name fc1_02_startsAt<br /> attr EVU_Tibber_connect get02-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-56Name fc1_02_total<br /> attr EVU_Tibber_connect get02-57Name fc1_03_startsAt<br /> attr EVU_Tibber_connect get02-57OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-58Name fc1_03_total<br /> attr EVU_Tibber_connect get02-59Name fc1_04_startsAt<br /> attr EVU_Tibber_connect get02-59OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-5Name fc0_01_startsAt<br /> attr EVU_Tibber_connect get02-5OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-60Name fc1_04_total<br /> attr EVU_Tibber_connect get02-61Name fc1_05_startsAt<br /> attr EVU_Tibber_connect get02-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-62Name fc1_05_total<br /> attr EVU_Tibber_connect get02-63Name fc1_06_startsAt<br /> attr EVU_Tibber_connect get02-63OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-64Name fc1_06_total<br /> attr EVU_Tibber_connect get02-65Name fc1_07_startsAt<br /> attr EVU_Tibber_connect get02-65OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-66Name fc1_07_total<br /> attr EVU_Tibber_connect get02-67Name fc1_08_startsAt<br /> attr EVU_Tibber_connect get02-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-68Name fc1_08_total<br /> attr EVU_Tibber_connect get02-69Name fc1_09_startsAt<br /> attr EVU_Tibber_connect get02-69OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-6Name fc0_01_total<br /> attr EVU_Tibber_connect get02-70Name fc1_09_total<br /> attr EVU_Tibber_connect get02-71Name fc1_10_startsAt<br /> attr EVU_Tibber_connect get02-71OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-72Name fc1_10_total<br /> attr EVU_Tibber_connect get02-73Name fc1_11_startsAt<br /> attr EVU_Tibber_connect get02-73OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-74Name fc1_11_total<br /> attr EVU_Tibber_connect get02-75Name fc1_12_startsAt<br /> attr EVU_Tibber_connect get02-75OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-76Name fc1_12_total<br /> attr EVU_Tibber_connect get02-77Name fc1_13_startsAt<br /> attr EVU_Tibber_connect get02-77OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-78Name fc1_13_total<br /> attr EVU_Tibber_connect get02-79Name fc1_14_startsAt<br /> attr EVU_Tibber_connect get02-79OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-7Name fc0_02_startsAt<br /> attr EVU_Tibber_connect get02-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-80Name fc1_14_total<br /> attr EVU_Tibber_connect get02-81Name fc1_15_startsAt<br /> attr EVU_Tibber_connect get02-81OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-82Name fc1_15_total<br /> attr EVU_Tibber_connect get02-83Name fc1_16_startsAt<br /> attr EVU_Tibber_connect get02-83OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-84Name fc1_16_total<br /> attr EVU_Tibber_connect get02-85Name fc1_17_startsAt<br /> attr EVU_Tibber_connect get02-85OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-86Name fc1_17_total<br /> attr EVU_Tibber_connect get02-87Name fc1_18_startsAt<br /> attr EVU_Tibber_connect get02-87OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-88Name fc1_18_total<br /> attr EVU_Tibber_connect get02-89Name fc1_19_startsAt<br /> attr EVU_Tibber_connect get02-89OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-8Name fc0_02_total<br /> attr EVU_Tibber_connect get02-90Name fc1_19_total<br /> attr EVU_Tibber_connect get02-91Name fc1_20_startsAt<br /> attr EVU_Tibber_connect get02-91OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-92Name fc1_20_total<br /> attr EVU_Tibber_connect get02-93Name fc1_21_startsAt<br /> attr EVU_Tibber_connect get02-93OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-94Name fc1_21_total<br /> attr EVU_Tibber_connect get02-95Name fc1_22_startsAt<br /> attr EVU_Tibber_connect get02-95OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-96Name fc1_22_total<br /> attr EVU_Tibber_connect get02-97Name fc1_23_startsAt<br /> attr EVU_Tibber_connect get02-97OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02-98Name fc1_23_total<br /> attr EVU_Tibber_connect get02-9Name fc0_03_startsAt<br /> attr EVU_Tibber_connect get02-9OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get02Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {currentSubscription {priceInfo {current {total startsAt} today {total startsAt} tomorrow {total startsAt}}}}}}&quot; }<br /> attr EVU_Tibber_connect get02Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get02Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get02JSON data_viewer_home_currentSubscription_priceInfo<br /> attr EVU_Tibber_connect get02Name 02_priceAll<br /> attr EVU_Tibber_connect get02URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect get03-1Name nodes_00_00_from<br /> attr EVU_Tibber_connect get03-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get03-2Name nodes_00_00_cost<br /> attr EVU_Tibber_connect get03-2OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get03-3Name nodes_00_00_consumption<br /> attr EVU_Tibber_connect get03-4Name nodes_00_01_from<br /> attr EVU_Tibber_connect get03-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get03-50Name nodes_00_01_cost<br /> attr EVU_Tibber_connect get03-50OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get03-5Name nodes_00_01_cost<br /> attr EVU_Tibber_connect get03-5OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get03-6Name nodes_00_01_consumption<br /> attr EVU_Tibber_connect get03-7Name nodes_00_02_from<br /> attr EVU_Tibber_connect get03-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get03-8Name nodes_00_02_cost<br /> attr EVU_Tibber_connect get03-8OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get03-9Name nodes_00_02_consumption<br /> attr EVU_Tibber_connect get03Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {consumption(resolution: HOURLY, last: 3) {nodes {from cost consumption }}}}}&quot;}<br /> attr EVU_Tibber_connect get03Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get03Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get03Name 03_consumption_hour<br /> attr EVU_Tibber_connect get03RegOpt g<br /> attr EVU_Tibber_connect get03Regex \{&quot;from&quot;:&quot;([\d+-]+T[\d+:]+\.000[+-][\d+:]+)&quot;,&quot;cost&quot;:(null|\d+\.\d+|0),&quot;consumption&quot;:(null|\d+\.\d+|0)\}<br /> attr EVU_Tibber_connect get03URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect get04-10Name nodes_24_03_from<br /> attr EVU_Tibber_connect get04-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-11Name nodes_24_03_cost<br /> attr EVU_Tibber_connect get04-11OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-12Name nodes_24_03_consumption<br /> attr EVU_Tibber_connect get04-13Name nodes_24_04_from<br /> attr EVU_Tibber_connect get04-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-14Name nodes_24_04_cost<br /> attr EVU_Tibber_connect get04-14OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-15Name nodes_24_04_consumption<br /> attr EVU_Tibber_connect get04-16Name nodes_24_05_from<br /> attr EVU_Tibber_connect get04-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-17Name nodes_24_05_cost<br /> attr EVU_Tibber_connect get04-17OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-18Name nodes_24_05_consumption<br /> attr EVU_Tibber_connect get04-19Name nodes_24_06_from<br /> attr EVU_Tibber_connect get04-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-1Name nodes_24_00_from<br /> attr EVU_Tibber_connect get04-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-20Name nodes_24_06_cost<br /> attr EVU_Tibber_connect get04-20OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-21Name nodes_24_06_consumption<br /> attr EVU_Tibber_connect get04-22Name nodes_24_07_from<br /> attr EVU_Tibber_connect get04-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-23Name nodes_24_07_cost<br /> attr EVU_Tibber_connect get04-23OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-24Name nodes_24_07_consumption<br /> attr EVU_Tibber_connect get04-25Name nodes_24_08_from<br /> attr EVU_Tibber_connect get04-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-26Name nodes_24_08_cost<br /> attr EVU_Tibber_connect get04-26OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-27Name nodes_24_08_consumption<br /> attr EVU_Tibber_connect get04-28Name nodes_24_09_from<br /> attr EVU_Tibber_connect get04-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-29Name nodes_24_09_cost<br /> attr EVU_Tibber_connect get04-29OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-2Name nodes_24_00_cost<br /> attr EVU_Tibber_connect get04-2OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-30Name nodes_24_09_consumption<br /> attr EVU_Tibber_connect get04-31Name nodes_24_10_from<br /> attr EVU_Tibber_connect get04-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-32Name nodes_24_10_cost<br /> attr EVU_Tibber_connect get04-32OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-33Name nodes_24_10_consumption<br /> attr EVU_Tibber_connect get04-34Name nodes_24_11_from<br /> attr EVU_Tibber_connect get04-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-35Name nodes_24_11_cost<br /> attr EVU_Tibber_connect get04-35OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-36Name nodes_24_11_consumption<br /> attr EVU_Tibber_connect get04-37Name nodes_24_12_from<br /> attr EVU_Tibber_connect get04-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-38Name nodes_24_12_cost<br /> attr EVU_Tibber_connect get04-38OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-39Name nodes_24_12_consumption<br /> attr EVU_Tibber_connect get04-3Name nodes_24_00_consumption<br /> attr EVU_Tibber_connect get04-40Name nodes_24_13_from<br /> attr EVU_Tibber_connect get04-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-41Name nodes_24_13_cost<br /> attr EVU_Tibber_connect get04-41OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-42Name nodes_24_13_consumption<br /> attr EVU_Tibber_connect get04-43Name nodes_24_14_from<br /> attr EVU_Tibber_connect get04-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-44Name nodes_24_14_cost<br /> attr EVU_Tibber_connect get04-44OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-45Name nodes_24_14_consumption<br /> attr EVU_Tibber_connect get04-46Name nodes_24_15_from<br /> attr EVU_Tibber_connect get04-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-47Name nodes_24_15_cost<br /> attr EVU_Tibber_connect get04-47OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-48Name nodes_24_15_consumption<br /> attr EVU_Tibber_connect get04-49Name nodes_24_16_from<br /> attr EVU_Tibber_connect get04-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-4Name nodes_24_01_from<br /> attr EVU_Tibber_connect get04-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-50Name nodes_24_16_cost<br /> attr EVU_Tibber_connect get04-50OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-51Name nodes_24_16_consumption<br /> attr EVU_Tibber_connect get04-52Name nodes_24_17_from<br /> attr EVU_Tibber_connect get04-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-53Name nodes_24_17_cost<br /> attr EVU_Tibber_connect get04-53OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-54Name nodes_24_17_consumption<br /> attr EVU_Tibber_connect get04-55Name nodes_24_18_from<br /> attr EVU_Tibber_connect get04-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-56Name nodes_24_18_cost<br /> attr EVU_Tibber_connect get04-56OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-57Name nodes_24_18_consumption<br /> attr EVU_Tibber_connect get04-58Name nodes_24_19_from<br /> attr EVU_Tibber_connect get04-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-59Name nodes_24_19_cost<br /> attr EVU_Tibber_connect get04-59OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-5Name nodes_24_01_cost<br /> attr EVU_Tibber_connect get04-5OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-60Name nodes_24_19_consumption<br /> attr EVU_Tibber_connect get04-61Name nodes_24_20_from<br /> attr EVU_Tibber_connect get04-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-62Name nodes_24_20_cost<br /> attr EVU_Tibber_connect get04-62OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-63Name nodes_24_20_consumption<br /> attr EVU_Tibber_connect get04-64Name nodes_24_21_from<br /> attr EVU_Tibber_connect get04-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-65Name nodes_24_21_cost<br /> attr EVU_Tibber_connect get04-65OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-66Name nodes_24_21_consumption<br /> attr EVU_Tibber_connect get04-67Name nodes_24_22_from<br /> attr EVU_Tibber_connect get04-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-68Name nodes_24_22_cost<br /> attr EVU_Tibber_connect get04-68OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-69Name nodes_24_22_consumption<br /> attr EVU_Tibber_connect get04-6Name nodes_24_01_consumption<br /> attr EVU_Tibber_connect get04-70Name nodes_24_23_from<br /> attr EVU_Tibber_connect get04-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-71Name nodes_24_23_cost<br /> attr EVU_Tibber_connect get04-71OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-72Name nodes_24_23_consumption<br /> attr EVU_Tibber_connect get04-7Name nodes_24_02_from<br /> attr EVU_Tibber_connect get04-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get04-8Name nodes_24_02_cost<br /> attr EVU_Tibber_connect get04-8OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get04-9Name nodes_24_02_consumption<br /> attr EVU_Tibber_connect get04Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {consumption(resolution: HOURLY, last: 24) {nodes {from cost consumption}}}}}&quot;}<br /> attr EVU_Tibber_connect get04Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get04Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get04Name 04_consumption_hour_24<br /> attr EVU_Tibber_connect get04RegOpt g<br /> attr EVU_Tibber_connect get04Regex \{&quot;from&quot;:&quot;([\d+-]+T[\d+:]+\.000[+-][\d+:]+)&quot;,&quot;cost&quot;:(null|\d+\.\d+|0),&quot;consumption&quot;:(null|\d+\.\d+|0)\}<br /> attr EVU_Tibber_connect get04URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect get05AutoNumLen 4<br /> attr EVU_Tibber_connect get05Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {consumption(resolution: HOURLY, last: 100) {nodes {from cost consumption}}}}}&quot;}<br /> attr EVU_Tibber_connect get05Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get05Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get05JSON data_viewer_home<br /> attr EVU_Tibber_connect get05Name 05_consumption_hourly_100<br /> attr EVU_Tibber_connect get05URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect get06-10Name Adresse_07_Telefon<br /> attr EVU_Tibber_connect get06-11Name Adresse_01_Vorname<br /> attr EVU_Tibber_connect get06-12Name Adresse_02_Nachname<br /> attr EVU_Tibber_connect get06-1Name Adresse_03_Strasse<br /> attr EVU_Tibber_connect get06-2Name Adresse_05_Ort<br /> attr EVU_Tibber_connect get06-3Name Adresse_06_Land<br /> attr EVU_Tibber_connect get06-4Name Adresse_05_Ort<br /> attr EVU_Tibber_connect get06-5Name Adresse_06_Land<br /> attr EVU_Tibber_connect get06-6Name Adresse_09_latitude<br /> attr EVU_Tibber_connect get06-7Name Adresse_10_longitude<br /> attr EVU_Tibber_connect get06-8Name Adresse_04_Plz<br /> attr EVU_Tibber_connect get06-9Name Adresse_08_eMail<br /> attr EVU_Tibber_connect get06Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {address {address1 address2 address3 postalCode city country latitude longitude} owner {firstName lastName contactInfo {email mobile}}}}}&quot; }<br /> attr EVU_Tibber_connect get06Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get06Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get06JSON data_viewer_home<br /> attr EVU_Tibber_connect get06Name 06_address<br /> attr EVU_Tibber_connect get06URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect get07-10Name nodes_24_03_from<br /> attr EVU_Tibber_connect get07-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-11Name nodes_24_03_cost<br /> attr EVU_Tibber_connect get07-11OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-12Name nodes_24_03_consumption<br /> attr EVU_Tibber_connect get07-13Name nodes_24_04_from<br /> attr EVU_Tibber_connect get07-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-14Name nodes_24_04_cost<br /> attr EVU_Tibber_connect get07-14OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-15Name nodes_24_04_consumption<br /> attr EVU_Tibber_connect get07-16Name nodes_24_05_from<br /> attr EVU_Tibber_connect get07-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-17Name nodes_24_05_cost<br /> attr EVU_Tibber_connect get07-17OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-18Name nodes_24_05_consumption<br /> attr EVU_Tibber_connect get07-19Name nodes_24_06_from<br /> attr EVU_Tibber_connect get07-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-1Name features_realTimeConsumptionEnabled<br /> attr EVU_Tibber_connect get07-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-20Name nodes_24_06_cost<br /> attr EVU_Tibber_connect get07-20OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-21Name nodes_24_06_consumption<br /> attr EVU_Tibber_connect get07-22Name nodes_24_07_from<br /> attr EVU_Tibber_connect get07-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-23Name nodes_24_07_cost<br /> attr EVU_Tibber_connect get07-23OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-24Name nodes_24_07_consumption<br /> attr EVU_Tibber_connect get07-25Name nodes_24_08_from<br /> attr EVU_Tibber_connect get07-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-26Name nodes_24_08_cost<br /> attr EVU_Tibber_connect get07-26OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-27Name nodes_24_08_consumption<br /> attr EVU_Tibber_connect get07-28Name nodes_24_09_from<br /> attr EVU_Tibber_connect get07-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-29Name nodes_24_09_cost<br /> attr EVU_Tibber_connect get07-29OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-2Name features_id<br /> attr EVU_Tibber_connect get07-2OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-30Name nodes_24_09_consumption<br /> attr EVU_Tibber_connect get07-31Name nodes_24_10_from<br /> attr EVU_Tibber_connect get07-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-32Name nodes_24_10_cost<br /> attr EVU_Tibber_connect get07-32OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-33Name nodes_24_10_consumption<br /> attr EVU_Tibber_connect get07-34Name nodes_24_11_from<br /> attr EVU_Tibber_connect get07-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-35Name nodes_24_11_cost<br /> attr EVU_Tibber_connect get07-35OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-36Name nodes_24_11_consumption<br /> attr EVU_Tibber_connect get07-37Name nodes_24_12_from<br /> attr EVU_Tibber_connect get07-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-38Name nodes_24_12_cost<br /> attr EVU_Tibber_connect get07-38OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-39Name nodes_24_12_consumption<br /> attr EVU_Tibber_connect get07-3Name nodes_24_00_consumption<br /> attr EVU_Tibber_connect get07-40Name nodes_24_13_from<br /> attr EVU_Tibber_connect get07-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-41Name nodes_24_13_cost<br /> attr EVU_Tibber_connect get07-41OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-42Name nodes_24_13_consumption<br /> attr EVU_Tibber_connect get07-43Name nodes_24_14_from<br /> attr EVU_Tibber_connect get07-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-44Name nodes_24_14_cost<br /> attr EVU_Tibber_connect get07-44OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-45Name nodes_24_14_consumption<br /> attr EVU_Tibber_connect get07-46Name nodes_24_15_from<br /> attr EVU_Tibber_connect get07-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-47Name nodes_24_15_cost<br /> attr EVU_Tibber_connect get07-47OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-48Name nodes_24_15_consumption<br /> attr EVU_Tibber_connect get07-49Name nodes_24_16_from<br /> attr EVU_Tibber_connect get07-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-4Name nodes_24_01_from<br /> attr EVU_Tibber_connect get07-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-50Name nodes_24_16_cost<br /> attr EVU_Tibber_connect get07-50OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-51Name nodes_24_16_consumption<br /> attr EVU_Tibber_connect get07-52Name nodes_24_17_from<br /> attr EVU_Tibber_connect get07-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-53Name nodes_24_17_cost<br /> attr EVU_Tibber_connect get07-53OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-54Name nodes_24_17_consumption<br /> attr EVU_Tibber_connect get07-55Name nodes_24_18_from<br /> attr EVU_Tibber_connect get07-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-56Name nodes_24_18_cost<br /> attr EVU_Tibber_connect get07-56OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-57Name nodes_24_18_consumption<br /> attr EVU_Tibber_connect get07-58Name nodes_24_19_from<br /> attr EVU_Tibber_connect get07-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-59Name nodes_24_19_cost<br /> attr EVU_Tibber_connect get07-59OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-5Name nodes_24_01_cost<br /> attr EVU_Tibber_connect get07-5OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-60Name nodes_24_19_consumption<br /> attr EVU_Tibber_connect get07-61Name nodes_24_20_from<br /> attr EVU_Tibber_connect get07-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-62Name nodes_24_20_cost<br /> attr EVU_Tibber_connect get07-62OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-63Name nodes_24_20_consumption<br /> attr EVU_Tibber_connect get07-64Name nodes_24_21_from<br /> attr EVU_Tibber_connect get07-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-65Name nodes_24_21_cost<br /> attr EVU_Tibber_connect get07-65OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-66Name nodes_24_21_consumption<br /> attr EVU_Tibber_connect get07-67Name nodes_24_22_from<br /> attr EVU_Tibber_connect get07-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-68Name nodes_24_22_cost<br /> attr EVU_Tibber_connect get07-68OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-69Name nodes_24_22_consumption<br /> attr EVU_Tibber_connect get07-6Name nodes_24_01_consumption<br /> attr EVU_Tibber_connect get07-70Name nodes_24_23_from<br /> attr EVU_Tibber_connect get07-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-71Name nodes_24_23_cost<br /> attr EVU_Tibber_connect get07-71OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-72Name nodes_24_23_consumption<br /> attr EVU_Tibber_connect get07-7Name nodes_24_02_from<br /> attr EVU_Tibber_connect get07-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)<br /> attr EVU_Tibber_connect get07-8Name nodes_24_02_cost<br /> attr EVU_Tibber_connect get07-8OExpr ($val ne &quot;0&quot; and $val ne &quot;null&quot;)? round($val,4) : $val<br /> attr EVU_Tibber_connect get07-9Name nodes_24_02_consumption<br /> attr EVU_Tibber_connect get07Data { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {id features{realTimeConsumptionEnabled} } } }&quot; }<br /> attr EVU_Tibber_connect get07Header01 Content-Type: application/json<br /> attr EVU_Tibber_connect get07Header02 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect get07JSON data_viewer_home<br /> attr EVU_Tibber_connect get07Name 07_realTimeConsumptionEnabled<br /> attr EVU_Tibber_connect get07RegOpt g<br /> attr EVU_Tibber_connect get07Regex \{&quot;from&quot;:&quot;([\d+-]+T[\d+:]+\.000[+-][\d+:]+)&quot;,&quot;cost&quot;:(null|\d+\.\d+|0),&quot;consumption&quot;:(null|\d+\.\d+|0)\}<br /> attr EVU_Tibber_connect get07URL https://api.tibber.com/v1-beta/gql<br /> attr EVU_Tibber_connect group PV Steuerung EVU<br /> attr EVU_Tibber_connect icon stromzaehler_icon<br /> attr EVU_Tibber_connect replacement01Mode expression<br /> attr EVU_Tibber_connect replacement01Regex %%token%%<br /> attr EVU_Tibber_connect replacement01Value {KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_token&quot;)}<br /> attr EVU_Tibber_connect replacement02Mode expression<br /> attr EVU_Tibber_connect replacement02Regex %%homeID%%<br /> attr EVU_Tibber_connect replacement02Value {KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_homeID&quot;)}<br /> attr EVU_Tibber_connect requestData { &quot;query&quot;: &quot;{viewer {home(id:\&quot;%%homeID%%\&quot;) {currentSubscription {priceInfo {current {total energy tax startsAt }}}}}}&quot; }<br /> attr EVU_Tibber_connect requestHeader1 Content-Type: application/json<br /> attr EVU_Tibber_connect requestHeader2 Authorization: Bearer %%token%%<br /> attr EVU_Tibber_connect room Strom-&gt;Boerse<br /> attr EVU_Tibber_connect showBody 1<br /> attr EVU_Tibber_connect showError 1<br /> attr EVU_Tibber_connect sortby 313<br /> attr EVU_Tibber_connect timeout 30<br /> attr EVU_Tibber_connect userReadings ws_connect:ws_cmd:.connect {\<br /> my $hash = $defs{$name};;\<br /> my $devState = DevIo_IsOpen($hash);;\<br /> return &quot;Device already open&quot; if (defined($devState));;\<br /> \<br /> # establish connection to websocket\<br /> # format must also include portnumber if a path is to be specified\<br /> $hash-&gt;{DeviceName} = AttrVal($name, &quot;ws_websocketURL&quot;, &quot;wss:echo.websocket.org:443&quot;);;\<br /> \<br /> # special headers needed for Tibber, see also Developer Tools in Browser\<br /> $hash-&gt;{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';;\<br /> $hash-&gt;{header}{'Host'} = 'websocket-api.tibber.com';;\<br /> $hash-&gt;{header}{'Origin'} = 'https://developer.tibber.com';;\<br /> \<br /> # callback function when &quot;select()&quot; signals data for us\<br /> # websocket Ping/Pongs are treated in DevIo but still call this function\<br /> $hash-&gt;{directReadFn} = sub () {\<br /> my $hash = $defs{$name};;\<br /> \<br /> # we can read without closing the DevIo, because select() signalled data\<br /> my $buf = DevIo_SimpleRead($hash);;\<br /> \<br /> # if read fails, close device\<br /> if(!defined($buf)) {\<br /> DevIo_CloseDev($hash);;\<br /> $buf = &quot;not_connected&quot;;;\<br /> }\<br /> \<br /> #Log(3, &quot;$name:$reading: websocket data: &gt;&gt;&gt;$buf&lt;&lt;&lt;&quot;);;\<br /> \<br /> # only update our reading if buffer is not empty and if last update is older than minInterval\<br /> if ($buf ne &quot;&quot;) {\<br /> my $websocketDataAge = ReadingsAge($name, &quot;ws_websocketData&quot;, 3600);;\<br /> my $minInterval = AttrVal($name, &quot;ws_minInterval&quot;, 0);;\<br /> my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);;\<br /> \<br /> readingsBeginUpdate($hash);;\<br /> readingsBulkUpdate($hash, &quot;ws_websocketData&quot;, &quot;$buf&quot;) if ($isNext &amp;&amp; $websocketDataAge &gt; $minInterval);;\<br /> readingsBulkUpdate($hash, &quot;ws_websocketData&quot;, &quot;$buf&quot;) if (!$isNext);;\<br /> readingsEndUpdate($hash, 1);;\<br /> #Log(3, &quot;$name:$reading: websocket data written to reading&quot;);;\<br /> }\<br /> };;\<br /> \<br /> # open DevIo websocket\<br /> DevIo_OpenDev($hash, 0, undef, sub(){\<br /> my ($hash, $error) = @_;;\<br /> return &quot;$error&quot; if ($error);;\<br /> \<br /> my $token = AttrVal($name, &quot;ws_token&quot;, &quot;???&quot;);;\<br /> $token = KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_token&quot;) if ($token eq &quot;???&quot;);;\<br /> \<br /> DevIo_SimpleWrite($hash, '{&quot;type&quot;:&quot;connection_init&quot;,&quot;payload&quot;:{&quot;token&quot;:&quot;'.$token.'&quot;}}', 2);;\<br /> });;\<br /> readingsBulkUpdate($hash, &quot;ws_websocketData&quot;, &quot;&quot;);;\<br /> #Log(3, &quot;$name:$reading: websocket data cleared in reading&quot;);;\<br /> \<br /> return POSIX::strftime(&quot;%H:%M:%S&quot;,localtime(time()));;\<br /> },\<br /> \<br /> ws_disconnect:ws_cmd:.disconnect {\<br /> Log(3, &quot;$name: disconnect&quot;);;\<br /> my $hash = $defs{$name};;\<br /> RemoveInternalTimer($hash);;\<br /> DevIo_SimpleRead($hash);;\<br /> DevIo_CloseDev($hash);;\<br /> \<br /> return POSIX::strftime(&quot;%H:%M:%S&quot;,localtime(time()));;\<br /> },\<br /> \<br /> ws_onDisconnect {\<br /> my $myState = ReadingsVal($name, &quot;state&quot;, &quot;???&quot;);;\<br /> my $myData = ReadingsVal($name, &quot;ws_websocketData&quot;, &quot;???&quot;);;\<br /> return if ($myState ne &quot;disconnected&quot; and $myData ne &quot;not_connected&quot;);;\<br /> \<br /> ## timer callback function, called after a few seconds to initiate a reconnect\<br /> my $timerFunction = sub() {\<br /> my ($arg) = @_;;\<br /> my $hash = $defs{$name};;\<br /> my $devState = DevIo_IsOpen($hash);;\<br /> \<br /> # only re-connect if device is not connected\<br /> readingsSingleUpdate($hash, &quot;ws_cmd&quot;, &quot;connect&quot;, 1) if (!defined($devState));;\<br /> };;\<br /> RemoveInternalTimer($name.$reading.'Timer');;\<br /> \<br /> # wait a random time before reconnect (exponential backoff TBD):\<br /> my $rwait = int(rand(200)) + 30;;\<br /> InternalTimer(gettimeofday() + $rwait, $timerFunction, $name.$reading.'Timer');;\<br /> \<br /> #set cmd to a new value, informs user and allows to retrigger when timer expires\<br /> my $hash = $defs{$name};;\<br /> readingsBulkUpdate($hash, &quot;ws_cmd&quot;, &quot;reconnect attempt in $rwait seconds&quot;);;\<br /> \<br /> return POSIX::strftime(&quot;%H:%M:%S&quot;,localtime(time()));;\<br /> },\<br /> \<br /> ws_onTimeout:ws_websocketData:.* {\<br /> #re-establish websocket connection if no data received in the past ten minutes\<br /> #but only if our reading &quot;ws_cmd&quot; was not set to the value &quot;disconnect&quot;\<br /> \<br /> #Log(3, &quot;$name:$reading: websocket data triggert ws_onTimeout&quot;);;\<br /> \<br /> #timeout in seconds when the connection is considered dead\<br /> my $timeoutTime = 600;;\<br /> \<br /> # function to execute when timeout expired\<br /> # defining the function here in the userReading, allows us to insert variables directly\<br /> my $timerFunction = sub() {\<br /> my ($arg) = @_;;\<br /> my $hash = $defs{$name};;\<br /> my $rCmd = ReadingsVal($name, &quot;ws_cmd&quot;, &quot;???&quot;);;\<br /> my $age = ReadingsAge($name, &quot;ws_websocketData&quot;, 0);;\<br /> \<br /> Log(3, &quot;$name: onTimeoutTimer triggered &gt;&gt;$arg&lt;&lt;&quot;);;\<br /> \<br /> #do not do anything further if disconnect is on purpose\<br /> if ( $rCmd eq &quot;disconnect&quot; ) {\<br /> Log(3, &quot;$name: ws_cmd was set to disconnect&quot;);;\<br /> return;;\<br /> }\<br /> \<br /> # for whatever reason, we triggered to soon (80%)\<br /> if ( $age &lt; $timeoutTime*0.8 ) {\<br /> Log(3, &quot;$name: ws_websocketData is not outdated&quot;);;\<br /> return;;\<br /> }\<br /> \<br /> DevIo_CloseDev($hash);;\<br /> Log(3, &quot;$name: onTimeoutTimer closed DevIo...&quot;);;\<br /> \<br /> readingsSingleUpdate($hash, &quot;ws_cmd&quot;, &quot;connect&quot;, 1);;\<br /> Log(3, &quot;$name: onTimeoutTimer set ws_cmd to value 'connect'&quot;);;\<br /> };;\<br /> \<br /> #Log(3, &quot;$name:$reading: onTimeout function defined&quot;);;\<br /> \<br /> #remove/cancel previous timers, because we got fresh data and countdown starts again\<br /> RemoveInternalTimer($name.$reading.'Timer');;\<br /> \<br /> #set timer to expire and execute function defined above, give special arg as identifier\<br /> InternalTimer(gettimeofday() + $timeoutTime, $timerFunction, $name.$reading.'Timer');;\<br /> \<br /> return POSIX::strftime(&quot;%H:%M:%S&quot;,localtime(time()));;\<br /> },\<br /> \<br /> ws_onConnectionAck:ws_websocketData:.*connection_ack.* {\<br /> #ws_websocketData contains the string &quot;connection_ack&quot;\<br /> Log(3, &quot;$name:$reading: got connection ack&quot;);;\<br /> \<br /> # do not proceed if connection is lost\<br /> my $hash = $defs{$name};;\<br /> my $devState = DevIo_IsOpen($hash);;\<br /> return &quot;Device not open&quot; if (!defined($devState));;\<br /> \<br /> readingsBulkUpdate($hash, &quot;ws_cmd&quot;, &quot;got connection ack&quot;);;\<br /> \<br /> my $homeId = AttrVal($name, &quot;ws_homeId&quot;, &quot;???&quot;);;\<br /> $homeId = KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_homeID&quot;) if ($homeId eq &quot;???&quot;);;\<br /> \<br /> my $myId = AttrVal($name, &quot;ws_myId&quot;, &quot;???&quot;);;\<br /> $myId = KeyValue(&quot;read&quot;,&quot;EVU_Tibber_connect_homeID&quot;) if ($myId eq &quot;???&quot;);;\<br /> \<br /> # build the query, do it in pieces, the comma at the end caused perl errors\<br /> # so we put it together in this not very elegant way\<br /> my $json = '{ &quot;id&quot;:&quot;'. $myId .'&quot;, &quot;type&quot;:&quot;subscribe&quot;'.&quot;, &quot;;;\<br /> $json .= '&quot;payload&quot;:{';;\<br /> $json .= '&quot;variables&quot;:{}'.&quot;, &quot;;;\<br /> $json .= '&quot;extensions&quot;:{}'.&quot;, &quot;;;\<br /> $json .= '&quot;query&quot;:&quot;subscription { liveMeasurement( homeId: \&quot;'.$homeId.'\&quot; ) ';;\<br /> #$json .= '{ timestamp power accumulatedConsumption accumulatedCost currency minPower averagePower maxPower signalStrength }}&quot;';;\<br /> $json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';;\<br /> $json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';;\<br /> $json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';;\<br /> $json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}&quot;';;\<br /> $json .= '}}';;\<br /> \<br /> #send the string via websocket as ASCII\<br /> Log(3, &quot;$name:$reading: sending JSON: &gt;&gt;&gt;$json&lt;&lt;&lt;&quot;);;\<br /> DevIo_SimpleWrite($hash, $json, 2);;\<br /> \<br /> return POSIX::strftime(&quot;%H:%M:%S&quot;,localtime(time()));;\<br /> },\<br /> \<br /> ws_onNextLiveMeasurement:ws_websocketData:.*next.*payload.*data.*liveMeasurement.* {\<br /> #websocketData contains next-live-measurement-data\<br /> my $val = ReadingsVal($name, &quot;ws_websocketData&quot;, &quot;{}&quot;);;\<br /> my %res = %{json2nameValue($val, undef, undef, &quot;payload_data_liveMeasurement.*&quot;)};;\<br /> \<br /> my $ret = &quot;got values for:\n&quot;;;\<br /> foreach my $k (sort keys %res) {\<br /> $ret .= &quot;$k\n&quot;;;\<br /> readingsBulkUpdate($hash, makeReadingName($k), $res{$k});;\<br /> }\<br /> return $ret;;\<br /> },\<br /> \<br /> nodes_TIMESTAMP:nodes_00_00_cost.* {\<br /> my ($timestamp,$value) = 2x0;;\<br /> my $tmp = 0;;\<br /> \<br /> for (my $loop_last = 0;; $loop_last &lt;= 2;; $loop_last++) {\<br /> $timestamp = ReadingsVal(&quot;$NAME&quot;,&quot;nodes_00_&quot;.sprintf(&quot;%02d&quot;,$loop_last).&quot;_from&quot;,&quot;null&quot;);;\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;nodes_00_&quot;.sprintf(&quot;%02d&quot;,$loop_last).&quot;_cost&quot;,&quot;null&quot;);;\<br /> \<br /> if ( $value ne &quot;null&quot; ) {\<br /> # Eintragen der Kosten für die Stunde\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','nodes_cost','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> # Eintragen des Verbrauchs für die Stunde\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;nodes_00_&quot;.sprintf(&quot;%02d&quot;,$loop_last).&quot;_consumption&quot;,&quot;null&quot;);;\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','nodes_consumption','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> } else {\<br /> $tmp = &quot;null&quot;;;\<br /> }\<br /> } # end for\<br /> if ($tmp eq &quot;null&quot;) {\<br /> $timestamp = $tmp\<br /> }\<br /> $timestamp;;\<br /> },\<br /> \<br /> nodes_TIMESTAMP:nodes_24_00_cost.* {\<br /> my ($timestamp,$value) = 2x0;;\<br /> my $tmp = 0;;\<br /> \<br /> for (my $loop_last = 0;; $loop_last &lt;= 23;; $loop_last++) {\<br /> $timestamp = ReadingsVal(&quot;$NAME&quot;,&quot;nodes_24_&quot;.sprintf(&quot;%02d&quot;,$loop_last).&quot;_from&quot;,&quot;null&quot;);;\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;nodes_24_&quot;.sprintf(&quot;%02d&quot;,$loop_last).&quot;_cost&quot;,&quot;null&quot;);;\<br /> \<br /> if ( $value ne &quot;null&quot; ) {\<br /> # Eintragen der Kosten für die Stunde\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','nodes_cost','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> # Eintragen des Verbrauchs für die Stunde\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;nodes_24_&quot;.sprintf(&quot;%02d&quot;,$loop_last).&quot;_consumption&quot;,&quot;null&quot;);;\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','nodes_consumption','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> } else {\<br /> $tmp = &quot;null&quot;;;\<br /> }\<br /> } # end for\<br /> if ($tmp eq &quot;null&quot;) {\<br /> $timestamp = $tmp\<br /> }\<br /> $timestamp;;\<br /> },\<br /> \<br /> nodes_TIMESTAMP:05_consumption_hourly_100-0001.* {\<br /> my ($timestamp,$value) = 2x0;;\<br /> \<br /> for (my $loop_last = 1;; $loop_last &lt;= 300;; $loop_last += 3) {\<br /> \<br /> $timestamp = ReadingsVal(&quot;$NAME&quot;,&quot;05_consumption_hourly_100-&quot;.sprintf(&quot;%04d&quot;,$loop_last+2),&quot;null&quot;);; # timestamp\<br /> $timestamp =~ s/T/ /g ;;\<br /> $timestamp = substr($timestamp,0,19);;\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;05_consumption_hourly_100-&quot;.sprintf(&quot;%04d&quot;,$loop_last+1),&quot;null&quot;);; # cost\<br /> \<br /> if ( $value ne &quot;&quot; ) {\<br /> $value = round($value,4);;\<br /> # print $timestamp.&quot; &quot;.$value.&quot;\n&quot;;;\<br /> \<br /> # Eintragen der Kosten für die Stunde\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','nodes_cost','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> # Eintragen des Verbrauchs für die Stunde\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;05_consumption_hourly_100-&quot;.sprintf(&quot;%04d&quot;,$loop_last),&quot;null&quot;);; # consumption\<br /> $value = round($value,4);;\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','nodes_consumption','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> }\<br /> } # end for\<br /> \<br /> $timestamp;;\<br /> },\<br /> \<br /> nodes_cost_avg:nodes_TIMESTAMP.* {\<br /> ## Berechnung des Tages Wertes\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;nodes_TIMESTAMP&quot;,&quot;null&quot;) ne &quot;null&quot; ) {\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT cast(avg(VALUE)*100 AS DECIMAL(4,2)) FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_cost'\<br /> AND TIMESTAMP &gt;= curdate() ;;&quot;) ;;\<br /> } else {\<br /> ReadingsVal(&quot;$NAME&quot;,&quot;nodes_cost_avg&quot;,&quot;null&quot;)\<br /> }\<br /> },\<br /> \<br /> nodes_cost_min:nodes_TIMESTAMP.* {\<br /> ## Ermittlung des minimal Wertes\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;nodes_TIMESTAMP&quot;,&quot;null&quot;) ne &quot;null&quot; ) {\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT cast(min(VALUE)*100 AS DECIMAL(4,2)) FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_cost'\<br /> AND TIMESTAMP &gt;= curdate() ;;&quot;) ;;\<br /> } else {\<br /> ReadingsVal(&quot;$NAME&quot;,&quot;nodes_cost_min&quot;,&quot;null&quot;)\<br /> }\<br /> },\<br /> \<br /> nodes_cost_max:nodes_TIMESTAMP.* {\<br /> ## Ermittlung des maximal Wertes\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;nodes_TIMESTAMP&quot;,&quot;null&quot;) ne &quot;null&quot; ) {\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT cast(max(VALUE)*100 AS DECIMAL(4,2)) FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_cost'\<br /> AND TIMESTAMP &gt;= curdate() ;;&quot;) ;;\<br /> } else {\<br /> ReadingsVal(&quot;$NAME&quot;,&quot;nodes_cost_max&quot;,&quot;null&quot;)\<br /> }\<br /> },\<br /> \<br /> nodes_consumption_day:nodes_TIMESTAMP.* {\<br /> ## Berechnung des Tages Verbrauches\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_consumption'\<br /> AND date(TIMESTAMP) = curdate() ;;&quot;) ;;\<br /> },\<br /> \<br /> nodes_consumption_month:nodes_TIMESTAMP.* {\<br /> ## Berechnung des Monats Verbrauches\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_consumption'\<br /> AND YEAR(TIMESTAMP) = YEAR(curdate())\<br /> AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;&quot;) ;;\<br /> },\<br /> \<br /> nodes_consumption_year:nodes_TIMESTAMP.* {\<br /> ## Berechnung des Jahres Verbrauches\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_consumption'\<br /> AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;&quot;) ;;\<br /> },\<br /> \<br /> fc_avg:current_price.* {\<br /> ## Berechnung des durchschnitt Wertes\<br /> my $fc_avg = 0;;\<br /> my $fc = 0;;\<br /> \<br /> if (ReadingsVal(&quot;$NAME&quot;,&quot;fc1_00_startsAt&quot;,&quot;null&quot;) ne &quot;null&quot;) { ## Der nächste Tag ist bereits da\<br /> if (AttrVal(&quot;$NAME&quot;,&quot;verbose&quot;,0) &gt;=3) {\<br /> Log 3, &quot;$NAME cmd_1 : Tibber Daten für fc1 sind bereits da&quot;;;\<br /> }\<br /> $fc = 1;;\<br /> } # end if\<br /> \<br /> for (my $j=0;;$j&lt;=$fc;;$j++){\<br /> for (my $k=0;;$k&lt;=23;;$k++) { ## Summe berechnen\<br /> $fc_avg += ReadingsVal(&quot;$NAME&quot;,sprintf(&quot;fc%d_%02d_total&quot;,$j,$k),0);;\<br /> } # end $k\<br /> } # end $j\<br /> \<br /> return round($fc_avg / (24 *(1+$fc)) *100 ,2);; ## Durchschnitt berechnen\<br /> },\<br /> \<br /> fc_med:current_price.* {\<br /> ## Berechnung des median Wertes\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT\<br /> cast( ( (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', floor(1+((count(VALUE)-1) / 2))) , ',', -1))\<br /> + (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', ceiling(1+((count(VALUE)-1) / 2))), ',', -1))\<br /> )/2 *100\<br /> AS DECIMAL(4,2))\<br /> FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND ( READING='fc0_total' AND TIMESTAMP &gt;= DATE_FORMAT(NOW(), '%Y-%m-%d 00:00:00')\<br /> OR READING='fc1_total' AND TIMESTAMP &gt;= DATE_FORMAT(NOW() + INTERVAL 1 DAY, '%Y-%m-%d 00:00:00') ) ;;&quot;) ;;\<br /> },\<br /> \<br /> fc_min:current_price.* {\<br /> ## Ermittlung des minimal Wertes\<br /> my $fc_min = 0;;\<br /> my $fc_tmp = 0;;\<br /> my $fc = 0;;\<br /> \<br /> if (ReadingsVal(&quot;$NAME&quot;,&quot;fc1_00_startsAt&quot;,&quot;null&quot;) ne &quot;null&quot;) { ## Der nächste Tag ist bereits da\<br /> $fc = 1;;\<br /> } # end if\<br /> \<br /> for (my $j=0;;$j&lt;=$fc;;$j++){\<br /> for (my $k=0;;$k&lt;=23;;$k++) {\<br /> $fc_tmp = ReadingsVal(&quot;$NAME&quot;,sprintf(&quot;fc%d_%02d_total&quot;,$j,$k),0);;\<br /> \<br /> if (($fc_tmp &lt; $fc_min) or ($j == 0 and $k == 0)) {\<br /> $fc_min = $fc_tmp;;\<br /> }\<br /> } # end $k\<br /> } # end $j\<br /> \<br /> return round($fc_min *100 ,2);; ## Von Euro auf Cent umrechnen\<br /> },\<br /> \<br /> fc_max:current_price.* {\<br /> ## Ermittlung des minimal Wertes\<br /> my $fc_max = 0;;\<br /> my $fc_tmp = 0;;\<br /> my $fc = 0;;\<br /> \<br /> if (ReadingsVal(&quot;$NAME&quot;,&quot;fc1_00_startsAt&quot;,&quot;null&quot;) ne &quot;null&quot;) { ## Der nächste Tag ist bereits da\<br /> $fc = 1;;\<br /> } # end if\<br /> \<br /> for (my $j=0;;$j&lt;=$fc;;$j++){\<br /> for (my $k=0;;$k&lt;=23;;$k++) {\<br /> $fc_tmp = ReadingsVal(&quot;$NAME&quot;,sprintf(&quot;fc%d_%02d_total&quot;,$j,$k),0);;\<br /> \<br /> if (($fc_tmp &gt; $fc_max) or ($j == 0 and $k == 0)) {\<br /> $fc_max = $fc_tmp;;\<br /> }\<br /> } # end $k\<br /> } # end $j\<br /> \<br /> return round($fc_max *100 ,2);; ## Von Euro auf Cent umrechnen\<br /> },\<br /> \<br /> fc_trigger_price:fc_avg.* {\<br /> ## fc_trigger_price:[fc_avg|compensation_grid].* {\<br /> my $fc_avg = ReadingsVal(&quot;$NAME&quot;,&quot;fc_avg&quot;,0);;\<br /> my $fc_min = ReadingsVal(&quot;$NAME&quot;,&quot;fc_min&quot;,0);;\<br /> \<br /> # Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\<br /> my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\<br /> \<br /> # Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;compensation_grid&quot;,0) != 0 ) {\<br /> my $price_level_battery = round( ($fc_avg - ReadingsVal(&quot;$NAME&quot;,&quot;compensation_grid&quot;,0)) *0.85 , 1) ;;\<br /> if ( $price_level &gt; $price_level_battery ) {\<br /> $price_level = $price_level_battery;;\<br /> }\<br /> }\<br /> $price_level;;\<br /> },\<br /> \<br /> fc0_trigger_start:fc_trigger_price.* {\<br /> my $fc_trigger_price = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for (my $loop_hour = $hour;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc0_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &lt; $fc_trigger_price ) {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour)) ;;\<br /> }\<br /> } # end for loop_hour\<br /> \<br /> return(&quot;null&quot;);;\<br /> },\<br /> \<br /> fc0_trigger_stop:fc0_trigger_start.* {\<br /> my $fc = 0;;\<br /> my $loop_hour = 0;;\<br /> my $fc_trigger_price = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my $fc_trigger_start = ReadingsVal(&quot;$NAME&quot;,&quot;fc0_trigger_start&quot;,&quot;null&quot;);;\<br /> my $fc_trigger_stop = $fc_trigger_start;;\<br /> \<br /> if ( $fc_trigger_start ne &quot;null&quot; ) {\<br /> $fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for ($loop_hour = $fc_trigger_start;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$fc.&quot;_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &lt; $fc_trigger_price ) {\<br /> $fc_trigger_stop = sprintf(&quot;%02d:00&quot;,$loop_hour) ;;\<br /> } else {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour));;\<br /> }\<br /> \<br /> # wechsel zum nächsten Tag\<br /> if ( $loop_hour == 23 and $fc == 0 ) {\<br /> $fc = 1;;\<br /> $loop_hour = -1;;\<br /> }\<br /> \<br /> } # end for loop_hour\<br /> }\<br /> \<br /> return($fc_trigger_stop);;\<br /> },\<br /> \<br /> fc0_trigger:fc0_trigger_stop.* {\<br /> \<br /> # Setzen des Triggers für die aktuelle Stunde\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;current_price&quot;,100) &lt; ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) ) {\<br /> return(&quot;on&quot;)\<br /> } else {\<br /> return(&quot;off&quot;)\<br /> }\<br /> },\<br /> \<br /> fc1_trigger_start:fc_trigger_price.* {\<br /> if (ReadingsVal(&quot;$NAME&quot;,&quot;fc1_00_startsAt&quot;,&quot;null&quot;) ne &quot;null&quot;) {\<br /> my $fc_trigger_price = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for (my $loop_hour = 0;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc1_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &lt; $fc_trigger_price ) {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour)) ;;\<br /> }\<br /> } # end for loop_hour\<br /> }\<br /> return(&quot;null&quot;);;\<br /> },\<br /> \<br /> fc1_trigger_stop:fc0_trigger_start.* {\<br /> my $loop_hour = 0;;\<br /> my $fc_trigger_price = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my $fc_trigger_start = ReadingsVal(&quot;$NAME&quot;,&quot;fc1_trigger_start&quot;,&quot;null&quot;);;\<br /> my $fc_trigger_stop = $fc_trigger_start;;\<br /> \<br /> if ( $fc_trigger_start ne &quot;null&quot; ) {\<br /> $fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for ($loop_hour = $fc_trigger_start;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc1_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &lt; $fc_trigger_price ) {\<br /> $fc_trigger_stop = sprintf(&quot;%02d:00&quot;,$loop_hour) ;;\<br /> } else {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour));;\<br /> }\<br /> \<br /> } # end for loop_hour\<br /> }\<br /> \<br /> return($fc_trigger_stop);;\<br /> },\<br /> \<br /> fc_trigger_max:fc_avg.* {\<br /> my $fc_avg = ReadingsVal(&quot;$NAME&quot;,&quot;fc_avg&quot;,0);;\<br /> my $fc_max = ReadingsVal(&quot;$NAME&quot;,&quot;fc_max&quot;,0);;\<br /> \<br /> # Berechnung eines Schwellwertes als täglichen Maximalpreises\<br /> my $price_level = round( ($fc_max - $fc_avg)/2 + $fc_avg , 0);;\<br /> \<br /> $price_level;;\<br /> },\<br /> \<br /> fc0_trigger_max_start:fc_trigger_max.* {\<br /> my $fc_trigger_max = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_max&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger_max Fensters\<br /> my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for (my $loop_hour = $hour;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc0_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &gt; $fc_trigger_max ) {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour)) ;;\<br /> }\<br /> } # end for loop_hour\<br /> \<br /> return(&quot;null&quot;);;\<br /> },\<br /> \<br /> fc0_trigger_max_stop:fc0_trigger_max_start.* {\<br /> my $fc = 0;;\<br /> my $loop_hour = 0;;\<br /> my $fc_trigger_max = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_max&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my $fc_trigger_max_start = ReadingsVal(&quot;$NAME&quot;,&quot;fc0_trigger_max_start&quot;,&quot;null&quot;);;\<br /> my $fc_trigger_max_stop = $fc_trigger_max_start;;\<br /> \<br /> if ( $fc_trigger_max_start ne &quot;null&quot; ) {\<br /> $fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for ($loop_hour = $fc_trigger_max_start;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$fc.&quot;_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &gt; $fc_trigger_max ) {\<br /> $fc_trigger_max_stop = sprintf(&quot;%02d:00&quot;,$loop_hour) ;;\<br /> } else {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour));;\<br /> }\<br /> \<br /> # wechsel zum nächsten Tag\<br /> if ( $loop_hour == 23 and $fc == 0 ) {\<br /> $fc = 1;;\<br /> $loop_hour = -1;;\<br /> }\<br /> \<br /> } # end for loop_hour\<br /> }\<br /> \<br /> return($fc_trigger_max_stop);;\<br /> },\<br /> \<br /> fc0_trigger_max:fc0_trigger_max_stop.* {\<br /> \<br /> # Setzen des maximum Triggers für die aktuelle Stunde\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;current_price&quot;,0) &gt; ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_max&quot;,0) ) {\<br /> return(&quot;on&quot;)\<br /> } else {\<br /> return(&quot;off&quot;)\<br /> }\<br /> },\<br /> \<br /> fc1_trigger_max_start:fc_trigger_max.* {\<br /> if (ReadingsVal(&quot;$NAME&quot;,&quot;fc1_00_startsAt&quot;,&quot;null&quot;) ne &quot;null&quot;) {\<br /> my $fc_trigger_max = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_max&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for (my $loop_hour = 0;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc1_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &gt; $fc_trigger_max ) {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour)) ;;\<br /> }\<br /> } # end for loop_hour\<br /> }\<br /> return(&quot;null&quot;);;\<br /> },\<br /> \<br /> fc1_trigger_max_stop:fc0_trigger_max_start.* {\<br /> my $loop_hour = 0;;\<br /> my $fc_trigger_max = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_max&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my $fc_trigger_max_start = ReadingsVal(&quot;$NAME&quot;,&quot;fc1_trigger_max_start&quot;,&quot;null&quot;);;\<br /> my $fc_trigger_max_stop = $fc_trigger_max_start;;\<br /> \<br /> if ( $fc_trigger_max_start ne &quot;null&quot; ) {\<br /> $fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for ($loop_hour = $fc_trigger_max_start;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc1_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &gt; $fc_trigger_max ) {\<br /> $fc_trigger_max_stop = sprintf(&quot;%02d:00&quot;,$loop_hour) ;;\<br /> } else {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour));;\<br /> }\<br /> \<br /> } # end for loop_hour\<br /> }\<br /> \<br /> return($fc_trigger_max_stop);;\<br /> },\<br /> \<br /> total_cost_day:nodes_TIMESTAMP.* {\<br /> ## Berechnung des Tages Wertes\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\<br /> FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_cost'\<br /> AND date(TIMESTAMP) = curdate() ;;&quot;) ;;\<br /> },\<br /> \<br /> total_cost_month:nodes_TIMESTAMP.* {\<br /> ## Berechnung des monats Wertes\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\<br /> FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_cost'\<br /> AND YEAR(TIMESTAMP) = YEAR(curdate())\<br /> AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;&quot;) ;;\<br /> },\<br /> \<br /> total_cost_year:nodes_TIMESTAMP.* {\<br /> ## Berechnung des Jahres Wertes\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\<br /> FROM history\<br /> WHERE DEVICE='&quot;.$NAME.&quot;'\<br /> AND READING='nodes_cost'\<br /> AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;&quot;) ;;\<br /> },\<br /> \<br /> fc_DbLog:fc0_00_total.* {\<br /> my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\<br /> \<br /> for (my $loop_fc = 0;; $loop_fc &lt;= 1;; $loop_fc++) {\<br /> $loop_fc_next = $loop_fc +1;;\<br /> $date = ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$loop_fc.&quot;_00_startsAt&quot;,&quot;null&quot;);;\<br /> if ($date ne &quot;null&quot;) {\<br /> $date =~ /([\d+-]+)/;; $date = $1 ;;\<br /> for (my $loop_hour = 0;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $hour = sprintf(&quot;%02d&quot;,$loop_hour);;\<br /> $timestamp = $date.&quot; &quot;.$hour.&quot;:00:00&quot;;;\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$loop_fc.&quot;_&quot;.$hour.&quot;_total&quot;,&quot;null&quot;);;\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','fc&quot;.$loop_fc.&quot;_total','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> }\<br /> if (ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$loop_fc.&quot;_00_startsAt&quot;,&quot;null&quot;) eq ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$loop_fc_next.&quot;_00_startsAt&quot;,&quot;null&quot;)) {\<br /> fhem(&quot;deletereading $NAME fc&quot;.$loop_fc_next.&quot;_.*&quot;);;\<br /> }\<br /> } else {\<br /> fhem(&quot;deletereading $NAME fc1_.*&quot;);;\<br /> }\<br /> }\<br /> ReadingsTimestamp(&quot;$NAME&quot;,&quot;fc0_00_startsAt&quot;,&quot;null&quot;);;\<br /> }<br /> attr EVU_Tibber_connect verbose 0<br /> attr EVU_Tibber_connect ws_minInterval 54<br /> attr EVU_Tibber_connect ws_websocketURL wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== EVU_Tibber RAW Device ====<br /> Das Device dient der Anzeige und Steuerung des EVU_Tibber_connect Devices.<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> defmod EVU_Tibber DOIF ## Startup Befehle für den WebSocket vom EVU_Tibber_connect\<br /> init\<br /> { \<br /> Log(0, &quot;$SELF 0 init : ▶️ EVU_Tibber init&quot;);;\<br /> fhem(&quot;setreading EVU_Tibber_connect ws_cmd connect&quot;);; \<br /> if (AttrVal(&quot;$SELF&quot;,&quot;verbose&quot;,0) &gt;=3) {\<br /> Log 3, &quot;$SELF 0 WebSocket : ▶️ EVU_Tibber_connect start Websocket&quot;;;\<br /> }\<br /> Log(0, &quot;$SELF 0 init : 🏁 EVU_Tibber init done&quot;);;\<br /> }\<br /> \<br /> ################################################################################################################\<br /> ## EVU_Tibber_connect start/stop WebSocket\<br /> EVU_Tibber_connect_ws\<br /> {if( !([$SELF:state] eq &quot;off&quot;) ## DOIF enabled\<br /> # or [$SELF:ui_command_2] ## Hier wird das uiTable select ausgewertet\<br /> and [$SELF:ui_command_2] ne &quot;---&quot;\<br /> ) {\<br /> \<br /> fhem(&quot;setreading EVU_Tibber_connect ws_cmd &quot;.[?$SELF:ui_command_2]);; \<br /> \<br /> set_Reading(&quot;ui_command_2&quot;,&quot;---&quot;);; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\<br /> ## kann das Kommando nicht sofort wiederholt werden\<br /> }\<br /> }\<br /> \<br /> ################################################################################################################\<br /> ## 1 Scheduling für das Abholen von Tibber Daten\<br /> 1_EVU_Tibber_PriceInfo\<br /> {if( !([$SELF:state] eq &quot;off&quot;) ## DOIF enabled\<br /> and\<br /> ( [:03] ## Kurz nach jeder vollen Stunde\<br /> )\<br /> or [$SELF:ui_command_1] eq &quot;1_EVU_Tibber_PriceInfo&quot; ## Hier wird das uiTable select ausgewertet\<br /> ) {\<br /> \<br /> ::CommandGet(undef, &quot;EVU_Tibber_connect 01_priceInfo&quot;);; ## Preis für die aktuelle Stunde\<br /> ::CommandGet(undef, &quot;EVU_Tibber_connect 03_consumption_hour&quot;);; ## Kosten der letzen drei Stunden\<br /> if (AttrVal(&quot;$SELF&quot;,&quot;verbose&quot;,0) &gt;=3) {\<br /> Log 3, &quot;$SELF 1 PriceInfo : Abfrage von Tibber&quot;;;\<br /> }\<br /> \<br /> set_Reading(&quot;ui_command_1&quot;,&quot;---&quot;);; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\<br /> ## kann das Kommando nicht sofort wiederholt werden\<br /> }\<br /> }\<br /> \<br /> ################################################################################################################\<br /> ## 2 Scheduling für das Abholen der Tibber Preise\<br /> 2_EVU_Tibber_PriceAll\<br /> {if( !([$SELF:state] eq &quot;off&quot;) ## DOIF enabled\<br /> and\<br /> ([00:03] or [14:03] ## Ab 14:00 Uhr gibt es die Preise für den nächsten Tag\<br /> )\<br /> or [$SELF:ui_command_1] eq &quot;2_EVU_Tibber_PriceAll&quot; ## Hier wird das uiTable select ausgewertet\<br /> ) {\<br /> \<br /> ::CommandGet(undef, &quot;EVU_Tibber_connect 02_priceAll&quot;);;\<br /> if (AttrVal(&quot;$SELF&quot;,&quot;verbose&quot;,0) &gt;=3) {\<br /> Log 3, &quot;$SELF 2 priceAll : Abfrage von Tibber für den nächsten Tag&quot;;;\<br /> }\<br /> \<br /> set_Reading(&quot;ui_command_1&quot;,&quot;---&quot;);; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\<br /> ## kann das Kommando nicht sofort wiederholt werden\<br /> }\<br /> }\<br /> \<br /> ################################################################################################################\<br /> ## 2 Erstellen des Diagramms im uiTable\<br /> 3_EVU_Tibber_Diagramm\<br /> {if( !([$SELF:state] eq &quot;off&quot;) ## DOIF enabled\<br /> and\<br /> ( [00:05] or [14:05] ## Kurz nach Mitternacht\<br /> )\<br /> or [$SELF:ui_command_1] eq &quot;3_EVU_Tibber_Diagramm&quot; ## Hier wird das uiTable select ausgewertet\<br /> ) {\<br /> \<br /> my (@out) = (&quot;&quot;) x 2;;\<br /> my $timestamp;;\<br /> \<br /> for (my $j=0;;$j&lt;=1;;$j++){\<br /> \<br /> if (ReadingsVal(&quot;EVU_Tibber_connect&quot;,sprintf(&quot;fc%d_00_startsAt&quot;,$j),&quot;null&quot;) eq &quot;null&quot;) { ## Der nächste Tag ist noch nicht da\<br /> if (AttrVal(&quot;$SELF&quot;,&quot;verbose&quot;,0) &gt;=3) {\<br /> Log 3, &quot;$SELF 3 Diagramm : Tibber Daten für fc&quot;.$j.&quot; sind noch nicht da&quot;;;\<br /> }\<br /> \<br /> $timestamp = POSIX::strftime(&quot;%Y-%m-%d&quot;,localtime(time+86400));; ## Setze das Datum auf morgen\<br /> for (my $k=0;;$k&lt;=24;;$k++) {\<br /> $out[$j] .= sprintf(&quot;%s_%02d:00:00 0.0\n&quot;, $timestamp, $k);; ## Die Daten mit 0 ergänzen\<br /> }\<br /> $j = 2;; ## Aus der Schleife springen\<br /> \<br /> } else {\<br /> \<br /> for (my $i=0;;$i&lt;=23;;$i++){\<br /> $timestamp = ReadingsVal(&quot;EVU_Tibber_connect&quot;,sprintf(&quot;fc%d_%02d_startsAt&quot;,$j,$i),&quot;&quot;);;\<br /> $timestamp =~ s/ /_/g;;\<br /> $out[$j] .=$timestamp.&quot; &quot;.::round(ReadingsVal(&quot;EVU_Tibber_connect&quot;,sprintf(&quot;fc%d_%02d_total&quot;,$j, $i),0)*100,1).&quot;\n&quot;;;\<br /> } # End $i\<br /> \<br /> } # End if\<br /> } # End $j\<br /> \<br /> if (AttrVal(&quot;$SELF&quot;,&quot;verbose&quot;,0) &gt;=3) {\<br /> Log 3, &quot;$SELF 3 Diagramm : Werte für das Diagramm&quot;;;\<br /> print($out[0]);;\<br /> print($out[1]);;\<br /> }\<br /> ## Die readings current_price und current_level dienen hier nur als Trigger Events, und müssen für\<br /> ## jedes Diagramm unterschiedlich sein, die Daten werden über $out[] bereit gestellt !!\<br /> ::DOIF_modify_card_data(&quot;EVU_Tibber&quot;,&quot;EVU_Tibber_connect&quot;,&quot;current_price&quot;,&quot;bar1day&quot;,0,$out[0]);;\<br /> ::DOIF_modify_card_data(&quot;EVU_Tibber&quot;,&quot;EVU_Tibber_connect&quot;,&quot;current_level&quot;,&quot;bar1day&quot;,-86400,$out[1]);;\<br /> ## Mit der Abfrage 03_consumption_hour werden die Trigger erneut ausgelöst\<br /> ::CommandGet(undef, &quot;EVU_Tibber_connect 01_priceInfo&quot;);; ## Kosten der letzen drei Stunden\<br /> ## fhem(&quot;get EVU_Tibber_connect 01_priceInfo&quot;);; ## Kosten der letzen drei Stunden\<br /> \<br /> set_Reading(&quot;ui_command_1&quot;,&quot;---&quot;);; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\<br /> ## kann das Kommando nicht sofort wiederholt werden\<br /> }\<br /> }\<br /> <br /> attr EVU_Tibber DbLogExclude .*<br /> attr EVU_Tibber comment Version 2023.12.06 13:00 \<br /> Dieses Device benötigt EVU_Tibber_connect als Verbindung zu Tibber.<br /> attr EVU_Tibber disable 0<br /> attr EVU_Tibber group PV Steuerung EVU<br /> attr EVU_Tibber icon stromzaehler_icon<br /> attr EVU_Tibber room Strom-&gt;Boerse<br /> attr EVU_Tibber sortby 315<br /> attr EVU_Tibber uiState {\<br /> package ui_Table;;\<br /> $TABLE = &quot;style='width:100%;;'&quot;;;\<br /> \<br /> $TD{0..6}{0} = &quot;style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'&quot;;;\<br /> $TD{0..6}{1..4} = &quot;style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'&quot;;;\<br /> $TD{0..6}{5} = &quot;style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'&quot;;;\<br /> \<br /> }\<br /> \<br /> &quot;Kommando&lt;dd&gt;Auswahl&lt;/dd&gt;&quot; |widget([$SELF:ui_command_1],&quot;uzsuDropDown,---,1_EVU_Tibber_PriceInfo,2_EVU_Tibber_PriceAll,3_EVU_Tibber_Diagramm&quot;) |&quot;LiveMessurement &lt;br&gt;&quot;.widget([$SELF:ui_command_2],&quot;uzsuDropDown,---,connect,disconnect&quot;)|&quot;&quot;|[EVU_Tibber_connect:ws_cmd]\<br /> \<br /> &quot;Strompreis&lt;br&gt;&quot;.card([EVU_Tibber_connect:current_price:bar1day],undef,undef,0,60,90,0,&quot;fc0 &quot;.::ReadingsVal(Device(),&quot;current_currency&quot;,&quot;&quot;),undef,&quot;1&quot;,&quot;130,,,,,,220&quot;).card([EVU_Tibber_connect:current_level:bar1day],undef,undef,0,60,90,0,&quot;fc1 &quot;.::ReadingsVal(Device(),&quot;current_currency&quot;,&quot;&quot;),undef,&quot;1&quot;,&quot;130,,,,,,220&quot;)|\<br /> &quot;&lt;span style=font-weight:bold&gt;nächste 3h&lt;/span&gt;&lt;br&gt;&lt;br&gt;&quot;.Price(1).&quot;&lt;br&gt;&quot;.Price(2).&quot;&lt;br&gt;&quot;.Price(3)|&quot;&lt;span style=font-weight:bold&gt;Statistik fc0&lt;/span&gt;&lt;br&gt;&lt;br&gt;&quot;.::ReadingsVal(Device(),&quot;fc_min&quot;,0).&quot; min&lt;br&gt;&quot;.::ReadingsVal(Device(),&quot;fc_avg&quot;,0).&quot; avg&lt;br&gt;&quot;.::ReadingsVal(Device(),&quot;fc_med&quot;,0).&quot; med&lt;br&gt;&quot;.::ReadingsVal(Device(),&quot;fc_max&quot;,0).&quot; max&quot;|\<br /> &quot;&lt;span style=font-weight:bold&gt;Trigger fc0&lt;/span&gt;&lt;br&gt;Basis &quot;.widget([EVU_Tibber_connect:compensation_grid],&quot;selectnumbers,0,0.1,12,1,lin&quot;).&quot;&lt;br&gt;&quot;.Format(&quot;trigger_0&quot;)|\<br /> &quot;&lt;span style=font-weight:bold&gt;Trigger fc1&lt;/span&gt;&lt;br&gt;&lt;br&gt;&quot;.Format(&quot;trigger_1&quot;)<br /> attr EVU_Tibber uiTable {\<br /> package ui_Table;;\<br /> $TABLE = &quot;style='width:100%;;'&quot;;;\<br /> \<br /> $TD{0..18}{0} = &quot;style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'&quot;;;\<br /> $TD{0..18}{1..5} = &quot;style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'&quot;;;\<br /> $TD{0..18}{6} = &quot;style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'&quot;;;\<br /> \<br /> sub FUNC_Status {\<br /> my($value, $min, $colorMin, $statusMin, $colorMiddel, $statusMiddle, $max, $colorMax, $statusMax)=@_;;\<br /> my $ret = ($value &lt; $min)? '&lt;span style=&quot;color:'.$colorMin.'&quot;&gt;'.$statusMin.'&lt;/span&gt;' : ($value &gt; $max)? '&lt;span style=&quot;color:'.$colorMax.'&quot;&gt;'.$statusMax.'&lt;/span&gt;' : '&lt;span style=&quot;color:'.$colorMiddel.'&quot;&gt;'.$statusMiddle.'&lt;/span&gt;';;\<br /> return $ret;;\<br /> }\<br /> \<br /> sub Device {\<br /> return &quot;$SELF&quot;.&quot;_connect&quot;;;\<br /> }\<br /> \<br /> sub Cost {\<br /> my($i)=@_;;\<br /> my $currency = (::ReadingsVal(Device(),&quot;current_currency&quot;,&quot;&quot;) eq &quot;EUR&quot;)? &quot; €&quot; : &quot;&quot;;;\<br /> \<br /> return ::ReadingsVal(Device(),&quot;total_cost_&quot;.$i,0).$currency;;\<br /> }\<br /> \<br /> sub Price {\<br /> my($i)=@_;;\<br /> my $j;;\<br /> my $value;;\<br /> my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\<br /> \<br /> if ($i == 0) {\<br /> $value = ::ReadingsVal(Device(),&quot;current_price&quot;,0);;\<br /> $value = ( ::ReadingsVal(Device(),&quot;fc0_trigger&quot;,&quot;off&quot;) eq &quot;on&quot; ) ?\<br /> &quot;&lt;span style='color:green'&gt;&quot;.$value.&quot;&lt;/span&gt;&quot; :\<br /> &quot;&lt;span style='color:red'&gt;&quot;.$value.&quot;&lt;/span&gt;&quot; ;;\<br /> $value .= &quot; ct/kWh&quot;;;\<br /> } else {\<br /> $j = $i+$hour;;\<br /> if ($j &lt; 24) {\<br /> $value = ::round(::ReadingsVal(Device(),&quot;fc0_&quot;.sprintf(&quot;%02d&quot;,$j).&quot;_total&quot;,0)*100,1);;\<br /> } else {\<br /> $j = $j - 24;;\<br /> $value = ::round(::ReadingsVal(Device(),&quot;fc1_&quot;.sprintf(&quot;%02d&quot;,$j).&quot;_total&quot;,0)*100,1);;\<br /> }\<br /> $value = ( ::ReadingsVal(Device(),&quot;fc_trigger_price&quot;,&quot;0&quot;) &gt; $value ) ?\<br /> &quot;&lt;span style='color:green'&gt;&quot;.$value.&quot;&lt;/span&gt;&quot; :\<br /> &quot;&lt;span style='color:red'&gt;&quot;.$value.&quot;&lt;/span&gt;&quot; ;;\<br /> $value = sprintf(&quot;%02d&quot;,$j).&quot; : &quot;.$value ;;\<br /> }\<br /> return $value;;\<br /> }\<br /> \<br /> sub Format {\<br /> my($i)=@_;;\<br /> \<br /> my $MonthBefore = &quot;LogDBRep_Statistic_previous_Month&quot;;;\<br /> my $MonthPrevious = ::ReadingsTimestamp(&quot;$MonthBefore&quot;,&quot;EVU_Tibber_Pulse_nodes_consumption_month&quot;,&quot;null&quot;);;\<br /> $MonthPrevious = ($MonthPrevious ne &quot;null&quot;) ? POSIX::strftime(&quot;%Y&quot;,localtime(::time_str2num(::ReadingsTimestamp(&quot;$MonthBefore&quot;,&quot;EVU_Tibber_Pulse_nodes_consumption_month&quot;,&quot;null&quot;)))) : &quot;null&quot;;;\<br /> \<br /> my $YearBefore = &quot;LogDBRep_Statistic_previous_Year&quot;;;\<br /> my $YearPrevious = ::ReadingsTimestamp(&quot;$YearBefore&quot;,Device().&quot;_nodes_consumption_year&quot;,&quot;null&quot;);;\<br /> $YearPrevious = ($YearPrevious ne &quot;null&quot;) ? POSIX::strftime(&quot;%Y&quot;,localtime(::time_str2num(::ReadingsTimestamp(&quot;$YearBefore&quot;,Device().&quot;_nodes_consumption_year&quot;,&quot;null&quot;)))) : &quot;null&quot;;;\<br /> \<br /> if ($i eq &quot;day&quot;) {\<br /> return sprintf(&quot;%04d&quot;,::ReadingsVal(Device(),&quot;nodes_consumption_day&quot;,0));;\<br /> } elsif ($i eq &quot;month&quot;) {\<br /> my $evu_em = sprintf(&quot;%04d&quot;,::ReadingsVal(Device(),&quot;nodes_consumption_month&quot;,0));;\<br /> $evu_em .= ($MonthPrevious ne &quot;null&quot;) ? sprintf(&quot; / %04d&quot;, ::ReadingsVal(&quot;$MonthBefore&quot;,&quot;EVU_Tibber_Pulse_nodes_consumption_month&quot;,0) ) : &quot;&quot;;;\<br /> return $evu_em;;\<br /> } elsif ($i eq &quot;year&quot;) {\<br /> my $evu_ey = sprintf(&quot;%04d&quot;,::ReadingsVal(Device(),&quot;nodes_consumption_year&quot;,0));;\<br /> $evu_ey .= ($YearPrevious ne &quot;null&quot;) ? sprintf(&quot; / %04d&quot;, ::ReadingsVal(&quot;$YearBefore&quot;,&quot;EVU_Tibber_Pulse_nodes_consumption_month&quot;,0) ) : &quot;&quot;;;\<br /> return $evu_ey;;\<br /> } elsif ($i eq &quot;trigger_0&quot;) {\<br /> return ((::ReadingsVal(Device(),&quot;fc0_trigger_start&quot;,&quot;&quot;) eq &quot;null&quot; ) ?\<br /> &quot;&lt;span style='color:red'&gt;Heute kein Trigger &lt;br&gt;mehr unter &quot;.\<br /> ::ReadingsVal(Device(),&quot;fc_trigger_price&quot;,&quot;null&quot;).&quot; ct&lt;/span&gt;&quot; :\<br /> &quot;&lt;span style='color:green'&gt;Trigger von&lt;br&gt;&quot;.\<br /> ::ReadingsVal(Device(),&quot;fc0_trigger_start&quot;,&quot;00:00&quot;).&quot; bis &quot;.::ReadingsVal(Device(),&quot;fc0_trigger_stop&quot;,&quot;00:00&quot;).&quot;&lt;br&gt;unter &quot;.\<br /> ::ReadingsVal(Device(),&quot;fc_trigger_price&quot;,&quot;null&quot;).&quot; ct&lt;/span&gt;&quot; );;\<br /> } elsif ($i eq &quot;trigger_1&quot;) {\<br /> if (::ReadingsVal(Device(),&quot;fc1_00_startsAt&quot;,&quot;null&quot;) ne &quot;null&quot;) {\<br /> return ((::ReadingsVal(Device(),&quot;fc1_trigger_start&quot;,&quot;null&quot;) eq &quot;null&quot; ) ?\<br /> &quot;&lt;span style='color:red'&gt;Morgen kein Trigger &lt;br&gt;mehr unter &quot;.\<br /> ::ReadingsVal(Device(),&quot;fc_trigger_price&quot;,&quot;null&quot;).&quot; ct&lt;/span&gt;&quot; :\<br /> &quot;&lt;span style='color:green'&gt;Morgen ein Trigger von&lt;br&gt;&quot;.\<br /> ::ReadingsVal(Device(),&quot;fc1_trigger_start&quot;,&quot;00:00&quot;).&quot; bis &quot;.::ReadingsVal(Device(),&quot;fc1_trigger_stop&quot;,&quot;00:00&quot;).&quot;&lt;br&gt;unter &quot;.\<br /> ::ReadingsVal(Device(),&quot;fc_trigger_price&quot;,&quot;null&quot;).&quot; ct&lt;/span&gt;&quot; );;\<br /> } else {\<br /> return &quot;Morgen noch kein Trigger vorhanden&quot;;;\<br /> }\<br /> }\<br /> return &quot;null&quot;;;\<br /> }\<br /> \<br /> }\<br /> \<br /> &quot;Statistiken &quot;.::ReadingsVal(Device(),&quot;current_date&quot;,0).&quot; in kWh&quot;|&quot;&lt;span style=font-weight:bold&gt;aktuell&lt;/span&gt;&quot;|&quot;&lt;span style=font-weight:bold&gt;heute&lt;/span&gt;&quot;|&quot;&lt;span style=font-weight:bold&gt;Monat&lt;/span&gt;&quot;|&quot;&lt;span style=font-weight:bold&gt;Jahr&lt;/span&gt;&quot;\<br /> \<br /> &quot;Strom&lt;dd&gt;Preis / Kosten&lt;/dd&gt;&quot;|Price(0)|Cost(&quot;day&quot;)|Cost(&quot;month&quot;)|Cost(&quot;year&quot;)\<br /> \<br /> ## Wenn man das liveMessurment von Tibber verwendet\<br /> &quot;Bezug vom Netz&quot;|\<br /> sprintf(&quot;%04d W&quot;,([EVU_Tibber_connect:payload_data_liveMeasurement_power] &gt;= 0 ? ::ReadingsVal(&quot;EVU_Tibber_connect&quot;,&quot;payload_data_liveMeasurement_power&quot;,0) : 0))|\<br /> Format(&quot;day&quot;)|Format(&quot;month&quot;)|Format(&quot;year&quot;)\<br /> \<br /> &quot;Einspeisung ins Netz&quot;|\<br /> sprintf(&quot;%04d W&quot;,([EVU_Tibber_connect:payload_data_liveMeasurement_powerProduction] &gt;= 0 ? ::ReadingsVal(&quot;EVU_Tibber_connect&quot;,&quot;payload_data_liveMeasurement_powerProduction&quot;,0) : 0))|\<br /> &quot;&quot;|&quot;&quot;|&quot;&quot;\<br /> \<br /> ## Wenn man einen eigenes SmartMeter verwendet\<br /> ## &quot;Bezug vom Netz&quot;|sprintf(&quot;%04d W&quot;,([WR_0_KSEM:M_AC_Power] &gt;= 0 ? ::round(::ReadingsVal(&quot;WR_0_KSEM&quot;,&quot;M_AC_Power&quot;,0),0) : 0) )|Format(&quot;day&quot;)|Format(&quot;month&quot;)|Format(&quot;year&quot;)\<br /> ## &quot;Einspeisung ins Netz&quot;|sprintf(&quot;%04d W&quot;,([WR_0_KSEM:M_AC_Power] &lt;= 0 ? abs(::round(::ReadingsVal(&quot;WR_0_KSEM&quot;,&quot;M_AC_Power&quot;,0),0)) : 0) )|&quot;&quot;|&quot;&quot;|&quot;&quot;<br /> attr EVU_Tibber verbose 3<br /> <br /> setstate EVU_Tibber 2024-01-23 10:03:00 ui_command_1 ---<br /> setstate EVU_Tibber 2024-01-20 17:40:53 ui_command_2 ---<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== LogDBRep_EVU_Tibber_connect_SQL RAW Device ====<br /> Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements wertden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> defmod LogDBRep_EVU_Tibber_connect_SQL DbRep LogDB<br /> attr LogDBRep_EVU_Tibber_connect_SQL DbLogExclude .*<br /> attr LogDBRep_EVU_Tibber_connect_SQL room System<br /> attr LogDBRep_EVU_Tibber_connect_SQL sqlCmdHistoryLength 5<br /> attr LogDBRep_EVU_Tibber_connect_SQL timeout 20<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == 2. aWATTar ==<br /> <br /> === Vorausetzungen ===<br /> * FHEM mit einer installierten MySQL DbLog (FileLog wird nicht untertsützt)<br /> * Für die Berechnung der tatsächlichen Kosten benötigt man seine lokalen fix Kosten, die je nach Region unterschiedlich sind.<br /> * Die bisherige Berechnung mit Stand 20240123 wäre wie folgt: round(($val+$val*0.03+1.785)*1.19,2)<br /> <br /> === EVU_aWATTar_connect ===<br /> Das EVU_aWATTar_connect fragt mit HTTPMOD die aWATTar API Webseite ab. Es werden keine Live Verbrauchdaten geliefert.<br /> <br /> ==== Verwendete Module ====<br /> * HTTPMOD<br /> * DbLog<br /> * DbRep<br /> <br /> ==== EVU_aWATTar_connect RAW Device ====<br /> Momentan fragt das EVU_aWattar_connect lediglich die aktuellen Preise des Tages ab. Die readings sind an die des EVU_Tibber_connect angelehnt, um im weiteren Verlauf evetuell ein gemeinsames Device für die Anzeige und Steuerung zu erarbeiten.<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> defmod EVU_aWATTar_connect HTTPMOD https://api.awattar.de/v1/marketdata/current.yaml 0<br /> attr EVU_aWATTar_connect DbLogExclude .*<br /> attr EVU_aWATTar_connect comment Version 2024.01.23 13:00\<br /> \<br /> Achtung, momentan werden nur die Börsenpreise ohne die fix Kosten dargestellt.\<br /> \<br /> https://api.awattar.de/v1/marketdata<br /> attr EVU_aWATTar_connect enableControlSet 1<br /> attr EVU_aWATTar_connect get01-15Name fc_max<br /> attr EVU_aWATTar_connect get01-15OExpr round(($val+$val*0.03+1.785)*1.19,2)<br /> attr EVU_aWATTar_connect get01-1Name current_date<br /> attr EVU_aWATTar_connect get01-22Name fc_med<br /> attr EVU_aWATTar_connect get01-22OExpr round(($val+$val*0.03+1.785)*1.19,2)<br /> attr EVU_aWATTar_connect get01-29Name fc_avg<br /> attr EVU_aWATTar_connect get01-29OExpr round(($val+$val*0.03+1.785)*1.19,2)<br /> attr EVU_aWATTar_connect get01-36Name current_price<br /> attr EVU_aWATTar_connect get01-36OExpr round(($val+$val*0.03+1.785)*1.19,2)<br /> attr EVU_aWATTar_connect get01-8Name fc_min<br /> attr EVU_aWATTar_connect get01-8OExpr round(($val+$val*0.03+1.785)*1.19,2)<br /> attr EVU_aWATTar_connect get01Name 01_priceInfo<br /> attr EVU_aWATTar_connect get01RegOpt g<br /> attr EVU_aWATTar_connect get01Regex date_now: (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})|price_low: ([0-9]+[0-9\.]+)|price_high: ([0-9]+[0-9\.]+)|price_median: ([0-9]+[0-9\.]+)|price_average: ([0-9]+[0-9\.]+)|price_current: ([0-9]+[0-9\.]+)<br /> attr EVU_aWATTar_connect get01URL https://api.awattar.de/v1/marketdata/current.yaml<br /> attr EVU_aWATTar_connect get02-10Name fc0_09_total<br /> attr EVU_aWATTar_connect get02-10OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-11Name fc0_10_total<br /> attr EVU_aWATTar_connect get02-11OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-12Name fc0_11_total<br /> attr EVU_aWATTar_connect get02-12OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-13Name fc0_12_total<br /> attr EVU_aWATTar_connect get02-13OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-14Name fc0_13_total<br /> attr EVU_aWATTar_connect get02-14OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-15Name fc0_14_total<br /> attr EVU_aWATTar_connect get02-15OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-16Name fc0_15_total<br /> attr EVU_aWATTar_connect get02-16OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-17Name fc0_16_total<br /> attr EVU_aWATTar_connect get02-17OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-18Name fc0_17_total<br /> attr EVU_aWATTar_connect get02-18OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-19Name fc0_18_total<br /> attr EVU_aWATTar_connect get02-19OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-1Name fc0_00_total<br /> attr EVU_aWATTar_connect get02-1OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-20Name fc0_19_total<br /> attr EVU_aWATTar_connect get02-20OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-21Name fc0_20_total<br /> attr EVU_aWATTar_connect get02-21OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-22Name fc0_21_total<br /> attr EVU_aWATTar_connect get02-22OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-23Name fc0_22_total<br /> attr EVU_aWATTar_connect get02-23OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-24Name fc0_23_total<br /> attr EVU_aWATTar_connect get02-24OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-2Name fc0_01_total<br /> attr EVU_aWATTar_connect get02-2OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-3Name fc0_02_total<br /> attr EVU_aWATTar_connect get02-3OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-4Name fc0_03_total<br /> attr EVU_aWATTar_connect get02-4OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-5Name fc0_04_total<br /> attr EVU_aWATTar_connect get02-5OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-6Name fc0_05_total<br /> attr EVU_aWATTar_connect get02-6OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-7Name fc0_06_total<br /> attr EVU_aWATTar_connect get02-7OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-8Name fc0_07_total<br /> attr EVU_aWATTar_connect get02-8OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02-9Name fc0_08_total<br /> attr EVU_aWATTar_connect get02-9OExpr round(($val+$val*0.03+1.785)*1.19/100,4)<br /> attr EVU_aWATTar_connect get02FollowGet 01_priceInfo<br /> attr EVU_aWATTar_connect get02Name 02_priceDay<br /> attr EVU_aWATTar_connect get02RegOpt g<br /> attr EVU_aWATTar_connect get02Regex (?&lt;=abs_[0-9]{2}_amount: )([0-9]+[0-9\.]+)<br /> attr EVU_aWATTar_connect get02URL https://api.awattar.de/v1/marketdata/current.yaml<br /> attr EVU_aWATTar_connect get03-1Name fc3_00_startsAt<br /> attr EVU_aWATTar_connect get03-1OExpr POSIX::strftime(&quot;%Y-%m-%d %H:%M:%S&quot;,localtime(substr($val,0,10)))<br /> attr EVU_aWATTar_connect get03-4Name fc3_00_total<br /> attr EVU_aWATTar_connect get03-4OExpr round($val/1000,4)<br /> attr EVU_aWATTar_connect get03Name 02_priceAll<br /> attr EVU_aWATTar_connect get03RegOpt g<br /> attr EVU_aWATTar_connect get03Regex &quot;start_timestamp&quot;: (\d{10})|&quot;marketprice&quot;: (\d*\.\d*)<br /> attr EVU_aWATTar_connect get03URL https://api.awattar.de/v1/marketdata?start=1701990000000&amp;end=1702159200000<br /> attr EVU_aWATTar_connect group PV Steuerung EVU<br /> attr EVU_aWATTar_connect icon sani_pump<br /> attr EVU_aWATTar_connect room Strom-&gt;Boerse<br /> attr EVU_aWATTar_connect sortby 213<br /> attr EVU_aWATTar_connect userReadings fc_trigger_price:fc_avg.* {\<br /> ## fc_trigger_price:[fc_avg|compensation_grid].* {\\<br /> my $fc_avg = ReadingsVal(&quot;$NAME&quot;,&quot;fc_avg&quot;,0);;\<br /> my $fc_min = ReadingsVal(&quot;$NAME&quot;,&quot;fc_min&quot;,0);;\<br /> \<br /> # Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\<br /> my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\<br /> \<br /> # Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;compensation_grid&quot;,0) != 0 ) {\<br /> my $price_level_battery = round( ($fc_avg - ReadingsVal(&quot;$NAME&quot;,&quot;compensation_grid&quot;,0)) *0.85 , 1) ;;\<br /> if ( $price_level &gt; $price_level_battery ) {\<br /> $price_level = $price_level_battery;;\<br /> }\<br /> }\<br /> $price_level;;\<br /> },\<br /> \<br /> fc0_trigger_start:fc_trigger_price.* {\<br /> my $fc_trigger_price = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for (my $loop_hour = $hour;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc0_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &lt; $fc_trigger_price ) {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour)) ;;\<br /> }\<br /> } # end for loop_hour\<br /> \<br /> return(&quot;null&quot;);;\<br /> },\<br /> \<br /> fc0_trigger_stop:fc0_trigger_start.* {\<br /> my $fc = 0;;\<br /> my $loop_hour = 0;;\<br /> my $fc_trigger_price = ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) /100;;\<br /> \<br /> # Ermitteln des nächsten Trigger Fensters\<br /> my $fc_trigger_start = ReadingsVal(&quot;$NAME&quot;,&quot;fc0_trigger_start&quot;,&quot;null&quot;);;\<br /> my $fc_trigger_stop = $fc_trigger_start;;\<br /> \<br /> if ( $fc_trigger_start ne &quot;null&quot; ) {\<br /> $fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\<br /> my $fc_total = 0;;\<br /> \<br /> for ($loop_hour = $fc_trigger_start;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $fc_total = ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$fc.&quot;_&quot;.sprintf(&quot;%02d&quot;,$loop_hour).&quot;_total&quot;,0);;\<br /> if ( $fc_total &lt; $fc_trigger_price ) {\<br /> $fc_trigger_stop = sprintf(&quot;%02d:00&quot;,$loop_hour) ;;\<br /> } else {\<br /> return(sprintf(&quot;%02d:00&quot;,$loop_hour));;\<br /> }\<br /> \<br /> # wechsel zum nächsten Tag\<br /> if ( $loop_hour == 23 and $fc == 0 ) {\<br /> $fc = 1;;\<br /> $loop_hour = -1;;\<br /> }\<br /> \<br /> } # end for loop_hour\<br /> }\<br /> \<br /> return($fc_trigger_stop);;\<br /> },\<br /> \<br /> fc0_trigger:fc0_trigger_stop.* {\<br /> \<br /> # Setzen des Triggers für die aktuelle Stunde\<br /> if ( ReadingsVal(&quot;$NAME&quot;,&quot;current_price&quot;,100) &lt; ReadingsVal(&quot;$NAME&quot;,&quot;fc_trigger_price&quot;,0) ) {\<br /> return(&quot;on&quot;)\<br /> } else {\<br /> return(&quot;off&quot;)\<br /> }\<br /> },\<br /> \<br /> fc_DbLog:fc0_00_total.* {\<br /> my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\<br /> \<br /> for (my $loop_fc = 0;; $loop_fc &lt;= 1;; $loop_fc++) {\<br /> $loop_fc_next = $loop_fc +1;;\<br /> $date = ReadingsVal(&quot;$NAME&quot;,&quot;current_date&quot;,&quot;null&quot;);;\<br /> if ($date ne &quot;null&quot;) {\<br /> $date =~ /([\d+-]+)/;; $date = $1 ;;\<br /> for (my $loop_hour = 0;; $loop_hour &lt;= 23;; $loop_hour++) {\<br /> $hour = sprintf(&quot;%02d&quot;,$loop_hour);;\<br /> $timestamp = $date.&quot; &quot;.$hour.&quot;:00:00&quot;;;\<br /> $value = ReadingsVal(&quot;$NAME&quot;,&quot;fc&quot;.$loop_fc.&quot;_&quot;.$hour.&quot;_total&quot;,&quot;null&quot;);;\<br /> ::CommandGet(undef, &quot;LogDBRep_&quot;.$NAME.&quot;_SQL sqlCmdBlocking\<br /> INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\<br /> VALUES('&quot;.$timestamp.&quot;','$NAME','Tibber','fc&quot;.$loop_fc.&quot;_total','&quot;.$value.&quot;')\<br /> ON DUPLICATE KEY UPDATE\<br /> VALUE='&quot;.$value.&quot;';;&quot;) ;;\<br /> }\<br /> } else {\<br /> fhem(&quot;deletereading $NAME fc1_.*&quot;);;\<br /> }\<br /> }\<br /> ReadingsVal(&quot;$NAME&quot;,&quot;current_date&quot;,&quot;null&quot;);;\<br /> }<br /> attr EVU_aWATTar_connect verbose 0<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== LogDBRep_EVU_aWATTar_connect_SQL RAW Device ====<br /> Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements wertden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.<br /> &lt;syntaxhighlight lang=&quot;Perl&quot;&gt;<br /> defmod LogDBRep_EVU_aWATTar_connect_SQL DbRep LogDB<br /> attr LogDBRep_EVU_aWATTar_connect_SQL DbLogExclude .*<br /> attr LogDBRep_EVU_aWATTar_connect_SQL room System<br /> attr LogDBRep_EVU_aWATTar_connect_SQL sqlCmdHistoryLength 5<br /> attr LogDBRep_EVU_aWATTar_connect_SQL timeout 20<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Links ==<br /> * Website (deutsch) des Anbieters [https://tibber.com/de Tibber]<br /> * Website (deutsch) des Anbieters [https://www.awattar.de/ aWATTar]</div> Stephan http://wiki.fhem.de/w/index.php?title=FTUI_Widget_Checkbox&diff=37375 FTUI Widget Checkbox 2022-04-03T05:57:35Z <p>Stephan: /* Attribute */</p> <hr /> <div>Das [[{{PAGENAME}}|Widget Checkbox]] ist ein Widget für [[FHEM Tablet UI]], welches als Umschalter zwischen zwei Zuständen eingesetzt wird. Es verhält sich ähnlich wie das [[FTUI_Widget_Switch]] und orientiert sich optisch an Konfigurationsschaltern moderner grafischer Benutzeroberflächen. Daher empfiehlt es sich, die Checkbox weniger als Schalter für Devices einzusetzen, sondern vornehmlich für die Aktivierung von Funktionalitäten, zumal in dieses Widget keine Symbole integriert werden können.<br /> <br /> &lt;gallery height=&quot;100&quot; widths=&quot;300&quot;&gt;<br /> File:FTUI_Widget_Checkbox_01.png<br /> &lt;/gallery&gt;<br /> <br /> ==Attribute==<br /> {| class=&quot;wikitable&quot;<br /> !Attribut<br /> !Beschreibung<br /> !Standard-Wert<br /> !Beispiel<br /> |-<br /> |'''data-device'''||FHEM-Device, dessen Reading gesetzt werden soll (&lt;command&gt; '''&lt;device&gt;''' &lt;reading&gt; &lt;value&gt;)||||<br /> |-<br /> |'''data-get'''||Reading, dessen Inhalt den aktuellen Wert wiedergibt||'STATE'||<br /> |-<br /> |'''data-set'''||Reading, das gesetzt werden soll (&lt;command&gt; &lt;device&gt; '''&lt;reading&gt;''' &lt;value&gt;)||||<br /> |-<br /> |'''data-cmd'''||Befehl, der gesendet werden soll ('''&lt;command&gt;''' &lt;device&gt; &lt;reading&gt; &lt;value&gt;) (z.B. setstate, set, setreading, trigger)||||<br /> |-<br /> |'''data-doubleclick (n/a)'''||Zeit, die vergehen muss, bis das Element ein zweites mal betätigt werden kann. '0' schaltet dieses Verhalten ab.||||<br /> |-<br /> |'''data-lock (n/a)'''||Reading, mit dem das Element für eine Bedienung gesperrt wird. Gütige Werte sind 'true', '1' oder 'on' ||||<br /> |-<br /> |'''data-color'''||Farbe des Icon (RGB-Angabe oder Farbname)||||<br /> |-<br /> |'''data-background-color'''||Hintergrundfarbe des Widgets||||<br /> |-<br /> |'''data-hide'''||Reading zum Verstecken des Elementes. Das Element verschwindet, wenn der Wert mit '''data-hide-on''' übereinstimmt.||||<br /> |-<br /> |'''data-hide-on'''||Zeichenkette, bei der das Element versteckt wird||&lt;nowiki&gt;'true|1|on'&lt;/nowiki&gt;||<br /> |-<br /> |'''data-hide-off'''||Zeichenkette, bei der das Element angezeigt wird||'!on'||<br /> |-<br /> |'''data-hideparents'''||jQuery-Selector, um auch die Eltern-Elemente zu verstecken||||data-hideparents=&quot;#Name&quot;<br /> |-<br /> |'''data-reachable'''||Reading, dessen Inhalt angibt, ob das Device erreichbar ist, oder nicht. Der Inhalt des Readings muss eine Ganzzahl (Integer) sein.||||<br /> |}<br /> <br /> ==CSS Klassen==<br /> {|class=&quot;wikitable&quot;<br /> !Klasse!!Beschreibung<br /> {{FTUI Klasse|small}}{{FTUI Klasse|normal}}{{FTUI Klasse|large}}{{FTUI Klasse|transparent}}{{FTUI Klasse|half-transparent}}{{FTUI Klasse|hide}}<br /> |}<br /> <br /> Zusätzlich sind alle Vordergrundfarben-[[FHEM_Tablet_UI#CSS-Klassen|Klassen]] als Hintergrundfarbe für den Zustand &quot;ON&quot; verfügbar.<br /> <br /> ==Beispiele==<br /> [[File:FTUI_Widget_Checkbox_01.png]]<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;checkbox&quot; class=&quot;&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> <br /> [[File:FTUI_Widget_Checkbox_03.png]]<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;checkbox&quot; <br /> data-on-color=&quot;green&quot; <br /> data-on-background-color=&quot;blue&quot; <br /> data-off-color=&quot;red&quot; <br /> data-off-background-color=&quot;white&quot; <br /> class=&quot;&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==Links==<br /> [[FTUI_Widget_Switch]]<br /> <br /> [[Kategorie:FHEM Tablet UI|Checkbox]]</div> Stephan http://wiki.fhem.de/w/index.php?title=SVG&diff=37267 SVG 2022-02-26T01:55:22Z <p>Stephan: Links zur commandref &quot;repariert&quot;. Sieht nicht mehr ganz so schön aus wie vorher, funktioniert dafür aber wieder;)</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Erstellung von Diagrammen aus Logdaten<br /> |ModType=h<br /> |ModForumArea=Frontends<br /> |ModTechName=98_SVG.pm <br /> |ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])}}<br /> <br /> Das Modul [[SVG]] generiert Diagramme aus [[FileLog|Logdateien]] oder [[DbLog|-datenbanken]].<br /> <br /> Die Eigenschaften des zu erstellenden Diagrams werden in einer .gplot-Datei festgelegt.<br /> <br /> == Definition ==<br /> Die Definition &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> define &lt;name&gt; SVG &lt;logDevice&gt;:&lt;gplotfile&gt;:&lt;logfile&gt;<br /> &lt;/syntaxhighlight&gt;besteht lediglich in der Angabe einer Datenquelle, einer .gplot-File und der Angabe von entweder ''CURRENT'' (für LogFile-Quellen) bzw. ''HISTORY'' (für Datenbanken).<br /> <br /> Details zur Definition sind in der {{Link2CmdRef|Anker=SVG-define}} dargestellt.<br /> <br /> == Hintergründe ==<br /> Ursprünglich wurde für das Rendern von Diagrammen in FHEM das Programmpaket ''[http://gnuplot.sourceforge.net/ gnuplot]'' verwendet. Daher entspricht die Syntax der ''.gplot''-Files in großen Teilen derjenigen von ''gnuplot'' (z.B. zu den Linientypen und -farben oder zur Gestaltung des Hintergrundes). Allerdings eben nur in großen Teilen, denn das Modul ''SVG'' implementiert eigenständige Rendering-Routinen, so dass die grundlegenden Formatierungsvorgaben dort, wo dies über spezielle Attribute gesteuert werden kann (z.B. zur Zahl der Achsen), auch über die Attribute vorgenommen werden sollte. Weiter sollte man nicht davon ausgehen, dass alle eventuell von gnuplot her bekannten Funktionen unterstützt werden.<br /> Weitere Hinweise hierzu und zum Aufbau der ''.gplot''-Files sind in [[Plots_erzeugen#Individuell / Manuell|Plots erzeugen]] zu finden.<br /> {{Hinweis|Der Artikel [[Plots_erzeugen|Plots erzeugen]] enthält auch eine Darstellung des gplot-Editors. Dieser kann ein gutes Hilfsmittel sein, um ein grundlegendes Verständnis der Funktionsweise zu erhalten. Man erhält damit allerdings ''.gplot''-Dateien, die sämtliche Angaben hart vercodet beinhalten. Falls Sie beabsichtigen, eine ''.gplot''-File zur Verwendung mit mehreren gleichartigen Geräten anzulegen, empfiehlt es sich, die Dateien direkt zu bearbeiten und die Verweise auf die darzustellenden Daten über Attribute zu steuern, wie nachfolgend dargestellt.}}<br /> == Attribute ==<br /> Das wichtigste spezifische Attribut ist ''plotReplace'', das einige andere, ältere Attribute ersetzen kann. Durch dieses können Angaben in den .gplot-Dateien dynamisch ersetzt werden, wodurch es auf einfache Weise möglich ist, dieselbe .gplot-Datei zur Erstellung von mehreren Plots zu nutzen, die dann auch in einem Plot unterschiedliche Datenquellen verwenden können. Dabei ist zu beachten, dass die in ''plotReplace'' angegebenen Parameter-Wert-Paare in zwei Stufen ersetzt werden: <br /> <br /> Wird in der .gplot-Datei die Schreibweise ''%key%'' verwendet, wird der Parameter bereits ersetzt, bevor die Datenquelle ausgewertet wurde, in der Schreibweise ''&lt;key&gt;'' erfolgt die Auswertung erst danach. Dies ermöglicht es z.B. auch, Informationen aus unterschiedlichen FileLog-Dateien zu visualisieren, ohne die betreffende Datenquelle hart in der .gplot-Datei zu verankern.<br /> <br /> Weiter ist es über diesen Mechanismus möglich, auch angepaßten Perl-Code zur Datenauswertung und -formatierung zu verwenden.<br /> <br /> Siehe dazu insbesondere auch die nachfolgenden beiden Beispiele &quot;Leistungsdaten einer Steckdose (FileLog)&quot; und &quot;Temperatur- und Heizungsdaten eines Zimmers&quot; (DBLog).<br /> <br /> Weitere Details in der {{Link2CmdRef|Anker=SVG-attr}}.<br /> <br /> == Funktionen ==<br /> Details in der {{Link2CmdRef|Anker=SVG-attr-plotfunction}}.<br /> <br /> == Beispiele ==<br /> <br /> === Leistungsdaten einer Steckdose (FileLog) ===<br /> <br /> * Inhalt der Datei '''SVG_PlugX.gplot'''<br /> {{Randnotiz|RNTyp=g|RNText=Gegebenenfalls sind die Feldnamen anzupassen}}<br /> &lt;syntaxhighlight lang=&quot;Gnuplot&quot;&gt;<br /> # Leistungsdaten einer Steckdose (FileLog)<br /> #<br /> # plotReplace-Parameter: DataDevice (von diesem Gerät stammen die Daten)<br /> # FileLogDevice (in diesem Gerät werden die Daten geloggt)<br /> # stateOFFvalue (y-Wert zur Darstellung von ausgeschaltetem Zustand)<br /> # stateONvalue (y-Wert zur Darstellung von eingeschaltetem Zustand)<br /> # stateUNKNOWNvalue (y-Wert zur Darstellung von unbekanntem Zustand)<br /> # title (in der Regel ein perl-Ausdruck zur Darstellung von Eckwerten in der Titelzeile)<br /> # yrange (Wertebereich für Darstellung in W vorgeben)<br /> # y2range (Wertebereich für Darstellung in mA vorgeben)<br /> <br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;title&gt;'<br /> set ytics <br /> set y2tics <br /> set grid ytics y2tics<br /> set ylabel &quot;Leistung (W)&quot;<br /> set y2label &quot;Strom (mA)&quot;<br /> set yrange %yrange%<br /> set y2range %y2range%<br /> <br /> #%FileLogDevice% 4:%DataDevice%.power\x3a:0:<br /> #%FileLogDevice% 4:%DataDevice%.current\x3a:&quot;&quot;:($fld[3]*1000)<br /> #%FileLogDevice% 4:%DataDevice%.userRead_socket_state\x3a:&quot;&quot;:($fld[3]=~&quot;off&quot;?%stateOFFvalue%:($fld[3]=~&quot;on&quot;?%stateONvalue%:%stateUNKNOWNvalue%))<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Leistung' ls l0 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Strom' ls l1fill_stripe lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Schaltzustand' ls l3 lw 1 with steps<br /> &lt;/syntaxhighlight&gt;<br /> <br /> * Definition von SVG-Device '''SVG_Test'''<br /> {{Randnotiz|RNTyp=g|RNText=Alle Vorkommen von ...Data-Device... und ...FileLog-Device... sind zu ersetzen}}<br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> defmod SVG_Test SVG ...FileLog-Device...:SVG_PlugX:CURRENT<br /> attr SVG_Test captionPos auto<br /> attr SVG_Test plotReplace DataDevice=&quot;...Data-Device...&quot; FileLogDevice=&quot;...FileLog-Device...&quot; stateOFFvalue=&quot;20&quot; stateONvalue=&quot;30&quot; stateUNKNOWNvalue=&quot;10&quot; yrange=&quot;[0:75]&quot; y2range=&quot;[0:300]&quot; title={&quot;Steckdose(Testgerät) --- W: $data{min1}...$data{max1} / $data{currval1} --- mA: $data{min2}...$data{max2} / $data{currval2}&quot;}<br /> &lt;/syntaxhighlight&gt;<br /> <br /> * So sieht das resultierende Diagramm aus<br /> [[Datei:SVG Leistungsdaten einer Steckdose.png|thumb|left|300px]]<br /> <br /> <br /> <br /> <br /> <br /> <br /> === Temperatur- und Heizungsdaten eines Zimmers === <br /> Quelle: {{Link2Forum|Topic=104935|Message=1011527}}<br /> (Datenquelle ist ein DBLog-Device namens LogDB):<br /> <br /> [[Datei:PlotReplace Example DBLog.png|thumb|right|300px]]<br /> &lt;syntaxhighlight lang=&quot;Gnuplot&quot;&gt;<br /> # Created by FHEM/98_SVG.pm, 2020-01-06<br /> # to replace variables, use plotReplace like<br /> # plotReplace-Parameter: SPEC1=Thermostat (von diesem Gerät stammen die Thermostat-Daten)<br /> # DBLogDevice (in diesem Gerät werden die Daten geloggt)<br /> # Die übrigen plotReplace-Parameter sind selbsterklärend, Beispiel:<br /> # attr SVG_Thermostat plotReplace DBLogDevice=DBLog SPEC1=Thermostat TL=&quot;My example thermostat&quot; EXTERNALTEMPDEVICE=MYSENSOR_97 EXTERNALTEMPREADING=temperature2 \<br /> # ROOMHUMIDITYDEVICE=HUEDevice3 EXTERNALHUMIDITYREADING=humidity ROOMTEMPDEVICE=HUEDevice4 ROOMTEMPREADING=temperature WINDOW1=Window1_MyRoom WINDOW2=Window2_MyRoom<br /> <br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;TL&gt;'<br /> set ytics<br /> set y2tics<br /> set grid<br /> set ylabel &quot;Valve/Window&quot;<br /> set y2label &quot;Temperature&quot;<br /> set yrange [-5:105]<br /> set y2range [-15:35]<br /> set isosample 20<br /> <br /> #%DBLogDevice% %SPEC1%:desired-temp::<br /> #%DBLogDevice% %SPEC1%:measured-temp:0:<br /> #%DBLogDevice% %EXTERNALTEMPDEVICE%:%EXTERNALTEMPREADING%::<br /> #%DBLogDevice% %SPEC1%:actuator:0:int<br /> #%DBLogDevice% %ROOMHUMIDITYDEVICE%:%EXTERNALHUMIDITYREADING%:0:<br /> #%DBLogDevice% %ROOMTEMPDEVICE%:%ROOMTEMPREADING%:0:<br /> #%DBLogDevice% %WINDOW1%:state:::$val=~s/(open|closed|tilted)(\d*).*/$1eq&quot;open&quot;?60:$1eq&quot;tilted&quot;?45:0/eg<br /> #%DBLogDevice% %WINDOW2%:state:::$val=~s/(open|closed|tilted)(\d*).*/$1eq&quot;open&quot;?60:$1eq&quot;tilted&quot;?45:0/eg<br /> <br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 2:2 axes x1y2 title 'Measured actuator' ls l7 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Aussen' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 y2title 'Valve' ls l5 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Humidity' ls l2 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured roomsensor' ls l3 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 y2title '%WINDOW1%' ls l4fill lw 0.5 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 y2title '%WINDOW2%' ls l5fill lw 0.5 with steps<br /> &lt;/syntaxhighlight&gt;<br /> == Hinweise ==<br /> * Plot-Abrisse vermeiden<br /> Sind in den Quelldaten nicht genügend Datenpunkte vorhanden, kann es zu Lücken in der Darstellung kommen. Abhilfe kann man mit [[LogProxy]] schaffen oder, indem man zusätzliche Datenpunkte in den Datenquellen generiert, z.B. durch das Setzen von ''addLog''-Attributen an FileLog bzw. DBLog-Geräten. Weitere Hinweise sind in [[Plot-Abriss vermeiden]] zu finden.<br /> <br /> == Links ==<br /> * [[Plots erzeugen]]<br /> * [[Creating Plots]]<br /> <br /> &lt;references /&gt;<br /> [[Kategorie:Logging]]</div> Stephan http://wiki.fhem.de/w/index.php?title=Event-aggregator&diff=34636 Event-aggregator 2021-01-18T19:20:04Z <p>Stephan: Alternative: DOIF hinzugefügt</p> <hr /> <div>{{SEITENTITEL:event-aggregator}} &lt;!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat --&gt;<br /> &lt;!-- Infobox Attribut sinnvoll? --&gt;<br /> {{Baustelle}}<br /> Mit dem Attribut [[event-aggregator]] können (nach Wunsch zeitlich gewichtete) Durchschnittswerte, Minima, Maxima oder Median etc. berechnet werden. Der Median kann hilfreich sein, um Messwerte mit Ausreissern (unsinnige Werte, z.B. durch Übertragungsfehler) zu glätten.<br /> <br /> == Syntax ==<br /> Das ''event-aggregator'' Attribut wird in der folgenden Weise spezifiziert:<br /> :&lt;code&gt;&lt;nowiki&gt;attr &lt;device&gt; event-aggregator reading:interval:method:function:holdTime&lt;/nowiki&gt;&lt;/code&gt;<br /> <br /> Mehrere Readings werden als kommagetrennte Liste angegeben.<br /> <br /> Die einzelnen Teile haben folgende Bedeutung:<br /> === reading ===<br /> Das zu aggregierende Reading des aktuellen Gerätes. Das Reading selbst muss seine Werte aus einer Aktion oder einem Event in FHEM erhalten (beispielsweise, indem Temperaturwerte ausgegeben oder andere Größen in das Reading geschrieben werden). Indem dann der event-aggregator auf dieses Reading angewandt wird, werden die erhaltenen Größen bearbeitet - je nach Installation wird dann also das Minimum, das Maximum oder der Median der Werte beim Reading ausgegeben.<br /> <br /> Wichtig: Es kann immer nur einen event-aggregator pro Reading geben. Will man daher mehrere Werte (z.B. min, max, avg), muss man weitere Readings erzeugen (z.B. mit userReadings oder notify). Der Aggregator kann als regulärer Ausdruck angegeben werden (bsp. .*_rain.*)<br /> <br /> === interval === <br /> <br /> Updates des &lt;readings&gt; werden ignoriert, Events werden für mindestens &lt;interval&gt; Sekunden unterdrückt.<br /> <br /> Nach der interval-periode wird das reading mit einem Wert upgedated, der sich aus den Werten und Zeitstempeln der vorher ignorierten Updates zusammensetzt.<br /> <br /> === method === <br /> <br /> betrifft die Gewichtung nach Zeitintervallen<br /> * &lt;code&gt;none&lt;/code&gt;: keine zeitliche Gewichtung<br /> * &lt;code&gt;const&lt;/code&gt;: Annahme, dass zwischen den zwei Messpunkten keine Veränderung stattgefunden hat<br /> * &lt;code&gt;linear&lt;/code&gt;: Annahme, dass der Wert sich zwischen zwei Messpunkten linear verändert hat.<br /> <br /> === function === <br /> <br /> * &lt;code&gt;count&lt;/code&gt; Anzahl<br /> * &lt;code&gt;min&lt;/code&gt; Minimum<br /> * &lt;code&gt;max&lt;/code&gt; Maximum<br /> * &lt;code&gt;mean&lt;/code&gt; artihmetischer Mittelwert<br /> * &lt;code&gt;sd&lt;/code&gt; Standardabweichung<br /> * &lt;code&gt;integral&lt;/code&gt; Summe (falls holdTime nicht angegeben) oder Integral für den Zeitraum holdTime<br /> * &lt;code&gt;median&lt;/code&gt; [https://de.wikipedia.org/wiki/Median Median] (nur für method &lt;code&gt;none&lt;/code&gt; und gesetzte holdTime) - im Gegensatz zum Mittelwert nicht anfällig für Ausreisser, hilfreich bei Sensoren mit sporadisch unsinnigen Messwerten<br /> <br /> === holdTime === <br /> <br /> Zeitfenster in Sekunden, für die die vergangenen Werte gehalten werden, um die Aggregatfunktion zu berechnen.<br /> <br /> <br /> == Duplizieren von Readings==<br /> Wenn mehrere Funktionen für ein Reading berechnet werden sollen, muss dieses Reading zuvor dupliziert werden.<br /> In der Commandref wird ein notify vorgeschlagen, evtl. können aber auch DOIF_Readings, event_Readings und userReadings verwendet werden:<br /> <br /> &lt;code&gt;<br /> original_reading:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === DOIF_Readings ===<br /> TODO!<br /> &lt;code&gt;<br /> original_reading:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === event_Readings ===<br /> &lt;code&gt;<br /> attr DOIF-Device event_Readings <br /> original_reading:[&lt;Device&gt;:&lt;Reading&gt;], &lt;br /&gt;<br /> copy_1:[$SELF:original_reading], &lt;br /&gt;<br /> &lt;s&gt;copy_2:int(10*[$SELF:copy_1])/10&lt;/s&gt; Funktioniert so nicht!!! &lt;br /&gt;<br /> attr DOIF-Device event-aggregator copy_1:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === userReadings ===<br /> &lt;code&gt;<br /> attr DOIF-Device userReadings <br /> original_reading {ReadingsVal(&quot;&lt;Device&gt;&quot;,&quot;&lt;Reading&gt;&quot;,0)}, &lt;br /&gt;<br /> copy_1 {ReadingsVal($name,&quot;original_reading&quot;,0)}, &lt;br /&gt;<br /> copy_2 {int(10*ReadingsVal($name,&quot;copy_1&quot;,0))/10}&lt;br /&gt;<br /> attr DOIF-Device event-aggregator copy_1:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> Dabei darf anscheinend kein Leerzeichen zwischen mehreren Readings vorkommen: https://forum.fhem.de/index.php/topic,114947.msg1091775.html#msg1091775<br /> <br /> == Wechselwirkungen == <br /> - keine bekannt - <br /> <br /> == Beispiele ==<br /> ; aus der {{Link2CmdRef|Anker=Event-aggregator}}<br /> &lt;code&gt;<br /> attr myPowerMeter event-aggregator EP_POWER_METER:300:linear:mean,EP_ENERGY_METER:300:none:v<br /> <br /> attr myBadSensor event-aggregator TEMP::none:median:300<br /> <br /> attr mySunMeter event-aggregator SUN_INTENSITY_24H::const:integral:86400<br /> &lt;/code&gt;<br /> <br /> == Siehe auch ==<br /> *[[event-on-update-reading]]<br /> *[[event-min-interval]]<br /> *[[event-aggregator]]<br /> Es gibt mittlerweile auch bei DOIF eine Funktion, die diverse Mittelwerte berechnet. Für alle, die mit event-aggregator hadern, ggf. eine Alternative.<br /> <br /> == Links ==<br /> * Benutzungstipps (''Best Practice'') für das Attribut in {{Link2Forum|Topic=36522|LinkText=diesem Forenthread}}<br /> <br /> [[Kategorie:Attribut (allgemeingültig)]]</div> Stephan http://wiki.fhem.de/w/index.php?title=NUKI&diff=34518 NUKI 2021-01-01T02:46:56Z <p>Stephan: Rechtschreibfehler behoben</p> <hr /> <div>&lt;div style=&quot;float:right&quot;&gt;<br /> {{Infobox Modul<br /> |ModPurpose=Einbindung der Nuki Bridge HW/APP<br /> |ModType=d<br /> |ModCmdRef=NUKIBridge<br /> |ModForumArea=Sonstige Systeme<br /> |ModTechName=73_NUKIBridge.pm<br /> |ModOwner=CoolTux &lt;br /&gt;({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])<br /> }}<br /> {{Infobox Modul<br /> |ModPurpose=Steuern von Nuki Smartlocks über NUKIBridge<br /> |ModType=d<br /> |ModCmdRef=NUKIDevice<br /> |ModForumArea=Sonstige Systeme<br /> |ModTechName=73_NUKIDevice.pm<br /> |ModOwner=CoolTux &lt;br /&gt;({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]])<br /> }}<br /> &lt;/div&gt;<br /> <br /> ==NUKIBridge==<br /> NUKIBridge - Steuert das Nuki Smartlock über die Nuki Bridge <br /> <br /> Das Nuki Bridge Modul verbindet FHEM mit der Nuki Bridge und liest dann alle auf der Bridge verfügbaren Smartlocks ein. Desweiteren werden automatisch die erkannten Smartlocks als eigenständige Devices angelegt.<br /> <br /> Für eine aktive Callback Funktion müssen noch zwei Attribute der Bridge eingerichtet werden:<br /> * webhookFWinstance - zu verwendende Webinstanz (darf keine Passwortabfrage beinhalten)<br /> * webhookHttpHostname - IP oder FQDN des FHEM Servers<br /> <br /> Voraussetzung für ein fehlerfreies Laden ist die Installation von JSON (libperl-json).<br /> <br /> ===Definition===<br /> :&lt;code&gt;define &lt;name&gt; NUKIBridge &lt;HOST&gt; &lt;API-TOKEN&gt;&lt;/code&gt;<br /> <br /> '''Beispiel:'''<br /> :&lt;code&gt;define NBridge1 NUKIBridge 192.168.0.23 F34HK6&lt;/code&gt;<br /> <br /> Diese Anweisung erstellt ein NUKIBridge Device mit Namen NBridge1 und der IP 192.168.0.23 sowie dem Token F34HK6. Nach dem Anlegen des Bridge Devices werden alle zur Verfügung stehende Smartlock automatisch in FHEM angelegt.<br /> <br /> ===Readings===<br /> * 0_nukiId - ID des ersten gefundenen Nuki Smartlocks<br /> * 0_name - Name des ersten gefunden Nuki Smartlocks<br /> * smartlockCount - Anzahl aller gefundenen Smartlock<br /> * bridgeAPI - API Version der Bridge<br /> * bridgeType - Hardware oder Software/App Bridge<br /> * currentTime - aktuelle Zeit auf der Bridge zum zeitpunkt des Info holens<br /> * firmwareVersion - aktuell auf der Bridge verwendete Firmwareversion<br /> * hardwareId - ID der Hardware Bridge<br /> * lastError - gibt die letzte HTTP Errormeldung wieder<br /> * serverConnected - true/false gibt an ob die Hardwarebridge Verbindung zur Nuki-Cloude hat.<br /> * serverId - gibt die ID des Cloudeservers wieder<br /> * uptime - Uptime der Bridge in Sekunden<br /> * wifiFirmwareVersion- Firmwareversion des Wifi Modules der Bridge<br /> * Die vorangestellte Zahl ist fortlaufend und gibt beginnend bei 0 die Eigenschaften eines Smartlocks wieder.<br /> <br /> ===Set===<br /> * &lt;s&gt;autocreate - veranlasst ein erneutes Einlesen aller Smartlocks von der Bridge und falls noch nicht in FHEM vorhanden das automatische Anlegen.&lt;/s&gt;<br /> * callbackRemove - löschen einer Callback Instanz auf der Bridge. Die Instanz ID kann mittels get callbackList ermittelt werden<br /> * clearLog - löscht das Logfile auf der Bridge<br /> * fwUpdate - schaut nach einer neueren Firmware und installiert diese, sofern vorhanden<br /> * info - holt aktuelle Informationen über die Bridge<br /> * reboot - veranlasst einen reboot der Bridge<br /> <br /> ===Get===<br /> * callbackList - gibt die Liste der eingetragenen Callback URLs wieder. Die Bridge nimmt maximal drei auf<br /> * logFile - zeigt das Logfile der Bridge an<br /> <br /> ===Attribute===<br /> * disable - deaktiviert die Nuki Bridge<br /> <br /> ==NUKIDevice==<br /> NUKIDevice - Steuert das Nuki Smartlock<br /> <br /> Das Nuki Modul verbindet FHEM über die Nuki Bridge mit einem Nuki Smartlock. Es ist dann möglich, das Schloss zu ver- und entriegeln. In der Regel werden die Nuki Devices automatisch durch das Bridgemodul angelegt. <br /> <br /> ===Definition===<br /> :&lt;code&gt;define &lt;name&gt; NUKIDevice &lt;Nuki-Id&gt; &lt;IODev-Device&gt;&lt;/code&gt;<br /> <br /> '''Beispiel:'''<br /> :&lt;code&gt;define Haustuer NUKIDevice 1 NBridge1&lt;/code&gt;<br /> <br /> Diese Anweisung erstellt ein NUKIDevice mit Namen Haustuer, der NukiId 1 sowie dem IODev Device NBridge1. Nach dem Anlegen des Devices wird automatisch der aktuelle Zustand des Smartlocks aus der Bridge gelesen.<br /> Damit das NUKIDevice auch Statusänderungen mitbekommt, die beispielsweise aus der nativen NUKI-App oder der manuellen Betätigung des Devices herrühren, ist es notwendig, die Attribute webhookFWinstance und webhookHttpHostname zu setzen.<br /> <br /> :&lt;code&gt;attr Haustuer webhookFWinstance WEB (Name der FHEMWEB Instanz)&lt;/code&gt;<br /> :attr Haustuer webhookHttpHostname 192.168.0.1 (IP/FQDN vom FHEM Server)<br /> <br /> Zum Überprüfen kann die Funktion<br /> :&lt;code&gt;get NUKIBridge callbackList&lt;/code&gt;<br /> aufgerufen werden. Es sollte nur ein Callback eingetragen<br /> sein, der in dieser Form hinterlegt sein sollte.<br /> :&lt;code&gt;&lt;nowiki&gt;0 http://192.168.0.1:8083/fhem/NUKIDevice-123456789&lt;/nowiki&gt;&lt;/code&gt;<br /> <br /> ===Readings===<br /> * state - Status des Smartlock bzw. Fehlermeldung von Fehler vorhanden.<br /> * lockState - aktueller Schließstatus: uncalibrated, locked, unlocked, unlocked (lock ‘n’ go), unlatched, locking, unlocking, unlatching, motor blocked, undefined<br /> * succes - true, false; gibt des Status des letzten Schließbefehles wieder. Geklappt oder nicht geklappt.<br /> * batteryCritical - ist die Batterie in einem kritischen Zustand? true, false<br /> * battery - Status der Batterie, ok, low<br /> <br /> <br /> ===Set===<br /> * statusRequest - ruft den aktuellen Status des Smartlocks von der Bridge ab<br /> * lock - verschließen<br /> * unlock - aufschließen<br /> * unlatch - entriegeln/Falle öffnen<br /> * locknGo - verschließen wenn gegangen<br /> * locknGoWithUnlatch - verschließen nachdem die Falle geöffnet wurde<br /> <br /> ===Attribute===<br /> * disable - deaktiviert das Nuki Device<br /> * webhookFWinstance - zu verwendene Webinstanz für den Callbackaufruf<br /> * webhookHttpHostname - IP oder FQDN vom FHEM Server für den Callbackaufruf<br /> <br /> == Links ==<br /> * [https://nuki.io/de/ Webseite des Herstellers]<br /> <br /> [[Kategorie:Türschlosssteuerung]]</div> Stephan http://wiki.fhem.de/w/index.php?title=Codemirror&diff=33890 Codemirror 2020-09-07T10:37:52Z <p>Stephan: Warnung bei STRG-Q hinzugefügt</p> <hr /> <div>{{Randnotiz|RNTyp=Fehl|RNText=Die Befehlsvervollständigungsfunktion funktioniert Stand 05/2019 nur, wenn der [[CsrfToken-HowTo|csrfToken]] in der entsprechenden FHEMWEB-Instanz abgeschaltet ist (&lt;code&gt;attr &lt;FHEMWEB&gt; csrfToken none&lt;/code&gt;). Aus Sicherheitsgründen empfiehlt sich den csrfToken nur zur Bearbeitung zu deaktivieren und/oder andere geeignete Sicherheitsmaßnahmen zu ergreifen ( -&gt; Aufmerksamkeit des Anwenders! ).}}<br /> <br /> {{SEITENTITEL:codemirror}}<br /> [[Bild:ConfEditDEFAutocomplete.png|mini|300px|rechts|Automatische Vervollständigung / Befehlsauswahlfenster (&quot;se&quot; getippt, dann Strg+Leertaste gedrückt)]]<br /> Bei der Bearbeitung der [[Konfiguration]] über das [[FHEMWEB]]-Frontend bietet FHEM optional Anwenderunterstützung durch Syntaxhervorhebungs-, Befehlsauswahl- und Befehlsvervollständigungsfunktionen. Hierzu ist der Editor [https://codemirror.net codemirror] in FHEM eingebunden.<br /> <br /> == Aktivierung in FHEMWEB ==<br /> Um die Funktionalität in FHEM zu aktivieren, muss folgendes Attribut auf die entsprechende FHEMWEB-Instanz gesetzt werden:<br /> :&lt;code&gt;attr &lt;FHEMWEB-Devicename&gt; JavaScripts codemirror/fhem_codemirror.js&lt;/code&gt;<br /> <br /> Für alle FHEMWEB-Instanzen der aktuellen Konfiguration wird die Funktionalität folgendermaßen aktiviert.<br /> :&lt;code&gt;attr TYPE=FHEMWEB JavaScripts codemirror/fhem_codemirror.js&lt;/code&gt;<br /> <br /> == Wichtige Tastenkombinationen ==<br /> Im erweiterten Editor ist Suchen und Ersetzen mit folgenden Tastenkombinationen möglich:<br /> * 'STRG + F' =&gt; Suche starten<br /> * 'STRG + G' =&gt; Zum nächsten Treffer<br /> * 'SHIFT + Ctrl + G' =&gt; Zum vorherigen Treffer<br /> * 'SHIFT + Ctrl + F' =&gt; Einzeln Ersetzen<br /> * 'SHIFT + Ctrl + R' =&gt; Im gesamten Dokument Ersetzen<br /> <br /> Folgende hilfreiche Tastenkombinationen werden desweiteren automatisch erstellt:<br /> * 'TAB' =&gt; Einrücken von Text, auch mehrerer markierter Zeilen auf einmal, oder mindestens einer komplett markierten Zeile. <br /> * 'SHIFT + TAB' =&gt; Verringern der Einrückung der aktuellen Zeile, oder auch mehrerer markierter Zeilen auf einmal.<br /> * 'STRG + Q' =&gt; Auskommentieren oder Kommentar der Zeile entfernen in welcher sich der Cursor gerade befindet, oder mehrerer markierter Zeilen auf einmal. '''ACHTUNG: Beendet ggf. auch ohne Nachfrage den Browser (Firefox), wodurch sämtliche Bearbeitungen unwiderruflich verloren sind!''' <br /> * 'STRG + UP' oder 'STRG + DOWN' =&gt; Hoch-/Runterscrollen des Textes ohne den Cursor umzusetzen.<br /> * 'ALT + G' =&gt; Jump-To-Line, falls das Modul jump-to-line.js über den entsprechenden codemirrorParam geladen wurde.<br /> <br /> == Anpassung ==<br /> Der Editor kann mit dem FHEMWEB-Attribut ''codemirrorParam'' und den Parametern, welche auf der [https://codemirror.net/doc/manual.html#config codemirror Seite] zu finden sind, noch weiter angepasst werden, z.B.: <br /> :&lt;code&gt;attr TYPE=FHEMWEB codemirrorParam { &quot;indentWithTabs&quot;:false, &quot;indentUnit&quot;:2, &quot;autocomplete&quot;:false, &quot;height&quot;:&quot;auto&quot; }&lt;/code&gt;<br /> In diesem Beispiel würde der Text statt mit Tabulatoren mit Leerzeichen und statt der standardmäßigen vier Leerzeichen, nur noch mit zwei Leerzeichen bei Verwenden von 'TAB' oder 'SHIFT+TAB' eingerückt werden, und Autovervollständigung mit STRG+SPACE wird deaktiviert (die Dateien show-hint.js und show-hint.css werden nicht mehr geladen); darüber hinaus wird die Höhe des Editors automatisch dem Inhalt angepasst.<br /> <br /> Folgende codemirror-Parameter werden standardmäßig gesetzt und können unter anderen mit dem Attribut ''codemirrorParam'' überschrieben werden:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Parameter !! Standardwert !! Wert !! Bemerkungen<br /> |-<br /> | &quot;matchBrackets&quot;<br /> | true<br /> | boolean<br /> | Lädt das Modul ''matchbrackets.js'' und aktiviert die Markierung zusammengehörender Klammern.<br /> |-<br /> | &quot;autoRefresh&quot;<br /> | true<br /> | boolean<br /> | Lädt das Modul ''autorefresh.js'', durch welches unter anderem verhindert wird, dass beim zweiten Aufruf von Codemirror ein schwarzer Editor ohne Inhalt angezeigt wird.<br /> |-<br /> | &quot;search&quot;<br /> | true<br /> | boolean<br /> | Lädt die Module ''search.js, searchcursor.js, dialog.js'', sowie den stylesheet ''dialog.css'' und aktiviert die Suchen &amp; Ersetzen Funktionalität.<br /> |-<br /> | &quot;comment&quot;<br /> | true<br /> | boolean<br /> | Lädt das Modul ''comment.js'' und aktiviert die Funktionalität mit STRG+Q Zeilen auszukommentieren / Kommentare zu entfernen.<br /> |-<br /> | &quot;autocomplete&quot;<br /> | true<br /> | boolean<br /> | Lädt das Modul ''show-hint.js'' sowie den stylesheet ''show-hint.css'' und aktiviert die Funktionalität, mit STRG+SPACE die Autovervollständigung zu verwenden.<br /> |-<br /> | &quot;autocompleteAlways&quot;<br /> | false<br /> | boolean<br /> | Wenn zusätzlich zu &quot;autocomplete&quot; aktiviert, wird die Befehlsvervollständigung bei jedem Tastendruck durchgeführt (nicht nur durch STRG+SPACE).<br /> |-<br /> | &quot;autoCloseBrackets&quot;<br /> | true<br /> | boolean<br /> | Lädt das Modul ''closebrackets.js'' und aktiviert die Funktionalität, dass ()[]{}''&quot;&quot; automatisch geschlossen werden.<br /> |-<br /> | &quot;jumpToLine&quot;<br /> | false<br /> | boolean<br /> | Lädt das Modul ''jump-to-line.js'' und aktiviert die Funktionalität, dass mit ALT+G zu bestimmten Zeilen gesprungen werden kann.<br /> |-<br /> | &quot;jumpToLine_extraKey&quot;<br /> | false<br /> | z.B. &quot;ALT-H&quot;<br /> | Hierdurch lässt sich die Standardtastenbelegung ALT+G für jumpToLine anpassen.<br /> |-<br /> | &quot;keyMap&quot;<br /> | false<br /> | &quot;vim&quot;<br /> | Hierdurch wird wie in dem Beispiel die Datei fhem/www/codemirror/vim.js oder eine andere in diesem Ordner befindliche *.js Datei geladen.<br /> |-<br /> | &quot;indentUnit&quot;<br /> | 4<br /> | integer<br /> | Gibt an, wieviele Leerzeichen ein TAB-Block umfasst.<br /> |-<br /> | &quot;type&quot;<br /> | &quot;fhem&quot;<br /> | string<br /> | Der Standard codemirror-mode, default wird hier die ''fhem.js'' geladen. <br /> |-<br /> | &quot;theme&quot;<br /> | &quot;blackboard&quot;<br /> | string<br /> | Das Standard codemirrer-theme, default wird hier die ''blackboard.css'' geladen.<br /> |-<br /> | &quot;indentWithTabs&quot;<br /> | true<br /> | boolean<br /> | Wenn aktiviert, wird mit Tabulator statt Leerzeichen eingerückt.<br /> |-<br /> | &quot;autofocus&quot;<br /> | true<br /> | boolean<br /> | Wenn aktiviert, wird der Fokus beim laden von codemirror automatisch in das Editor-Fenster gesetzt.<br /> |-<br /> | &quot;lineNumbers&quot;<br /> | true<br /> | boolean<br /> | Wenn aktiviert, werden die Zeilennummern im Editor angezeigt.<br /> |-<br /> | &quot;smartIndent&quot;<br /> | false<br /> | boolean<br /> | Kontext-sensitive Einrückung (''true'') oder &quot;gleiche Einrückung wie vorherige Zeile&quot; (''false'').<br /> |-<br /> | &quot;height&quot;<br /> | false<br /> | integer / &quot;auto&quot;<br /> | Entweder die standard, automatische, oder benutzerdefinierte Höhe des Editorfensters verwenden. (Im DEF sowie bei Attributen)<br /> |}<br /> <br /> == Links ==<br /> Der Forums-Thread unter der Überschrift {{Link2Forum|Topic=20444|LinkText=Javascript Editor einbinden}} enthält die Diskussion zum Entwicklungsprozess.<br /> <br /> [[Kategorie:Glossary]]<br /> [[Kategorie:FHEM Frontends]]</div> Stephan http://wiki.fhem.de/w/index.php?title=Event-aggregator&diff=32841 Event-aggregator 2020-02-24T12:13:43Z <p>Stephan: /* Duplizieren von Readings */</p> <hr /> <div>{{SEITENTITEL:event-aggregator}} &lt;!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat --&gt;<br /> &lt;!-- Infobox Attribut sinnvoll? --&gt;<br /> {{Baustelle}}<br /> Mit dem Attribut [[event-aggregator]] können (nach Wunsch zeitlich gewichtete) Durchschnittswerte, Minima, Maxima oder Median etc. berechnet werden. Der Median kann hilfreich sein, um Messwerte mit Ausreissern (unsinnige Werte, z.B. durch Übertragungsfehler) zu glätten.<br /> <br /> == Syntax ==<br /> Das ''event-aggregator'' Attribut wird in der folgenden Weise spezifiziert:<br /> :&lt;code&gt;&lt;nowiki&gt;attr &lt;device&gt; event-aggregator reading:interval:method:function:holdTime&lt;/nowiki&gt;&lt;/code&gt;<br /> <br /> Mehrere Readings werden als kommagetrennte Liste angegeben.<br /> <br /> Die einzelnen Teile haben folgende Bedeutung:<br /> === reading ===<br /> Das zu aggregierende Reading des aktuellen Gerätes. Das Reading selbst muss seine Werte aus einer Aktion oder einem Event in FHEM erhalten (beispielsweise, indem Temperaturwerte ausgegeben oder andere Größen in das Reading geschrieben werden). Indem dann der event-aggregator auf dieses Reading angewandt wird, werden die erhaltenen Größen bearbeitet - je nach Installation wird dann also das Minimum, das Maximum oder der Median der Werte beim Reading ausgegeben.<br /> <br /> Wichtig: Es kann immer nur einen event-aggregator pro Reading geben. Will man daher mehrere Werte (z.B. min, max, avg), muss man weitere Readings erzeugen (z.B. mit userReadings oder notify). Der Aggregator kann als regulärer Ausdruck angegeben werden (bsp. .*_rain.*)<br /> <br /> === interval === <br /> <br /> Updates des &lt;readings&gt; werden ignoriert, Events werden für mindestens &lt;interval&gt; Sekunden unterdrückt.<br /> <br /> Nach der interval-periode wird das reading mit einem Wert upgedated, der sich aus den Werten und Zeitstempeln der vorher ignorierten Updates zusammensetzt.<br /> <br /> === method === <br /> <br /> betrifft die Gewichtung nach Zeitintervallen<br /> * &lt;code&gt;none&lt;/code&gt;: keine zeitliche Gewichtung<br /> * &lt;code&gt;const&lt;/code&gt;: Annahme, dass zwischen den zwei Messpunkten keine Veränderung stattgefunden hat<br /> * &lt;code&gt;linear&lt;/code&gt;: Annahme, dass der Wert sich zwischen zwei Messpunkten linear verändert hat.<br /> <br /> === function === <br /> <br /> * &lt;code&gt;count&lt;/code&gt; Anzahl<br /> * &lt;code&gt;min&lt;/code&gt; Minimum<br /> * &lt;code&gt;max&lt;/code&gt; Maximum<br /> * &lt;code&gt;mean&lt;/code&gt; artihmetischer Mittelwert<br /> * &lt;code&gt;sd&lt;/code&gt; Standardabweichung<br /> * &lt;code&gt;integral&lt;/code&gt; Summe (falls holdTime nicht angegeben) oder Integral für den Zeitraum holdTime<br /> * &lt;code&gt;median&lt;/code&gt; [https://de.wikipedia.org/wiki/Median Median] (nur für method &lt;code&gt;none&lt;/code&gt; und gesetzte holdTime) - im Gegensatz zum Mittelwert nicht anfällig für Ausreisser, hilfreich bei Sensoren mit sporadisch unsinnigen Messwerten<br /> <br /> === holdTime === <br /> <br /> Zeitfenster in Sekunden, für die die vergangenen Werte gehalten werden, um die Aggregatfunktion zu berechnen.<br /> <br /> <br /> == Duplizieren von Readings==<br /> Wenn mehrere Funktionen für ein Reading berechnet werden sollen, muss dieses Reading zuvor dupliziert werden.<br /> In der Commandref wird ein notify vorgeschlagen, evtl. können aber auch DOIF_Readings, event_Readings und userReadings verwendet werden:<br /> <br /> &lt;code&gt;<br /> original_reading:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === DOIF_Readings ===<br /> TODO!<br /> &lt;code&gt;<br /> original_reading:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === event_Readings ===<br /> &lt;code&gt;<br /> attr DOIF-Device event_Readings <br /> original_reading:[&lt;Device&gt;:&lt;Reading&gt;], &lt;br /&gt;<br /> copy_1:[$SELF:original_reading], &lt;br /&gt;<br /> &lt;s&gt;copy_2:int(10*[$SELF:copy_1])/10&lt;/s&gt; Funktioniert so nicht!!! &lt;br /&gt;<br /> attr DOIF-Device event-aggregator copy_1:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === userReadings ===<br /> &lt;code&gt;<br /> attr DOIF-Device userReadings <br /> original_reading {ReadingsVal(&quot;&lt;Device&gt;&quot;,&quot;&lt;Reading&gt;&quot;,0)}, &lt;br /&gt;<br /> copy_1 {ReadingsVal($name,&quot;original_reading&quot;,0)}, &lt;br /&gt;<br /> copy_2 {int(10*ReadingsVal($name,&quot;copy_1&quot;,0))/10}&lt;br /&gt;<br /> attr DOIF-Device event-aggregator copy_1:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> <br /> == Wechselwirkungen == <br /> - keine bekannt - <br /> <br /> == Beispiele ==<br /> ; aus der {{Link2CmdRef|Anker=Event-aggregator}}<br /> &lt;code&gt;<br /> attr myPowerMeter event-aggregator EP_POWER_METER:300:linear:mean,EP_ENERGY_METER:300:none:v<br /> <br /> attr myBadSensor event-aggregator TEMP::none:median:300<br /> <br /> attr mySunMeter event-aggregator SUN_INTENSITY_24H::const:integral:86400<br /> &lt;/code&gt;<br /> <br /> == Siehe auch ==<br /> *[[event-on-update-reading]]<br /> *[[event-min-interval]]<br /> *[[event-aggregator]]<br /> <br /> == Links ==<br /> * Benutzungstipps (''Best Practice'') für das Attribut in {{Link2Forum|Topic=36522|LinkText=diesem Forenthread}}<br /> <br /> [[Kategorie:Attribut (allgemeingültig)]]</div> Stephan http://wiki.fhem.de/w/index.php?title=Event-aggregator&diff=32840 Event-aggregator 2020-02-24T12:13:21Z <p>Stephan: </p> <hr /> <div>{{SEITENTITEL:event-aggregator}} &lt;!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat --&gt;<br /> &lt;!-- Infobox Attribut sinnvoll? --&gt;<br /> {{Baustelle}}<br /> Mit dem Attribut [[event-aggregator]] können (nach Wunsch zeitlich gewichtete) Durchschnittswerte, Minima, Maxima oder Median etc. berechnet werden. Der Median kann hilfreich sein, um Messwerte mit Ausreissern (unsinnige Werte, z.B. durch Übertragungsfehler) zu glätten.<br /> <br /> == Syntax ==<br /> Das ''event-aggregator'' Attribut wird in der folgenden Weise spezifiziert:<br /> :&lt;code&gt;&lt;nowiki&gt;attr &lt;device&gt; event-aggregator reading:interval:method:function:holdTime&lt;/nowiki&gt;&lt;/code&gt;<br /> <br /> Mehrere Readings werden als kommagetrennte Liste angegeben.<br /> <br /> Die einzelnen Teile haben folgende Bedeutung:<br /> === reading ===<br /> Das zu aggregierende Reading des aktuellen Gerätes. Das Reading selbst muss seine Werte aus einer Aktion oder einem Event in FHEM erhalten (beispielsweise, indem Temperaturwerte ausgegeben oder andere Größen in das Reading geschrieben werden). Indem dann der event-aggregator auf dieses Reading angewandt wird, werden die erhaltenen Größen bearbeitet - je nach Installation wird dann also das Minimum, das Maximum oder der Median der Werte beim Reading ausgegeben.<br /> <br /> Wichtig: Es kann immer nur einen event-aggregator pro Reading geben. Will man daher mehrere Werte (z.B. min, max, avg), muss man weitere Readings erzeugen (z.B. mit userReadings oder notify). Der Aggregator kann als regulärer Ausdruck angegeben werden (bsp. .*_rain.*)<br /> <br /> === interval === <br /> <br /> Updates des &lt;readings&gt; werden ignoriert, Events werden für mindestens &lt;interval&gt; Sekunden unterdrückt.<br /> <br /> Nach der interval-periode wird das reading mit einem Wert upgedated, der sich aus den Werten und Zeitstempeln der vorher ignorierten Updates zusammensetzt.<br /> <br /> === method === <br /> <br /> betrifft die Gewichtung nach Zeitintervallen<br /> * &lt;code&gt;none&lt;/code&gt;: keine zeitliche Gewichtung<br /> * &lt;code&gt;const&lt;/code&gt;: Annahme, dass zwischen den zwei Messpunkten keine Veränderung stattgefunden hat<br /> * &lt;code&gt;linear&lt;/code&gt;: Annahme, dass der Wert sich zwischen zwei Messpunkten linear verändert hat.<br /> <br /> === function === <br /> <br /> * &lt;code&gt;count&lt;/code&gt; Anzahl<br /> * &lt;code&gt;min&lt;/code&gt; Minimum<br /> * &lt;code&gt;max&lt;/code&gt; Maximum<br /> * &lt;code&gt;mean&lt;/code&gt; artihmetischer Mittelwert<br /> * &lt;code&gt;sd&lt;/code&gt; Standardabweichung<br /> * &lt;code&gt;integral&lt;/code&gt; Summe (falls holdTime nicht angegeben) oder Integral für den Zeitraum holdTime<br /> * &lt;code&gt;median&lt;/code&gt; [https://de.wikipedia.org/wiki/Median Median] (nur für method &lt;code&gt;none&lt;/code&gt; und gesetzte holdTime) - im Gegensatz zum Mittelwert nicht anfällig für Ausreisser, hilfreich bei Sensoren mit sporadisch unsinnigen Messwerten<br /> <br /> === holdTime === <br /> <br /> Zeitfenster in Sekunden, für die die vergangenen Werte gehalten werden, um die Aggregatfunktion zu berechnen.<br /> <br /> <br /> == Duplizieren von Readings==<br /> Wenn mehrere Funktionen für ein Reading berechnet werden sollen, muss dieses Reading zuvor dupliziert werden.<br /> In der Commandref wird ein notify vorgeschlagen, evtl. können aber auch DOIF_Readings, event_Readings und userReadings verwendet werden:<br /> &lt;code&gt;<br /> original_reading:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === DOIF_Readings ===<br /> TODO!<br /> &lt;code&gt;<br /> original_reading:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === event_Readings ===<br /> &lt;code&gt;<br /> attr DOIF-Device event_Readings <br /> original_reading:[&lt;Device&gt;:&lt;Reading&gt;], &lt;br /&gt;<br /> copy_1:[$SELF:original_reading], &lt;br /&gt;<br /> &lt;s&gt;copy_2:int(10*[$SELF:copy_1])/10&lt;/s&gt; Funktioniert so nicht!!! &lt;br /&gt;<br /> attr DOIF-Device event-aggregator copy_1:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> === userReadings ===<br /> &lt;code&gt;<br /> attr DOIF-Device userReadings <br /> original_reading {ReadingsVal(&quot;&lt;Device&gt;&quot;,&quot;&lt;Reading&gt;&quot;,0)}, &lt;br /&gt;<br /> copy_1 {ReadingsVal($name,&quot;original_reading&quot;,0)}, &lt;br /&gt;<br /> copy_2 {int(10*ReadingsVal($name,&quot;copy_1&quot;,0))/10}&lt;br /&gt;<br /> attr DOIF-Device event-aggregator copy_1:interval:method:function:holdTime<br /> &lt;/code&gt;<br /> == Wechselwirkungen == <br /> - keine bekannt - <br /> <br /> == Beispiele ==<br /> ; aus der {{Link2CmdRef|Anker=Event-aggregator}}<br /> &lt;code&gt;<br /> attr myPowerMeter event-aggregator EP_POWER_METER:300:linear:mean,EP_ENERGY_METER:300:none:v<br /> <br /> attr myBadSensor event-aggregator TEMP::none:median:300<br /> <br /> attr mySunMeter event-aggregator SUN_INTENSITY_24H::const:integral:86400<br /> &lt;/code&gt;<br /> <br /> == Siehe auch ==<br /> *[[event-on-update-reading]]<br /> *[[event-min-interval]]<br /> *[[event-aggregator]]<br /> <br /> == Links ==<br /> * Benutzungstipps (''Best Practice'') für das Attribut in {{Link2Forum|Topic=36522|LinkText=diesem Forenthread}}<br /> <br /> [[Kategorie:Attribut (allgemeingültig)]]</div> Stephan http://wiki.fhem.de/w/index.php?title=FHEM_User_Interface_Painter&diff=31643 FHEM User Interface Painter 2019-11-08T11:32:41Z <p>Stephan: /* Links */</p> <hr /> <div>[[Datei:FUIP_Symbolbild.png|mini|400px|FUIP in Aktion]]<br /> Der '''FHEM User Interface Painter (FUIP)''' ist ein FHEM-Modul, mit dem man [[FHEM Tablet UI]] (FTUI) Seiten graphisch (&quot;klickibunti&quot;) erstellen kann. D.h. man kann sich ein UI zusammenklicken, welches die Tablet UI Technik verwendet, aber ohne sich selbst unbedingt mit HTML und CSS herumschlagen zu müssen.<br /> Hier ist ein kurzes Video, welches FUIP in Aktion zeigt:<br /> <br /> [https://forum.fhem.de/index.php?action=dlattach;topic=85869.0;attach=98455 Einführungsvideo]<br /> <br /> (Das Video zeigt nicht unbedingt den neusten Stand, aber es dürfte klar werden, wofür FUIP gut sein soll.)<br /> <br /> == Installation und Upgrade in FHEM ==<br /> Genau wie FTUI ist auch FUIP nicht automatisch Teil von FHEM. Es muss explizit installiert bzw. hinzugefügt werden. Die Installation funktioniert folgendermaßen:<br /> * FUIP verwendet FTUI. D.h. man sollte zuerst einmal FTUI installieren, falls noch nicht passiert. Wie das geht steht bei [[FHEM Tablet UI#Installation|FHEM Tablet UI]]. Dabei reicht der erste Schritt aus, da lediglich die FTUI-Dateien von FUIP benötigt werden.<br /> * Dann das FUIP-Repository zum FHEM Update hinzufügen: <br /> ** &lt;code&gt;update add https://raw.githubusercontent.com/ThorstenPferdekaemper/FHEM-FUIP/master/controls_fuip.txt&lt;/code&gt;<br /> * Jetzt &lt;code&gt;update all fuip&lt;/code&gt; machen.<br /> * Warten, bis man ganz sicher ist, dass alles installiert ist. Das sieht man normalerweise an der Meldung &lt;code&gt;update finished, &quot;shutdown restart&quot; is needed to activate the changes.&lt;/code&gt;. Das ganze kann etwas länger dauern, da FUIP aus einige Dateien besteht, von denen ein paar etwas größer sind. <br /> * Jetzt erst &lt;code&gt;shutdown restart&lt;/code&gt;. <br /> * FUIP sollte jetzt installiert sein.<br /> <br /> Zum Upgrade reicht ein &lt;code&gt;update&lt;/code&gt;, wenn man FUIP wie oben beschrieben installiert hat. Will man nur den FUIP-Teil aktualisieren und nicht alles in FHEM, dann geht das mit &lt;code&gt;update all fuip&lt;/code&gt;.<br /> <br /> Falls es bei oder nach der Installation oder dem Upgrade Probleme gibt (welcher Art auch immer), sollten die folgenden Punkte geprüft werden:<br /> * Wird das richtige Repository benutzt? Man kann das mit &lt;code&gt;update list&lt;/code&gt; überprüfen. Wenn der Eintrag für fuip nicht genau so aussieht wie oben beschrieben, dann sollte er per &lt;code&gt;update delete&lt;/code&gt; gelöscht werden und dann genau so eingetragen werden wie oben beschrieben. <br /> * Ist der update-Prozess wirklich komplett durchgelaufen? Auch wenn es etwas länger dauert, muss man auf die Meldung &lt;code&gt;update finished, &quot;shutdown restart&quot; is needed to activate the changes.&lt;/code&gt; warten, bevor man durchstartet. Im Zweifelsfall einfach noch einmal &lt;code&gt;update all fuip&lt;/code&gt; machen und diesmal mehr Geduld haben.<br /> * FHEM braucht Schreibrechte im Verzeichnis &lt;fhem&gt;/FHEM/lib/FUIP/config (&lt;fhem&gt; steht meistens für /opt/fhem) und allen enthaltenen Dateien. Auf Betriebssystemebene (Linux) kann man das mit &lt;code&gt;ls -ls&lt;/code&gt; überprüfen. Meistens kann es mit folgendem Befehl repariert werden: &lt;code&gt;chown -R fhem:dialout /opt/fhem/FHEM/lib/FUIP/config&lt;/code&gt;. (Dieser Punkt gilt nicht bzw. nicht genau so, wenn man die configDB benutzt.)<br /> * Steht etwas verdächtiges im Logfile?<br /> <br /> == Erste Schritte ==<br /> Zuerst legt man ein &quot;FUIP Device&quot; an, also etwa &lt;code&gt;define ui FUIP&lt;/code&gt;. Dieses Device meldet sich sozusagen als Webserver bei FHEM an (wie z.B. auch [[HTTPSRV]]), d.h. es erscheint im Menu oben links (über den Räumen) ein Link &quot;ui&quot;. Beim Klick auf diesen Link generiert FUIP eine FTUI Übersichtsseite aus den Räumen im FHEM System. (Das kann ein bisschen dauern, wenn man viele Devices hat.) Nun kann man durch Verschieben und größer/kleiner-Ziehen der einzelnen Zellen bzw. durch Verschieben des Zelleninhalts die Gestaltung ändern. Außerdem kann man über das Zahnrad rechts oben in den Zellen neuen Inhalt hinzufügen, den bestehenden Inhalt ändern und vieles mehr.<br /> Durch Klicken auf die Räume im Menu der Übersichtsseite werden einzelne Raum-Seiten generiert. Diese kann man ebenfalls entsprechend bearbeiten. Natürlich können auch eigene Seiten hinzugefügt werden. Wie das geht sieht man im Video, welches oben verlinkt ist.<br /> <br /> Nachdem man die Seiten entsprechend bearbeitet hat sollte man ein &lt;code&gt;set ui save&lt;/code&gt; machen. Ansonsten gehen die Änderungen beim nächsten FHEM-Neustart verloren. Ein normales &lt;code&gt;save config&lt;/code&gt; reicht nicht aus und ist auch nicht notwendig.<br /> <br /> Die folgenden detaillierten Informationen können zum Teil veraltet sein, da FUIP noch weitereintwickelt wird. Es sollten allerdings keine Funktionen verschwinden.<br /> <br /> == Das Konfigurations-Popup ==<br /> === ...für Zellen ===<br /> [[Datei:FUIP_KonfigZelle.png|mini|600px]]<br /> Beim Klick auf das Zahnrad rechts oben in einer Zelle wird der Konfigurations-Dialog für diese Zelle geöffnet. Im Folgenden werden die Funktionen der einzelnen Elemente erklärt.<br /> ;Zur Seiten-Konfiguration: Damit kann man zum Konfig-Dialog für die ganze Seite wechseln. <br /> ;Zellen-Überschrift: Hier wird die Überschrift der Zelle festgelegt. Eine Zelle muss keine Überschrift haben. (Die Zahlen hinter der Überschrift in der Zelle selbst verschwinden, wenn man das Attribut ''locked'' setzt.)<br /> ;Neuer View: Hiermit fügt man einen neuen View, also neuen Inhalt, zu einer Zelle hinzu. Man wählt dann aus, welcher Art View angelegt werden soll und füllt die Details, wie z.B. das zugehörige Device. Der neue View wird an einer freien Stelle (falls möglich) in der Zelle eingefügt. Nach schließen des Konfig-Dialogs kann man den View dann per Drag&amp;Drop geeignet positionieren.<br /> ;Neuer View (Device): Dies dient ebenfalls dazu, neue Views in die Zelle zu packen. Allerdings wählt man nicht die Art des Views aus, sondern die FHEM-Devices, die dargestellt werden sollen. Das System sucht dann jeweils einen geeigneten View aus. Bisher funktioniert das nur sehr eingeschränkt, hat aber den Vorteil, dass man gleich mehrere Devices auswählen kann.<br /> ;Abbrechen: Damit schließt man den Dialog ohne die Änderungen zu übernehmen.<br /> ;Details zum View: Hier klappt man die Details zum View aus und kann diese ändern. Was man damit genau machen kann kommt auf die Art des View an. Per Drag&amp;Drop kann man auch die Reihenfolge der Views im Konfig-Dialog ändern. Das hat allerdings keinen Effekt auf die Positonierung bereits existierender Views in der Zelle. <br /> ;View löschen: Das löscht den View aus der Zelle. Wenn man den View eigentlich nicht löschen, sondern in einer anderen Zelle haben will, dann kann man ihn auch per Drag&amp;Drop in die andere Zelle verschieben. Lässt man einen View in einer anderen Zelle &quot;fallen&quot;, dann wird dieser automatisch der neuen Zelle zugeordnet.<br /> ;Übernehmen: Das schließt den Dialog und übernimmt die Änderungen. Dadurch kann man die Auswirkungen auf dem UI selbst sehen. Um die Änderungen allerdings den nächsten FHEM Neustart überleben zu lassen muss man noch ein &lt;code&gt;set ui save&lt;/code&gt; machen.<br /> ;Auto-Anordnen: Hiermit kann man die einzelnen Views in der Zelle automatisch anordnen. Es kann momentan sein, dass dadurch Änderungen verloren gehen. D.h. dieser Button sollte nur benutzt werden, wenn man seit dem Öffnen des Dialogs keine Änderungen gemacht hat. Außerdem schließt der Button dan Dialog. FUIP ordnet die Views in der Reihenfolge an, in der sie im Konfig-Popup erscheinen. Das zugrunde liegende Layout ist sehr einfach gehalten und kann sich auch noch ändern. Diese Funktion ist vor Allem brauchbar für mehrere gleichartige Views in derselben Zelle, wie z.B. bei Menus. <br /> ;Neue Zelle: Legt eine neue (leere) Zelle auf der aktuellen Seite an. Der Konfig-Dialog wird dabei geschlossen und Änderungen gehen verloren.<br /> ;Zelle kopieren: Kopiert die aktuelle Zelle. Man muss eine Seite angeben, zu der die kopierte Zelle gehören soll. Das entsprechende Feld ist mit der aktuellen Seite vorbelegt. Falls man dies nicht ändert, wird einfach eine Kopie der Zelle auf derselben Seite erzeugt. Ansonsten wird die Zelle auf die angegebene Seite kopiert. Die Funktion schließt den Konfig-Dialog und Änderungen gehen verloren. Falls man eine andere Seite angegeben hat, wird zu dieser gewechselt.<br /> ;Zelle exportieren: Dies erlaubt die Definition der Zelle herunterzuladen und auf dem Client (also dem Rechner, auf dem der Browser läuft) zu speichern.<br /> ;Zelle importieren: Damit lädt man eine exportierte Zelle wieder hoch. FUIP erzeugt dann auf der aktuellen Seite eine neue Zelle mit dem entsprechenden Inhalt. Das funktioniert auch mit Zellen, die von einer anderen FUIP-Seite, einem anderen FUIP-Device oder von einer anderen FHEM-Installation kommen.<br /> ;Zelle löschen: Damit löscht man die aktuelle Zelle. Sie verschwindet dann von der aktuellen Seite.<br /> ;Toggle editOnly: Bei manchen Views ist es schwierig, sie mit der Maus &quot;anzufassen&quot;, da sie sofort eine Aktion auslösen (z.B. bei Links). Mit &quot;Toggle editOnly&quot; wird eine graue &quot;Schicht&quot; über die Views gelegt. Dadurch weiß man besser, wo man den View anfassen kann und Mausklicks haben keine Wirkung mehr, außer Drag&amp;Drop.<br /> <br /> === ...für Seiten ===<br /> [[Datei:FUIP_SeitenKonfig.png|mini|600px]]<br /> Drückt man im Konfig-Dialog für Zellen auf &quot;Cell/Page&quot; kommt man auf den Konfig-Dialog für ganze Seiten. Die Bedeutung der Einzelnen Elemente ist wie folgt.<br /> ;Zur Zellen-Konfiguration:Das bringt einen zurück zum Konfig-Dialog für Zellen.<br /> ;Seiten-Überschrift:Hier kann ein Titel für die Seite eingetragen werden. Das erscheint dann je nach Browser irgendwo oben. (Technisch ist es der Inhalt des &lt;title&gt; Tags in &lt;head&gt;.)<br /> ;Abbrechen:Damit schließt man den Dialog ohne die Änderungen zu übernehmen.<br /> ;Übernehmen: Das schließt den Dialog und übernimmt die Änderungen. Dadurch kann man die Auswirkungen auf dem UI selbst sehen. Um die Änderungen allerdings den nächsten FHEM Neustart überleben zu lassen muss man noch ein &lt;code&gt;set ui save&lt;/code&gt; machen.<br /> ;Seite kopieren:Dadurch wird eine neue Seite angelegt, die so aussieht wie die aktuelle. Der Dialog wird dann geschlossen und automatisch zur neuen Seite gesprungen.<br /> ;Seite exportieren:Das ist dasselbe wie für Zellen, nur für die ganze aktuelle Seite.<br /> ;Seite importieren:Das ist im Prinzip auch wie für Zellen, nur dass eine neue Seite angelegt wird. Exportierte Zellen können nur als Zellen importiert werden und exportierte Seiten nur als Seiten.<br /> <br /> == Das FUIP-Device ==<br /> Wie in [[#Erste Schritte|Erste Schritte]] bereits beschrieben, muss man zur Verwendung von FUIP zuerst ein FUIP-Device anlegen. Alles, was man mit FUIP macht (bzw. was das System macht) passiert in Bezug auf ein FUIP-Device. Man kann auch jederzeit mehrere FUIP-Devices anlegen. Verschiedene Instanzen von FUIP stören sich nicht gegenseitig, man kann aber (z.B. in einem Menu) auf eine andere FUIP-Instanz verweisen (verlinken).<br /> <br /> Das FUIP-Device hat die folgenden Eigenschaften.<br /> === Sets ===<br /> Die folgenden set-Kommandos sind für den Benutzer gedacht. Es gibt noch weitere set-Kommandos, welche aber vor Allem für FUIP-interne Zwecke gedacht sind. <br /> ;save: Mit &lt;code&gt;set &lt;name&gt; save&lt;/code&gt; wird der momentane Zustand der FUIP-Seiten zu diesem FUIP-Device gespeichert. Das betrifft nicht die Definition des FUIP-Device selbst (also auch nicht dessen Attribute). Diese müssen nach wie vor über &lt;code&gt;save&lt;/code&gt; (also &quot;Save config&quot;) gespeichert werden. Die FUIP-Seiten stehen in der Datei &lt;fhem&gt;/FHEM/lib/FUIP/config/FUIP_&lt;name&gt;.cfg. Dabei steht &lt;fhem&gt; in der Regel für /opt/fhem und &lt;name&gt; für den Namen des FUIP-Devices. Ohne ein &lt;code&gt;set &lt;name&gt; save&lt;/code&gt; gehen alle Änderungen beim nächsten FHEM Restart verloren. <br /> ;load: Mit &lt;code&gt;set &lt;name&gt; load&lt;/code&gt; stellt man den Zustand wieder her, der mit &lt;code&gt;set &lt;name&gt; save&lt;/code&gt; gespeichert wurde. Das ist vor Allem dann nützlich, wenn man sich beim Bearbeiten der Seiten vertan hat. Ansonsten wird beim FHEM Start das &quot;load&quot; automatisch ausgeführt. <br /> ;pagedelete: Mit &lt;code&gt;set &lt;name&gt; pagedelete &lt;page&gt;&lt;/code&gt; wird die Seite &lt;page&gt; gelöscht. Das kann auch dazu genutzt werden, FUIP zum Neugenerieren einer Seite zu &quot;zwingen&quot;, indem man die Seite nach dem Löschen einfach wieder aufruft. Auch das Löschen einer Seite geht ohne ein &quot;save&quot; verloren, d.h. die Seite ist dann nach einem FHEM Neustart wieder da. <br /> ;refreshBuffer: FUIP verwendet Informationen aus dem &quot;eigentlichen&quot; FHEM, wie z.B. die Liste aller Devices sowie bestimmte Readings, Internals und Attribute. Insbesondere bei &quot;entferntem&quot; FUIP, also bei Verwendung des Attributs ''fhemwebUrl'', kann die Ermittlung dieser Daten länger dauern. Daher wird praktisch alles durch FUIP zwischengespeichert (&quot;gepuffert&quot;). Wenn man nun neue Devices anlegt bzw. bestehende Devices ändert, dann bekommt das FUIP-Device davon unter Umständen nichts mit. In so einem Fall kann man mit &lt;code&gt;set &lt;name&gt; refreshBuffer&lt;/code&gt; den Zwischenspeicher löschen, um FUIP dazu zu zwingen, die Informationen erneut zu ermitteln.<br /> <br /> === Gets ===<br /> Alle Get-Kommandos sind nur für FUIP-interne Zwecke bestimmt.<br /> <br /> === Internals ===<br /> ;editOnly: Hier wird der &quot;editOnly-Modus&quot; gespeichert, der auf der Konfig-Oberfläche ein- und ausgeschaltet werden kann. Siehe auch [[#Das Konfigurations-Popup|Das Konfigurations-Popup]].<br /> <br /> === Readings ===<br /> FUIP-Devices haben keine Readings.<br /> <br /> === Attribute ===<br /> ;baseHeight: Basishöhe einer Zelle, d.h. eine 1x1-Zelle ist ''baseHeight'' Pixel hoch. Standardwert ist 108.<br /> ;baseWidth: Basisbreite einer Zelle, d.h. eine 1x1-Zelle ist ''baseWidth'' Pixel breit. Standardwert ist 142. Diese Abmessungen beziehen sich nur auf die Zelle selbst, nicht auf den Zwischenraum zwischen zwei Zellen. Der Zwischenraum beträgt (horizontal und vertikal) 10 Pixel.<br /> ;pageWidth: Seitenbreite in Pixel. Wenn ''pageWidth'' nicht gesetzt ist (das ist der Default), dann wird die Seitenbreite nicht festgelegt. Sie ergibt sich dann aus ''baseWidth'' (d.h. die Breite einer 1er-Zelle) und der Anzahl der verwendeten Spalten plus die Breite der Zwischenräume. D.h. in der Regel muss man ''pageWidth'' nicht angeben.<br /> :Die Angabe in ''pageWidth'' beeinflusst auch die Darstellung des Hintergrundbilds, falls das Attribut ''styleBackgroundImage'' gesetzt ist. Siehe ''styleBackgroundImage'' für Details.<br /> ;fhemwebUrl: Mit FUIP kann man sich auch an ein &quot;entferntes&quot; FHEM ankoppeln. Das Attribut ''fhemwebUrl'' hat dabei in etwa die Bedeutung wie ''fhemweb_url'' bei FTUI. (Siehe auch hier: [[FHEM Tablet UI#Verbindung zu FHEM|Verbindung zu FHEM (FTUI)]].) Genau wie beim &quot;normalen&quot; FTUI muss das Attribut ''CORS'' der FHEMWEB-Instanz des Ziels auf &quot;1&quot; stehen. Ansonsten würde schon FTUI nicht funktionieren. Außerdem darf die FHEMWEB-Instanz keine Passwort-Prüfung haben. Stattdessen kann man mit dem Attribut ''allowedfrom'' oder einer allowed-Instanz den Zugriff einschränken. <br /> :Man darf ''fhemwebUrl'' auf keinen Fall setzen (auch nicht auf 127.0.0.1 oder so), wenn sich die FUIP-Instanz auf das lokale FHEM beziehen soll. In dem Fall würde FHEM ewig auf sich selbst warten.<br /> :Wenn man ein &quot;entferntes&quot; FHEM benutzt, dann können einige Funktionen der Konfigurationsoberfläche etwas Zeit brauchen. Zum Beispiel müssen für die Eingabehilfe für Devices alle Devices aus dem entfernten FHEM gelesen werden. Das ist so implementiert, dass das entfernte FHEM möglichst wenig belastet wird, was aber zu Lasten des FUIP-FHEM geht. Siehe auch das Set-Kommando ''refreshBuffer'' zu diesem Thema.<br /> ;locked: Wenn ''locked'' auf &quot;1&quot; gesetzt wird, dann sind die FUIP-Seiten gegen Bearbeitung gesperrt. Das Zahnrad-Icon oben rechts erscheint dann nicht mehr. Dadurch kann ein reiner &quot;Tablet-UI Benutzer&quot; die Seiten nicht mehr ändern und die Oberfläche sieht komplett wie normalerweise bei FTUI aus. Zusätzlich verschwinden auch die Zellennummern rechts neben den Zellenüberschriften und Zellen ohne Überschrift haben dann auch keinen &quot;Titelbalken&quot; mehr.<br /> ;styleBackgroundImage: Dateiname des Hintergrundbilds. Die Bilddatei muss sich im Verzeichnis &lt;fhem&gt;/FHEM/lib/FUIP/images befinden. (&lt;fhem&gt; steht meistens für /opt/fhem) Unterstützt werden jpg- und png- Dateien. Nachdem eine neue Datei hochgeladen wurde, muss man im Browser (in FHEMWEB) die Seite einmal auffrischen (neu laden), um die neue Datei verwenden zu können. <br /> :Falls das Attribut ''pageWidth'' gesetzt ist, dann wird die Breite des Hintergrundbilds auf die angegebene Größe gesetzt. Ansonsten (ohne ''pageWidth'') nimmt das Bild die Breite des Browser-Fensters ein. Die Höhe des Bilds wird entsprechend skaliert, man muss sich also selbst darum kümmern, dass das Bild ein passendes Seitenverhältnis hat.<br /> :Bei Verwendung eines Hintergrundbilds werden die Zellenhintergründe automatisch auf halbtransparent gesetzt, so dass das Bild durchscheint. <br /> ;styleColor: Standard-Textfarbe (Vordergrundfarbe) für alle Views. Der Defaultwert ist #808080, also ein helles Grau. Man kann die Farbe nicht für alle FTUI-Widgets festlegen. D.h. ''styleColor'' funktioniert nicht unbedingt überall.<br /> <br /> == Links ==<br /> * {{Link2Forum|Topic=85869|LinkText=Foren-Thread zur Geburt von FUIP}}<br /> * [https://www.youtube.com/watch?v=9DPrMOvZ1wo Youtube-Webinar von Thorsten]<br /> <br /> [[Kategorie:FHEM Frontends]]</div> Stephan http://wiki.fhem.de/w/index.php?title=FTUI_Widget_Chart&diff=31159 FTUI Widget Chart 2019-08-29T13:51:52Z <p>Stephan: Benötigten Parameter bei DbLog hinzugefügt</p> <hr /> <div>Das [[{{PAGENAME}}|Chart Widget]] ist ein Widget für [[FHEM Tablet UI]], mit dem sich verschiedenste Diagramme darstellen lassen. Die Aneinanderreihung mehrerer Werte eines Device-Readings zu einem zeitlichen Verlauf wird dabei als Graph bezeichnet.<br /> <br /> Es können beliebige Werte dargestellt und entsprechend der Sinnhaftigkeit, oder persönlichem Geschmack, formatiert werden. Farbe und Form der Linien sind je Graph einstellbar, auch wenn mehrere gleichzeitig in einem Diagramm angezeigt werden.<br /> <br /> Jedes Diagramm kann zwei Y-Achsen besitzen. Die primäre Y-Achse (primary) wird auf der linken Seite angezeigt, die sekundäre Y-Achse (secondary) auf der rechten Seite. Beide Achsen können unterschiedlich formatiert werden.<br /> <br /> &lt;gallery&gt;<br /> File:Chart_tabletUI.png<br /> Datei:FTUI Widget Chart Stacked.png<br /> Datei:FTUI Widget Chart-fc-Proplanta.png<br /> Datei:Wetterchart2.png<br /> Datei:PieChart.png<br /> &lt;/gallery&gt;<br /> <br /> ==Attribute==<br /> {|class=&quot;wikitable&quot;<br /> ! style=&quot;width:150px&quot;|Attribut<br /> !Beschreibung<br /> !Standard-Wert<br /> !Beispiel<br /> |-<br /> |'''data-device'''||Name des FHEM-Device, das die Aktualisierung des Charts triggert||||data-device=&quot;WohnzimmerHeizung&quot;<br /> |-<br /> |'''data-get'''||Reading, das das Update des Diagramms triggert||'STATE'||<br /> |-<br /> |'''data-logdevice'''||Name des Log-Device, das dargestellt werden soll, oder ein Array, um mehrere Werte in einem Diagramm darzustellen||||data-logdevice=&quot;FileLog_WohnzimmerHeizung&quot;<br /> |-<br /> |'''data-logfile'''|| Name des Log-Files, aus dem die Daten entnommen werden sollen (oder Array)||'-' = aktuelle Datei||data-logfile=&quot;WohnzimmerHeizung-2015.log&quot;&lt;br&gt;Beachte: Der Wert &quot;CURRENT&quot; ermöglicht die Navigation auch zu älterne Logfiles (Jahreswechsel)<br /> |-<br /> |'''data-columnspec'''||Ermittelt den Wert aus dem Log-File, der angezeigt werden soll (oder Array)||||data-columnspec=&quot;4:meas.*&quot;<br /> |-<br /> |'''data-style'''||Stil, wie die Graph-Linien dargestellt werden sollen (z.B. 'SVGplot l0' oder 'ftui l0dash'), oder ein Array, wenn mehrere Linien unterschiedlich dargestellt werden sollen (siehe [[#Aussehen_der_Linien|Hinweise]])||||<br /> |-<br /> |'''data-ptype'''||Form, wie die Graphen dargestellt werden sollen (z.B. 'lines', 'cubic' oder 'fa-cog'), oder ein Array (siehe [[#Form_der_Linien|Hinweise]])||'lines'||<br /> |-<br /> |'''data-uaxis'''||Name der Achse, die verwendet werden soll ('primary' = links, oder 'secondary' = rechts), oder ein Array||'primary'||<br /> |-<br /> |'''data-legend'''||Bezeichnung des Graphen (wird in Legende und am Cursor angezeigt), oder ein Array||||<br /> |-<br /> |'''data-minvalue'''||Minimaler Wert, der auf der linken Y-Achse ('primary') angezeigt werden soll. 'auto' = automatische Berechnung||'10'||<br /> |-<br /> |'''data-maxvalue'''||Maximaler Wert, der auf der linken Y-Achse ('primary') angezeigt werden soll. 'auto' = automatische Berechnung||'30'||<br /> |-<br /> |'''data-minvalue_sec'''||Minimaler Wert, der auf der rechten Y-Achse ('secondary') angezeigt werden soll. 'auto' = automatische Berechnung||'auto'||<br /> |-<br /> |'''data-maxvalue_sec'''||Maximaler Wert, der auf der rechten Y-Achse ('secondary') angezeigt werden soll. 'auto' = automatische Berechnung||'auto'||<br /> |-<br /> |'''data-xticks'''||Abstand zwischen den vertikalen Hilfslinien (bezogen auf die X-Achse) in Minuten. 'auto' = automatische Berechnung||'auto'||<br /> |-<br /> |'''data-yticks'''||Abstand zwischen den horizontalen Hilfslinien (bezogen auf die linke Y-Achse). Kann auch ein Array mit Werte-Paaren enthalten, um die Linien mit Text zu beschriften.||'auto'||data-yticks='[[0,&quot;open&quot;],[1,&quot;closed&quot;]]'<br /> |-<br /> |'''data-yticks_format'''||Dient zur Formatierung der Ticks der Y-Achse. Die Formatierung geschieht über Platzhalter, Trenner und einen beliebigen durch ' ' getrennten Text. Als Platzhalter dient ein oder mehrere '#', als Trenner können '.', ',' und ':' verwendet werden. Ist ein Trenner enthalten (z.B. '#.##') dann bedeutet das in dem Beispiel, dass der Ytick mit 2 Nachkommastellen versehen wird und vorne Platz für eine Stelle vor dem Komma vorgehalten wird (führende Nullen werden nicht dargestellt, aber de Platz wird reserviert so dass das ganze rechtsbündig immer passt). Ist kein Trenner vorhanden, dann wird der Ytick auf die Summe der Platzhalter mit einer festen Gesamtbreite gesetzt (#### würde also bedeuten, dass immer 4 Stellen (ohne Trenner) verwendet werden. aus 0.4 würde 0.400 aus 10.437 würde 10.44). Als Trenner kann man z.B. für Zeiten auch einen ':' verwenden und dadurch auch so etwas wie &quot;12:00 Uhr&quot; realisieren (in dem Beispiel wäre data-yticks_format=&quot;##:## Uhr&quot; und kein data-yunit oder data-yticks=&quot;##:##&quot; und data-yunit=&quot;Uhr&quot;).||||data-yticks_format=&quot;#.##&quot;<br /> |-<br /> |'''data-yticks_sec'''||Abstand zwischen den horizontalen Hilfslinien (bezogen auf die rechte Y-Achse). Kann auch ein Array mit Werte-Paaren enthalten, um die Linien mit Text zu beschriften.||'auto'||data-yticks='[[0,&quot;open&quot;],[1,&quot;closed&quot;]]'<br /> |-<br /> |'''data-yticks_format_sec'''||Dient zur Formatierung der Ticks der Y-Achse. Die Formatierung geschieht über Platzhalter, Trenner und einen beliebigen durch ' ' getrennten Text. Als Platzhalter dient ein oder mehrere '#', als Trenner können '.', ',' und ':' verwendet werden. Ist ein Trenner enthalten (z.B. '#.##') dann bedeutet das in dem Beispiel, dass der Ytick mit 2 Nachkommastellen versehen wird und vorne Platz für eine Stelle vor dem Komma vorgehalten wird (führende Nullen werden nicht dargestellt, aber de Platz wird reserviert so dass das ganze rechtsbündig immer passt). Ist kein Trenner vorhanden, dann wird der Ytick auf die Summe der Platzhalter mit einer festen Gesamtbreite gesetzt (#### würde also bedeuten, dass immer 4 Stellen (ohne Trenner) verwendet werden. aus 0.4 würde 0.400 aus 10.437 würde 10.44). Als Trenner kann man z.B. für Zeiten auch einen ':' verwenden und dadurch auch so etwas wie &quot;12:00 Uhr&quot; realisieren (in dem Beispiel wäre data-yticks_format=&quot;##:## Uhr&quot; und kein data-yunit oder data-yticks=&quot;##:##&quot; und data-yunit=&quot;Uhr&quot;).||||data-yticks_format_sec=&quot;#.##&quot;<br /> |-<br /> |'''data-yticks_prio'''||Legt fest, ob die horizontalen Hilfslinien der linken (primary) oder der rechten (secondary) Y-Achse zugeordnet werden sollen||||data-yticks_prio='secondary'<br /> |-<br /> |'''data-ytype'''||Legt fest, ob die primäre y Achse logarithmisch sein soll (wert &quot;log&quot;)||||data-ytype=&quot;log&quot;<br /> |-<br /> |'''data-ytype_sec'''||Legt fest, ob die sekundäre y Achse logarithmisch sein soll (wert &quot;log&quot;)||||data-ytype_sec=&quot;log&quot;<br /> |-<br /> |'''data-y_margin'''|||Gibt die Möglichkeit, Abstände zwischen den Graphen und dem oberen Rand des Plots zu definieren (Einheit Pixel). Falls der Wert skalar ist, werden oben und unten die gleichen Abstände eingehalten. Falls ein 2D Array angegeben wird, können die Werte unten (erster Wert im Array) und oben (zweiter Wert im Array) getrennt festgelegt werden||&quot;0&quot;|||data-y_margin='[&quot;10&quot;,&quot;20&quot;]'<br /> |-<br /> |'''data-y_margin_sec'''|||Gibt die Möglichkeit, Abstände zwischen den Graphen und dem oberen Rand des Plots zu definieren (Einheit Pixel). Falls der Wert skalar ist, werden oben und unten die gleichen Abstände eingehalten. Falls ein 2D Array angegeben wird, können die Werte unten (erster Wert im Array) und oben (zweiter Wert im Array) getrennt festgelegt werden||&quot;0&quot;|||data-y_margin='[&quot;10&quot;,&quot;20&quot;]'<br /> |-<br /> |'''data-daysago_start'''||Anzahl der vergangenen Tage, wo das Diagramm beginnen soll. '0' = Beginn heute 0:00 Uhr. (siehe [[#Zeitstrahl_.2F_Start_.26_Ende_auf_der_X-Achse|Hinweise]])||'0'||<br /> |-<br /> |'''data-daysago_end'''||Anzahl der vergangenen Tage, wo das Diagramm enden soll. '-1' = Ende heute 24:00 Uhr. (siehe [[#Zeitstrahl_.2F_Start_.26_Ende_auf_der_X-Achse|Hinweise]])||'-1'||<br /> |-<br /> |'''data-xticks_round'''||Wenn vorhanden und entweder 'h', 'd', 'w', wird auf Stunde, Tag oder Woche bei den xticks gerundet (also die Tickmarks und die Gridlines bei den entsprechend gerundeten Zeiten gesetzt). Es kann auch 'auto' angegeben werden, um eine autmoatische Rundung durchzuführen||||<br /> |-<br /> |'''data-nofulldays'''||Aktiviert/deaktiviert die Rundung der X-Achse auf ganze Tage. Binärwert ('true' oder 'false')||'false'||<br /> |-<br /> |'''data-timeformat'''||Zeitformat für die Anzeige an der X-Achse (siehe [[#Zeitformat_der_X-Achse|Hinweise]])||||<br /> |-<br /> |'''data-timeranges'''||Hierdurch können vordefinierte Zeiträume für die X-Achse festgelegt werden, die dann durch eine pulldown menu (neuer Button oben neben dem &quot;-&quot; Button) direkt ausgewählt werden können. Der Parameter ist ein Array aus Array Einträgen, welche jeweils [&lt;Name&gt;,&lt;daysago_start&gt;,&lt;daysago_end&gt;] enthalten)||<br /> ||data-timeranges='[&lt;br&gt;<br /> [&quot;Actual Year&quot;,&quot;0Y&quot;,&quot;-1Y&quot;],&lt;br&gt;<br /> [&quot;Last Year&quot;,&quot;1Y&quot;,&quot;0Y&quot;],&lt;br&gt;<br /> [&quot;Actual Month&quot;,&quot;0M&quot;,&quot;-1M&quot;],&lt;br&gt;<br /> [&quot;Last Month&quot;,&quot;1M&quot;,&quot;0M&quot;],&lt;br&gt;<br /> [&quot;Actual Week&quot;,&quot;0W&quot;,&quot;-1W&quot;],&lt;br&gt;<br /> [&quot;Last Week&quot;,&quot;1W&quot;,&quot;0W&quot;],&lt;br&gt;<br /> [&quot;Today&quot;,&quot;0D&quot;,&quot;-1D&quot;],&lt;br&gt;<br /> [&quot;Yesterday&quot;,&quot;1D&quot;,&quot;0D&quot;]&lt;br&gt;<br /> ]'<br /> |-<br /> |'''data-ytext'''||Text, der neben der linken Y-Achse angezeigt wird||||<br /> |-<br /> |'''data-ytext_sec'''||Text, der neben der rechten Y-Achse angezeigt wird||||<br /> |-<br /> |'''data-yunit'''||Einheit, die an der linken Y-Achse angezeigt wird||||<br /> |-<br /> |'''data-yunit_sec'''||Einheit, die an der rechten Y-Achse angezeigt wird||||<br /> |-<br /> |'''data-show_both_axes'''||Legt fest ob beide Y-Achsen Linien gezeichnet werden sollen||false||<br /> |-<br /> |'''data-crosshair'''||Aktiviert/deaktiviert den Fadenkreuz-Cursor. Binärwert ('true' oder 'false')||'false'||<br /> |-<br /> |'''data-cursorgroup'''||Zahl zur Gruppierung der Werte am Fadenkreuz-Cursor ([[#Fadenkreuz-Cursor|Hinweise]])||||<br /> |-<br /> |'''data-scrollgroup'''||Zahl zur Gruppierung der Graphen beim Bewegen und Zoomen. Alle Linien mit der selben Zahl werden miteinander gekoppelt und bewegen sich gemeinsam.||||<br /> |-<br /> |'''data-showlegend'''||Aktiviert/deaktiviert die Anzeige der Legene. Binärwert ('true' oder 'false')||'false'||<br /> |-<br /> |'''data-legendpos'''||Array von zwei Werten, die die horizontale und vertikale Position der Legende festlegen ([[#Legende|Hinweise]])||'[&quot;top&quot;,&quot;right&quot;]'||<br /> |-<br /> |'''data-legend_horiz'''||legt fest, dass die Legendeneinträge horizontal angeordnet sind (anstatt vertikal wie im default Fall)||false||data-legend_horiz=&quot;true&quot;<br /> |-<br /> |'''data-width'''||Breite des Diagramms (in % oder px)||||<br /> |-<br /> |'''data-height'''||Höhe des Diagramms (in % oder px)||||<br /> |-<br /> |'''data-graphsshown'''||Aktiviert/deaktiviert die initiale Anzeige von Graphen. Binärwert ('true' oder 'false'). Array, wenn mehrere Linien angezeigt werden sollen.||||data-graphsshown='[true,false,true]'<br /> |-<br /> |'''data-ddd'''||Einstellung für die 3D-Drehung ([[#3-dimensionale_Drehung|Hinweise]])||||data-ddd='[&quot;40&quot;,&quot;60&quot;,&quot;0&quot;]'<br /> |-<br /> |'''data-dddspace'''||Abstand zwischen zwei Graphen, wenn die 3D-Anzeige aktiviert wurde (px)||'15'||<br /> |-<br /> |'''data-dddwidth'''||Breite, bzw. Tiefe der Graphen, wenn diese 3-dimensional angezeigt werden (px)||'10'||<br /> |-<br /> |'''data-title'''||Titel, der über dem Diagramm angezeigt werden soll. Der Inhalt kann auch dynamisch erzeugt werden ([[#Diagrammtitel|Hinweise]])||||<br /> |-<br /> |'''data-title_class'''||Klassenname für die Formatierung des Titels. Die Eigenschaften müssen dann entsprechend in einem CSS File angegeben werden (z.B. in fhem-tablet-ui-user.css)||||<br /> |-<br /> |'''data-prefetch'''||Legt fest, ob zusätzliche Daten rechts und links des Plots im Hintergrund vom Server geholt werden sollen||false||data-prefetch=&quot;true&quot;<br /> |}<br /> Einige Parameter (style, maxvalue, minvalue, maxvalue_sec, minvalue_sec) können auch aus Readings dynamisch gesetzt werden wenn &quot;&lt;device&gt;:&lt;reading&gt;&quot; als Parameter gesetzt wird. Damit kann man z.B. in FHEM über notify etc. die Linientypen dynamisch anpassen (z.B. wenn der Wert eines Devices in einem bestimmten Bereich liegt, ändert sich die Farbe des Graphen).<br /> <br /> ==CSS Klassen==<br /> {|class=&quot;wikitable&quot;<br /> !Klasse!!Beschreibung<br /> {{FTUI Klasse|fullsize}}{{FTUI Klasse|noticks}}{{FTUI Klasse|nobuttons}}{{FTUI Klasse|small}}{{FTUI Klasse|normal}}{{FTUI Klasse|big}}<br /> |}<br /> <br /> <br /> Folgende Widget-spezifsche Klassen können zusätzlich in einer eigenen CSS-Datei definiert werden:<br /> <br /> {|class=&quot;wikitable&quot;<br /> !Klasse<br /> !Beschreibung<br /> |-<br /> |'''chart-background'''||Hintergrundfarbe des Diagramms<br /> |-<br /> |'''buttons'''||Größe und Farbe der Buttons<br /> |-<br /> |'''text.axes'''||Generelle Schriftart und Farbe der Achsen<br /> |-<br /> |'''gridlines'''||Generelle Farbe und Größe der Gitternetzlinien<br /> |-<br /> |'''xaxis'''||Schriftart, Größe und Farbe der X-Achse<br /> |-<br /> |'''yaxis'''||Schriftart, Größe und Farbe der Y-Achse<br /> |-<br /> |'''xticks'''||Schriftart, Größe und Farbe der X-Achse (Zwischenlinien)<br /> |-<br /> |'''yticks'''||Schriftart, Größe und Farbe der Y-Achse (Zwischenlinien)<br /> |-<br /> |'''crosshair'''||Schriftart, Größe und Vordergrund/Hintergrundfarbe der Momentanwerte am Fadenkreuzcursor<br /> |-<br /> |'''caption'''||Schriftart, Größe und Farbe der Text-Buttons für Legende und Cursor<br /> |-<br /> |'''legend'''||Schriftart, Größe und Farbe der Legende<br /> |}<br /> <br /> Die Standardwerte sind in der Datei &lt;code&gt;css/ftui_chart.css&lt;/code&gt; zu finden.<br /> <br /> ==Datenquellen==<br /> Beim Chart-Widget können die gleichen Datenquellen genutzt werden, die auch für SVG-Plots verwendet werden können:<br /> # [[FileLog]]: Verlaufsdaten einer Textdatei entnehmen<br /> # [[DbLog]]: Verlaufsdaten einer Datenbank entnehmen<br /> # [[LogProxy]]: Daten dynamisch berechnet<br /> <br /> ===FileLog===<br /> Um [[FileLog]] zu nutzen, wird als '''data-logdevice''' das FHEM-Device für das FileLog angegeben. In der Regel entstehen hier im Laufe der Zeit mehrere Log-Dateien. Name und Anzahl sind von der Definition abhängig - meist wird jeden Monat oder jedes Jahr eine neue Datei angelegt. Die gewünschte Datei kann mit '''data-logfile''' ausgewählt werden. Möchte man stets die aktuelle Datei verwenden (macht vor allem dann Sinn, wenn man die neusten Daten anzeigen will), kann das Attribut weggelassen, oder explizit &lt;code&gt;-&lt;/code&gt; eingetragen werden. Zuletzt wird '''data-columnspec''' benötigt, um die gewünschten Daten zu in der Logdatei zu identifizieren. Hier wird die Spalte, in der die Daten stehen, gefolgt von Doppelpunkt und Readingname angegeben.<br /> <br /> Für ein Heizungsthermostat von Homematic mit dem Namen ''DG.wz.HZ.Heizungsventil'' ergibt sich somit beispielhaft folgende Definition, um gemessene Temperatur, Sollwert und Ventilstellung im Diagramm darzustellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;DG.wz.HZ.Heizungsventil&quot;<br /> data-logdevice=&quot;FileLog_DG.wz.HZ.Heizungsventil&quot;<br /> data-logfile=&quot;-&quot;<br /> data-columnspec='[&quot;4:measured-temp&quot;,&quot;4:desired-temp&quot;,&quot;4:actuator&quot;]'<br /> ...&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Sollen Daten von unterschiedlichen Geräten in einem Diagramm angezeigt werden, muss '''data-logdevice''' als Array nach dem Schema &lt;code&gt;data-logdevice='[&quot;&lt;Logdatei_1&gt;&quot;,&quot;&lt;Logdatei_2&gt;&quot;,&quot;&lt;Logdatei_3&gt;&quot;]'&lt;/code&gt; definiert werden. Für jeden Eintrag in '''data-columnspec''' muss es auch den passenden Eintrag in '''data-logdevice''' geben (auch die Reihenfolge ist relevant).<br /> <br /> ===DbLog===<br /> Um die Daten aus [[DbLog]] anzeigen zu können, werden die gleichen Attribute verwendet und mit für die Datenbank angepassten Werten beschrieben. Bei '''data-logdevice''' das FHEM-Device für die Datenbank angegeben. Im nachfolgenden Beispiel heißt diese &lt;code&gt;logdb&lt;/code&gt; und besitzt wie üblich zwei Tabellen: &lt;code&gt;current&lt;/code&gt; und &lt;code&gt;history&lt;/code&gt; (der zeitliche Verlauf liegt in letzterer). Der Tabellenname wird bei '''data-logfile''' eingetragen. Da die Daten in der Datenbank etwas anders abgelegt werden, muss auch '''data-columnspec''' entsprechend angepasst werden. Statt der Spalte wird hier das FHEM-Device, gefolgt von Doppelpunkt und Readingname angegeben.<br /> <br /> Für das oben beschriebene Homematic-Heizungsthermostat ergibt sich dann folgende Definition, um die gleichen Daten aus einer Datenbank, statt einem LogFile zu lesen:<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;DG.wz.HZ.Heizungsventil&quot;<br /> data-get=&quot;measured-temp&quot;<br /> data-style='[&quot;ftui l0&quot;]'<br /> data-logdevice=&quot;logdb&quot;<br /> data-logfile=&quot;HISTORY&quot;<br /> data-columnspec='[&quot;DG.wz.HZ.Heizungsventil:measured-temp&quot;,&quot;DG.wz.HZ.Heizungsventil:desired-temp&quot;,&quot;DG.wz.HZ.Heizungsventil:actuator&quot;]'<br /> ...&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Für die Anzeige von unterschiedlichen Geräten in einem Diagramm, muss nur '''data-columnspec''' entsprechend angepasst werden, solange sich alle Daten in der Datenbank befinden.<br /> <br /> ===LogProxy===<br /> Um die Daten mittels [[LogProxy]] berechnen und anzeigen zu können, muss in FHEM ein LogProxy-Device definiert sein:<br /> <br /> &lt;pre&gt;<br /> define myLogProxy logProxy<br /> &lt;/pre&gt;<br /> <br /> Weitere Einstellungen am LogProxy sind nicht nötig, die bloße Existenz reicht.<br /> <br /> Bei '''data-logdevice''' wird das FHEM-Device für den LogProxy angegeben. Im nachfolgenden Beispiel heißt dieses &lt;code&gt;myLogProxy&lt;/code&gt;. Das Attribut '''data-logfile''' wird für LogProxy nicht benötigt. Befinden sich nur LogProxy-Werte im Diagramm kann das Attribut komplett entfallen. Sollen weitere Werte angezeigt werden, bleibt die Definition im Array einfach leer.<br /> <br /> Im Attribut '''data-columnspec''' wird eine Formel angegeben, wie die Werte berechnet werden sollen. Hier können die Formeln 1:1 von einem eventuell vorhandenen SVG-Plot übernommen werden. '''Dabei gibt es jedoch folgendes zu beachten:''' Befindet sich die Formel in einem Array, dürfen die Formeln keine Anführungszeichen (&lt;code&gt;&quot;&lt;/code&gt;) beinhalten. Stattdessen müssen sie als escapter Ascii-Code (&lt;code&gt;\\x22&lt;/code&gt;) eingefügt werden.<br /> <br /> Das nachfolgende Beispiel zeigt, wie Vorhersagewerte aus einem FHEM-Device vom Typ Proplanta (Name hier &lt;code&gt;AU.xx.WE.Proplanta&lt;/code&gt;) angezeigt werden können.<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;AU.xx.WE.Proplanta&quot;<br /> data-logdevice='[<br /> &quot;myLogProxy&quot;,<br /> &quot;myLogProxy&quot;,<br /> &quot;myLogProxy&quot;,<br /> &quot;myLogProxy&quot;<br /> ]'<br /> data-columnspec='[<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22temp_\\x22,$from,$to,12,\\x22day\\x22)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22rain_\\x22,$from,$to,12,\\x22day\\x22)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22chOfRain_\\x22,$from,$to,12,\\x22day\\x22)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22cloud_\\x22,$from,$to,12,\\x22day\\x22)&quot;<br /> ]'<br /> ...&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> '''Auch alle anderen Funktionen, die [[LogProxy]] bietet, können hier angewendet werden.'''<br /> <br /> ==Hinweise==<br /> ===Aktualisierung des Charts===<br /> Damit der Refresh des Charts funktioniert, muss auch ein Device angegeben werden, der das Refresh triggert. Das Diagramm wird immer dann aktualisiert, wenn sich der Inhalt von '''data-get''' ändert.<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;WohnzimmerHeizung&quot;<br /> data-logdevice=&quot;FileLog_WohnzimmerHeizung&quot;<br /> ...&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===Aussehen der Linien===<br /> Mit dem Attribut '''data-style''' kann das Aussehen der Linien des jeweiligen Graphen verändert werden. Hierfür können die Standard-FHEM-Styles verwendet werden. Dazu wird das Attribut mit &lt;code&gt;SVGplot&lt;/code&gt;, gefolgt von einem Leerzeichen und der gewünschten Farbe/Stil befüllt. Es existieren jedoch auch noch weitere, an FTUI angepasste Styles, zu finden in der CSS-Datei &lt;code&gt;css/ftui_chart.css&lt;/code&gt;. Um diese zu verwenden, wird das Attribut mit &lt;code&gt;ftui&lt;/code&gt;, gefolgt von einem Leerzeichen und der gewünschten Farbe/Stil befüllt. Eigene Styles können zum Beispiel in der Datei &lt;code&gt;css/fhem-table-ui-user.css&lt;/code&gt; definiert werden.<br /> <br /> Folgende Übersicht zeigt die im Standard verfügbaren '''Farben''', alle Abbildungen sind mit im FTUI-Style entstanden:<br /> &lt;div&gt;&lt;ul&gt; <br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f0.png|thumb|none|150px|Farbe &quot;l0&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f1.png|thumb|none|150px|Farbe &quot;l1&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f2.png|thumb|none|150px|Farbe &quot;l2&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f3.png|thumb|none|150px|Farbe &quot;l3&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f4.png|thumb|none|150px|Farbe &quot;l4&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f5.png|thumb|none|150px|Farbe &quot;l5&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Farbe-f6.png|thumb|none|150px|Farbe &quot;l6&quot;]] &lt;/li&gt;<br /> &lt;/ul&gt;&lt;/div&gt;<br /> <br /> Die Angabe zur Farbe kann dann mit der Linienart kombiniert werden. Dazu stehen folgende '''Stile''' zur Verfügung:<br /> &lt;div&gt;&lt;ul&gt; <br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-2D-normal.png|thumb|none|225px|Darstellung in 2D: Stil &quot;normal&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-2D-dot.png|thumb|none|225px|Darstellung in 2D: Stil &quot;dot&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-2D-dash.png|thumb|none|225px|Darstellung in 2D: Stil &quot;dash&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-2D-fill.png|thumb|none|225px|Darstellung in 2D: Stil &quot;fill&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-2D-sym.png|thumb|none|225px|Darstellung in 2D: Stil &quot;sym&quot;]] &lt;/li&gt;<br /> &lt;/ul&gt;&lt;/div&gt;<br /> <br /> &lt;div&gt;&lt;ul&gt; <br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-3D-normal.png|thumb|none|225px|Darstellung in 3D: Stil &quot;normal&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-3D-dot.png|thumb|none|225px|Darstellung in 3D: Stil &quot;dot&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-3D-dash.png|thumb|none|225px|Darstellung in 3D: Stil &quot;dash&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-3D-fill.png|thumb|none|225px|Darstellung in 3D: Stil &quot;fill&quot;]] &lt;/li&gt;<br /> &lt;li style=&quot;display: inline-block;&quot;&gt; [[File:FTUI_Widget_Chart_Form-3D-sym.png|thumb|none|225px|Darstellung in 3D: Stil &quot;sym&quot;]] &lt;/li&gt;<br /> &lt;/ul&gt;&lt;/div&gt;<br /> <br /> Farbe und Stil werden kombiniert (zusammengeschrieben) beim Attribut '''data-style''' angegeben, sodass sich beispielsweise für eine graue Punktlinie folgendes ergibt: &lt;code&gt;data-style=&quot;ftui l1dot&quot;&lt;/code&gt;.<br /> Um die Darstellung als normale Linie zu erhalten, darf im Gegensatz zu den anderen Linienformen der Stil &lt;code&gt;normal&lt;/code&gt; nicht angegeben werden. Für eine einfache graue Linie ist also die Angabe &lt;code&gt;data-style=&quot;ftui l1&quot;&lt;/code&gt; korrekt, wohingegen &lt;code&gt;data-style=&quot;ftui l1normal&quot;&lt;/code&gt; zu einer fehlerhaften Anzeige führt.<br /> <br /> '''Hinweis:''' Der Stil ''sym'' ist speziell dafür geeignet, Symbole statt Linien zu zeichnen. Dazu kann beim Attribut '''data-ptype''' als Linienform ein beliebiges Font-Awsome-, oder Open Automation-Icon angegeben werden. Alle in diesem Abschnitt enthaltenen Abbildungen sind mit &lt;code&gt;data-ptype=&quot;lines&quot;&lt;/code&gt; entstanden.<br /> <br /> '''Übergänge mit datenabhängigen Grenzen:''' Plotstile (data-style) können auch direkt als Gradienten auf Basis von Plot-Datenwerten definiert werden. Dazu muss der Plotstil als Array angegeben werden. Der erste Wert des Arrays gibt an, ob nur die Linie gezeichnet werden soll (Zahl angeben, die die Dicke der Linie definiert) oder gefüllt (&quot;fill&quot; eintragen). Alle danach folgenden Array Elemente sind beliebig viele Stopp Punkte für die Farbübergänge, welche wiederum aus Arrays mit 3 Parametern bestehen. Für jeden Stopp Punkt werden der Datenwert, die Farbe und die Durchsichtigkeit gesetzt. Hierdurch lassen sich z.B. Einfärbungen setzen, die für Temperaturplots immer negative Werte blau einfärben und positive Werte rot. Zwischen den Stop Punkten wird die Farbe interpoliert, also ein weicher Übergang generiert. Will man harte Übergänge muss man Zwei Stopp Punkte mit unterschiedlichen Farbwerten aber dem gleichen Datenwert erzeugen.&lt;br&gt;<br /> Beispiel 1 für einen weichen Gradienten, der bei 0 von blau nach rot übergeht, bei diesem Übergang durchsichtig ist und von dort nach negativen bzw. positiven Werden immer deckender wird:&lt;br&gt;<br /> &lt;code&gt;data-style='[&quot;fill&quot;,[&quot;-20&quot;,&quot;#0000ff&quot;,&quot;0.7&quot;],[&quot;0&quot;,&quot;#0000ff&quot;,&quot;0&quot;],[&quot;0&quot;,&quot;#ff0000&quot;,&quot;0&quot;],[&quot;302&quot;,&quot;#ff0000&quot;,&quot;0.7&quot;]]'&lt;/code&gt;&lt;br&gt;<br /> Beispiel 2 mit einem harten Übergang von blau nach rot bei 0:&lt;br&gt;<br /> &lt;code&gt;data-style='[&quot;fill&quot;,[&quot;-20&quot;,&quot;#0000ff&quot;,&quot;0.7&quot;],[&quot;0&quot;,&quot;#0000ff&quot;,&quot;0.7&quot;],[&quot;0&quot;,&quot;#ff0000&quot;,&quot;0.7&quot;],[&quot;50&quot;,&quot;#ff0000&quot;,&quot;0.7&quot;]]'&lt;/code&gt;<br /> Es gibt auch die Möglichkeit den Bereich zwischen zwei Graphen einzufärben. Dazu muss ein Wert in Columnspec als Array angegeben werden. Ist dies der Fall, dann wird der zweite Graph umgekehrt an den ersten angehängt.&lt;br&gt;<br /> Beispiel:<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> data-columnspec='[<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AgroWeather\\x22,\\x22weatherIcon\\x22,$from,$to,12)&quot;,<br /> [<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AgroWeather\\x22,\\x22tempMax\\x22,$from,$to,12)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AgroWeather\\x22,\\x22tempMin\\x22,$from,$to,12)&quot;<br /> ],<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AgroWeather\\x22,\\x22rain\\x22,$from,$to,0,\\x22day\\x22)&quot;<br /> ]'<br /> &lt;/syntaxhighlight&gt;<br /> [[Datei:FTUI Widget Chart DynamicStyles.png|thumb|none|225px|dynamischer Übergang]]<br /> <br /> ===Form der Linien===<br /> Das Attribut '''data-ptype''' beeinflusst die Form der Linien. Hier sind folgende Werte möglich:<br /> <br /> * &lt;code&gt;lines&lt;/code&gt;<br /> * &lt;code&gt;points&lt;/code&gt;<br /> * &lt;code&gt;steps&lt;/code&gt;<br /> * &lt;code&gt;fsteps&lt;/code&gt;<br /> * &lt;code&gt;histeps&lt;/code&gt;<br /> * &lt;code&gt;bars&lt;/code&gt;<br /> * &lt;code&gt;ibars&lt;/code&gt;<br /> * &lt;code&gt;cubic&lt;/code&gt;<br /> * &lt;code&gt;quadratic&lt;/code&gt;<br /> * &lt;code&gt;quadraticSmooth&lt;/code&gt;<br /> <br /> Zusätzlich ist es möglich, Symbole anzeigen zu lassen. Unterstützt werden Font-Awesome ('fa-...'), Open Automation ('oa-...') und FHEM-Symbole ('fs-...')). Damit die Symbole korrekt angezeigt werden, muss im Attribut '''data-style''' der Stil &lt;code&gt;sym&lt;/code&gt; gewählt werden, da sonst nur Punkte, statt der Symbole gezeichnet werden.<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;DG.wz.HZ.Heizungsventil&quot;<br /> data-logdevice=&quot;FileLog_DG.wz.HZ.Heizungsventil&quot;<br /> ...<br /> data-style=&quot;ftui l1sym&quot;<br /> data-ptype=&quot;fa-cog&quot;<br /> ...&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die Größe der Symbole ist in der Datei &lt;code&gt;css/ftui_chart.css&lt;/code&gt; auf 12px festgelegt. Dieser Wert kann in einer eigenen CSS-Datei durch Anpassung von &lt;code&gt;stroke-width&lt;/code&gt; überschrieben werden.<br /> <br /> &lt;syntaxhighlight lang=&quot;css&quot;&gt;<br /> .ftui.l0sym { stroke:#DDA400; stroke-width:12px; fill:none; }<br /> .ftui.l1sym { stroke:#BBBBBB; stroke-width:12px; fill:none; }<br /> .ftui.l2sym { stroke:#CC0000; stroke-width:12px; fill:none; }<br /> .ftui.l3sym { stroke:#CCCC00; stroke-width:12px; fill:none; }<br /> .ftui.l4sym { stroke:#33CC33; stroke-width:12px; fill:none; }<br /> .ftui.l5sym { stroke:#33CCCC; stroke-width:12px; fill:none; }<br /> .ftui.l6sym { stroke:#3333CC; stroke-width:12px; fill:none; }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> '''data-ptype''' kann auch Inhalt im Format &lt;code&gt;'icon:1'&lt;/code&gt; verarbeiten. Dann muss der zugehörige Wert in '''data-columnspec''' den Pfad zu einem Icon (z.B. für Wettervorhersagen) beinhalten. Der Y-Wert wird dann vom ersten Graphen übernommen. Weitere Ausführungen hierzu im Beispiel [[#Darstellung der Wetter Icons im Diagramm]].<br /> <br /> ===Stapeln von Linien===<br /> Über '''data-ptype''' kann zusätzlich festgelegt werden, ob Graphen übereinander gestapelt werden sollen. &lt;code&gt;data-ptype='lines:1'&lt;/code&gt; bedeutet, dass der zugehörige Graph auf den Graph mit der Nummer 1 gestapelt werden soll. So etwas kann z.B. Sinn machen, wenn man den Stromverbrauch einzelner Devices darstellen und zusätzlich sehen will, wie hoch die Summe ist. Beispiel siehe unten.<br /> <br /> [[Datei:FTUI Widget Chart Stacked.png]]<br /> <br /> ===Zeitstrahl / Start &amp; Ende auf der X-Achse===<br /> Die Attribute '''data-daysago_start''' und '''data-daysago_end''' dienen der Definition von Anfang und Ende der X-Achse. Im einfachsten Fall wird eine Anzahl an Tagen eingegeben, die sich auf das aktuelle Datum beziehen. Dabei gilt es zu beachten, dass es sich um ''vergangene Tage'' handelt. Das bedeutet, dass Tage in der Vergangenheit als positive Zahl angegeben werden, Tage in der Zukunft hingegen als negative Zahl. Es kann jeweils auch ein fixes Datum (z.B. '2013-10-23') angegeben werden. Uhrzeitangaben werden nur berücksichtigt, wenn '''data-nofulldays='true' ''' verwendet wird.<br /> <br /> '''Relative Zeitangabe in Stunden/Tagen/Wochen/Monaten/Jahren'''&lt;br /&gt;<br /> Zur Ausgabe einer Anzahl an zurückliegenden Stunden bis zum aktuellen Zeitpunkt wird als Startzeitpunkt die Anzahl der Stunden/Tage/Wochen/Monate/Jahre angegeben, die angezeigt werden sollen, gefolgt vom Kleinbuchstaben '''h''' für Stunden, '''d''' für Tage, '''w''' für Wochen, '''m''' für Monate, '''y''' für Jahre, . Als Endzeitpunkt wird '''now''' gewählt.&lt;br /&gt;<br /> Das nachfolgende Beispiel zeigt die Werte der vergangenen 3 Stunden an:<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> data-nofulldays=&quot;true&quot;<br /> data-daysago_start=&quot;3h&quot;<br /> data-daysago_end=&quot;now&quot;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> '''Fester Zeitbereich des heutigen Tages (Stunden/Tage/Wochen/Monate/Jahre)'''&lt;br /&gt;<br /> Um ein festes Stunden/Tages/Wochen/Monats/Jahresfenster anzuzeigen, werden die absoluten Stunden/Tages/Wochen/Monats/Jahreszahlen mit negativem Vorzeichen, gefolgt vom Großbuchstaben '''H''' (entsprechend D/W/M/Y für Tage/Wochen/Monate/Jahre) angegeben. Wird '''data-daysago_start''' als positiver Wert angegeben, wird die Anzahl der Stunden/Tage/Wochen/Monate/Jahre von heute 0:00 Uhr subtrahiert (siehe Rechenweg weiter unten).&lt;br /&gt;<br /> Das Beispiel zeigt den Zeitbereich von heute 5:00 Uhr bis heute 22:00 Uhr:<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> data-nofulldays=&quot;true&quot;<br /> data-daysago_start=&quot;-5H&quot;<br /> data-daysago_end=&quot;-22H&quot;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> '''Fester Zeitbereich Tage-übergreifend'''&lt;br /&gt;<br /> Die Zeit in Tagen kann als Gleitkommazahl angegeben werden. Damit ist es möglich, Tage und Uhrzeiten zu kombinieren. Die Werte sind dann als Teil eines ganzen Tages, bezogen auf heute 0:00 Uhr zu errechnen und mit &lt;code&gt;.&lt;/code&gt; als Teiler anzugeben.&lt;br /&gt;<br /> Das nachfolgende Beispiel zeigt einen Zeitbereich von '''gestern 15:00 Uhr''' bis '''morgen 3:00 Uhr'''.<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> data-nofulldays=&quot;true&quot;<br /> data-daysago_start=&quot;0.375&quot;<br /> data-daysago_end=&quot;-1.125&quot;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Für die nachfolgenden Rechenwege sind die Einheiten nur zur Verdeutlichung angegeben. Die Einheiten werden im Attribut nicht angegeben.<br /> <br /> Der Wert für '''GESTERN''' wird wie folgt ermittelt:&lt;br /&gt;<br /> Ausgangspunkt ist heute 0:00 Uhr, gestern 15:00 Uhr liegt also 9 Stunden davor. Diese 9 Stunden sind ein &lt;code&gt;9/24 Tag&lt;/code&gt; und errechnet sich so:<br /> &lt;pre&gt;<br /> 1d / 24h = 0.0416666...d/h<br /> 0.0416d/h * 9h = 0.375d<br /> &lt;/pre&gt;<br /> <br /> Der Wert für '''MORGEN''' wird wie folgt ermittelt:&lt;br /&gt;<br /> Ausgangspunkt ist wieder heute 0:00 Uhr, morgen 3:00 Uhr liegt dann 27 Stunden dahinter. Der Einfachheit halber werden hier nur die 3 Stunden errechnet und dann ein ganzer Tag addiert:<br /> &lt;pre&gt;<br /> 1d / 24h = 0.0416666...d/h<br /> 0.0416d/h * 3h = 0.125d<br /> <br /> 0.125d + 1d = 1.125d<br /> &lt;/pre&gt;<br /> Da das Attribut Tage in der Vergangenheit erwartet, muss für einen Wert in der Zukunft wieder eine negative Zahl angegeben werden.<br /> <br /> ===Zeitformat der X-Achse===<br /> Die Zeitanzeige auf der X-Achse kann sehr flexibel eingestellt werden. Dafür stehen verschiedene Platzhalter zur Verfügung, die durch spezielle Zeichen (&lt;code&gt;-&lt;/code&gt;, &lt;code&gt;.&lt;/code&gt;, &lt;code&gt;/&lt;/code&gt;, &lt;code&gt; &lt;/code&gt; (Leerzeichen), &lt;code&gt;:&lt;/code&gt;, &lt;code&gt;,&lt;/code&gt;, &lt;code&gt;\&lt;/code&gt;) getrennt werden. Alle Zeichen werden trotz Escape-Zeichen (&lt;code&gt;\&lt;/code&gt;) in der Ausgabe angezeigt.<br /> <br /> Folgende Platzhalter werden unterstützt:<br /> *&lt;code&gt;'mm'&lt;/code&gt;: Minuten als zweistellige Zahl<br /> *&lt;code&gt;'hh'&lt;/code&gt;: Stunden als zweistellige Zahl<br /> *&lt;code&gt;'dd'&lt;/code&gt;: Tag als zweistellige Zahl (Kalenderdatum)<br /> *&lt;code&gt;'MM'&lt;/code&gt;: Monat als zweistellige Zahl (z.B. 02 für Februar)<br /> *&lt;code&gt;'MMM'&lt;/code&gt;: Monat als dreistellige Abkürzung (z.B. Dec für Dezember)<br /> *&lt;code&gt;'MMMM'&lt;/code&gt;: Langname des Monats (z.B. March)<br /> *&lt;code&gt;'ee'&lt;/code&gt;: Wochentag als zweistellige Zahl (z.B. 00 für Sonntag)<br /> *&lt;code&gt;'eee'&lt;/code&gt;: Wochentag als dreistellige Abkürzung (z.B. Mon für Montag)<br /> *&lt;code&gt;'eeee'&lt;/code&gt;: Langname des Wochentags (z.B. Tuesday)<br /> *&lt;code&gt;'yy'&lt;/code&gt;: Jahr als zweistellige Zahl (z.B. 16 für 2016)<br /> *&lt;code&gt;'yyyy'&lt;/code&gt;: Jahr als vierstellige Zahl (z.B. 2016)<br /> *&lt;code&gt;'LF'&lt;/code&gt;: Fügt einen Zeilenumbruch hinzu<br /> <br /> Beispiel: Der String &lt;code&gt;'MMM\LF\yyyy'&lt;/code&gt; zeigt &lt;code&gt;'Jan'&lt;/code&gt; in der ersten, und &lt;code&gt;'2016'&lt;/code&gt; in der zweiten Zeile. &lt;code&gt;'MM.dd 2016'&lt;/code&gt; wird zu &lt;code&gt;'03.05 2016'&lt;/code&gt;.<br /> <br /> ===Fadenkreuz-Cursor===<br /> Der Fadenkreuz-Cursor zeigt die Momentanwerte, indem man ihn über die Graphen bewegt. In Desktop-Browsern reicht einfaches Bewegen des Maus. Unter iOS und Android kann der Cursor wird der Cursor durch einfaches Tippen auf die neue Position bewegt.<br /> <br /> Mit dem Attribut '''data-cursorgroup''' können Graphen gruppiert werden. Am Cursor werden dann die Momentanwerte aller Graphen gleichzeitig angezeigt, die die selbe Zahl besitzen, sobald man die Maus über einen aus der Gruppe bewegt.<br /> <br /> ===Legende===<br /> Mit dem Attribut '''data-legendpos''' kann die Position der Legende innerhalb des Diagramms festgelegt werden. Die Position wird mit einem Array, bestehend aus zwei Werten im Format &lt;code&gt;'[&quot;&lt;horizontal&gt;&quot;,&quot;&lt;vertikal&gt;&quot;]'&lt;/code&gt; angegeben. Für die horizontale Positionierung sind &lt;code&gt;'left'&lt;/code&gt;, &lt;code&gt;'right'&lt;/code&gt;, &lt;code&gt;'before'&lt;/code&gt;, und &lt;code&gt;'behind'&lt;/code&gt;, die vertikale Positionierung &lt;code&gt;'top'&lt;/code&gt;, &lt;code&gt;'bottom'&lt;/code&gt;, &lt;code&gt;'above'&lt;/code&gt;, &lt;code&gt;'below'&lt;/code&gt; erlaubt (der Unterschied zwischen &lt;code&gt;'left'&lt;/code&gt; und &lt;code&gt;'before'&lt;/code&gt; liegt darin, dass im zweiten Fall die Legende nicht in den Zeichenbereich gesetzt wird sondern vor das ganze Chart (entsprechend für &lt;code&gt;'after'&lt;/code&gt;, &lt;code&gt;'above'&lt;/code&gt; und &lt;code&gt;'below'&lt;/code&gt;). Alternativ können auch Zahlen verwendet werden, die die Position in Prozent angeben. Durch verschieben mit der Maus oder durch verschieben mit dem Finger oder Stift auf Touch Devices kann die Legende auch an eine andere Position verschoben werden.<br /> <br /> Wenn die Legende eingeblendet ist, kann mittels Klick auf einen Legendeneintrag der zugehörige Graph ein- und ausgeblendet werden.<br /> <br /> ===3-dimensionale Drehung===<br /> '''data-ddd''' ermöglicht, den Graphen 3-dimensional zu drehen. Als Wert wird ein Array mit den 3 Winkeln für x, y und z erwartet, wobei z selbst bisher nicht unterstützt wird.<br /> <br /> Beispiel: &lt;code&gt;data-ddd='[&quot;40&quot;,&quot;60&quot;,&quot;0&quot;]'&lt;/code&gt;. <br /> <br /> Wenn der 3D Modus aktiv ist ('''data-ddd''' gesetzt) sind 2 zusätzliche Parameter verfügbar um das Aussehen der Graphen zu beeinflussen. '''data-dddspace''' gibt an, wie viele pixel der Raum zwischen den einzelnen in z-Richtung hintereinander angeordneten Graphen betragen soll.<br /> '''data-dddwidth''' legt fest, wie viele pixel die einzelnen Graphen tief (oder dick) sein sollen.<br /> <br /> Wenn das Array angegeben wird, erscheinen zwei zusätzliche Buttons im Diagramm, mit denen die Drehung in X- und Y-Richtung verändert werden kann.<br /> <br /> ===Diagrammtitel===<br /> Mit dem Attribut '''data-title''' kann dem Diagramm, ähnlich wie in FHEM-SVG-Plots, ein Titel hinzugefügt werden.<br /> <br /> Folgende Platzhalter werden unterstützt:<br /> *&lt;code&gt;'min1'&lt;/code&gt;: Minimaler Y-Wert des ersten Graphs<br /> *&lt;code&gt;'max1'&lt;/code&gt;: Maximaler Y-Wert des ersten Graphs<br /> *&lt;code&gt;'avg1'&lt;/code&gt;: Mittlerer Y-Wert des ersten Graphs<br /> *&lt;code&gt;'cnt1'&lt;/code&gt;: Anzahl der dargestellten Einzelwerte im ersten Graph<br /> *&lt;code&gt;'currval1'&lt;/code&gt;: Letzter, bzw. aktuellster Y-Wert des ersten Graphs<br /> *&lt;code&gt;'mindate1'&lt;/code&gt;: Niedrigster Wert auf der X-Achse des ersten Graphs<br /> *&lt;code&gt;'maxdate1'&lt;/code&gt;: Höchster Wert auf der X-Achse vom ersten Graphs<br /> *&lt;code&gt;'currdate1'&lt;/code&gt;: Letzter, bzw. aktuellster Wert auf der X-Achse des ersten Graphs<br /> <br /> Durch Einsetzen einer anderen Zahl statt '1' können auch die Werte der anderen Graphen angezeigt werden. Das Weglassen der Zahl bewirkt, dass der jeweils zutreffende Wert automatisch ermittelt wird. Bedeutet: &lt;code&gt;max&lt;/code&gt; führt dazu, dass der höchste Wert aller angezeigter Graphen verwendet wird.<br /> Zusätzlich ist es möglich durch &quot;$eval(&lt;regexp&gt;)&quot; regular Expressions auszuwerten (also z.B. Berechnungen durchzuführen). In &lt;regexp&gt; können auch &quot;$data()&quot; vorkommen.<br /> <br /> Beispiel: &lt;code&gt;data-title=&quot;Klima Wohnzimmer Average: $eval(parseInt($data{avg1}*10)/10)°C / Max: $eval(parseInt($data{max1}*10)/10)°C&quot;&lt;/code&gt;<br /> <br /> ===Buttons im Diagramm===<br /> Es gibt mehrere Buttons, mit denen sich die Anzeige des Diagramms verändern lässt. &lt;code&gt;&lt;-&lt;/code&gt; und &lt;code&gt;-&gt;&lt;/code&gt; bewegen die Graphen nach links und rechts. &lt;code&gt;+&lt;/code&gt; und &lt;code&gt;-&lt;/code&gt; zoomen die Anzeige. &lt;code&gt;legend&lt;/code&gt; und &lt;code&gt;cursor&lt;/code&gt; schalten die zugehörigen Anzeigen ein und aus. Falls der 3D Modus eingeschaltet ist, gibt es Buttons zum Drehen der Darstellung um die X- und Y-Achse. Falls &lt;code&gt;data-timeranges&lt;/code&gt; gesetzt ist, wird ein Pulldown Menü dargestellt, welches die Auswahl von dort definierten Zeiträumen für die X-Achse erlaubt.<br /> <br /> ==Beispiele==<br /> ===Einfaches Diagramm===<br /> Das Beispiel zeigt ein einfaches Diagramm mit 4 unterschiedlich formatierten Graphen, Legende und Momentanwerten am Fadenkreuz-Cursor.<br /> <br /> [[File:Chart_tabletUI.png]]<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-logdevice='[&quot;Log.Garden&quot;,&quot;Log.Garden&quot;,&quot;Log.Garden&quot;,&quot;Log.Predicted&quot;]'<br /> data-columnspec='[&quot;4:Garden.T:15:&quot;,&quot;10:Garden.T:0:delta-h&quot;,&quot;10:Garden.T:0:delta-d&quot;,&quot;4:predicted.*:15:&quot;]'<br /> data-style='[&quot;ftui l0fill&quot;,&quot;ftui l1fill&quot;,&quot;ftui l2&quot;,&quot;ftui l3dot&quot;]'<br /> data-ptype='[&quot;lines&quot;,&quot;histeps&quot;,&quot;histeps&quot;,&quot;cubic&quot;]'<br /> data-uaxis='[&quot;primary&quot;,&quot;secondary&quot;,&quot;secondary&quot;,&quot;primary&quot;]'<br /> data-legend='[&quot;Temperature&quot;,&quot;Rain/hour&quot;,&quot;Rain/day&quot;,&quot;Predicted Temp.&quot;]'<br /> data-yunit=&quot;°C&quot;<br /> data-ytext=&quot;Temperature&quot;<br /> data-minvalue=&quot;auto&quot;<br /> data-maxvalue=&quot;auto&quot;<br /> data-yunit_sec=&quot;mm&quot;<br /> data-ytext_sec=&quot;Rain (mm)&quot;<br /> data-height=&quot;250&quot;<br /> data-yticks=&quot;auto&quot;<br /> data-minvalue_sec=&quot;auto&quot;<br /> data-maxvalue_sec=&quot;auto&quot;<br /> data-nofulldays=&quot;true&quot;<br /> data-daysago_start=&quot;2013-08-13T00:00:00&quot;<br /> data-daysago_end=&quot;2013-08-14T00:00:00&quot;<br /> data-cursorgroup=&quot;1&quot;<br /> data-scrollgroup=&quot;1&quot;<br /> data-xticks=&quot;auto&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===7-Tage-Wettervorhersage mit Proplanta===<br /> In diesem Beispiel wird gezeigt, wie die Vorhersagewerte von [[PROPLANTA]] in einem Diagramm dargestellt werden können. Da die Werte nicht in einer Datenbank oder einem FileLog vorliegen, müssen sie über [[LogProxy]] verarbeitet werden. Dafür sind einige Vorbereitungen in FHEM nötig.<br /> <br /> [[File:FTUI_Widget_Chart-fc-Proplanta.png|941px]]<br /> <br /> '''1.''' Ein LogProxy-Device muss vorhanden sein:<br /> &lt;pre&gt;<br /> define myLogProxy logProxy<br /> &lt;/pre&gt;<br /> <br /> '''2.''' In der Datei &lt;code&gt;99_myUtils.pm&lt;/code&gt; muss folgende Routine hinzugefügt werden, die die Daten bereitstellt:<br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> #---------------------------------------<br /> # Proplanta LogProxy-Funktion<br /> #---------------------------------------<br /> sub logProxy_proplanta2Plot($$$$;$$) {<br /> my ($device, $fcValue, $from, $to, $fcHour, $expMode) = @_;<br /> my $regex;<br /> my @rl;<br /> <br /> return undef if(!$device);<br /> <br /> if($fcValue =~ s/_$//) {<br /> $regex = &quot;^fc[\\d]+_&quot;.$fcValue.&quot;[\\d]{2}\$&quot;;<br /> }<br /> else {<br /> $regex = &quot;^fc[\\d]+_&quot;.$fcValue.&quot;\$&quot;;<br /> }<br /> <br /> $fcHour = 12 if(!defined $fcHour);<br /> $expMode = &quot;point&quot; if(!defined $expMode);<br /> <br /> if( defined($defs{$device}) ) {<br /> if( $defs{$device}{TYPE} eq &quot;PROPLANTA&quot; ) {<br /> @rl = sort{<br /> my ($an) = ($a =~ m/fc(\d+)_.*/);<br /> my ($bn) = ($b =~ m/fc(\d+)_.*/);<br /> $an &lt;=&gt; $bn or $a cmp $b;<br /> }( grep /${regex}/,keys %{$defs{$device}{READINGS}} );<br /> return undef if( !@rl );<br /> } else {<br /> Log3 undef, 2, &quot;logProxy_proplanta2Plot: $device is not a PROPLANTA device&quot;;<br /> return undef;<br /> }<br /> }<br /> <br /> my $fromsec = SVG_time_to_sec($from);<br /> my $tosec = SVG_time_to_sec($to);<br /> my $sec = $fromsec;<br /> my ($h,$fcDay,$mday,$mon,$year);<br /> my $timestamp;<br /> <br /> my $reading;<br /> my $value;<br /> my $prev_value;<br /> my $min = 999999;<br /> my $max = -999999;<br /> my $ret = &quot;&quot;;<br /> <br /> # while not end of plot range reached<br /> while(($sec &lt; $tosec) &amp;&amp; @rl) {<br /> #remember previous value for start of plot range<br /> $prev_value = $value;<br /> <br /> $reading = shift @rl;<br /> ($fcDay) = $reading =~ m/^fc(\d+).*/;<br /> $h = ($reading =~ m/.*(\d\d)$/)?$1:$fcHour;<br /> $value = ReadingsVal($device,$reading,undef);<br /> <br /> ($mday,$mon,$year) = split('\.',ReadingsVal($device,&quot;fc&quot;.$fcDay.&quot;_date&quot;,undef));<br /> $timestamp = sprintf(&quot;%04d-%02d-%02d_%02d:%02d:%02d&quot;, $year, $mon, $mday, $h, 0, 0);<br /> $sec = SVG_time_to_sec($timestamp);<br /> <br /> # skip all values before start of plot range<br /> next if( SVG_time_to_sec($timestamp) &lt; $fromsec );<br /> <br /> # add first value at start of plot range<br /> if( !$ret &amp;&amp; $prev_value ) {<br /> $min = $prev_value if( (looks_like_number($prev_value) &amp;&amp; ($prev_value &lt; $min)) || ($prev_value lt $min) );<br /> $max = $prev_value if( (looks_like_number($prev_value) &amp;&amp; ($prev_value &gt; $max)) || ($prev_value gt $max) );<br /> $ret .= &quot;$from $prev_value\n&quot;;<br /> }<br /> <br /> # done if after end of plot range<br /> last if($sec &gt; $tosec);<br /> <br /> $min = $value if( (looks_like_number($value) &amp;&amp; ($value &lt; $min )) || ($value lt $min) );<br /> $max = $value if( (looks_like_number($value) &amp;&amp; ($value &gt; $max )) || ($value gt $max) );<br /> <br /> # add actual controll point<br /> $ret .= &quot;$timestamp $value\n&quot;;<br /> <br /> # Log 1, &quot;$timestamp $value -0- $reading&quot;;<br /> }<br /> if(($sec &lt; $tosec) &amp;&amp; !@rl &amp;&amp; ($expMode eq &quot;day&quot;)) {<br /> $timestamp = sprintf(&quot;%04d-%02d-%02d_%02d:%02d:%02d&quot;, $year, $mon, $mday, 23, 59, 59);<br /> if(SVG_time_to_sec($timestamp) &lt; $tosec) {<br /> $ret .= &quot;$timestamp $value\n&quot;;<br /> }<br /> else {<br /> $ret .= &quot;$to $value\n&quot;;<br /> }<br /> }<br /> elsif(($sec &gt; $tosec) &amp;&amp; ($expMode eq &quot;day&quot;)) {<br /> $value = $prev_value + ($value - $prev_value)*(86400 + ($tosec - $sec))/86400;<br /> $ret .= &quot;$to $value\n&quot;;<br /> }<br /> return ($ret,$min,$max,$prev_value);<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Anschließend können die Daten im Chart-Widget angezeigt werden. Der Device-Name von Proplanta heißt hier im Beispiel &lt;code&gt;AU.xx.WE.Proplanta&lt;/code&gt;.<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;AU.xx.WE.Proplanta&quot;<br /> data-logdevice='[<br /> &quot;myLogProxy&quot;,<br /> &quot;myLogProxy&quot;,<br /> &quot;myLogProxy&quot;<br /> ]'<br /> data-columnspec='[<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22rain_\\x22,$from,$to,12,\\x22day\\x22)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22chOfRain_\\x22,$from,$to,12,\\x22day\\x22)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22cloud_\\x22,$from,$to,12,\\x22day\\x22)&quot;<br /> ]'<br /> data-style='[<br /> &quot;ftui l6fill&quot;,<br /> &quot;ftui l5fill&quot;,<br /> &quot;ftui l1fill&quot;<br /> ]'<br /> data-ptype='[<br /> &quot;steps&quot;,<br /> &quot;quadraticSmooth&quot;,<br /> &quot;quadraticSmooth&quot;<br /> ]'<br /> data-uaxis='[<br /> &quot;primary&quot;,<br /> &quot;secondary&quot;,<br /> &quot;secondary&quot;<br /> ]'<br /> data-legend='[<br /> &quot;Regen&quot;,<br /> &quot;Regenwahrscheinlichkeit&quot;,<br /> &quot;Wolken&quot;<br /> ]'<br /> data-yunit=&quot;mm&quot;<br /> data-ytext=&quot;Regen&quot;<br /> data-yunit_sec=&quot;%&quot;<br /> data-ytext_sec=&quot;Chance auf Regen / Wolken&quot;<br /> data-timeformat=&quot;eeee&quot;<br /> data-minvalue=&quot;auto&quot;<br /> data-maxvalue=&quot;auto&quot;<br /> data-minvalue_sec=&quot;auto&quot;<br /> data-maxvalue_sec=&quot;auto&quot;<br /> data-daysago_start = &quot;0&quot;<br /> data-daysago_end = &quot;-7&quot;<br /> data-xticks=&quot;1440&quot;<br /> data-yticks=&quot;auto&quot;<br /> data-title=&quot;7-Tage-Wettervorhersage&quot;<br /> data-showlegend=&quot;true&quot;<br /> class=&quot;nobuttons fullsize&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> '''Hilfreiche Links und Quellen zu diesem Beispiel:'''<br /> *[[LogProxy|LogProxy im FHEM-Wiki]]<br /> *{{Link2Forum|Topic=22967|Message=246973|LinkText=Stundengenaue Wettervorhersage (#1) im FHEM-Forum}}<br /> *{{Link2Forum|Topic=22967|Message=334713|LinkText=Stundengenaue Wettervorhersage (#2) im FHEM-Forum}}<br /> <br /> ===Darstellung der Wetter Icons im Diagramm===<br /> <br /> [[File:Wetterchart2.png]]<br /> <br /> Wie oben bereits beschrieben, gibt es beim Chart grundsätzlich die Möglichkeit, Icons, welche in Form von URLs in den Logs abgelegt sind oder welche per logProxy generiert werden, darzustellen. Die Icons werden auf genau dem gleichen Weg von FHEM gelesen, wie alle anderen Datenpunkte. Im Folgenden wird ein Beispiel gezeigt, mit dem die im Proplanta Modul als Readings abgelegten Icons per logProxy Funktion gelesen und in ein Chart eingebaut werden könnnen.<br /> Da es beim Proplanta Modul für die ersten 7 Tage nicht das Reading &lt;code&gt;fc#_weatherIcon&lt;/code&gt; gibt, sondern mehrere Readings für unterschiedliche Tageszeiten wogegen für die zweiten 7 Tage ausschließlich das Reading &lt;code&gt;fc#_weatherIcon&lt;/code&gt; vorhanden ist, sollte per &lt;code&gt;attr device userReading&lt;/code&gt; mit folgendem Eintrag dafür gesorgt werden, dass für alle Tage ein Reading &lt;code&gt;fc#_weatherIcon&lt;/code&gt; vorhanden ist (alternativ könnten auch 2 Graphen gezeichnet werden, wobei der erste dann nur die ersten 7 Tage enthält und der zweite die letzen 7 Tage, will man nur die ersten 7 Tage darstellen braucht man das userReading nicht unbedingt).<br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> fc0_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc0_weatherDayIcon&quot;,&quot;&quot;);},<br /> fc1_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc1_weatherDayIcon&quot;,&quot;&quot;);},<br /> fc2_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc2_weatherDayIcon&quot;,&quot;&quot;);},<br /> fc3_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc3_weatherDayIcon&quot;,&quot;&quot;);},<br /> fc4_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc4_weatherDayIcon&quot;,&quot;&quot;);},<br /> fc5_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc5_weatherDayIcon&quot;,&quot;&quot;);},<br /> fc6_weatherIcon {ReadingsVal(&quot;AU.xx.WE.Proplanta&quot;,&quot;fc6_weatherDayIcon&quot;,&quot;&quot;);}<br /> &lt;/syntaxhighlight&gt;<br /> Um die Icons darzustellen muss ein zusätzlicher Graph definiert werden. Dieser nutzt neben der Columnspec, die die URLs abruft den Parameter &lt;code&gt;data-ptype=&quot;icons:#&quot;&lt;/code&gt; (# ist eine Zahl und steht für die Nummer, beginnend bei 0 des Graphen, welcher für die y-Position der Icons verwendet werden soll) und den Stil &lt;code&gt;sym&lt;/code&gt;. Der Wert für die Symbolgröße sollte z.B. durch eine zusätzliche Definition im File fhem-tablet-ui-user.css in der Form:<br /> &lt;syntaxhighlight lang=&quot;css&quot;&gt;<br /> /* icon lines */<br /> .ftui.l99icon { stroke:#DDA400; stroke-width:48px; fill:none; }<br /> &lt;/syntaxhighlight&gt;<br /> angepasst werden.<br /> <br /> Im folgenden ein Beispiel, welches eine Linie für die Maximale Tagestemperatur zeichnet und auf dieser Linie die Wetter Icons darstellt.<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;AU.xx.WE.Proplanta&quot;<br /> data-logdevice='[<br /> &quot;myLogProxy&quot;,<br /> &quot;myLogProxy&quot;<br /> ]'<br /> data-columnspec='[<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22weatherIcon\\x22,$from,$to,12,\\x22day\\x22)&quot;,<br /> &quot;Func:logProxy_proplanta2Plot(\\x22AU.xx.WE.Proplanta\\x22,\\x22tempMax\\x22,$from,$to,12,\\x22day\\x22)&quot;<br /> ]'<br /> data-style='[<br /> &quot;ftui l99icon&quot;,<br /> &quot;ftui l1fill&quot;<br /> ]'<br /> data-ptype='[<br /> &quot;icons:1&quot;,<br /> &quot;quadraticSmooth&quot;<br /> ]'<br /> data-uaxis='[<br /> &quot;primary&quot;,<br /> &quot;primary&quot;<br /> ]'<br /> data-legend='[<br /> &quot;Wetterbedingung&quot;,<br /> &quot;Max. Temperature&quot;<br /> ]'<br /> data-yunit=&quot;°C&quot;<br /> data-ytext=&quot;Temperature (°C)&quot;<br /> data-timeformat=&quot;ee\LF\dd.MM&quot;<br /> data-minvalue=&quot;auto&quot;<br /> data-maxvalue=&quot;auto&quot;<br /> data-minvalue_sec=&quot;auto&quot;<br /> data-maxvalue_sec=&quot;auto&quot;<br /> data-daysago_start=&quot;-1w&quot;<br /> data-y_margin=&quot;20&quot;<br /> data-daysago_end=&quot;-3w&quot;<br /> data-xticks=&quot;1440&quot;<br /> data-yticks=&quot;auto&quot;<br /> data-title=&quot;14-Tage-Wettervorhersage&quot;<br /> data-showlegend=&quot;true&quot;<br /> class=&quot;nobuttons fullsize&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===Kuchendiagramme===<br /> In folgendem Beispiel wird gezeigt, wie man ein &quot;Kuchendiagramm&quot; darstellen kann.<br /> <br /> [[File:PieChart.png]]<br /> <br /> Ähnlich wie bei den Beispielen für die Wetter Darstellungen wird hierzu auch wieder logProxy benötigt. Zunächst muss die folgende zusätzliche Funktion in &lt;code&gt;99_myUtils.pm&lt;/code&gt; einfügen.<br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> #---------------------------------------<br /> # Funktion zum Erzeugen der Inputs für Kuchendiagramme<br /> #---------------------------------------<br /> sub logProxy_values2PieChart($$$$;$$) {<br /> my ($device, $reading, $angle_start, $angle_dif, $inner_rad, $show_text) = @_;<br /> Log3 undef, 1, &quot;$device, $reading, $angle_start, $angle_dif, $inner_rad, $show_text\n&quot;;<br /> <br /> use constant PI =&gt; 4 * atan2(1,1);<br /> <br /> my $value=ReadingsVal($device,$reading,0);<br /> <br /> my $angle_delta = $value/100*360;<br /> $angle_start = $angle_start/100*360;<br /> <br /> my $rad=10;<br /> my $irad=0;<br /> if ($inner_rad) {<br /> $irad = $rad*$inner_rad;<br /> }<br /> my $angle=$angle_start/360*2.0*PI;<br /> my $x=$irad*sin($angle);<br /> my $y=$irad*cos($angle);<br /> my $ret .= &quot;;p &quot;.$x.&quot; &quot;.$y.&quot;\n&quot;; # add segment at angle $angle<br /> <br /> for (my $i=$angle_start; $i&lt;=$angle_start+$angle_delta; $i+=$angle_dif) {<br /> $angle = $i/360*2.0*PI;<br /> $x = $rad*sin($angle);<br /> $y = $rad*cos($angle);<br /> $ret .= &quot;;p &quot;.$x.&quot; &quot;.$y.&quot;\n&quot;; # add segment at angle $angle<br /> }<br /> <br /> $angle = ($angle_start+$angle_delta)/360*2.0*PI; # add last segment <br /> $ret .= &quot;;p &quot;.$rad*sin($angle).&quot; &quot;.$rad*cos($angle).&quot;\n&quot;;<br /> <br /> if ($inner_rad) {<br /> for (my $i=$angle_start; $i&lt;$angle_start+$angle_delta; $i+=$angle_dif) {<br /> $angle = ($angle_start+$angle_start+$angle_delta-$i)/360*2.0*PI;<br /> $x = $irad*sin($angle);<br /> $y = $irad*cos($angle);<br /> $ret .= &quot;;p &quot;.$x.&quot; &quot;.$y.&quot;\n&quot;; # add segment at angle $angle<br /> }<br /> }<br /> <br /> $angle = ($angle_start)/360*2.0*PI; # add last segment <br /> $ret .= &quot;;p &quot;.$irad*sin($angle).&quot; &quot;.$irad*cos($angle).&quot;\n&quot;;<br /> <br /> if ($show_text) { # show text values<br /> $x = ($rad+$irad)/2*sin((2*$angle_start+$angle_delta)/2/360*2.0*PI);<br /> $y = ($rad+$irad)/2*cos((2*$angle_start+$angle_delta)/2/360*2.0*PI);<br /> <br /> $ret .= &quot;;t &quot;.$x.&quot; &quot;.$y.&quot; middle &quot;.$show_text.&quot;:&quot;.$value.&quot;%\n&quot;;<br /> }<br /> <br /> return($ret);<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> In FHEM braucht man Readings, welche eine Zahl enthalten, die als Prozentwert interpretiert wird. Für jeden Prozentwert (also für jedes Reading) generiert die o.a. Funktion nun den Chart Input für ein Kuchenstück und liefert diesen als Antwort auf das GET, welches das Chart Widget auslöst. Dazu braucht die Funktion folgende Parameter: (Name des FHEM Devices, Name des Readings, Start Winkel des Kuchenstücks (Mathematisch gegen den Uhrzeigersinn in Grad), Delta Winkel zum Zeichnen (legt fest in welchen Schritten der Teilkreis des Kuchenstücks gezeichnet wird), Skalierungsfaktor für inneren Ring wenn ein Ring gezeichtnet werden soll (0 bedeutet komplette Kuchenstücke), optionaler Text der ins Kuchenstück vor die Prozentzahl geschrieben wird).<br /> Im Folgenden eine Beispielkonfiguration für die Darstellung als Kuchendiagramm, die Readings heißen hier dPer1 bis dPer4. Der Startwinkel wird duch Aufsummierung der jeweils vorher schon gezeichneten Kuchenstücke gebildet, dadurch entstehen aneinander hängende Stücke.<br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> [[Datei:[[Datei:Beispiel.jpg]]]]&lt;div class=&quot;normal noaxes nobuttons&quot;<br /> data-type=&quot;chart&quot;<br /> data-logdevice='[&quot;lp&quot;]'<br /> data-logfile=&quot;CURRENT&quot;<br /> data-columnspec='[<br /> &quot;Func:logProxy_values2PieChart(\&quot;dPer1\&quot;,\&quot;state\&quot;,ReadingsVal(\&quot;dPer4\&quot;,\&quot;state\&quot;,0)+ReadingsVal(\&quot;dPer3\&quot;,\&quot;state\&quot;,0),5,0,\&quot;first\&quot;)&quot;,<br /> &quot;Func:logProxy_values2PieChart(\&quot;dPer2\&quot;,\&quot;state\&quot;,ReadingsVal(\&quot;dPer4\&quot;,\&quot;state\&quot;,0)+ReadingsVal(\&quot;dPer3\&quot;,\&quot;state\&quot;,0)+ReadingsVal(\&quot;dPer1\&quot;,\&quot;state\&quot;,0),5,0,\&quot;second\&quot;)&quot;,<br /> &quot;Func:logProxy_values2PieChart(\&quot;dPer3\&quot;,\&quot;state\&quot;,ReadingsVal(\&quot;dPer4\&quot;,\&quot;state\&quot;,0),5,0,\&quot;third\&quot;)&quot;,<br /> &quot;Func:logProxy_values2PieChart(\&quot;dPer4\&quot;,\&quot;state\&quot;,0,5,0,\&quot;fourth\&quot;)&quot;<br /> ]'<br /> data-style='[&quot;ftui l0fill&quot;,&quot;ftui l1fill&quot;,&quot;ftui l2fill&quot;,&quot;ftui l3fill&quot;]'<br /> data-ptype='[&quot;lines&quot;]'<br /> data-uaxis='[&quot;primary&quot;]'<br /> data-legend='[&quot;First&quot;,&quot;Second&quot;,&quot;Third&quot;,&quot;Fourth&quot;]'<br /> data-legendpos='[&quot;left&quot;,&quot;top&quot;]'<br /> data-yunit=&quot;&quot;<br /> data-height=&quot;300&quot;<br /> data-width=&quot;300&quot;<br /> data-ddd='[&quot;-40&quot;,&quot;0&quot;,&quot;0&quot;]'<br /> data-dddspace='[&quot;-10&quot;]'<br /> data-dddwidth='[&quot;10&quot;]'<br /> data-showlegend=&quot;true&quot;<br /> data-legend_horiz=&quot;true&quot;<br /> data-xticks=&quot;auto&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===Fensterstatus offen/geschlossen===<br /> Dieses Beispiel zeigt, wie ein Fensterkontakt, dessen Reading die Werte &lt;code&gt;closed&lt;/code&gt; und &lt;code&gt;open&lt;/code&gt; einnimmt, als Graph gezeichnet werden kann. Technisch gesehen werden hier die Werte &lt;code&gt;0&lt;/code&gt; und &lt;code&gt;1&lt;/code&gt; gezeichnet, indem über das Attribut '''data-columnspec''' dem Zustand &lt;code&gt;open&lt;/code&gt; der Wert &lt;code&gt;1&lt;/code&gt; und allen anderen Zuständen der Wert &lt;code&gt;0&lt;/code&gt; zugeordnet wird. Über das Attribut '''data-yticks''' wird die Beschriftung an der Y-Achse (&lt;code&gt;0&lt;/code&gt; und &lt;code&gt;1&lt;/code&gt;) gegen einen frei definierbaren Text ausgetauscht.<br /> <br /> &lt;syntaxhighlight lang=&quot;html&quot;&gt;<br /> &lt;div data-type=&quot;chart&quot;<br /> data-device=&quot;wz_fensterstatus&quot;<br /> data-logdevice='[&quot;myDbLog&quot;]'<br /> data-logfile='[&quot;HISTORY&quot;]'<br /> data-columnspec='[&quot;wz_fensterstatus:state:0::$val=($val=~\\x22open\\x22?1:0)&quot;]'<br /> data-style='[&quot;ftui l4fill&quot;]'<br /> data-ptype='[&quot;steps&quot;]'<br /> data-height=&quot;290&quot;<br /> data-yticks='[[0,&quot;geschlossen&quot;],[1,&quot;offen&quot;]]'<br /> data-minvalue=&quot;0&quot;<br /> data-maxvalue=&quot;1.1&quot;<br /> data-nofulldays=&quot;true&quot;<br /> data-daysago_start=&quot;1&quot;<br /> data-daysago_end=&quot;-1&quot;<br /> data-cursorgroup=&quot;1&quot;<br /> data-scrollgroup=&quot;1&quot;&gt;<br /> &lt;/div&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> '''Hinweis:''' Das Beispiel funktioniert nur mit DbLog. Falls Logfiles verwendet werden muss statt '$val' '$fld[''num'']' verwendet werden. Hierbei steht ''num'' für die Spalte (beginnend bei 0) in der die Daten stehen.<br /> <br /> ==Links==<br /> {{Link2Forum|Topic= 48450 |Message=401006|LinkText=Thread im FHEM-Forum}}<br /> <br /> [[Kategorie:FHEM Tablet UI|Chart]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog&diff=31058 DbLog 2019-07-29T10:54:57Z <p>Stephan: /* Beispiel: Anlegen und Nutzung einer Mysql-Datenbank */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Mit der Zeit entstehen in FHEM recht umfangreiche Log-Daten für die verschiedensten konfigurierten Devices. Die übliche Einstiegs-[[Konfiguration]] sieht vor, dass die Logs als {{Link2CmdRef|Lang=de|Anker=FileLog|Label=FileLog}} gespeichert werden - je nach Einstellung in wenigen sehr großen oder vielen kleineren Dateien. Der Datei-basierte Zugriff ist allerdings nicht wirklick performant und kann schnell zum Flaschenhals werden (z.B. bei der Darstellung von Graphen über einen längeren Zeitraum).<br /> <br /> Alternativ kann FHEM die Log-Daten mittels {{Link2CmdRef|Lang=de|Anker=DbLog|Label=DbLog}} in einer Datenbank speichern. Diese kann lokal als einfache SQLite- oder als zentrale Server-Datenbank (s.u.) gestaltet sein. Schon eine lokale einfache SQLite-Datenbank ist in der Regel deutlich performanter als File-basierte Logs.<br /> <br /> Damit eine Datenbank-Nutzung möglich ist, müssen folgende Anpassungen gemacht werden:<br /> # [[#Datenbank|Erstellen einer entsprechenden Datenbank]]<br /> # [[#Datenbank-Anbindung mittels db.conf|Konfiguration der Datenbank-Anbindung in FHEM]]<br /> # [[#Konfiguration als Device in fhem.cfg|Anpassen aller (oder einzelner) Konfigurationen von FileLog nach DbLog]]<br /> # [[#Anpassen der gplot-Konfigurationen|Ggf. Anpassen der gplot-Konfigurationen]]<br /> <br /> ;Hinweis:<br /> Reporting und Management von DbLog-Datenbankinhalten kann mit dem Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] stattfinden.<br /> <br /> == Konfiguration ==<br /> === Datenbank-Anbindung mittels db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MySQL-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Konfiguration als Device ===<br /> Das DbLog Device wird dann definiert mit<br /> :&lt;code&gt;define &lt;name&gt; DbLog &lt;configfilename&gt; &lt;regexp&gt; &lt;/code&gt;<br /> wobei ''&lt;configfilename&gt;'' dem Pfad zur zuvor angelegten db.conf entspricht.<br /> Ein Beispiel hierfür wäre:<br /> :&lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;<br /> Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit vielen teils irrelevanten Werten gefüllt wird. Man kann daher die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Dies ist in [[#Finetuning des Loggings]] beschrieben.<br /> <br /> Unbedingt beachten: bei Verwendung des Moduls configdb wird die Konfigurationsdatei aus der '''''Datenbank''''' gelesen. Deshalb ist es erforderlich, das File mittels &lt;code&gt;configdb fileimport db.conf &lt;/code&gt; vorher zu importieren !<br /> <br /> === Finetuning des Loggings ===<br /> Bei der Konfiguration des Log-Devices werden die zu loggenden Daten definiert - in der einfachsten Form sieht das so aus: &lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;. Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit sehr vielen und teils nicht benötigten Werten gefüllt wird und schnell wächst. Die Datenbank ist zwar deutlich leistungsfähiger, was große Datenmengen angeht, Datensparsamkeit kann aber schnell sinnvoll werden...<br /> <br /> Um das Log-Aufkommen einzugrenzen gibt es mehrere Ansätze:<br /> * Einschränkung über den &lt;code&gt;define&lt;/code&gt;-Eintrag<br /> * Einschränkung über DbLogExclude-Einträge der jeweiligen Devices<br /> * Einschränkung über DbLogInclude-Einträge des jeweiligen Devices<br /> * Ausschluß von Device/Reading-Kombinationen über das Attribut &quot;excludeDevs&quot;. Es können [https://fhem.de/commandref_DE.html#devspec devspec] verwendet werden. <br /> <br /> ==== Einschränkung über den zentralen &lt;code&gt;define&lt;/code&gt;-Eintrag ====<br /> Man kann die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Die erste Wildcard, also das erste &lt;code&gt;.*&lt;/code&gt;, entspricht dem in FHEM verwendeten Device-Namen. Die zweite Wildcard entspricht dem vom Device ausgegebenen zu loggenden Wert. Separiert werden beiden Angaben durch einen Doppelpunkt. <br /> <br /> Ein Beispiel, um zwar alle definierten Devices zu erfassen, aber nur die Werte Temperatur, Ventilposition und Luftfeuchte in die Datenbank zu schreiben wäre:<br /> :&lt;code&gt;define myDbLog DbLog ./db.conf .*:(temperature|valveposition|humidity).* &lt;/code&gt;<br /> <br /> ==== Einschränkung über die jeweiligen Devices ====<br /> Man kann die zu loggenden Werte für einzelne Devices separat einschränken, ohne dies im zentralen define-Eintrag machen zu müssen. Dies kann interessant sein, wenn beispielsweise ein Device Fehlerwerte meldet, die uninteressant sind, oder es meldet unnötig häufig Werte - beides ist z.B. bei 1-wire-Temperatursensoren gerne der Fall.<br /> <br /> Um das einzuschränken gibt es 2 Stellparameter, die als Attribute direkt zum jeweiligen Device konfiguriert werden:<br /> * DbLogExclude - definiert Werte, die nicht geloggt werden sollen<br /> * DbLogInclude - definiert Werte, die geloggt werden sollen ( siehe attr DbLogSelectionMode )<br /> * event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef|Lang=de|Anker=event-on-update-reading}})<br /> <br /> Eine konkrete Konfiguration für einen sehr gesprächigen 1-wire-Temperatursensor könnte wie folgt aussehen:<br /> &lt;pre&gt;<br /> define EG_Balkon GPIO4 BUSMASTER<br /> attr EG_Balkon DbLogExclude failures,T,85 # logge keine &quot;failures&quot;, &quot;T&quot;-Werte und &quot;85&quot;-Werte (default-Werte, wenn keine Temperatur gelesen werden kann)<br /> attr EG_Balkon event-on-change-reading state # logge nur, wenn sich ein Wert ändert (wenn sich die Temperatur nicht ändert, logge das nicht)<br /> attr EG_Balkon event-min-interval state:900 # logge spätestens alle 900sec = 15min<br /> attr EG_Balkon event-on-update-reading .* # logge alle Werte, die aktualisiert werden<br /> <br /> attr &lt;1-Wire-Device vom Typ OWTHERM oder OWSWITCH&gt; DbLogExclude data.* # verhindert das Logging der state-Eintragungen<br /> &lt;/pre&gt;<br /> <br /> Eine in diesem {{Link2Forum|Topic=33697|Message=264127}} vorgestellte Strategie zur Vermeidung unnötigen Loggings ist, dass bei der Definition von Devices durch das nachfolgende &lt;code&gt;notify&lt;/code&gt; automatisch ein DbLogExclude für alle Werte (.*) des Devices zugewiesen wird und dies nur bei Interesse an geloggten Werten gelöscht bzw. angepasst wird:<br /> &lt;code&gt;define nDbLogExclude notify global:DEFINED.* attr $EVTPART1 DbLogExclude .*&lt;/code&gt;<br /> <br /> Ebenso ist es mittlerweile möglich, lediglich erwünschte Werte (Positiv-Liste) zu loggen und alle anderen zu verwerfen. Hierfür wird im LogDevice das attribut DbLogSelectionMode Include verwendet. Nun kann für jedes Device mit DbLogInclude &lt;Reading1&gt;,&lt;Reading2&gt;,... angegeben werden, welche Readings geloggt werden sollen. <br /> Integriert ist ebenfalls ein &quot;min-interval&quot;, siehe {{Link2CmdRef}}.<br /> <br /> == Datenbank ==<br /> Unterstützte Datenbanksysteme (Auswahl):<br /> * Sqlite<br /> * MySQL<br /> * PostGreSql<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen &quot;fhem&quot; an.<br /> <br /> ==== current ====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== history ====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> {{Todo|Ausbauen}}<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Hierfür gibt es eine [[DbLog-MySQL|extra Seite]], die die Unterschiede und Feinheiten zwischen den verschiedenen Versionen berücksichtigt<br /> <br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog&diff=31057 DbLog 2019-07-29T10:53:41Z <p>Stephan: /* Datenbank */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Mit der Zeit entstehen in FHEM recht umfangreiche Log-Daten für die verschiedensten konfigurierten Devices. Die übliche Einstiegs-[[Konfiguration]] sieht vor, dass die Logs als {{Link2CmdRef|Lang=de|Anker=FileLog|Label=FileLog}} gespeichert werden - je nach Einstellung in wenigen sehr großen oder vielen kleineren Dateien. Der Datei-basierte Zugriff ist allerdings nicht wirklick performant und kann schnell zum Flaschenhals werden (z.B. bei der Darstellung von Graphen über einen längeren Zeitraum).<br /> <br /> Alternativ kann FHEM die Log-Daten mittels {{Link2CmdRef|Lang=de|Anker=DbLog|Label=DbLog}} in einer Datenbank speichern. Diese kann lokal als einfache SQLite- oder als zentrale Server-Datenbank (s.u.) gestaltet sein. Schon eine lokale einfache SQLite-Datenbank ist in der Regel deutlich performanter als File-basierte Logs.<br /> <br /> Damit eine Datenbank-Nutzung möglich ist, müssen folgende Anpassungen gemacht werden:<br /> # [[#Datenbank|Erstellen einer entsprechenden Datenbank]]<br /> # [[#Datenbank-Anbindung mittels db.conf|Konfiguration der Datenbank-Anbindung in FHEM]]<br /> # [[#Konfiguration als Device in fhem.cfg|Anpassen aller (oder einzelner) Konfigurationen von FileLog nach DbLog]]<br /> # [[#Anpassen der gplot-Konfigurationen|Ggf. Anpassen der gplot-Konfigurationen]]<br /> <br /> ;Hinweis:<br /> Reporting und Management von DbLog-Datenbankinhalten kann mit dem Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] stattfinden.<br /> <br /> == Konfiguration ==<br /> === Datenbank-Anbindung mittels db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MySQL-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Konfiguration als Device ===<br /> Das DbLog Device wird dann definiert mit<br /> :&lt;code&gt;define &lt;name&gt; DbLog &lt;configfilename&gt; &lt;regexp&gt; &lt;/code&gt;<br /> wobei ''&lt;configfilename&gt;'' dem Pfad zur zuvor angelegten db.conf entspricht.<br /> Ein Beispiel hierfür wäre:<br /> :&lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;<br /> Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit vielen teils irrelevanten Werten gefüllt wird. Man kann daher die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Dies ist in [[#Finetuning des Loggings]] beschrieben.<br /> <br /> Unbedingt beachten: bei Verwendung des Moduls configdb wird die Konfigurationsdatei aus der '''''Datenbank''''' gelesen. Deshalb ist es erforderlich, das File mittels &lt;code&gt;configdb fileimport db.conf &lt;/code&gt; vorher zu importieren !<br /> <br /> === Finetuning des Loggings ===<br /> Bei der Konfiguration des Log-Devices werden die zu loggenden Daten definiert - in der einfachsten Form sieht das so aus: &lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;. Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit sehr vielen und teils nicht benötigten Werten gefüllt wird und schnell wächst. Die Datenbank ist zwar deutlich leistungsfähiger, was große Datenmengen angeht, Datensparsamkeit kann aber schnell sinnvoll werden...<br /> <br /> Um das Log-Aufkommen einzugrenzen gibt es mehrere Ansätze:<br /> * Einschränkung über den &lt;code&gt;define&lt;/code&gt;-Eintrag<br /> * Einschränkung über DbLogExclude-Einträge der jeweiligen Devices<br /> * Einschränkung über DbLogInclude-Einträge des jeweiligen Devices<br /> * Ausschluß von Device/Reading-Kombinationen über das Attribut &quot;excludeDevs&quot;. Es können [https://fhem.de/commandref_DE.html#devspec devspec] verwendet werden. <br /> <br /> ==== Einschränkung über den zentralen &lt;code&gt;define&lt;/code&gt;-Eintrag ====<br /> Man kann die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Die erste Wildcard, also das erste &lt;code&gt;.*&lt;/code&gt;, entspricht dem in FHEM verwendeten Device-Namen. Die zweite Wildcard entspricht dem vom Device ausgegebenen zu loggenden Wert. Separiert werden beiden Angaben durch einen Doppelpunkt. <br /> <br /> Ein Beispiel, um zwar alle definierten Devices zu erfassen, aber nur die Werte Temperatur, Ventilposition und Luftfeuchte in die Datenbank zu schreiben wäre:<br /> :&lt;code&gt;define myDbLog DbLog ./db.conf .*:(temperature|valveposition|humidity).* &lt;/code&gt;<br /> <br /> ==== Einschränkung über die jeweiligen Devices ====<br /> Man kann die zu loggenden Werte für einzelne Devices separat einschränken, ohne dies im zentralen define-Eintrag machen zu müssen. Dies kann interessant sein, wenn beispielsweise ein Device Fehlerwerte meldet, die uninteressant sind, oder es meldet unnötig häufig Werte - beides ist z.B. bei 1-wire-Temperatursensoren gerne der Fall.<br /> <br /> Um das einzuschränken gibt es 2 Stellparameter, die als Attribute direkt zum jeweiligen Device konfiguriert werden:<br /> * DbLogExclude - definiert Werte, die nicht geloggt werden sollen<br /> * DbLogInclude - definiert Werte, die geloggt werden sollen ( siehe attr DbLogSelectionMode )<br /> * event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef|Lang=de|Anker=event-on-update-reading}})<br /> <br /> Eine konkrete Konfiguration für einen sehr gesprächigen 1-wire-Temperatursensor könnte wie folgt aussehen:<br /> &lt;pre&gt;<br /> define EG_Balkon GPIO4 BUSMASTER<br /> attr EG_Balkon DbLogExclude failures,T,85 # logge keine &quot;failures&quot;, &quot;T&quot;-Werte und &quot;85&quot;-Werte (default-Werte, wenn keine Temperatur gelesen werden kann)<br /> attr EG_Balkon event-on-change-reading state # logge nur, wenn sich ein Wert ändert (wenn sich die Temperatur nicht ändert, logge das nicht)<br /> attr EG_Balkon event-min-interval state:900 # logge spätestens alle 900sec = 15min<br /> attr EG_Balkon event-on-update-reading .* # logge alle Werte, die aktualisiert werden<br /> <br /> attr &lt;1-Wire-Device vom Typ OWTHERM oder OWSWITCH&gt; DbLogExclude data.* # verhindert das Logging der state-Eintragungen<br /> &lt;/pre&gt;<br /> <br /> Eine in diesem {{Link2Forum|Topic=33697|Message=264127}} vorgestellte Strategie zur Vermeidung unnötigen Loggings ist, dass bei der Definition von Devices durch das nachfolgende &lt;code&gt;notify&lt;/code&gt; automatisch ein DbLogExclude für alle Werte (.*) des Devices zugewiesen wird und dies nur bei Interesse an geloggten Werten gelöscht bzw. angepasst wird:<br /> &lt;code&gt;define nDbLogExclude notify global:DEFINED.* attr $EVTPART1 DbLogExclude .*&lt;/code&gt;<br /> <br /> Ebenso ist es mittlerweile möglich, lediglich erwünschte Werte (Positiv-Liste) zu loggen und alle anderen zu verwerfen. Hierfür wird im LogDevice das attribut DbLogSelectionMode Include verwendet. Nun kann für jedes Device mit DbLogInclude &lt;Reading1&gt;,&lt;Reading2&gt;,... angegeben werden, welche Readings geloggt werden sollen. <br /> Integriert ist ebenfalls ein &quot;min-interval&quot;, siehe {{Link2CmdRef}}.<br /> <br /> == Datenbank ==<br /> Unterstützte Datenbanksysteme (Auswahl):<br /> * Sqlite<br /> * MySQL<br /> * PostGreSql<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen &quot;fhem&quot; an.<br /> <br /> ==== current ====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== history ====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> {{Todo|Ausbauen}}<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog&diff=31056 DbLog 2019-07-29T10:50:39Z <p>Stephan: /* Datenbank */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Mit der Zeit entstehen in FHEM recht umfangreiche Log-Daten für die verschiedensten konfigurierten Devices. Die übliche Einstiegs-[[Konfiguration]] sieht vor, dass die Logs als {{Link2CmdRef|Lang=de|Anker=FileLog|Label=FileLog}} gespeichert werden - je nach Einstellung in wenigen sehr großen oder vielen kleineren Dateien. Der Datei-basierte Zugriff ist allerdings nicht wirklick performant und kann schnell zum Flaschenhals werden (z.B. bei der Darstellung von Graphen über einen längeren Zeitraum).<br /> <br /> Alternativ kann FHEM die Log-Daten mittels {{Link2CmdRef|Lang=de|Anker=DbLog|Label=DbLog}} in einer Datenbank speichern. Diese kann lokal als einfache SQLite- oder als zentrale Server-Datenbank (s.u.) gestaltet sein. Schon eine lokale einfache SQLite-Datenbank ist in der Regel deutlich performanter als File-basierte Logs.<br /> <br /> Damit eine Datenbank-Nutzung möglich ist, müssen folgende Anpassungen gemacht werden:<br /> # [[#Datenbank|Erstellen einer entsprechenden Datenbank]]<br /> # [[#Datenbank-Anbindung mittels db.conf|Konfiguration der Datenbank-Anbindung in FHEM]]<br /> # [[#Konfiguration als Device in fhem.cfg|Anpassen aller (oder einzelner) Konfigurationen von FileLog nach DbLog]]<br /> # [[#Anpassen der gplot-Konfigurationen|Ggf. Anpassen der gplot-Konfigurationen]]<br /> <br /> ;Hinweis:<br /> Reporting und Management von DbLog-Datenbankinhalten kann mit dem Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] stattfinden.<br /> <br /> == Konfiguration ==<br /> === Datenbank-Anbindung mittels db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MySQL-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Konfiguration als Device ===<br /> Das DbLog Device wird dann definiert mit<br /> :&lt;code&gt;define &lt;name&gt; DbLog &lt;configfilename&gt; &lt;regexp&gt; &lt;/code&gt;<br /> wobei ''&lt;configfilename&gt;'' dem Pfad zur zuvor angelegten db.conf entspricht.<br /> Ein Beispiel hierfür wäre:<br /> :&lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;<br /> Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit vielen teils irrelevanten Werten gefüllt wird. Man kann daher die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Dies ist in [[#Finetuning des Loggings]] beschrieben.<br /> <br /> Unbedingt beachten: bei Verwendung des Moduls configdb wird die Konfigurationsdatei aus der '''''Datenbank''''' gelesen. Deshalb ist es erforderlich, das File mittels &lt;code&gt;configdb fileimport db.conf &lt;/code&gt; vorher zu importieren !<br /> <br /> === Finetuning des Loggings ===<br /> Bei der Konfiguration des Log-Devices werden die zu loggenden Daten definiert - in der einfachsten Form sieht das so aus: &lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;. Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit sehr vielen und teils nicht benötigten Werten gefüllt wird und schnell wächst. Die Datenbank ist zwar deutlich leistungsfähiger, was große Datenmengen angeht, Datensparsamkeit kann aber schnell sinnvoll werden...<br /> <br /> Um das Log-Aufkommen einzugrenzen gibt es mehrere Ansätze:<br /> * Einschränkung über den &lt;code&gt;define&lt;/code&gt;-Eintrag<br /> * Einschränkung über DbLogExclude-Einträge der jeweiligen Devices<br /> * Einschränkung über DbLogInclude-Einträge des jeweiligen Devices<br /> * Ausschluß von Device/Reading-Kombinationen über das Attribut &quot;excludeDevs&quot;. Es können [https://fhem.de/commandref_DE.html#devspec devspec] verwendet werden. <br /> <br /> ==== Einschränkung über den zentralen &lt;code&gt;define&lt;/code&gt;-Eintrag ====<br /> Man kann die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Die erste Wildcard, also das erste &lt;code&gt;.*&lt;/code&gt;, entspricht dem in FHEM verwendeten Device-Namen. Die zweite Wildcard entspricht dem vom Device ausgegebenen zu loggenden Wert. Separiert werden beiden Angaben durch einen Doppelpunkt. <br /> <br /> Ein Beispiel, um zwar alle definierten Devices zu erfassen, aber nur die Werte Temperatur, Ventilposition und Luftfeuchte in die Datenbank zu schreiben wäre:<br /> :&lt;code&gt;define myDbLog DbLog ./db.conf .*:(temperature|valveposition|humidity).* &lt;/code&gt;<br /> <br /> ==== Einschränkung über die jeweiligen Devices ====<br /> Man kann die zu loggenden Werte für einzelne Devices separat einschränken, ohne dies im zentralen define-Eintrag machen zu müssen. Dies kann interessant sein, wenn beispielsweise ein Device Fehlerwerte meldet, die uninteressant sind, oder es meldet unnötig häufig Werte - beides ist z.B. bei 1-wire-Temperatursensoren gerne der Fall.<br /> <br /> Um das einzuschränken gibt es 2 Stellparameter, die als Attribute direkt zum jeweiligen Device konfiguriert werden:<br /> * DbLogExclude - definiert Werte, die nicht geloggt werden sollen<br /> * DbLogInclude - definiert Werte, die geloggt werden sollen ( siehe attr DbLogSelectionMode )<br /> * event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef|Lang=de|Anker=event-on-update-reading}})<br /> <br /> Eine konkrete Konfiguration für einen sehr gesprächigen 1-wire-Temperatursensor könnte wie folgt aussehen:<br /> &lt;pre&gt;<br /> define EG_Balkon GPIO4 BUSMASTER<br /> attr EG_Balkon DbLogExclude failures,T,85 # logge keine &quot;failures&quot;, &quot;T&quot;-Werte und &quot;85&quot;-Werte (default-Werte, wenn keine Temperatur gelesen werden kann)<br /> attr EG_Balkon event-on-change-reading state # logge nur, wenn sich ein Wert ändert (wenn sich die Temperatur nicht ändert, logge das nicht)<br /> attr EG_Balkon event-min-interval state:900 # logge spätestens alle 900sec = 15min<br /> attr EG_Balkon event-on-update-reading .* # logge alle Werte, die aktualisiert werden<br /> <br /> attr &lt;1-Wire-Device vom Typ OWTHERM oder OWSWITCH&gt; DbLogExclude data.* # verhindert das Logging der state-Eintragungen<br /> &lt;/pre&gt;<br /> <br /> Eine in diesem {{Link2Forum|Topic=33697|Message=264127}} vorgestellte Strategie zur Vermeidung unnötigen Loggings ist, dass bei der Definition von Devices durch das nachfolgende &lt;code&gt;notify&lt;/code&gt; automatisch ein DbLogExclude für alle Werte (.*) des Devices zugewiesen wird und dies nur bei Interesse an geloggten Werten gelöscht bzw. angepasst wird:<br /> &lt;code&gt;define nDbLogExclude notify global:DEFINED.* attr $EVTPART1 DbLogExclude .*&lt;/code&gt;<br /> <br /> Ebenso ist es mittlerweile möglich, lediglich erwünschte Werte (Positiv-Liste) zu loggen und alle anderen zu verwerfen. Hierfür wird im LogDevice das attribut DbLogSelectionMode Include verwendet. Nun kann für jedes Device mit DbLogInclude &lt;Reading1&gt;,&lt;Reading2&gt;,... angegeben werden, welche Readings geloggt werden sollen. <br /> Integriert ist ebenfalls ein &quot;min-interval&quot;, siehe {{Link2CmdRef}}.<br /> <br /> == Datenbank ==<br /> Unterstützte Datenbanksysteme (Auswahl):<br /> * Sqlite<br /> * [[DbLog-MySQL|MySQL]]<br /> * PostGreSql<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen &quot;fhem&quot; an.<br /> <br /> ==== current ====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== history ====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> {{Todo|Ausbauen}}<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31055 DbLog-MySQL 2019-07-29T10:49:19Z <p>Stephan: /* phpMyAdmin */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === phpMyAdmin ===<br /> Ein sehr beliebtes Tool ist phpMyAdmin. <br /> # apt-get install phpMyAdmin<br /> Bei der Installation wird man nach einem Passwort für den User &quot;phpMyAdmin&quot; gefragt, der im weiteren Verlauf erstmal nutzlos ist.<br /> Nun kann man sich unter &lt;meine-fhem-Domain&gt;/phpMyAdmin mit der Seite verbinden.<br /> Zum einloggen kann nun der in der config-datei angegebene fhemuser mit dem fhempasswort verwendet werden, oder, sofern ein Passwort vergeben ist, auch den User root. <br /> Der Unterschied liegt darin, dass root *alle* Datenbanken sehen und ändern darf (was zum ändern von Datenbankeigenschaften sowie Benutzerkonten notwendig ist), während dem fhemuser nur die fhemdatenbank angezeigt wird(was für suchabfragen, deletes und inserts sowie Tabellenänderungen völlig ausreicht.<br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. <br /> Zur Ermittlung der MariaDB-Größe kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31054 DbLog-MySQL 2019-07-29T10:49:04Z <p>Stephan: /* Bearbeitung von Datenbank-Einträgen */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === phpMyAdmin ===<br /> Ein sehr beliebtes Tool ist phpMyAdmin. <br /> # apt-get install phpMyAdmin<br /> Bei der Installation wird man nach einem Passwort für den User &quot;phpMyAdmin&quot; gefragt, der im weiteren Verlauf erstmal nutzlos ist.<br /> Nun kann man sich unter &lt;meine-fhem-Domain&gt;/phpMyAdmin mit der Seite verbinden.<br /> Zum einloggen kann nun der in der config-datei angegebene fhemuser mit dem fhempasswort verwendet werden, oder, sofern ein Passwort vergeben ist, auch den User root. <br /> Der Unterschied liegt darin, dass root *alle* Datenbanken sehen und ändern darf (was zum ändern von Datenbankeigenschaften sowie Benutzerkonten notwendig ist), während dem fhemuser nur die fhemdatenbank angezeigt wird(was für suchabfragen, deletes und inserts sowie Tabellenänderungen völlig ausreicht.<br /> <br /> Für die<br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. <br /> Zur Ermittlung der MariaDB-Größe kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31053 DbLog-MySQL 2019-07-29T10:44:00Z <p>Stephan: /* Performance-Optimierung */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. <br /> Zur Ermittlung der MariaDB-Größe kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31052 DbLog-MySQL 2019-07-29T10:43:42Z <p>Stephan: /* Datenbank reparieren */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. <br /> Zur Ermittlung der MariaDB-Größe kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31051 DbLog-MySQL 2019-07-29T09:37:24Z <p>Stephan: /* Dateigrösse mitloggen */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. <br /> Zur Ermittlung der MariaDB-Größe kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31050 DbLog-MySQL 2019-07-29T09:35:13Z <p>Stephan: /* SQLite-Datenbanken */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31049 DbLog-MySQL 2019-07-29T09:34:24Z <p>Stephan: /* Werte auslesen */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31048 DbLog-MySQL 2019-07-29T09:32:27Z <p>Stephan: /* Integration von DBLog in eigene Module */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31047 DbLog-MySQL 2019-07-29T09:18:02Z <p>Stephan: /* Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Unter Ubuntu/debian: <br /> # apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Nach der Installation muss das Script <br /> # mysql_secure_installation<br /> ausgeführt werden. Dieses legt ein root-Passwort fest, entfernt die anonymen User und entfernt die test-Datenbank.<br /> Empfohlen wird, alle Fragen mit '''Y''' zu beantworten.<br /> <br /> Zum Test mit MariaDB verbinden:<br /> # mysql -u root -p<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen:<br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> Enter password:<br /> MariaDB [(none)]&gt; exit<br /> <br /> Jetzt kann man den Zugang als fhemuser testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> MariaDB [(none)]&gt; show databases;<br /> <br /> &lt;&lt; Ergebnis Show Databases einfügen &gt;&gt;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden.<br /> Um die Tabellen zu sehen, kann man den folgenden Befehl eingeben: <br /> <br /> MariaDB [(none)]&gt; show tables;<br /> <br /> &lt;&lt; Ergebnis Show tables einfügen &gt;&gt;<br /> , die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31046 DbLog-MySQL 2019-07-29T08:03:10Z <p>Stephan: /* Beispiel: Anlegen und Nutzung einer Mysql-Datenbank */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer MariaDB-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mariadb-server<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der Shell-Prompt und &quot;mysql&gt;&quot; der MariaDB-Prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit MariaDB verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31045 DbLog-MySQL 2019-07-29T06:50:20Z <p>Stephan: /* Beispiel: Anlegen und Nutzung einer SQLite-Datenbank */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31044 DbLog-MySQL 2019-07-29T06:49:55Z <p>Stephan: /* Anpassen der gplot-Konfigurationen */ gelöscht</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31043 DbLog-MySQL 2019-07-29T06:49:13Z <p>Stephan: /* Datenbank */ Anpassung auf mysql</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Im Verzeichnis '''contrib/dblog''' befindet sich das Script '''db_create_mysql.sql''' , welches eine neue Datenbank samt Tabellenstruktur anlegt. Ausserdem wird ein Benutzer &quot;fhemuser&quot; mit einem (zu ändernden) &quot;fhempasswort&quot; angelegt.<br /> ==== Primary Keys ====<br /> ===== current =====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ===== history =====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`history` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`TIMESTAMP`,`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31042 DbLog-MySQL 2019-07-29T06:44:10Z <p>Stephan: /* Konfiguration */ Anpassung auf MariaDB</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Server version: 10.1.40-MariaDB-0ubuntu0.18.04.1 Ubuntu 18.04 ==<br /> === db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MariaDB-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp. Bei der Verwendung von MariaDB muss die MySQL-Datei verwendet werden.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> == Datenbank ==<br /> Unterstützte Datenbanksysteme (Auswahl):<br /> * Sqlite<br /> * MySQL<br /> * PostGreSql<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen &quot;fhem&quot; an.<br /> <br /> ==== current ====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== history ====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> {{Todo|Ausbauen}}<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31041 DbLog-MySQL 2019-07-29T06:32:27Z <p>Stephan: /* Einleitung */ Anpassung auf MySQL</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Da bei der Inbetriebnahme und der Migration von MySQL bzw MariaDB-Datenbanken einige kleine Fallen auftreten können, gibt's hier ein paar Hinweise.<br /> <br /> == Konfiguration ==<br /> === Datenbank-Anbindung mittels db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MySQL-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Konfiguration als Device ===<br /> Das DbLog Device wird dann definiert mit<br /> :&lt;code&gt;define &lt;name&gt; DbLog &lt;configfilename&gt; &lt;regexp&gt; &lt;/code&gt;<br /> wobei ''&lt;configfilename&gt;'' dem Pfad zur zuvor angelegten db.conf entspricht.<br /> Ein Beispiel hierfür wäre:<br /> :&lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;<br /> Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit vielen teils irrelevanten Werten gefüllt wird. Man kann daher die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Dies ist in [[#Finetuning des Loggings]] beschrieben.<br /> <br /> Unbedingt beachten: bei Verwendung des Moduls configdb wird die Konfigurationsdatei aus der '''''Datenbank''''' gelesen. Deshalb ist es erforderlich, das File mittels &lt;code&gt;configdb fileimport db.conf &lt;/code&gt; vorher zu importieren !<br /> <br /> === Finetuning des Loggings ===<br /> Bei der Konfiguration des Log-Devices werden die zu loggenden Daten definiert - in der einfachsten Form sieht das so aus: &lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;. Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit sehr vielen und teils nicht benötigten Werten gefüllt wird und schnell wächst. Die Datenbank ist zwar deutlich leistungsfähiger, was große Datenmengen angeht, Datensparsamkeit kann aber schnell sinnvoll werden...<br /> <br /> Um das Log-Aufkommen einzugrenzen gibt es mehrere Ansätze:<br /> * Einschränkung über den &lt;code&gt;define&lt;/code&gt;-Eintrag<br /> * Einschränkung über DbLogExclude-Einträge der jeweiligen Devices<br /> * Einschränkung über DbLogInclude-Einträge des jeweiligen Devices<br /> * Ausschluß von Device/Reading-Kombinationen über das Attribut &quot;excludeDevs&quot;. Es können [https://fhem.de/commandref_DE.html#devspec devspec] verwendet werden. <br /> <br /> ==== Einschränkung über den zentralen &lt;code&gt;define&lt;/code&gt;-Eintrag ====<br /> Man kann die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Die erste Wildcard, also das erste &lt;code&gt;.*&lt;/code&gt;, entspricht dem in FHEM verwendeten Device-Namen. Die zweite Wildcard entspricht dem vom Device ausgegebenen zu loggenden Wert. Separiert werden beiden Angaben durch einen Doppelpunkt. <br /> <br /> Ein Beispiel, um zwar alle definierten Devices zu erfassen, aber nur die Werte Temperatur, Ventilposition und Luftfeuchte in die Datenbank zu schreiben wäre:<br /> :&lt;code&gt;define myDbLog DbLog ./db.conf .*:(temperature|valveposition|humidity).* &lt;/code&gt;<br /> <br /> ==== Einschränkung über die jeweiligen Devices ====<br /> Man kann die zu loggenden Werte für einzelne Devices separat einschränken, ohne dies im zentralen define-Eintrag machen zu müssen. Dies kann interessant sein, wenn beispielsweise ein Device Fehlerwerte meldet, die uninteressant sind, oder es meldet unnötig häufig Werte - beides ist z.B. bei 1-wire-Temperatursensoren gerne der Fall.<br /> <br /> Um das einzuschränken gibt es 2 Stellparameter, die als Attribute direkt zum jeweiligen Device konfiguriert werden:<br /> * DbLogExclude - definiert Werte, die nicht geloggt werden sollen<br /> * DbLogInclude - definiert Werte, die geloggt werden sollen ( siehe attr DbLogSelectionMode )<br /> * event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef|Lang=de|Anker=event-on-update-reading}})<br /> <br /> Eine konkrete Konfiguration für einen sehr gesprächigen 1-wire-Temperatursensor könnte wie folgt aussehen:<br /> &lt;pre&gt;<br /> define EG_Balkon GPIO4 BUSMASTER<br /> attr EG_Balkon DbLogExclude failures,T,85 # logge keine &quot;failures&quot;, &quot;T&quot;-Werte und &quot;85&quot;-Werte (default-Werte, wenn keine Temperatur gelesen werden kann)<br /> attr EG_Balkon event-on-change-reading state # logge nur, wenn sich ein Wert ändert (wenn sich die Temperatur nicht ändert, logge das nicht)<br /> attr EG_Balkon event-min-interval state:900 # logge spätestens alle 900sec = 15min<br /> attr EG_Balkon event-on-update-reading .* # logge alle Werte, die aktualisiert werden<br /> <br /> attr &lt;1-Wire-Device vom Typ OWTHERM oder OWSWITCH&gt; DbLogExclude data.* # verhindert das Logging der state-Eintragungen<br /> &lt;/pre&gt;<br /> <br /> Eine in diesem {{Link2Forum|Topic=33697|Message=264127}} vorgestellte Strategie zur Vermeidung unnötigen Loggings ist, dass bei der Definition von Devices durch das nachfolgende &lt;code&gt;notify&lt;/code&gt; automatisch ein DbLogExclude für alle Werte (.*) des Devices zugewiesen wird und dies nur bei Interesse an geloggten Werten gelöscht bzw. angepasst wird:<br /> &lt;code&gt;define nDbLogExclude notify global:DEFINED.* attr $EVTPART1 DbLogExclude .*&lt;/code&gt;<br /> <br /> Ebenso ist es mittlerweile möglich, lediglich erwünschte Werte (Positiv-Liste) zu loggen und alle anderen zu verwerfen. Hierfür wird im LogDevice das attribut DbLogSelectionMode Include verwendet. Nun kann für jedes Device mit DbLogInclude &lt;Reading1&gt;,&lt;Reading2&gt;,... angegeben werden, welche Readings geloggt werden sollen. <br /> Integriert ist ebenfalls ein &quot;min-interval&quot;, siehe {{Link2CmdRef}}.<br /> <br /> == Datenbank ==<br /> Unterstützte Datenbanksysteme (Auswahl):<br /> * Sqlite<br /> * MySQL<br /> * PostGreSql<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen &quot;fhem&quot; an.<br /> <br /> ==== current ====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== history ====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> {{Todo|Ausbauen}}<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=DbLog-MySQL&diff=31040 DbLog-MySQL 2019-07-29T06:26:08Z <p>Stephan: Kopie der DbLog-Seite</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Protokolliert Ereignisse in einer Datenbank<br /> |ModType=h<br /> |ModForumArea=Automatisierung<br /> |ModTechName=93_DbLog.pm<br /> |ModOwner=tobiasfaust ({{Link2FU|118|Forum}}/[[Benutzer Diskussion:Tobias.faust|Wiki]])&lt;br /&gt;DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])<br /> }}<br /> <br /> == Einleitung ==<br /> Mit der Zeit entstehen in FHEM recht umfangreiche Log-Daten für die verschiedensten konfigurierten Devices. Die übliche Einstiegs-[[Konfiguration]] sieht vor, dass die Logs als {{Link2CmdRef|Lang=de|Anker=FileLog|Label=FileLog}} gespeichert werden - je nach Einstellung in wenigen sehr großen oder vielen kleineren Dateien. Der Datei-basierte Zugriff ist allerdings nicht wirklick performant und kann schnell zum Flaschenhals werden (z.B. bei der Darstellung von Graphen über einen längeren Zeitraum).<br /> <br /> Alternativ kann FHEM die Log-Daten mittels {{Link2CmdRef|Lang=de|Anker=DbLog|Label=DbLog}} in einer Datenbank speichern. Diese kann lokal als einfache SQLite- oder als zentrale Server-Datenbank (s.u.) gestaltet sein. Schon eine lokale einfache SQLite-Datenbank ist in der Regel deutlich performanter als File-basierte Logs.<br /> <br /> Damit eine Datenbank-Nutzung möglich ist, müssen folgende Anpassungen gemacht werden:<br /> # [[#Datenbank|Erstellen einer entsprechenden Datenbank]]<br /> # [[#Datenbank-Anbindung mittels db.conf|Konfiguration der Datenbank-Anbindung in FHEM]]<br /> # [[#Konfiguration als Device in fhem.cfg|Anpassen aller (oder einzelner) Konfigurationen von FileLog nach DbLog]]<br /> # [[#Anpassen der gplot-Konfigurationen|Ggf. Anpassen der gplot-Konfigurationen]]<br /> <br /> ;Hinweis:<br /> Reporting und Management von DbLog-Datenbankinhalten kann mit dem Modul [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] stattfinden.<br /> <br /> == Konfiguration ==<br /> === Datenbank-Anbindung mittels db.conf ===<br /> DbLog wird durch 2 verschiedene Einträge aktiviert/definiert. In einer Datei namens '''db.conf''' werden die Parameter für eine Verbindung zur Datenbank (host, username, password, etc.) hinterlegt. Diese Datei kann in einem beliebigen Verzeichnis angelegt werden. Für eine MySQL-Datenbank sieht die db.conf folgendermaßen aus:<br /> <br /> %dbconfig= (<br /> connection =&gt; &quot;mysql:database=fhem;host=db;port=3306&quot;,<br /> user =&gt; &quot;fhemuser&quot;,<br /> password =&gt; &quot;fhempassword&quot;,<br /> );<br /> <br /> Im Verzeichnis '''contrib/dblog''' der FHEM-Installation befindet sich eine Beispielkonfiguration mit der Syntax für jeden unterstützen Datenbanktyp.<br /> Es wird empfohlen diese Datei zu kopieren und erst dann entsprechend zu bearbeiten. Am Besten kopiert man diese Datei in das FHEM Home Directory /opt/fhem/ und achtet auf die entsprechenden Rechte!<br /> chown fhem:dialout /opt/fhem/db.conf<br /> <br /> === Konfiguration als Device ===<br /> Das DbLog Device wird dann definiert mit<br /> :&lt;code&gt;define &lt;name&gt; DbLog &lt;configfilename&gt; &lt;regexp&gt; &lt;/code&gt;<br /> wobei ''&lt;configfilename&gt;'' dem Pfad zur zuvor angelegten db.conf entspricht.<br /> Ein Beispiel hierfür wäre:<br /> :&lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;<br /> Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit vielen teils irrelevanten Werten gefüllt wird. Man kann daher die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Dies ist in [[#Finetuning des Loggings]] beschrieben.<br /> <br /> Unbedingt beachten: bei Verwendung des Moduls configdb wird die Konfigurationsdatei aus der '''''Datenbank''''' gelesen. Deshalb ist es erforderlich, das File mittels &lt;code&gt;configdb fileimport db.conf &lt;/code&gt; vorher zu importieren !<br /> <br /> === Finetuning des Loggings ===<br /> Bei der Konfiguration des Log-Devices werden die zu loggenden Daten definiert - in der einfachsten Form sieht das so aus: &lt;code&gt;define logdb DbLog ./db.conf .*:.* &lt;/code&gt;. Die Angabe von &lt;code&gt;.*:.*&lt;/code&gt; bedeutet, dass sämtliche DeviceMessages (Messwerte, Batteriestatus, KeepAlives, etc.) in die Datenbank geschrieben werden. Dies führt u.U. dazu, dass die Datenbank auch mit sehr vielen und teils nicht benötigten Werten gefüllt wird und schnell wächst. Die Datenbank ist zwar deutlich leistungsfähiger, was große Datenmengen angeht, Datensparsamkeit kann aber schnell sinnvoll werden...<br /> <br /> Um das Log-Aufkommen einzugrenzen gibt es mehrere Ansätze:<br /> * Einschränkung über den &lt;code&gt;define&lt;/code&gt;-Eintrag<br /> * Einschränkung über DbLogExclude-Einträge der jeweiligen Devices<br /> * Einschränkung über DbLogInclude-Einträge des jeweiligen Devices<br /> * Ausschluß von Device/Reading-Kombinationen über das Attribut &quot;excludeDevs&quot;. Es können [https://fhem.de/commandref_DE.html#devspec devspec] verwendet werden. <br /> <br /> ==== Einschränkung über den zentralen &lt;code&gt;define&lt;/code&gt;-Eintrag ====<br /> Man kann die zu loggenden Werte einschränken, indem man genau angibt welche Werte übertragen werden sollen. Die erste Wildcard, also das erste &lt;code&gt;.*&lt;/code&gt;, entspricht dem in FHEM verwendeten Device-Namen. Die zweite Wildcard entspricht dem vom Device ausgegebenen zu loggenden Wert. Separiert werden beiden Angaben durch einen Doppelpunkt. <br /> <br /> Ein Beispiel, um zwar alle definierten Devices zu erfassen, aber nur die Werte Temperatur, Ventilposition und Luftfeuchte in die Datenbank zu schreiben wäre:<br /> :&lt;code&gt;define myDbLog DbLog ./db.conf .*:(temperature|valveposition|humidity).* &lt;/code&gt;<br /> <br /> ==== Einschränkung über die jeweiligen Devices ====<br /> Man kann die zu loggenden Werte für einzelne Devices separat einschränken, ohne dies im zentralen define-Eintrag machen zu müssen. Dies kann interessant sein, wenn beispielsweise ein Device Fehlerwerte meldet, die uninteressant sind, oder es meldet unnötig häufig Werte - beides ist z.B. bei 1-wire-Temperatursensoren gerne der Fall.<br /> <br /> Um das einzuschränken gibt es 2 Stellparameter, die als Attribute direkt zum jeweiligen Device konfiguriert werden:<br /> * DbLogExclude - definiert Werte, die nicht geloggt werden sollen<br /> * DbLogInclude - definiert Werte, die geloggt werden sollen ( siehe attr DbLogSelectionMode )<br /> * event-min-interval, event-on-change-reading und event-on-update-reading beeinflussen, wie häufig Werte geloggt werden (vgl. {{Link2CmdRef|Lang=de|Anker=event-on-update-reading}})<br /> <br /> Eine konkrete Konfiguration für einen sehr gesprächigen 1-wire-Temperatursensor könnte wie folgt aussehen:<br /> &lt;pre&gt;<br /> define EG_Balkon GPIO4 BUSMASTER<br /> attr EG_Balkon DbLogExclude failures,T,85 # logge keine &quot;failures&quot;, &quot;T&quot;-Werte und &quot;85&quot;-Werte (default-Werte, wenn keine Temperatur gelesen werden kann)<br /> attr EG_Balkon event-on-change-reading state # logge nur, wenn sich ein Wert ändert (wenn sich die Temperatur nicht ändert, logge das nicht)<br /> attr EG_Balkon event-min-interval state:900 # logge spätestens alle 900sec = 15min<br /> attr EG_Balkon event-on-update-reading .* # logge alle Werte, die aktualisiert werden<br /> <br /> attr &lt;1-Wire-Device vom Typ OWTHERM oder OWSWITCH&gt; DbLogExclude data.* # verhindert das Logging der state-Eintragungen<br /> &lt;/pre&gt;<br /> <br /> Eine in diesem {{Link2Forum|Topic=33697|Message=264127}} vorgestellte Strategie zur Vermeidung unnötigen Loggings ist, dass bei der Definition von Devices durch das nachfolgende &lt;code&gt;notify&lt;/code&gt; automatisch ein DbLogExclude für alle Werte (.*) des Devices zugewiesen wird und dies nur bei Interesse an geloggten Werten gelöscht bzw. angepasst wird:<br /> &lt;code&gt;define nDbLogExclude notify global:DEFINED.* attr $EVTPART1 DbLogExclude .*&lt;/code&gt;<br /> <br /> Ebenso ist es mittlerweile möglich, lediglich erwünschte Werte (Positiv-Liste) zu loggen und alle anderen zu verwerfen. Hierfür wird im LogDevice das attribut DbLogSelectionMode Include verwendet. Nun kann für jedes Device mit DbLogInclude &lt;Reading1&gt;,&lt;Reading2&gt;,... angegeben werden, welche Readings geloggt werden sollen. <br /> Integriert ist ebenfalls ein &quot;min-interval&quot;, siehe {{Link2CmdRef}}.<br /> <br /> == Datenbank ==<br /> Unterstützte Datenbanksysteme (Auswahl):<br /> * Sqlite<br /> * MySQL<br /> * PostGreSql<br /> <br /> === Tabellen ===<br /> Die Datenbank ist relativ simpel gestaltet und besteht lediglich aus den folgenden beiden Tabellen:<br /> * current<br /> * history<br /> <br /> DbLog ist auf eine feste Tabellenstruktur angewiesen. Man muss daher in seiner Datenbank eine Tabelle mit folgenden Spalten anlegen:<br /> {| class=&quot;wikitable&quot;<br /> |-<br /> ! Spalte<br /> ! Beschreibung (en)<br /> ! Beschreibung (de)<br /> ! Beispiel<br /> |-<br /> | '''TIMESTAMP'''<br /> | timestamp of event<br /> | Zeitstempel<br /> | 2007-12-30 21:45:22 <br /> |-<br /> | '''DEVICE'''<br /> | device name<br /> | Device-Name<br /> | Wetterstation<br /> |-<br /> | '''TYPE'''<br /> | device type<br /> | Device-Typ<br /> | KS300<br /> |-<br /> | '''EVENT'''<br /> | event specification as full string<br /> | Eventspezifikation als Text<br /> | humidity: 71 (%)<br /> |-<br /> | '''READING'''<br /> | name of reading extracted from event<br /> | Bezeichnung des Readings<br /> | humidity<br /> |-<br /> | '''VALUE'''<br /> | actual reading extracted from event<br /> | Wert des Readings<br /> | 71<br /> |-<br /> | '''UNIT'''<br /> | unit extracted from event<br /> | Einheit des Readings<br /> | %<br /> |-<br /> |}<br /> <br /> Die Vorlagen zur Anlage von Tabellen und Indizes sind für jeden unterstützten Datenbanktyp im Verzeichnis '''contrib/dblog''' der FHEM-Installation, oder hier zu finden: [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/dblog/ Link]. Das MySQL-Skript (db_create_mysql.sql) legt eine neue Datenbank, das PostGres-Skript (db_create_postgresql.sql) ein neues Schema mit Namen &quot;fhem&quot; an.<br /> <br /> ==== current ====<br /> Die Tabelle current enthält für jedes zu loggende Device lediglich den letzten Wert. Falls noch kein Wert geloggt wurde, ist diese Tabelle leer. <br /> Falls der Inhalt gelöscht wird, bauen sich die Daten automatisch wieder auf. Es gehen durch das löschen der Tabelle current keine Log-Informationen verloren.<br /> Der Inhalt wird aber u.a. für die Dropdown-Felder beim Plot-Editor verwendet.<br /> <br /> Um doppelte Einträge in der Tabelle zu vermeiden, wurden die Möglichkeit geschaffen Primary Keys zu definieren. Da in der Spalte &lt;code&gt;READING&lt;/code&gt; u.U. bei verschiedenen Geräten gleiche Namen vorkommen können, sollte der Primary Key um den Gerätenamen erweitert werden. Der Primary Key sollte also aus &lt;code&gt;DEVICE&lt;/code&gt; und &lt;code&gt;READING&lt;/code&gt; bestehen. Um in der Datenbank ''fhem'' diesen PK zu setzen, kann folgender SQL Code verwendet werden:<br /> <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> ALTER TABLE `fhem`.`current` <br /> CHANGE COLUMN `DEVICE` `DEVICE` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> CHANGE COLUMN `READING` `READING` VARCHAR(64) CHARACTER SET 'utf8' COLLATE 'utf8_bin' NOT NULL ,<br /> ADD PRIMARY KEY (`DEVICE`, `READING`);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> ==== history ====<br /> Die Tabelle history enthält alle bisher geloggten Daten. Löschen in dieser Tabelle bedeutet automatisch Datenverlust (gewollt oder nicht ... )<br /> Der Inhalt dieser Tabelle wird verwendet, um die Plots zu zeichnen oder Auswertungen mit [https://wiki.fhem.de/wiki/DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten DbRep] anzufertigen<br /> <br /> {{Todo|Ausbauen}}<br /> <br /> Um Problem beim Import von cacheFiles zu vermeiden, kann in der Datenbank ein PK angelegt werden, welcher Timestamp, Device und Reading umfasst. Dadurch werden doppelte Einträge wirksam verhindert.<br /> <br /> == Anpassen der gplot-Konfigurationen ==<br /> Die meisten gplot-Konfigurationen sind bisher lediglich auf FileLog-Konfigurationen ausgelegt. Deshalb müssen sie für die Verwendung mit DbLog angepasst werden. Glücklicherweise beschränkt sich dies auf die reinen FileLog-Zeilen - es müssen die DbLog-Äquivalente hinzugefügt werden. Die FileLog-Einträge müssen zwar nicht gelöscht werden, wenn man aber FileLog und DbLog parallel betreibt, sollte man getrennte gplot-Dateien für beide Logging-Typen haben um Auswertungsprobleme erkennen zu können.<br /> <br /> Für die fht.gplot Konfiguration sähe die Anpassung wie folgt aus (lediglich die vier DbLog-Zeilen wurden hinzugefügt):<br /> &lt;pre&gt;<br /> # Created by FHEM/98_SVG.pm, 2014-12-25 21:53:30<br /> set terminal png transparent size &lt;SIZE&gt; crop<br /> set output '&lt;OUT&gt;.png'<br /> set xdata time<br /> set timefmt &quot;%Y-%m-%d_%H:%M:%S&quot;<br /> set xlabel &quot; &quot;<br /> set title '&lt;L1&gt;'<br /> set ytics nomirror<br /> set y2tics <br /> set grid y2tics<br /> set ylabel &quot;Actuator/Window (%)&quot;<br /> set y2label &quot;Temperature in C&quot;<br /> set yrange 0:100<br /> set y2range 5:25<br /> <br /> #FileLog 4:.measured-temp\x3a:0:<br /> #FileLog 4:.actuator\x3a:0:int<br /> #FileLog 4:.desired-temp::<br /> #FileLog 4:.window\x3a::<br /> <br /> #DbLog &lt;SPEC1&gt;:.measured-temp:0:<br /> #DbLog &lt;SPEC1&gt;:.actuator:0:int<br /> #DbLog &lt;SPEC1&gt;:.desired-temp::<br /> #DbLog &lt;SPEC1&gt;:.window::<br /> <br /> plot &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Measured temperature' ls l0 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Actuator (%)' ls l1 lw 1 with lines,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y2 title 'Desired Temperature' ls l2 lw 1 with steps,\<br /> &quot;&lt;IN&gt;&quot; using 1:2 axes x1y1 title 'Window' ls l3 lw 1 with steps<br /> &lt;/pre&gt;<br /> <br /> Des Weiteren ist zu beachten: <br /> <br /> On-Off-Plots<br /> <br /> EG_Bad:window:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:0/eg<br /> <br /> unter Berücksichtigung von dim-Werten:<br /> <br /> EG_WoZi_Licht:value:::$val=~s/(on|off)(\d*).*/$1eq&quot;on&quot;?1:($1eq&quot;dim&quot;?$2*0.01:0)/eg<br /> <br /> == Beispiel: Anlegen und Nutzung einer SQLite-Datenbank ==<br /> Im folgenden wird eine lokale SQLite-Datenbank auf einen Ubuntu-System angelegt (nach Quelle: [http://www.tatsch-it.de/fhem-dblog/ http://www.tatsch-it.de/fhem-dblog/])<br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> ''Installation von SQLite:''<br /> &lt;pre&gt;sudo aptitude install sqlite3 libdbi-perl libdbd-sqlite3-perl&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anlegen der SQLite-Datenbank fhem.db'' (öffnet auch direkt eine SQL-Kommandozeile):<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> CREATE TABLE 'history' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE TABLE 'current' (TIMESTAMP TIMESTAMP, DEVICE varchar(64), TYPE varchar(64), EVENT varchar(512), READING varchar(64), VALUE varchar(128), UNIT varchar(32));<br /> CREATE INDEX Search_Idx ON `history` (DEVICE, READING, TIMESTAMP);<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassen des Besitzers und der Rechte der Datenbank-Datei:''<br /> &lt;pre&gt;<br /> sudo chown fhem /opt/fhem/fhem.db<br /> sudo chmod 666 /opt/fhem/fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Datenbank-Anbindung des FHEM konfigurieren:''<br /> &lt;pre&gt;sudo nano /opt/fhem/db.conf&lt;/pre&gt;<br /> Inhalt:<br /> &lt;pre&gt;<br /> %dbconfig= (<br /> connection =&gt; &quot;SQLite:dbname=/opt/fhem/fhem.db&quot;,<br /> user =&gt; &quot;&quot;,<br /> password =&gt; &quot;&quot;<br /> );<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Logging des FHEM auf die Datenbank konfigurieren:'' (hier sind nur die Anpassungen aufgeführt)<br /> &lt;pre&gt;sudo nano /opt/fhem/fhem.cfg&lt;/pre&gt;<br /> &lt;pre&gt;<br /> ...<br /> attr global userattr DbLogExclude ... # erlaubt es einzelne Einträge nicht zu loggen<br /> ...<br /> define logdb DbLog ./db.conf .*:.* # logt alle(!) auflaufenden Events aller Konfigurationen<br /> ...<br /> &lt;/pre&gt;<br /> Da durch diese &lt;code&gt;define&lt;/code&gt;-Definition alle auflaufenden Events gelogt werden, müssen keine weiteren Anpassungen in der Konfiguration gemacht werden. Die FileLog-Einträge können bedenkenlos bestehen bleiben - dann wird in Datenbank und FileLog gelogt und man verliert keine Daten, falls etwas nicht klappt. Wenn alles wie geplant läuft, können die FileLog-Definitionen gelöscht werden (ebenso die Log-Dateien). Ebenso können die zu loggenden Daten später eingegrenzt werden (s. [[#Finetuning des Loggings]]).<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''FHEM neu starten:''<br /> &lt;pre&gt;<br /> sudo service fhem stop<br /> sudo service fhem start<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Kontrollieren, ob Logs in die Datenbank geschrieben werden:''<br /> &lt;pre&gt;sudo sqlite3 /opt/fhem/fhem.db&lt;/pre&gt;<br /> In der geöffneten SQL-Kommandozeile eingeben:<br /> &lt;pre&gt;<br /> select * from history order by TIMESTAMP; # dies gibt alle(!) Logs chronologisch aus (kann nach längerem Betrieb recht lange dauern)<br /> &lt;/pre&gt;<br /> Die Kommandozeile verlässt man mit &lt;code&gt;.exit&lt;/code&gt;.<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> ''Anpassung der glot-Dateien:'' siehe [[#Anpassen der gplot-Konfigurationen]]<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> == Beispiel: Anlegen und Nutzung einer Mysql-Datenbank ==<br /> Anstatt nano kann jeder andere kompatible Editor verwendet werden. Weiterhin bitte beachten, dass die hier genannten Befehle teilweise root-Rechte voraussetzen. Entweder komplett als root arbeiten, oder mittels sudo.<br /> <br /> Unter Ubuntu/debian: <br /> apt-get update &amp;&amp; apt-get install mysql-server mysql-client libdbd-mysql libdbd-mysql-perl<br /> <br /> <br /> Bei der Installation sollte man aus Sicherheitsgründen ein Passwort für den mysql-root vergeben, wenn man nicht sogar ganz den Login verbietet.<br /> <br /> Hinweis: im Folgenden ist &quot;#&quot; der normale Prompt und &quot;mysql&gt;&quot; der prompt innerhalb mysql, dieser kann mit exit verlassen werden. <br /> <br /> Zum Test mal mit mysql verbinden:<br /> # mysql -p -u root<br /> Enter password:<br /> mysql&gt; exit<br /> <br /> Jetzt die Tabellenstruktur anlegen. <br /> Hierfür kann die Datei /opt/fhem/contrib/dblog/db_create_mysql.sql als Vorlage verwendet und das Passwort und der Benutzername geändert werden. <br /> cd /opt/fhem/contrib/dblog/<br /> nano db_create_mysql.sql<br /> Dann wird die Datei eingelesen (root Passwort wird abgefragt): <br /> <br /> # mysql -u root -p &lt; db_create_mysql.sql<br /> <br /> Jetzt kann man den Zugang testen: <br /> <br /> # mysql -p -u &lt;fhemuser&gt;<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; show databases;<br /> <br /> Nun müsste eine Datenbank &quot;fhem&quot; angezeigt werden, die die Tabellen current und history enthält.<br /> <br /> Nun in der Datei db.conf den mysql-Block auskommentieren und ebenfalls Benutzername, Passwort UND HOST anpassen. Leider ist hier nicht standardmäßig localhost eingestellt.<br /> nano /opt/fhem/db.conf<br /> <br /> Jetzt kann unter FHEM ein DbLog-Device angelegt werden (mit dem beispiel wird alles geloggt: <br /> define logdb DbLog ./db.conf .*:.*<br /> Als State muss ein &quot;connected&quot; angezeigt werden. <br /> <br /> Ein rereadcfg in FHEM stellt sicher, dass die neue Konfiguration übernommen wird - ein Neustart ist nicht erforderlich.<br /> <br /> Nun kann die Funktion noch einmal überprüft werden: <br /> &lt;syntaxhighlight lang=&quot;sql&quot;&gt;<br /> # mysql -u &lt;fhemuser&gt; -p<br /> Enter password: &lt;fhempassword&gt;<br /> mysql&gt; use fhem;<br /> Database changed<br /> mysql&gt; show tables;<br /> +----------------+<br /> | Tables_in_fhem |<br /> +----------------+<br /> | current |<br /> | history |<br /> +----------------+<br /> 2 rows in set (0,00 sec)<br /> mysql&gt; select * from history; # Achtung, kann sehr groß werden .... #<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Beispiel: Abfragescript PHP/MySQL ==<br /> Um eine schnelle Übersicht zu bekommen habe ich mir dieses Script geschrieben:<br /> &lt;syntaxhighlight lang=&quot;php&quot;&gt;&lt;?php $pdo = new PDO('mysql:host=localhost;dbname=fhem', 'fhemuser', 'fhempasswort');<br /> echo '&lt;h2&gt;Tabelle Current&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;th&gt;Readings&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE, GROUP_CONCAT(DISTINCT READING ORDER BY READING DESC SEPARATOR '&lt;/li&gt;&lt;li&gt;') FROM current GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;td&gt;&lt;ol&gt;&lt;li&gt;&quot; . $row[2] . &quot;&lt;/li&gt;&lt;/ol&gt;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> <br /> <br /> echo '&lt;h2&gt;Tabelle History&lt;/h1&gt;&lt;br&gt;&lt;table border=&quot;1&quot;&gt;';<br /> echo &quot;&lt;tr&gt;&lt;th&gt;Anzahl&lt;/th&gt;&lt;th&gt;Name&lt;/th&gt;&lt;/tr&gt;&quot;;<br /> $sql = &quot;SELECT COUNT(*), DEVICE FROM history GROUP BY DEVICE;&quot;; foreach ($pdo-&gt;query($sql) as<br /> $row) {<br /> echo &quot;&lt;tr&gt;&lt;td&gt;&quot; . $row[0] . &quot;&lt;/td&gt;&lt;td&gt;&quot; . $row[1] . &quot;&lt;/td&gt;&lt;/tr&gt;&quot;;<br /> }<br /> echo &quot;&lt;/table&gt;&quot;;<br /> ?&gt;<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Bitte passt fhemuser und fhempasswort an. Das Ganze kommt dann nach ''/var/www/html/fhemdb.php'' und ist mit ''&lt;IP&gt;/fhemdb.php'' aufrufbar. Wenn ihr den 2. Block für die history Tabelle ausklammert oder entfernt läuft das Script viel schneller ab - klar die history Tabelle ist meist randvoll.<br /> <br /> == Integration von DBLog in eigene Module ==<br /> === Bereitstellung der UNITS ===<br /> Mit der DbLog_splitFn kann der Modulautor selbst festlegen, wie die Events des Moduls in die Bestandteile Reading/Value/Unit zerlegt werden um ein korrektes Logging per DbLog zu gewährleisten.<br /> <br /> Dazu muss der Modulautor in der [[DevelopmentModuleIntro#X_Initialize|Initialize-Funktion]] eine &lt;code&gt;DbLog_splitFn&lt;/code&gt; bereitstellen:<br /> <br /> &lt;syntaxhighlight lang=&quot;perl&quot;&gt;<br /> sub X_Initialize($)<br /> {<br /> my ($hash) = @_;<br /> ...<br /> $hash-&gt;{DbLog_splitFn} = &quot;X_DbLog_splitFn&quot;;<br /> }<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Die genaue Aufrufsyntax und Funktionweise einer DbLog_split-Funktion findet man [[DevelopmentModuleIntro#X_DbLog_split|hier]].<br /> <br /> == Werte auslesen ==<br /> Manchmal möchte man Daten aus den Logs abrufen ohne händisch in der Datenbank herumzuwühlen (s.u.). Dies ist insb. auch dann hilfreich, wenn man eigenen Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.<br /> <br /> Grundsätzlich beschrieben ist dies in der {{Link2CmdRef|Lang=de|Anker=DbLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[FileLog#Werte_auslesen|FileLogs]].<br /> <br /> Hier ein paar Beispiele, was man damit anstellen kann:<br /> <br /> * &lt;code&gt;get meineDB - - 2016-10-01 2016-10-03 meinSensor&lt;/code&gt; alle Einträge des meinSensor vom 01.10.-03.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor&lt;/code&gt; alle Einträge des meinSensor von 8-16 Uhr am 01.10.2016<br /> * &lt;code&gt;get meineDB - - 2016-10-01_08:00:00 2016-10-01_16:00:00 meinSensor:temperature&lt;/code&gt; nur die temperature Werte<br /> * &lt;code&gt;{ ReadingsTimestamp(&quot;meinSensor&quot;,&quot;state&quot;,&quot;0&quot;) }&lt;/code&gt; Timestamp des aktuellen state des meinSensor<br /> * &lt;code&gt;{ OldTimestamp(&quot;meinSensor&quot;) }&lt;/code&gt; Timestamp des letzten state des FHT_3a32<br /> * &lt;code&gt;{ time_str2num(OldTimestamp(&quot;meinSensor&quot;)) }&lt;/code&gt; Timestamp in Sekunden des letzten state des meinSensor<br /> * ...<br /> <br /> == Bearbeitung von Datenbank-Einträgen ==<br /> {{Hinweis|Dieser Abschnitt soll lediglich eine kleine Einführung in die Datenbank-Bearbeitung liefern. Für vertiefende Informationen sollte man sich grundsätzlich mit SQL beschäftigen. Eine umfassende und gut verständliche Anleitung zu SQL bietet bspw. [http://www.w3schools.com/sql/default.asp w3schools].}}<br /> Irgendwann wird der Fall eintreten, dass in der Datenbank Einträge drinstehen, die geändert oder gelöscht werden sollen (zB. fehlerhafte Sensor-Rückmeldungen, umbenannte Readings). In klassischen Log-Dateien würde man diese einfach bearbeiten und löschen/anpassen (wobei man aber tunlichst zuvor FHEM stoppt, um Datenfehler zu vermeiden). Eine Datenbank kann bearbeitet werden, ohne FHEM stoppen zu müssen. <br /> <br /> Datenbanken kann man ohne weitere Hilfsmittel direkt von der Kommandozeile/Shell aus bearbeiten. Alternativ gibt es auch verschiedenste Tools (webbasiert oder als Applikation), die einen dabei unterstützen (Bsp. findet man u.a. [https://wiki.ubuntuusers.de/SQLite/#Grafische-Benutzeroberflaechen hier]). Für einfache Arbeiten reicht allerdings idR. Shell.<br /> <br /> === SQLite-Datenbanken ===<br /> '''Öffnen der DB unter Linux:''' <br /> <br /> (Es werden Schreibrechte benötigt,ohne kann man die DB zwar öffnen, aber nichts machen)<br /> sudo sqlite3 fhem.db<br /> Dadurch öffnet sich ein SQL-Konsole, auf der alle weiteren Befehle ausgeführt werden.<br /> <br /> '''Schliessen der DB:'''<br /> <br /> sqlite&gt; .exit<br /> <br /> <br /> '''Hilfe anzeigen:'''<br /> <br /> sqlite&gt; .help<br /> <br /> <br /> '''Alle Tabellen anzeigen:'''<br /> <br /> sqlite&gt; .tables<br /> <br /> <br /> '''Das Schema der DB anzeigen:''' <br /> <br /> (vgl. oben [[DbLog#Datenbanken]] und [[DbLog#Beispiel: Anlegen und Nutzung einer SQLite-Datenbank]])<br /> <br /> sqlite&gt; .schema<br /> <br /> <br /> '''Alle Eintäge anzeigen:''' <br /> <br /> Die Einträge liegen alle in der Tabelle &quot;History&quot;.<br /> <br /> '''Ganz wichtig''' ist immer das &quot;;&quot; am Ende Zeile (bei allen Kommandos, die nicht mit einem &quot;.&quot; anfangen). Wenn es vergessen wurde zeigt die Konsole solange neue Zeilen bis ein &quot;;&quot; eingegeben wird. So kann ein Befehl auch bequem über mehrere Zeilen geschrieben werden.<br /> <br /> sqlite&gt; select * from HISTORY;<br /> <br /> Dies kann sehr lange dauern und kann ggf. mit &lt;code&gt;STRG-C&lt;/code&gt; abgebrochen werden.<br /> <br /> <br /> '''Alle Einträge eines Geräts anzeigen:'''<br /> <br /> In &lt;code&gt;where&lt;/code&gt;-Statements werden Strings in einfache Anführungsstriche gesetzt, Zahlen nicht.<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug';<br /> <br /> <br /> '''Alle Einträge eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser';<br /> <br /> <br /> '''Alle Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> sqlite&gt; select * from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> '''LÖSCHEN aller Einträge eines bestimmten Wertes eines Readings eines Geräts anzeigen:'''<br /> <br /> '''Achtung:''' Löschen kann nicht rückgängig gemacht werden!! Also IMMER erst die entsprechenden SELECT-Statements solange verfeinern bis wirklich nur die gewünschten Einträge angezeigt werden. Dann das &lt;code&gt;select *&lt;/code&gt; durch &lt;code&gt;delete&lt;/code&gt; ersetzen.<br /> <br /> sqlite&gt; delete from HISTORY where DEVICE='Pollenflug' and READING='Graeser' and VALUE&gt;1;<br /> <br /> <br /> == Datenbank reparieren ==<br /> Es kann immer wieder mal vorkommen, dass Datenbanken Fehler enthalten. Das muss im Alltag garnicht auffallen und auch nicht immer schlimm enden. Wenn man auf der SQL-Konsole aber bspw. eine Meldung &lt;code&gt;Error: database disk image is malformed&lt;/code&gt; erhält, sollte man ein Reparatur vornehmen.<br /> <br /> === SQLite-Datenbanken ===<br /> Die folgenden Schritte beschreiben, wie man eine SQLite-DB reparieren kann (Quelle: [http://techblog.dorogin.com/2011/05/sqliteexception-database-disk-image-is.html]):<br /> <br /> &lt;ol&gt;<br /> &lt;li&gt;<br /> DB öffnen:<br /> &lt;pre&gt;sudo sqlite3 fhem.db&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Integritäts-Check durchführen:<br /> &lt;pre&gt;sqlite&gt; pragma integrity_check;&lt;/pre&gt;<br /> Kommt hier ein &quot;ok&quot; ist die DB gesund. Ansonsten erscheint etwas wie<br /> &lt;pre&gt;<br /> *** in database main ***<br /> On tree page 118786 cell 1: Rowid 75 out of order (previous was 816660)<br /> On tree page 118786 cell 4: Rowid 815704 out of order (previous was 816727)<br /> Corruption detected in cell 0 on page 118786<br /> Multiple uses for byte 132 of page 118786<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Datenbank-Dump erstellen (Export gesamten DB in die Datei &quot;dump_all_20160516_1043.sql&quot;) und DB verlassen:<br /> &lt;pre&gt;<br /> sqlite&gt; .mode insert<br /> sqlite&gt; .output dump_all_20160516_1043.sql<br /> sqlite&gt; .dump<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Neue Datenbank erstellen und den Dump einlesen, Integritäts-Check machen und verlassen:<br /> &lt;pre&gt;sudo sqlite3 fhem-neu.db&lt;/pre&gt;<br /> &lt;pre&gt;<br /> sqlite&gt; .read dump_all_20160516_1043.sql<br /> sqlite&gt; pragma integrity_check;<br /> ok<br /> sqlite&gt; .exit<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Spätestens jetzt FHEM stoppen:<br /> &lt;pre&gt;sudo service fhem stop&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Alte DB sichern und neue aktivieren:<br /> &lt;pre&gt;<br /> sudo mv fhem.db fhem.db.sv_20160516<br /> sudo mv fhem-neu.db fhem.db<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> Kontrollieren, dass die neue DB die gleichen Rechte wie die alte DB hat (und ggf. korrigieren):<br /> &lt;pre&gt;<br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 root root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> <br /> ~/fhem$ sudo chown fhem:root fhem.db<br /> <br /> ~/fhem$ ls -lha<br /> insgesamt 6,3G<br /> drwxr-xr-x 12 fhem root 4,0K Mai 16 11:07 .<br /> drwxr-xr-x 4 root root 4,0K Dez 25 17:50 ..<br /> ...<br /> -rw-r--r-- 1 fhem root 1,4G Mai 16 11:04 fhem.db<br /> -rw-r--r-- 1 fhem root 2,6G Mai 16 10:59 fhem.db.sv_20160516<br /> ...<br /> &lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;li&gt;<br /> FHEM wieder starten (und natürlich kontrollieren):<br /> &lt;pre&gt;sudo service fhem start&lt;/pre&gt;<br /> &lt;/li&gt;<br /> &lt;/ol&gt;<br /> <br /> <br /> == Datenbank migrieren ==<br /> Eine schöne Anleitung zur Migration von SQLite zu MySQL/MariaDB mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] findet sich hier: [https://demaya.de/fhem-umzug-sqlite-mysql-mariadb/].<br /> <br /> Hinweis: Wenn die SQLite-DB sehr groß wird, kann es sein, dass der oben beschriebene Weg nicht funktioniert (konkret war dies bei meiner 15 GB großen DB nicht möglich, der Prozess hat sich immer nach mehreren Stunden aufgehängt).<br /> <br /> == Nützliche Codeschnipsel ==<br /> Anbei ein paar nützliche Codeschnipsel rund um DbLog<br /> <br /> <br /> === Dateigrösse mitloggen ===<br /> Da die Datenbank ins Unermessliche wachsen kann, empfiehlt es sich - je nach Speicherplatz - ab einer bestimmten Grösse tätig zu werden. Dazu muss diese Grösse allerdings ermittelt werden. Diese geschieht mittels des Userreadings, welches man vorteilshafterweise mit im DbLog-device anlegt:<br /> <br /> &lt;pre&gt;attr myDbLog userReadings DbFileSize:reduceLogState.* { (split(' ',`du -m fhem.db`))[0] }&lt;/pre&gt;<br /> <br /> Mittels dieses Attributs wird die Grösse der .db-Datei immer nach dem Ausführen des ReduceLog in das Reading &quot;DbFileSize&quot; in ganzzahligen MByte abgelegt.<br /> <br /> Basierend auf diesem Reading können dann weitere Aktionen, beispielsweise ein Plot, erstellt werden.<br /> <br /> Die oben beschriebene Möglichkeit ist für SQLite verwendbar. Zur Ermittlung der DB-Größe andere DB-Typen (aber auch für SQLite nutzbar) kann wie [[DbRep_-_Reporting_und_Management_von_DbLog-Datenbankinhalten#Gr.C3.B6.C3.9Fe_der_FHEM-Datenbank_ermitteln | hier]] beschrieben vorgegangen werden.<br /> <br /> <br /> == Performance-Optimierung ==<br /> Auch eine Datenbank kann mit der Zeit langsamer werden. Dies hängt von mehreren Faktoren ab:<br /> * Menge der gelogten Daten (zB. &gt; 4-5 GB)<br /> * Eingesetzte Hardware (zB. langsame SD-Karte vs. schnelle SSD)<br /> * Eingesetztes Datenbanksystem (zB. SQLite, MySQL)<br /> * Komplexität der Abfragen (zB. für aufwändige Graphen oder Berechnungen)<br /> <br /> Diese Punkte sollen im folgenden diskutiert werden:<br /> <br /> <br /> === Komplexität der Abfragen ===<br /> Dies ist kein Problem der Datenbank, sondern rein der Abfrage. Dem entsprechend muss die Optimierung auch in der Abfrage oder im Skript gesucht werden. Dies ist nicht Ziel dieses Abschnittes und wird hier nicht weiter behandelt.<br /> <br /> <br /> === Eingesetztes Datenbanksystem ===<br /> Welches Datenbanksystem eingesetzt wird (zB. SQLite oder MySQL) hat auf die Performance der Datenbank gar keinen so großen Einfluss, wie vielleicht zuerst gedacht. Selbst SQLite kann problemlos Datenbanken mit etlichen GB Größe performant verarbeiten. Der Flaschenhals ist hier viel mehr die darunter liegende Hardware (s.u.).<br /> <br /> Die Performance der Datenbank an sich, kann aber durch verschiedene Maßnahmen verbessert werden:<br /> * Pflegemaßnahmen bzgl. der Daten<br /> * '''Erstellung von Indizes'''<br /> <br /> <br /> ==== Menge der Daten und Pflegemaßnahmen bzgl. der Daten ====<br /> Die Menge der geloggten Daten hat natürlich Einfluss auf die Geschwindigkeit von Abfragen - je mehr Daten vorhanden sind, desto mehr Daten müssen auch durchforstet werden um eine Abfrage zu bedienen. Die Reduzierung der geloggten Datenmenge hat also direkten Einfluss auf die Größe und damit auch die Geschwindigkeit der Datenbank. Die Menge der zu loggenden Daten lässt sich an zwei Stellen einschränken:<br /> * bei der Definition jedes Devices (s. Kapitel oben)<br /> * bei der Festlegung des fhem-weiten Log-Levels (s. [[Loglevel]])<br /> <br /> Die Menge der bereits geloggten Daten kann zB. mit Hilfe von [[DbRep - Reporting und Management von DbLog-Datenbankinhalten|DbRep]] verringert und optimiert werden, bspw.<br /> * löschen unnötiger Daten<br /> * vacuum der Datenbank<br /> <br /> Insgesamt haben diese Maßnahmen aber nur einen eingeschränkten Effekt auf die Performance der DB. Deutlich effektiver ist die Erstellung eines Index (s.u.).<br /> <br /> <br /> ==== Erstellung von Indizes ====<br /> Die Erstellung von Indizes hat mit Abstand den größten Einfluss auf die Performance einer Datenbank (auf unveränderter Hardware). Extrem zusammengefasst ist ein Index eine extrem optimiertes Nachschlageverzeichnis für einen bestimmten Typ Daten (ein Index wie im Buch halt). Eine wunderbare Einführung in Indizes bietet [[https://use-the-index-luke.com/de|https://use-the-index-luke.com]].<br /> <br /> In fhem sind Indizes sogar sehr einfach einzurichten da die Datenbank-Nutzung sehr stark vorgegeben ist. Nahezu jede Abfrage folgt dem Schema ''Device -&gt; Reading -&gt; Datum -&gt; Wert''. Ein Index kann genau diese Abfrage bedienen und beschleunigen. Ein Index nur über die Devices wäre ein erster Schritt, brächte aber noch keinen großen Gewinn (wie um Link oben gut beschrieben). Über die gesamten ersten drei Schritte erstellt (Device -&gt; Reading -&gt; Datum) bringt der Index aber sofort eine deutliche Geschwindigkeitssteigerung.<br /> <br /> Die Erstellung eines Index erfolgt direkt in der Datenbank (und nicht aus fhem heraus), hier am Beispiel einer SQLite-DB:<br /> <br /> Öffnen der DB:<br /> &lt;pre&gt; sudo sqlite3 fhem.db &lt;/pre&gt;<br /> <br /> Erzeugen des Index auf der DB-Konsole (das Semikolon am Ende ist wichtig):<br /> &lt;pre&gt; create index idx_device_reading_timestamp on history (device, reading, timestamp); &lt;/pre&gt;<br /> <br /> Verlassen der DB:<br /> &lt;pre&gt; .exit &lt;/pre&gt;<br /> <br /> Einzig zu berücksichtigen ist, dass dieser Index die Datenbank um bis zu 1/3 vergrößert. Er kann aber bei Bedarf auch wieder entfernt werden. Bei meiner 15 GB SQLite-Datei (auf einem Mac Mini mit SSD) hat dies ca. 15 min gedauert (den fhem hatte ich vorsichtshalber währenddessen deaktiviert).<br /> <br /> Sollte jemand spezielle Berechnungen oder Skripte ausführen, die nach einem anderen Abfrage-Schema arbeiten, könnte man dafür spezialisierte zusätzliche Indizes erstellen. Das sollte aber dann mit dem Wissen des obigen Links erarbeitet werden, da dann etwas mehr Hintergrundwissen sehr hilfreich ist.<br /> <br /> <br /> ==== DB-Backup ====<br /> Ein anderer Aspekt, der eigentlich nichts mit der Performance der DB zu tun hat, ist der Einfluss aufs Backup. Wird bspw. ein Systembackup per RSYNC gemacht, muss bei SQLite immer die komplette ggf. riesige Datei gesynct werden - bei MySQL würden nur die veränderten DB-Elemente gesynct. Dies soll hier nicht weiter vertieft werden, sollte aber bei einer Gesamtstrategie bedacht werden.<br /> <br /> <br /> === Eingesetzte Hardware ===<br /> fhem hat grundsätzlich sehr viele kleine Datenzugriffe, unabhängig davon ob FileLog oder DbLog eingesetzt wird. Deshalb ist der absolut größte Performance-Gewinn durch den Einsatz schneller Festplatten zu erreichen - ganz einfache Aussage: ''je schneller desto besser ;-)''. Konkret bietet eine SSD mit mind. 250MB/s Datenzugriff eine ordentliche Basis für jedes datengestützte System, wie den fhem.<br /> <br /> Wenn die Datenmenge größer und die Abfragen komplexer werden, müssen natürlich irgendwann auch die Prozessorleistung und der Arbeitsspeicher mit wachsen. Aber auch an einem Raspi wird eine SSD deutlich performanter sein, als eine einfache SD-Karte oder eine klassische rotierende Festplatte.<br /> <br /> <br /> == Links ==<br /> * [[Heizleistung_und_Gasverbrauch|Beispiel das DbLog-Daten für SVG-Plots verwendet]]<br /> * [[SVG-Plots von FileLog auf DbLog umstellen]]</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28157 BOTVAC 2018-10-23T22:21:37Z <p>Stephan: /* Attribute */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *boundaries<br /> <br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> **Note that navigationMode can only be set to deep, if cleaningMode is turbo<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> Es muss kein Quadrat sein, der Bereich ist von 100 - 400 cm, in 1 cm Schritten einstellbar. Rechtecke von z.B. 152x244 sind also möglich. <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> <br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28156 BOTVAC 2018-10-23T20:19:59Z <p>Stephan: /* Definition in FHEM */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> **Note that navigationMode can only be set to deep, if cleaningMode is turbo<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> Es muss kein Quadrat sein, der Bereich ist von 100 - 400 cm, in 1 cm Schritten einstellbar. Rechtecke von z.B. 152x244 sind also möglich. <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> <br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28155 BOTVAC 2018-10-23T20:19:53Z <p>Stephan: /* Allgemeines */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> **Note that navigationMode can only be set to deep, if cleaningMode is turbo<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> Es muss kein Quadrat sein, der Bereich ist von 100 - 400 cm, in 1 cm Schritten einstellbar. Rechtecke von z.B. 152x244 sind also möglich. <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28154 BOTVAC 2018-10-23T20:19:28Z <p>Stephan: /* FHEM Device */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Definition ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> **Note that navigationMode can only be set to deep, if cleaningMode is turbo<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> Es muss kein Quadrat sein, der Bereich ist von 100 - 400 cm, in 1 cm Schritten einstellbar. Rechtecke von z.B. 152x244 sind also möglich. <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28153 BOTVAC 2018-10-23T20:17:50Z <p>Stephan: /* Attribute */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Definition ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> **Note that navigationMode can only be set to deep, if cleaningMode is turbo<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> Es muss kein Quadrat sein, der Bereich ist von 100 - 400 cm, in 1 cm Schritten einstellbar. Rechtecke von z.B. 152x244 sind also möglich. <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28152 BOTVAC 2018-10-23T20:09:32Z <p>Stephan: /* Attribute */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Definition ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> Es muss kein Quadrat sein, der Bereich ist von 100 - 400 cm, in 1 cm Schritten einstellbar. Rechtecke von z.B. 152x244 sind also möglich. <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28151 BOTVAC 2018-10-23T20:06:04Z <p>Stephan: /* Attribute */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Definition ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> *actionInterval<br /> **Poll-Interval für den aktiven Betrieb (Busy/Paused)<br /> *cleaningMode<br /> **wird bei Starten der nächsten Reinigung verwendet: eco,turbo<br /> *cleaningModifier<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,double<br /> *cleaningNavigationMode<br /> **wird bei Starten der nächsten Reinigung verwendet: normal,extra care,deep<br /> *cleaningSpotWidth<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> *cleaningSpotHeight<br /> **wird bei Starten der nächsten Reinigung verwendet: 100,200,300,400<br /> <br /> <br /> Die Attribute werden zum Saugertyp passend angeboten. Dadurch sind die Startbefehle für die Reinigung parameterlos. Einzige Ausnahme beim D7 ist set &lt;name&gt; startCleaning &lt;house|map&gt;<br /> Wenn die cleaning-Attribute nicht definiert sind, werden die Werte der letzten Reinigung aus dem Reading genommen.<br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28150 BOTVAC 2018-10-23T20:04:30Z <p>Stephan: /* Allgemeines */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> === Definition ===<br /> define &lt;name&gt; BOTVAC &lt;email&gt; [&lt;vendor&gt;] [&lt;poll-interval&gt;]<br /> set &lt;name&gt; password &lt;password&gt;<br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28149 BOTVAC 2018-10-23T20:04:01Z <p>Stephan: /* SET */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> <br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *dismissCurrentAlert<br /> **Zurücksetzen einer anstehenden Warnmeldung<br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> **https://developers.neatorobotics.com/api/robot-remote-protocol/maps<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28148 BOTVAC 2018-10-23T20:00:57Z <p>Stephan: /* MAPS */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> <br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> Map per telegram versenden: <br /> set &lt;TelegramBot&gt; cmdSend {ReadingsVal('&lt;BOTVAC&gt;', '.map_cache', '')}<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28147 BOTVAC 2018-10-23T19:53:25Z <p>Stephan: /* SET */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> <br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *findMe<br /> **The robot will emit a sound and blink the LEDs when it receives the findMe command.<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *pause<br /> **pausiert die Reinigung<br /> *pauseToBase<br /> **Beendet eine Reinigung und fährt zur Basis zurück<br /> *reloadMaps<br /> **Lädt die letzte Karte vom Neato-Server, die erstellt wurde. Das passiert normalerweise automatisch, ist aber z.B. beim Neustart von Fhem sinnvoll. Beim Vorwerk läuft diese Funktion (noch) ins Leere.<br /> *resume<br /> **Setzt Reinigung fort<br /> <br /> *schedule<br /> **Die möglichen Argumente sind 'on' und 'off' zum An- und Abschalten der Zeitsteuerung.<br /> *sendToBase<br /> **Fährt zur Basis zurück<br /> <br /> *setBoundaries<br /> *setRobot<br /> **Legt den zu steuernden Roboter fest<br /> *startCleaning<br /> ** Startet die Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *startSpot<br /> **Startet die Spot-Reinigung und hat je nach Model ein weiteres Argument Eco/Turbo oder Normal/ExtraCare<br /> *statusRequest<br /> *stop<br /> ** stoppt die Reinigung<br /> *syncRobots<br /> **Synchronisiert die Roboterdaten. Das ist nützlich, wenn man mehrere Geräte unter einem Neato- bzw. Vorwerk-Account verwaltet und dort Geräte entfernt oder hinzugefügt hat.<br /> *stopCleaning<br /> ** Stop cleaning the house.<br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28146 BOTVAC 2018-10-23T19:36:12Z <p>Stephan: /* MAPS */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> <br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *findMe<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *reloadMaps<br /> *schedule<br /> *setBoundaries<br /> *setRobot<br /> ** nur verfügbar, wenn mehr als ein Sauger vorhanden ist. Ordnet dem Fhem-Gerät einen Sauger(name) zu.<br /> *startCleaning<br /> *startSpot<br /> *statusRequest<br /> *syncRobots<br /> **synchronisiert die Sauger, die zu einem Nutzer zugeordnet sind<br /> *pause<br /> *stop<br /> <br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> http(s)://&lt;ip&gt;:&lt;port&gt;/fhem/BOTVAC/&lt;device&gt;/map<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28145 BOTVAC 2018-10-23T19:34:19Z <p>Stephan: /* MAPS */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> <br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *findMe<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *reloadMaps<br /> *schedule<br /> *setBoundaries<br /> *setRobot<br /> ** nur verfügbar, wenn mehr als ein Sauger vorhanden ist. Ordnet dem Fhem-Gerät einen Sauger(name) zu.<br /> *startCleaning<br /> *startSpot<br /> *statusRequest<br /> *syncRobots<br /> **synchronisiert die Sauger, die zu einem Nutzer zugeordnet sind<br /> *pause<br /> *stop<br /> <br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> https://forum.fhem.de/index.php/topic,51713.msg548498.html#msg548498<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan http://wiki.fhem.de/w/index.php?title=BOTVAC&diff=28144 BOTVAC 2018-10-23T19:33:52Z <p>Stephan: /* Voraussetzungen */</p> <hr /> <div>{{Infobox Modul<br /> |ModPurpose=Dieses Modul dient zur Steuerung eines NEATO oder VORWERK Saugroboters<br /> |ModType=d<br /> |ModCmdRef=BOTVAC<br /> |ModForumArea=Sonstiges<br /> |ModTechName=noch nicht eingcheckt<br /> |ModOwner=vuffiraa<br /> }}<br /> <br /> [[BOTVAC]] ist ein Modul mit welchem VORWERK und NEATO Saugroboter gesteuert werden können. <br /> <br /> == Allgemeines ==<br /> <br /> === Funktionsumfang ===<br /> Aktuell ist folgenden Funktionsumfang vorhanden:<br /> <br /> === Attribute ===<br /> <br /> <br /> <br /> === SET === <br /> *findMe<br /> *manualCleaningMode<br /> *nextCleaningMode<br /> *nextCleaningNavigationMode<br /> *nextCleaningSpotHeight<br /> *nextCleaningSpotWidth<br /> *password<br /> *reloadMaps<br /> *schedule<br /> *setBoundaries<br /> *setRobot<br /> ** nur verfügbar, wenn mehr als ein Sauger vorhanden ist. Ordnet dem Fhem-Gerät einen Sauger(name) zu.<br /> *startCleaning<br /> *startSpot<br /> *statusRequest<br /> *syncRobots<br /> **synchronisiert die Sauger, die zu einem Nutzer zugeordnet sind<br /> *pause<br /> *stop<br /> <br /> <br /> === GET ===<br /> *batteryPercent<br /> <br /> === readings ===<br /> <br /> *dockHasBeenSeen<br /> **stellt sich erst eine Weile nach Beginn einer Reinigung auf &quot;1&quot;.Und nur in diesem Zustand klappt das Zurücksenden.<br /> <br /> <br /> === MAPS ===<br /> <br /> == Grundkonfiguration ==<br /> <br /> === Definition in FHEM ===<br /> === Icons ===<br /> https://forum.fhem.de/index.php/topic,51713.msg539375.html#msg539375<br /> <br /> die Datei reinkopieren, dann &quot;set WEB rereadicons&quot; und anschließend normal als Icon auswählen.<br /> Inzwischen ist das Icon wohl im SVN eingecheckt.<br /> <br /> == FHEM Device ==<br /> siehe https://mwinkler.jimdo.com/eigene-anwendungen/winconnect/fhem-device/<br /> <br /> == Probleme ==<br /> === falls er Sauger mit der App neu konfiguriert werden musste ===<br /> Du hast nach der Neuinstallation der App auch deinen VR/NEATO neu registriert. Fhem lädt aber noch die Daten aus der alten Registrierung. <br /> Wähle mal im Gerät unter Set 'syncRobots' aus. Wenn es danach bei Set auch eine Funktion 'setRobot' gibt, hast du wirklich  den VR neu registriert. Dann einfach über dieses Set den VR wechseln. <br /> Ansonsten bleibt noch die Registrierungsschlüssel im Fhem-Gerät zu löschen. Das geht über die Kommandozeile in Fhem:<br /> - deleteReading &lt;device&gt; accessToken<br /> - deleteReading &lt;device&gt; secretKey</div> Stephan