LED显示屏二次开发接口的设计方案
(4)如果(2)中指令是文件传输指令,则重复(2)、(3),直到文件传输结束。
在通信过程中,发送方要强制结束发送过程,可以发送通信握手命令或强制中止通信进行强制终止。
2。2通信通道接口
在对LED显示屏进行通信之前,必须先建立通信通道,而退出系统时,则释放通信通道资源。通信通道接口包括:
(1)打开通信通道
函数格式:DWORDCOMM_Open(constPDeviceParampDevParam,DWORDdwNotify,DWORDdwWindws,DWORDdwMsg);
参数说明:
①pDevParam:表示指定设备的参数,例如串口的波特率、串口号,以及网络本地IP地址、端口号等参数;②dwNotify:表示当LED显示屏有返回值时是否通知,0代表不通知,1表示通知;③dwWindws:表示消息通知的窗体句柄;④dwMsg:用户定义的消息号。
返回值:
①0:表示创建失败;②其它值:表示设备通道值。
功能描述:
该函数用来建立一个通信通道,函数运行一次即建立一个通道,建立成功就返回一个DWORD值,代表一个设备的句柄,用于区分不同的通道。该值供其它接口函数使用,以便对不同的显示屏进行控制。
物理上支持串口通道、网络通道,对于串口,设置串口号、波特率、接收/发送缓冲区,然后打开串口;对于网络,设置本地IP、端口号、接收/发送缓冲区,然后打开网口。这里需要特别强调的是,网络采用UDP方式,这主要是为了:
①在协议实现上与串口统一;②只需一次创建;③提高网络通信握手连接。
因篇幅原因,以下函数将只列出函数格式和功能说明。
(2)关闭通信通道
函数格式:DWORDCOMM_Close(DWORDdwDev/*通信设备通道*/);
该函数关闭已打开的通信通道(dwDev),释放通信通道资源,一般在退出系统前使用。
(3)强制中止通信
函数格式:DWORDCOMM_Break(DWORDdwDev);
该函数中止当前通信通道(dwDev)的通信。
(4)通信握手
函数格式:DWORDCOMM_Link(DWORDdwDev/*通信设备通道*/,
BYtebyDstNo/*目标显示屏ID*/,
char*chHost/*网络地址,串口时无效*/,
WORDwPort/*网络端口号,串口时无效*/
);
该函数查询显示屏是否能够通信,可在通信之前或监控LED显示屏时使用。
2。3节目接口
LED显示屏显示的信息其实是一个个的节目文件,一般先在上位机控制系统中生成,然后发送到显示屏上显示。在设计节目接口时,可能因节目结构不同,细节上有些差别,本文根据如图3所示的树形节目结构设计一种节目接口。
(1)节目初始化。
函数格式:
DWORDProgram_Init(DWORDdwProgramType/*节目类型*/,
DWORDdwScreenType/*显示屏类型*/,
DWORDdwWidth/*节目宽度*/,
DWORDdwHeight/*节目高度*/
);
该函数用于在计算机内存开辟一块内存空间,或释放上一次节目占用的资源,为节目生成做准备。
(2)添加区域
函数格式:
DWORDProgram_AddArea(DWORDdwAreaType/*区域类型*/,
LPRECTrect/*显示区域*/,
DWORDdwAreaNO/*区域号*/
);
在显示屏页面上,根据节目的要求,需要划分不同的区域,设置其起点和宽高。可使用该函数在当前显示页面上创建一个个的区域,以放置具体的显示对象,例如内码文字、时钟等。
(3)添加各种对象。
在页面的区域上,可添加单行文字、多行文字、内码文字、图片、视频动画、WORD文档、Flash动画、表格、数字时钟、模拟时钟、倒计时等各种显示对象,在实现时,每一种对象对应一个函数。这里列出常用的添加图片的函数:
函数格式:
DWORDProgram_AddPicture(DWORDdwAreaNO/*区域号*/,
HDCdc/*图形dc*/,
DWORDdwWidth/*图片宽*/,
DWORDdwHeight/*图片高*/,
LPRECTrect/*显示区域*/,
DWORDdwAction/*特效号*/,
DWORDdwExitAction/*退出特效号*/,
DWORDdwSpeed/*显示速度*/,
DWORDdwTimecount/*显示时间*/,
DWORDdwTransparent/*透明与否*/);
该函数在指定区域上添加一个图片,显示内容来自于dc。
(4)节目数据生成。
函数格式:DWORDProgram_MakeData()。
该函数生成节目数据,以便使用LEDControl_SendToScreen函数发送到不同的显示屏。
2。4命令接口
命令接口主要为控制、监控和发送节目数据而设计,例如,火车站或街头的广告屏,在夜间人少时,广告效果不明显,同时也为了省电,可在指定夜间时间点关闭显示屏,然后到早晨指定时间点自动打开显示屏。经过总结,命令接口的命令包括:
(1)重启命令。
函数格式:DWORDLEDControl_Reboot(DWORDdwDev,BYTEbyDstNo,char*chHost,WORDwPort);
该函数用来重启指定的LED显示屏。
(2)电源控制。
函数格式:DWORDLEDControl_SetPower(DWORDdwDev,BYTEbyDstNo,charchHost,WORDwPort,DWORDdwPower/*开或关标识*/);
该函数打开或关闭显示屏。
(3)显示屏亮度调节。
函数格式:DWORDLEDControl_SetBrightness(DWORDdwDev,BYTEbyDstNo,char*chHost,WORDwPort,BYTEbyBrightness/*亮度*/);
该函数用于调节显示屏亮度。
(4)校时。
函数格式:DWORDLEDControl_AdjustTime(DWORDdwDev,BYTEbyDstNo,char*chHost,WORDwPort);
该函数用于计算机时钟校正显示屏时钟。
(5)节目发送接口。
函数格式:DWORDLEDControl_SendToScreen(DWORDdwDev,BYTEbyDstNo,char*chHost,WORDwPort);
该函数将Program_MakeData生成的节目数据发送到显示屏,最后返回状态值,表示成功、失败及其它状态,用户根据状态再进行相应的处理。
(6)局部更新节目接口。
函数格式:DWORDLEDControl_UpdateCodeText(DWORDdwDev,BYTEbyDstNo,char*chHost,WORDwPort,char*chCodeText/*字符串缓冲区*/,intiLen/*字符串长度*/);
评论