DevelopmentState - Versionsgeschichte

Drhirn: Rechtschreibfehler korrigiert, Link zur CommandRef durch Vorlage Link2CmdRef ersetzt

2018-06-14T11:32:27Z

Rechtschreibfehler korrigiert, Link zur CommandRef durch Vorlage Link2CmdRef ersetzt

← Nächstältere Version		Version vom 14. Juni 2018, 13:32 Uhr
Zeile 1:		Zeile 1:
	Der Default-Status eines Gerätes wird in FHEM durch die interne Variable ''STATE'' dargestellt. ~~Dieser~~ wird beispielsweise von [[FHEMWEB]] oder von dem ''list''-Befehl angezeigt.		Der Default-Status eines Gerätes wird in FHEM durch die interne Variable '''''STATE''''' dargestellt. Diese wird beispielsweise von [[FHEMWEB]] oder von dem [[list]]-Befehl angezeigt.

	~~Dieser~~ sollte jedoch von Modulautoren nicht direkt gesetzt werden. Stattdessen ermittelt FHEM den Wert folgendermaßen:		Der ''STATE'' sollte jedoch von Modulautoren nicht direkt gesetzt werden. Stattdessen ermittelt FHEM den Wert folgendermaßen:
	# Falls das Attribut ''stateFormat'' gesetzt ist, wird dieses ausgewertet und das Ergebnis in den ''STATE'' geschrieben. (~~Siehe [http://fhem.~~de~~/commandref.html#~~readingFnAttributes ~~commandref.html#readingFnAttributes]~~)		# Falls das Attribut ''stateFormat'' gesetzt ist, wird dieses ausgewertet und das Ergebnis in den ''STATE'' geschrieben. (siehe {{Link2CmdRef\|Anker=readingFnAttributes\|Lang=de\|Label=readingFnAttributes}} in der CommandRef)
	# Falls das Reading ''state'' existiert, wird ~~diesen~~ in ''STATE'' übernommen.		# Falls das Reading ''state'' existiert, wird dessen Wert in ''STATE'' übernommen.

	Wenn ein Modulautor ein bestimmtes Reading in ''STATE'' ~~vorgelegen~~ möchte so kann er dies mit dem ''stateFormat''-Attribut tun.		Wenn ein Modulautor ein bestimmtes Reading in ''STATE'' vorbelegen möchte, so kann er dies mit dem ''stateFormat''-Attribut tun.
	Dies sollte aber nur in der ''define'' Funktion des Moduls geschehen, damit der User die Möglichkeit hat, das Attribut anschließend anzupassen.		Dies sollte aber nur in der ''define'' Funktion des Moduls geschehen, damit der User die Möglichkeit hat, das Attribut anschließend anzupassen.

Markusbloch: Anpassung von -Tags nach

2017-07-26T17:57:27Z

Anpassung von <source>-Tags nach <syntaxhighlight>

← Nächstältere Version		Version vom 26. Juli 2017, 19:57 Uhr
Zeile 10:		Zeile 10:
	Beispiel:		Beispiel:

	<~~source~~ lang="perl">		<syntaxhighlight lang="perl">
	sub MYMODULE_Define($$)		sub MYMODULE_Define($$)
	{		{
Zeile 37:		Zeile 37:
	[...];		[...];
	}		}
	</~~source~~>		</syntaxhighlight>

	[[Kategorie:Development]]		[[Kategorie:Development]]

UniqueCK: add missing bracket

2017-01-15T17:18:17Z

add missing bracket

← Nächstältere Version		Version vom 15. Januar 2017, 19:18 Uhr
Zeile 19:		Zeile 19:

	# prüfen, ob eine neue Definition angelegt wird		# prüfen, ob eine neue Definition angelegt wird
	if($init_done && !defined($hash->{OLDDEF})		if($init_done && !defined($hash->{OLDDEF}))
	{		{
	# setzen von stateFormat		# setzen von stateFormat

Markusbloch: Aktualisierung auf -Tag und korrekte Prüfung auf neue Definition

2016-10-19T13:42:01Z

Aktualisierung auf <source>-Tag und korrekte Prüfung auf neue Definition

← Nächstältere Version		Version vom 19. Oktober 2016, 15:42 Uhr
Zeile 10:		Zeile 10:
	Beispiel:		Beispiel:

	sub MYMODULE_Define($$)		<source lang="perl">
	{		sub MYMODULE_Define($$)
	my ($hash, $def) = @_;		{
	my @args = split("[ \t]+", $def);		my ($hash, $def) = @_;
	my ($name, $type) = @args;		my @args = split("[ \t]+", $def);
	[...];		my ($name, $type) = @args;
	~~'''~~$attr{$name}{"stateFormat"} = "power";~~'''~~		[...];
	~~[...];~~
	}		# prüfen, ob eine neue Definition angelegt wird
			if($init_done && !defined($hash->{OLDDEF})
	~~sub MYMODULE_Call($$)~~		{
	{		# setzen von stateFormat
	~~[...];~~		$attr{$name}{"stateFormat"} = "power";
	~~my $power = [...];~~		}
	~~readingsBeginUpdate($hash);~~
	~~'''readingsBulkUpdate($hash,"power",$power);'''~~		[...];
	~~readingsEndUpdate($hash, 1);~~		}
	[...];
	}

			sub MYMODULE_Call($$)
			{
			[...];
			my $power = [...];
			readingsBeginUpdate($hash);
			readingsBulkUpdate($hash,"power",$power);
			readingsEndUpdate($hash, 1);
			[...];
			}
			</source>

	[[Kategorie:Development]]		[[Kategorie:Development]]

Akw: Kurze Einführung in die STATE-Variable

2014-03-10T20:55:41Z

Kurze Einführung in die STATE-Variable

Neue Seite

Der Default-Status eines Gerätes wird in FHEM durch die interne Variable ''STATE'' dargestellt. Dieser wird beispielsweise von [[FHEMWEB]] oder von dem ''list''-Befehl angezeigt.

Dieser sollte jedoch von Modulautoren nicht direkt gesetzt werden. Stattdessen ermittelt FHEM den Wert folgendermaßen:
# Falls das Attribut ''stateFormat'' gesetzt ist, wird dieses ausgewertet und das Ergebnis in den ''STATE'' geschrieben. (Siehe [http://fhem.de/commandref.html#readingFnAttributes commandref.html#readingFnAttributes])
# Falls das Reading ''state'' existiert, wird diesen in ''STATE'' übernommen.

Wenn ein Modulautor ein bestimmtes Reading in ''STATE'' vorgelegen möchte so kann er dies mit dem ''stateFormat''-Attribut tun.
Dies sollte aber nur in der ''define'' Funktion des Moduls geschehen, damit der User die Möglichkeit hat, das Attribut anschließend anzupassen.

Beispiel:

sub MYMODULE_Define($$)
{
my ($hash, $def) = @_;
my @args = split("[ \t]+", $def);
my ($name, $type) = @args;
[...];
'''$attr{$name}{"stateFormat"} = "power";'''
[...];
}

sub MYMODULE_Call($$)
{
[...];
my $power = [...];
readingsBeginUpdate($hash);
'''readingsBulkUpdate($hash,"power",$power);'''
readingsEndUpdate($hash, 1);
[...];
}

[[Kategorie:Development]]