OWCOUNT - Versionsgeschichte

Ph1959de: Infobox eingefügt + kleinere Änderungen

2015-07-16T05:22:17Z

Infobox eingefügt + kleinere Änderungen

← Nächstältere Version		Version vom 16. Juli 2015, 07:22 Uhr
Zeile 1:		Zeile 1:
	~~OWCOUNT (Dateiname: ''~~21_OWCOUNT.pm'') ~~ist ein Frontendmodul für FHEM und dient zur Kommunikation mit 1-Wire Komponenten DS2423~~ (~~Dual Counter plus RAM~~) ~~bzw. dessen Nachbau auf Basis von ATtiny-Prozessoren. Dabei wird als Backendmodul sowohl OWX zugelassen, als auch OWServer.~~		{{Infobox Modul
			\|ModPurpose=1-Wire Frontendmodul
			\|ModType=d
			\|ModForumArea=1Wire
			\|ModTechName=21_OWCOUNT.pm
			\|ModOwner=Pahenning ({{Link2FU\|376\|Forum}}/[[Benutzer Diskussion:Pahenning\|Wiki]])<br>ntruchsess ({{Link2FU\|677\|Forum}}/[[Benutzer Diskussion:Ntruchsess\|Wiki]])
			}}

	=Definition=		[[OWCOUNT]] ist ein Frontendmodul für FHEM und dient zur Kommunikation mit [[1-Wire]] Komponenten DS2423 (Dual Counter plus RAM) bzw. dessen Nachbau auf Basis von ATtiny-Prozessoren. Dabei wird als Backendmodul sowohl [[OWX]] zugelassen, als auch [[OWServer]].

			== Definition ==
	define <name> OWCOUNT [<model>] <ROM_ID> [interval]		define <name> OWCOUNT [<model>] <ROM_ID> [interval]
	define <name> OWCOUNT <FAM_ID>.<ROM_ID> [interval]		define <name> OWCOUNT <FAM_ID>.<ROM_ID> [interval]
Zeile 12:		Zeile 20:
	Bei der Initialisierung wird automatisch geprüft, ob ein interner RAM vorhanden ist. Wenn nicht, wird ''model=DS2423emu'' gesetzt.		Bei der Initialisierung wird automatisch geprüft, ob ein interner RAM vorhanden ist. Wenn nicht, wird ''model=DS2423emu'' gesetzt.

	=Get=		== Get ==
	*get <name> id => FAM_ID.ROM_ID.CRC		*get <name> id => FAM_ID.ROM_ID.CRC
	*get <name> present => 1 if device present, 0 if not		*get <name> present => 1 if device present, 0 if not
Zeile 24:		Zeile 32:
	*get <name> version => OWX version number		*get <name> version => OWX version number

	=Set=		== Set ==
	*set <name> interval => set query interval for measurement		*set <name> interval => set query interval for measurement
	*set <name> memory <page> => 32 byte string into page 0..13		*set <name> memory <page> => 32 byte string into page 0..13
	*set <name> midnight <channel> => todays starting value for counter		*set <name> midnight <channel> => todays starting value for counter

	=Attribute=		== Attribute ==
	*attr <name> LogM <string> = device name (not file name) of monthly log file		*attr <name> LogM <string> = device name (not file name) of monthly log file
	*attr <name> LogY <string> = device name (not file name) of yearly log file		*attr <name> LogY <string> = device name (not file name) of yearly log file
Zeile 41:		Zeile 49:
	*attr <name> <channel>Period <string> = period for rate calculation = hour (default), minute or second		*attr <name> <channel>Period <string> = period for rate calculation = hour (default), minute or second

	=Beispiel=		== Beispiel ==
	*A-Kanal		*A-Kanal
	**Dieser Kanal zählt Tastendrücke, diese haben den Namen ''GPunkte'' erhalten (steht für Gummipunkte, um Fehlinterpretationen zuvorzukommen ...), ein Datentyp wird nicht festgesetzt.		**Dieser Kanal zählt Tastendrücke, diese haben den Namen ''GPunkte'' erhalten (steht für Gummipunkte, um Fehlinterpretationen zuvorzukommen ...), ein Datentyp wird nicht festgesetzt.
Zeile 89:		Zeile 97:
	attr OWCY.FL room Obergeschoss		attr OWCY.FL room Obergeschoss

	=Zugriff auf rohe Datenwerte=		== Zugriff auf rohe Datenwerte ==
	Der midnight-Wert von Kanal B des als OWC definierten 1-Wire Counters ist enthalten in		Der midnight-Wert von Kanal B des als OWC definierten 1-Wire Counters ist enthalten in
	$defs{'OWC'}->{owg_midnight}->[1]		$defs{'OWC'}->{owg_midnight}->[1]
Zeile 99:		Zeile 107:
	Ähnlich könnte man auch die B-Rate überschreiben, sie steht in		Ähnlich könnte man auch die B-Rate überschreiben, sie steht in
	$defs{'OWC'}{READINGS}{<channel-name>}{VAL}		$defs{'OWC'}{READINGS}{<channel-name>}{VAL}


	[[Kategorie:1-Wire]]		[[Kategorie:1-Wire]]

Pahenning am 11. März 2014 um 07:42 Uhr

2014-03-11T07:42:42Z

@@ Zeile 88: / Zeile 88: @@
   define OWCY.FL FileLog /home/fhem/fhemlogs/OWCY-%Y.log OWC.*month.*
   attr OWCY.FL room Obergeschoss
 [[Kategorie:1-Wire]]

Pahenning am 18. Januar 2014 um 09:46 Uhr

2014-01-18T09:46:42Z

@@ Zeile 1: / Zeile 1: @@
 =Beispiel=
 *A-Kanal
@@ Zeile 46: / Zeile 88: @@
   define OWCY.FL FileLog /home/fhem/fhemlogs/OWCY-%Y.log OWC.*month.*
   attr OWCY.FL room Obergeschoss

Pahenning am 18. Januar 2014 um 09:30 Uhr

2014-01-18T09:30:41Z

@@ Zeile 1: / Zeile 1: @@
 =Beispiel=
 *A-Kanal
-**Dieser Kanal zählt Tastendrücke
+**Dieser Kanal zählt Tastendrücke, diese haben den Namen ''GPunkte'' erhalten (steht für Gummipunkte, um Fehlinterpretationen zuvorzukommen ...), ein Datentyp wird nicht festgesetzt.
-**Diese Tastendrücke haben den Namen "GPunkte" erhalten (steht für Gummipunkte, um Fehlinterpretationen zuvorzukommen ...), ein Datentyp wird nicht festgesetzt, demnach wird als Default-Einheit der Wert ''cts'' (für counts) verwendet.
+**Eine Einheit wird nicht festgesetzt, demnach wird die Default-Einheit ''cts'' (für counts) verwendet.
-**Als Default-Periode für die Ratenberechnung wird 1 Minute verwendet.
+**Als Periode für die Ratenberechnung wird 1 Minute (''minute'')verwendet, die Rate heißt ''GRate''. Ein Datentyp wird nicht festgesetzt, die Einheit ergibt sich automatisch als ''cts/min''.
 **Der Kanal ist im inkrementierenden ("normalen") Modus, wird demnach nicht täglich auf Null gesetzt.
 *B-Kanal
 **Dieser Kanal zählt Impulse (à la Stromzähler - obwohl beim Autor zu Testzwecken ein Timer dranhängt, der alle 4 Sekunden ein Signal abgibt).
-**Der Kanal hat den Name E-Energy erhalten
+**Der Kanal hat den Name ''E-Energy'' und den Datentyp ''energy'' erhalten.
-**Dabei steht jeder Impuls für 0,001 kWh => BFactor ist 0.001. Außerdem ist dieser Kanal im täglichen Modus '''BMode=daily''', es wird also jeden Nacht kurz vor Mitternacht der Mitternachtswert extrapoliert und als "day" Wert ausgegeben. Dieser Wert wird auch im internen Memory als "midnight B" gespeichert und vom Zählerstand abgezogen. Bei dem Testgerät sind das also pro Tag 21,6 kWh = 86400 Sekunden / 4 Sekunden * 0,001 kWh
+**Die Einheit im Kanal sind Kilowattstunden, sowohl die Langform als auch die Kurzform dieser Einheit werden als ''kWh'' gesetzt.
-- Das monatliche Logging erfolgt durch das FileLog  OWCM.FL, siehe dessen Definition darunter. Darin stehen Zeilen wie:
+Insgesamt ergibt sich also als Konfiguration dieses DS2423
 -01-09_23:59:42 OWC day: D09  GPunkte:  49.0 cts GPunktem:  49.0 cts  E-Energy:  21.6 kWh E-Energym:   21.60 kWh
 -01-10_23:59:43 OWC day: D10  GPunkte:  89.0 cts GPunktem:  89.0 cts  E-Energy:  21.6 kWh E-Energym:   43.20 kWh
@@ Zeile 17: / Zeile 41: @@
 -01-12_23:59:55 OWC day: D12  GPunkte:  89.0 cts GPunktem:  89.0 cts  E-Energy:  21.6 kWh E-Energym:  86.4 kWh
 -01-13_23:59:11 OWC day: D13  GPunkte:  89.0 cts GPunktem:  89.0 cts  E-Energy:  21.6 kWh E-Energym: 108.0 kWh
-Damit wird also in der 9. und der 15. Spalte der kumulierte monatliche Wert berechnet.  Dazu muss natürlich das Modul wissen, in welchem Device das Logging erfolgt - dazu wird das Attribut LogM auf OWCM.FL gesetzt. Man kann also jederzeit mit "get OWC month" fragen, was der bisherige monatliche Verbrauch ist - das Modul liest dann die entsprechende Datei.
+Damit wird durch das Modul OWCOUNT in der 9. und der 15. Spalte der kumulierte monatliche Wert berechnet, der sich mit ''get month'' und ''get year'' abfragen lässt.
-define OWCY.FL FileLog /home/fhem/fhemlogs/OWCY-%Y.log OWC.*month.*
+Das jährliche Logging erfolgt beispielsweise mit
-attr OWCY.FL room Obergeschoss
+ define OWCY.FL FileLog /home/fhem/fhemlogs/OWCY-%Y.log OWC.*month.*

Pahenning: Die Seite wurde neu angelegt: „=Beispiel= *A-Kanal Dieser Kanal zählt Tastendrücke Diese Tastendrücke haben den Namen "GPunkte" erhalten (steht für Gummipunkte, um Fehlinterpretatio…“

2014-01-18T08:43:08Z

Die Seite wurde neu angelegt: „=Beispiel= *A-Kanal **Dieser Kanal zählt Tastendrücke **Diese Tastendrücke haben den Namen "GPunkte" erhalten (steht für Gummipunkte, um Fehlinterpretatio…“

Neue Seite

=Beispiel=
*A-Kanal
**Dieser Kanal zählt Tastendrücke
**Diese Tastendrücke haben den Namen "GPunkte" erhalten (steht für Gummipunkte, um Fehlinterpretationen zuvorzukommen ...), ein Datentyp wird nicht festgesetzt, demnach wird als Default-Einheit der Wert ''cts'' (für counts) verwendet.
**Als Default-Periode für die Ratenberechnung wird 1 Minute verwendet.
**Die Anzahl der Gummipunkte/Minute heißt "GRate",
**Der Kanal ist im inkrementierenden ("normalen") Modus, wird demnach nicht täglich auf Null gesetzt.
*B-Kanal
**Dieser Kanal zählt Impulse (à la Stromzähler - obwohl beim Autor zu Testzwecken ein Timer dranhängt, der alle 4 Sekunden ein Signal abgibt).
**Der Kanal hat den Name E-Energy erhalten
**Dabei steht jeder Impuls für 0,001 kWh => BFactor ist 0.001. Außerdem ist dieser Kanal im täglichen Modus '''BMode=daily''', es wird also jeden Nacht kurz vor Mitternacht der Mitternachtswert extrapoliert und als "day" Wert ausgegeben. Dieser Wert wird auch im internen Memory als "midnight B" gespeichert und vom Zählerstand abgezogen. Bei dem Testgerät sind das also pro Tag 21,6 kWh = 86400 Sekunden / 4 Sekunden * 0,001 kWh

- Das monatliche Logging erfolgt durch das FileLog OWCM.FL, siehe dessen Definition darunter. Darin stehen Zeilen wie:
2014-01-09_23:59:42 OWC day: D09 GPunkte: 49.0 cts GPunktem: 49.0 cts E-Energy: 21.6 kWh E-Energym: 21.60 kWh
2014-01-10_23:59:43 OWC day: D10 GPunkte: 89.0 cts GPunktem: 89.0 cts E-Energy: 21.6 kWh E-Energym: 43.20 kWh
2014-01-11_23:59:39 OWC day: D11 GPunkte: 89.0 cts GPunktem: 89.0 cts E-Energy: 21.6 kWh E-Energym: 64.80 kWh
2014-01-12_23:59:55 OWC day: D12 GPunkte: 89.0 cts GPunktem: 89.0 cts E-Energy: 21.6 kWh E-Energym: 86.4 kWh
2014-01-13_23:59:11 OWC day: D13 GPunkte: 89.0 cts GPunktem: 89.0 cts E-Energy: 21.6 kWh E-Energym: 108.0 kWh
Damit wird also in der 9. und der 15. Spalte der kumulierte monatliche Wert berechnet. Dazu muss natürlich das Modul wissen, in welchem Device das Logging erfolgt - dazu wird das Attribut LogM auf OWCM.FL gesetzt. Man kann also jederzeit mit "get OWC month" fragen, was der bisherige monatliche Verbrauch ist - das Modul liest dann die entsprechende Datei.

- Das jährliche Logging wird ganz ähnlich gemacht, dazu muss dann natürlich LogY auf den Namen des Filelog OWCY.FL gesetzt werden.

define OWC OWCOUNT 1D.CE780F000000 60
attr OWC model DS2423
attr OWC room Obergeschoss

attr OWC AName GPunkte|
attr OWC ARate GRate|
attr OWC APeriod minute

attr OWC BName E-Energy|energy
attr OWC BRate E-Power|power
attr OWC BUnit kWh|kWh
attr OWC BFactor 0.001
attr OWC BMode daily

attr OWC LogM OWCM.FL
attr OWC LogY OWCY.FL

define OWC.FL FileLog /home/fhem/fhemlogs/OWC-%Y-%m-%d.log OWC.*GPunkte.*E-Energy.*
attr OWC.FL room Obergeschoss

define OWCM.FL FileLog /home/fhem/fhemlogs/OWCM-%Y-%m.log OWC.*day.*
attr OWCM.FL room Obergeschoss

define OWCY.FL FileLog /home/fhem/fhemlogs/OWCY-%Y.log OWC.*month.*
attr OWCY.FL room Obergeschoss

OWCOUNT - Versionsgeschichte

Ph1959de: Infobox eingefügt + kleinere Änderungen

Pahenning am 11. März 2014 um 07:42 Uhr

Pahenning am 18. Januar 2014 um 09:46 Uhr

Pahenning am 18. Januar 2014 um 09:30 Uhr

Pahenning: Die Seite wurde neu angelegt: „=Beispiel= *A-Kanal **Dieser Kanal zählt Tastendrücke **Diese Tastendrücke haben den Namen "GPunkte" erhalten (steht für Gummipunkte, um Fehlinterpretatio…“

Pahenning: Die Seite wurde neu angelegt: „=Beispiel= *A-Kanal Dieser Kanal zählt Tastendrücke Diese Tastendrücke haben den Namen "GPunkte" erhalten (steht für Gummipunkte, um Fehlinterpretatio…“