Supporto allo sviluppo
Informazioni su interfacce e protocolli relativi al FRITZ!Box
Apprezziamo molto l'interesse degli utenti per eventuali sviluppi di prodotti nell'ambito della famiglia dei prodotti FRITZ!Box. In questo settore esiste già una serie di progetti con approcci e orientamenti tecnici differenti. FRITZ! assume fondamentalmente una posizione neutrale.
Il FRITZ!Box supporta già, nella sua attuale versione, numerosi progetti di sviluppo di fornitori indipendenti. Per questo sono disponibili interfacce aperte e standardizzate che noi supportiamo all'interno dell'architettura di sistema del FRITZ!Box.
Inoltre, su questa pagina è disponibile un'assistenza avanzata per determinate idee di implementazione. Si augura agli utenti buon successo nella realizzazione dei progetti!
Il seguente documento descrive le modifiche e fornisce raccomandazioni per la guida dell'utente durante l'accesso a un FRITZ!Box. Il documento è rivolto agli sviluppatori che programmano applicazioni di terze parti per il FRITZ!Box. Dal punto di vista della facilità d'uso, si consiglia vivamente agli sviluppatori di applicazioni di terze parti di adattare la guida dell'utente e la terminologia al comportamento dell'interfaccia della FRITZ!Box, a cui l'utente è abituato.
TR-064 è un protocollo sviluppato dal Broadband Forum per configurare i router Internet dalla rete locale. Si basa sullo standard UPnP (Universal Plug and Play), che viene generalmente utilizzato per il controllo di dispositivi di diversi produttori all'interno di reti basate su IP. Gli indirizzi multicast utilizzati da UPnP e quindi anche da TR-064 provengono da un intervallo di indirizzi che non viene instradato. Un accesso al FRITZ!Box tramite TR-064 è quindi possibile solo dalla propria rete locale.
In generale, per la comunicazione è necessario un client software che supporti TR-064. Tramite questo client è possibile effettuare richieste di stato del FRITZ!Box, così come impostare manualmente o tramite un file di configurazione determinati parametri del FRITZ!Box, ad esempio i dati di accesso per la connessione a Internet.
Questo documento fornisce una panoramica delle funzioni offerte:
Questo documento fornisce una panoramica sui primi passi nell'attuazione di un progetto di sviluppo:
- TR-064 – Primi Passi (PDF in inglese)
Versione: 10/10/2024
Questo documento elenca i servizi e i documenti da noi supportati relativi al protocollo TR-064:
- TR-064 – Panoramica (PDF in inglese)
Versione: 10/10/2024
Tutte le estensioni per il FRITZ!Box si riferiscono allo standard TR-064.
| Servizio | Descrizione | Download | Data |
|---|---|---|---|
| WAN | |||
| WANIPConnection | Configurazione WAN, servizio TR-064 in modalità di connessione IP (ad esempio, client IP), stato della connessione, instaurazione e disconnessione della connessione Internet, dati di accesso a Internet, abilitazioni porte, indirizzo IP esterno, server DNS | TR-064_WAN_IP_Connection.pdf | 08/09/2021 |
| WANPPPConnection | Configurazione WAN, servizio TR-064 in modalità di connessione PPPoE (ad esempio, DSL), stato della connessione, instaurazione e disconnessione della connessione Internet, dati di accesso a Internet, abilitazioni porte, indirizzo IP esterno, server DNS | TR-064_WAN_PPP_Connection.pdf | 08/09/2021 |
| WANFiber | Servizi TR-064 per connessioni in fibra ottica | TR-064_WAN_Fiber.pdf | 30/08/2023 (nuovo per FRITZ!OS 8) |
| WANCommonInterfaceConfig | Statistiche WAN, monitor online, tipo di accesso WAN fisico e stato | TR-064_WAN_Common_Interface_Config.pdf | 20/01/2023 |
| WANEthernetLinkConfig | Ethernet-Linkstatus | TR-064_WAN_Ethernet_Link_Config.pdf | 15/07/2009 |
| WANDSLInterfaceConfig | Informazioni DSL (CRC, velocità di trasmissione dati, SNR, ...), diagnostica DSL (ad esempio rilevamento di interruzioni del cavo) | TR-064_WAN_DSL_Interface_Config.pdf | 01/11/2019 |
| WANDSLLinkConfig | Impostazioni VCC, statistiche ATM | TR-064_WAN_DSL_Link_Config.pdf | 17/10/2022 |
| X_AVM-DE_WANMobileConnection | Supporto TR-064 per i prodotti FRITZ! con accesso a Internet tramite rete mobile (5G / 4G). | TR-064_WAN_Mobile_Connection.pdf | 10/10/2024 (nuovo per FRITZ!OS 8) |
| X_AVM-DE_Speedtest | Misurazioni del throughput dei dati | TR-064_Speedtest.pdf | 10/01/2022 |
| X_AVM-DE_RemoteAccess | Dynamic DNS, accesso remoto | TR-064_Remote_Access_SCPD.pdf | 17/10/2022 |
| TR-064_Remote_Access.pdf | 15/08/2018 | ||
| X_AVM-DE_MyFritz | Accesso remoto, MyFRITZ!, Dynamic DNS | TR-064_MyFRITZ.pdf | 14/02/2022 |
| X_AVM-DE_HostFilter | Gestione accessi, blocco di accesso a Internet | TR-064_Host_Filter.pdf | 11/02/2022 |
| Layer3Forwarding | Route di rete IP, tipo di connessione WAN | TR-064_Layer_3_Forwarding.pdf | 15/07/2009 |
| Telefonia | |||
| X_AVM-DE_OnTel | Rubrica telefonica, rubrica telefonica online, elenco chiamate, blocco delle chiamate, deviazione delle chiamate | TR-064_Contact_SCPD.pdf | 10/10/2024 (nuovo per FRITZ!OS 8) |
| X_AVM-DE_TAM | Segreteria telefonica, elenco chiamate | TR-064_TAM.pdf | 14/02/2022 |
| X_VoIP | Configurazione del provider di telefonia Internet, configurazione del telefono LAN/IP, assistenza alla composizione, interni SIP | TR-064_VoIP.pdf | 14/02/2022 |
| Rete locale | |||
| LanDeviceHosts | Dispositivi della rete locale, Wake on LAN, FRITZ!Mesh | TR-064_Hosts.pdf | 10/10/2024 (nuovo per FRITZ!OS 8) |
| WLANConfiguration | Configurazione Wi-Fi e statistiche, dispositivi della rete Wi-Fi | TR-064_WLAN_Configuration.pdf | 10/10/2024 (nuovo per FRITZ!OS 8) |
| LANHostConfigManagement | Impostazioni di rete, server DHCP, intervalli di indirizzi IP, maschera di sottorete | TR-064_LAN_Host_Config_Management.pdf | 20/11/2015 |
| LANEthernetInterfaceConfig | Interfaccia LAN e statistiche (contatore di pacchetti) | TR-064_LAN_Ethernet_Interface_Config.pdf | 15/07/2009 |
| X_AVM-DE_Dect | Dispositivi DECT | TR-064_DECT.pdf | 17/10/2022 |
| X_AVM-DE_Media | TR-064 per i prodotti FRITZ! con supporto DVB-C (ad esempio FRITZ!Box Cable) | TR-064_Media.pdf | 25/02/2022 |
| X_HomeAuto | Dispositivi Smart Home | TR-064_HomeAuto.pdf | 11/02/2022 |
| X_HomePlug | Dispositivi Powerline | TR-064_HomePlug.pdf | 11/02/2022 |
| Memorie/NAS | |||
| X_AVM-DE_Storage | Impostazioni per SMB, FTP | TR-064_Storage.pdf | 14/02/2022 |
| X_AVM-DE_UPnP | Media server UPnP AV | TR-064_UPnP.pdf | 22/09/2009 |
| X_AVM-DE_WebDAV | Configurazione memoria online / WebDAV | TR-064_WebDAV.pdf | 18/09/2009 |
| X_AVM-DE_Filelinks | Condivisioni file | TR-064_Filelinks.pdf | 07/07/2016 |
| Sistema | |||
| DeviceInfo | Informazioni sul prodotto, eventi, codice di provisioning TR-069, porta di sicurezza per TR-064 | TR-064_Device_Info.pdf | 10/10/2024 (nuovo per FRITZ!OS 8) |
| DeviceConfig | Salvataggio/ripristino impostazioni, impostazioni di fabbrica, riavvio generazione SID | TR-064_Device_Config.pdf | 16/02/2022 |
| LANConfigSecurity | Liste utenti e password FRITZ!Box | TR-064_LAN_Config_Security.pdf | 07/06/2022 |
| X_AVM-DE_AppSetup | Gestione delle app (VPN, filtro dei messaggi, permessi, accesso remoto) | TR-064_App_Setup.pdf | 17/02/2022 |
| ManagementService | Configurazione TR-069 | TR-064_Management_Server.pdf | 23/01/2013 |
| X_AVM-DE_USPController | Supporto TR-064 per il protocollo USP (User Services Platform / TR-369) | TR-064_USP_Controller.pdf | 07/10/2022 |
| X_AVM-DE_Auth | Autenticazione a 2 fattori | TR-064_Authentication.pdf | 11/02/2022 |
| Time | Server di riferimento orario (NTP) | TR-064_Time.pdf | 15/02/2022 |
| UserInterface | Informazioni sul firmware e aggiornamento, impostazioni della lingua | TR-064_User_Interface.pdf | 10/10/2024 (nuovo per FRITZ!OS 8) |
| Informazioni disponibili via UPnP | |||
| Internet Gateway Device Spec v1.0 | Il dispositivo terminale fornisce informazioni sulla connessione WAN tramite UPnP, che possono essere richieste senza autenticazione. | IGD_v1.pdf | 20/01/2023 |
| Internet Gateway Device Spec v2.0 | IGD_v2.pdf | 20/01/2023 | |
La trasmissione dei parametri QoS rilevanti avviene tramite le informazioni dell'header X-RTP-Stat nel messaggio SIP-BYE. I dettagli necessari vengono riassunti qui:
Qui vengono spiegate le impostazioni che un provider Internet può utilizzare per configurare in modo ottimale i parametri QoS (Quality of Service) per un FRITZ!Box:
Session ID
L'utilizzo degli ID di sessione offre una protezione efficace contro i cosiddetti attacchi Cross-Site Request Forgery, in cui un aggressore modifica indebitamente i dati in un'applicazione web. Il seguente documento tratta dell'utilizzo degli ID di sessione ed è rivolto agli sviluppatori che programmano strumenti per il FRITZ!Box.
- Session-ID (PDF in inglese)
Versione: 03/05/2021
AHA-HTTP-Interface
La documentazione dell'interfaccia HTTP per il controllo dei dispositivi FRITZ! per la domotica (ad esempio FRITZ!Smart Energy 200/301/302/440/500) permette a un'applicazione esterna di comandare questi dispositivi. I dispositivi devono essere presenti nella rete locale del FRITZ!Box e devono poter essere controllati tramite l'interfaccia utente. Per poter utilizzare tutte le funzionalità dell'interfaccia, è necessario installare la versione release più recente di FRITZ!OS. I dettagli a riguardo sono descritti nella history della documentazione.
- AHA HTTP Interface (PDF in tedesco)
Versione: 21/10/2024 (nuovo per FRITZ!OS 8)
Qui viene spiegato il supporto IPv6 nel FRITZ!Box:
Qui vengono spiegate la topologia Mesh fornita in formato JSON di un FRITZ!Box e le risposte alle domande più frequenti sulla sua interpretazione:
- Mesh Topology (PDF in inglese)
- Mesh Topology Schema v7.8 (JSON)
Versione: 10/10/2024 (nuovo per FRITZ!OS 8)
Per eventuali suggerimenti relativi ai documenti disponibili su questa pagina è possibile contattarci volentieri all'indirizzo Entwicklungssupport@avm.de.
Prima di contattarci tramite questo indirizzo, si prega di aggiornare i propri dispositivi all'ultima versione del firmware e di inviarci in allegati i dati di assistenza generati da http://fritz.box/support.lua.
Nota:Informazioni sui diritti di marchio e d'autore
Prima di avviare uno sviluppo autonomo, si prega di rispettare anche i diritti di marchio e d'autore di FRITZ!. Vorremmo consigliare a questo punto di attenersi alle disposizioni del diritto dei marchi e di scegliere una denominazione del prodotto autonoma, con la quale, ad esempio, "FRITZ!" o "F!" non possano essere considerati come produttore, partner, promotore o simili nell'ambito di tale sviluppo/applicazione. Deve inoltre essere garantito che non ci siano effetti negativi sui prodotti e servizi FRITZ! o sui marchi FRITZ! (ad esempio danni alla reputazione). Inoltre, è escluso l'uso di elementi grafici come il logo FRITZ! e il logo F!, così come l'adozione di elementi grafici tratti dai prodotti FRITZ!, come l'interfaccia utente del FRITZ!Box. Nell'attuazione concreta, questo riguarda tra l'altro sia l'utilizzo dei loghi FRITZ! sia la menzione dei nostri marchi, in particolare "FRITZ!", "F!" o "FRITZ!Box", nel nome di un prodotto sviluppato da un altro distributore. Come semplice indicazione di determinati aspetti o caratteristiche, l'utilizzo di segni simili può essere consentito in singoli casi e in una certa misura. Anche un riferimento all'idoneità del nuovo prodotto sviluppato (esempio: "Nome-del-prodotto-dell'app-esempio, gestione degli indirizzi per FRITZ!Box") in una sottoriga o in un testo discorsivo è consentito in casi specifici e in una certa misura.
Importante:Esclusione di responsabilità e garanzia
Per tutte le funzioni menzionate, così come per l'esattezza della relativa documentazione, non assumiamo alcuna responsabilità né garanzia. Ci riserviamo il diritto di modificare o eliminare, in tutto o in parte, le funzioni in qualsiasi momento e senza preavviso.
