connbox 0.1.0

This is a service to connect and interact with a connbox for Pellet stoves (Palazzetti, Jotul)

Cbox

This project provides an API to interact through http with a Connection Box (a.k.a connBox or cBox) available in your LAN

:bulb: I can't manage to find direct documentation from the connbox manufacturer but basically if you have a stove with a Fumis Controller then you can install a cBox on it and this project is for you.

How to

Check your python installation, python 3.13.+ is required

python --version

Start playing around => check workbench for local dev

async with Cbox.connected_to(host) as cbox:
  # Fetch current cbox info
  print(await cbox.fetch_info())

  # Change cbox settings
  await cbox.change_status(Cbox.Status.OFF)
  await cbox.change_fan_setpoint(FanStatus.AUTO)
  await cbox.change_temperature_setpoint(19)
  await cbox.change_power_setpoint(4)

  # Fetch changed cbox info
  print(await cbox.fetch_info())

Here is the output

DEBUG:cbox.connbox:Fetch infos
{"timestamp": "2024-10-20 09:41:59", "globalStatus": "CHIMNEY_ALARM", "fanSetpoint": "SPEED_1", "powerSetpoint": 1, "temperatureSetpoint": 23, "temperature1": 18.2, "temperature2": 0, "temperature3": 27, "temperature4": 0, "temperature5": 19, "firmwareDate": "2023-07-26", "firmwareVersion": 48}
DEBUG:cbox.connbox:Change status => off
DEBUG:cbox.connbox:Change fan setpoint AUTO
DEBUG:cbox.connbox:Change temperature setpoint => 19
DEBUG:cbox.connbox:Change power setpoing => 4
DEBUG:cbox.connbox:Fetch infos
{"timestamp": "2024-10-20 09:42:03", "globalStatus": "OFF", "fanSetpoint": "AUTO", "powerSetpoint": 4, "temperatureSetpoint": 19, "temperature1": 18.2, "temperature2": 0, "temperature3": 27, "temperature4": 0, "temperature5": 19, "firmwareDate": "2023-07-26", "firmwareVersion": 48}

Resources

Connbox related

Connbox Jotul PDF

Connbox Palazzetti

Application Jotul android Pellet control

Fumis related

Fumis Controller

This controller is integrated by this non exhaustive list of brands :

• Palazzetti / Jotul / TurboFonte / Godin / Fonte Flamme / Invicta / Casatelli / Alpis / Faizen / HETA / ...

If you have this can of controller then you can install a connbox and use this project.

Alternatives

WirelessPalaControl

• Based on a custom connection hardware (no connbox here)
• Written in C++
• Grade A integration with HomeAssistant
• MQTT support

hass-Palazzetti

• All in one HomeAssistant integration
• Written in Python
• Grade B integration with HomeAssistant
  • It exposes a custom service and is not fully integratd as a Climate Entity

Developer's corner

• How to contribute
• About Connbox protocol