
* 🔥 Removes octopress.js * 🔥 Removes use of root_url var * 🔥 Removes Octopress generator reference from feed * 🔥 Removes delicious support * 🔥 Removes support for Pinboard * 🔥 Removes support for Disqus * 🔥 Removes support for Google Plus * ↩️ Migrate custom after_footer to default template * ↩️ Migrate custom footer to default template * ↩️ Migrate custom header to default template * 🔥 Removes unused template files * 🚀 Places time to read directly in post template * 🚀 Removes unneeded capture from archive_post.html template * 🔥 🚀 Removes unused, but heaving sorting call in component page * 🚀 Merged javascripts into a single file * 🔥 Removes more uses of root_url * 🚀 Removal of unneeded captures from head * 🔥 🚀 Removal of expensive liquid HTML compressor * 🔥 Removes unneeded templates * 🚀 Replaces kramdown with GitHub's CommonMark 🚀 * 💄 Adds Prism code syntax highlighting * ✨ Adds support for redirect in Netlify * ↩️ 🔥 Let Netlify handle all developer doc redirects * ✏️ Fixes typo in redirects file: Netify -> Netlify * 🔥 Removes unused .themes folder * 🔥 Removes unused aside.html template * 🔥 Removes Disqus config leftover * 🔥 Removes rouge highlighter config * 🔥 Removes Octopress 🎉 * 💄 Adjust code block font size and adds soft wraps * 💄 Adds styling for inline code blocks * 💄 Improve styling of note/warning/info boxes + div support * 🔨 Rewrites all note/warning/info boxes
3.1 KiB
title, description, logo, ha_category, ha_release, ha_iot_class, redirect_from
title | description | logo | ha_category | ha_release | ha_iot_class | redirect_from | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Freebox | Instructions on how to integrate Freebox routers into Home Assistant. | freebox.svg |
|
0.85 | Local Polling |
|
The freebox
integration allows you to observe and control Freebox router.
There is currently support for the following device types within Home Assistant:
- Sensor with traffic metrics
- Device tracker for connected devices
- Switch to control WiFi
Configuration
If you have enabled the discovery component,
your Freebox should be detected automatically. Otherwise, you can set it
up manually in your configuration.yaml
file:
freebox:
host: foobar.fbxos.fr
port: 1234
{% configuration %} host: description: The url of the Freebox. required: true type: string port: description: The https port the Freebox is listening on. required: true type: string {% endconfiguration %}
You can find out your Freebox host and port by opening
this address in your browser. The
returned json should contain an api_domain (host
) and a https_port (port
).
Initial setup
The first time Home Assistant will connect to your Freebox, you will need to authorize it by pressing the right arrow on the facade of the Freebox when prompted to do so.
To make the WiFi switch working you will have to add "Modification des réglages de la Freebox " permission to Home Assitant application in "Paramètres de la Freebox" > "Gestion des accès" > "Applications".
Supported routers
Only the routers with Freebox OS are supported:
- Freebox V7 also known as Freebox Delta
- Freebox V6 also known as Freebox Revolution
- Freebox mini 4k
Presence Detection
This platform offers presence detection by keeping track of the devices connected to a Freebox router.
Notes
Note that the Freebox waits for some time before marking a device as
inactive, meaning that there will be a small delay (1 or 2 minutes)
between the time you disconnect a device and the time it will appear
as "away" in Home Assistant. You should take this into account when specifying
the consider_home
parameter.
On the contrary, the Freebox immediately reports devices newly connected, so
they should appear as "home" almost instantly, as soon as Home Assistant
refreshes the devices states.
Sensor
This platform offers you sensors to monitor a Freebox router. The monitored conditions are instant upload and download rates in KB/s.
Switch
This platform offers you a switch to toggle the Wifi on or off. This will toggle all WiFi interfaces of the router (all SSID and all bands).