外设模块详细设计说明

技术文件技术文件名称：外设模块详细设计说明技术文件编号：版本：拟制审核会签标准化批准修改记录目录1 编写目的 (3)2 术语、定义和缩略语 (3)2.1术语、定义 (3)2.2缩略语 (3)3 模块描述 (3)4 标准模块 (3)5 模块设计 (3)5.1IC卡相关类 (3)5.1.1界面类CICCard (4)5.1.2IC卡观察者接口类IICCardObserver (5)5.1.3IC卡操作接口类IICCardImpl (5)5.2打印机相关类 (6)5.2.1界面类CDevPrinter (6)5.2.2打印机接口类IDevPrinter (6)5.3本地回显相关类 (7)5.3.1界面类CLocalView (7)5.3.2本地回显接口类ILocalViewImpl (8)5.4IO控制相关类 (9)5.4.1界面类CIOControl (9)5.4.2IO控制接口类IIOControl (10)6 接口设计 (11)6.1输出 (11)6.2输入 (13)1编写目的编写本文件的目的在于详细地说明外设模块中各成分的设计考虑，以利于程序员编制程序。

2术语、定义和缩略语2.1术语、定义2.2缩略语本文件应用了以下缩略语：3模块描述为了减少系统复杂度和减少模块间的耦合，系统把和硬件或底层的相关的操作均抽象为外部设备操作，系统外设包括：1.IC读卡器、ID读卡器、电子刷卡器。

2.视频本地回显设备。

3.打印机。

4.红绿灯控制。

5.闸门控制。

6.灯光控制。

7.外设报警控制。

4标准模块本模块开发建立在系统基础模块之上。

5模块设计5.1IC卡相关类类图：5.1.1界面类CICCardCICCardl类为上层提供对IC卡操作的统一界面。

函数如下：class CICCard{public:///@brief///开始读IC 卡///@param///observer-观察者void start(IICCardObserver *observer);///@brief///停止读IC 卡void stop();///@brief///写IC 卡bool write(CardICStruct *data);///@brief///设置IC 卡类型void setType(int type=0);public:static CICCard& instance();}5.1.2IC卡观察者接口类IICCardObserver函数如下：class IICCardObserver{public:virtual void onCardICData(int type, char *data) = 0;};5.1.3IC卡操作接口类IICCardImplIC卡操作接口类IICCardImpl定义了操作IC的基本函数接口，所以IC卡操作的具体实现类均实现IICCardImpl接口。

函数如下：class IICCardImpl{public:virtual void start(IICCardObserver *observer) = 0;virtual void stop() = 0;virtual bool write(CardICStruct *data) = 0;};5.2打印机相关类类图：5.2.1界面类CDevPrinterCDevPrinter类为上层提供对打印机操作的统一界面。

函数如下：class CDevPrinter{public:///@brief///打印png 文件bool printFromPicData(char *data, int len);bool printFromPicFile(char *path);///@brief///设置类型v oid setType(int type=0);public:static CDevPrinter& instance();}5.2.2打印机接口类IDevPrinter打印机操作接口类IDevPrinter定义了操作打印机的基本函数接口，所以打印机操作的具体实现类均实现IDevPrinter接口。

函数如下：class IDevPrinter{public:///@brief///初始化virtual bool init() = 0;///@brief///释放virtual bool destroy() = 0;///@brief///打印png 文件virtual bool printFromPicData(char *data, int len) = 0;virtual bool printFromPicFile(char *path) = 0;}5.3本地回显相关类类图：5.3.1界面类CLocalViewCLocalView类为上层提供对回显操作的统一界面。

函数如下：class CLocalView{public:///@brief///启动本地回显///@param///channel-视频通道///id-显示区域///x-屏幕X 坐标///y-屏幕Y 坐标bool start(int channel, int id, int x, int y);///@brief///停止本地回显///@param///channel-视频通道void stop(int channel);public:static CLocalView& instance();}5.3.2本地回显接口类ILocalViewImpl本地回显接口类ILocalViewImpl定义了本地回显的基本函数接口，所以本地回显操作的具体实现类均实现ILocalViewImpl接口。

函数如下：class ILocalViewImpl{public:///@brief///初始化///@param///w-视频显示宽度///h-视频显示高度virtual bool init(int w, int h) = 0;///@brief///释放virtual bool destroy() = 0;///@brief///启动本地回显///@param///channel-视频通道///id-显示区域///x-屏幕X 坐标///y-屏幕Y 坐标virtual bool start(int channel, int id, int x, int y) = 0;///@brief///停止本地回显///@param///channel-视频通道virtual void stop(int channel) = 0;}5.4IO控制相关类类图：5.4.1界面类CIOControlCIOControl类为上层提供对IO控制操作的统一界面。

函数如下：class CIOControl{public:///@brief///控制红绿灯///@param///0-表示红灯亮///1-表示绿灯亮v oid ledControl(int ledType);///@brief///控制闸门///@param///isOpen-false表示关，true表示开v oid gatesControl(bool isOpen);///@brief///控制灯光///@param///isOpen-false表示关，true表示开v oid lightControl(bool isOpen);///@brief///报警///@param///isOpen-false表示关，true表示开v oid alarmControl(bool isOpen);public:static CIOControl& instance();}5.4.2IO控制接口类IIOControlIO控制接口类IIOControl定义了IO控制的基本函数接口，所以IO控制操作的具体实现类均实现IIOControl接口。

函数如下：class IIOControl{public:///@brief///控制红绿灯///@param///0-表示红灯亮///1-表示绿灯亮virtual void ledControl(int ledType) = 0;///@brief///控制闸门///@param///isOpen-false表示关，true表示开virtual void gatesControl(bool isOpen) = 0;///@brief///控制灯光///@param///isOpen-false表示关，true表示开virtual void lightControl(bool isOpen) = 0;///@brief///报警///@param///isOpen-false表示关，true表示开virtual void alarmControl(bool isOpen) = 0;}6接口设计6.1输出外设模块对外接口：class DeviceModuleImpl{public:///@brief///模块启动void start();///@brief///模块停止void stop();public://---------------------------------------------------------IC 卡读写///@brief///启动IC 卡读卡void cardICStart(IICCardObserver *observer);///@brief///停止IC 卡读卡void cardICStop();///@brief///IC 卡写数据bool writeCardIC(CardICStruct *data);///@brief///设置数据卡类型void cardSetType(int type);//---------------------------------------------------------视频本地回显///@brief///启动本地回显///@param///channel-视频通道///id-显示区域///x-屏幕X 坐标///y-屏幕Y 坐标bool localViewStart(int channel, int id, int x, int y);///@brief///停止本地回显///@param///channel-视频通道void localViewStop(int channel);//---------------------------------------------------------打印///@brief///打印png 文件bool printFromPicData(char *data, int len);bool printFromPicFile(char *path);///@brief///设置打印机类型void printerSetType(int type);//---------------------------------------------------------控制红绿灯///@brief///控制红绿灯///@param///0-表示红灯亮///1-表示绿灯亮void ledControl(int ledType);//---------------------------------------------------------控制闸门///@brief///控制闸门///@param///isOpen-false表示关，true表示开void gatesControl(bool isOpen);//---------------------------------------------------------控制灯光///@brief///控制灯光///@param///isOpen-false表示关，true表示开void lightControl(bool isOpen);//---------------------------------------------------------报警///@brief///报警///@param///isOpen-false表示关，true表示开void alarmControl(bool isOpen);public:///@brief///接口单件static DeviceModuleImpl& instance();}6.2输入系统只调用基础库中相关类接口。