MeinesmarteWelt: 1 Version importiert

2026-10-23T09:17:37Z

1 Version importiert

← Nächstältere Version

Version vom 23. Oktober 2026, 11:17 Uhr

import>Meine smarte Welt: Import Handbuch 2.0.0

2026-10-23T09:00:00Z

Import Handbuch 2.0.0

Neue Seite

__TOC__

Alle Dienste nehmen zusätzlich das optionale Feld <code><nowiki>config_entry</nowiki></code> (im UI „FRITZ!Box“ mit Auswahlliste) entgegen. Ohne Angabe wirkt ein Dienst auf die zuerst geladene Box; Installationen mit nur einer Box sind nicht betroffen. Dienste erscheinen unter Entwicklerwerkzeuge → Aktionen und lassen sich in Automationen und Skripten nutzen. Dienste, die eine Antwort liefern, nutzt du mit <code><nowiki>response_variable</nowiki></code>.

== fritzbox_netzwerk.set_device_name ==

Ändert die ''Bezeichnung'' (<code><nowiki>X_AVM-DE_FriendlyName</nowiki></code>) eines Geräts, nicht den DNS-Hostnamen. 1–64 Zeichen, Leerzeichen und Sonderzeichen erlaubt, nur bei Geräten mit <code><nowiki>name_writeable</nowiki></code>. Braucht laut AVM das Recht ''App'' für das Konto.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse des Geräts
|-
| <code><nowiki>name</nowiki></code> || ja || neue Bezeichnung
|}

<pre>
action: fritzbox_netzwerk.set_device_name
data:
mac: "3C:A6:F6:00:11:22"
name: "Drucker Arbeitszimmer"
</pre>

== fritzbox_netzwerk.wake_on_lan ==

Sendet ein Wake-on-LAN-Signal.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse
|}

<pre>
action: fritzbox_netzwerk.wake_on_lan
data:
mac: "3C:A6:F6:00:11:22"
</pre>

== fritzbox_netzwerk.set_internet_access (experimentell) ==

Sperrt oder erlaubt den Internetzugang eines Geräts (TR-064 <code><nowiki>X_AVM-DE_HostFilter</nowiki></code>). Verfügbarkeit hängt von Modell und FRITZ!OS ab.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse
|-
| <code><nowiki>blocked</nowiki></code> || ja || <code><nowiki>true</nowiki></code> sperrt, <code><nowiki>false</nowiki></code> erlaubt
|-
| <code><nowiki>minutes</nowiki></code> || nein || nur beim Sperren: danach automatisch wieder freigeben (übersteht einen Neustart)
|}

<pre>
# kurz freigeben, dann wieder sperren
- action: fritzbox_netzwerk.set_internet_access
data: {mac: "3C:A6:F6:00:11:22", blocked: false}
- delay: "00:05:00"
- action: fritzbox_netzwerk.set_internet_access
data: {mac: "3C:A6:F6:00:11:22", blocked: true}
</pre>

== fritzbox_netzwerk.set_mac_filter (experimentell) ==

Schaltet den WLAN-MAC-Filter ein oder aus und beendet ein laufendes Pairing. Braucht die FRITZ!Box-Steuerung.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>enabled</nowiki></code> || ja || <code><nowiki>true</nowiki></code> = Filter an
|}

<pre>
action: fritzbox_netzwerk.set_mac_filter
data:
enabled: true
</pre>

== fritzbox_netzwerk.start_pairing (experimentell) ==

Schaltet den MAC-Filter für <code><nowiki>minutes</nowiki></code> Minuten aus, danach automatisch wieder ein. Nur bei eingeschaltetem Filter.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>minutes</nowiki></code> || nein || 1–120; ohne Angabe die Einstellung ''Pairing-Dauer''
|}

<pre>
action: fritzbox_netzwerk.start_pairing
data:
minutes: 5
</pre>

== fritzbox_netzwerk.reboot_mesh (experimentell) ==

Startet alle FRITZ!-Geräte neu: erst die erreichbaren Repeater, nach kurzer Pause die Box. Ohne Repeater nur die Box.

<pre>
action: fritzbox_netzwerk.reboot_mesh
</pre>

== fritzbox_netzwerk.gast_wlan_info ==

Liefert SSID, Status und einen QR-Code des Gast-WLANs als Antwort des Dienstes (nicht als Sensor – das Passwort landet nie im Verlauf). Antwortfelder: <code><nowiki>ssid</nowiki></code>, <code><nowiki>eingeschaltet</nowiki></code>, <code><nowiki>offen</nowiki></code>, <code><nowiki>passwort</nowiki></code> (<code><nowiki>null</nowiki></code> bei offenem Netz), <code><nowiki>qr_code_svg_base64</nowiki></code> (direkt als <code><nowiki>data:image/svg+xml;base64,…</nowiki></code> nutzbar) und <code><nowiki>dienst</nowiki></code>.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>service</nowiki></code> || nein || WLAN-Dienst 1–4 erzwingen, falls die Erkennung danebenliegt
|}

<pre>
action: fritzbox_netzwerk.gast_wlan_info
data:
service: 4
response_variable: gast_wlan
</pre>

== fritzbox_netzwerk.set_device_note ==

Setzt Etikett, Notiz und „reserviert“ eines Geräts, nur in Home Assistant gespeichert. Nicht übergebene Felder bleiben unverändert, ein leerer Text löscht das Feld.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse
|-
| <code><nowiki>label</nowiki></code> || nein || Etikett
|-
| <code><nowiki>note</nowiki></code> || nein || Notiz
|-
| <code><nowiki>reserved</nowiki></code> || nein || als reserviert markieren
|}

<pre>
action: fritzbox_netzwerk.set_device_note
data:
mac: "3C:A6:F6:00:11:22"
label: Kinderzimmer
note: Gehört Anna
reserved: true
</pre>

== fritzbox_netzwerk.mark_devices_reserved ==

Markiert alle Geräte, deren IP zu einem Muster passt, als „reserviert“ (nur in Home Assistant). Antwort: <code><nowiki>gefunden</nowiki></code>, <code><nowiki>geaendert</nowiki></code>, <code><nowiki>dry_run</nowiki></code>, <code><nowiki>geraete</nowiki></code>.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>ip_filter</nowiki></code> || ja || Muster wie beim IP-Filter der Karte (<code><nowiki>*</nowiki></code>, <code><nowiki>?</nowiki></code>, Komma, <code><nowiki>!</nowiki></code>)
|-
| <code><nowiki>reserved</nowiki></code> || nein || <code><nowiki>false</nowiki></code> hebt die Markierung auf
|-
| <code><nowiki>dry_run</nowiki></code> || nein || nur Vorschau
|}

<pre>
action: fritzbox_netzwerk.mark_devices_reserved
data:
ip_filter: "192.168.178.*,!192.168.178.1"
reserved: true
dry_run: true
response_variable: ergebnis
</pre>

== fritzbox_netzwerk.update_oui ==

Lädt die IEEE-Herstellerregister (MA-L, MA-M, MA-S) neu und gibt die Zahl der Einträge je Register zurück.

== fritzbox_netzwerk.list_access_profiles (experimentell) ==

Liefert alle Zugangsprofile der Kindersicherung (ID und Name). Option nötig.

<pre>
action: fritzbox_netzwerk.list_access_profiles
response_variable: profile
</pre>

== fritzbox_netzwerk.get_access_profile (experimentell) ==

Liefert das aktuelle Zugangsprofil eines Geräts.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse
|}

== fritzbox_netzwerk.set_access_profile (experimentell) ==

Weist einem Gerät ein Zugangsprofil zu, optional zeitlich begrenzt.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse
|-
| <code><nowiki>profile</nowiki></code> || ja || Name oder ID (<code><nowiki>filtprof…</nowiki></code>)
|-
| <code><nowiki>minutes</nowiki></code> || nein || danach wieder das bisherige Profil
|}

<pre>
action: fritzbox_netzwerk.set_access_profile
data:
mac: "3C:A6:F6:00:11:22"
profile: Gesperrt
minutes: 60
</pre>

== fritzbox_netzwerk.install_blueprints ==

Kopiert die mitgelieferten Blueprints in den Blueprint-Ordner. Antwort: Listen <code><nowiki>installiert</nowiki></code>, <code><nowiki>aktualisiert</nowiki></code>, <code><nowiki>unveraendert</nowiki></code>, <code><nowiki>uebersprungen</nowiki></code>.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>overwrite</nowiki></code> || nein || auch abweichende vorhandene Dateien ersetzen
|}

== fritzbox_netzwerk.get_dns_settings (experimentell) ==

Liest die DNS-Einstellungen der Box, ändert nichts.

<pre>
action: fritzbox_netzwerk.get_dns_settings
response_variable: dns
# dns.internet.ipv4.eigene_server, dns.heimnetz.ipv4_lokaler_dns, ...
</pre>

== fritzbox_netzwerk.set_dns_settings (experimentell) ==

Ändert DNS-Einstellungen. Braucht die Option „DNS-Einstellungen der Box ändern“ (nicht für <code><nowiki>dry_run</nowiki></code>). Antwort: <code><nowiki>geschrieben</nowiki></code>, <code><nowiki>aenderungen</nowiki></code> (<code><nowiki>vorher</nowiki></code>/<code><nowiki>nachher</nowiki></code>), <code><nowiki>ergebnis</nowiki></code>. Nicht angegebene Felder bleiben unverändert; ein leerer Text löscht bei Internet-DNS und zweitem Server den Eintrag.

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>internet_ipv4_custom</nowiki></code>, <code><nowiki>…_dns1</nowiki></code>, <code><nowiki>…_dns2</nowiki></code> || nein || eigene DNSv4-Server der Internetverbindung
|-
| <code><nowiki>internet_ipv6_custom</nowiki></code>, <code><nowiki>…_dns1</nowiki></code>, <code><nowiki>…_dns2</nowiki></code> || nein || eigene DNSv6-Server der Internetverbindung
|-
| <code><nowiki>home_ipv4_dns</nowiki></code> || nein || lokaler DNS-Server (IPv4) im Heimnetz
|-
| <code><nowiki>home_ipv6_dns</nowiki></code>, <code><nowiki>home_ipv6_advertise</nowiki></code> || nein || lokaler DNSv6-Server und Router Advertisement
|-
| <code><nowiki>dry_run</nowiki></code> || nein || nur Vorschau
|}

<pre>
action: fritzbox_netzwerk.set_dns_settings
data:
internet_ipv4_custom: true
internet_ipv4_dns1: "9.9.9.9"
internet_ipv4_dns2: "149.112.112.112"
dry_run: true
</pre>

== fritzbox_netzwerk.set_static_ip (experimentell) ==

Weist einem Gerät eine feste IPv4-Adresse zu. Braucht die Option „Statische IP-Adresse setzen“ (nicht für <code><nowiki>dry_run</nowiki></code>).

{| class="wikitable" style="width:100%"
! Feld !! Pflicht !! Bedeutung
|-
| <code><nowiki>mac</nowiki></code> || ja || MAC-Adresse
|-
| <code><nowiki>ip</nowiki></code> || ja || gewünschte Adresse
|-
| <code><nowiki>dry_run</nowiki></code> || nein || nur Prüfung
|}

<pre>
action: fritzbox_netzwerk.set_static_ip
data:
mac: "3C:A6:F6:00:11:22"
ip: "192.168.178.50"
dry_run: true
</pre>

----
← [[FRITZ!Box Netzwerk/Sensoren und Ereignisse|Sensoren und Ereignisse]] | [[FRITZ!Box Netzwerk|Inhaltsübersicht]] | [[FRITZ!Box Netzwerk/Blueprints|Blueprints]] →

[[Kategorie:FRITZ!Box Netzwerk]]

FRITZ!Box Netzwerk/Dienste (Aktionen) - Versionsgeschichte

MeinesmarteWelt: 1 Version importiert

import>Meine smarte Welt: Import Handbuch 2.0.0