小羊肉肉.
0548c1555f
主要更改： 1. 新增使用手册： - AI算法更新指南 - HTPA60x40传感器升级指南 - 环境配置教程 2. 传感器模块优化： - HTPA60x40dR1L0.9传感器集成 - HTPAd32x32L1k7传感器更新 - 传感器配置文档完善 3. 项目文档整理： - 删除过期的433MHz使用指南 - 更新README文档结构 - 完善配置教程链接 目标：完善项目文档，优化传感器集成
155 lines
3.0 KiB
Markdown
155 lines
3.0 KiB
Markdown
# 433MHz模块使用指南
|
||
|
||
## 概述
|
||
|
||
本文档介绍如何使用ESP32上集成的RTM300-433M模块进行433MHz无线通信。该模块基于CMT2300A芯片，支持FSK调制，可用于各类433MHz无线设备的控制和数据接收。
|
||
|
||
## 硬件连接
|
||
|
||
RTM300-433M模块通过以下引脚连接到ESP32：
|
||
|
||
| 模块引脚 | ESP32引脚 | 功能描述 |
|
||
|---------|----------|---------|
|
||
| CSB | GPIO48 | 主片选（寄存器控制） |
|
||
| FCSB | GPIO47 | FIFO片选（数据控制） |
|
||
| SCLK | GPIO9 | SPI时钟线 |
|
||
| SDIO | GPIO4 | SPI双向数据线 |
|
||
| IO3 | GPIO37 | 接收中断引脚 |
|
||
| IO1 | GPIO36 | 辅助状态引脚 |
|
||
|
||
## 功能特性
|
||
|
||
- 工作频率：433.92MHz
|
||
- 调制方式：FSK
|
||
- 数据速率：1.2Kbps
|
||
- FIFO大小：32字节
|
||
- 通信方式：HTTP API接口
|
||
|
||
## HTTP API接口
|
||
|
||
### 1. 获取模块状态
|
||
|
||
```
|
||
GET /api/rf433/status
|
||
```
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"ready": true,
|
||
"version": "1.0.0",
|
||
"mode": "receive"
|
||
}
|
||
```
|
||
|
||
### 2. 发送数据
|
||
|
||
```
|
||
POST /api/rf433/send
|
||
```
|
||
|
||
**请求体：**
|
||
```json
|
||
{
|
||
"data": "A55A01020304" // 十六进制字符串
|
||
}
|
||
```
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"success": true,
|
||
"length": 6,
|
||
"message": "数据发送成功"
|
||
}
|
||
```
|
||
|
||
### 3. 设置接收模式
|
||
|
||
```
|
||
POST /api/rf433/receive
|
||
```
|
||
|
||
**请求体：**
|
||
```json
|
||
{
|
||
"enable": true // true启用接收模式，false禁用
|
||
}
|
||
```
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"success": true,
|
||
"mode": "receive",
|
||
"message": "接收模式已启用"
|
||
}
|
||
```
|
||
|
||
### 4. 读取寄存器（调试用）
|
||
|
||
```
|
||
GET /api/rf433/register?addr=0x00
|
||
```
|
||
|
||
**响应示例：**
|
||
```json
|
||
{
|
||
"address": "0x00",
|
||
"value": "0x05",
|
||
"description": "控制寄存器"
|
||
}
|
||
```
|
||
|
||
## 使用示例
|
||
|
||
### Python测试脚本
|
||
|
||
项目根目录下提供了`test_433mhz.py`脚本，用于测试433MHz模块的基本功能：
|
||
|
||
```bash
|
||
# 使用默认IP地址(192.168.1.3)
|
||
python test_433mhz.py
|
||
|
||
# 指定设备IP地址
|
||
python test_433mhz.py --ip 192.168.1.100
|
||
```
|
||
|
||
### 发送自定义数据
|
||
|
||
可以使用任何HTTP客户端（如curl、Postman等）发送自定义数据：
|
||
|
||
```bash
|
||
curl -X POST http://192.168.1.3/api/rf433/send \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"data": "A55A01020304"}'
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
1. **模块初始化失败**
|
||
- 检查硬件连接是否正确
|
||
- 确认ESP32固件已正确烧录
|
||
- 重启设备尝试重新初始化
|
||
|
||
2. **发送数据失败**
|
||
- 确认数据格式正确（十六进制字符串）
|
||
- 数据长度不能超过32字节
|
||
- 检查模块状态是否就绪
|
||
|
||
3. **无法接收数据**
|
||
- 确认已启用接收模式
|
||
- 检查发送设备是否工作在相同频率
|
||
- 确认发送设备与接收设备距离适当
|
||
|
||
## 注意事项
|
||
|
||
1. 433MHz模块初始化在单独的任务中进行，不会阻塞主系统运行
|
||
2. 模块初始化有3秒超时保护，超时后系统会继续运行
|
||
3. 中断处理已优化，不会导致串口监视器卡顿
|
||
4. 使用433MHz功能时，请遵守当地无线电管理规定
|
||
|
||
## 技术支持
|
||
|
||
如有问题或需要技术支持，请联系项目维护人员。
|