4box S Series – Native MQTT Integration for Home Assistant

Share your Projects! Custom Integrations
1

Hi everyone! :waving_hand:

I’ve created a custom Home Assistant integration for Finder / 4box S Series devices that communicate over MQTT.

The goal was to bring these devices into Home Assistant locally, without relying on the vendor’s cloud or an additional gateway.

:house: What does it support?

The integration currently supports the four device families documented in the 4box MQTT protocol:

  • :electric_plug: Relay / socket devices – switches, power, current, voltage, temperature and energy sensors, plus overcurrent/overtemperature diagnostics

  • :window: Motorized shutters – open/close/stop, position, optional tilt support and calibration

  • :radio_button: Uniko Push – pulse button and relay-active status

  • :thermometer: Thermostats – HVAC mode, target temperature, current temperature and humidity, with optional presets

The devices communicate directly with your Wi-Fi network and use MQTT, so there is no cloud service or proprietary gateway involved. The integration uses Home Assistant’s built-in MQTT integration.

:sparkles: Some highlights

  • Native Home Assistant config flow

  • No external runtime dependencies

  • Local communication via MQTT

  • Energy monitoring compatible with the Home Assistant Energy Dashboard

  • Support for both single- and dual-channel relay devices

  • Position and tilt control for compatible shutters

  • Thermostat control with configurable polling

  • Options can be changed without removing and re-adding devices

:package: Installation

The project is available on GitHub:

GitHub – 4box S Series Home Assistant Integration

The integration can be installed manually, and it can also be added to HACS as a custom repository.

You’ll need:

  • Home Assistant 2024.1 or newer

  • Home Assistant’s MQTT integration configured

  • A 4box S Series device with MQTT enabled through the official 4box app

  • An MQTT broker reachable by the device and Home Assistant

:warning: Current status

At the moment, the integration has been physically tested with a P40S.

Support for the other device families is implemented according to the manufacturer’s MQTT documentation, but I don’t currently have physical units for all of them to test against.

So if you own an M048B/M048C/M048D/M054F/M053B, a Uniko Push device, or a Morpheos thermostat, I’d be very interested in your feedback and testing results! :folded_hands:

There is also a test suite and device simulator in the repository to make development and testing easier.

:handshake: Feedback & contributions

This is my first attempt at bringing the 4box S Series MQTT protocol into Home Assistant, so feedback, bug reports, additional device testing and pull requests are very welcome.

If you have one of these devices and try the integration, please let me know:

  • Which model and firmware you’re using

  • Which features work correctly

  • Which features don’t

  • Any MQTT messages or protocol differences you discover

Hopefully this can be useful to other 4box users who want to bring their devices into Home Assistant without depending on the cloud.

Thanks, and happy automating! :rocket:

This is an independent community project and is not affiliated with, endorsed by, or supported by Finder S.p.A. or 4box.