UIMeter内置一个命令解释器,可以通过超级终端(或者Putty、SecrueCRT)等软件来连接。 连接以后可以通过串口使用UIMeter全部功能。使用串口命令之前,需要切换通讯协议到 TERM协议,切换方法请参考UIMeter用户手册。
串口参数如下所示:
波特率115200、8位数据、1位停止、无校验、无流控。
本文档基于UIMeter固件v20.1.10,其余固件版本仅供参考。
随着新固件发布,相关命令可能会有调整,恕不另行通知。
获取当前电压、电流、时间、功率、电量等信息。
命令格式:getui
命令输出如下所示:
getui
U: PGA=8 AD=0x00C132 4.9488V 0.0000W 96593uV
I: PGA=8 AD=0x000000 0.0000A 9999.9R 0uV
T: RAW=0x1A80 26.5C 813.5C
P: 0.0000Ah 0.0000Wh 319s
第三方工具可以使用该命令采集当前数据。
第三方软件可以通过执行该命令查询设备实时数据,可以关闭命令回显,降低第三方软件编写难度。
清除设备当前时间和电量信息。
命令格式:clear
。
设备上电以后,运行时间和Ah电量、Wh电量会一直累计,执行该命令以后,运行时间、Ah电量、Wh电量全部归零。 其余数据为实时更新,该命令无影响。
操作离线数据。
V3命令格式:log [dump|auto|ring|max|int|uh|ul|ih|il] Op.logs.
V4命令格式:log [dump|auto|append|uart|file|int|flush|uh|ul|ih|il] Op.logs.
不带参数的log命令输出当前设置,依次显示AUTO模式开关、RING模式开关、数据最大记录条数、记录间隔、 UH、UL、IH、IL四个参数。具体意义见以下子命令说明。
UIMeterV3
log
log [dump|auto|ring|max|int|uh|ul|ih|il] Op.logs.
AUTO=0 RING=0 MAX=4096 INT=1
UH= 0.0000V UL= 0.0000V
IH= 0.0000A IL= 0.0000A
UIMeterV4
log
log [dump|auto|append|uart|file|int|flush|uh|ul|ih|il] Op.logs.
AUTO=0 APPEND=0 UART=1 FILE=1 INT=1 FLUSH=100
UH= 0.0000V UL= 0.0000V
IH= 0.0000A IL= 0.0000A
log dump子命令用来导出离线数据。
命令格式:log dump [数据条数]
。
数据条数应该小于设备最大记录条数。导出10条数据如下:
log dump 10
i, t(s), U(V), I(A), Tself, Tprob
0, 11, 0.0001, 0.0000, 26.5, 26.5
1, 12, 0.0000, 0.0000, 26.5, 26.5
2, 13, 0.0001, 0.0000, 26.5, 26.5
3, 14, 0.0000, 0.0000, 26.5, 26.5
4, 15, 0.0000, 0.0000, 26.5, 26.5
5, 16, 0.0000, 0.0000, 26.5, 26.5
6, 17, 0.0000, 0.0000, 26.5, 26.5
7, 18, 0.0000, 0.0000, 26.5, 26.5
8, 19, 0.0000, 0.0000, 26.5, 26.5
9, 20, 0.0000, 0.0000, 26.5, 26.5
第一列为数据索引, 第二列为设备记录数据时的相对时间(单位秒), 第三列为电压(启用分流器测量功能以后为分流器电流), 第四列为电流, 第五列为冷端温度(环温), 第六列为探头温度(K型热电偶测温时有意义)
可以借助超级终端捕获文字功能保存离线数据。菜单:传送(T)->捕获文字(C)… 打开超级终端的捕获文字功能,启动捕获文字,执行完log dump命令,然后停止。 保存离线记录数据。
离线数据格式为CSV文件,可以使用Excel或者任意一款文本编辑器编辑。
v17.5.11固件开始增加分流器电流测量功能,启用分流器电流测量功能以后,原电压档记录数据为分流器电流。
V4版本log dump命令实际读取record.csv
文件的内容。
打开或者关闭AUTO模式。
默认情况下,数据离线记录功能需要用户来手动启动。如果用户需要同步采集某些量, 多台UIMeter之间很难完成同步启动采集, 因此可以打开AUTO模式,UIMeter上电以后 自动开始记录数据。通过给多台UIMeter同时上电来完成数据同步采集。
log auto 1
命令打开自动记录功能log auto 0
命令关闭自动记录功能。设置以后立即生效,保存参数需要执行param save
命令。
打开或者关闭RING模式。
默认模式下,记录数据达到最大以后停止记录,通过打开RING模式,可以使数据达到最大 以后自动从0开始记录,覆盖旧数据。该方法可以用于循环记录,跟踪最新的测试数据。
log ring 1
命令打开RING模式log ring 0
命令关闭RING模式。设置以后立即生效,保存参数需要执行param save
命令。
设置最大记录条数。
UIMeter具备2048和4096两种离线记录条数。可以使用log max命令设置最大记录数据。
log max 2
Set Max data log to 2048
log max 4
Set Max data log to 4096
最大记录条数需要和实际设备配置的EEPROM容量匹配,32kB对应2048条,64kB对应4096条。
log max 2
log max 4
设置以后立即生效,保存参数需要执行param save
命令。
UIMeterV4内置文件系统,不支持该命令。
设置离线记录间隔,单位秒,如:log int 10
,设置离线记录间隔为10秒每次。最大间隔65535秒。
设置以后立即生效,保存参数需要执行param save
命令。
设定UH、UL、IH、IL四个参数。
四个参数决定离线记录的条件。UH和UL设定电压上限和下限,IH和IL设定电流上限和下限。
记录规则如下:
注意,UH、UL、IH、IL为在原来手动记录基础上增加的四个条件,设置以后仍然需要手动 启停记录,如果不使用需要全部设置为0.
设置命令举例参考如下:
log uh 0
UH= 0.0000V
log ul 0
UL= 0.0000V
log ih 20000
IH= 2.0000A
log il 10000
IL= 1.0000A
log
log [dump|auto|ring|max|int|uh|ul|ih|il] Op.logs.
AUTO=0 RING=0 MAX=4096 INT=1
UH= 0.0000V UL= 0.0000V
IH= 2.0000A IL= 1.0000A
电流大于1A小于2A时记录离线数据:UH=UL=0V,IH=2A,IL=1A。
电压高于10V时记录离线数据:UH=0V,UL=10V,IH=0A,IL=0A。
设置以后立即生效,保存参数需要执行param save
命令。
打开或者关闭APPEND模式。
UIMeterV4内置文件系统,默认记录数据截断模式写入record.csv
文件,之前记录的数据将被丢弃。
打开APPEND模式以后,每次记录以追加模式写入record.csv
文件,保留之前的记录数据。APPEND
模式容易将存储空间写满,用户需要自行管理存储空间。
-使用log append 1
命令打开APPEND模式
-使用log append 0
命令关闭APPEND模式
设置以后立即生效,保存参数需要执行param save
命令。
UART开关控制离线记录数据是否发往串口,默认UART=0.
FILE开关控制离线记录数据是否写入record.csv
文件,默认FILE=1.
默认数据只写入record.csv
文件,不发往串口。用户可设置UART=1, FILE=1数据同时
发往串口和record.csv
文件。设置UART=1,FILE=0数据只发往串口。
log uart 1
命令打开UART开关log uart 0
命令关闭UART开关log file 1
命令打开FILE开关log file 0
命令关闭FILE开关设置以后立即生效,保存参数需要执行param save
命令。
控制内部文件系统数据刷新间隔。
内部文件系统使用缓存提高性能,合理设置数据刷新间隔可以避免掉电以后丢失数据,一般用户无需修改。
命令格式:log flush 100
设置以后立即生效,保存参数需要执行param save
”`命令。
操作用户参数。
命令格式:param [load|save|restore] Operate parameters.
param命令带三个子命令:load、save、restore。
param load
命令从内置EEPROM加载保存的参数。param save
命令将参数保存到内置EEPROM。param restore
命令恢复默认参数。同时按住左右键上电也可以恢复默认参数。
电压通道参数设置。
命令格式:uset [adj|zero|max|min|cali] [adj_D5|U_D4] set U param.
不带参数的uset命令输出当前电压通道和电流通道的所有参数。
uset
uset [adj|zero|max|min|cali] [adj_D5|U_D4] set U param.
Uadj= 1.00458 1.00239 1.00000 1.00000 2
Iadj= 0.99477 1.00000 1.00000 1.00000 0
Umax=20.0000V Umin= 0.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 0A Gain= 1.00000
设置电压增益校正系数。
电压增益校正系数是一个1附近的数值,用来校正分压电阻、基准初始值等带来的误差。 范围0-100,如果UIMeter显示电压数值小于实际电压值,需要增大电压增益校正系数, 反之减小电压增益校正系数。
使用uset adj命令将电压增益校正系数设置为1.00234,如下所示,设定数值需要扩大100000倍去掉小数点。
uset adj 100234
uset
uset [adj|zero|max|min|cali] [adj_D5|U_D4] set U param.
Uadj= 1.00234 1.00239 1.00000 1.00000 2
Iadj= 0.99477 1.00000 1.00000 1.00000 0
Umax=20.0000V Umin= 0.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 0A Gain= 1.00000
设置电压零偏校正系数。
如果电压通道在短接测量端时不为0,需要校正电压零偏。单位为一个电压分辨率。
如果电压显示0.0003V,使用uset zero 3
命令校正。
如果电压显示-0.0002V,使用uset zero -2
命令校正。
设置电压上限、电压下限。
UIMeter使用电压上限、电压下限控制输出MOS管和LED。测量电压高于下限并且低于下限 时打开输出MOS管熄灭LED;测量电压高于上限或者低于下限关闭输出MOS管点亮LED。
设置方法举例如下:
uset max 100000
uset min 20000
uset
uset [adj|zero|max|min|cali] [adj_D5|U_D4] set U param.
Uadj= 1.00458 1.00239 1.00000 1.00000 2
Iadj= 0.99477 1.00000 1.00000 1.00000 0
Umax=10.0000V Umin= 2.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 0A Gain= 1.00000
电压数值需要扩大10000倍去掉小数。
电压快速校准。
首先使用uset adj 100000
命令将电压增益系数设置为1.
将UIMeter电压通道与基准电压源并联,读取基准源电压值,执行命令 uset cali [基准电压值]
UIMeter自动计算校准系数,保证电压显示值与基准电压值相等,基准电压值需要扩大10000倍去掉小数。
设置以后立即生效,保存参数需要执行param save
命令。
电流通道参数设置。
命令格式:iset [adj|zero|cali|shunt|gain] [adj_D5|I_D4] set I param.
不带参数的iset命令输出当前电压通道和电流通道的所有参数。
iset
iset [adj|zero|cali|shunt|gain] [adj_D5|I_D4] set I param.
Uadj= 1.00458 1.00239 1.00000 1.00000 2
Iadj= 0.99477 1.00000 1.00000 1.00000 0
Umax=20.0000V Umin= 0.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 0A Gain= 1.00000
设置电流增益校正系数。
电流增益校正系数是一个1附近的数值,用来校正检流电阻、基准初始值等带来的误差, 范围0-100,如果UIMeter显示电流数值小于实际电流值,需要增大电流增益校正系数, 反之减小电流增益校正系数。
使用iset adj命令将电流增益校正系数设置为1.00234,设定数值需要扩大100000倍去掉小数点。
iset adj 100234
iset
iset [adj|zero|cali|shunt|gain] [adj_D5|I_D4] set I param.
Uadj= 1.00458 1.00239 1.00000 1.00000 2
Iadj= 1.00234 1.00000 1.00000 1.00000 0
Umax=20.0000V Umin= 0.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 0A Gain= 1.00000
设置电流零偏校正系数。
如果电流通道在测量端悬空时不为0,需要校正电流零偏。单位为一个电流分辨率。
如果电流显示0.0003A,使用iset zero 3
命令校正。
如果电流显示-0.0002A,使用iset zero -2
命令校正。
电流快速校准。
首先使用iset adj 100000
命令将电流增益校正系数设置为1.
将UIMeter电流通道与基准电流源串联,读取基准源电流值,执行命令 iset cali [基准电流值]
UIMeter自动计算校准系数,保证电流显示值与基准电流值相等,基准电流值需要扩大10000倍去掉小数。
设置以后立即生效,保存参数需要执行param save
命令。
设置分流器量程和增益校正系数。该命令从v17.5.11固件开始支持。
UIMeter从v17.5.11固件开始支持使用电压档测量分流器。短接J4跳线右侧两位, 然后设置分流器量程以后即可使用电压档测试分流器电流。
一般分流器输出满量程电压均为75mV。75mV电压除以量程即为分流器电阻。
如75mV 150A分流器,电阻为75mV/150A=0.5mR
。
UIMeter采样分流器微小电阻上的压降,然后根据用户设置的分流器量程 计算出流过分流器上的电流。
命令格式:iset shunt [分流器量程]
命令格式:iset gain [扩大100000倍后的增益校正系数]
分流器量程设置为100A校正系数设置为1.00111,命令如下:
iset shunt 100
iset gain 100111
iset
iset [adj|zero|cali|shunt|gain] [adj_D5|I_D4] set I param.
Uadj= 1.00458 1.00239 1.00000 1.00000 2
Iadj= 0.99477 1.00000 1.00000 1.00000 0
Umax=20.0000V Umin= 0.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 100A Gain= 1.00111
分流器量程设置为0A校正系数设置为1,命令如下:
iset shunt 0
iset gain 100000
iset
iset [adj|zero|cali|shunt|gain] [adj_D5|I_D4] set I param.
Uadj= 1.00458 1.00239 1.00000 1.00000 2
Iadj= 0.99477 1.00000 1.00000 1.00000 0
Umax=20.0000V Umin= 0.0000V Uhys= 0.5000V 4
75mV SHUNT Range= 0A Gain= 1.00000
分流器量程设置范围1A-65534A,可兼容市面上绝大多数分流器。
分流器量程设置为0A或者65535A时,关闭分流器电流测量功能。
一般用户设置分流器量程以后即可准确测量大电流,如果用户具备大电流校准条件, 可以使用iset gain命令进一步提高测量精度。
设置以后立即生效,保存参数需要执行param save
命令。
查看或者设置设备参数。
命令格式:info [hires|tft|inv|probe|addr|baud] Show/Set Info.
不带参数的info命令获取设备参数。
info
info [hires|tft|inv|probe|addr|baud] Show/Set Info.
HIRES=0 TFT=0 INV=0 PROBE=0-TYPEK ADDR=1 BAUD=3-115200
设置参数的命令格式为:info [子命令] [参数]
子命令如下表所示:
命令名 | 意义 | 取值 |
---|---|---|
HIRES | 是否高分辨率版本 | 0:标准版 1:高分辨率版本 |
TFT | 是否TFT彩屏 | 0:1602屏 1:TFT彩屏 |
INV | 光耦极性是否反相(仅V4版本) | 0:不反相,1:反相 |
PROBE | 温度探头类型 | 0:K型热电偶 1:PT100 2:5k欧NTC |
ADDR | 串口地址 | 1-247 |
BAUD | MODBUS协议波特率 | 115200bps-2400bps |
UIMeter所有版本使用相同的固件,用info hires
命令来进行区分。
info hires 1
命令设置为高分辨率版本,2.2R检流电阻1uA电流分辨率。info hires 0
命令设置为标准版本,25mR检流电阻0.1mA电流分辨率。设置以后立即生效,保存参数需要执行param save
命令。
UIMeter兼容1602屏幕和TFT彩屏。
info tft 0
设置为1602屏幕。info tft 1
设置为TFT彩屏。设置以后执行param save
命令保存参数,重启生效。
UIMeterV4增加了一颗输出光耦,型号EL357NC,默认情况下,光耦发光二极管与二极管D1极性相同, 即D1点亮光耦输出CE饱和导通,设置INV=1以后极性反相,即D1点亮光耦输出CE截止。
设置以后执行param save
命令保存参数,重启生效。
UIMeter兼容三种温度探头。
info probe 0
设置为K型热电偶。info probe 1
设置为PT100。info probe 2
设置为5k欧NTC电阻。设置以后立即生效,保存参数需要执行param save
命令。
设置串口地址,地址范围1-247.
info addr 2
设置串口地址为2,该地址与MODBUS协议地址相同。设置以后立即生效,保存参数需要执行param save
命令。
设置MODBUS协议串口波特率,支持波特率:115200、57600、38400、19200、9600、4800、2400。
info baud 9600
设置波特率为9600bps。设置以后执行param save
命令保存,然后切换为MODBUS协议生效。
该命令仅仅对MODBUS协议生效。TERM协议仍然使用115200固定波特率。
设备控制命令。
命令格式:ctrl [echo|bklt|dir|test|led|opt|mos|time] [param] Device Ctrl.
通过设备控制命令可以控制设备的运行参数。
开关命令行回显。
ctrl echo 0
。ctrl echo 1
。UIMeter默认回显用户输入的字符,可以关闭命令行回显。
version
UIMeter v20.1.10 SN:098339534154023148544536
ECHO Studio <echo.xjtu@gmail.com>. All Rights Reserved.
ctrl echo 0
ECHO=0
UIMeter v20.1.10 SN:098339534154023148544536
ECHO Studio <echo.xjtu@gmail.com>. All Rights Reserved.
ECHO=1
version
UIMeter v20.1.10 SN:098339534154023148544536
ECHO Studio <echo.xjtu@gmail.com>. All Rights Reserved.
设置以后立即生效,保存参数需要执行param save
命令。
设置背光亮度。
命令格式:ctrl bklt [0-F]
参数为十六进制,0到F,0最暗关闭背光,F最亮。命令举例如下:
ctrl bklt 0
ctrl bklt F
ctrl bklt 8
设置以后立即生效,保存参数需要执行param save
命令。
设置TFT屏幕显示方向。
命令格式:ctrl dir [0|1|2|3]
共TFT屏幕共4个显示方向0、1、2、3。默认显示方向为0。
设为默认显示方向:ctrl dir 0
该命令只对TFT屏幕设备有效,设置以后需要保存参数重启生效。
打开或关闭测试模式。
UIMeter的输出MOS管和LED默认由软件自动控制。打开测试模式以后,可以手动控制输出MOS管和LED。
命令格式:ctrl test [0|1]
ctrl test 0
ctrl test 1
开关指示LED。
ctrl led 0
ctrl led 1
UIMeter指示LED默认由软件自动控制,用户也可以手动控制。
用户使用info TEST 1
命令打开测试模式以后,可以使用ctrl led
命令控制LED。
开关输出光耦。
ctrl opt 0
ctrl opt 1
UIMeter输出光耦默认由软件自动控制,用户也可以手动控制。
用户使用info TEST 1
命令打开测试模式以后,可以使用ctrl opt
命令控制输出光耦。
开关输出MOS管。
ctrl mos 0
ctrl mos 1
UIMeter输出MOS管默认由软件自动控制,用户也可以手动控制。
用户使用info TEST 1
命令打开测试模式以后,可以使用ctrl mos
命令控制输出MOS管。
设置设备运行时间。
命令格式:ctrl time [设备运行秒数]
命令举例如下:
ctrl time 0
ctrl time 3600
ctrl time 86400
UIMeter上电以后运行时间从0开始自动增加,用户可通过ctrl time
命令手动设置运行时间。
重启系统。
可以带一个延时参数,单位ms,如果reboot 900
延时900ms以后重启。
命令输出如下:
reboot
rebooting...
UIMeter v20.1.10 SN:098339534154023148544536
ECHO Studio <echo.xjtu@gmail.com>. All Rights Reserved.
reboot 900
rebooting...
UIMeter v20.1.10 SN:098339534154023148544536
ECHO Studio <echo.xjtu@gmail.com>. All Rights Reserved.
获取在线帮助。
命令输出如下:
help
getui -> get U I P R Info.
clear -> clear power and time Info.
log -> log [dump|auto|ring|max|int|uh|ul|ih|il] Op.logs.
param -> param [load|save|restore] Operate parameters.
uset -> uset [adj|zero|max|min|cali] [adj_D5|U_D4] set U param.
iset -> iset [adj|zero|cali|shunt|gain] [adj_D5|I_D4] set I param.
info -> info [hires|tft|inv|probe|addr|baud] Show/Set Info.
ctrl -> ctrl [echo|bklt|dir|test|led|opt|mos|time] [param] Device Ctrl.
reboot -> reboot [delay ms] Restart system.
help -> help Info.
version -> display SW version and SN.
获取固件和设备序列号等信息。
命令输出如下:
version
UIMeter v20.1.10 SN:098339534154023148544536
ECHO Studio <echo.xjtu@gmail.com>. All Rights Reserved.
UIMeterV4增加了文件系统支持,使用文件系统来存储离线记录数据,提供了常见的文件管理命令,描述如下。
命令格式: lfs [umount|mount|format] Operate File System.
lfs命令带三个子命令:umount、mount、format。
lfs umount
命令卸载文件系统。lfs mount
命令挂载文件系统。lfs format
命令格式化文件系统。UIMeterV4启动以后会自动挂载文件系统。如果更换FLASH芯片或者文件系统出错,可以尝试使用lfs format
命令重新格式化文件系统。
列出文件。
命令执行情况如下:
ls
d 0 .
d 0 ..
- 453951 01.csv
- 2587912 02.csv
- 1789445 record.csv
查看文件系统使用情况。
命令执行情况如下:
df
Block Size:4096 Total:2048 Used:1188 Rate:58.0%
删除文件。
命令格式:rm [file|dir] remove FILE or DIR.
命令执行情况如下:
ls
d 0 .
d 0 ..
- 453951 01.csv
- 2587912 02.csv
- 1789445 03.csv
- 473 record.csv
rm record.csv
ls
d 0 .
d 0 ..
- 453951 01.csv
- 2587912 02.csv
- 1789445 03.csv
文件更名。
命令格式:mv [src] [dst] move or rename FILE or DIR.
命令执行情况如下:
ls
d 0 .
d 0 ..
- 453951 01.csv
- 2587912 02.csv
- 1789445 record.csv
mv record.csv 03.csv
ls
d 0 .
d 0 ..
- 453951 01.csv
- 2587912 02.csv
- 1789445 03.csv
离线记录数据默认截断模式写入record.csv
文件,如果想保存record.csv
文件的内容,可以使用mv
命令修改为其它文件名。
查看文件内容。
命令格式:cat [file] Show File Contents.
命令执行情况如下:
ls
d 0 .
d 0 ..
- 453951 01.csv
- 2587912 02.csv
- 1789445 03.csv
- 387 record.csv
cat record.csv
0, 9998, 4.8913, 0.0000, 27.0,814.0
1, 9999, 4.8904, 0.0000, 27.0,814.0
2, 10000, 4.8888, 0.0000, 27.0,814.0
3, 10001, 4.8909, 0.0000, 27.0,814.0
4, 10002, 4.8849, 0.0000, 27.0,814.0
5, 10003, 4.8848, 0.0000, 27.0,814.0
6, 10004, 4.8914, 0.0000, 27.0,814.0
7, 10005, 4.8885, 0.0000, 27.0,814.0
8, 10006, 4.8884, 0.0000, 27.0,814.0
使用cat
命令查看文件内容,配合超级终端
的捕获文字功能可以从设备中导出数据到PC。
log dump
命令只能导出record.csv
文件中记录的内容;cat
命令可以查看任意文件内容。
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )