UnifiClient - Versionsgeschichte

Ph1959de: Link auf Modulowner im Forum korrigiert

2021-03-16T10:51:09Z

Link auf Modulowner im Forum korrigiert

← Nächstältere Version		Version vom 16. März 2021, 12:51 Uhr
Zeile 4:		Zeile 4:
	\|ModForumArea=Automatisierung		\|ModForumArea=Automatisierung
	\|ModTechName=74_UnifiClient.pm		\|ModTechName=74_UnifiClient.pm
	\|ModOwner=Wuehler ({{Link2FU\|~~Wuehler~~\|Forum}} / [[Benutzer Diskussion:Wuehler\|Wiki]])}}		\|ModOwner=Wuehler ({{Link2FU\|18141\|Forum}} / [[Benutzer Diskussion:Wuehler\|Wiki]])}}

	Das Modul [[UnifiClient]] ermöglicht die Steuerung eines [[Unifi]]-Controllers durch FHEM. Wenn durch den Unifi-Controller auch ein [[UnifiSwitch]] verwaltet wird, so legt das Modul bei aktiviertem [[autocreate]] UnifiSwitch-Devices an.		Das Modul [[UnifiClient]] ermöglicht die Steuerung eines [[Unifi]]-Controllers durch FHEM. Wenn durch den Unifi-Controller auch ein [[UnifiSwitch]] verwaltet wird, so legt das Modul bei aktiviertem [[autocreate]] UnifiSwitch-Devices an.
	Ausserdem gibt es das Unterstützungsmodul [[UnifiClient]], welches alle vorhandenen Informationen zu Clients als Reading bereitstellt und clientspezifische Funktionen zur Verfügung stellt.		Ausserdem gibt es das Unterstützungsmodul [[UnifiClient]], welches alle vorhandenen Informationen zu Clients als Reading bereitstellt und clientspezifische Funktionen zur Verfügung stellt.
Zeile 11:		Zeile 10:
	== Voraussetzungen ==		== Voraussetzungen ==
	=== UnifiModul-Device ===		=== UnifiModul-Device ===
	Es wird ein [[Unifi]]-Device (als IODev) benötigt.		Es wird ein [[Unifi]]-Device (als [[Interface\|IODev]]) benötigt.

	=== Definition ===		== Definition ==
	Die Definition erfolgt mittels <code>define <name> UnifiClient <clientname in Unifi-Modul> </code>.		Die Definition erfolgt mittels <code>define <name> UnifiClient <clientname in Unifi-Modul> </code>.

Ph1959de: diverse kleine Korrekturen

2019-06-04T07:49:05Z

diverse kleine Korrekturen

← Nächstältere Version		Version vom 4. Juni 2019, 09:49 Uhr
Zeile 6:		Zeile 6:
	\|ModOwner=Wuehler ({{Link2FU\|Wuehler\|Forum}} / [[Benutzer Diskussion:Wuehler\|Wiki]])}}		\|ModOwner=Wuehler ({{Link2FU\|Wuehler\|Forum}} / [[Benutzer Diskussion:Wuehler\|Wiki]])}}

	Das Modul [[UnifiClient]] ermöglicht die Steuerung eines Unifi-Controllers durch FHEM. Wenn durch den Unifi-Controller auch ein [[UnifiSwitch]] verwaltet wird, so legt das Modul bei aktiviertem [[autocreate]] UnifiSwitch-Devices an.		Das Modul [[UnifiClient]] ermöglicht die Steuerung eines [[Unifi]]-Controllers durch FHEM. Wenn durch den Unifi-Controller auch ein [[UnifiSwitch]] verwaltet wird, so legt das Modul bei aktiviertem [[autocreate]] UnifiSwitch-Devices an.
	Ausserdem gibt es das Unterstützungsmodul [[UnifiClient]], welches alle vorhandenen Informationen zu Clients als Reading bereitstellt und clientspezifische Funktionen zur Verfügung stellt.		Ausserdem gibt es das Unterstützungsmodul [[UnifiClient]], welches alle vorhandenen Informationen zu Clients als Reading bereitstellt und clientspezifische Funktionen zur Verfügung stellt.

Zeile 18:		Zeile 18:
	== Anwendung ==		== Anwendung ==
	Aufgrund der großen Anzahl an Readings bietet es sich an, die Events mittels Attribut <code>event-on-change-reading</code> einzuschränken.		Aufgrund der großen Anzahl an Readings bietet es sich an, die Events mittels Attribut <code>event-on-change-reading</code> einzuschränken.

	=== Online-Zeitsteuerung ===		=== Online-Zeitsteuerung ===
	Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den ~~client~~ nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu ~~blocken~~ (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).		Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den Client nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu blockieren (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).
	Mit dem Attribut treshholdBytesPerMinute kann die Menge an ~~bytes~~ angegeben werden, die ein Client ohne Anrechnung auf die Onlinezeit verbrauchen darf.
	Es bietet sich folgendes stateFormat an:		Mit dem Attribut treshholdBytesPerMinute kann die Menge an Bytes angegeben werden, die ein Client ohne Anrechnung auf die Onlinezeit verbrauchen darf. Es bietet sich folgendes stateFormat an:
	<~~pre~~>		:<code>{ ReadingsVal("$name","fhem_usedOnlineTime","? Minuten")." / ".ReadingsVal("$name","_f_usergroup_name","? Minuten")." / ".((ReadingsVal("$name","blocked","?") eq "true") ? "blocked":ReadingsVal("$name","fhem_state","?"))}</code>
	{ ReadingsVal("$name","fhem_usedOnlineTime","? Minuten")." / ".ReadingsVal("$name","_f_usergroup_name","? Minuten")." / ".((ReadingsVal("$name","blocked","?") eq "true") ? "blocked":ReadingsVal("$name","fhem_state","?"))}
	</~~pre~~>

	=== Anwesenheitserkennung ===		=== Anwesenheitserkennung ===
	Mittels [[PRESENCE]]:		Mittels [[PRESENCE]]:
	<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>		:<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>

	Oder bei Verwendung von ROOMMATE ohne eigenes PRESENCE-Device per userReadings. Da beim verlassen des WLANs das Handy oft als "wired" an den USG o.ä. "übergeben" wird, mit einer zusätzlichen Abfrage auf <code>is_wired</code>:
	~~<pre>~~
	~~attr <UnifiClientName> userReadings presence {((ReadingsVal("$name","is_wired","?") eq "true") ? "absent" : ((ReadingsVal("$name","fhem_state","?") eq "connected") ? "present":"absent"));;}~~

			Oder, bei Verwendung von ROOMMATE ohne eigenes PRESENCE-Device, per userReadings. Da beim Verlassen des WLANs das Handy oft als "wired" an den USG o.ä. "übergeben" wird, mit einer zusätzlichen Abfrage auf ''is_wired'':
			:<code>attr <UnifiClientName> userReadings presence {((ReadingsVal("$name","is_wired","?") eq "true") ? "absent" : ((ReadingsVal("$name","fhem_state","?") eq "connected") ? "present":"absent"));;}</code>
	und im Roommate:		und im Roommate:
	attr <myRoommate> rr_presenceDevice <UnifiClientName>		:<code>attr <myRoommate> rr_presenceDevice <UnifiClientName></code>
	</~~pre~~>


	Um die Ressourcennutzung des Unifi-Moduls zu reduzieren kann man im DEF des Unifi-Devices das Update-Intervall ~~hoch setzen~~ und nur einzelne Clients mittels at einzeln updaten:		Um die Ressourcennutzung des Unifi-Moduls zu reduzieren, kann man im DEF des Unifi-Devices das Update-Intervall hochsetzen und nur einzelne Clients mittels at einzeln updaten:
	<pre>defmod updateUnifiClients at +*00:00:10 {\		<pre>defmod updateUnifiClients at +*00:00:10 {\
	fhem("set clientName1 update");;\		fhem("set clientName1 update");;\
	fhem("set clientName2 update");;\		fhem("set clientName2 update");;\
	}</pre>		}</pre>

Wuehler: /* Anwesenheitserkennung */ Erweiterung des presence-Readings auf wired-Abfrage

2019-06-03T18:22:07Z

Anwesenheitserkennung: Erweiterung des presence-Readings auf wired-Abfrage

← Nächstältere Version		Version vom 3. Juni 2019, 20:22 Uhr
Zeile 30:		Zeile 30:
	<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>		<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>

	Oder bei Verwendung von ROOMMATE ohne eigenes PRESENCE-Device per userReadings:		Oder bei Verwendung von ROOMMATE ohne eigenes PRESENCE-Device per userReadings. Da beim verlassen des WLANs das Handy oft als "wired" an den USG o.ä. "übergeben" wird, mit einer zusätzlichen Abfrage auf <code>is_wired</code>:
	<pre>		<pre>
	attr <UnifiClientName> userReadings presence {((ReadingsVal("$name","fhem_state","?") eq "connected") ? "present":"absent");;}		attr <UnifiClientName> userReadings presence {((ReadingsVal("$name","is_wired","?") eq "true") ? "absent" : ((ReadingsVal("$name","fhem_state","?") eq "connected") ? "present":"absent"));;}

	und im Roommate:		und im Roommate:

Wuehler: /* Anwesenheitserkennung */

2019-05-30T09:24:31Z

Anwesenheitserkennung

← Nächstältere Version		Version vom 30. Mai 2019, 11:24 Uhr
Zeile 29:		Zeile 29:
	Mittels [[PRESENCE]]:		Mittels [[PRESENCE]]:
	<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>		<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>

			Oder bei Verwendung von ROOMMATE ohne eigenes PRESENCE-Device per userReadings:
			<pre>
			attr <UnifiClientName> userReadings presence {((ReadingsVal("$name","fhem_state","?") eq "connected") ? "present":"absent");;}

			und im Roommate:
			attr <myRoommate> rr_presenceDevice <UnifiClientName>
			</pre>


	Um die Ressourcennutzung des Unifi-Moduls zu reduzieren kann man im DEF des Unifi-Devices das Update-Intervall hoch setzen und nur einzelne Clients mittels at einzeln updaten:		Um die Ressourcennutzung des Unifi-Moduls zu reduzieren kann man im DEF des Unifi-Devices das Update-Intervall hoch setzen und nur einzelne Clients mittels at einzeln updaten:

Wuehler: /* Anwendung */

2019-05-20T20:22:16Z

Anwendung

← Nächstältere Version		Version vom 20. Mai 2019, 22:22 Uhr
Zeile 17:		Zeile 17:

	== Anwendung ==		== Anwendung ==
			Aufgrund der großen Anzahl an Readings bietet es sich an, die Events mittels Attribut <code>event-on-change-reading</code> einzuschränken.
	=== Online-Zeitsteuerung ===		=== Online-Zeitsteuerung ===
	Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den client nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu blocken (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).		Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den client nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu blocken (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).

Wuehler: /* Online-Zeitsteuerung */

2019-05-20T20:17:05Z

Online-Zeitsteuerung

← Nächstältere Version		Version vom 20. Mai 2019, 22:17 Uhr
Zeile 20:		Zeile 20:
	Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den client nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu blocken (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).		Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den client nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu blocken (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).
	Mit dem Attribut treshholdBytesPerMinute kann die Menge an bytes angegeben werden, die ein Client ohne Anrechnung auf die Onlinezeit verbrauchen darf.		Mit dem Attribut treshholdBytesPerMinute kann die Menge an bytes angegeben werden, die ein Client ohne Anrechnung auf die Onlinezeit verbrauchen darf.
			Es bietet sich folgendes stateFormat an:
			<pre>
			{ ReadingsVal("$name","fhem_usedOnlineTime","? Minuten")." / ".ReadingsVal("$name","_f_usergroup_name","? Minuten")." / ".((ReadingsVal("$name","blocked","?") eq "true") ? "blocked":ReadingsVal("$name","fhem_state","?"))}
			</pre>

	=== Anwesenheitserkennung ===		=== Anwesenheitserkennung ===

Wuehler: /* Anwesenheitserkennung */

2019-05-20T19:57:34Z

Anwesenheitserkennung

← Nächstältere Version		Version vom 20. Mai 2019, 21:57 Uhr
Zeile 26:		Zeile 26:

	Um die Ressourcennutzung des Unifi-Moduls zu reduzieren kann man im DEF des Unifi-Devices das Update-Intervall hoch setzen und nur einzelne Clients mittels at einzeln updaten:		Um die Ressourcennutzung des Unifi-Moduls zu reduzieren kann man im DEF des Unifi-Devices das Update-Intervall hoch setzen und nur einzelne Clients mittels at einzeln updaten:
	<~~code~~>		<pre>defmod updateUnifiClients at +*00:00:10 {\
	defmod updateUnifiClients at +*00:00:10 {\
	fhem("set clientName1 update");;\		fhem("set clientName1 update");;\
	fhem("set clientName2 update");;\		fhem("set clientName2 update");;\
	}		}</pre>
	</~~code~~>

Wuehler: /* Anwesenheitserkennung */

2019-05-20T19:53:48Z

Anwesenheitserkennung

← Nächstältere Version		Version vom 20. Mai 2019, 21:53 Uhr
Zeile 22:		Zeile 22:

	=== Anwesenheitserkennung ===		=== Anwesenheitserkennung ===
			Mittels [[PRESENCE]]:
	<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>		<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>

			Um die Ressourcennutzung des Unifi-Moduls zu reduzieren kann man im DEF des Unifi-Devices das Update-Intervall hoch setzen und nur einzelne Clients mittels at einzeln updaten:
			<code>
			defmod updateUnifiClients at +*00:00:10 {\
			fhem("set clientName1 update");;\
			fhem("set clientName2 update");;\
			}
			</code>

Wuehler: Die Seite wurde neu angelegt: „{{Infobox Modul |ModPurpose=Steuerung von Unifi-Clients über FHEM |ModType=d |ModForumArea=Automatisierung |ModTechName=74_UnifiClient.pm |ModOwner=Wuehler (…“

2019-05-20T19:38:25Z

Die Seite wurde neu angelegt: „{{Infobox Modul |ModPurpose=Steuerung von Unifi-Clients über FHEM |ModType=d |ModForumArea=Automatisierung |ModTechName=74_UnifiClient.pm |ModOwner=Wuehler (…“

Neue Seite

{{Infobox Modul
|ModPurpose=Steuerung von Unifi-Clients über FHEM
|ModType=d
|ModForumArea=Automatisierung
|ModTechName=74_UnifiClient.pm
|ModOwner=Wuehler ({{Link2FU|Wuehler|Forum}} / [[Benutzer Diskussion:Wuehler|Wiki]])}}

Das Modul [[UnifiClient]] ermöglicht die Steuerung eines Unifi-Controllers durch FHEM. Wenn durch den Unifi-Controller auch ein [[UnifiSwitch]] verwaltet wird, so legt das Modul bei aktiviertem [[autocreate]] UnifiSwitch-Devices an.
Ausserdem gibt es das Unterstützungsmodul [[UnifiClient]], welches alle vorhandenen Informationen zu Clients als Reading bereitstellt und clientspezifische Funktionen zur Verfügung stellt.

== Voraussetzungen ==
=== UnifiModul-Device ===
Es wird ein [[Unifi]]-Device (als IODev) benötigt.

=== Definition ===
Die Definition erfolgt mittels <code>define <name> UnifiClient <clientname in Unifi-Modul> </code>.

== Anwendung ==
=== Online-Zeitsteuerung ===
Das Modul versucht die Onlinezeit eines Clients zu berechnen und stellt Attribute bereit, um den client nach dem Verbrauch der Online-Zeit (Attribut maxOnlineMinutesPerDay) entweder zu blocken (default; Achtung Provisionierung) oder in eine andere Usergroup zu verschieben (Attribut blockingUsergroup; ohne Provisionierung).
Mit dem Attribut treshholdBytesPerMinute kann die Menge an bytes angegeben werden, die ein Client ohne Anrechnung auf die Onlinezeit verbrauchen darf.

=== Anwesenheitserkennung ===
<code>define <NAME> PRESENCE event <UnifiClientName>:fhem_state:.disconnected <UnifiClientName>:fhem_state:.connected</code>