merbanan/rtl_433Programme pour décoder les transmissions radio des appareils sur les bandes ISM (et autres fréquences)
rtl_433 (malgré son nom) est un récepteur de données générique, principalement pour les bandes ISM 433,92 MHz, 868 MHz (SRD), 315 MHz, 345 MHz et 915 MHz.
Le code source officiel se trouve dans le dépôt https://github.com/merbanan/rtl_433/.
Voir aussi une liste de logiciels qui fonctionnent avec rtl_433 dans le wiki. Pour plus de documentation et de projets connexes, en particulier ceux qui aident au développement de rtl_433, voir le site https://triq.org/.
Il fonctionne avec RTL-SDR et/ou SoapySDR. Les dongles DVB basés sur Realtek RTL2832 (utilisant RTL-SDR) et le LimeSDR (LimeSDR USB et LimeSDR mini échantillons d'ingénierie aimablement fournis par MyriadRf), le PlutoSDR, le HackRF One (utilisant les pilotes SoapySDR), ainsi que SoapyRemote sont activement testés et pris en charge.
rtl_433 est écrit en C portable (norme C99) et est connu pour compiler sur Linux (y compris embarqué), FreeBSD, MacOS et Windows. Les compilateurs et chaînes d'outils plus anciens sont pris en charge comme objectif clé. La faible consommation de ressources et le très petit nombre de dépendances permettent à rtl_433 de fonctionner sur du matériel embarqué. La plupart des architectures de processeurs 32 bits et 64 bits courantes comme amd64, arm64, armhf, i386, ppc64el, riscv64, s390x et autres sont bien prises en charge.
Voir BUILDING.md
Linux (Debian, Ubuntu) : sudo apt install rtl-433. Pour les autres distributions, voir repology ou pkgs.org.
FreeBSD : pkg install rtl-433.
MacOS : brew install rtl_433.
Des images Docker avec rtl_433 sont disponibles sur la page github de hertzg.
Voir CONTRIBUTING.md.
rtl_433 -h```
A "rtl_433.conf" file is searched in "./", XDG_CONFIG_HOME e.g. "$HOME/.config/rtl_433/",
SYSCONFDIR e.g. "/usr/local/etc/rtl_433/", then command line args will be parsed in order.
= General options =
[-V] Output the version string and exit
[-v] Increase verbosity (can be used multiple times).
-v : verbose notice, -vv : verbose info, -vvv : debug, -vvvv : trace.
[-c ] Read config options from a file
= Tuner options =
[-d | : | | rtl_tcp | help]
[-g | help] (default: auto)
[-t ] apply a list of keyword=value settings to the SDR device
e.g. for SoapySDR -t "antenna=A,bandwidth=4.5M,rfnotch_ctrl=false"
for RTL-SDR use "direct_samp[=1]", "offset_tune[=1]", "digital_agc[=1]", "biastee[=1]"
[-f ] Receive frequency(s) (default: 433920000 Hz)
[-H ] Hop interval for polling of multiple frequencies (default: 600 seconds)
[-p <ppm_error>] Correct rtl-sdr tuner frequency offset error (default: 0)
[-s ] Set sample rate (default: 250000 Hz)
[-D quit | restart | pause | manual] Input device run mode options (default: quit).
= Demodulator options =
[-R | help] Enable only the specified device decoding protocol (can be used multiple times)
Specify a negative number to disable a device decoding protocol (can be used multiple times)
[-X | help] Add a general purpose decoder (prepend -R 0 to disable all decoders)
[-Y auto | classic | minmax] FSK pulse detector mode.
[-Y level=] Manual detection level used to determine pulses (-1.0 to -30.0) (0=auto).
[-Y minlevel=] Manual minimum detection level used to determine pulses (-1.0 to -99.0).
[-Y minsnr=] Minimum SNR to determine pulses (1.0 to 99.0).
[-Y autolevel] Set minlevel automatically based on average estimated noise.
[-Y squelch] Skip frames below estimated noise level to reduce cpu load.
[-Y ampest | magest] Choose amplitude or magnitude level estimator.
[-Y filter=] Manual FM low-pass filter cutoff to separate simultaneous transmissions: us (1-9999, e.g. 20), Hz (10000+), or ratio of sample rate (0.0-1.0).
= Analyze/Debug options =
[-A] Pulse Analyzer. Enable pulse analysis and decode attempt.
Disable all decoders with -R 0 if you want analyzer output only.
[-y ] Verify decoding of demodulated test data (e.g. "{25}fb2dd58") with enabled devices
= File I/O options =
[-S none | all | unknown | known] Signal auto save. Creates one file per signal.
Note: Saves raw I/Q samples (uint8 pcm, 2 channel). Preferred mode for generating test files.
[-r | help] Read data from input file instead of a receiver
[-w | help] Save data stream to output file (a '-' dumps samples to stdout)
[-W | help] Save data stream to output file, overwrite existing file
= Data output options =
[-F log | kv | json | csv | mqtt | influx | syslog | trigger | rtl_tcp | http | null | help] Produce decoded output in given format.
Append output to file with : (e.g. -F csv:log.csv), defaults to stdout.
Specify host/port for syslog with e.g. -F syslog:127.0.0.1:1514
[-M time[:] | protocol | level | noise[:] | stats | bits | help] Add various meta data to each output.
[-K FILE | PATH | | =] Add an expanded token or fixed tag to every output line.
[-C native | si | customary] Convert units in decoded output.
[-n ] Specify number of samples to take (each sample is an I/Q pair)
[-T ] Specify number of seconds to run, also 12:34 or 1h23m45s
[-E hop | quit] Hop/Quit after outputting successful event(s)
[-h] Output this usage help and exit
Use -d, -g, -R, -X, -F, -M, -r, -w, or -W without argument for more help