DevIo - Versionsgeschichte

Torxgewinde: /* Referenzen */ Websocket ergänzt

2024-01-11T18:38:11Z

Referenzen: Websocket ergänzt

@@ Zeile 67: / Zeile 67: @@
 Die Verbindung kann optional verschlüsselt via SSL/TLS aufgebaut werden. Dazu muss das Internal <code>$hash->{SSL}</code> auf 1 gesetzt werden.
 |-
 | style="vertical-align:top" | '''UNIX-Socket'''

Markusbloch: /* Wichtige Internals zur Konfiguration */ Hinzufügen von $hash->{devioNoSTATE}

2021-10-05T16:34:44Z

Wichtige Internals zur Konfiguration: Hinzufügen von $hash->{devioNoSTATE}

← Nächstältere Version		Version vom 5. Oktober 2021, 18:34 Uhr
Zeile 97:		Zeile 97:
	! style="min-width: 13em;" \| Internal !! Beschreibung		! style="min-width: 13em;" \| Internal !! Beschreibung
	\|-		\|-
	\| style="vertical-align:top" \| <code>$hash->{DeviceName}</code>		\| style="vertical-align:top; white-space:nowrap;" \| <code>$hash->{DeviceName}</code>

	''mandatory''		''mandatory''
	\| style="vertical-align:top" \| Die Gegenstelle zu der eine Verbindung aufgebaut werden soll. Die möglichen Werte und deren Syntax ist im Kapitel [[#Unterstützte Verbindungsarten\|Unterstützte Verbindungsarten]] genauer beschrieben.		\| style="vertical-align:top" \| Die Gegenstelle zu der eine Verbindung aufgebaut werden soll. Die möglichen Werte und deren Syntax ist im Kapitel [[#Unterstützte Verbindungsarten\|Unterstützte Verbindungsarten]] genauer beschrieben.
	\|-		\|-
	\| style="vertical-align:top" \| <code>$hash->{nextOpenDelay}</code>		\| style="vertical-align:top; white-space:nowrap;" \| <code>$hash->{nextOpenDelay}</code>

	''optional''		''optional''
Zeile 109:		Zeile 109:
	Standardwert: 60 Sekunden		Standardwert: 60 Sekunden
	\|-		\|-
	\| style="vertical-align:top" \| <code>$hash->{TIMEOUT}</code>		\| style="vertical-align:top; white-space:nowrap;" \| <code>$hash->{TIMEOUT}</code>

	''optional''		''optional''
Zeile 118:		Zeile 118:
	Standardwert: 3 Sekunden		Standardwert: 3 Sekunden
	\|-		\|-
	\| style="vertical-align:top" \| <code>$hash->{SSL}</code>		\| style="vertical-align:top; white-space:nowrap;" \| <code>$hash->{SSL}</code>

	''optional''		''optional''
Zeile 125:		Zeile 125:
	Standardwert: 0 (keine Verschlüsselung)		Standardwert: 0 (keine Verschlüsselung)
	\|-		\|-
	\| style="vertical-align:top" \| <code>$hash->{devioLoglevel}</code>		\| style="vertical-align:top; white-space:nowrap;" \| <code>$hash->{devioLoglevel}</code>

	''optional''		''optional''
Zeile 131:		Zeile 131:

	Standardwert: ''[leer]''		Standardwert: ''[leer]''
			\|-
			\| style="vertical-align:top; white-space:nowrap;" \| <code>$hash->{devioNoSTATE}</code>

			''optional''
			\|\| Flag (0 oder 1) - Sofern aktiviert, verändert DevIo das Internal <code>STATE</code> nicht direkt, sondern setzt nur das Reading "state" unter Berücksichtigung eines gesetzten <code>stateFormat</code> Attribut der jeweiligen Definition. Details dazu siehe {{Link2Forum\|Topic=120940}}

			Standardwert: 0
	\|}		\|}

Krikan am 20. Juli 2020 um 16:54 Uhr

2020-07-20T16:54:10Z

Änderungen zeigen

Markusbloch: /* Generierte Events */ Hinweis auf https://forum.fhem.de/index.php/topic,98809.msg921911.html#msg921911

2019-03-23T15:31:50Z

Generierte Events: Hinweis auf https://forum.fhem.de/index.php/topic,98809.msg921911.html#msg921911

← Nächstältere Version		Version vom 23. März 2019, 17:31 Uhr
Zeile 431:		Zeile 431:
	\|-		\|-
	\| '''<code>CONNECTED</code>''' \|\| Die Verbindung wurde nach einem Verbindungsabbruch erfolgreich wieder aufgebaut. Dieses Event wird nur nach einem erfolgreichen Reconnect von einer zuvor verlorenen Verbindung generiert. Es wird '''nicht''' nach der erfolgreichen Initialverbindung generiert.		\| '''<code>CONNECTED</code>''' \|\| Die Verbindung wurde nach einem Verbindungsabbruch erfolgreich wieder aufgebaut. Dieses Event wird nur nach einem erfolgreichen Reconnect von einer zuvor verlorenen Verbindung generiert. Es wird '''nicht''' nach der erfolgreichen Initialverbindung generiert.

			<u>Hinweis:</u><br>Seit [https://svn.fhem.de/trac/changeset/18985/ SVN-Revision 18985] wird das <code>CONNECTED</code>-Event auch beim erfolgreichen Aufbau der initialen Verbindung getriggert. Dies gilt jedoch nur für TCP-Verbindungen. Bei allen anderen Verbindungsarten bleibt das Verhalten unverändert. (siehe {{Link2Forum\|Topic=98809\|Message=921911}})
	\|-		\|-
	\| '''<code>DISCONNECTED</code>''' \|\| Die Verbindung ist zusammengebrochen. Es wird ein neuer Verbindungsversuch nach <code>$hash->{nextOpenDelay}</code> Sekunden erfolgen (siehe [[#Wichtige Internals zur Konfiguration\|Wichtige Internals zur Konfiguration]]).		\| '''<code>DISCONNECTED</code>''' \|\| Die zuvor erfolgreich aufgebaute Verbindung ist zusammengebrochen. Es wird ein neuer Verbindungsversuch nach <code>$hash->{nextOpenDelay}</code> Sekunden erfolgen (siehe [[#Wichtige Internals zur Konfiguration\|Wichtige Internals zur Konfiguration]]).

			<u>Hinweis:</u><br>Seit [https://svn.fhem.de/trac/changeset/18985/ SVN-Revision 18985] wird das <code>DISCONNECTED</code>-Event auch nach dem ersten initialem erfolglosen Verbindungsversuch getriggert. Dies gilt jedoch nur für TCP-Verbindungen. Bei allen anderen Verbindungsarten bleibt das Verhalten unverändert. (siehe {{Link2Forum\|Topic=98809\|Message=921911}})
	\|-		\|-
	\| '''<code>FAILED</code>''' \|\| Dieses Event wird nur bei der Nutzung der Funktion [[#DevIo_Expect\|DevIo_Expect()]] generiert, sofern es keine Antwort auf die zuvor gesendeten Daten gibt. Dies bedeutet konkret, dass Gerät hat nicht auf die eigene Anfrage geantwortet und die Verbindung wird daher neu aufgebaut. Details dazu, siehe [[#DevIo_Expect()\|DevIo_Expect()]].		\| '''<code>FAILED</code>''' \|\| Dieses Event wird nur bei der Nutzung der Funktion [[#DevIo_Expect\|DevIo_Expect()]] generiert, sofern es keine Antwort auf die zuvor gesendeten Daten gibt. Dies bedeutet konkret, dass Gerät hat nicht auf die eigene Anfrage geantwortet und die Verbindung wird daher neu aufgebaut. Details dazu, siehe [[#DevIo_Expect()\|DevIo_Expect()]].

Markusbloch: /* TCP/IP-Verbindung */ DevIo_Close() muss vor dem setzen von DeviceName ausgeführt werden (moddef-Befehl).

2019-03-06T15:22:06Z

TCP/IP-Verbindung: DevIo_Close() muss vor dem setzen von DeviceName ausgeführt werden (moddef-Befehl).

← Nächstältere Version		Version vom 6. März 2019, 17:22 Uhr
Zeile 648:		Zeile 648:
	return "no device given" unless($dev);		return "no device given" unless($dev);

			# close connection if maybe open (on definition modify)
			DevIo_CloseDev($hash) if(DevIo_IsOpen($hash));

	# add a default port (1012), if not explicitly given by user		# add a default port (1012), if not explicitly given by user
	$dev .= ':1012' if(not $dev =~ m/:\d+$/);		$dev .= ':1012' if(not $dev =~ m/:\d+$/);

			# set the IP/Port for DevIo
	$hash->{DeviceName} = $dev;		$hash->{DeviceName} = $dev;

	~~# close connection if maybe open (on definition modify)~~
	~~DevIo_CloseDev($hash) if(DevIo_IsOpen($hash));~~

	# open connection with custom init and error callback function (non-blocking connection establishment)		# open connection with custom init and error callback function (non-blocking connection establishment)
	DevIo_OpenDev($hash, 0, "MY_MODULE_Init", "MY_MODULE_Callback");		DevIo_OpenDev($hash, 0, "MY_MODULE_Init", "MY_MODULE_Callback");

Markusbloch: /* serielle Verbindung */ DevIo_Close() muss vor dem setzen von DeviceName ausgeführt werden (moddef-Befehl).

2019-03-06T15:20:26Z

serielle Verbindung: DevIo_Close() muss vor dem setzen von DeviceName ausgeführt werden (moddef-Befehl).

← Nächstältere Version		Version vom 6. März 2019, 17:20 Uhr
Zeile 518:		Zeile 518:
	return "no device given" unless($dev);		return "no device given" unless($dev);

			# close connection if maybe open (on definition modify)
			DevIo_CloseDev($hash) if(DevIo_IsOpen($hash));

	# add a default baud rate (9600), if not given by user		# add a default baud rate (9600), if not given by user
	$dev .= '@9600' if(not $dev =~ m/\@\d+$/);		$dev .= '@9600' if(not $dev =~ m/\@\d+$/);

			# set the device to open
	$hash->{DeviceName} = $dev;		$hash->{DeviceName} = $dev;

	~~# close connection if maybe open (on definition modify)~~
	~~DevIo_CloseDev($hash) if(DevIo_IsOpen($hash));~~

	# open connection with custom init function		# open connection with custom init function

Markusbloch: /* DevIo_CloseDev() */

2018-12-05T22:16:30Z

DevIo_CloseDev()

← Nächstältere Version		Version vom 6. Dezember 2018, 00:16 Uhr
Zeile 401:		Zeile 401:
	Die Funktion DevIo_CloseDev() schließt eine evtl. geöffnete Verbindung für die Definition <code>$hash</code>.		Die Funktion DevIo_CloseDev() schließt eine evtl. geöffnete Verbindung für die Definition <code>$hash</code>.

	Optional kann man mit dem Flag <code>$isFork</code> angeben, dass man sich aktuell in einem Fork vom Hauptprozess befindet. Dadurch ~~wird~~ beim Schließen ~~von~~ seriellen ~~Verbindungen~~ die Kommunikationsparameter nicht zurückgesetzt. Dies verhindert einen Ausfall der nachwievor bestehenden Verbindung im ~~Hauptprozess~~.		Optional kann man mit dem Flag <code>$isFork</code> angeben, dass man sich aktuell in einem Fork vom Hauptprozess befindet. Dadurch werden beim Schließen einer seriellen Verbindung die Kommunikationsparameter nicht zurückgesetzt. Dies verhindert einen Ausfall der nachwievor bestehenden Verbindung im Elternprozess.

	Parameter:		Parameter:
Zeile 416:		Zeile 416:

	''optional''		''optional''
	\|\| Ein Flag (0 oder 1), welches angibt, dass DevIo_CloseDev() innerhalb eines geforkten Kindprozess ausgeführt wird. Dadurch werden ~~serielle Verbindung so geschlossen, dass dabei~~ die Kommunikationsparameter (Baudrate, Datenbits, Parität, etc.) nicht zurückgesetzt ~~werden~~. Dieses Flag wird primär von dem Modul [[Blocking_Call\|Blocking.pm]] verwendet um Verbindungen in einem geforkten Kindprozess zu schließen, ohne die Verbindung im Hauptprozess zu beeinträchtigen.		\|\| Ein Flag (0 oder 1), welches angibt, dass DevIo_CloseDev() innerhalb eines geforkten Kindprozess ausgeführt wird. Dadurch werden die Kommunikationsparameter im Falle einer seriellen Verbindung (Baudrate, Datenbits, Parität, etc.) nicht zurückgesetzt. Dieses Flag wird primär von dem Modul [[Blocking_Call\|Blocking.pm]] verwendet um Verbindungen in einem geforkten Kindprozess zu schließen, ohne die Verbindung im Hauptprozess zu beeinträchtigen.

	Standardwert: 0 (Verbindung wird im Hauptprozess geschlossen)		Standardwert: 0 (Verbindung wird im Hauptprozess geschlossen)

Markusbloch: /* Hinweis bei der Datenverarbeitung (Buffering) */

2018-07-29T14:20:26Z

Hinweis bei der Datenverarbeitung (Buffering)

← Nächstältere Version		Version vom 29. Juli 2018, 16:20 Uhr
Zeile 472:		Zeile 472:
	# remove trailing whitespaces		# remove trailing whitespaces
	chomp $msg;		chomp $msg;

	~~# update $hash->{PARTIAL} with the current buffer content~~
	~~$hash->{PARTIAL} = $buffer;~~

	# parse the extracted message		# parse the extracted message
	MY_MODULE_ParseMessage($hash, $msg);		MY_MODULE_ParseMessage($hash, $msg);
	}		}

			# update $hash->{PARTIAL} with the current buffer content
			$hash->{PARTIAL} = $buffer;
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Markusbloch: /* serielle Verbindung */

2018-07-29T14:18:48Z

serielle Verbindung

← Nächstältere Version		Version vom 29. Juli 2018, 16:18 Uhr
Zeile 608:		Zeile 608:
	return undef;		return undef;
	}		}

			1;
	</syntaxhighlight>		</syntaxhighlight>

Markusbloch: /* TCP/IP-Verbindung */

2018-07-29T14:18:21Z

TCP/IP-Verbindung

← Nächstältere Version		Version vom 29. Juli 2018, 16:18 Uhr
Zeile 747:		Zeile 747:
	return undef;		return undef;
	}		}

			1;
	</syntaxhighlight>		</syntaxhighlight>