Fn-Link 3121N-H

软件开发指南
1.01
PLC-IoT Module

FN-LINK TECHNOLOGY LIMITED Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

Revision history
Revision Date Author Description
V1.00 2019.07.20 Wayne First draft
V1.01 2019.07.21 Wayne 1、 修改了 1.3 部署方案介绍

FN-LINK TECHNOLOGY LIMITED Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

Index

1. 概述 ..................................................................................................................................... 1
2. 测试环境搭建 ..................................................................................................................... 3
3. 测试评估方法 ...................................................................................................................... 3
4．软件开发指南 ................................................................................................................... 13
5．固件烧录 ........................................................................................................................... 13

FN-LINK TECHNOLOGY LIMITED Proprietary & Confidential Information

1. 概述
3121N-H 模块是由 Fn-Link 公司基于海思 Hi3921SV100 芯片开发的 PLC 通信模块，支持交流
220V 和直流 12V PLC 通信。
本文档重点描述用户如何使用 3121N-H 模组进行评估测试、软件系统集成开发。
适用于：软件工程师、测试工程师、技术支持工程师

1.1 PLC 含义
PLC 即电力线载波通信，在交流（如 AC 10KV，220V/380V）或直流（DC 12V/24V）线路上
加载载波信号传输数据。PLC 工作原理如下：

1.2 PLC 组网拓扑结构

CCO：（Concentrator）主节点模组
（Station） 子节点模组
STA：
PCO：（Proxy Coordinator） 代理子节点模组
（1）网络节点之间采用 6 字节 MAC 地址寻址，支持广播和单播通信，一个网络中只允许一个
CCO 存在。
（2）3121N-H 模组支持 CCO 和 STA 两种工作模式，可通过烧录不同软件版本实现。模组之

FN-LINK TECHNOLOGY LIMITED 1 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南
间支持自动快速组网，动态路由，多路径寻址。PCO 是具备代理中继功能的 STA 设备， CCO
根据网络信号等情况自动选择 STA 充当 PCO 角色。CCO 模组支持网络拓扑管理，如：白名单
设置和拓扑信息查询。

1.3 模组部署方案
（1） 方案一：OpenCPU

GPIO
STA
PWM
Host CCO

GPIO
?、 STA
Uart PWM
PLC

CCO 和 STA 需烧录 Fn-Link 提供的协议固件，

该方案支持 Host 从 CCO UART0 串口控制和采集所有 STA 的 GPIO/PWM 状态，
STA 最多支持 4 个 GPIO 和 1 个 PWM
（2） 方案二：Modem

STA Mcu
Host CCO U

?、 STA Mcu
Uart
PLC U

CCO 和 STA 需烧录 Fn-Link 提供的透传固件

该方案支持 CCO UART0 串口数据可广播透传給所有 STA，STA UART0 串口数据可单
播給 CCO，
CCO 和 STA 只负责透传串口数据，所有业务功能由 MCU 实现。
（3） 优点
方案一：成本低，STA 硬件接口较少
方案二：灵活性高，不受 STA 硬件接口限制

FN-LINK TECHNOLOGY LIMITED 2 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

2. 测试环境搭建
2.1 硬件准备
1、 1 台 x86 PC：操作系统 win XP 及以上版本
2、 2 条 usb 转串口线（PC 需安装串口驱动，可识别串口设备）
3、 至少 2 个 3121N-H 模组

2.2 软件准备
1、 3131N-H 模组固件烧录
选择一个模组烧录 CCO 固件，其他模组烧录 STA 固件，烧录方法参考固件烧录章节，
固件版本可联系 Fn-Link FAE 获取
2、 透传固件测试，需将 CCO 和 STA 模组的 UART0 分别连接到 PC 串口；
3、 协议固件测试，只需连接 CCO 串口 UART0。
4、 串口配置：波特率 115200，数据位 8 ，停止位 1， 偶校验 Even，无流控
5、 PLC_Module_Debuger.exe 模组功能评估工具（PC 端软件）
6、 HiAssistant.exe 模组诊断工具（PC 端软件）

2.3 测试拓扑

STA PC
PC CCO

?、 STA PC
Uart
PLC

3.测试评估方法
3.1 HiAssistant 工具（PC 串口连接 CCO 串口 UART1）
1、 连接 CCO
（1） 串口如下图连接

FN-LINK TECHNOLOGY LIMITED 3 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

（2） 打开 HiAssistant 软件，按下图操作，选择正确的串口号:

（3） 如下图显示，表示 CCO 连接成功。

FN-LINK TECHNOLOGY LIMITED 4 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

2、 查看网络拓扑信息
在右側窗口空白处右键菜单点击刷新，可获取最新的拓扑信息。如下图显示：

2、全网命令收发

支持以下全网命令：

FN-LINK TECHNOLOGY LIMITED 5 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

7、 固件升级
升级固件文件名命名规则：
xxx_cco.hupg 為 CCO 设备升级固件，xxx_sta.hupg 為 STA 设备升级固件。
（1） 全网升级（所有 STA）

显示如下图信息表示升级成功

（2） 单点升级（连接的 CCO）

FN-LINK TECHNOLOGY LIMITED 6 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

显示如下信息表示升级成功：

8、 白名单管理
设置 CCO 设备的白名单参数，不在 CCO 白名单中的 STA 将不被 CCO 发现。

FN-LINK TECHNOLOGY LIMITED 7 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

白名单配置文件格式如下：

9、 全网写 NV
NV 是 CCO 和 STA 设备参数，可以根据需要修改相应设备的参数。
NV 不可随意修改，修改前請咨询 Fn-Link FAE，以免造成设备异常问题。
MAC 地址参数 NVID 為 0x3,修改 MAC 地址操作如下图：

FN-LINK TECHNOLOGY LIMITED 8 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

10、 性能测试

3.2 PLC_Module_Debuger 工具（PC 串口连接 CCO 串口 UART0）

该工具是基于《Hi3921V100 模组接口协议.pdf》开发的 PC Demo 程序，必须配合支持该协议
的 CCO 和 STA 设备使用。
1、 连接 CCO
（1） 串口如下图连接
（2） 工具选择正确的串口号，点击打开串口，若有以下信息打印，表示 CCO 连接成功。

FN-LINK TECHNOLOGY LIMITED 9 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

2、 固件升级
（1） 单点升级

（2） 全网升级

FN-LINK TECHNOLOGY LIMITED 10 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

3、 模组本地测试命令
（1） 获取版本信息
get_version

（2） 获取 MAC 地址
get_mac

（3） 获取通信地址
get_dev

（4） 设置通信地址
set_dev 01:03:11:34:5f:fe

FN-LINK TECHNOLOGY LIMITED 11 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南
参数：通信MAC地址

（5） 重启设备
reboot 5
参数：<delay time>[0-255]S

（6） 获取拓扑信息（仅 CCO 支持）

get_topoinfo 1 10
参数：<start seq>[1-200] <req cnt>[1-200]

4、 吞吐测试命令
utx_t 10:00:c0:a8:01:02 480 10
参数：<dst mac> <payload size>[1-2000]Byte <Tx count>[1-65535]

5、 GPIO 测试
set_gpio 01:03:11:34:5f:fd 2 1
参数：<sta's address> <PIN num>[2|3|4|6] <low|hige>[0|1]
get_gpio 01:03:11:34:5f:fd 2

参数：<sta's address> <PIN num>[2|3|4|6]

6、 PWM 测试
set_pwm 01:03:11:34:5f:fd 50 100

参数：<sta's address> <duty>[0-100]% <freq>[1-200]khz

get_pwm 01:03:11:34:5f:fd

FN-LINK TECHNOLOGY LIMITED 12 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南

4．软件开发指南
4.1 固件开发
固件版本暂时由 Fn-Link 定制开发，当前可支持透传固件和协议固件两个版本。
4.2 CCO 网关或上位机开发
可参考 Hi3921V100 模组接口协议.pdf》文档以及 PLC_Module_Debuger 工具 Demo 源码进行
移植开发。
源码结构：

5．固件烧录
5.1 烧录
hiBurn 通过 UART1 烧录固件。首次空片烧录和需更新 flashboot+应用+NV 采用该方式。

FN-LINK TECHNOLOGY LIMITED 13 Proprietary & Confidential Information

 Fn-Link 3121N-H 软件开发指南
（1） 空片时选 RomBoot 更新固件时选 flashBoot
（2） 文件选择 hbin 类型固件
（3） 命令框输入 burn 2000000 0 7f000 点击发送
（4） 点击传输文件

5.2 升级固件
升级仅更新应用部分，flashboot 和 NV 无法升级更新
（1）HiAssitant 通过 UART1 升级固件，详见上面 HiAssistant 章节。
（2）PLC_Module_Debuger 通过 UART0 升级固件，详见 PLC_Module_Debuger 章节

FN-LINK TECHNOLOGY LIMITED 14 Proprietary & Confidential Information