QES通讯从机程序设计规范.docVIP

深圳市XXXXXXXXXX企业标准 Q/ES041-2011 通讯从机程序设计规范 2011-05-18发布 2011-06-01实施 深圳市xxxxxx有限公司发布 目 录 前 言 2 1 目的 3 2 范围 3 3从机分类 3 4程序设计 3 4.1模块化程序框架 3 4.2数据定义 3 4.2.1收发缓冲区及控制变量 3 4.2.2串口状态控制变量 4 4.3串口收发控制 4 4.3.1数据接收 4 4.3.2数据发送 5 4.3.3 发送完成计时 5 4.3.4接收超时计时 6 5 协议模块 6 5.1协议接口 6 5.2协议实现与调度 6 6 通讯测试要求 7 前 言 历次修订说明 版本V1.0，2011年04月26日，首次制订发行。 本标准由深圳市xxxxxxx有限公司提出。 本标准由深圳市深圳市xxxxxxx有限公司归口。 本标准起草单位：深圳市深圳市xxxxxx有限公司。 本标准起草人： 本标准于2011年04月首次发布。 通讯从机程序设计规范 1 目的 统一本公司软件开发人员在设备通讯编程时的编程实现。 2 范围 适用于公司所有产品的软件源程序。 3从机分类 串行通讯的从机根据硬件电路不同分为： RS232方式 RS485方式 4程序设计 4.1模块化程序框架 通过标准化的协议接口和收发缓冲区及通讯控制变量，把串口收发中断和协议进行有效隔离。串口中断程序负责芯片物理寄存器到内存缓冲区的数据传递；协议负责接收帧的识别，接收帧的数据分析，应答帧的组织。通过协议接口标准化，在开发阶段中断程序模块和协议程序模块可以独立编程；在运行时中断程序及通讯响应程序通过对接口的调用使协议模块得到运行。 在协议中要注意控制接收帧数据分析程序的独立性，不能把命令的执行放在解析程序中进行，应把解析出来的命令或事件放在全局变量中，交由后续的监控任务或事件处理任务来执行处理。 4.2数据定义 串口中断和协议之间通过一组全局变量进行交互, 全局变量定义在一个公共模块中，其命名遵循了软件编程规范 -- CC++。 需要的全局变量分为两类:收发缓冲区及控制变量和串口状态控制变量。 4.2.1收发缓冲区及控制变量 gauartx_rx_data[]: 接收缓冲区 gauartx_recive_count: 接收字节总数 gauartx_tx_data[]: 发送缓冲区 gauartx_send_count: 待发送字节总数 gauartx_send_indx: 要发送的缓冲区偏移指针 说明： 变量名称中的uartx用于区分多个串口，如串口1: gauart1_recive_size； 对于单工的问答型通讯模式的串口来说，可以直接使用接收缓冲区作为发送缓冲区，以节省内存空间。 4.2.2串口状态控制变量 gnuartx_status: 串口状态，取值来自： ENUM COM_STATUS{ COM_IDLE, //空闲 COM_RECIVING, //接收中 COM_RECIVE_COMPLETED, //接收完成 COM_SEND_WAITING, //等待发送（应答帧组织完成） COM_SENDING, //发送中 COM_SEND_COMPLETED //发送完成 }; gnuartx_recive_timeout_tickcount: 接收超时计时，当串口状态gnuartx_status处于接收中COM_RECIVING时，对接收超时进行计数。用一个10MS以下定时器计数，在每次串口接收中断中对此计数变量清零，定时器中进行增1计数，并判断如果到达一定的量值（时间量取值一个典型通讯周期的一半左右）则判当前帧接收失败，并把串口状态gnuartx_status改为空闲COM_IDLE。 gnchangeto_recive_tickcount：对于以485模式工作的串