GraftSense E22-900M22S无线模块快速应用通过硬件连接、驱动安装、初始配置、和代码运行四个步骤实现无线模块快速上手。GraftSense E22-900M22S LoRa模块通过双主控架构和UART命令桥设计，将复杂的LoRa底层开发简化为标准串口通信。本文手把手教你从硬件连接、驱动安装、参数配置到代码运行，10分钟内跑通第一个LoRa通信示例。
引脚 | 名称 | 功能说明 | 电平 |
1 | GND | 电源地 | — |
2 | +5V | 电源输入（5V） | 5V |
3 | SRX | RP2040 UART1接收（外部主控TX接此脚） | 3.3V |
4 | STX | RP2040 UART1发送（外部主控RX接此脚） | 3.3V |
串口连接注意事项：由于无线模块设计时已将原RX网络标记为TX、原TX网络标记为RX，因此外部主控与LoRa模块连接时串口信号无需交叉——RX接RX，TX接TX。具体连接：外部主控TX→模块SRX，外部主控RX→模块STX，外部主控GND→模块GND（共地），外部主控5V→模块+5V（供电）。如果外部主控是5V电平，需在TX线路上增加电平转换。
上电前检查清单：
①、先断电安装850-930MHz匹配天线，再接通5V电源，禁止无天线发射；
②、测得模块VCC稳定在3.3V后才运行射频程序；
③、禁止把5V直接接到E22 VCC或SPI/控制信号；
④、确认天线频段匹配（850-930MHz）。
无线模块驱动已发布至MicroPython包仓库（uPyPI），可通过mpremote的mip工具直接安装：
安装命令：mpremote mip install https://upypi.net/pkgs/lora_driver/1.0.0
板载RP2040-Zero需上传完整驱动文件（_sx126x.py、sx126x.py、sx1262.py、e22_900m22s.py、e22_uart_protocol.py、e22_uart_bridge.py、main.py），重新上电后MicroPython自动执行main.py启动UART命令桥服务。外部应用主控只需上传e22_uart_client.py（E22_UART_Client类，封装高层API）和e22_uart_protocol.py（协议定义）两个文件即可。
配置项 | 建议起始值 | 说明 |
频率 | 915.0MHz | 按地区调整，中国470M，北美915MHz，欧洲868MHz |
带宽BW | 125kHz | 带宽越小灵敏度越高、速率越低 |
扩频因子SF | SF9 | SF越大距离越远但速率越低，两端必须一致 |
编码率CR | 4/7 | 抗突发干扰能力，两端必须一致 |
同步字 | 0x12 | 私有网络常用值，不同同步字的网络互不干扰 |
输出功率 | 先10-14dBm | 供电和天线验证后再逐级提高至22dBm |
DIO2射频开关 | 启用 | 本板TXEN/RXEN自动切换所必需 |
参数调整建议：需要更远距离可增大SF（SF10-SF12）、减小BW（62.5kHz），但速率降低；需要更高速率可减小SF（SF7-SF8）、增大BW（250kHz），但距离缩短。根据实际应用场景在距离和速率之间取平衡。
上电后首先调用e22.ping()，确认外部主控与板载RP2040之间的UART通信正常，命令桥服务已启动。成功返回pong说明正常；超时无响应则检查UART接线、波特率115200、是否共地和模块供电。
ping成功后调用e22.initialize(915.0, output_power_dbm=0)，配置频率915MHz、发射功率0dBm（先低功率验证）。通信两端都需要执行initialize且参数必须一致。
初始化成功后，一端调用e22.send(b"hello")发送测试数据。send命令触发SX1262进入发射模式，DIO2/TXEN自动拉高使能发射通道，数据通过LoRa调制后由天线发射。
另一端调用payload, rssi_dbm, snr_db = e22.receive(timeout_ms=5000)，等待5秒接收数据。接收到数据后返回payload（字节数据）、rssi_dbm（接收信号强度dBm）、snr_db（信噪比dB）；5秒内无数据返回None。
单向通信验证成功后，进行双向通信测试：A端发送"hello from A"，B端接收后回复"hello from B"，A端接收回复。如果双向通信都正常，说明LoRa模块硬件、驱动、配置都工作正常，可以开始开发应用逻辑。
A：通信距离地域标准距离可以按照以下按顺序排查：
①、检查UART接线（外部TX接模块SRX、外部RX接模块STX，注意本模块串口已板内交叉，外部RX接RX、TX接TX）；
②、检查波特率是否115200 8N1；
③、检查是否共地；
④、检查模块供电（5V输入和3.3V LDO输出是否正常）；
⑤、检查板载RP2040是否已上传main.py并正常运行。
A：通信距离地域标准距离可以按照以下顺序排查：
①、确认两端频率、SF、BW、CR、同步字参数完全一致；
②、确认两端天线都已连接且频段匹配（850-930MHz）；
③、确认DIO2射频开关已启用（initialize时必须启用）；
④、将两端靠近（1米内）测试排除距离过远问题；
⑤、降低发射功率验证（高功率可能导致电源不稳）；
⑥、检查接收端是否真的进入接收模式。
GraftSense E22-900M22S无线模块的快速上手只需四步：硬件连接（4Pin接口，串口无需交叉）、驱动安装（uPyPI mip一键安装，板载7个文件+外部2个文件）、初始配置（频率915MHz/SF9/BW125kHz/CR4/7/同步字0x12/功率先10-14dBm）、代码运行（ping→initialize→send→receive四步跑通通信）。GraftSense LoRa无线模块的双主控架构和UART命令桥设计让开发者无需关心SPI驱动、寄存器配置、中断处理等底层细节，只需几行代码即可完成LoRa通信。按照本教程操作，10分钟内即可跑通第一个LoRa通信示例。
成都亿佰特电子科技有限公司作为深耕物联网无线通信传输领域十多年的国家高新技术企业，提供LoRa/蓝牙/WiFi/zigbee/LPWAN/超外差/SPI/SoC片上系统/无线音视频传输/毫米波雷达等无线数传模块到串口服务器/遥控开关/数传电台/工业通信网关/远程IO模块/模拟量开关量采集模块/Profinet转modbus模组等工业通信设备以及嵌入式核心板、单板机、工控机、电源模块、配套天线设备、传感探测器等物联网模组全链路产品矩阵，所有无线通信模块产品通过CE、FCC、ROHS、3C、ISO和无线电发射设备型号核准等权威认证，具有工业级、低功耗、高性能、高性价比、远距离通信等特点，已在智慧农业、工业物联网、智慧城市智能家居等领域规模化落地。
如需进一步了解LoRa模组选型或获取技术支持，欢迎通过以下方式联系亿佰特物联网应用专家：
产品选型与技术咨询：拨打4000-330-990，技术专员一对一解答
技术支持邮箱：support@cdebyte.com
官网了解更多：亿佰特官网—查看完整LoRa模组产品与技术资料
微信公众号：搜索"cdebyte"关注微信公众号，获取最新产品动态与应用方案
相关阅读：
3、LoRa模块天线怎么选？增益/类型/长度对通信距离影响实测
