USB-CAN通讯模块用户编程说明.docVIP

USB-CAN通讯模块——用户编程说明 2012.03 用户如果只是利用 USB-CAN通讯模块进行CAN总线通信测试，可以直接利用随本产品提供的EmbededDebug工具软件，接入CAN总线。如果用户打算开发自己产品的软件程序，可以使用我公司提供的相关API，简化通讯开发过程。 下面介绍CAN通讯相关的两个类。如果只做CAN方面的收发操作，可以只关心RT_CAN类，使用其中的SendCANMessage函数发送CAN消息，使用RecvCANMessage或者通过SetRxPackageCallBack设置接收回调函数的方式接收CAN消息即可；如果希望详细了解我公司的通讯协议，可结合本文档与源代码进行学习。 1 串口通讯说明 1.1串口通讯数据包的封装格式 通讯数据包的封装格式：FrameHead +Data+CheckSum+FrameTail，控制符为0xA5, FrameHead为连续的两个0xAA, FrameTail为连续的两个0x55，如果Data中含0xA5、0xAA、0x55（即特殊字符），则在发送该字符之前添加一个控制符0xA5。CheckSum为8位校验和，即Data的所有数据之和的低八位。 1.2 串口通讯操作类 1.2.1 类名称 串口操作类名称是：RT_COM（见RT_COM.cpp和RT_COM.h） 1.2.2 相关定义说明 (1) typedef void (*RxPackageCallBackFunc)(void *pParam, const BYTE * byBuf, DWORD dwLen); 说明：用于定义接收数据操作回调函数 参数：pParam：用户参数，调用SetRxPackageCallBack时设置。 byBuf：接收到的数据。 dwLen：接收到数据的长度 返回值：无 1.2.3函数说明 注意：以下文档中出现的com为RT_COM类实例化的对象。 (1) RT_COM(DWORD dwMaxPackageSize = 4096); 说明：类的构造函数 参数：MaxPackageSize：默认值为4096，用于初始化发送和接收缓冲。 返回值：无 (2) static DWORD FindAll(DWORD *dwDevName); 说明：*当传入参数为NULL时，返回设备的数量，可利用该数量初始化dwDevName *当传入参数不为NULL时，dwDevName传出所有设备名称 参数：dwDevName（传出）：存放设备名称，可以为NULL。 返回值：返回检查到的设备数量。 Example: #include RT_COM.h DWORD *dwDev, dwDevNum; //分配空间 dwDevNum = RT_ COM::FindAll(NULL); dwDev = new DWORD[dwDevNum]; //列出虚拟COM RT_ COM::FindAll(dwDev); for (DWORD i=0; idwDevNum; i++) { printf(COM%d\n, dwDev[i]); } (3) BOOL Open(DWORD dwPortNo, DWORD dwBaud); 说明：打开指定串口 参数：dwPortNo：串口号 dwBaud：指定串口波特率 返回值：如果成功打开，则返回TRUE；否则返回FALSE。 Example: #include RT_COM.h if(com.Open (6, 921600)) { //打开虚拟串口成功的操作 } (4) void Close(); 说明：关闭当前打开的串口 参数：无 返回值：无 Example: #include RT_COM.h if(com.Close ()) { //关闭虚拟串口成功的操作 } (5) void SetRxPackageCallBack(RxPackageCallBackFunc func, void *pParam); 说明：设置接收数据的回调函数 参数：pParam：用户参数。 func：RxPackageCallBackFunc类型的函数指针，用于在接收到数据后进行相关处理。 返回值：无 Example: #include RT_COM.h 定义回调函数： void RecvCallback(void * pParam, const BYTE * buf, DWORD len) { //执行回调操作 } 设置回调函数： com.SetRxPackageCallBack(RecvCallback, NULL); (6) DWORD WritePackag