Plugin avm¶
Im folgenden sind etwaige Anforderungen und unterstützte Hardware beschrieben. Danach folgt die Beschreibung, wie das Plugin avm konfiguriert wird. Außerdem ist im folgenden beschrieben, wie das Plugin in den Item Definitionen genutzt werden kann. 1
Beschreibung¶
Ansteuerung von AVM FRITZ!Boxen, WLAN-Repeatern, DECT Steckdosen, etc.
Anforderungen¶
Minimum SmartHomeNG Version: 1.6
Konfiguration¶
Im folgenden ist beschrieben, wie das Plugin avm konfiguriert wird. Außerdem ist im folgenden beschrieben, wie das Plugin in den Item Definitionen genutzt werden kann.
Parameter¶
Das Plugin verfügt über folgende Parameter, die in der Datei ../etc/plugin.yaml konfiguriert werden:
call_monitor¶
(optional) Aktiviert oder deaktiviert den MonitoringService, welcher auf den Call Monitor des FritzDevice verbindet. Der Call Monitor muss über ein verbundenes Telefon via #96*5* aktiviert sein.
Datentyp: bool
Standardwert: False
call_monitor_incoming_filter¶
(optional) Spezielle Rufnummern ausfiltern, die vom Callmonitor ignoriert werden sollen.
Datentyp: str
cycle¶
(optional) Zeit zwischen zwei Updateläufen. Default ist 300 Sekunden.
Datentyp: int
Standardwert: 300
password¶
(optional) Passwort für den Login. Wird in der Regel immer benötigt und aus Sicherheitsgründen empfohlen.
Datentyp: str
port¶
(optional) Port des FritzDevice, normalerweise 49433 für https oder 49000 für http
Datentyp: int
Standardwert: 49443
ssl¶
(optional) Mit True wird das FritzDevice via https, mit False via http angesprochen.
Datentyp: bool
Standardwert: True
username¶
(optional) Nutzername für den Login. Kann für manche Features benötigt werden! (Speziell für Fritz!OS 7 ist die Konfiguration der Fritz!Box auf Anmeldung mit FRITZ!Box-Benutzernamen und Kennwort notwendig
Datentyp: str
verify¶
(optional) Schaltet die Zertifikate-Prüfung an oder aus. Normalerweise False.
Datentyp: bool
Standardwert: False
Item Attribute¶
Das Plugin unterstützt folgende Item Attribute, die in den Dateien im Verzeichnis ../items verwendet werden:
ain¶
Definition der Aktor Identifikationsnummer (AIN)Items vom avm_data_type aha_device. Nur für diese Items mandatory!
Datentyp: str
avm_data_type¶
AVM Datentyp des jeweiligen Items.
Datentyp: str
Mögliche Werte:
uptime
serial_number
software_version
hardware_version
myfritz_status
monitor_trigger
is_call_incoming
call_duration_incoming
last_caller_incoming
last_number_incoming
last_called_number_incoming
last_call_date_incoming
call_event_incoming
is_call_outgoing
call_duration_outgoing
last_caller_outgoing
last_number_outgoing
last_called_number_outgoing
last_call_date_outgoing
call_event_outgoing
call_direction
call_event
tam
tam_name
tam_old_message_number
tam_new_message_number
tam_total_message_number
wan_connection_status
wan_connection_error
wan_is_connected
wan_uptime
wan_ip
wan_upstream
wan_downstream
wan_total_packets_sent
wan_total_packets_received
wan_current_packets_sent
wan_current_packets_received
wan_total_bytes_sent
wan_total_bytes_received
wan_current_bytes_sent
wan_current_bytes_received
wan_link
wlanconfig
wlanconfig_ssid
wlan_guest_time_remaining
network_device
device_ip
device_connection_type
device_hostname
aha_device
energy
power
temperature
set_temperature
set_temperature_reduced
set_temperature_comfort
hkr_device
firmware_version
manufacturer
product_name
device_name
connection_status
device_id
device_function
set_hkrwindowopen
avm_incoming_allowed¶
(optional) Definition der erlaubten eingehenden Rufnummer in Items vom avm_data_type monitor_trigger.
Datentyp: str
avm_mac¶
Definition der MAC Adresse für Items vom avm_data_type network_device. Nur für diese Items mandatory!
Datentyp: mac
avm_target_number¶
(optional) Definition der erlaubten angerufenen Rufnummer in Items vom avm_data_type monitor_trigger.
Datentyp: str
avm_wlan_index¶
(optional) Definition des Wlans ueber index: (1: 2.4Ghz, 2: 5Ghz, 3: Gaeste).
Datentyp: int
index¶
Index für den Anrufbeantworter, normalerweise für den ersten eine „1“. Es werden bis zu 5 Anrufbeantworter vom Gerät unterstützt.
Datentyp: num
Logik Parameter¶
Das Plugin verfügt über folgende Parameter, die in der Datei ../etc/logic.yaml konfiguriert werden:
Keine Logik Parameter in den Metadaten beschrieben - Bitte in der README nachsehen (siehe Fußnote)
Plugin Functions¶
Das Plugin verfügt über folgende öffentliche Funktionen, die z.B. in Logiken aufgerufen werden können.
get_call_origin()¶
Gib den Namen des Telefons zurück, das aktuell als ‚call origin‘ gesetzt ist.
Ergebnistyp der Funktion: str
get_calllist(filter_incoming= ‚‘, phonebook_id=0)¶
Ermittelt ein Array mit dicts aller Einträge der Anrufliste (Attribute ‚Id‘, ‚Type‘, ‚Caller‘, ‚Called‘, ‚CalledNumber‘, ‚Name‘, ‚Numbertype‘, ‚Device‘, ‚Port‘, ‚Date‘,‘ Duration‘ (einige optional)).
Ergebnistyp der Funktion: list(dict(str))
filter_incoming¶
Filter, um nur die Anrufe zu erhalten, die zu einer bestimmten angerufenen Nummer gehören.
Datentyp: str
get_contact_name_by_phone_number(phone_number, phonebook_id=0)¶
Durchsucht das Telefonbuch mit einer (vollständigen) Telefonnummer nach Kontakten. Falls kein Name gefunden wird, wird die Telefonnummer zurückgeliefert.
Ergebnistyp der Funktion: str
get_device_log_from_lua()¶
Ermittelt die Logeinträge auf dem Gerät über die LUA Schnittstelle /query.lua?mq_log=logger:status/log.
Ergebnistyp der Funktion: list(list(str))
get_device_log_from_tr064()¶
Ermittelt die Logeinträge auf dem Gerät über die TR-064 Schnittstelle.
Ergebnistyp der Funktion: list(str)
get_host_details(index)¶
Ermittelt die Informationen zu einem Host an einem angegebenen Index.
Ergebnistyp der Funktion: dict(str)
get_hosts(only_active)¶
Ermittelt ein Array mit den Namen aller verbundener Hosts.
Ergebnistyp der Funktion: list(dict(str))
get_phone_name(index)¶
Gibt den Namen eines Telefons an einem Index zurück. Der zurückgegebene Wert kann in ‚set_call_origin‘ verwendet werden.
Ergebnistyp der Funktion: str
get_phone_numbers_by_name(name, phonebook_id=0)¶
Durchsucht das Telefonbuch mit einem Namen nach nach Kontakten und liefert die zugehörigen Telefonnummern.
Ergebnistyp der Funktion: dict(dict(str))
is_host_active(mac_address)¶
Prüft, ob eine MAC Adresse auf dem Gerät aktiv ist. Das kann bspw. für die Umsetzung einer Präsenzerkennung genutzt werden.
Ergebnistyp der Funktion: bool
reconnect()¶
Verbindet das Gerät neu mit dem WAN (Wide Area Network).
Die Funktion liefert kein Ergebnis
set_call_origin(phone_name)¶
Setzt den ‚call origin‘, bspw. vor dem Aufruf von ‚start_call‘.
Die Funktion liefert kein Ergebnis
phone_name¶
Identifikator des Telefons, dass als ‚call origin‘ gesetzt werden soll. Bspw. zwei Sterne gefolgt von ‚610‘ für ein internes Gerät.
Datentyp: mac
start_call(phone_number)¶
Startet einen Anruf an eine übergebene Telefonnummer (intern oder extern).
Die Funktion liefert kein Ergebnis
wol(mac_address)¶
Sendet einen WOL (WakeOnLAN) Befehl an eine MAC Adresse.
Die Funktion liefert kein Ergebnis
mac_address¶
MAC Adresse
Datentyp: mac
- 1
Diese Seite wurde aus den Metadaten des Plugins erzeugt. Für den Fall, dass diese Seite nicht alle benötigten Informationen enthält, bitte auf die englischsprachige README Datei des Plugins zugreifen.