Egteks mPower1203二次开发API说明

***********************************************************************************/

* Author:tommy.zhang@egteks.com

* Date  :2022.04.16

*

*==================================================================================

*HISTORY

*----------------------------------------------------------------------------------

* V1.0.1.0 初版

***********************************************************************************/



mPower1203.dll提供如下API接口:

/**********************************************************************************

** 函数名:     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]voltage取值参考MPOWER_POWER_E

**

** 返回:       [out]结果码: 0-成功 其他-失败

*************************************************************************************/

int SetPower(int id, int voltage)



/************************************************************************************

** 函数名:     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()