这一节我将讲解thinkgear.h 里面的函数和宏定义。这一些都可以在MindSet Development ToolsThinkGear Communications Driverdocshtmlindex.html
这个路径中找到并打开。是使用doxygen软件生成的API帮助文档。
下面我将做一下简单的翻译。其实最主要的功劳还是google翻译(^v^)?
这些是API
THINKGEAR_API int TG_GetDriverVersion ()
获取当前TGCD库的版本
THINKGEAR_API int TG_GetNewConnectionId ()
返回一个控制ID,是一个整数。该ID是ThinkGear的连接对象。
/////////////////////下面的函数要用到TG_GetNewConnectionId ////////////////////////////////
THINKGEAR_API int TG_SetStreamLog (int connectionId, const char *filename)
做为一个ThinkGear的连接,将对它进行串行数据流字节的读取,它将自动记录这些字节数据到一个日志文件中。
THINKGEAR_API int TG_SetDataLog (int connectionId, const char *filename)
作为一个ThinkGear连接器读取并解析来自它的串行数据流的数据包,它将记录数据解析到一个日志文件。
THINKGEAR_API int TG_EnableBlinkDetection (int connectionId, int enable)
启用或禁止眨眼检测
THINKGEAR_API int TG_Connect (int connectionId, const char *serialPortName, int serialBaudrate, int serialDataFormat)
连接一个ThinkGear连接,通过给定的ConnectionId,在串行通信(COM)端口,以便与ThinkGear模块进行通信。
THINKGEAR_API void TG_FreeConnection (int connectionId)
释放与给定的ThinkGear连接相关联的所有内存。
///////////////////////////////////////////////////////////////////////////////////////////
/////////////////////下面的函数要用到TG_Connect ////////////////////////////////
THINKGEAR_API int TG_ReadPackets (int connectionId, int numPackets)
尝试使用ThinkGear连接,通过指定的ConnectionId,读取串口数据流的numPackets。
THINKGEAR_API int TG_GetValueStatus (int connectionId, int dataType)
如果数据类型是由最近一次调用TG_ReadPackets后更新的。那么将返回非零。
THINKGEAR_API float TG_GetValue (int connectionId, int dataType)
通过指定dataType类型(该参数的取值为define的那些TG_DATA_开头的常量)将返回指定类型所取到的值。
THINKGEAR_API int TG_SendByte (int connectionId, int b)
通过ThinkGear连接器(大概是为了某个ThinkGear模块)发送一个字节。
THINKGEAR_API int TG_SetBaudrate (int connectionId, int serialBaudrate)
指定connectionid和串口波特率,然后尝试改变波特率。
THINKGEAR_API int TG_SetDataFormat (int connectionId, int serialDataFormat)
给出connectionid和串口数据格式,进而改变所使用的ThinkGear连接的数据包解析格式。
THINKGEAR_API void TG_Disconnect (int connectionId)
指定ID,从串行通信端口断开ThinkGear连接。
///////////////////////////////////////////////////////////////////////////////////////////
THINKGEAR_API int TG_WriteStreamLog (int connectionId, int insertTimestamp, const char *msg)
THINKGEAR_API int TG_WriteDataLog (int connectionId, int insertTimestamp, const char *msg)
THINKGEAR_API int TG_EnableLowPassFilter (int connectionId, int rawSamplingRate)
作为一个ThinkGear连接读取并解析原始脑电值(通过TG_ReadPackets函数),对原始波形数据,驱动程序会自动套用30Hz的低通滤波器。
THINKGEAR_API int TG_EnableAutoRead (int connectionId, int enable)
启用或禁用后台自动读取连接。
这些宏定义
#define THINKGEAR_API __declspec( dllimport ) //栈调用方式
#define WINVER 0x0501
#define TG_MAX_CONNECTION_HANDLES 128
Maximum number of Connections that can be requested before being required to free one.
////////////////波特率 TG_Connect() 和TG_SetBaudrate()这两个函数会用到///////////////////////
#define TG_BAUD_1200 1200
#define TG_BAUD_2400 2400
#define TG_BAUD_4800 4800
#define TG_BAUD_9600 9600
#define TG_BAUD_57600 57600
#define TG_BAUD_115200 115200
////////////////数据格式////////////////////////////////
#define TG_STREAM_PACKETS 0
#define TG_STREAM_5VRAW 1
#define TG_STREAM_FILE_PACKETS 2
////////////////获取哪一种数据类型 TG_GetValue()这个函数会用到////////////////////
#define TG_DATA_BATTERY 0 //应该是电量吧
#define TG_DATA_POOR_SIGNAL 1 //连接质量
#define TG_DATA_ATTENTION 2 //专注度
#define TG_DATA_MEDITATION 3 //冥想度
#define TG_DATA_RAW 4 //原始数据
#define TG_DATA_DELTA 5 //δ波段
#define TG_DATA_THETA 6 //θ脑波
#define TG_DATA_ALPHA1 7 //α脑波
#define TG_DATA_ALPHA2 8 //α脑波
#define TG_DATA_BETA1 9 //β脑波
#define TG_DATA_BETA2 10 //β脑波
#define TG_DATA_GAMMA1 11 //γ脑波
#define TG_DATA_GAMMA2 12 //γ脑波
#define TG_DATA_BLINK_STRENGTH 37 //眨眼强度
对于上面讲到的一些数据的解释,网上的资料真的有点少。
对于上面提到的宏进行详解
POOR_SIGNAL质量
无符号的一个字节的整数值描述了神念科技NeuroSky的ThinkGear测量到的信号的强弱,它的范围值从0到200。零以外的值表示检测到了某种噪声信号。数值越高,表示测到的噪声越多。数值达到200说明神念科技NeuroSky的ThinkGear触点没有接触到用户的皮肤。
这个值每秒都会有输出,显示了刚刚测量到的信号的质量。信号质量差的原因很多。按照严重程度,它们分别是:
•传感器,地面,或者参考触点都没有在人的头上(即没有人戴ThinkGear的电极)。
•传感器、地面或者参考触点没有与人的皮肤接触好(比如:头发夹在里面,或者耳机与头的尺寸不适合,或者耳机没有放置在头部正确的位置 )。
•佩戴者动作过多(即头部或身体过于晃动,或碰撞到耳机)
•过多环境静电噪声(某些环境中会有强大的静电信号,或者在佩带传感器时人的静电积累)。
•过多的非EEG生物噪声(即肌电,心电,眼电等)。
正常使用神念科技NeuroSky的ThinkGear产品时也会不可避免的受到一定数量噪声的干扰,神念科技NeuroSky的过滤技术和eSense™ 专利算法都可以检测,改正,补偿,解释和容忍不同类型非脑电噪声。多数用户都只对eSense值感兴趣,如专注度Attention和冥想度Meditation,他们无需担心POOR_SIGNAL质量值,除非检测到POOR_SIGNAL质量值时专注度Attention和冥想度Meditation都无法更新。POOR_SIGNAL质量值对那些对噪音比较敏感的应用程序比较有用(正如一些医学或研究用的应用程序)或者只要检测出一点噪音数据就需要立刻作出反应的应用程序。默认情况下,数值的输出是有效的。通常一秒钟输出一次。
eSense “专注度Attention”指数
这个无符号的一个字节值表明用户当前的“eSense专注度Attention指数”,即使用者 精神“集中度”水平或“注意度”水平的强烈程度,例如,当你能够进入高度专 注状态并且可以稳定地控制你的心理活动,该指数的值就会很高。该指数值的范 围是0到100。心烦意乱、精神恍惚、专注度Attention不集中以及焦虑等精神状态都将降低 专注度Attention指数的数值。默认情况下,数值的输出是有效的。通常一秒钟输出一次。
eSense“冥想度Meditation“指数
这个无符号的一个字节值表明用户当前的“eSense冥想度Meditation指数” ,即使用 者精神“平静度”水平或“冥想度Meditation”水平。该指数值的范围是0到100。需要注 意的是,冥想度Meditation指数反映的是使用者的精神状态,而不是其身体状态,所以,简 单地进行全身肌肉放松并不能快速地提高冥想度Meditation水平。然而,对大多数人来说,
在正常的环境下,进行身体放松通常有助于精神状态的放松。冥想度Meditation水平的提高 与大脑活动的减少有明显的关联。长期观察结果表明:闭上眼睛可以使得大脑无 需处理通过眼睛看到的景象从而降低大脑精神活动水平。所以,闭上眼睛通常是 提高冥想度Meditation值的有效方法。心烦意乱、精神恍惚、焦虑、激动不安等精神状态以 及感官刺激等都将降低冥想度Meditation指数的数值。默认情况下,数值的输出是有效的。通常一秒钟输出一次。
原始波值raw(16位)
此数值由两个字节组成,代表一个单一的原始波样品。它的值是一个从 -32768到32767之间的十六位带符号整数。数值的第一个字节代表高位,第二个 字节代表低位。要重建完整的原始波的值,只要简单地将第一个字节左移8个位,并且按位或第二个字节:
RAW Wave Value (16-bit)
short raw = (Value[0]<<8) | Value[1];
Value[0]是高位字节,Value[1]是低位字节。
在系统或语言中位操作不是很方便,可用以下算术运算来代替:
raw = Value[0]*256 + Value[1];
if( raw >= 32768 ) raw = raw - 65536;
在语言里raw是表示数值从-32768到32767之间的任何有符号的数据类型。 每个ThinkGear模型仅在-32768到32767之间的特定范围里记录它的原始波 信息。例如,MindSet记录的原始波大约在-2048到2047之间。 默认情况下,数值的输出是有效的。每秒钟输出512次,也就是说大约每2 毫秒一次。
ASIC_EEG_POWER 各种脑电波
这个数据值代表8种众所周知的脑电(脑波)电流强度 。这个数值在小端格式 中作为一系列八个3字节无符号整数输出。八种脑电功率是按如下顺序输出的: delta(0.5-2.75赫兹),theta(3.5-6.75赫兹),low-alpha(7.5-9.25赫兹), high-alpha(10-11.75赫兹),low-beta(13-16.75赫兹),high-beta(18-29.75
赫兹),low-gamma(31-39.75赫兹),mid-gamma(41-49.75赫兹)。这些数值没有单位并且考虑到相对数量和短暂波动,他们只有在互相比较时才有意义。
默认情况下,数值的输出是有效的。通常每秒钟输出一次。
眨眼的强度
无符号的一个字节的值记录了用户最近眨眼的强度。它的数值范围从1到 255,并且一检测到眨眼,数值就会被记录下来。这个数值表明眨眼的相对强烈程度,没有单位。
注意:这个数值当前只能通过TGCD 和TGC 的应用程序接口才可使用。它不 可直接作为任何ThinkGear硬件的输出来使用。关于TGCD,可以参考使用 TG_GetValueStatus() 和 TG_GetValue()函数的TG_DATA_BLINK_STRENGTH数据类型。