pTpSenddll调用说明.doc

【接库文件】pTpSend.dll一、通讯操作部份1、打开串口函数【函数功能说明】打开串行口【函数格式】int SS_Open_Com(const int com,const int baud,const int delay);【函数参数】com串口号 0-255，0-表示COM1，1-表示COM2， baud波特率 1200/2400/4800/9600/19200/38400/57600或者是：0-4800,1-9600,2-19200,3-38400,4-57600delay控制命令回应时间；当计算机打开串口后，通过串口往控制卡写命令或数据，超过delay秒后，若控制卡未返回任何成功或错误代码，返回超时错误。【函数返回值】成功:0失败:返回错误码代码err_code（见附注1）2、关闭通讯连接【函数功能说明】关闭已经打开的串口【函数格式】void SS_Close(void)【函数参数】无【函数返回值】成功:0失败:返回错误码代码err_code（见附注1）二、显示屏操作部份1、控制卡时钟校正【函数功能说明】校正控制卡的时钟，使之与电脑主机同步。【函数格式】int SS_Send_Time(const int addr)【函数参数】addr显示屏地址 0255,其中0,255为广播地址,地址为0时，不返回任何数据【函数返回值】成功: 0失败: 不返回或返回错误码代码err_code（见附注1）2、控制卡复位【函数功能说明】控制卡复位，等同控制卡断电后，再上电。【函数格式】int SS_Send_Reset(const int addr)【函数参数】addr显示屏地址 0255,其中0,255为广播地址,地址为0时，不返回任何数据【函数返回值】成功:0失败: 不返回或返回错误码代码err_code（见附注1）3、发送数据文件【函数功能说明】往指定地址的显示屏中传送一个或多个文件数据【函数格式】int SS_Send_File(const int addr,const int hard_type,const int Width,const int Height, const int Effect, const int Speed,const int Delay,const int Color,const char *FileList)【函数参数】addr显示屏地址 0255,其中0,255为广播地址，地址为0时，不返回任何数据hard_type硬件类型，0-小卡，1-大卡，2-双色图文卡，3-全彩图文卡Width屏体宽度 Height屏体高度 16或32Effect播放方式,祥见附注1Speed播放速度 07Delay停留时间 099Color文本颜色 0-红，1-绿，2-黄FileList文件名列表，含文件绝对路径，两个文件之间以回车换行分隔。【函数返回值】成功:0失败: 不返回或不返回或返回错误码代码err_code（见附注1）4、发送字符串数据【函数功能说明】往指定地址的显示屏中传送指定字符串数据(断电可以保存)【函数格式】int SS_Send_String(const int addr,const int Width,const int Height, const int Effect, const int Speed,const int Delay,const int Color,const char *DataString)【函数参数】addr显示屏地址 0255,其中0,255为广播地址，地址为0时，不返回任何数据Width屏体宽度 Height屏体高度 16/24/32/48/64/80/96/112/128Effect播放方式，祥见附注1Speed播放速度 07Delay停留时间 099Color文本颜色0-红，1-绿，2-黄DataString要显示的文本字符串。【函数返回值】成功:0失败: 不返回或不返回或返回错误码代码err_code（见附注1）5、发送实时数据【函数功能说明】往指定地址的显示屏中传送实时文本字符串数据(断电不保存,仅一幅)【函数格式】int SS_Send_Flash(const int addr,const int Width,const int Height, const int Effect, const int Speed,const int Stay, const int Color, const int TotalStay,constchar *DataString, const int DataSize)【函数参数】addr显示屏地址 0255,其中0,255为广播地址，地址为0时，不返回任何数据Width屏体宽度 Height屏体高度 16/24/32/48/64/80/96/112/128Effect播放方式，祥见附注1Speed播放速度 07Stay停留时间 099Color文本颜色0-红，1-绿，2-黄TotalStay即时文本的有效时间099DataString要显示的文本字符串DataSize文本字符串长度【函数返回值】成功:0失败:不返回或返回0xEC 6、发送实时数据(单页)【函数功能说明】往指定地址的显示屏中传送实时文本字符串数据(断电不保存)【函数格式】int SS_Send_Flash(const int addr,const int Width,const int Height, const int Effect, const int Speed,const int Stay, const int Color, const int TotalStay,constchar *DataString, const int DataSize)【函数参数】addr显示屏地址 0255,其中0,255为广播地址，地址为0时，不返回任何数据Width屏体宽度 Height屏体高度 16/24/32/48/64/80/96/112/128Effect播放方式，祥见附注1Speed播放速度 07Stay停留时间 099Color文本颜色0-红，1-绿，2-黄TotalStay即时文本的有效时间099DataString要显示的文本字符串DataSize文本字符串长度【函数返回值】成功:0失败:不返回或返回0xEC7、发送实时数据(多页)【函数功能说明】往指定地址的显示屏中传送实时文本字符串数据(断电不保存)【函数格式】int SS_Send_Flash_Ex(const int addr,const int Width,const int Height, const int Effect, const int Speed,const int Stay, const int Color, const int TotalStay,constchar *DataString, const int DataSize)【函数参数】addr显示屏地址 0255,其中0,255为广播地址，地址为0时，不返回任何数据Width屏体宽度 Height屏体高度 16/24/32/48/64/80/96/112/128Effect播放方式，祥见附注1Speed播放速度 07Stay停留时间 099Color文本颜色0-红，1-绿，2-黄TotalStay即时文本的有效时间099DataString要显示的文本字符串DataSize文本字符串长度【函数返回值】成功:0失败:不返回或返回0xEC8、发送实时图像【函数功能说明】往指定地址的显示屏中传送实时图像数据(断电不保存)【函数格式】int SS_Send_Flash_Img(const int addr,const int Width,const int Height, const int TotalStay,constchar * img_file)【函数参数】addr显示屏地址 0255,其中0,255为广播地址，地址为0时，不返回任何数据Width屏体宽度 Height屏体高度 16/24/32/48/64/80/96/112/128TotalStay即时文本的有效时间099img_file要显示的图像文件名【函数返回值】成功:0失败:不返回或返回0xEC三、附注【附注 1】显示屏播放方式1、 小卡播放方式1-连续左移2-连续上移3-连续下移4-下覆盖5-上覆盖6-反相显示7-闪烁显示8-立即打出2、 大卡播放方式1-连续左移2-连续右移3-连续上移4-连续下移5-下覆盖6-上覆盖7-右覆盖8-左覆盖9-反相显示10-闪烁显示11-立即打出3、 双色/全彩图文卡播放方式1-连续左移2-连续右移3-连续上移4-连续下移5-下覆盖6-上覆盖7-右覆盖8-左覆盖9-反相显示10-闪烁显示11-立即打出12-左飞移13-右飞移14-下沙漏15-上沙漏16-右沙漏17-左