放大器编程说明.doc

1、USB 接口系列放大器编程说明老用户请注意：我公司生产的 USB 接口系列放大器已经升级到 5.0,驱动程序及动态连接库已经更新，给您带来的不便请您谅解，如果使用中问题发现问题请 及时与我 们联系。 电话：82755026/27/28/29/30 邮件地址：symtopsymtop .com。本说明适用于我公司生产的所有 USB 接口系列放大器。UB-nT 是我公司开发的 USB 总线传输数据的生物电放大器，UE-nT 是我公司开发的 USB总线传输数据的脑电放大器。其中 n 表示导数，T 代表类型。你可以用动态连接库中的ReadDevice 函数查询放大器设备信息。我们在产品外表面有放大器型

2、号的标示，请确认无误后使用。UB-nT 生物电放大器及 UE-nT 脑电放大器可与各种提供 USB 接口的台式机、笔记本电脑连接构成高性能的数据采集系统。我公司提供放大器专用动态连接库 EEGAMP.DLL， 。此动态连接库提供了非常简单的编程接口。编译时加入 EEGGAMP.H 和 EEGAMP.LIB。我公司生产的所有系列的放大器统一使用这个动态连接库。动态连接库当前版本为 4.0.0.0 ，请查看 EEGAMP.DLL 文件属性中的版本信息。一 函数一览OpenDevice 打开放大器；CloseDevice 关闭放大器；ReadData 从放大器读取数据；ReadParam 从放大器读

3、取参数；WriteParam 向放大器写入参数；ValidateClientID 验证客户识别号；ReadDevice 读取设备信息；ReadParamEx 从放大器读取某一类型的参数WriteParamEx 向放大器写入某一类型的参数二 函数的详细说明1OpenDevice函数形式：HANDLE OpenDevice();说 明：该函数打开放大器，取得放大器设备句柄。执行其他操作前应首先调用该函数获得放大器设备句柄。输入参数：无返 回 值：放大器设备句柄。如果返回值为 INVALID_HANDLE_VALUE，说明放大器打开失败。在调用其他函数时使用此设备句柄。2CloseDevice函数形

4、式：BOOL CloseDevice(HANDLE hDevice);说 明：该函数关闭放大器。在放大器停止使用前应调用该函数。输入参数：打开放大器时得到的设备句柄。返 回 值：标识设备是否正常关闭。3ReadData函数形式：BOOL ReadData(HANDLE hDevice,short* pBuffer,ULONG *nCounts);说 明：该函数用于读取放大器数据。输入参数：hDevice 打开放大器时得到的设备句柄pBuffer 存贮读到数据的缓冲区地址，共有 10 次采样数据连续存放。对于非 FS、FZ、FX 型号的放大器，每次数据为n（n 为标称通道数）个 16 位有符号数

5、(1 个单位代表 0.5微伏) ,此缓冲区大小应分配为 10*n*2 字节。对于FS、FZ、FX 型号的放大器，每次数据为 n+1（n 为标称通道数）个 16 位有符号数(1 个单位代表 0.5 微伏) ,此缓冲区大小应分配为 10*(n+1)*2 字节。应用程序必须保证在10ms（1000Hz 采样率）或 9.7ms（1024Hz 采样率）内读取最新数据，否则数据自动刷新。 nCounts 读取到的数据个数。返 回 值：标识从放大器读取数据是否成功。注意：FS、FZ、FX 包含 1 导标记数据，附加在每次普通采样数据的最后，大小为2 个字节，高字节为标记类型，低字节为标记值。目前只有一种标记

6、数据同步信号输入。序号 高字节 低字节 含义1 0X00 0X00 标记数据无效2 0X01 0X01 有同步信号输入344ReadParam函数形式：STRU_PARAM ReadParam(HANDLE hDevice);说 明：该函数用于从放大器读取参数。输入参数：hDevice 打开放大器时得到的设备句柄返 回 值：包含放大器参数的 STRU_PARAM 结构。5WriteParam函数形式：BOOL WriteParam(HANDLE hDevice,STRU_PARAM OutData);说 明：该函数用于向放大器写入参数。输入参数：hDevice 打开放大器时得到的设备句柄Out

7、Data STRU_PARAM 结构返 回 值：标识向放大器写入数据是否成功。6ValidateClientID函数形式：BOOL ValidateClientID(HANDLE hDevice,unsigned short nClientID);说 明：该函数用于验证客户标识号；输入参数：hDevice 打开放大器时得到的设备句柄nClientID：客户标示号返 回 值：标识验证是否成功。7ReadDevice函数形式：STRU_DEVICE_INFO ReadDeviceInfo(HANDLE hDevice);说 明：该函数用于读取设备信息；输入参数：hDevice 打开放大器时得到的设

8、备句柄返 回 值：设备信息。8ReadParamEx函数形式：BOOL ReadParamEx(HANDLE hDevice,short nParamType,short* pBuffer,short* nSize);说 明：该函数用于从放大器读取某一类型的参数。输入参数：hDevice： 打开放大器时得到的设备句柄nParamType：参数类型 1-设备信息 2-放大器参数 4-采样率pBuffer: 存贮读到数据的缓冲区地址，数据顺序与对应结构相同nSize: 返回的有效数据字节数返 回 值：读取数据是否成功。9WriteParamEx函数形式：BOOL ReadParamEx(HANDL

9、E hDevice,short nParamType,short* pBuffer,short nSize);说 明：该函数用于向放大器写入某一类型的参数。输入参数：hDevice： 打开放大器时得到的设备句柄nParamType：参数类型 2-放大器参数 3-阻抗检测 LED 控制 4-采样率pBuffer: 存贮数据的缓冲区地址，数据顺序与对应结构相同；LED 控制数据与通道顺序相同，需要点亮设为 1，需要关闭设为 0；nSize: 有效数据字节数返 回 值：写入数据是否成功。注：ReadParamEx、WriteParamEx 中参数类型的说明1-设备信息 ：只读类型，8 字节2-放大器

10、参数：读写类型，16 字节 ,参数顺序为结构定义中的顺序。3-阻抗检测 LED 控制：只写类型，最大 128 字节，每两个字节控制一个通道的 LED，0 代表灭，1 代表亮。4-采样率：读写类型，2 字节。1000 代表 1000Hz 采样率，1024 代表 1024Hz 采样率；默认采样率为 1000Hz。如果你使用1024Hz 采样率，请在每次调用 OpenDevice()之后设置一次采样率。三、结构定义：1、 设备信息typedef struct _DEVICEINFO_unsigned short nRouteNum; /通道数 FS、FZ 、FX 附加 1 导标记数据unsigned

11、 short nType; /类型 1-A 、2-B、3-C、4-A1、5-FZ、6-F、7-BZ、8-CZ、9-FS、10-FXunsigned short nDeviceID; /设备编号unsigned short nSwitchNo; /拨码开关标示号STRU_DEVICE_INFO,*P_STRU_DEVICE_INFO;注意：FS、FZ、FX 包含 1 导标记数据，附加在每次普通采样数据的最后,大小为 2 个字节，高字节为标记类型，低字节为标记值。因此读到的通道数比型号中标记的通道数多 1。2、参数typedef struct _PARAMunsigned short nSense

12、Degree;unsigned short nHightFre;unsigned short nTimeConstant;unsigned short nWorkFre;unsigned short nModeOfSign;unsigned short nGateOfJam;unsigned short nHold1;unsigned short nHold2;STRU_PARAM,*P_STRU_PARAM;各成员变量含义如下： nSenseDegree：非各导可分别设置型： 写脑电参数时，设置为零；写入扩展通道参数时，高 8 位为零，低 8 位为N（N 为该扩展通道的序号） 。 读脑电参数

13、时，高 8 位为 1，低 8 位为 0，其他参数设为 0，写入一次；然后读取参数返回的是脑电参数；读扩展通道参数时，高 8 位为 1，低 8 位为N（N 为该扩展通道的序号） ，其他参数设为 0，写入一次；然后读取参数返回的是相应扩展通道参数；各导可分别设置型： 写参数时，若设置为零，写入的参数对所有得通道有效；若高 8 位为零低 8位为 N，写入的参数对第 N 通道有效。 读第 N 通道的参数时，首先设置高 8 位为 1，第 8 位设置为 N，其他参数设为0，写入一次；然后读取的参数返回的是第 N 通道的参数。 nHightFre 高频滤波：可以设置为 15、30、45、60、120(默认值

14、为 30),分别对应 15Hz、30Hz、45Hz、60Hz、120Hz(默认值为 30Hz)； nTimeConstant 时间常数： 可以设置为 3、10、30(默认值为 30),分别对应0.03s、0.1s、0.3s（默认值为 0.3s） ； nWorkFre 工频限波： 可以设置为 0、50、60(默认值为 50)，分别对应 关闭、50Hz、60Hz(默认值为 50Hz); nModeOfSign 信号方式：普通型可以设置为 0、1(默认值为 0)，分别对应EEG、方波(默认值为 EEG)；带阻抗检测型(BZ 型)可以设置为 0、1、2(默认值为 0)，分别对应 EEG、方波、阻抗检测

15、(默认值为 EEG)。在阻抗检测模式时，读取得数值乘 2 为各通道阻抗值 nGateOfJam 干扰门限： 可以设置为 0-127(0-7FH)之间的任意数字(默认值为127(7FH)，对应门限值为 255*0.5v -（127*256+255）*0.5v。设为127（7FH）时相当于关闭干扰检测。放大器干扰幅度的峰值超过门限持续 1秒钟以上，将关闭该通道输入，该通道输出 0；放大器干扰幅度的峰值低于门限持续 1 秒钟以上，将打开该通道。 nHold1 未定义 nHold2 未定义例如：设置脑电参数gm_hDevice=OpenDevice();STRU_PARAM struParam;str

16、uParam.nSenseDegree=0;struParam.nHightFre=30;struParam.nTimeConstant=30;struParam.nWorkFre=50;struParam.nModeOfSign=0;struParam.nGateOfJam=127;if(!WriteParam(gm_hDevice,struParam)AfxMessageBox(“Write Failed!“);CloseDevice(gm_hDevice);读取脑电参数gm_hDevice=OpenDevice();STRU_PARAM struParam;struParam.nSens

17、eDegree=0x0100struParam.nHightFre=0;struParam.nTimeConstant=0;struParam.nWorkFre=0;struParam.nModeOfSign=0;struParam.nGateOfJam=0;if(!WriteParam(gm_hDevice,struParam)AfxMessageBox(“Write Failed!“);struParam=ReadParam(gm_hDevice);CloseDevice(gm_hDevice);设置 24 导放大器第 1 扩展通道的参数gm_hDevice=OpenDevice();ST

18、RU_PARAM struParam;struParam.nSenseDegree=22;struParam.nHightFre=30;struParam.nTimeConstant=30;struParam.nWorkFre=50;struParam.nModeOfSign=0;struParam.nGateOfJam=127;if(!WriteParam(gm_hDevice,struParam)AfxMessageBox(“Write Failed!“);CloseDevice(gm_hDevice);读取 24 导放大器第 1 扩展通道的参数gm_hDevice=OpenDevice(

19、);STRU_PARAM struParam;struParam.nSenseDegree=0x0100+0X16；/0X16-22struParam.nHightFre=0;struParam.nTimeConstant=0;struParam.nWorkFre=0;struParam.nModeOfSign=0;struParam.nGateOfJam=0;if(!WriteParam(gm_hDevice,struParam)AfxMessageBox(“Write Failed!“);struParam=ReadParam(gm_hDevice);CloseDevice(gm_hDev

20、ice);三、数据格式：ReadData 函数读取放大器数据，把数据放到调用者指定的缓冲区。1、缓冲区内每个采样周期数据放置的格式如下：第 0 个采样周期数据第 1 个采样周期数据第 2 个采样周期数据第 3 个采样周期数据第 4 个采样周期数据第 5 个采样周期数据第 6 个采样周期数据第 7 个采样周期数据第 8 个采样周期数据第 9 个采样周期数据2、每个采样周期内的数据格式如下：1 导：1 导生物电，双极输入2 导：2 导生物电，单极或双极输入4 导：4 导生物电，单极或双极输入8 导：8 导生物电，单极或双极输入12 导：12 导生物电，单极或双极输入16 导：16 导脑电18 导：

21、16 导脑电、1 导心电、1 导呼吸19 导：19 导脑电21 导：19 导脑电、1 导心电、1 导呼吸22 导：19 导脑电、1 导心电、1 导呼吸、1 导双极扩展24 导：19 导脑电、1 导心电、1 导呼吸、3 导双极扩展32 导：32 导脑电41 导：32 导脑电、1 导心电、1 导呼吸、1 导双极扩展、6 导单极扩展注意：FS、FZ、FX 包含 1 导标记数据，附加在每次普通采样数据的最后，大小为 2 个字节，高字节为标记类型，低字节为标记值。目前只有一种标记数据同步信号输入。序号 高字节 低字节 含义1 0X00 0X00 标记数据无效2 0X01 0X01 有同步信号输入343、每个采样周期中的每个通道的数据为 16 位有符号数。附：型号编制说明：一区：由字母表示输入信号类型和输出接口类型“U“USB 接口“E“脑电（EEG）“B“生物电（Bioelectricity）“C“心电（ECG）二区：由数字表示生物电或脑电可输入的通道数（单极或双极输入）“D“所有通道为双极输入三区：由字母或数字的组合表示不同的功能“B“普通型；“F“各导参数可分别设置；“Z“阻抗检测；“S“附加一导标记数据；“X“增强型一区 二区 三区-