rtl_433项目操作指南：从基础使用到高级信号分析

rtl_433项目操作指南：从基础使用到高级信号分析

rtl_433 Program to decode radio transmissions from devices on the ISM bands (and other frequencies) 项目地址: https://gitcode.com/gh_mirrors/rt/rtl_433

项目概述

rtl_433是一款功能强大的无线信号接收和解码工具，主要用于接收和解析433MHz、868MHz等ISM频段的无线信号。该项目支持多种硬件设备，包括常见的RTL-SDR接收器，能够解码200多种不同的无线协议，广泛应用于气象站、智能家居设备、无线传感器等物联网设备的信号接收和分析。

核心架构

rtl_433的核心处理流程由以下几个关键模块组成：

1. 输入模块：支持RTL-SDR、SoapySDR和rtl_tcp等多种输入源
2. 加载器：支持从文件加载原始数据(cu8, cs16等格式)
3. 信号处理：包括OOK/FSK解调、脉冲检测、切片和编码处理
4. 信号分析：提供脉冲统计信息
5. 解码器：内置200多种协议解码器
6. 转储器：支持将原始数据保存到文件
7. 输出模块：支持屏幕显示(KV)、JSON、CSV、MQTT等多种输出格式

输入设备配置

RTL-SDR设备

RTL-SDR是最常用的输入设备，配置方式如下：

# 使用设备索引号(默认0表示第一个设备)
rtl_433 -d 0

# 使用设备序列号(需提前用rtl_eeprom设置)
rtl_433 -d :NESDRSMA

SoapySDR设备

SoapySDR提供了更广泛的硬件支持：

# 使用默认SoapySDR设备
rtl_433 -d ""

# 指定特定驱动
rtl_433 -d "driver=rtlsdr"
rtl_433 -d "driver=plutosdr"

rtl_tcp网络输入

通过网络接收来自rtl_tcp服务器的数据：

# 默认连接localhost:1234
rtl_433 -d rtl_tcp

# 指定服务器IP和端口
rtl_433 -d rtl_tcp:192.168.1.100:1234

接收参数调优

增益设置

# RTL-SDR自动增益
rtl_433 -g auto

# RTL-SDR手动设置增益(dB)
rtl_433 -g 30

# SoapySDR多级增益控制
rtl_433 -g "LNA=20,TIA=8,PGA=2"

频率设置

# 默认433.92MHz
rtl_433 -f 433.92M

# 其他常用频段
rtl_433 -f 868M
rtl_433 -f 315M

# 多频点扫描(每个频点停留5秒)
rtl_433 -f 433.92M -f 868M -H 5

采样率与PPM校正

# 设置采样率为250kHz
rtl_433 -s 250k

# 设置PPM校正值(补偿晶振漂移)
rtl_433 -p 50

解码器管理

rtl_433内置200多种解码器，可按需启用或禁用：

# 禁用特定解码器(LaCrosse和Nexus)
rtl_433 -R -8 -19

# 仅启用特定解码器
rtl_433 -R 8 19

# 禁用所有默认解码器
rtl_433 -R 0

灵活解码器配置

对于非标准协议，可以使用灵活解码器：

rtl_433 -X "n=doorbell,m=OOK_PWM,s=400,l=800,r=7000,g=1000,match={24}0xa9878c,repeats>=3"

配置参数说明：

• n：设备名称
• m：调制方式(OOK_PWM等)
• s/l：短/长脉冲宽度(μs)
• r/g：重置/间隔最大时间(μs)
• match：必须匹配的比特模式
• repeats：最小重复次数

信号分析与数据记录

信号分析模式

# 启用详细信号分析
rtl_433 -A

# 仅显示分析结果(禁用所有解码器)
rtl_433 -A -R 0

分析结果会显示脉冲宽度分布、间隔分布等信息，帮助判断信号调制方式。

数据记录

# 记录所有信号到文件
rtl_433 -S all

# 记录未知信号(未被解码的信号)
rtl_433 -S unknown

记录的文件名格式为g<NNN>_<FFF>M_<RRR>k.cu8，包含抓取序号、频率和采样率信息。

文件操作

从文件读取信号

# 从文件读取信号数据
rtl_433 -r record.cu8

支持的文件格式包括cu8、cs16、cf32等。

保存信号数据

# 保存原始信号数据
rtl_433 -w output.cu8

# 保存OOK解码数据到stdout
rtl_433 -w OOK:-

输出格式配置

rtl_433支持多种输出格式：

# 默认KV格式(屏幕显示)
rtl_433 -F kv

# JSON格式(适合程序处理)
rtl_433 -F json:log.json

# CSV格式
rtl_433 -F csv:data.csv

# MQTT输出
rtl_433 -F "mqtt://localhost:1883,user=name,pass=word"

元数据添加

# 添加时间戳和协议信息
rtl_433 -M time:iso -M protocol

# 添加自定义标签
rtl_433 -K mysensor

实用技巧

1. 频率偏移：为避免DC信号衰减，建议设置10-50kHz的频率偏移
2. 晶振校准：长期运行的RTL-SDR设备建议使用PPM校正
3. 信号分析：开发新解码器时，先用-A分析信号特征
4. 文件命名：记录文件时，文件名会自动包含频率和采样率信息
5. 灵活解码：对于未知协议，先用-X测试简单解码规则

通过合理组合这些功能，rtl_433可以满足从简单的信号接收到复杂的协议分析等各种无线信号处理需求。

rtl_433 Program to decode radio transmissions from devices on the ISM bands (and other frequencies) 项目地址: https://gitcode.com/gh_mirrors/rt/rtl_433