简介
Esight工具是用于mPower系列产品的上位机软件,支持windows7及其以上版本系统，支持x86(32位)和x64(64位)系统。 mPower1203是一款集便携式直流程控供电、高精度电流测试、动态电流波形显示分析以及高性价比为一体的直流分析电源，可以很好的在您进行功耗测试分析时提供动态测量分析和便携服务！
市场痛点：
· 手持设备/穿戴设备对低功耗的需求越来越高，普通的大功率直流电源虽价格便宜，但电流测试精度不能满足需求。
· 普通的大功率直流电源不能提供电流波形的显示，保存，回放以及分析功能。
· 专业的直流电源分析仪非常昂贵，价格都是几万甚至几十万。而且比较笨重，不方便高频率的搬运。很难做到户外无220V交流电环境下的可调供电以及电流测试。
我们能解决什么？
· mPower系列产品体积只有常规智能手机大小，供电容易，携带和使用都方便。
·mPower系列产品可支持nA级~A级的动态电流测量范围，测试精度可高达100nA，采样率可高达30ksps，可准确的反映电流动态情况，并配合Esight工具进行电流波形的显示分析、存储和回放。
· mPower系列产品设备可采用标配的适配器供电，也可采用通用的手机充电器供电使用。户外情况可采用充电宝等直流储能设备供电使用。
mPower接线说明
电源模式
连接示意图如下：
给负载提供调0.6~13V的供电电压。
能够实时监测显示负载电流波形。
电流表模式
连接示意图如下：
注意事项：电流表模式电流要从I+流入,I-流出，不要接反了！
实时监测显示所串入电路的电流波形。
mPower供电方式
1. 有市电插座场景，推荐使用标配的9V配器供电。
2. 通过手机充电适配器和Type-C线也可以给mPower供电。
3. 外场无市电场景，可以使用充电宝配合Type-C线给mPower供电。
注意：mPower的Type-A接口只能用于和PC通信，无法供电。
Esight工具操作
设备连接PC
1. 默认mPower开机会自动连接Esight工具。开机过程中电源灯会闪烁，开机完成后常亮。
2. 如果没有自动连接，可以点击左下角【offline】或者点击菜单【Tools】->【Port】选择端口连接。
3. 关于限流保护【CurLimit】，如果电源模式下，两个端子短路，默认会提示过流同时会自动切断电源；也可以通过设置限流值来限定负载达到设定电流自动断开功能用来保护负载不会超过设定电流值。
波形捕获和分析
捕获：下面以电源模式auto档位为例,选择好模式后将【Power】按钮置为ON状态，点击【Run】按钮即可实时捕获波形。点击【Stop】按钮停止捕获。
标尺：选择X标尺,X2标尺会自动定位到屏幕显示区域最大值。将鼠标放在标尺线或者标签上按住鼠标左键即可左右拖动标尺，释放鼠标即可停止。
X1和X2标尺区域之间波形的平均/最大/最小电流。
Y1和Y2是X1和X2点对应的电流（如果有Y标尺则是Y标尺对应的电流）。
缩放：鼠标滚轮在波形区默认是水平缩放，按住shift按键配合鼠标滚轮也是水平缩放，按住ctrl按键配合鼠标滚轮是垂直缩放，同时按住shift和ctrl配合滚轮则同时水平垂直缩放。鼠标左键拖动一个矩形框可以实现矩形区域放大。
平移：按住鼠标滚轮可以任意方向平移波形；在X坐标轴按住鼠标左键或者使用鼠标滚轮可以左右平移X轴；在Y坐标轴按住鼠标左键或者使用鼠标滚轮可以上下平移Y轴。
坐标轴的平移力度可以通过【Tool】->【Config】中Axis ratio设置，默认为10%。
触发：勾选【Trig】后通过移动触发线或者手动输入值调整触发线位置，当捕获电流达到触发值时自动停止捕获。
存储：点击【SaveWave】可以保存当前波形，也可以通过勾选【InstSave】实现长时间保存所有波形。
鼠标移动到坐标轴右下角区域会自动弹出已保存波形对话框，双击即可回放波形。
双波形同时回放：点击【PlayWave】弹出文件选择对话框，同时选择2个波形文件，点击打开即可。双波形的X轴偏移可以通过LeftOffset/RightOffset配置，按回车键生效。
校零：如果发现设备开机后底电流不是在0附近跳动可以点击【Tools】->【ZeroBase】手动校零。
其他配置
点击【Tools】->【Config】打开配置选项。
面板隐藏：为了最大化显示波形区域，可以通过配置面板隐藏功能。
实时电压：勾选【InstVoltage】即可。
负坐标：因为容性负载的原因，可能会出现负电流，因此默认会显示负坐标，如果不关注负电流，可以去勾选【NegtiveAxis】取消负坐标的显示。
优先级：采样率默认Normal模式，如果需要更快的采样率可以配置为Fast或者High模式；默认显示平均电量，也可以配置为平均功率。
二次开发
：第三方程序也可以直接调用windows dll库提供的API接口控制mPower1203设备，理论上可以支持128路mPower1203设备同时采集数据,dll库提供了如下接口：
** 函数名: Init
** 函数描述: 初始化mPower1203动态库
** 参数: 无
** 返回: [out]结果码: 0-成功 其他-失败
int Init()
** 函数名: OpenPort
** 函数描述: 打开一路mPower1203设备
** 参数: [in]port:mPower1203设备端口号(设备使用USB连接PC后可以在PC的设备管理
器中查看对应设备的端口号)
** 返回: [out]设备id:通常是从1开始,依次累加,如果ID小于0表示打开失败
int OpenPort(string port)
** 函数名: ClosePort
** 函数描述: 关闭一路mPower1203设备
** 参数: [in]设备id
** 返回: [out]结果码: 0-成功 其他-失败
int ClosePort(int id)
** 函数名: SetType
** 函数描述: 配置为电流表/电源类型
** 参数: [in]设备id
** 参数: [in]type取值参考MPOWER_TYPE_E
** 返回: [out]结果码: 0-成功 其他-失败
int SetType(int id, int type)
** 函数名: SetMode
** 函数描述: 配置设备工作模式
** 参数: [in]设备id
** 参数: [in]mode在电压表模式下取值参考MPOWER_POWER_MODE_E,电流表模式下取值参考
MPOWER_AMPERE_MODE_E
** 返回: [out]结果码: 0-成功 其他-失败
int SetMode(int id, int mode)
** 函数名: SetVoltage
** 函数描述: 电源模式下配置设备输出电压
** 参数: [in]设备id
** 参数: [in]voltage取值参考MPOWER_VOLTAGE_E,支持0.6V-13V电压可调
** 返回: [out]结果码: 0-成功 其他-失败
int SetVoltage(int id, int voltage)
** 函数名: SetPower
** 函数描述: 电源模式下打开/关闭设备电源
** 参数: [in]设备id
** 参数: [in]on取值参考MPOWER_POWER_E
** 返回: [out]结果码: 0-成功 其他-失败
int SetPower(int id, int on)
** 函数名: StartSample
** 函数描述: 启动数据采集
** 参数: [in]设备id
** 返回: [out]结果码: 0-成功 其他-失败
int StartSample(int id)
** 函数名: StopSample
** 函数描述: 停止数据采集
** 参数: [in]设备id
** 返回: [out]结果码: 0-成功 其他-失败
int StopSample(int id)
** 函数名: GetCurrent
** 函数描述: 获取电流采样数据，注意：因为数据采集速率非常快，建议单独线程采集数据,且
尽量不要有耗时操作比如延时函数或者log输出等等，如果获取到相同时间戳的数
据只保留一个即可
** 参数: [in]设备id
** 返回: [out]电流数据数组，长度不固定，一定是偶数，数据输出格式如下:
[0]:时间戳(us) [1]:电流(uA) [2]:时间戳 [3]:电流(uA) ... 依次类推
double[] GetCurrent(int id)
** 函数名: GetFwVersion
** 函数描述: 获取mPower1203设备固件版本号
** 参数: [in]设备id
** 返回: [out]版本号,[0]主版本号 [1]次版本号 [2]修订号
byte[] GetFwVersion(int id)
** 函数名: GetDllVersion
** 函数描述: 获取mPower1203.dll版本号
** 参数: 无
** 返回: [out]版本号,[0]主版本号 [1]次版本号 [2]修订号
byte[] GetDllVersion()
三台设备同时采集示例python程序如下：
#coding=utf-8
本例程使用python控制Egteks公司的mPower1203设备,同时支持多路设备配置和电流数据采集
本例程演示同时采集3路mPower1203设备
本例程实测环境是python v2.7.18
库文件mPower1203.dll提供的API接口说明参考History文件
import os
import time
import clr
#常量数据定义
from collections import namedtuple
MPOWER_TYPE = namedtuple('MPOWER_TYPE','POWER AMPERE')._make(range(2))
MPOWER_POWER_MODE = namedtuple('MPOWER_POWER_MODE','AUTO NORMAL PERCISION ULTRA')._make(range(4))
MPOWER_AMPERE_MODE = namedtuple('MPOWER_AMPERE_MODE','AUTO NORMAL PERCISION')._make(range(3))
MPOWER_VOLTAGE = namedtuple('MPOWER_VOLTAGE','V0_6 V0_7 V0_8 V0_9 V1_0 V1_1 V1_2 V1_3 V1_4 V1_5 \
V1_6 V1_7 V1_8 V1_9 V2_0 V2_1 V2_2 V2_3 V2_4 V2_5 V2_6 V2_7 V2_8 V2_9 V3_0 V3_1 V3_2 V3_3 V3_4 V3_5 \
V3_6 V3_7 V3_8 V3_9 V4_0 V4_1 V4_2 V4_3 V4_4 V4_5 V4_6 V4_7 V4_8 V4_9 V5_0 V6_0 V7_0 V8_0 V9_0 V10 V11 V12 V13')._make(range(53))
MPOWER_POWER = namedtuple('MPOWER_POWER','OFF ON')._make(range(2))
#导入mPower1203动态库
clr.FindAssembly('mPower1203.dll')
from mPower1203 import *
mPower = ClassmPower()
#初始化动态库
Res = mPower.Init()
print Res
#配置第一路,COM口需要根据实际端口号调整
Ch1 = mPower.OpenPort("COM5")
print Ch1
#配置为电源模式
Res = mPower.SetType(Ch1,MPOWER_TYPE.POWER)
print Res
#设置输出电压为12v
Res = mPower.SetVoltage(Ch1,MPOWER_VOLTAGE.V12)
print Res
#打开电源输出开关
Res = mPower.SetPower(Ch1,MPOWER_POWER.ON)
print Res
#打开第二路,COM口需要根据实际端口号调整
Ch2 = mPower.OpenPort("COM12")
print Ch2
#配置为电源模式
Res = mPower.SetType(Ch2,MPOWER_TYPE.POWER)
print Res
#设置输出电压为12v
Res = mPower.SetVoltage(Ch2,MPOWER_VOLTAGE.V12)
print Res
#打开电源输出开关
Res = mPower.SetPower(Ch2,MPOWER_POWER.ON)
print Res
#打开第三路,COM口需要根据实际端口号调整
Ch3 = mPower.OpenPort("COM13")
print Ch3
#配置为电源模式
Res = mPower.SetType(Ch2,MPOWER_TYPE.POWER)
print Res
#设置输出电压为12v
Res = mPower.SetVoltage(Ch2,MPOWER_VOLTAGE.V12)
print Res
#打开电源输出开关
Res = mPower.SetPower(Ch2,MPOWER_POWER.ON)
print Res
#启动数据采样
Res = mPower.StartSample(Ch1)
print Res
time.sleep(1)
Res = mPower.StartSample(Ch2)
print Res
time.sleep(1)
Res = mPower.StartSample(Ch3)
print Res
time.sleep(1)
说明:
1.这里为了演示采集数据所以使用log输出函数,正式使用场景下数据采集线程请勿输出log,避免丢数据
2.因为PC采集API调用速度可能会比实际设备采集数据速度快，所以可能会出现接收数据中存在多个时间
戳完全一样的数据,后续数据处理时丢弃掉重复的数据只保留一个即可
while True:
Data1 = mPower.GetCurrent(Ch1)
Data2 = mPower.GetCurrent(Ch2)
Data3 = mPower.GetCurrent(Ch3)
#输出3个通道每次接收的数据个数,
#print('%d,%d,%d'%(len(Data1),len(Data2),len(Data3)))
#输出3个通道每次接收的第一个数据的时间戳(us)和电流(uA)
print('%d,%.3f,%d,%.3f,%d,%.3f'%(Data1[0],Data1[1],Data2[0],Data2[1],Data3[0],Data3[1]))
#停止数据采样
Res = mPower.StopSample(Ch1)
print Res
Res = mPower.StopSample(Ch2)
print Res
Res = mPower.StopSample(Ch3)
print Res
#关闭通道
Res = mPower.ClosePort(Ch1)
print Res
Res = mPower.ClosePort(Ch2)
print Res
Res = mPower.ClosePort(Ch3)
热门跟贴