Декодер сигналов IoT-устройств на частотах 433.92/868/315/915 МГц через RTL-SDR: метеостанции, датчики температуры, счётчики воды/газа, брелоки, датчики парковки. Поддерживает 250+ протоколов. Вывод в JSON для автоматизации.
sudo apt install rtl-433 # или: git clone https://github.com/merbanan/rtl_433 mkdir rtl_433/build && cd rtl_433/build cmake .. && make && sudo make install # Прослушивание эфира: rtl_433 # JSON вывод: rtl_433 -F json
rtl_433 (несмотря на название) является универсальным приёмником данных, в основном предназначенным для работы в диапазонах ISM 433.92 МГц, 868 МГц (SRD), 315 МГц, 345 МГц и 915 МГц.
Официальный исходный код находится в репозитории https://github.com/merbanan/rtl_433/. Для получения дополнительной документации и ознакомления с связанными проектами посетите сайт https://triq.org/.
Он работает с RTL-SDR и/или SoapySDR. Активно тестируются и поддерживаются USB-модули DVB на базе чипов Realtek RTL2832 (с использованием RTL-SDR), а также LimeSDR (LimeSDR USB и LimeSDR mini, инженерные образцы любезно предоставленные MyriadRf), PlutoSDR, HackRF One (с использованием драйверов SoapySDR), а также SoapyRemote.
)
rtl_433 написан на переносимом C (стандарт C99) и, как известно, компилируется в системах Linux (включая встраиваемые), FreeBSD, MacOS и Windows. Поддержка более старых компиляторов и инструментальных цепочек является ключевой целью. Низкое потребление ресурсов и минимальное количество зависимостей позволяют rtl_433 работать на встраиваемом оборудовании. Хорошо поддерживаются наиболее распространённые 32-битные и 64-битные архитектуры CPU, такие как amd64, arm64, armhf, i386, ppc64el, riscv64, s390x и другие.
Смотрите BUILDING.md)
Linux (Debian, Ubuntu): sudo apt install rtl-433. Для других дистрибутивов смотрите repology или pkgs.org.
FreeBSD: pkg install rtl-433.
MacOS: brew install rtl_433.
Docker-образы с rtl_433 доступны на странице hertzg в github.
Смотрите CONTRIBUTING.md).
rtl_433 -h
Файл "rtl_433.conf" ищется в "./", XDG_CONFIG_HOME (например, "$HOME/.config/rtl_433/"),
SYSCONFDIR (например, "/usr/local/etc/rtl_433/"), затем аргументы командной строки будут обработаны по порядку.
= Общие опции =
[-V] Вывести строку версии и завершить работу.
[-v] Увеличить подробность вывода (можно использовать несколько раз).
-v : подробные уведомления, -vv : подробная информация, -vvv : отладка, -vvvv : трассировка.
[-c <путь>] Читать опции конфигурации из файла.
= Оции тюнера =
[-d <индекс USB-устройства RTL-SDR> | :<серийный номер USB-устройства RTL-SDR> | <запрос устройства SoapySDR> | rtl_tcp | help]
[-g <усиление> | help] (по умолчанию: авто)
[-t <настройки>] применить список настроек ключ=значение к устройству SDR.
например, для SoapySDR -t "antenna=A,bandwidth=4.5M,rfnotch_ctrl=false"
для RTL-SDR используйте "direct_samp[=1]", "offset_tune[=1]", "digital_agc[=1]", "biastee[=1]"
[-f <частота>] Принимать частоту(ы) (по умолчанию: 433920000 Гц).
[-H <секунды>] Интервал переключения для опроса нескольких частот (по умолчанию: 600 секунд).
[-p <ошибка в ppm>] Корректировать смещение частоты тюнера rtl-sdr (по умолчанию: 0).
[-s <частота дискретизации>] Установить частоту дискретизации (по умолчанию: 250000 Гц).
[-D quit | restart | pause | manual] Опции режима работы входного устройства (по умолчанию: quit).
= Опции демодулятора =
[-R <устройство> | help] Включить декодирование только указанного протокола устройства (можно использовать несколько раз).
Укажите отрицательное число, чтобы отключить протокол декодирования устройства (можно использовать несколько раз).
[-X <спецификация> | help] Добавить универсальный декодер (добавьте -R 0, чтобы отключить все декодеры).
[-Y auto | classic | minmax] Режим детектора импульсов FSK.
[-Y level=<уровень в дБ>] Ручной уровень обнаружения для определения импульсов (-1.0 до -30.0) (0=авто).
[-Y minlevel=<уровень в дБ>] Ручной минимальный уровень обнаружения для определения импульсов (-1.0 до -99.0).
[-Y minsnr=<уровень в дБ>] Минимальное соотношение сигнал/шум для определения импульсов (1.0 до 99.0).
[-Y autolevel] Установить minlevel автоматически на основе средней оценки шума.
[-Y squelch] Пропускать кадры ниже уровня предполагаемого шума для снижения нагрузки на CPU.
[-Y ampest | magest] Выбрать оценщик амплитуды или оценщик магнитуды.
= Опции анализа/отладки =
[-A] Анализатор импульсов. Включить анализ импульсов и попытку декодирования.
Отключите все декодеры с помощью -R 0, если хотите получить только вывод анализатора.
[-y <код>] Проверить декодирование демодулированных тестовых данных (например, "{25}fb2dd58") с включёнными устройствами.
= Опции ввода/вывода файлов =
[-S none | all | unknown | known] Автосохранение сигналов. Создаёт один файл на сигнал.
Примечание: Сохраняет необработанные семплы I/Q (uint8 pcm, 2 канала). Предпочтительный режим для создания тестовых файлов.
[-r <имя файла> | help] Читать данные из входного файла вместо приёмника.
[-w <имя файла> | help] Сохранять поток данных в выходной файл ('-' выводит семплы в stdout).
[-W <имя файла> | help] Сохранять поток данных в выходной файл, перезаписывая существующий файл.
= Опции вывода данных =
[-F log | kv | json | csv | mqtt | influx | syslog | trigger | rtl_tcp | http | null | help] Генерировать декодированный вывод в указанном формате.
Добавить вывод в файл с помощью :<имя файла> (например, -F csv:log.csv), по умолчанию в stdout.
Укажите хост/порт для syslog, например -F syslog:127.0.0.1:1514.
[-M time[:<опции>] | protocol | level | noise[:<секунды>] | stats | bits | help] Добавлять различные метаданные к каждому выводу.
[-K FILE | PATH | <тег> | <ключ>=<тег>] Добавлять расширенный токен или фиксированный тег к каждой строке вывода.
[-C native | si | customary] Конвертировать единицы измерения в декодированном выводе.
[-n <значение>] Указать количество семплов для взятия (каждый семпл - это пара I/Q).
[-T <секунды>] Указать количество секунд для работы, также можно 12:34 или 1h23m45s.
[-E hop | quit] Переключаться/Завершаться после вывода успешного(ых) события(ий).
[-h] Вывести эту справку по использованию и завершить работу.
Используйте -d, -g, -R, -X, -F, -M, -r, -w или -W без аргумента для получения дополнительной справки
# Поддерживаемые протоколы устройств
[01] Пульт управления Silvercrest
[02] Датчик температуры Rubicson, TFA 30.3197 или InFactory PT-310
[03] Датчик температуры Prologue, FreeTec NC-7104, NC-7159-675
[04] Переключатель Waveman
[06]* ELV EM 1000
[07]* ELV WS 2000
[08] Датчик температуры/влажности LaCrosse TX
[10] Дождемер Acurite 896
[11] Датчик температуры и влажности Acurite 609TXC
[12] Метеосенсор Oregon Scientific
[13]* Mebus 433
[14]* Intertechno 433
[15] Беспроводной переключатель KlikAanKlikUit
[16] Метеосенсор AlectoV1 (Alecto WS3500 WS4500 Ventus W155/W044 Oregon)
[17] Cardin S466-TX2
[18] Датчик температуры/влажности/дождя Fine Offset Electronics, WH2, WH5, Telldus
[19] Датчик температуры/влажности Nexus, FreeTec NC-7345, NX-3980, Solight TE82S, TFA 30.3209
[20] Датчик температуры Ambient Weather F007TH, TFA 30.3208.02, SwitchDocLabs F016TH
[21] Сенсор Calibeur RF-104
[22] X10 RF
[23] Контакт охранной системы DSC
[24]* Brennenstuhl RCS 2044
[25] Датчик Globaltronics GT-WT-02
[26] Термостат Danfoss CFR
[29] Chuango Security Technology
[30] Универсальный пульт SC226x EV1527
[31] TFA-Twin-Plus-30.3049, Conrad KW9010, Ea2 BL999
[32] Метеостанция Fine Offset Electronics WH1080/WH3080
[33] WT450, WT260H, WT405H
[34] Метеостанция LaCrosse WS-2310 / WS-3600
[35] Esperanza EWS
[36] Efergy e2 classic
[37]* Inovalley kw9015b, TFA Dostmann 30.3161 (датчик дождя и температуры)
[38] Универсальный датчик температуры 1
[39] Датчик температуры WG-PB12V1
[40] Датчики температуры/влажности Acurite 592TXR, 592TX, 5n1, 3n1, Atlas weather station, 515 fridge/freezer, 6045 lightning, 899 rain, 1190/1192 leak
[41] Термометр Acurite 986 для холодильника/морозильной камеры
[42] Датчик температуры, влажности, ветра и дождя HIDEKI TS04
[43] Монитор нефтяного бака Watchman Sonic / Apollo Ultrasonic / Beckett Rocket
[44] Датчик тока CurrentCost
[45] emonTx OpenEnergyMonitor
[46] Пульт управления HT680
[47] Датчик температуры и влажности Conrad S3318P, FreeTec NC-5849-913, датчик температуры ORIA WA50 ST389
[48]* Дистанционный бесключевой доступ Akhan 100F14
[49] Quhwa
[50] Датчик температуры OSv1
[51] Беспроводной переключатель Proove / Nexa / KlikAanKlikUit
[52] Термо-/гигросенсор Bresser 3CH
[53] Датчик температуры и влажности почвы Springfield
[54] Дистанционный термогигросенсор Oregon Scientific SL109H
[55] Датчик температуры Acurite 606TX / Technoline TX960
[56] Датчик температуры бассейна TFA
[57] Датчик температуры и влажности Kedsum, Pearl NC-7415
[58] Blyss DC5-UK-WH
[59] Система контроля давления в шинах (TPMS) Steelmate
[60] Система контроля давления в шинах (TPMS) Schrader
[61]* LightwaveRF
[62]* Дверной звонок Elro DB286A
[63] Оптический датчик Efergy
[64]* Автомобильный ключ Honda
[67] Radiohead ASK
[68] Датчик движения/контакт Kerui PIR
[69] Метеостанция Fine Offset WH1050
[70] Датчик двери/окна Honeywell, 2Gig DW10/DW11, повторитель RE208
[71] Датчик барбекю Maverick ET-732/733
[72]* RF-tech
[73] Датчик LaCrosse TX141-Bv2, TX141TH-Bv2, TX141-Bv3, TX141W, TX145wsdth, (TFA, ORIA)
[74] Датчик температуры/влажности Acurite 00275rm,00276rm с опциональным зондом
[75] Датчик температуры/влажности LaCrosse TX35DTH-IT, TFA Dostmann 30.3155
[76] Датчик температуры LaCrosse TX29IT, TFA Dostmann 30.3159.IT
[77] Центральное отопление Vaillant calorMatic VRT340f
[78] Датчик температуры/влажности/давления Fine Offset Electronics, WH25, WH32, WH32B, WN32B, WH24, WH65B, HP1000, Misol WS2320
[79] Датчик температуры/дождя Fine Offset Electronics, WH0530
[80] Маяк IBIS
[81] Нефть ультразвуковая STANDARD FSK
[82] Система контроля давления в шинах (TPMS) Citroen
[83] Нефть ультразвуковая STANDARD ASK
[84] Термометр Thermopro TP11
[85] Solight TE44/TE66, EMOS E0107T, NX-6876-917
[86]* Беспроводный детектор дыма и тепла GS 558
[87] Универсальный беспроводной датчик движения
[88] Система контроля давления в шинах (TPMS) Toyota
[89] Система контроля давления в шинах (TPMS) Ford
[90] Система контроля давления в шинах (TPMS) Renault
[91] Датчик температуры и влажности inFactory, nor-tec, FreeTec NC-3982-913
[92] Датчик температуры FT-004-B
[93] Автомобильный ключ Ford
[94] Вешний датчик температуры Philips (тип AJ3650)
[95] Система контроля давления в шинах (TPMS) Schrader EG53MA4, Saab, Opel, Vauxhall, Chevrolet
[96] Nexa
[97] Термометр ThermoPro TP08/TP12/TP20
[98] GE Color Effects
[99] X10 Security
[100] Охранные устройства Interlogix GE UTC
[101]* Пульт Dish 6.3
[102] Охранная система SimpliSafe Home Security System (может потребоваться отключение автоматического усиления для декодирования клавиатуры)
[103] Мини-датчик влажности растений Sensible Living
[104] Wireless M-Bus, Mode C&T, 100kbps (-f 868.95M -s 1200k)
[105] Wireless M-Bus, Mode S, 32.768kbps (-f 868.3M -s 1000k)
[106]* Wireless M-Bus, Mode R, 4.8kbps (-f 868.33M)
[107]* Wireless M-Bus, Mode F, 2.4kbps
[108] Дистанционный датчик температуры Hyundai WS SENZOR
[109] Термометр для бассейна WT0124
[110] Система контроля давления в шинах (TPMS) PMV-107J (Toyota)
[111] Датчик температуры Emos TTX201
[112] Датчик температуры/влажности Ambient Weather TX-8300
[113] Термогигрометр Ambient Weather WH31E, дождемер EcoWitt WH40, метеостанция WS68
[114] Maverick ET73
[115] Honeywell ActivLink, беспроводный дверной звонок
[116] Honeywell ActivLink, беспроводный дверной звонок (FSK)
[117]* Монитор энергии ESA1000 / ESA2000
[118]* Дождемер Biltema
[119] Метеоцентр Bresser 5-в-1
[120] Датчик температуры/влажности Digitech XC-0324 / AmbientWeather FT005TH
[121] Датчик влажности почвы Opus/Imagintronix XT300
[122] FS20 / FHT
[123]* Система контроля давления в шинах (TPMS) Jansite модель TY02S
[124] Метеосенсоры LaCrosse/ELV/Conrad WS7000/WS2500
[125] Беспроводной ультразвуковой уровень жидкости в баке TS-FT002 с датчиком температуры
[126] Датчик температуры Companion WTR001
[127] Беспроводный уличный термометр Ecowitt WH53/WH0280/WH0281A
[128] Пульт управления DirecTV RC66RX
[129]* Датчик температуры и влажности Eurochron
[130] Монитор энергии IKEA Sparsnas
[131] Пульты на основе кодирующих микросхем Microchip HCS200/HCS300 KeeLoq Hopping Encoder
[132] Уличный датчик температуры/влажности TFA Dostmann 30.3196
[133] Термометр Rubicson 48659
[134] Метеостанция AOK (перебрендированная Holman Industries iWeather WS5029, Conrad AOK-5056, Optex 990018)
[135] Вешний датчик температуры Philips (тип AJ7010)
[136] Счётчик электроэнергии ESIC EMT7110
[137] Globaltronics QUIGG GT-TMBBQ-05
[138] Датчик Globaltronics GT-WT-03
[139] Norgo NGE101
[140] Система контроля давления в шинах (TPMS) Elantra2012
[141] Датчик температуры/влажности Auriol HG02832, HG05124A-DCF, Rubicson 48957
[142] Датчик влажности почвы Fine Offset Electronics/Ecowitt WH51, WN31, SwitchDoc Labs SM23
[143] Метеостанция Holman Industries iWeather WS5029 (старый PWM)
[144] Метеосенсор TBH
[145] Метеостанция WS2032
[146] Датчик температуры/влажности Auriol AFW2A1
[147] Дождемер TFA Drop 30.3233.01
[148] Контакт охранной системы DSC (WS4945)
[149] Стандартное сообщение потребления ERT (SCM)
[150]* Klimalogg
[151] Visonic powercode
[152] Датчик температуры и влажности Eurochron EFTH-800
[153] Беспроводная метеостанция с USB Cotech 36-7959, SwitchDocLabs FT020T
[154] Расширенное стандартное сообщение потребления (SCMplus)
[155] Метеостанция Fine Offset Electronics WH1080/WH3080 (FSK)
[156] Система контроля давления в шинах (TPMS) Abarth 124 Spider и Shenzhen EGQ Q85
[157] Метеостанция Missil ML0757
[158] Метеостанция Sharp SPC775
[159] Insteon
[160] Интервальное сообщение данных ERT (IDM)
[161] Интервальное сообщение данных ERT (IDM) для сетевых счётчиков
[162]* Датчик температуры ThermoPro-TX2
[163] Датчик температуры Acurite 590TX с опциональной влажностью
[164] Security+ 2.0 (брелок)
[165] Уличный датчик температуры/влажности TFA Dostmann 30.3221.02 (а также 30.3249.02)
[166] Датчик ветра LaCrosse Technology View LTV-WSDTH01 Breeze Pro
[167] Somfy RTS
[168] Система контроля давления в шинах (TPMS) Schrader SMD3MA4 (Subaru) 3039 (Infiniti, Nissan, Renault)
[169]* Пульт управления шлагбаумом Nice Flor-s
[170] Мультисенсор LaCrosse Technology View LTV-WR1
[171] Термо/гигросенсор LaCrosse Technology View LTV-TH
[172] Метеоцентр Bresser 6-в-1, 7-в-1 внутренний, почвенный, новый 5-в-1, 3-в-1 анемометр, Froggit WH6000, Ventus C8488A
[173] Метеоцентр Bresser 7-в-1, датчики качества воздуха PM2.5/PM10 7009970, CO2 7009977, HCHO/VOC 7009978
[174] EcoDHOME Smart Socket и солнечный монитор MCEE
[175] Дождемер LaCrosse Technology View LTV-R1, LTV-R3, анемометр LTV-W1/W2
[176] Монитор стоимости электроэнергии BlueLine Innovations
[177] Термометр для барбекю Burnhard
[178] Security+ (брелок)
[179] Детектор дыма, тепла и воды Cavius
[180] Солнечная система контроля давления в шинах (TPMS) Jansite
[181] Термометр для мяса Amazon Basics
[182] Термометр для бассейна TFA Marbella
[183] Датчик температуры/влажности Auriol AHFL
[184] Датчик температуры Auriol AFT 77 B2
[185] Беспроводной программируемый комнатный термостат Honeywell CM921
[186] Система контроля давления в шинах (TPMS) Hyundai (VDO)
[187] Устройства управления жалюзи и пульты RojaFlex
[188] Солнечные сенсоры Marlec Solar iBoost+
[189] Somfy io-homecontrol
[190] Датчик ударов молний Ambient Weather WH31L (FineOffset WH57)
[191] Пульты управления шторами Markisol, E-Motion, BOFU, Rollerhouse, BF-30x, BF-415
[192] Детектор протечек воды Govee H5054, контактный датчик дверей B5023
[193] Счётчик электроэнергии Clipsal CMR113 Cent-a-meter
[194] Датчик температуры и влажности Inkbird ITH-20R
[195] Датчик температуры и влажности почвы RainPoint
[196] Датчик температуры Atech-WS308
[197] Термометр для гриля/мяса Acurite 01185M
[198]* EnOcean ERP1
[199] Пульты для гаражных/воротных ворот Linear Megacode
[200]* Датчики температуры/дождя Auriol 4-LD5661/4-LD5972/4-LD6313
[201] Солнечная система контроля давления в шинах (TPMS) для грузовиков без бренда
[202] Funkbus / Instafunk (Berker, Gira, Jung)
[203] Система контроля давления в шинах (TPMS) Porsche Boxster/Cayman
[204] Охранные устройства Jasco/GE Choice Alert
[205] Сенсоры метеостанции Telldus FT0385R
[206] Дождемер LaCrosse TX34-IT
[207] Пульт управления SmartFire Proflame 2
[208] Система контроля давления в шинах (TPMS) AVE
[209] Охранная система SimpliSafe Gen 3 Home Security System
[210] Yale HSA (система домашней сигнализации), YES-Alarmkit
[211] Пульт для потолочного вентилятора Regency (-f 303.75M до 303.96M)
[212] Система контроля давления в шинах (TPMS) Renault 0435R
[213] Метеостанция Fine Offset Electronics WS80
[214] Метеостанция EMOS E6016 с DCF77
[215] Датчик температуры/влажности Emax W6, перебрендированный Altronics x7063/4/x7064A, Optex 990040/50/51, Orium 13093/13123, Infactory FWS-1200, Newentor Q9, Otio 810025, Protmex PT3390A, Jula Marquant 014331/32, TechniSat IMETEO X6 76-4924-00, метеостанция или датчик температуры/влажности
[216]* Устройства ANT и ANT+
[217] Дождемер EMOS E6016
[218] Пульты на основе кодирующих микросхем Microchip HCS200/HCS300 KeeLoq Hopping Encoder (FSK)
[219] Датчик качества воздуха Fine Offset Electronics WH45
[220] Термометр для барбекю Maverick XR-30
[221] Датчик температуры Fine Offset Electronics WN34S/L/D и Froggit DP150/D35
[222] Термометр для бассейна Rubicson 48942
[223] Водосчётчик Badger ORION, 100kbps (-f 916.45M -s 1200k)
[224] Монитор энергии GEO minim+
[225] Система контроля давления в шинах (TPMS) TyreGuard 400
[226] Система контроля давления в шинах (TPMS) Kia (-s 1000k)
[227] Пульт управления подсветкой бассейна SRSmith SRS-2C-TX (-f 915M)
[228] Расходомеры Neptune R900
[229] Датчик температуры/влажности WEC-2103
[230] Vauno EN8822C
[231] Детектор протечек воды Govee H5054
[232] Радиоуправляемый гриль и термометр для мяса TFA Dostmann 14.1504.V2
[233]* Таймер выстрелов CED7000
[234] Watchman Sonic Advanced / Plus, Tekelek
[235] Нефть ультразвуковая SMART FSK
[236] Термометр для мяса Gasmate BA1008
[237] Расходомеры Flowis
[238] Wireless M-Bus, Mode T, 32.768kbps (-f 868.3M -s 1000k)
[239] Счётчик электроэнергии Revolt NC-5642
[240] LaCrosse TX31U-IT, The Weather Channel WS-1910TWC-IT
[241] Системы контроля давления в шинах (TPMS) EezTire E618, Carchet, TST-507
[242]* Дождемер Baldr / RainPoint.
[243] Термостат Celsia CZC1
[244] Метеостанция Fine Offset Electronics WS90
[245]* Термометр и датчик влажности ThermoPro TX-2C
[246] Метеостанция TFA 30.3151
[247] Датчик протечек воды Bresser
[248]* Система контроля давления в шинах (TPMS) Nissan
[249] Датчик молний Bresser
[250] Дождемеры Schou 72543 Day Rain Gauge, Motonet MTX Rain, MarQuant Rain Gauge, TFA Dostmann 30.3252.01/47.3006.01 Rain Gauge and Thermometer, ADE WS1907
[251] Датчик протечек воды Fine Offset / Ecowitt WH55
[252] Системы контроля давления в шинах (TPMS) BMW Gen4-Gen5 и Audi Pressure Alert, мультибрендовые HUF/Beru, Continental, Schrader/Sensata, Audi
[253] Термостат Watts WFHT-RF
[254] Метеостанция Thermor DG950
[255] Водосчётчик Mueller Hot Rod
[256] Длиннодиапазонный беспроводной термометр для мяса для коптильни/гриля ThermoPro TP28b
[257] Системы контроля давления в шинах (TPMS) BMW Gen2 и Gen3
[258] Датчик движения Chamberlain CWPIRC PIR
[259] Термометры для мяса ThermoPro, TP829B 4 зонда только с температурой
[260]* Водосчётчик Arad/Master Meter Dialog3G
[261] Уличный датчик Geevon TX16-3
[262] Датчик качества воздуха Fine Offset Electronics WH46
[263] Беспроводная метеостанция Vevor 7-в-1
[264] Arexx Multilogger IP-HA90, IP-TH78EXT, TSN-70E
[265] Блок цифрового управления Rosstech DCU-706/Sundance/Jacuzzi
[266] Протокол двухсторонней связи Agility от Risco, датчик движения Risco PIR/PET RWX95P
[267] Термометры для мяса ThermoPro, TP828B 2 зонда с температурой, целевой диапазон для барбекю LO и HI
[268] Термо-/гигросенсор Bresser Explore Scientific ST1005H
[269] Устройства DeltaDore X3D
[270]* Quinetic
[271] Счётчики электроэнергии Landis & Gyr Gridstream 9.6k
[272] Счётчики электроэнергии Landis & Gyr Gridstream 19.2k
[273] Счётчики электроэнергии Landis & Gyr Gridstream 38.4k
[274] Счётчик электроэнергии Revolt ZX-7717
[275] Система контроля давления в шинах (TPMS) GM-Aftermarket
[276] Дождемер RainPoint HCS012ARF
[277] Водосчётчик Apator Metra E-RM 30
[278] Вешний термогигрометр ThermoPro TX-7B
[279] Датчик температуры сауны Nexus, CRX, Prego
[280] Датчик влажности/температуры/освещённости почвы Homelead HG9901 (Geevon, Dr.Meter, Royal Gardineer)
[281] Термометр для барбекю Maverick XR-50
[282] Конечная точка Orion от Badger Meter, GIF2014W-OSE, водосчётчик, перескок с 904.4 МГц на 924.6МГц (-s 1600k)
[283] Датчик качества воздуха Fine Offset Electronics WH43
[284] Термогигрометр Baldr E0666TH
[285] Монитор 12В батареи bm5-v2
[286] Универсальный (реверсивный) контроллер вентилятора 24В
[287] Метеостанция Fine Offset Electronics WS85
[288] Термометр для морозильной камеры и холодильника Oria WA150KM
[289] Счётчик энергии Voltcraft EnergyCount 3000 (ec3k)
[290] Конечная точка Orion от Badger Meter, GIF2020OCECNA, водосчётчик, перескок с 904.4 МГц на 924.6МГц (-s 1600k)
[291] Уличный датчик Geevon TX19-1
[292] Вешний датчик температуры WallarGe CLTX001
[293] Метеостанция Sainlogic SA8, Gevanti SA8
[294] Беспроводной двухзондовый термометр для мяса ThermoPro TempSpike XR TP862b / TP863b
[295] Система контроля давления в шинах (TPMS) Airpuxem TYH11_EU6_ZQ
[296] Распределитель отопления Apator Metra E-ITN 30
[297] Термометр ThermoPro TP211B
[298] Системы контроля давления в шинах (TPMS) TRW OOK OEM и клонированные модели
[299] Системы контроля давления в шинах (TPMS) TRW FSK OEM и клонированные модели
[300] Детектор протечек воды Govee H5059
[301] Автомобильный пульт Astrostart 2000 (-f 372.4M)
[302] Автомобильный пульт Compustar 1WG3R
[303] Автомобильный пульт Chrysler (-f 315.1M -s 920k)
[304] Автомобильный пульт Nidec (-f 31
* Отключено по умолчанию, используйте -R n или файл конфигурации для включения
= Выбор устройства ввода =
Драйвер устройства RTL-SDR доступен.
[-d <индекс USB-устройства RTL-SDR>] (по умолчанию: 0)
[-d :<серийный номер USB-устройства RTL-SDR (можно задать с помощью rtl_eeprom -s)>]
Для задания усиления RTL-SDR используйте -g <усиление> для установки общего усиления в дБ.
Драйвер устройства SoapySDR доступен.
[-d ""] Открыть устройство SoapySDR по умолчанию
[-d driver=rtlsdr] Открыть, например, конкретное устройство SoapySDR
Для задания усиления SoapySDR используйте -g ELEM=val,ELEM=val,... например -g LNA=20,TIA=8,PGA=2 (для LimeSDR).
[-d rtl_tcp[:[//]хост[:порт]] (по умолчанию: localhost:1234)
Укажите хост/порт для подключения, например -d rtl_tcp:127.0.0.1:1234
= Параметр усиления =
[-g <усиление>] (по умолчанию: авто)
Для RTL-SDR: усиление в дБ ("0" — авто).
Для SoapySDR: усиление в дБ для автоматического распределения ("" — авто), или строка элементов усиления.
Например "LNA=20,TIA=8,PGA=2" для LimeSDR.
= Спецификация гибкого декодера =
Используйте -X <спецификация> для добавления гибкого универсального декодера.
<спецификация> — это "ключ=значение[,ключ=значение...]"
Общие ключи:
name=<имя> (или: n=<имя>)
modulation=<модуляция> (или: m=<модуляция>)
short=<короткое> (или: s=<короткое>)
long=<длинное> (или: l=<длинное>)
sync=<синхронизация> (или: y=<синхронизация>)
reset=<сброс> (или: r=<сброс>)
gap=<интервал> (или: g=<интервал>)
tolerance=<допуск> (или: t=<допуск>)
priority=<n> : запускать декодер только как запасной вариант
где:
<имя> — любое описательное имя, необходимое в выводе
<модуляция> — одна из:
OOK_MC_ZEROBIT : код Манчестера с фиксированным ведущим нулевым битом
OOK_PCM : кодирование без возврата к нулю (импульсно-кодовая модуляция)
OOK_RZ : кодирование с возвратом к нулю (импульсно-кодовая модуляция)
OOK_PPM : импульсно-позиционная модуляция
OOK_PWM : импульсно-широтная модуляция
OOK_DMC : дифференциальный код Манчестера
OOK_PIWM_RAW : необработанная импульсно-интервальная и широтная модуляция
OOK_PIWM_DC : дифференциальная импульсно-интервальная и широтная модуляция
OOK_MC_OSV1 : код Манчестера для устройств OSv1
FSK_PCM : ФМ импульсно-кодовая модуляция
FSK_PWM : ФМ импульсно-широтная модуляция
FSK_MC_ZEROBIT : код Манчестера с фиксированным ведущим нулевым битом
<короткое>, <длинное>, <синхронизация> — номинальные тайминги модуляции в мкс,
<сброс>, <интервал>, <допуск> — максимальные тайминги модуляции в мкс:
PCM/RZ short: Номинальная ширина импульса [мкс]
long: Номинальная ширина битового периода [мкс]
PPM short: Номинальная ширина интервала '0' [мкс]
long: Номинальная ширина интервала '1' [мкс]
PWM short: Номинальная ширина импульса '1' [мкс]
long: Номинальная ширина импульса '0' [мкс]
sync: Номинальная ширина синхроимпульса [мкс] (необязательно)
common gap: Максимальный размер интервала перед новой строкой бит [мкс]
reset: Максимальный размер интервала перед концом сообщения [мкс]
tolerance: Максимальное отклонение импульса [мкс] (необязательно).
Доступные опции:
bits=<n> : совпадение только если хотя бы одна строка содержит <n> бит
rows=<n> : совпадение только если есть <n> строк
repeats=<n> : совпадение только если некоторая строка повторяется <n> раз
используйте opt>=n для совпадения не менее <n> и opt<=n для совпадения не более <n>
invert : инвертировать все биты
reflect : отразить каждый байт (старший бит в начале к старшему биту в конце)
decode_uart=<8n1|8n2|8o1> : декодирование UART 8n1 (10 в 8), 8n2, 8o1 (11 в 8)
decode_dm : декодирование дифференциального Манчестера
decode_mc : декодирование Манчестера
match=<биты> : совпадение только если найдены <биты>
preamble=<биты> : совпадение и выравнивание по преамбуле <биты>
<биты> — это спецификация строки вида {<количество бит>}<биты в шестнадцатеричном формате>
unique : подавлять дублирующий вывод строк
countonly : подавлять подробный вывод строк
Например -X "n=doorbell,m=OOK_PWM,s=400,l=800,r=7000,g=1000,match={24}0xa9878c,repeats>=3"
= Параметр формата вывода =
[-F log|kv|json|csv|mqtt|influx|syslog|trigger|rtl_tcp|http|null] Выводить декодированные данные в указанном формате.
Без этого параметра по умолчанию используется вывод LOG и KV. Используйте "-F null" для удаления вывода по умолчанию.
Дописывать вывод в файл с помощью :<имя_файла> (например -F csv:log.csv), по умолчанию — stdout.
[-F mqtt[s][:[//]хост[:порт][,<опции>]]] (по умолчанию: localhost:1883)
Укажите сервер MQTT, например -F mqtt://localhost:1883
Логин и пароль по умолчанию считываются из переменных окружения MQTT_USERNAME и MQTT_PASSWORD.
Добавьте опции MQTT, например -F "mqtt://host:1883,opt=arg"
Опции MQTT: user=foo, pass=bar, retain[=0|1], <формат>[=топик]
Поддерживаемые форматы MQTT: (по умолчанию — все)
availability: публикует доступность (онлайн/офлайн)
events: публикует данные событий в JSON, по умолчанию "<база>/events"
states: публикует данные состояний в JSON, по умолчанию "<база>/states"
devices: публикует информацию об устройствах и датчиках в вложенных топиках,
по умолчанию "<база>/devices[/тип][/модель][/подтип][/канал][/id]"
Базовый топик можно задать с помощью base=<топик>, по умолчанию "rtl_433/ИМЯ_ХОСТА".
Любая строка топика переопределяет базовый топик и будет расширять ключи вроде [/model]
Например -F "mqtt://localhost:1883,user=USERNAME,pass=PASSWORD,retain=0,devices=rtl_433[/id]"
Для TLS используйте, например -F "mqtts://host,tls_cert=<путь>,tls_key=<путь>,tls_ca_cert=<путь>"
При использовании MQTT каждый экземрляр rtl_433 требует уникального выбора драйвера. Идентификатор клиента MQTT вычисляется на основе строки драйвера.
Если вы используете несколько RTL-SDR, возможно, стоит задать серийный номер и выбирать по нему (это поможет не перепутать антенну).
[-F influx[:[//]хост[:порт][/<путь и опции>]]
Укажите сервер InfluxDB 2.0, например -F "influx://localhost:9999/api/v2/write?org=<org>&bucket=<bucket>,token=<authtoken>"
Укажите сервер InfluxDB 1.x, например -F "influx://localhost:8086/write?db=<db>&p=<password>&u=<user>"
Рекомендуется дополнительный параметр -M time:unix:usec:utc для корректных меток времени в InfluxDB
[-F syslog[:[//]хост[:порт]]] (по умолчанию: localhost:514)
Укажите хост/порт для syslog, например -F syslog:127.0.0.1:1514
[-F trigger:/путь/к/файлу]
Добавляет вывод, записывающий "1" по указанному пути для каждого события, используйте, например, с GPIO
[-F rtl_tcp[:[//]bind[:порт]]] (по умолчанию: localhost:1234)
Добавляет сервер прохождения rtl_tcp
[-F http[:[//]bind[:порт]]] (по умолчанию: 0.0.0.0:8433)
Добавляет HTTP API сервер, интерфейс доступен по адресу http://localhost:8433/
= Параметр метаинформации =
[-M time[:<опции>]|protocol|level|noise[:<сек>]|stats|bits] Добавляет различные метаданные в каждую строку вывода.
Используйте "time" для добавления метаданных текущей даты и времени (preset для ввода в реальном времени).
Используйте "time:rel" для добавления метаданных позиции сэмпла (preset для чтения файлов и stdin).
Используйте "time:unix" для отображения секунд с эпохи unix в качестве метаданных времени. Всегда в UTC.
Используйте "time:iso" для отображения времени в формате ISO-8601 (YYYY-MM-DD"T"hh:mm:ss).
Используйте "time:off" для удаления метаданных времени.
Используйте "time:usec" для добавления микросекунд к метаданным даты и времени.
Используйте "time:tz" для вывода времени со смещением часового пояса.
Используйте "time:utc" для вывода времени в UTC.
(это также может быть достигнуто при вызове с установленной переменной окружения TZ).
"usec" и "utc" можно комбинировать с другими опциями, например "time:iso:utc" или "time:unix:usec".
Используйте "replay[:N]" для воспроизведения файловых входов в (N-кратном) реальном времени.
Используйте "protocol" / "noprotocol" для вывода метаданных номера протокола декодера.
Используйте "level" для добавления метаданных модуляции, частоты, RSSI, SNR и шума.
Используйте "noise[:<сек>]" для отчёта об оценке уровня шума через заданные интервалы (по умолчанию: 10 секунд).
Используйте "stats[:[<уровень>][:<интервал>]]" для отчёта статистики (по умолчанию: 600 секунд).
уровень 0: без отчёта, 1: отчёт об успешных устройствах, 2: отчёт об активных устройствах, 3: отчёт обо всех
Используйте "bits" для добавления двоичного представления к выходным кодам (для отладки).
= Параметр чтения файла =
[-r <имя_файла>] Чтение данных из входного файла вместо приёмника
Параметры определяются по полному пути, имени файла и расширению.
Центральная частота определяется как (дробное) число с суффиксом 'M',
'Hz', 'kHz', 'MHz' или 'GHz'.
Частота дискретизации определяется как (дробное) число с суффиксом 'k',
'sps', 'ksps', 'Msps' или 'Gsps'.
Содержимое и формат файла определяются параметрами, возможные варианты:
'cu8', 'cs16', 'cf32' (подразумевается 'IQ'), и 'am.s16'.
Параметры должны быть разделены неалфавитно-цифровыми символами и не чувствительны к регистру.
Переопределения можно указать префиксом, разделённым двоеточием (':')
Например, определение по умолчанию по расширению: путь/имя_файла.am.s16
принудительные переопределения: am:s16:путь/имя_файла.ext
Чтение из каналов также поддерживает опции формата.
Например чтение комплексных 32-битных чисел с плавающей запятой: CU32:-
= Параметр записи файла =
[-w <имя_файла>] Сохранять поток данных в выходной файл ('-' выводит сэмплы в stdout)
[-W <имя_файла>] Сохранять поток данных в выходной файл, перезаписывая существующий файл
Параметры определяются по полному пути, имени файла и расширению.
Содержимое и формат файла определяются параметрами, возможные варианты:
'cu8', 'cs8', 'cs16', 'cf32' (подразумевается 'IQ'),
'am.s16', 'am.f32', 'fm.s16', 'fm.f32',
'i.f32', 'q.f32', 'logic.u8', 'ook' и 'vcd'.
Параметры должны быть разделены неалфавитно-цифровыми символами и не чувствительны к регистру.
Переопределения можно указать префиксом, разделённым двоеточием (':')
Например, определение по умолчанию по расширению: путь/имя_файла.am.s16
принудительные переопределения: am:s16:путь/имя_файла.ext
Некоторые примеры:
| Команда | Описание |
|---|---|
rtl_433 |
Режим приёма по умолчанию, использовать первое найденное устройство, слушать на частоте 433.92 МГц с частотой дискретизации 250к. |
rtl_433 -C si |
Режим приёма по умолчанию, также преобразовать единицы в метрическую систему. |
rtl_433 -f 868M -s 1024k |
Слушать на частоте 868 МГц и частоте дискретизации 1024к. |
rtl_433 -M hires -M level |
Отмечать временные метки с точностью до микросекунд и добавлять уровни приёма (зависит от усиления). |
rtl_433 -R 1 -R 8 -R 43 |
Включить только определённые декодеры для нужных устройств. |
rtl_433 -A |
Включить анализатор импульсов. Обобщает временные параметры импульсов, пауз и периодов. Может использоваться с -R 0 для отключения декодеров. |
rtl_433 -S all -T 120 |
Сохранять все обнаруженные сигналы (g###_###M_###k.cu8). Работать 2 минуты. |
rtl_433 -K FILE -r file_name |
Читать сохранённый файл данных вместо приёма данных в реальном времени. Помечать выходные данные именами файлов. |
rtl_433 -F json -M utc \| mosquitto_pub -t home/rtl_433 -l |
Направить выходные данные в сеть в виде сообщений MQTT в формате JSON. Тестовый клиент MQTT можно найти в examples/mqtt_rtl_433_test_client.py. |
rtl_433 -f 433.53M -f 434.02M -H 15 |
Опрашивать две частоты с интервалом перескока 15 секунд. |
Пожалуйста, обратите внимание: мы стремимся сделать использование rtl_433 безопасным, однако не стоит считать его абсолютно защищённым.
Нет никакой необходимости, например, запускать его с sudo, хотя мы читаем и записываем файлы без каких-либо проверок.
Вывод данных буквально берётся из воздуха, ему не стоит доверять. Если вы передаёте данные в сторонние системы, убедитесь, что граничные случаи проверены и обработаны. Сетевые входы и выходы предназначены для использования в доверенной локальной сети, содержат нефильтрованные данные и могут перегрузить получателя (имейте в виду, что, например, вывод MQTT может управляться кем угодно с радиопередатчиком).
Присоединяйтесь к группе Google rtl_433 для получения дополнительной информации о rtl_433: https://groups.google.com/forum/#!forum/rtl_433
Если вы видите эту ошибку:
Kernel driver is active, or device is claimed by second instance of librtlsdr.
In the first case, please either detach or blacklist the kernel module
(dvb_usb_rtl28xxu), or enable automatic detaching at compile time.
то выполните команду:
sudo rmmod rtl2832_sdr dvb_usb_rtl28xxu rtl2832
или добавьте
blacklist dvb_usb_rtl28xxu
в файл /etc/modprobe.d/blacklist.conf
Используемая схема нумерации версий — год.месяц. Мы стараемся сохранять совместимость API между релизами, но основное внимание уделяется удобству сопровождения.