通信通道接口

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/*显示区域*/,

DWORD&dwAreaNO/*区域号*/

）；

在显示屏页面上，根据节目的要求，需要划分不同的区域，设置其起点和宽高。可使用该函数在当前显示页面上创建一个个的区域，以放置具体的显示对象，例如内码文字、时钟等。

（3）添加各种对象。

在页面的区域上，可添加单行文字、多行文字、内码文字、图片、视频动画、WORD文档、Flash动画、表格、数字时钟、模拟时钟、倒计时等各种显示对象，在实现时，每一种对象对应一个函数。这里列出常用的添加图片的函数：

函数格式：

DWORDProgram_AddPicture（DWORDdwAreaNO/*区域号*/,

HDCdc/*图形dc*/,

DWORDdwWidth/*图片宽*/,

DWORDdwHeight/*图片高*/,

LPRECTrect/*显示区域*/,

DWORDdwAction/*特效号*/,

DWORDdwExitAction/*退出特效号*/,

DWORDdwSpeed/*显示速度*/,

DWORDdwTimecount/*显示时间*/,

DWORDdwTransparent/*透明与否*/）；

该函数在指定区域上添加一个图片，显示内容来自于dc.

（4）节目数据生成。

函数格式：DWORDProgram_MakeData（）。

该函数生成节目数据，以便使用LEDControl_SendToScreen函数发送到不同的显示屏。