Haverland Radiators Smart Box Integration

I have something working at least to some extent now - it creates a climate entity for each heater (as well as a temperature sensor, which might be a bit redundant), and you can do the very basics:

  • Get the current temperature and target temperature
  • Change HVAC mode (off/manual/auto)
  • Set the target temperature

There’s a lot more to do before this is usable, probably most notably packaging it properly, but also I need to make sure token refresh for the websocket session is working properly (access tokens expire after four hours).

I’ve released the code here: https://github.com/graham33/hass-smartbox in case you want to take a look. As I say, it probably needs a bit more work before it’s usable by others.

Here’s a screenshot to prove it:

This is excellent. Do I need to clone as a custom component? Is there a sample config for passing parameters?

Yes you’ll need to install it as a custom component. I’ve added some basic docs and fixed up the packaging a bit. Hopefully it should work but I’ve only tested it locally so you might run into some issues.

In terms of functionality, I’m still having trouble with reconnecting the web socket when the token expires. I’ve had another go at fixing that with the latest version, but it likely still has some issues.

Thanks for the update. How do i load the smartbox module in hass? I’ve been struggling with that bit

You need to install the smartbox python module, how you do that will depend on what kind of Home Assistant installation you have. If you have the ability to run pip install in the python environment where HA is running you should be able to install directly from github. I haven’t put the module on PyPi or anything yet since it’s quite early days.

I was able to get it installed by updating the manifest because i don’t have access to pip in Hass

“requirements”: [
“git+https://github.com/graham33/smartbox.git@main#smartbox==0.0.3”
],

I haven’t been able to get the radiators to show up yet. Should they just appear automatically?

I was able to get connected. It turns out the radiators won’t show up if you aren’t using the main account on the system. I used the details for the primary account and everything appeared

Thanks, will fix the requirements ref in the next update.

I only have one user on my system and haven’t looked into it how they work, I suspect different users might not have some necessary permissions, but there is a whole REST API for users that I haven’t investigated.

I think I’ve managed to get reconnection on token expiry working, but I’m adding some tests to make sure.

Hi everyone, I’m trying to setting up my radiator from HJM. I get all the details like user, pass and api (https://api-hjm.helki.com/) but how I get the HTTP Basic Auth credential ?

thanks!

Google ‘HTTP Basic Authentification’. You will find way to generate the credential from your id and password.

2 Likes

I installed the python smartbox using pip, pasted the “custom_components” folder in the main HA folder and configure the smartbox into the yaml file but I don’t see the radiators. any help? thanks

Are you getting any errors in your logs?

No, the smartbox doesn’t show in mi logs

You should see something in the logs even if it is successful or not

@ajtudela make sure you have a smartbox section in your configuration.yaml. You should see a message like:

[homeassistant.setup] Setting up smartbox

I’ve just released v0.0.3 which adds reconnect support, some internal refactorings and a few other fixes: https://github.com/graham33/hass-smartbox/releases/tag/v0.0.3. It seems to be working for me, will now try to add some more features (e.g. away/eco mode, power sensor).

It needs v0.0.4 of the smartbox package (https://github.com/graham33/smartbox/releases/tag/v0.0.4).

Thanks @gr_h_m and @davefrooney. I’ve managed to get the component!

Hello everyone!

I am subscribed to this thread and have been watching as there has been progress. However, I am not very advanced in HA and would like to know if you have been able to create a small step by step to integrate HJM radiators in HA.
I thank you all for the effort you are making and for sharing it with everyone.

Thank you very much!

I will try put something together tomorrow. Did you have a look at the github? Are there any steps in particular that you’re stuck on?

+1
I use Hass.io and do not know how to install the python smartbox package.
Thank you in advance.