Description
My ISP (Free) fiber modem (Freebox) has a pretty rich API to control and monitor it.
It is currently supported in Home Assistant but not to the full extend of the available API, including additional Wifi repeaters.
Goals
Adding support for Wifi repeaters linked to the ISP modem in Home Assistant.
Resources
https://dev.freebox.fr/sdk/os/ (old version of the API) the latest version of the api is only available from the modem webUI atm
Looking for hackers with the skills:
This project is part of:
Hack Week 25
Activity
Comments
-
6 days ago by fcrozat | Reply
I tested the freebox OS api, using both python and its bash implementation to understand better the api. It is possible to detect all devices connected to both main isp box and its wifi repeaters, already.
However, this part of the api is not used at all on Home Assistant integration.
But digging a bit in home assistant code, it appears all connected devices are properly exported in Home assistant but entities to track them are disabled by default if there is no other integrations for those devices. After manually enabling them, I can now track if some become disconnected and act accordingly in HA automation.
There is no real need for now to expand HA Freebox integration to support Wifi status, at least for my usage.
Closing this project as done
Similar Projects
Hack / Access old Freebox Delta wifi webcam by fcrozat
Description
French ISP Free was providing a wifi webcam which would integrate with their alarm offering but could only be used with one version of their fiber modem.
I've switch to a new generation of modem and the alarm offering is gone but I still own the webcam which is not usable anymore.
Goals
Try to get access to the webcam feed (either reprovision it or access its video feed) to integrate it on Home Assistant.
Resources
Smart-Home Reverse Engineering and Automation by pstivanin
Description
This project focuses on expanding smart-home automation by reverse-engineering several closed systems, developing missing integrations, and unifying them into a fully automated Home Assistant environment. The work includes protocol analysis, custom API design, and deep automation logic, combined with improvements to monitoring and camera workflows. The outcome will be a coherent ecosystem with enhanced control, transparency, and automation for heating, circulation, security, and access systems.
Goals
Samsung EHS
- Add the Elfin-EW11 to the hydronic module (F1/F2)
- Install the EHS integration and set it up
- Add automation and dashboards for anti-legionella, temperatures, COP, etc
Grundfos Recirculation Pump
- Disassemble the pump and add the custom PCB
- Write ESPHome firmware
- Integrate the pump into HA with simple and advanced automation modes (e.g. shower, anti-legionella, etc)
External Gate Automation
- Add two Shelly relays (pedestrian + full-open).
- Implement arrival automation, remote access, and safety timers.
Extra goals
- Look into influxdb and grafana for storing long term data like PV
- Look into an outdoor air quality monitor so that I can better control my CMV
Done
Garage Door Automation
- Add a Shelly relay for control
- Add optional open/close detection.
- Implement routines such as auto-close, geofence open, timeout warning.
Camera Dashboard
- Add WebRTC real-time feeds.
- Add controls for lights, sirens, strobe, and presets.
- Create a multi-camera layout optimized for mobile and desktop.
- Show IVS events (tripwire, intrusion).
Pellet Stove
- Reverse engineer the WINET protocol.
- Implement structured sensor parsing (temperatures, status, alarms).
- Implement command support for ON/OFF, power level, fan, and shutdown.
- Create robust automations for daily routines and error handling.
Dahua Event Proxy Server
Play with esp32 to create domotics stuff by aginies
Description
Play with ESP32 board and multiple small peripherals
https://github.com/aginies/domotique
Goals
- Finish the pool project
- add support of NFC auth in the door project
- improve the doc
- project to manage solar panel (router)
Resources
esp32 home
ESPClock: An open-source smart desk clock with Home Assistant integration by jbaier_cz
Description
ESPClock will be an open-source, Wi-Fi connected digital clock powered by ESP32 and ESPHome, designed to seamlessly integrate with Home Assistant. Featuring a 3D-printable case, the clock combines modern style with smart home functionality.
Goals
Key features:
- real-time clock
- native Home Assistant integration
- optional sensors for temperature, humidity and ambient light
- custom 3D-printable case
- open-source firmware and hardware design
- easy YAML-based configuration
Resources
- https://esphome.io/
- https://gist.github.com/baierjan/773e20a5061780f0a27ed86619dbffba
The Hacking
Chapter 1: Inventory
After thoroughly inspecting my closet, I managed to gather a handful of useful components. I decided to keep things simple and avoid making the project unnecessarily complex, opting for ready-made modules instead of assembling everything from individual parts. This approach saves time and reduces the chances of compatibility issues. The components I settled on are:
- Microcontroller: ESP32-LPkit
- 4-digit 7-segment display with integrated controller: TM1637
- Temperature and humidity sensor: DHT22
- Carbon dioxide sensor: MH-Z19
- PIR motion sensor: AM312
- Illumination sensor: VEML7700
- I2S-compatible microphone module: SPH0645LM4H
- A couple of micro switches
- A few LED diodes with appropriate resistors
With this list, the essential environmental parameters should be well covered. The clock’s main function—displaying the current time—is handled by the bright 0.56-inch display. Additionally, the setup provides simple input options through buttons and possibly even voice commands in the future.
Chapter 2: Wiring Diagram
I went through the datasheets for all the components to determine the most effective way to connect them. After comparing different options and checking for compatibility, I finalized the following wiring diagram.
Chapter 3: Firmware
For the software part, I decided to use ESPHome, which offers an easy and reliable way to integrate the clock with Home Assistant. All the components from the inventory are natively supported, so there is no need to write much additional code.
The following example shows how the YAML configuration for the clock may look: espclock.yaml
Smart-Home Reverse Engineering and Automation by pstivanin
Description
This project focuses on expanding smart-home automation by reverse-engineering several closed systems, developing missing integrations, and unifying them into a fully automated Home Assistant environment. The work includes protocol analysis, custom API design, and deep automation logic, combined with improvements to monitoring and camera workflows. The outcome will be a coherent ecosystem with enhanced control, transparency, and automation for heating, circulation, security, and access systems.
Goals
Samsung EHS
- Add the Elfin-EW11 to the hydronic module (F1/F2)
- Install the EHS integration and set it up
- Add automation and dashboards for anti-legionella, temperatures, COP, etc
Grundfos Recirculation Pump
- Disassemble the pump and add the custom PCB
- Write ESPHome firmware
- Integrate the pump into HA with simple and advanced automation modes (e.g. shower, anti-legionella, etc)
External Gate Automation
- Add two Shelly relays (pedestrian + full-open).
- Implement arrival automation, remote access, and safety timers.
Extra goals
- Look into influxdb and grafana for storing long term data like PV
- Look into an outdoor air quality monitor so that I can better control my CMV
Done
Garage Door Automation
- Add a Shelly relay for control
- Add optional open/close detection.
- Implement routines such as auto-close, geofence open, timeout warning.
Camera Dashboard
- Add WebRTC real-time feeds.
- Add controls for lights, sirens, strobe, and presets.
- Create a multi-camera layout optimized for mobile and desktop.
- Show IVS events (tripwire, intrusion).
Pellet Stove
- Reverse engineer the WINET protocol.
- Implement structured sensor parsing (temperatures, status, alarms).
- Implement command support for ON/OFF, power level, fan, and shutdown.
- Create robust automations for daily routines and error handling.
Dahua Event Proxy Server
Hack / Access old Freebox Delta wifi webcam by fcrozat
Description
French ISP Free was providing a wifi webcam which would integrate with their alarm offering but could only be used with one version of their fiber modem.
I've switch to a new generation of modem and the alarm offering is gone but I still own the webcam which is not usable anymore.
Goals
Try to get access to the webcam feed (either reprovision it or access its video feed) to integrate it on Home Assistant.
Resources
ESPClock: An open-source smart desk clock with Home Assistant integration by jbaier_cz
Description
ESPClock will be an open-source, Wi-Fi connected digital clock powered by ESP32 and ESPHome, designed to seamlessly integrate with Home Assistant. Featuring a 3D-printable case, the clock combines modern style with smart home functionality.
Goals
Key features:
- real-time clock
- native Home Assistant integration
- optional sensors for temperature, humidity and ambient light
- custom 3D-printable case
- open-source firmware and hardware design
- easy YAML-based configuration
Resources
- https://esphome.io/
- https://gist.github.com/baierjan/773e20a5061780f0a27ed86619dbffba
The Hacking
Chapter 1: Inventory
After thoroughly inspecting my closet, I managed to gather a handful of useful components. I decided to keep things simple and avoid making the project unnecessarily complex, opting for ready-made modules instead of assembling everything from individual parts. This approach saves time and reduces the chances of compatibility issues. The components I settled on are:
- Microcontroller: ESP32-LPkit
- 4-digit 7-segment display with integrated controller: TM1637
- Temperature and humidity sensor: DHT22
- Carbon dioxide sensor: MH-Z19
- PIR motion sensor: AM312
- Illumination sensor: VEML7700
- I2S-compatible microphone module: SPH0645LM4H
- A couple of micro switches
- A few LED diodes with appropriate resistors
With this list, the essential environmental parameters should be well covered. The clock’s main function—displaying the current time—is handled by the bright 0.56-inch display. Additionally, the setup provides simple input options through buttons and possibly even voice commands in the future.
Chapter 2: Wiring Diagram
I went through the datasheets for all the components to determine the most effective way to connect them. After comparing different options and checking for compatibility, I finalized the following wiring diagram.
Chapter 3: Firmware
For the software part, I decided to use ESPHome, which offers an easy and reliable way to integrate the clock with Home Assistant. All the components from the inventory are natively supported, so there is no need to write much additional code.
The following example shows how the YAML configuration for the clock may look: espclock.yaml