Rtl_433 - a custom component to read data from radio sensors

See the documentation site for all of the current details and setup instructions.

Highlights include:

  • A fully-featured Home Assistant integration that uses the http / websocket API instead of MQTT. This replaces the autodiscovery script and addon. New features include built-in support to measure and set PPM offsets, measuring the noise floor, and stamping a unique serial number on radios that ship with a generic “#1” serial.
  • A new addon that works with this integration. Notably, it ditches the entire templating system for configuration and instead works where you can append custom configuration to what is shipped out of the box. New features include full Availability support, support for managing the radio settings directly from Home Assistant, and an in-UI device mapping library so new devices can be supported without waiting for an integration update.
  • A Python library for the actual API calls to rtl_433 - this is a requirement for eventually upstreaming the integration to Home Assistant core.

I’ve been running these myself in my normal home system for the past month or so. My hope is that setup and installation is much easier - I’ve seen myself first-hand new users getting really tripped up on the autodiscovery side of things with the original addon I’ve been maintaining at Home Assistant Add-on: rtl_433 with MQTT auto discovery.

5 Likes

Nicely done. I like notifications when a device is discovered. Comparing to GitHub - catduckgnaf/rtl_433_haos_addon: Add-On for RTL_433 Home Assistant Community Edition! · GitHub Are there any options to: enable discovering devices in specific protocols only? Show something similar in logs like: Auto Level: Current noise level -11.8 dB, estimated noise -11.8 dB?

Thanks for the feedback!

Yes, the addon still has support for customizing the configuration file. By default, it disables TPMS sensors (and that’s got a checkbox in the addon settings). For anything beyond that, if you look at the startup logs it will tell you where to upload a custom configuration file that’s merged into the basic one it sets up.

however you may not need to do that - I haven’t at least! On the integration side, each hub has a discovery on / off toggle. Turn it on, wait until your desired devices are registered, and turn it back off. Even though the underlying rtl_433 process will be decoding all protocols, nothing new will show up in Home Assistant. If any extra devices are registered, you can delete them as normal in Home Assistant and they won’t come back unless you re-enable discovery.

Any verbose logs will show up on the addon side, as long as rtl_433 is configured to emit them. I don’t think the auto level information is available on the HTTP API.

You might find the device diagnostic entities do what you’re looking for. They’re disabled by default, but if you turn them on you can see noise / RSSI / SNR for each device. I’ve used it myself in troubleshooting flaky connections.

OK thanks for the tip. I’ve noticed that sometimes mydevices are not being discovered because of the big noise. That is why I use these noise level logs…

Perhaps a dumb question, but how do I find the Hostname or IP address of the rtl_433 server.?
Thanks.

1 Like

It looks like rtl_433 does emit this over http, and we were just dropping the messages in the Python library :see_no_evil_monkey: . I’m not sure how to best surface this in home assistant (the logs aren’t structured, so a future rtl_433 change could break text parsing).

Ooo, good point. The ideal workflow is that you install the integration first, reboot Home Assistant (so it’s installed), and the start up the addon. It will post a discovery tile to Integrations and everything will be preconfigured. But if you have the addon first, install the integration, and reboot, the discovery message will have been sent before the reboot and it won’t show up.

I’ll at least get docs improvements up for that to make it clearer. It looks like looping and re-posting discovery messages isn’t a common or good practice, so I think the docs are the best way to go.

Thanks, but I can’t even get the Integration installed. Can’t get past the below:

Where is your rtl radio set up? Is it plugged into the same machine and using the addon?

If the radio is connected somewhere else, then the host or ip address is for whatever device is running rtl_433.

Yes it is. I tried using the Host Name below and it did not work.

Ah! You’re using the old addon from the original repository.

Add GitHub - rtl-433-hass/rtl_433-hass-addons: Home Assistant App / add-on for rtl_433 · GitHub as a new addon repository, and you can stop the one you have installed (and turn off Start on boot too). Then, when you start the new addon, discovery should work and it should show up as a new integration to enable.

1 Like

Does this component support 868Mhz ?

Yes! You can change the frequency once it’s connected (here’s mine for doorbells), or you can choose not to manage the settings in the HA UI and write the config file yourself.

1 Like

Hello,
Do you think I can install Visonic sensors operating at 868 MHz?

I don’t see Visonic listed in the supported list of decoders, unless it is the same protocol under another brand name.

https://triq.org/rtl_433/

But theoretically, as long as the signals aren’t encrypted, it would be possible to write a decoder to do that: https://triq.org/rtl_433/CONTRIBUTING.html

Home Assistant Add-on: rtl_433 with MQTT auto discovery why reinvent the wheel?

Key difference … With or Without
or Orange vs apples

Did you want to encourage him?

This project isn’t exactly easy, and personally, I appreciate that someone is trying to make it more accessible and document it better.

1 Like

i Totally agree, and i felt the same when reading about it ( in the provided urls ) …which it seems David hasn’t

2 Likes

That did it!

1 Like

I’ve actually been the only maintainer of the addon you’ve linked to for several years now. I haven’t heard from Peter in about the amount of time. So, I’m well versed in the ups and downs of that one’s architecture (and several decisions I made myself!).

But, no need to change unless you want to! It’s still there and will continue to work.

2 Likes