Skip to content

📡 rtl_433

rtl_433 is a generic data receiver, mainly for the 433.92 MHz, 868 MHz (SRD), 315 MHz, 345 MHz, and 915 MHz ISM bands and is used to read devices.

I use this with Eclipse Mosquitto to connect 433 devices to Home Assistant.

🛠 Hardware

âš™ Config

Find the USB device idVendor and idProduct

sudo lsusb
Output
Bus 001 Device 003: ID 0bda:2838 Realtek Semiconductor Corp. RTL2838 DVB-T

🚫 Blacklist Driver

The default Linux kernel driver dvb_usb_rtl28xxu must be prevented from grabbing the device.

Create blacklist file

Host
echo 'blacklist dvb_usb_rtl28xxu' | sudo tee /etc/modprobe.d/blacklist-rtl.conf

Reboot the host for this to take effect.

🆔 Udev Rule

/etc/udev/rules.d/99-rtl433.rules

SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2838", SYMLINK+="rtl433"

Code

(
  udevadm control --reload-rules 
  udevadm trigger
)

Check that the device exists

ls /dev
Output
rtl433

Add the symlink /dev/rtl433 to devices.

compose.yaml

services:
  rtl433:
    devices:
      - /dev/rtl433:/dev/bus/usb/001/001
compose.yaml 
  rtl433:
    image: hertzg/rtl_433:25.12
    container_name: rtl433
    devices:
      - /dev/rtl433:/dev/bus/usb/001/001
    command:
      - "-Mtime:unix:usec:utc"
      - "-Fmqtt://mosquitto:1883,retain=1,user=${RTL_USER},pass=${RTL_PASS},events=rtl_433[/model][/id]"
      - "-Ccustomary"
      - "-f915M"
      - "-f433.9M"
    restart: unless-stopped
    networks:
      - localnet
    # network_mode: host

🩺 Troubleshooting

MQTT

Listen to a topic: rtl_433/#

| Start listening |

🔗 References