打造開箱即用的物聯(lián)網(wǎng)平臺(tái)
售前咨詢-楊: 19381903226
售前咨詢-楊: 19381903226
新聞中心
PRESS CENTER
此文檔說明適用于EC300的系列型號(hào)：EC300 EC301 EC300P
SSH工具
推薦使用MobaXterm，或者選擇自己習(xí)慣的SSH工具：
https://iotrouter.yuque.com/attachments/yuque/0/2025/zip/40387797/1754703569965-ba0cea7a-8665-4508-8af2-8c1a8b3d4802.zip
串口調(diào)試工具
推薦使用XCOM，或者選擇自己習(xí)慣的串口調(diào)試工具：
https://iotrouter.yuque.com/attachments/yuque/0/2025/zip/40387797/1754703569938-1c53c14b-674c-4d35-b7c6-fd2c84c327d6.zip
硬件工具
常用的輔助調(diào)試工具有：CAN轉(zhuǎn)USB工具 / RS485轉(zhuǎn)USB工具 / RS232轉(zhuǎn)USB工具等。請(qǐng)自行準(zhǔn)備！
交叉編譯工具鏈
https://iotrouter.yuque.com/attachments/yuque/0/2025/zip/40387797/1754705046416-ca53f38d-2fd6-427e-9c5c-9958ca1fd531.zip
軟件環(huán)境
軟件 | 版本 |
OS | 嵌入式Linux 20.04.6；部分裁剪 |
Nodejs | v22.17.0 |
Python | python3.8 |
Shell | bash |
GLIBC | GLIBC_2.31 |
Docker | V26.1.3 |
QT庫(kù) | V5.15.10 |
桌面環(huán)境 | Xfce4 |
設(shè)備資源
類目 | 詳情 | 備注 |
存儲(chǔ) | 共16G | 出廠開機(jī)剩余≈9G; |
內(nèi)存 | 2G | 出廠開機(jī)剩余≈1.4G |
CPU | 4*Cortex-A53@1.8GHz | 出廠開機(jī)剩余≈98% |
NPU | 1TPOS | 出廠開機(jī)剩余≈100% |
1. Debug口
EC300產(chǎn)品系列將系統(tǒng)調(diào)試串口引出為 Type-C 形態(tài)；
默認(rèn)登錄名：root
默認(rèn)密碼：詳見開放系統(tǒng)權(quán)限說明（https://iotrouter.yuque.com/zn3vdn/ec/hdsb71i79vmfr8wd#RUp2p）
2. 串口
硬件接口 | 設(shè)備文件 | EC300 | EC300P | EC301 |
RS485-1 | /dev/ttyS7 | ?? | ?? | ?? |
RS485-2 | /dev/ttyS2 | ? | ? | ?? |
RS232 | /dev/ttyS3 | ? | ? | ?? |
注：RS485為硬件自收發(fā)，用戶不需要關(guān)心收發(fā)切換，硬件會(huì)自動(dòng)處理
2.1. 快速測(cè)試
使用minicom工具測(cè)試，具體使用方法可以百度或者咨詢DeepSeek
2.2. C代碼測(cè)試樣例
編譯： gcc uart_example.c -o uart_example
RS485-1測(cè)試運(yùn)行:./uart_example/dev/ttyS7
2.3. Python代碼測(cè)試樣例
首先安裝依賴庫(kù)：pip install pyserial
RS485-1測(cè)試運(yùn)行：python uart_example.py /dev/ttyS7
3. LED
EC300產(chǎn)品系列 總共6個(gè)指示燈，其中4個(gè)可用戶編程控制
硬件接口 | IO索引 | IO編號(hào) | chip組 | 備注 |
POW | / | / | / | 電源指示燈 |
RUN | 50 | GPIO1_C2 | gpiochip1 | 內(nèi)部程序占用；運(yùn)行后呈閃爍狀態(tài) |
LED1 | 137 | GPIO4_B1 | gpiochip4 | 用戶可編程 |
LED2 | 51 | GPIO1_C3 | gpiochip1 | 用戶可編程 |
LED3 | 143 | GPIO4_B7 | gpiochip4 | 用戶可編程 |
LED4 | 52 | GPIO1_C4 | gpiochip1 | 用戶可編程 |
注：IO索引是由IO編號(hào)計(jì)算得出
3.1. 快速測(cè)試
測(cè)試運(yùn)行：bashled_example.sh137
3.2. C代碼測(cè)試樣例
編譯：gcc led_example.c -o led_example
測(cè)試運(yùn)行:./led_example
3.3. Python代碼測(cè)試樣例
測(cè)試運(yùn)行:python led_example.py
4. CAN
EC301 有兩路CAN接口
硬件接口 | 網(wǎng)絡(luò)接口 |
CAN1 [H1 L1] | can0 |
CAN2 [H2 L2] | can1 |
4.1. 快速測(cè)試
將can1和can2互接；命令行測(cè)試
4.2. C代碼測(cè)試樣例
編譯： gcc can_example.c -o can_example
測(cè)試運(yùn)行:./can_example
4.3. Python代碼測(cè)試樣例
首先安裝依賴庫(kù)：pip install python-can
測(cè)試運(yùn)行:python can_example.py
5. DI
EC301 有兩路DI接口；檢測(cè)范圍：5-28V
硬件接口 | IO索引 | IO編號(hào) | chip組 |
DI-1 | 19 | GPIO0_C3 | gpiochip0 |
DI-2 | 21 | GPIO0_C5 | gpiochip0 |
5.1. 快速測(cè)試
測(cè)試運(yùn)行：bashdi_example.sh19
測(cè)試將12V電源正極接入DI1，負(fù)極接入COM1；12V通電情況下打印0 ;不通電的情況下打印1；接線方式詳見：
5.2. C代碼測(cè)試樣例
編譯： gcc di_example.c -o di_example
測(cè)試運(yùn)行:./di_example
6. DO
EC301 有兩路DO接口，支持5A/DC12~24V輸出
硬件接口 | IO索引 | IO編號(hào) | chip組 |
DO-1 | 20 | GPIO0_C4 | gpiochip0 |
DO-2 | 18 | GPIO0_C2 | gpiochip0 |
6.1. 快速測(cè)試
測(cè)試運(yùn)行：bashdo_example.sh 20
測(cè)試將外部負(fù)載（比如led燈）正極接入COM1，負(fù)極接入DO1；測(cè)試程序運(yùn)行后led燈會(huì)間隔亮滅；接線方式詳見：
此處為語雀內(nèi)容卡片，點(diǎn)擊鏈接查看：https://iotrouter.yuque.com/zn3vdn/ec/anu8k7gd9rsnnyn8?inner=ff2zY
6.2. C代碼測(cè)試樣例
編譯： gcc do_example.c -o do_example
測(cè)試運(yùn)行:./do_example
6.3. Python代碼測(cè)試樣例
測(cè)試運(yùn)行：python do_example.py
7. 按鍵
EC300產(chǎn)品系列-按鍵：內(nèi)部程序管理，用戶不可編程，用于重啟或者復(fù)位設(shè)備的web網(wǎng)頁(yè)相關(guān)配置
硬件接口 | IO索引 | IO編號(hào) | chip組 | 備注 |
按鍵 | 0 | GPIO0_A0 | gpiochip0 | 默認(rèn)為系統(tǒng)的復(fù)位重啟按鍵 |
重啟：按下1s抬起
復(fù)位+重啟：按下>5s
8. 硬件看門狗
EC300產(chǎn)品系列均默認(rèn)啟用硬件看門狗，由內(nèi)部程序管理喂狗
硬件接口 | IO索引 | IO編號(hào) | chip組 | 備注 |
使能控制 | 113 | GPIO3_C1 | gpiochip3 | 高：?jiǎn)⒂?；低：關(guān)閉 |
喂狗IO | 8 | GPIO0_B0 | gpiochip0 |
|
建議喂狗周期：<30s
注：如果停止內(nèi)部程序，必須自行接管看門狗喂狗服務(wù)，否則設(shè)備會(huì)定期重啟
9. 網(wǎng)口
網(wǎng)口分為WAN+LAN口，由內(nèi)部網(wǎng)絡(luò)程序管理；需在web網(wǎng)頁(yè)配置，詳情請(qǐng)見：
此處為語雀內(nèi)容卡片，點(diǎn)擊鏈接查看：https://iotrouter.yuque.com/zn3vdn/ec/go5fnig7b5xumq79?singleDoc#%20《快速上手》
10. 蜂窩無線
EC300產(chǎn)品系列支持4G/5G通信（5G通信需要購(gòu)買5G版本，詳情請(qǐng)咨詢客服）；模組的識(shí)別+撥號(hào)由內(nèi)部程序管理，用戶無需關(guān)心。
11. WIFI
EC300產(chǎn)品系列支持wifi熱點(diǎn)和wifi客戶端；支持2.4GHz/5GHz頻段；wifi由內(nèi)部程序管理，用戶無需關(guān)心。
12. 藍(lán)牙
EC300產(chǎn)品系列支持藍(lán)牙功能
12.1. 快速測(cè)試
# 進(jìn)入shell藍(lán)牙交互模式 bluetoothctl
# 在交互模式中執(zhí)行以下命令： # 查看藍(lán)牙控制器（適配器）狀態(tài) show
# 若適配器未啟用，開啟它 power on
# 開啟可發(fā)現(xiàn)模式（允許其他設(shè)備發(fā)現(xiàn)本機(jī)） discoverable on
# 開啟配對(duì)模式 pairable on
# 開始掃描（持續(xù)掃描，按 Ctrl+C 停止） scan on
#以配對(duì)一個(gè)藍(lán)牙設(shè)備（如耳機(jī)，MAC 地址為 AA:BB:CC:DD:EE:FF）為例： # 在 bluetoothctl 中執(zhí)行 # 配對(duì)設(shè)備 pair AA:BB:CC:DD:EE:FF
# 信任設(shè)備（可選，避免后續(xù)重復(fù)驗(yàn)證） trust AA:BB:CC:DD:EE:FF
# 連接設(shè)備 connect AA:BB:CC:DD:EE:FF
# 若配對(duì)需要 PIN 碼，按提示輸入（通常是 0000 或 1234，或設(shè)備說明書中的密碼）。 # 連接成功后，可通過 info AA:BB:CC:DD:EE:FF 查看設(shè)備詳情。 info AA:BB:CC:DD:EE:FF |
13. 音頻
EC300產(chǎn)品系列支持3.5mm耳麥插座
13.1. 快速測(cè)試
將3.5mm耳機(jī)或者音響設(shè)備接入設(shè)備HP接口；創(chuàng)建腳本文件如下：
#!/bin/bash
#設(shè)置播放設(shè)備為 HP（HEADPHONE OUT） amixer -c 0 cset name='Playback Path' 'HP'
#設(shè)置播放音量為 200，范圍為 0~255 amixer -c 0 cset name='Playback Volume' 200
#播放示例音頻文件 aplay /run/media/mmcblk0p9/iotrouter.wav |
測(cè)試運(yùn)行：bash hp_example.sh
14. 顯示
硬件接口 | 分辨率 | EC300 | EC300P | EC301 |
HDMI | 1920x1080 | ?? | ? | ?? |
LVDS | 1280x800 | ? | ?? | ? |
14.1. LVDS屏幕
支持背光亮度調(diào)節(jié)，調(diào)節(jié)范圍【0-255】：
echo 128 > /sys/class/backlight/backlight/brightness echo 255 > /sys/class/backlight/backlight/brightness |
控制屏幕顯示：
#控制屏幕關(guān)： echo off > /sys/class/drm/card0-LVDS-1/status
#控制屏幕開： echo on > /sys/class/drm/card0-LVDS-1/status |
1. 獲取設(shè)備基礎(chǔ)信息
URL：GET http://{設(shè)備IP}/rpc-api/data/devinfo Method：GET 請(qǐng)求參數(shù)：無 |
響應(yīng)數(shù)據(jù)說明：
字段 | 字段名稱 | 數(shù)據(jù)類型 | 說明 |
code | 響應(yīng)狀態(tài)碼 | int | 固定返回 200，標(biāo)識(shí)請(qǐng)求成功 |
data.model | 設(shè)備型號(hào) | string | 設(shè)備型號(hào) |
data.sn | 設(shè)備序列號(hào) | string | 設(shè)備序列號(hào) |
data.version | 設(shè)備版本 | string | 設(shè)備軟件版本號(hào) |
響應(yīng)示例：
{ "code": 200, "data": { "model": "EC100", "sn": "4310AA01C8AA2B6B", "version": "3802" } } |
2. 獲取設(shè)備WWAN網(wǎng)絡(luò)信息
URL：GET http://{設(shè)備IP}/rpc-api/data/wwaninfo Method：GET 請(qǐng)求參數(shù)：無 |
響應(yīng)數(shù)據(jù)說明：
字段 | 字段名稱 | 數(shù)據(jù)類型 | 說明 |
code | 響應(yīng)狀態(tài)碼 | int | 固定返回 200，標(biāo)識(shí)請(qǐng)求成功 |
data.ip | 4G IP | string | 4G獲取到的IP地址 |
data.mask | 子網(wǎng)掩碼 | string | 網(wǎng)絡(luò)子網(wǎng)掩碼 |
data.dns | DNS 服務(wù)IP | string | DNS 解析服務(wù)器地址 |
data.signal | 信號(hào)強(qiáng)度 | int | 4G信號(hào)強(qiáng)度 |
data.ccid | SIM卡號(hào) | string | SIM卡卡號(hào) |
data.imei | IMEI | string | 設(shè)備4G模組IMEI |
data.netInfo | 網(wǎng)絡(luò)類型 | string | 當(dāng)前網(wǎng)絡(luò)類型 |
data.apn.addr | APN 地址 | string | 接入點(diǎn)名稱地址 |
data.apn.username | APN 用戶名 | string | PN 認(rèn)證用戶名 |
data.apn.password | APN 密碼 | string | APN 認(rèn)證密碼 |
響應(yīng)示例：
{ "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. 內(nèi)部管理程序
EC300產(chǎn)品系列為了簡(jiǎn)化用戶使用，內(nèi)置管理程序iotrouter開機(jī)自啟動(dòng)。管理程序包括但不限于下列功能：
設(shè)備初始化
網(wǎng)絡(luò)管理
看門狗
按鍵監(jiān)聽
防火墻
設(shè)備配置服務(wù)（默認(rèn)80端口，監(jiān)聽端口可更改；文件：/usr/local/src/iotrouter/web/user-config.js）
用戶文件瀏覽功能（默認(rèn)/home路徑；路徑可更改；文件：/usr/local/src/iotrouter/web/user-config.js）
注：內(nèi)部程序必須?；?，否則會(huì)造成設(shè)備開機(jī)運(yùn)行異常。如果用戶一定需要關(guān)閉內(nèi)部管理程序，必須自行接管上述管理程序服務(wù)。
2. NeuronEX
EC300產(chǎn)品系列均內(nèi)置NeuronEX-Lite，服務(wù)開機(jī)自啟動(dòng)，監(jiān)聽端口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
查看服務(wù)狀態(tài)：systemctl status neuronex
重啟服務(wù)：systemctl restart neuronex
停止服務(wù)：systemctl stop neuronex
關(guān)閉服務(wù)自啟：systemctl disable neuronex
3. Node-Red
EC300產(chǎn)品系列均內(nèi)置Node-Red，服務(wù)開機(jī)自啟動(dòng)，監(jiān)聽端口1880。
查看服務(wù)狀態(tài)：systemctl status node-red
重啟服務(wù)：systemctl restart node-red
停止服務(wù)：systemctl stop node-red
關(guān)閉服務(wù)自啟：systemctl disable node-red
4. FUXA
EC300產(chǎn)品系列均內(nèi)置fuxa，服務(wù)開機(jī)自啟動(dòng)，監(jiān)聽端口1881。
查看服務(wù)狀態(tài)：systemctl status fuxa
重啟服務(wù)：systemctl restart fuxa
停止服務(wù)：systemctl stop fuxa
關(guān)閉服務(wù)自啟：systemctl disable fuxa
5. Xfce4桌面
默認(rèn)的桌面為xfce4；這只是個(gè)示例；用戶如果需要顯示其他內(nèi)容，比如QT界面可以自行開發(fā)；
桌面顯示管理器為：lightdm
查看服務(wù)狀態(tài)：systemctl status lightdm
重啟服務(wù)：systemctl restart lightdm
停止服務(wù)：systemctl stop lightdm
關(guān)閉服務(wù)自啟：systemctl disable lightdm
6. 用戶自開發(fā)程序
用戶程序由用戶自由開發(fā)，用戶程序獨(dú)立運(yùn)行，但須注意內(nèi)存和空間管理避免導(dǎo)致系統(tǒng)異常。軟件可加入系統(tǒng)自啟動(dòng)方式：
/etc/rc.local
systemd服務(wù)
/etc/init.d系統(tǒng)
我司也提供軟件開發(fā)定制服務(wù)；如有需求請(qǐng)咨詢銷售人員
7. 開機(jī)LOGO
用戶可以自行替換系統(tǒng)開機(jī)LOGO；
logo名稱 | 顯示階段 |
logo.bmp | 用于 U-Boot 啟動(dòng)階段顯示 |
logo_kernel.bmp | 用于內(nèi)核啟動(dòng)階段顯示 |
7.1. 格式要求
LOGO 圖片要求為 BMP 格式的 24 位位圖，并且圖片分辨率建議不超過 HDMI 等顯示器分辨率。
7.2. LOGO替換
設(shè)備上電啟動(dòng)，將制作好的 logo.bmp、logo_kernel.bmp 文件拷貝至評(píng)估板根文件系統(tǒng)"boot/"目錄下，替換目錄下原有的logo.bmp、logo_kernel.bmp 文件。
注：logo文件的名稱不能更改
什么時(shí)候會(huì)使用到鏡像燒錄：用戶在使用設(shè)備時(shí)，可能因誤刪系統(tǒng)核心文件、錯(cuò)誤修改系統(tǒng)配置參數(shù)（如注冊(cè)表關(guān)鍵項(xiàng)），或誤執(zhí)行格式化系統(tǒng)分區(qū)等操作，導(dǎo)致系統(tǒng)無法啟動(dòng)、功能異常。此時(shí)燒錄對(duì)應(yīng)設(shè)備的系統(tǒng)出廠鏡像，能快速將系統(tǒng)恢復(fù)到初始正常狀態(tài)。
1. 燒錄工具
工具鏈接: https://pan.baidu.com/s/1LOn3jlVs3rOQmYHo1VbWhw?pwd=gncp 提取碼: gncp
Driver：驅(qū)動(dòng)
tool：燒錄工具
zh_xxxx_v3xxx.img：出廠鏡像
USB公對(duì)公轉(zhuǎn)換線
2. 驅(qū)動(dòng)安裝
安裝DriverDriverInstall.exe
3. 燒錄
打開 oolRKDevTool.exe
點(diǎn)擊Upgrade Firmware跳轉(zhuǎn)到燒錄界面
點(diǎn)擊Firmware選擇鏡像
按住Boot按鈕給EC300上電
燒錄下方會(huì)出現(xiàn)Found One MASKROM Device表示已經(jīng)識(shí)別到設(shè)備
點(diǎn)擊Upgrade開始燒錄，右側(cè)日志窗口出現(xiàn)燒錄日志
最后一行出現(xiàn)Success表示燒錄成功
原文細(xì)看：EC300開發(fā)指南
軌版-3.webp)
