新闻中心
PRESS CENTER
此文档说明适用于EC300的系列型号：EC300 EC301 EC300P
SSH工具
推荐使用MobaXterm，或者选择自己习惯的SSH工具：
https://iotrouter.yuque.com/attachments/yuque/0/2025/zip/40387797/1754703569965-ba0cea7a-8665-4508-8af2-8c1a8b3d4802.zip
串口调试工具
推荐使用XCOM，或者选择自己习惯的串口调试工具：
https://iotrouter.yuque.com/attachments/yuque/0/2025/zip/40387797/1754703569938-1c53c14b-674c-4d35-b7c6-fd2c84c327d6.zip
硬件工具
常用的辅助调试工具有：CAN转USB工具 / RS485转USB工具 / RS232转USB工具等。请自行准备！
交叉编译工具链
https://iotrouter.yuque.com/attachments/yuque/0/2025/zip/40387797/1754705046416-ca53f38d-2fd6-427e-9c5c-9958ca1fd531.zip
软件环境
软件 | 版本 |
OS | 嵌入式Linux 20.04.6；部分裁剪 |
Nodejs | v22.17.0 |
Python | python3.8 |
Shell | bash |
GLIBC | GLIBC_2.31 |
Docker | V26.1.3 |
QT库 | V5.15.10 |
桌面环境 | Xfce4 |
设备资源
类目 | 详情 | 备注 |
存储 | 共16G | 出厂开机剩余≈9G; |
内存 | 2G | 出厂开机剩余≈1.4G |
CPU | 4*Cortex-A53@1.8GHz | 出厂开机剩余≈98% |
NPU | 1TPOS | 出厂开机剩余≈100% |
1. Debug口
EC300产品系列将系统调试串口引出为 Type-C 形态；
默认登录名：root
默认密码：详见开放系统权限说明（https://iotrouter.yuque.com/zn3vdn/ec/hdsb71i79vmfr8wd#RUp2p）
2. 串口
硬件接口 | 设备文件 | EC300 | EC300P | EC301 |
RS485-1 | /dev/ttyS7 | ✔️ | ✔️ | ✔️ |
RS485-2 | /dev/ttyS2 | ❌ | ❌ | ✔️ |
RS232 | /dev/ttyS3 | ❌ | ❌ | ✔️ |
注：RS485为硬件自收发，用户不需要关心收发切换，硬件会自动处理
2.1. 快速测试
使用minicom工具测试，具体使用方法可以百度或者咨询DeepSeek
2.2. C代码测试样例
编译： gcc uart_example.c -o uart_example
RS485-1测试运行:./uart_example/dev/ttyS7
2.3. Python代码测试样例
首先安装依赖库：pip install pyserial
RS485-1测试运行：python uart_example.py /dev/ttyS7
3. LED
EC300产品系列 总共6个指示灯，其中4个可用户编程控制
硬件接口 | IO索引 | IO编号 | chip组 | 备注 |
POW | / | / | / | 电源指示灯 |
RUN | 50 | GPIO1_C2 | gpiochip1 | 内部程序占用；运行后呈闪烁状态 |
LED1 | 137 | GPIO4_B1 | gpiochip4 | 用户可编程 |
LED2 | 51 | GPIO1_C3 | gpiochip1 | 用户可编程 |
LED3 | 143 | GPIO4_B7 | gpiochip4 | 用户可编程 |
LED4 | 52 | GPIO1_C4 | gpiochip1 | 用户可编程 |
注：IO索引是由IO编号计算得出
3.1. 快速测试
测试运行：bashled_example.sh137
3.2. C代码测试样例
编译：gcc led_example.c -o led_example
测试运行:./led_example
3.3. Python代码测试样例
测试运行:python led_example.py
4. CAN
EC301 有两路CAN接口
硬件接口 | 网络接口 |
CAN1 [H1 L1] | can0 |
CAN2 [H2 L2] | can1 |
4.1. 快速测试
将can1和can2互接；命令行测试
4.2. C代码测试样例
编译： gcc can_example.c -o can_example
测试运行:./can_example
4.3. Python代码测试样例
首先安装依赖库：pip install python-can
测试运行:python can_example.py
5. DI
EC301 有两路DI接口；检测范围：5-28V
硬件接口 | IO索引 | IO编号 | chip组 |
DI-1 | 19 | GPIO0_C3 | gpiochip0 |
DI-2 | 21 | GPIO0_C5 | gpiochip0 |
5.1. 快速测试
测试运行：bashdi_example.sh19
测试将12V电源正极接入DI1，负极接入COM1；12V通电情况下打印0 ;不通电的情况下打印1；接线方式详见：
5.2. C代码测试样例
编译： gcc di_example.c -o di_example
测试运行:./di_example
6. DO
EC301 有两路DO接口，支持5A/DC12~24V输出
硬件接口 | IO索引 | IO编号 | chip组 |
DO-1 | 20 | GPIO0_C4 | gpiochip0 |
DO-2 | 18 | GPIO0_C2 | gpiochip0 |
6.1. 快速测试
测试运行：bashdo_example.sh 20
测试将外部负载（比如led灯）正极接入COM1，负极接入DO1；测试程序运行后led灯会间隔亮灭；接线方式详见：
此处为语雀内容卡片，点击链接查看：https://iotrouter.yuque.com/zn3vdn/ec/anu8k7gd9rsnnyn8?inner=ff2zY
6.2. C代码测试样例
编译： gcc do_example.c -o do_example
测试运行:./do_example
6.3. Python代码测试样例
测试运行：python do_example.py
7. 按键
EC300产品系列-按键：内部程序管理，用户不可编程，用于重启或者复位设备的web网页相关配置
硬件接口 | IO索引 | IO编号 | chip组 | 备注 |
按键 | 0 | GPIO0_A0 | gpiochip0 | 默认为系统的复位重启按键 |
重启：按下1s抬起
复位+重启：按下>5s
8. 硬件看门狗
EC300产品系列均默认启用硬件看门狗，由内部程序管理喂狗
硬件接口 | IO索引 | IO编号 | chip组 | 备注 |
使能控制 | 113 | GPIO3_C1 | gpiochip3 | 高：启用；低：关闭 |
喂狗IO | 8 | GPIO0_B0 | gpiochip0 |
|
建议喂狗周期：<30s
注：如果停止内部程序，必须自行接管看门狗喂狗服务，否则设备会定期重启
9. 网口
网口分为WAN+LAN口，由内部网络程序管理；需在web网页配置，详情请见：
此处为语雀内容卡片，点击链接查看：https://iotrouter.yuque.com/zn3vdn/ec/go5fnig7b5xumq79?singleDoc#%20《快速上手》
10. 蜂窝无线
EC300产品系列支持4G/5G通信（5G通信需要购买5G版本，详情请咨询客服）；模组的识别+拨号由内部程序管理，用户无需关心。
11. WIFI
EC300产品系列支持wifi热点和wifi客户端；支持2.4GHz/5GHz频段；wifi由内部程序管理，用户无需关心。
12. 蓝牙
EC300产品系列支持蓝牙功能
12.1. 快速测试
# 进入shell蓝牙交互模式 bluetoothctl
# 在交互模式中执行以下命令： # 查看蓝牙控制器（适配器）状态 show
# 若适配器未启用，开启它 power on
# 开启可发现模式（允许其他设备发现本机） discoverable on
# 开启配对模式 pairable on
# 开始扫描（持续扫描，按 Ctrl+C 停止） scan on
#以配对一个蓝牙设备（如耳机，MAC 地址为 AA:BB:CC:DD:EE:FF）为例： # 在 bluetoothctl 中执行 # 配对设备 pair AA:BB:CC:DD:EE:FF
# 信任设备（可选，避免后续重复验证） trust AA:BB:CC:DD:EE:FF
# 连接设备 connect AA:BB:CC:DD:EE:FF
# 若配对需要 PIN 码，按提示输入（通常是 0000 或 1234，或设备说明书中的密码）。 # 连接成功后，可通过 info AA:BB:CC:DD:EE:FF 查看设备详情。 info AA:BB:CC:DD:EE:FF |
13. 音频
EC300产品系列支持3.5mm耳麦插座
13.1. 快速测试
将3.5mm耳机或者音响设备接入设备HP接口；创建脚本文件如下：
#!/bin/bash
#设置播放设备为 HP（HEADPHONE OUT） amixer -c 0 cset name='Playback Path' 'HP'
#设置播放音量为 200，范围为 0~255 amixer -c 0 cset name='Playback Volume' 200
#播放示例音频文件 aplay /run/media/mmcblk0p9/iotrouter.wav |
测试运行：bash hp_example.sh
14. 显示
硬件接口 | 分辨率 | EC300 | EC300P | EC301 |
HDMI | 1920x1080 | ✔️ | ❌ | ✔️ |
LVDS | 1280x800 | ❌ | ✔️ | ❌ |
14.1. LVDS屏幕
支持背光亮度调节，调节范围【0-255】：
echo 128 > /sys/class/backlight/backlight/brightness echo 255 > /sys/class/backlight/backlight/brightness |
控制屏幕显示：
#控制屏幕关： echo off > /sys/class/drm/card0-LVDS-1/status
#控制屏幕开： echo on > /sys/class/drm/card0-LVDS-1/status |
1. 获取设备基础信息
URL：GET http://{设备IP}/rpc-api/data/devinfo Method：GET 请求参数：无 |
响应数据说明：
字段 | 字段名称 | 数据类型 | 说明 |
code | 响应状态码 | int | 固定返回 200，标识请求成功 |
data.model | 设备型号 | string | 设备型号 |
data.sn | 设备序列号 | string | 设备序列号 |
data.version | 设备版本 | string | 设备软件版本号 |
响应示例：
{ "code": 200, "data": { "model": "EC100", "sn": "4310AA01C8AA2B6B", "version": "3802" } } |
2. 获取设备WWAN网络信息
URL：GET http://{设备IP}/rpc-api/data/wwaninfo Method：GET 请求参数：无 |
响应数据说明：
字段 | 字段名称 | 数据类型 | 说明 |
code | 响应状态码 | int | 固定返回 200，标识请求成功 |
data.ip | 4G IP | string | 4G获取到的IP地址 |
data.mask | 子网掩码 | string | 网络子网掩码 |
data.dns | DNS 服务IP | string | DNS 解析服务器地址 |
data.signal | 信号强度 | int | 4G信号强度 |
data.ccid | SIM卡号 | string | SIM卡卡号 |
data.imei | IMEI | string | 设备4G模组IMEI |
data.netInfo | 网络类型 | string | 当前网络类型 |
data.apn.addr | APN 地址 | string | 接入点名称地址 |
data.apn.username | APN 用户名 | string | PN 认证用户名 |
data.apn.password | APN 密码 | string | APN 认证密码 |
响应示例：
{ "code": 200, "data": { "ip": "37.64.21.99", "mask": "255.255.255.255", "dns": "224.134.125.33", "signal": 90, "ccid": "89860480192470076526", "imei": "862701080346307", "netInfo": "LTE", "apn": { "addr": "", "username": "", "password": "" } } } |
1. 内部管理程序
EC300产品系列为了简化用户使用，内置管理程序iotrouter开机自启动。管理程序包括但不限于下列功能：
设备初始化
网络管理
看门狗
按键监听
防火墙
设备配置服务（默认80端口，监听端口可更改；文件：/usr/local/src/iotrouter/web/user-config.js）
用户文件浏览功能（默认/home路径；路径可更改；文件：/usr/local/src/iotrouter/web/user-config.js）
注：内部程序必须保活，否则会造成设备开机运行异常。如果用户一定需要关闭内部管理程序，必须自行接管上述管理程序服务。
2. NeuronEX
EC300产品系列均内置NeuronEX-Lite，服务开机自启动，监听端口8085；介绍详见:https://iotrouter.yuque.com/zn3vdn/ec/hdsb71i79vmfr8wd?singleDoc#%20%E3%80%8A%E5%AD%A6%E4%B9%A0%E8%B7%AF%E7%BA%BF%E3%80%8B
查看服务状态：systemctl status neuronex
重启服务：systemctl restart neuronex
停止服务：systemctl stop neuronex
关闭服务自启：systemctl disable neuronex
3. Node-Red
EC300产品系列均内置Node-Red，服务开机自启动，监听端口1880。
查看服务状态：systemctl status node-red
重启服务：systemctl restart node-red
停止服务：systemctl stop node-red
关闭服务自启：systemctl disable node-red
4. FUXA
EC300产品系列均内置fuxa，服务开机自启动，监听端口1881。
查看服务状态：systemctl status fuxa
重启服务：systemctl restart fuxa
停止服务：systemctl stop fuxa
关闭服务自启：systemctl disable fuxa
5. Xfce4桌面
默认的桌面为xfce4；这只是个示例；用户如果需要显示其他内容，比如QT界面可以自行开发；
桌面显示管理器为：lightdm
查看服务状态：systemctl status lightdm
重启服务：systemctl restart lightdm
停止服务：systemctl stop lightdm
关闭服务自启：systemctl disable lightdm
6. 用户自开发程序
用户程序由用户自由开发，用户程序独立运行，但须注意内存和空间管理避免导致系统异常。软件可加入系统自启动方式：
/etc/rc.local
systemd服务
/etc/init.d系统
我司也提供软件开发定制服务；如有需求请咨询销售人员
7. 开机LOGO
用户可以自行替换系统开机LOGO；
logo名称 | 显示阶段 |
logo.bmp | 用于 U-Boot 启动阶段显示 |
logo_kernel.bmp | 用于内核启动阶段显示 |
7.1. 格式要求
LOGO 图片要求为 BMP 格式的 24 位位图，并且图片分辨率建议不超过 HDMI 等显示器分辨率。
7.2. LOGO替换
设备上电启动，将制作好的 logo.bmp、logo_kernel.bmp 文件拷贝至评估板根文件系统"boot/"目录下，替换目录下原有的logo.bmp、logo_kernel.bmp 文件。
注：logo文件的名称不能更改
什么时候会使用到镜像烧录：用户在使用设备时，可能因误删系统核心文件、错误修改系统配置参数（如注册表关键项），或误执行格式化系统分区等操作，导致系统无法启动、功能异常。此时烧录对应设备的系统出厂镜像，能快速将系统恢复到初始正常状态。
1. 烧录工具
工具链接: https://pan.baidu.com/s/1LOn3jlVs3rOQmYHo1VbWhw?pwd=gncp 提取码: gncp
Driver：驱动
tool：烧录工具
zh_xxxx_v3xxx.img：出厂镜像
USB公对公转换线
2. 驱动安装
安装DriverDriverInstall.exe
3. 烧录
打开 oolRKDevTool.exe
点击Upgrade Firmware跳转到烧录界面
点击Firmware选择镜像
按住Boot按钮给EC300上电
烧录下方会出现Found One MASKROM Device表示已经识别到设备
点击Upgrade开始烧录，右侧日志窗口出现烧录日志
最后一行出现Success表示烧录成功
原文细看：EC300开发指南
打造开箱即用的物联网平台
