研几科技 · 文档中心

Appearance

Y211-L 技术手册 ​

Y211-L

Y211-L 规格书

目录 ​

  1. 概述
  2. 默认设置
  3. 串口工作模式与打包机制
  4. LoRa 参数与通信模式
  5. AT 指令调用规范
  6. 常用 AT 指令
  7. 典型配置流程
  8. 维护与升级
  9. 故障排除

1. 概述 ​

本手册用于指导 Y211-L LoRa DTU 的参数配置与联调。Y211-L 采用串口 AT 指令体系，支持透传模式和命令模式切换，可通过上位机或 MCU 完成无线参数、串口参数及中继参数配置。

项目说明
无线频段410~493 MHz
串口形态单串口（按型号支持 RS485/RS232/TTL）
典型通信距离最远约 10 km（开阔环境）
最大发射功率30 dBm
工作模式广播、定点、主从、中继组网
配置方式串口 AT 指令

2. 默认设置 ​

参数默认值
串口波特率9600 bps
数据位8
停止位1
校验位NONE
串口工作模式透传模式
起始频率410 MHz
步长1 MHz
信道0
速率档位5
LoRa 工作模式广播模式（BRD）
重发次数0
重发间隔1000 ms
中继开关OFF
中继组号0
中继规则0,0

3. 串口工作模式与打包机制 ​

3.1 串口模式 ​

Y211-L 支持两种串口工作模式：

  • 透传模式（默认）：串口数据被打包后通过 LoRa 转发。
  • AT 指令模式：串口输入作为 AT 命令执行，网络下发数据不透传。

3.2 进入 AT 指令模式 ​

推荐时序：

  1. 串口发送 +++
  2. 延时（建议 500 ms，需大于打包间隔且小于 3 s）
  3. 发送字符 a
  4. 串口收到 +ok 表示进入成功

说明：

  • 设备收到 +++ 后会暂时停止数据输出，最长约 3 秒；
  • 只有收到 +ok 后，才可进行 AT 查询/设置；
  • AT 模式掉电不保存，重启后恢复透传模式。

3.3 退出 AT 模式 ​

  • 发送 AT+EXIT\r\n，返回 OK；
  • 或直接重启设备。

3.4 打包机制 ​

串口数据满足以下任一条件即触发发送：

  • 长度触发：数据长度 >= 打包长度（默认 252，范围 5~252）
  • 间隔触发：相邻字符间隔 >= 打包间隔（默认 5 ms，范围 0~300 ms）

4. LoRa 参数与通信模式 ​

4.1 关键参数 ​

参数含义默认值
起始频率（base）频率计算基准410 MHz
步长（step）相邻信道频率间隔1 MHz
信道（ch）工作信道编号0
速率（sp）速率档位，1~9，值越大速率越快5
加密字（key）LoRa 数据加密字，1~16 字符项目配置
设备地址（id）定点/主从中的本机地址0

频率计算公式：F = base + step x ch

4.2 广播模式（BRD） ​

  • 数据仅广播转发，不改写数据内容；
  • 两端需要保持 起始频率/步长/信道/速率 一致；
  • 无需附加协议即可使用。

4.3 定点模式（FP） ​

定点模式发送帧格式（十六进制示意）：

[目标地址(2B)][目标信道(1B)][数据(nB)][XOR校验(1B)]

示例：

  • 发送到地址 0x0001，信道 0x03，数据 01 02 03：00 01 03 01 02 03 02
  • 目标地址为 0xFFFF 时，可在定点模式下实现广播发送。

4.4 主从模式（MS） ​

  • 主机发送数据时需要按主从协议组包；
  • 从机向主机回传数据时可直接透传；
  • 支持重发间隔与重发次数配置，用于降低丢包率。

主机发送帧示意：

[目标地址(2B)][数据(nB)]

4.5 中继组网 ​

中继组网关键参数：

  • AT+RELAY：中继开关
  • AT+GROUPID：中继组号
  • AT+RELAYRULE：中继输入/输出规则

典型规则：

  • 发送端组号与一级中继输入规则一致；
  • 各级中继输入规则与上一级输出规则一致；
  • 接收端组号与末级中继输出规则一致。

5. AT 指令调用规范 ​

5.1 指令格式 ​

  • 以 AT+ 开头，以 \r 或 \n 结尾；
  • 指令不区分大小写，建议统一大写；
  • 单条命令最长 256 字节（建议控制在 252 字节以内）；
  • 多参数使用英文半角逗号 , 分隔；
  • 必须等待上一条命令返回后再发送下一条（最长超时约 12 秒）。

5.2 调用类型 ​

类型发送格式返回格式
查询AT+CMD 或 AT+CMD?+CMD:value + OK
设置AT+CMD=value1,value2...OK
帮助AT+CMD=?+CMD:(参数范围...) + OK

5.3 常见错误码 ​

错误码含义
ARGS参数不合法（长度/格式/范围）
ARGC参数个数不合法
CMD_UNKNOWN未知指令
CMD_FORMAT指令格式错误
CMD_LENGTH命令长度超限
UN_VIEW参数只写不可读
DEV_MEMORY内存错误
DEV_SAVE参数保存失败

6. 常用 AT 指令 ​

6.1 设备与系统 ​

指令功能说明
AT+LIST列出支持指令调试首选
AT+VER查询固件版本返回版本号
AT+DEVINFO查询设备信息型号、版本、SN 等
AT+REBOOT重启设备参数按当前运行区生效
AT+EXIT退出 AT 模式返回透传
AT+RSTCFG恢复备份参数并重启等效 Reload
AT+BKCFG备份当前参数建议调试完成后执行
AT+CLRCFG恢复固化出厂参数并重启完全出厂恢复

6.2 串口相关 ​

指令参数范围/默认
AT+UART1=<baud>,<data>,<stop>,<parity>串口参数baud: 1200~460800（默认9600）；data: 7/8（默认8）；stop: 1/2（默认1）；parity: NONE/EVEN/ODD（默认NONE）
AT+UARTTL1=<tm>,<len>打包间隔与长度tm: 0~300 ms（默认5）；len: 5~252（默认252）

6.3 LoRa 基础参数 ​

指令参数范围/默认
AT+SPEED=<sp>LoRa 速率档位1~9（默认5）
AT+KEY=<key>LoRa 加密字1~16 字符，仅可设置不可查询
AT+FREQ=<base>,<step>起始频率、步长示例：4100,100（单位见下）
AT+CH=<ch>信道号与 base/step 共同决定频率
AT+WMODE=<mode>LoRa 工作模式BRD（广播）/FP（定点）/MS（主从）
AT+ADDR=<id>本机地址0~65535

说明：AT+FREQ 的示例使用 100 kHz 计量单位（如 4100 表示 410.0 MHz）。

6.4 主从与中继参数 ​

指令参数默认
AT+TMODE=<mode>MASTER 或 SLAVE依角色配置
AT+RETRANS=<time>,<count>重发间隔（ms）、重发次数1000,0
AT+RELAY=<state>ON / OFFOFF
AT+GROUPID=<id>中继组号（0~255）0
AT+RELAYRULE=<rule1>,<rule2>中继输入/输出规则（0~255）0,0

7. 典型配置流程 ​

7.1 广播透传快速配置 ​

  1. 进入 AT 模式（+++ -> 延时 -> a -> +ok）。
  2. 双方设置一致参数：
text
AT+FREQ=4100,100
AT+CH=0
AT+SPEED=5
AT+WMODE=BRD
  1. 设置串口参数（如需）：
text
AT+UART1=9600,8,1,NONE
AT+UARTTL1=5,252
  1. 保存备份：
text
AT+BKCFG
  1. 重启并验证链路：
text
AT+REBOOT

7.2 定点模式配置 ​

  1. 设置双方频段、速率一致：
text
AT+FREQ=4100,100
AT+SPEED=5
  1. 设置设备地址：
text
AT+ADDR=1
AT+ADDR=2
  1. 切换定点模式：
text
AT+WMODE=FP
  1. 按定点协议组包发送数据。

7.3 主从模式配置 ​

  1. 设置基础无线参数一致。
  2. 主机：AT+WMODE=MS + AT+TMODE=MASTER。
  3. 从机：AT+WMODE=MS + AT+TMODE=SLAVE。
  4. 视链路质量设置重发策略：
text
AT+RETRANS=1000,0
  1. 主机按主从协议组包发送，从机回传可直接透传。

7.4 中继组网配置建议 ​

  1. 先完成基础通信模式（广播、定点或主从）配置。
  2. 各节点开启中继功能：AT+RELAY=ON。
  3. 配置组号与规则链路：
  • 发送端组号 = 一级中继输入规则
  • 一级中继输出规则 = 二级中继输入规则
  • 接收端组号 = 末级中继输出规则
  1. 验证多跳链路后执行 AT+BKCFG 保存。

8. 维护与升级 ​

8.1 参数分区机制 ​

设备存在三类参数区：

  • 参数区：当前运行配置（查询/设置所在分区）
  • 备份区：通过 AT+BKCFG 保存
  • 固化区：出厂固化参数

推荐流程：

  1. 完成参数调试；
  2. 执行 AT+BKCFG 备份；
  3. 需要回退时执行 AT+RSTCFG；
  4. 彻底恢复出厂时执行 AT+CLRCFG。

8.2 固件升级 ​

升级步骤：

  1. 设备断电；
  2. 按住 Reload 按键上电，约 3 秒后松开，进入升级模式；
  3. 通过上位机选择固件并执行升级。

一般情况下，固件升级不影响已有参数配置；仍建议升级前执行参数备份。

9. 故障排除 ​

现象可能原因处理建议
无法进入 AT 模式时序不满足、未收到 +ok按 +++ -> 延时 500 ms -> a 重试
指令返回 CMD_FORMAT未以 AT+ 开头或缺少结束符检查命令格式和串口换行
指令返回 ARGS/ARGC参数值或个数错误先执行 AT+CMD=? 查看范围
LoRa 不通频率/步长/信道/速率不一致双端逐项核对 FREQ/CH/SPEED
定点通信失败目标地址或协议组包错误检查 ADDR 与定点帧格式/XOR
主从模式丢包重发策略未配置或链路干扰增大 RETRANS 时间并调整 count
中继链路断点组号/规则链不匹配核对 GROUPID、RELAYRULE 级联关系
参数重启后丢失未执行备份配置完成后执行 AT+BKCFG

LED 快速判别：

  • Power 常亮：供电正常
  • WORK 规律闪烁：模块运行正常
  • TX 闪烁：LoRa 发包
  • RX 闪烁：LoRa 收包