Hantek HT6022BE SDK manual HTMarch

Page 1
SDK - HTMarch.dll 说明文档
中文版(VB 6.0)
阅读须知:
DLL 在VC++ 6.0 环境下编译生成。所以数据类型符合VC++ 6.0 标准.
DLL 中的所有文件都是用命令行上定义的 DLL_API 符号编译的。在使用此DLL
任何其他项目上都不应定义此符号。这样,源文件中包含此文件的任何其他项目都会将
DLL_API 函数视为是从 DLL 导入的。
#define HTMARCH_API extern "C" __declspec(dllimport)
#endif
定义标准调用:
#define WIN_API __stdcall
函数介绍
1. 函数声明:
HTMARCH_API short WIN_API dsoOpenDevice(unsigned short DeviceIndex)
返回值:
返回 0 表示设备没有连接,返回 1 表示设备已连接。
参数:
DeviceIndex
设备索引值,第一台连接的设备索引值是 0,依次递加。 备注: 判断设备索引值为 DeviceIndex 的设备是否连接到 PC 程序举例:
unsigned short nDev = 0; if(dsoOpenDevice(0) == 1) { ;//设备已连接 } Else { ;//没有发现设备 }
2. 函数声明:
Page 2
HTMARCH_API short WIN_API dsoSetVoltDIV(unsigned short DeviceIndex,int nCH,int nVoltDIV);
返回值:1 表示设置成功;0 表示设置失败
参数:
DeviceIndex
表示当前设备的索引值。 nCH: 信道索引值。0 表示 CH11 表示 CH2
nVoltDIV 电压档位索引值。最小电压档位为 0。以下是索引值代表的档位
0: 20mV/DIV 1: 50mV/DIV 2: 100mV/DIV 3: 200mV/DIV 4: 500mV/DIV 5: 1V/DIV 6: 2V/DIV 7: 5V/DIV
备注: 判断索引值为 DeviceIndex 的设备是否连接. 程序举例:
dsoSetVoltDIV(0,0,5);//设置 CH1 的电压档位为1V/DIV.
3. 函数声明:
HTMARCH_API short WIN_API dsoSetTimeDIV(unsigned short DeviceIndex,int nTimeDIV);
返回值:1 表示设置成功;0 表示设置失败
参数:
nDeviceIndex 表示当前设备的索引值。
nTimeDIV
表示当前的采样率档位的索引值, 以下是取值
0 ~ 10 : 48MSa/s 11: 16MSa/s 12: 8MSa/s 13: 4MSa/s 14 ~ 24: 1MSa/s 25: 500KSa/s
Page 3
26: 200KSa/s 27: 100KSa/s
备注: 设置设备的采集率档位
程序举例:
4. 函数声明:
HTMARCH_API short WIN_API dsoReadHardData(
unsigned short DeviceIndex,
short* pCH1Data,
short* pCH2Data, unsigned long nReadLen,
short* pCalLevel, int nCH1VoltDIV, int nCH2VoltDIV, short nTrigSweep, short nTrigSrc, short nTrigLevel, short nSlope, int nTimeDIV, short nHTrigPos,
unsigned long nDisLen, unsigned long * nTrigPoint,
short nInsertMode);
返回值:读取数据,失败返回-1, 其他表示成功。
参数:
unsigned short DeviceIndex 设备的索引值
short* pCH1Data存储CH1数据的缓冲区指针 short* pCH2Data存储CH2数据的缓冲区指针
unsigned long nReadLen读取数据的长度
short* pCalLevel校对电平(参考函数dsoGetCalLevel ) int nCH1VoltDIVCH1的电压档位 int nCH2VoltDIVCH2的电压档位 short nTrigSweep扫频模式—0: AUTO; 1: Normal; 2: Single short nTrigSrc触发信源--- 0: CH1; 1: CH2 short nTrigLevel触发电平 – 0 ~ 255
short nSlope触发沿方式—0: Rise; 1: Fall
Page 4
int nTimeDIV采样率档位 short nHTrigPos水平触发位置---0 ~ 100
unsigned long nDisLen显示数据的长度 unsigned long * nTrigPoint返回触发点的索引值
short nInsertMode差值方式—0: Step 差值; 1: Line 差值; 2: SinX/X 差值
备注: 读取数据时调用此函数。
5. 函数声明:
HTMARCH_API unsigned short WIN_API dsoGetCalLevel(unsigned short
DeviceIndex,short* level,short nLen);
返回值:失败返回 0,成功返回非 0
参数:
DeviceIndex
表示当前设备的索引值。
level
存储校对数据的缓冲区。
nLen
校对数据的长度,这里=32 备注: 获取设备的校对数据。
程序举例: short nCal[32];
dsoGetCalLevel(0, nCal l,32);
6. 函数声明:
HTMARCH_API short WIN_API dsoCalibrate(unsigned short nDeviceIndex,int nTimeDIV,int nCH1VoltDIV,int nCH2VoltDIV,short* pCalLevel);
返回值:失败返回 0,成功返回非 0
参数:
nDeviceIndex 表示当前设备的索引值。
nTimeDIV
采样率档位
nCH1VoltDIV CH1 的电压档位
Page 5
nCH2VoltDIV CH2 的电压档位 pCalLevel 存储校对数据的存储区
备注:
当任意通道的零基准发生偏移时,可调用此函数进行校正,校正信息存储在 pCalLevel
中. 若没有发生偏移,则不需要调用此函数
7. 函数声明:
HTMARCH_API unsigned short dsoSetCalLevel(unsigned short DeviceIndex,short* level,short nLen);
返回值:失败返回 0,成功返回非 0
参数:
DeviceIndex
表示当前设备的索引值。
level
校正数据存储区
nLen
校正数据的长度,这里是32 备注: 当调用 dsoCalibrate 函数校正后,可调用此函数将获得的校正数据存储到设备中,已备
以后直接读取使用。 程序举例:
short nLevel[32];
dsoCalibrate(0,11,5,5,nLevel); //零基准发生偏移,首先进行校对,获取校对数据
dsoSetCalLevel(0, nLevel,32); //将校对数据存储到设备中
Loading...