简介：这份《Four-Faith四信LoRaWAN产品使用说明书》面向物联网开发工程师、嵌入式技术人员及LoRaWAN应用方案设计者，用于解决四信LoRaWAN终端节点在选型、配置与组网调试中的实操问题。文档围绕F8L10T、F8L10D、F8L10A等型号展开，涵盖LoRaWAN网络架构（终端节点、网关、网络服务器）、终端节点准备、OTAA与ABP参数配置、加网操作、中继功能、确认式与非确认式数据传输及AES、RSA加密等内容，并延伸至智能家居、工业自动化、智能农业等典型场景。资源包为1个PDF文件，大小约1.72MB，共25页，目录结构清晰，按系统简介、终端节点准备、数据传输、应用场景等章节编排，便于按模块查阅。目前已有217人学习下载，适合需要快速上手四信LoRaWAN产品、对照完成参数配置与排错的中高级物联网技术人员参考。
1. 从一份 25 页的 LoRaWAN 说明书说起：F8L10 系列到底能拿来做什么
手上拿到一份 25 页的 LoRaWAN 产品使用说明书，翻完第一遍的感觉是：信息密度不低，但章节顺序是按“系统简介 → 终端准备 → 数据操作”排的，真正上手时你会发现，最该先搞清楚的其实是“我手上这块板子属于哪个型号、它能不能加网、加网失败该看哪一段”。这份文档覆盖的是 F8L10T、F8L10D、F8L10A 三个系列，都是不带 PA 的版本，定位分别是带外壳的串口终端、可嵌入的模组、以及超小尺寸模组。如果你正在做智能表计、环境监测、工业采集这类低功耗广域网的节点侧开发，这份说明书就是终端侧的“操作底图”——它不讲服务器怎么搭，但把终端从接线、配参、加网到上下行数据的完整链路讲清楚了。适合谁？适合已经选定 LoRaWAN 架构、需要把终端节点跑通的嵌入式工程师和 IoT 方案落地人员。不适合谁？不适合还在选型阶段、连 NS 和 CS 分工都没分清的人，因为文档默认你已经有了服务器侧的配合方。
2. 三个型号的硬件底子：F8L10T、F8L10D、F8L10A 怎么选、怎么接
2.1 型号差异与选型逻辑
先把三个型号的定位摆清楚，这决定了你后面接线和配置的方式完全不同。
F8L10T 是带外壳的成品终端，对外提供 RS232/RS485 接口，可以直接用出厂配置的串口线接 PC，也支持 IO 输入输出和 AD 采集。它的 IO3、IO4 采集电流信号（0-20mA），IO5 采集电压信号（0-3.3V），换算方法在另一份《F8L10T LoRa 终端说明书》里。如果你做的是工业现场采集，需要直接接传感器或变送器，F8L10T 是最省事的选择。
F8L10D 是模组形态，体积小，适合嵌入到已有产品中。它提供开放的 AT 指令，引脚定义在文档里列了 27 个脚，包括 UART、GPIO、ADC、休眠控制、状态指示等。注意它的第 9 脚（IO1/SLEEP_RQ）和第 12 脚都是休眠控制脚，任何一脚高电平为唤醒，皆为低电平才休眠。这个“皆为低电平”的逻辑在实际接线时容易翻车，后面避坑章节会展开。
F8L10A 是超小尺寸模组，15×15×2.5mm，同样提供 AT 指令。它的引脚定义是 20 个脚，GPIO 编号和配置工具里的 IO1-IO5 是对应的。F8L10A 的 IO5 可以配置为模拟量输入，但范围只有 0-1.2V，比 F8L10D 的 0-3.3V 窄不少，选型时如果要用 ADC 功能，这个量程差异必须提前确认。
选型上我一般会这样判断：需要成品外壳和 485 接口，选 F8L10T；需要嵌入且对体积有要求但还能接受常规模组尺寸，选 F8L10D；空间极度受限且 ADC 量程够用，选 F8L10A。三个型号都不带 PA，所以发射功率和覆盖距离不要按带 PA 的版本去预期。
2.2 硬件连接的具体操作
F8L10T 的连接最简单：用出厂配置的 RS232 串口线或 RS232-485 转换线，把终端和配置 PC 连起来就行。不需要额外转接板。
F8L10D 需要把模块和主机连接，主机可以是 PC 也可以是其他带 UART 接口的设备。与 PC 相连时，用配套的开发板。接线时注意 TX 和 RX 是交叉的，模块的 TX 接主机的 RX，模块的 RX 接主机的 TX，这是串口通信的基本功，但每次换板子都有人接反。
F8L10A 的连接方式和 F8L10D 基本一致，但多了一步：模块需要先放在转接板上，才能和配置板配套。这里有两个文档里明确标出的注意事项，我直接抄下来：
- F8L10A 模块的 1-20 引脚与转接板上方的牛角座 1-20 脚是对应的，但与配置板结合的排针脚为非对应关系。这句话的意思是，你不能按引脚编号直接推配置板上的位置，必须看转接板的丝印。
- 配置板电源旁边的跳线帽必须插在 3.3V 端，否则 F8L10A 无法正常工作。这个跳线帽默认可能不在 3.3V，拿到板子第一件事就是检查。
- 如果要测试 IO 口功能，除了 1（VCC）、2（TX）、3（RX）、5（Reset）、6（GND）之外的跳线帽全部拔除，避免配置板电压对模块 IO 造成影响。
提示：F8L10A 的转接板和配置板之间的排针是非对应关系，接线前务必对照转接板丝印，不要凭引脚编号直接插。
3. 参数配置的五个模块：网络、系统、串口、IO、其他参数逐项拆解
3.1 配置方式与工具准备
文档给了两种配置方式：一是用“四信 LoRa 配置软件 LoRaConfig”（V2.2.9 以上版本），适合用 PC 配置的场景；二是用扩展 AT 命令，适合有串口通信程序的场景，Windows 下超级终端、Linux 下 minicom、putty 都可以，也可以由用户的单片机系统直接配置。
我一般会先用 LoRaConfig 把参数过一遍，因为界面把参数分成了网络参数、系统参数、串口参数、IO 端口、其他参数五大块，一目了然。配置工具的默认串口参数是 115200、8N1，语言中文。点击“加载参数”后会读出设备现有参数。
这里有一个关键操作习惯：在配置工具上修改完毕后点击“写参数”，工具会在相关 AT 指令发送完后追加“AT+SAV”（保存配置到 Flash 的指令），实现掉电保存。如果你是用串口直接发 AT 指令配置，配置完后必须手动再发一次“AT+SAV”，否则掉电后配置丢失。这个坑后面还会提。
3.2 网络参数：密钥、Class 类型、ADR 与速率
网络参数是加网的核心，主要配置密钥、网络类型、射频参数。
设备类型分终端、中继器、盲区终端，默认是终端。中继器和盲区终端的用法在 2.3 节中继功能里讲。
设备 Class 类型支持 Class A 和 Class C。Class A 仅在上行后打开接收窗口，接收服务器缓存的下行数据；Class C 在加网发送数据后持续打开接收窗口。文档里有一句很关键的提醒：设备类型一般为 Class A，如需长期供电并实时接收下行数据，则要和厂商沟通使用 Class C。这句话的潜台词是，Class C 不是配置工具里随便选一下就能用的，涉及功耗和供电方式，需要确认。
消息应答类型配置数据发送后服务器是否应答。这个参数影响的是确认式传输还是非确认式传输，按你的业务可靠性要求来选。
设备 EUI、AppKey、AppEUI 是加网相关参数，文档说可向厂商索取。实际操作中，这些参数是终端出厂携带的，你需要把 DevEUI 等信息提供给技术支持，让他们录入 LoRaWAN 服务器，为你搭建通信测试环境。这一步是很多新手卡住的地方——以为配置好终端就能加网，实际上服务器侧没有录入你的设备信息，加网必然失败。
速率自适应就是 LoRaWAN 的 ADR 调速机制，适用于非移动终端。服务器按终端上行数据的信噪比，下发指令调节终端速率，把速率和发送功率调到最佳状态。但文档明确写了“可能会存丢包现象，慎用”。我的经验是，固定安装、信号环境稳定的场景可以开，移动或信号波动大的场景建议关掉，手动固定速率等级。
上行数据速率参数是速率等级，需要参考官方的《LoRaWAN 地区参数手册 V1.0.3》得到对应的扩频因子和带宽。上行发射功率参数是发射功率等级，同样参考那份手册得到对应的 dBm 值。这两个参数不要凭感觉填，速率等级和功率等级都是离散的枚举值，填错了要么通不了，要么违规。
3.3 系统参数：工作模式、休眠、自动加网与心跳包
系统参数配置的是工作模式、休眠、心跳包等应用相关参数。
工作模式有透传和 AT 两种。透传模式下，加网后可通过串口直接发数据，会转发到服务器；如果未加网，会拒绝发送。AT 模式下，可通过 AT 指令进行设置、加网、发送等操作。如果你要用单片机控制，透传模式更省事；如果你要在 PC 上调试，AT 模式更灵活。
调试等级默认为 0。文档明确说了，出现加网失败等问题时，提高调试等级可通过模块打印的 LOG 排查问题原因。这个建议非常实用，后面避坑章节会展开怎么用。
信号强度展示默认为不显示，打开后可以看到接收信号的信号强度和信噪比。调试阶段建议打开，现场部署时可以关掉减少串口输出。
发送完成通知是 TxDone 引脚的脉冲提示。如果你用 GPIO 做发送完成中断，这个要打开。
休眠模式有不休眠和深度休眠两种。文档特别标注“空中唤醒为无效选项请不要选择”。F8L10D 的第 9 脚（IO1）和第 12 脚为休眠控制脚，任何一脚是高电平为唤醒状态，皆是低电平为休眠状态。F8L10A 第 9 脚（IO1）为休眠控制脚，高电平唤醒，低电平休眠。注意 F8L10D 是“任何一脚高电平即唤醒”，这意味着如果你只控制一个脚，另一个脚悬空或拉低，模块可能无法进入休眠。这是实际接线中很容易忽略的点。
自动加网默认为否，支持“否”、“自动”、“上电”三个选项。“否”是上电不加网；“自动”是上电后判断是否已加网，已加网则不操作，未加网则加网；“上电”是不管是否已加网都重新加网。这里有一个型号差异：F8L10D 加网后会保存加网参数和上行帧计数，重启后不需要重新加网；F8L10A 保存了加网参数但未保存上行帧计数，重启后需要重新加网。所以 F8L10A 建议设为“上电”，实现上电自动加网。
心跳包周期默认为 0s，不发送心跳包。唤醒发心跳包设置每次唤醒后是否发送心跳包。这两个参数按业务需求配，没有特殊要求就保持默认。
3.4 串口参数与 IO 参数
串口参数主要配置串口相关设置，数据帧间隔为 20ms，暂不开放修改。默认值波特率 115200、属性 8N1。串口参数需要重启生效。
IO 参数配置 5 个 IO 口的功能，都可配置为输入、输出模式。模拟量输入方面：F8L10T 的 IO3、IO4 可采集电流 0-20mA，IO5 可采集电压 0-3.3V；F8L10D 的 IO3、IO4、IO5 可配置为模拟量输入，范围 0-3.3V；F8L10A 的 IO5 可配置为模拟量输入，范围 0-1.2V。
这里有一个必须注意的点：IO1 为深度休眠的控制引脚，如果使用深度休眠模式，IO1 请使用默认的“不使用”选项。也就是说，你不能既用 IO1 做深度休眠控制，又把它配成其他 IO 功能。
采集间隔是 IO 状态值定时上报的周期，周期为 0 默认不上报。文档特别说明，因 LoRaWAN 协议特性，为防止空中信道拥堵，该条指令设置时间下限为 15S，设置时间大于 0 小于 15，当成 15 计。这个下限是硬性的，不要试图设更短。
Modbus 功能开关默认为关闭。如果用户需要远程下发 Modbus 命令进行 IO 状态采集，需要开启该功能。IO 功能配置无需重启便可生效，这是五大块参数里唯一不需要重启的。
3.5 其他参数：频点、通道数与组播
其他参数配置频点、通道数和组播功能，写入后需要重启生效。
地区参数部分，上行起始频点和上行通道数决定模块通信使用的频点，每个频点间隔为 200KHz。使用规则参考 AT 命令手册。这里不要自己算频点，按手册给的规则来。
组播参数部分，配置组播短地址及密钥。文档明确写了：组播设备必须处于 Class C。如果你要用组播功能，Class 类型必须选 Class C，否则组播收不到。
3.6 配置工具使用的三个关键注意点
第一，配置工具上点“写参数”会自动追加“AT+SAV”，但如果你用串口直接发 AT 指令，配置完后必须手动发“AT+SAV”保存到 Flash，否则掉电丢失。
第二，多数配置需要重启生效，所以每次配置结束后最好重启设备。不要配完一项就急着测，先把要改的都改完，重启一次。
第三，F8L10A 暂时不兼容用该配置工具进行升级，升级方法见另一份《F8L10A 产品固件升级使用说明书》。如果你拿 F8L10A 想用 LoRaConfig 升级固件，会失败。
4. 加网与中继：从 AT+JON 到盲区终端 Mesh 链路搭建
4.1 终端加网的操作步骤与成功/失败判断
配置好参数并重启后，终端可以通过串口工具加网。串口工具参数为 115200bps、8 数据位、1 停止位、无校验、无流控。
终端在 AT 模式下，发送 AT+JON 命令进行加网。如果不在 AT 模式，可以发送“+++”进行加网操作。注意 AT 命令均以换行符结尾，工具上需要勾选“发送新行”。这个细节看起来小，但不勾选的话命令不生效，新手经常在这里卡住。
加网成功或失败会有 LOG 提示。文档给了成功和失败的示例，但没有贴出具体 LOG 内容，实际调试时以模块打印为准。
加网失败重新加网上限为 16 次，期间会尝试所配置的不同频点。文档列了四种常见失败情况：设备 EUI 和 AppKey 未录入服务器；终端设备 EUI 和 AppKey 配置错误；设备天线没接好或非适配天线；基站未与服务器建立连接。这四条基本覆盖了 90% 的加网失败场景，排查时按这个顺序过一遍。
4.2 中继功能的参数配置与链路搭建
F8L10A 的 LoRaWAN 版本支持中继功能，中继跳数为一跳。设备类型分为终端、中继器、盲区终端。盲区终端与中继器的通信方式为私有协议的 mesh 网络，盲区终端将数据传输给中继设备，中继设备通过 LoRaWAN 协议转发给基站，进而传输给服务器。
中继功能的相关参数配置有五个关键项：
- 网络号：盲区终端和中继器必须相同，不同网络号的数据会被丢弃。
- 设备 ID：中继器设置为 0，盲区终端为非 0 且不重复。
- 透传地址：盲区终端的透传地址设置为中继器 ID，中继器透传地址不用修改。
- 空中速率：默认为 3 level，1 level 发送速率最慢传输距离最远，6 level 发送速率最快传输距离最近。盲区终端和中继器的空中速率必须相同，否则无法通信。
- 发送功率：单位 dBm。
- 载波频率：盲区终端与中继器必须同一个频点，用户可按地区相关规定进行调节。
通信说明里有三条硬性约束：盲区终端和中继器要建通信，Mesh 网络参数必须符合上述要求；中继器必须处于 Class A 类型，因为需要兼容服务器和 Mesh 网络的接收窗口，所以不能用 Class C；由同一个中继器上行的所有盲区终端的数据，在服务器上同一个中继器设备 EUI 的数据目录下。
链路搭建的操作顺序是：盲区终端无需加网，中继器开机后会自动强制加网，所有数据通信操作必须要在中继器加完网之后。也就是说，你先给中继器上电，等它加网成功，再让盲区终端发数据。如果中继器还没加网成功，盲区终端的数据发过去也没人转发。
注意：中继器必须用 Class A，不能用 Class C。这个限制来自 Mesh 网络和 LoRaWAN 接收窗口的兼容性要求，配错了中继链路直接不通。
5. 数据上下行与服务器对接：MQTT 替代与自建 CS 平台
5.1 数据上行与下行的基本操作
数据上行是终端（模块）上行数据方法，文档在 3.2 节给了终端上行数据方法和查看上行数据步骤。数据下行在 3.3 节。这两节的操作主体是用户，也就是说，文档假设你已经有了客户服务器（CS），终端的数据上行到 NS，NS 转发给你的 CS，你在 CS 上查看和处理。
透传模式下，加网后通过串口直接发数据，数据会转发到服务器。AT 模式下，通过 AT 指令发送。上行数据的查看需要在服务器侧操作，终端侧只能看到发送是否成功的提示。
数据下行方面，Class A 仅在上行后打开接收窗口以接收服务器缓存的下行数据，Class C 持续打开接收窗口。如果你需要实时下发命令，Class A 会有延迟，因为要等终端下一次上行后才能收到下行。
5.2 用 MQTT 工具替代客户服务器
文档 3.4 节提到使用 MQTT 工具替代客户服务器。这是一个很实用的调试手段：在你还没有搭建好自己的 CS 平台时，可以用 MQTT 工具订阅 NS 转发的数据，验证终端上行链路是否通畅。
具体操作上，你需要从 NS 侧获取 MQTT 的接入地址、端口、主题和认证信息，然后在 MQTT 客户端里订阅对应的上行主题。终端发数据后，如果 MQTT 客户端能收到，说明终端到 NS 的链路是通的，问题就在你的 CS 对接上。如果 MQTT 客户端收不到，问题在终端或 NS 侧。
这个方法的边界是：MQTT 工具只是替代 CS 做数据查看，不能替代 CS 做业务处理。它适合调试阶段快速验证链路，不适合生产环境。
5.3 客户自建 CS 平台如何对接
文档 3.5 节讲客户自建 CS 平台如何对接。这部分的具体对接协议和接口定义，文档没有展开，需要参考 NS 侧的对接文档。从终端侧的角度，你需要确认的是：终端上行数据的格式（透传模式下就是串口发出去的原始数据）、加网参数（DevEUI、AppEUI、AppKey）是否正确录入 NS、以及 NS 是否配置了转发到你的 CS。
对接时常见的卡点是数据格式。透传模式下，终端串口发什么，服务器就收到什么，没有额外的封装。如果你的 CS 期望的是 JSON 格式，需要在 CS 侧做解析，而不是在终端侧做格式化。终端侧只负责把数据发出去，格式化是服务器侧的事。
6. 避坑与排查：加网失败、休眠异常、配置丢失的现场记录
6.1 加网失败：先查服务器录入，再查天线和基站
现象：终端发 AT+JON 后，LOG 提示加网失败，重试 16 次后停止。
原因：按文档列的四种常见情况排查。最常见的是设备 EUI 和 AppKey 未录入服务器，其次是终端配置的 EUI 和 AppKey 与服务器录入的不一致。天线没接好或用了非适配天线也会导致加网失败，因为加网需要双向通信，接收灵敏度不够就收不到服务器的接受消息。基站未与服务器建立连接的情况较少见，但如果你用的是别人的基站，需要确认基站侧的状态。
解决：先确认服务器侧已录入正确的 DevEUI、AppEUI、AppKey。然后检查终端配置的这三个参数是否与服务器一致。再检查天线是否接好、是否为适配天线。最后确认基站与服务器的连接状态。如果这四步都过了还是失败，提高调试等级看模块打印的 LOG，LOG 里会有更具体的失败原因。
6.2 休眠控制：F8L10D 双引脚逻辑导致的休眠失败
现象：F8L10D 配置了深度休眠，但模块无法进入休眠，或者休眠后无法唤醒。
原因：F8L10D 的第 9 脚（IO1）和第 12 脚都是休眠控制脚，文档明确写了“任何一脚是高电平为唤醒状态，皆是低电平为休眠状态”。如果你只控制了其中一个脚，另一个脚悬空或电平不对，模块就无法按预期进入休眠。另外，如果 IO1 被配置为其他 IO 功能，深度休眠控制会失效。
解决：使用深度休眠模式时，IO1 保持默认的“不使用”选项。两个休眠控制脚都要拉到低电平才能休眠，任何一个拉高就会唤醒。实际接线时，如果不用的那个脚，要确保它被拉到低电平，不要悬空。
6.3 配置丢失：AT+SAV 漏发导致掉电后参数还原
现象：用串口直接发 AT 指令配置了参数，测试正常，但设备断电重启后参数恢复成默认值。
原因：配置工具点“写参数”会自动追加“AT+SAV”，但用串口直接发 AT 指令时，没有自动保存机制。文档在 2.1.3.6 节明确写了这一点。
解决：每次用 AT 指令配置完后，手动发送“AT+SAV”保存到 Flash。我一般会在配置脚本的最后固定加一条 AT+SAV，不管前面改了几项，最后都保存一次。
6.4 F8L10A 重启后需要重新加网
现象：F8L10A 加网成功后，断电重启，发现需要重新加网才能通信。
原因：文档在 2.2.2.1 节的注意事项里写了，F8L10A 有保存加网参数，但是未保存上行帧计数，重启后需要重新加网。F8L10D 则保存了加网参数和上行帧计数，重启后不需要重新加网。
解决：将 F8L10A 的系统参数中“自动加网”设置为“上电”，实现模块上电重启后自动进行加网。这样虽然还是要重新加网，但不需要人工干预。
6.5 ADR 开启后的丢包问题
现象：开启了速率自适应（ADR），在信号环境稳定的场景下出现偶发丢包。
原因：文档在网络参数配置里写了，ADR 机制下服务器会调节速率和发送功率，可能会存丢包现象。这是因为服务器根据信噪比调整参数时，如果调整后的参数在当前环境下不是最优，就会导致丢包。
解决：固定安装、信号环境稳定的场景可以开 ADR；移动或信号波动大的场景建议关掉 ADR，手动固定上行数据速率和上行发射功率。手动固定时，速率等级和功率等级参考《LoRaWAN 地区参数手册 V1.0.3》，不要凭感觉填。
7. 进阶技巧：用调试等级和 LOG 把加网问题定位到具体环节
调试等级这个参数，默认是 0，很多人配置时直接跳过。但文档在系统参数配置里明确写了：出现加网失败等问题时，提高调试等级可通过模块打印的 LOG 排查问题原因。这是整份说明书里最实用的一条排查建议，但也是最容易被忽略的。
我一般的做法是：拿到新模块，先把调试等级调到最高，接上串口工具，发一次 AT+JON，把完整 LOG 抓下来。LOG 里会显示模块尝试了哪些频点、每次尝试的结果、以及失败的具体原因。加网失败的四条常见情况里，“设备 EUI 和 AppKey 未录入服务器”和“终端配置错误”在 LOG 里的表现是不同的：前者是模块发出加网请求后收不到任何回应，后者是模块发出的请求参数与服务器预期不匹配，服务器直接拒绝。通过 LOG 可以区分这两种情况，避免盲目排查。
另一个技巧是信号强度展示。调试阶段打开这个选项，LOG 里会带上接收信号的信号强度和信噪比。如果信噪比很低，说明天线或环境有问题，加网失败是信号质量导致的，不是参数问题。这个信息比单纯看“加网失败”四个字有用得多。
还有一个操作习惯：每次改完参数，先点“写参数”，再点“重启设备”，等模块重启完成后再发 AT+JON。不要改一项测一项，因为多数配置需要重启生效，改一项重启一次效率太低。把网络参数、系统参数、串口参数、其他参数一次性改完，重启一次，再统一测试。
最后说一个关于 AT+SAV 的习惯。我见过太多人用串口工具发 AT 指令配置，测通了就直接断电，结果下次上电发现参数没了。从那以后我每次用 AT 指令配置，不管改了几项，最后都强制发一遍 AT+SAV，然后再发一次 AT+REBT 重启。这个习惯帮我省了很多“参数怎么又还原了”的排查时间。希望帮到你。
本文还有配套的精品资源，点击获取
