rtl_433: як приймати бездротові датчики на 433 і 868 МГц
rtl_433 — відкритий декодер бездротових датчиків у діапазонах ISM: найчастіше на 433,92 МГц, але також на 868 МГц (у Європі — пристрої короткого радіусу дії, SRD), 315, 345 і 915 МГц. Працює з донглом RTL-SDR (або будь-яким SDR, що підтримує SoapySDR). Метеостанції, термостати, датчики й лічильники передають відкрито, без спарювання, короткі повідомлення через певні проміжки часу; rtl_433 впізнає їх серед своїх декодерів (їх уже 386).
| Величина | Значення |
|---|---|
| Дуже поширений канал | 868,3 МГц |
| Частота дискретизації за замовчуванням | 250 кГц |
| Частота за замовчуванням | 433,92 МГц |
| Найбільший номер декодера | 386 |
Як воно йде
Донгл оцифровує смугу й віддає сирий сигнал (IQ) програмі rtl_433. Та знаходить імпульси, демодулює, ріже на кадри й приміряє кожен до своїх декодерів. Більшість перевіряє контрольну суму, перш ніж показати результат. Четвертьхвильова антена — розміри в картці 1.
Як встановити й запустити
| Система | Команда чи спосіб |
|---|---|
| Debian, Ubuntu | sudo apt install rtl-433 |
| macOS | brew install rtl_433 |
| FreeBSD | pkg install rtl-433 |
| Docker | Образи спільноти (проєкт rtl_433_docker від hertzg) |
| З вихідного коду | docs/BUILDING.md у репозиторії GitHub merbanan/rtl_433 |
| Перша спроба | rtl_433 -f 868.3M — нехай попрацює кілька хвилин: датчики передають не безперервно |
Діапазон 868 МГц
Кожна підсмуга має свій найбільший робочий цикл: за 1 % передавач займає канал не довше 36 с на годину. Тому датчики шлють дуже короткі повідомлення, часто раз на 30–60 с і рідше — треба бути терплячим. В Україні умови для таких пристроїв задає Перелік до постанови НКЕК № 361: для 868,0–868,6 МГц — 25 мВт і робочий цикл менше 1 %, а смуги 869,4–869,65 МГц у Переліку загальної авторизації немає (картка 13). На приймання це не впливає.
Що там можна почути
| Що | Приклади (номер декодера) | Примітка |
|---|---|---|
| Метеостанції | Bresser 5-в-1, 6-в-1, 7-в-1 (119, 172, 173); Fine Offset WS80 і WS90 (213, 244); Ecowitt, LaCrosse, TFA | У Європі часто продають варіант на 868 МГц: перевірте модель |
| Термостати | Eberle Instat 868r1 (358), Watts Vision (366) | Watts Vision: 868,3 МГц |
| Датчики | Cavius, дверей і вікон (368) | 868,7 МГц |
| Лічильники | Wireless M-Bus, режими S, T, C, R, F (104–107, 238) | Висока швидкість: дискретизація 1000–1200 кГц; дані інколи шифровані |
| Розумний дім | Somfy io-homecontrol (189) | Двосторонній, 868 МГц |
Налаштування приймання
| Параметр | Що робить |
|---|---|
-f 868.3M | Частота прослуховування (за замовчуванням 433,92 МГц) |
-s 250k | Дискретизація (за замовчуванням 250 кГц); для wM-Bus — 1000k чи 1200k |
-g 0 | Автоматичне підсилення; якщо перевантаження чи тиша — спробуйте фіксовані значення |
-p 20 | Корекція дрейфу донгла, у ppm (значення для прикладу) |
-f 433.92M -f 868.3M -H 30 | Перемикання між частотами кожні 30 с (за замовчуванням 600 с) |
Коли донгл перемикається, кадри з іншого діапазону пролітають повз: надійніше мати по донглу на діапазон.
Як датчики кодують біти
- Модуляція (OOK, FSK) каже, що змінюється на несучій; кодування (NRZ, Манчестер, PWM, PPM) — як подано біти.
- На 868 МГц частіше беруть FSK, а на 433 МГц переважає OOK: FSK краще тримає шум і відстань.
- Кадр зазвичай містить преамбулу, ідентифікатор, виміри й контрольну суму чи CRC;
rtl_433 її перевіряє й показує в полі
mic.
| № | Декодер на 868 МГц | Рекомендоване налаштування |
|---|---|---|
| 104 | Wireless M-Bus, режими C і T, 100 кбіт/с | -f 868.95M -s 1200k |
| 105 | Wireless M-Bus, режим S | -f 868.3M -s 1000k |
| 106, 107 | Wireless M-Bus, режими R і F | Типово вимкнені |
| 238 | Wireless M-Bus, режим T | -f 868.3M -s 1000k |
| 358 | Eberle Instat 868r1 | — |
| 366 | Watts Vision (термостат) | -f 868.3M |
| 368 | Cavius (датчик дверей і вікон) | -f 868.7M |
{ "time":"2026-10-14 07:12:03", "model":"Bresser-6in1", "id":12345678, "channel":0,
"battery_ok":1, "temperature_C":14.2, "humidity":71, "mic":"CRC" }
Приклад для ілюстрації, значення вигадані. Поля залежать від датчика; -M level
додає рівень сигналу.
Корисні команди
| Команда | Що робить |
|---|---|
rtl_433 -f 868.3M | Слухає 868,3 МГц і показує декодовані повідомлення |
rtl_433 -f 868.3M -F json -M level -M protocol | Вивід у JSON з рівнем і номером протоколу |
rtl_433 -f 868.3M -s 1000k -R 105 | Лише декодер 105 (wM-Bus, режим S) |
rtl_433 -f 868.3M -F mqtt://localhost:1883 | Публікує в MQTT (Home Assistant, Node-RED) |
rtl_433 -f 868.3M -A | Аналізатор імпульсів для незнайомого сигналу |
rtl_433 -f 868.3M -S unknown | Записує нерозпізнані сигнали |
rtl_433 -r capture.cu8 | Перечитує запис без жодного обладнання |
rtl_433 -f 868.3M -T 300 | Зупиняється через 300 с |
Інші виводи: csv, influx, kv, syslog, http. Загальний декодер -X дає змогу самому
описати простий протокол.
Якщо не працює
| Ознака | Куди дивитися |
|---|---|
| Жодного повідомлення | Почекайте кілька хвилин, наблизьте антену, перевірте справжню частоту датчика |
| Шум, але нічого не декодується | Підсилення завелике чи замале: -g 0, потім фіксовані значення |
| Частота зсунута | Виправте через -p або візьміть донгл із TCXO |
| Завади | Відсуньте донгл від комп'ютера (USB-подовжувач), подбайте про живлення |
| Невідомий сигнал | -A і -S unknown, потім спитайте в репозиторії на GitHub, доклавши запис |
Приймати зазвичай можна, але дані датчиків ваших сусідів (лічильники, сигналізації, термостати) — приватні: не публікуйте їх і не використовуйте. Ніколи не передавайте, щоб повторити команду (ролети, двері, сигналізація): це вже вторгнення. Що далі: репозиторій merbanan/rtl_433, Home Assistant, Node-RED, InfluxDB і Grafana.