FreeModbus源码分析

0.   版权声明:

本文著作权归属作者本人所有,提供广大网友学习分析用,如需在发表作品中引用,请联系作者本人。ourdev.cn作者IDsmily,百度文库idmcs3000电子邮件:[email protected]。本人保留署名权。如需转载请包含本版权声明。如果本文有不准确之处,欢迎与作者讨论,QQ:83414576。本人不对使用文中技术造成的后果负责。本文分析基于FreeModbus1.50.可以与作者联系获取pdf或者docx格式文档。

1.   FreeModbus协议分析

协议必须首先调用初始化功能eMBinit()函数。后调用eMBEnable(),最后,在循环体或者单独一个任务中调用eMBPoll()函数。

2.   应用层协议

2.1.     系统的启动

2.1.1.   eMBInit()函数的源码分析

RTU方式为例,首先,检查调用的地址是否合法。如不合法,返回错误。如果合法则继续执行,

首先,针对RTU方式还是ASCII方式,选择不同的编译模块。

对需要调用的函数指针进行复制。如果移植需要改变其他用途,则要修改相应的指针,包括如下赋值:

            pvMBFrameStartCur = eMBRTUStart;

            pvMBFrameStopCur = eMBRTUStop;

            peMBFrameSendCur = eMBRTUSend;

            peMBFrameReceiveCur = eMBRTUReceive;

            pvMBFrameCloseCur = MB_PORT_HAS_CLOSE ? vMBPortClose : NULL;

            pxMBFrameCBByteReceived = xMBRTUReceiveFSM;

            pxMBFrameCBTransmitterEmpty = xMBRTUTransmitFSM;

            pxMBPortCBTimerExpired = xMBRTUTimerT35Expired;

然后调用eStatus = eMBRTUInit( ucMBAddress, ucPort, ulBaudRate, eParity );具体初始化通讯端口。

2.1.2.   eMBRTUInit

eMBRTUInit这个函数主要干两件事:

第一,   初始化串口:   

if( xMBPortSerialInit( ucPort, ulBaudRate, 8, eParity ) != TRUE )

{

   eStatus = MB_EPORTERR;

}

这个函数在portserial.c中,需要用户在移植的时候根据自己的处理器编写。

第二,   初始化计时器:首先要根据波特率计算一下是3.5~5.0个字节周期的时间,然后再调用xMBPortTimersInit( ( USHORT ) usTimerT35_50us ),初始化计时器。这个函数在porttimer.c中,需要用户在移植的时候根据自己的处理器编写。

2.1.3.   eMBEnable源码分析

首先,看看Modbus功能是否是被关闭的,如果不是被关闭(可能是没有被初始化或者已经打开),就返回错误。

如果是disable状态,就干下面两件事:

l  调用pvMBFrameStartCur()。由于这是个函数指针,在模块eMBInit中,指向了eMBRTUStart函数

n  在源代码中有这样一段注释:,意思是,首先设置成STATE_RX_INIT,然后打开计时器,等待t3.5以后,进入STATE_RX_IDLE状态。

n  看源代码中,首先有设置Receiver的状态,后调用vMBPortSerialEnable,设置接收状态,然后打开定时器。

n  当定时器中断后,自动调用中断服务程序,在中断服务程序中,只调用了pxMBPortCBTimerExpired,而这是一个函数指针,在RTU方式初始化时,被指向了xMBRTUTimerT35Expired()函数。

n  xMBRTUTimerT35Expired函数在mbrtu.c中,在这里,我们只看第一种方式,就是进入初始化状态,在t35时间以后,只调用了一个xNeedPoll = xMBPortEventPost( EV_READY );

n  xMBPortEventPost函数就是在事件队列里加了一个EV_RDY事件。

l  然后,将eMB状态改为使能状态,

l  初始化结束。

2.2.     总线侦听eMBPoll()

首先,判断系统是否被使能,如果没有,则返回错误值。

然后,检查是否有事件发生,如果有,则根据不同类型的事件响应:

l  如果是EV_RDY,表示系统刚刚进入侦听状态,则什么都不做;

l  如果状态为EV_FRAME_RECEIVED,也就是接收到完整的帧,做下面两件事情:

n  调用eStatus=peMBFrameReceiveCur( &ucRcvAddress, &ucMBFrame, &usLength )。这是一个函数指针,在eMBInit中,被初始化指向eMBRTUReceive

n  eMBRTUReceive这个函数首先校验帧的长度和CRC,然后从协议中解析出地址、数据和长度。

n  然后检查地址,如果是广播地址或者是本机地址,就调用xMBPortEventPost( EV-EXECUTE),将接收器的状态更改为EV_EXECUTE

l  如果状态为EV_EXECUTE,就在函数列表中检查,有没有与命令字段相符合的函数来解析相应则执行该函数,否则返回非法功能代码。

2.3.  数据发送

发送数据通过指针eMBRTUSend,调用eMBRTUSend函数。

2.3.1.   eMBRTUSend函数

这个函数的作用就是打包,将数据打包成帧。

l  首先,检查接收状态。因为MODBUS是基于RS-485半双工通讯,所以当正在接收数据时,不发送该帧。

l  如果总线空,就将数据打包,将地址和CRC加入数据帧

l  将总线状态改为发送。

2.4.  功能注册

l  对于指定的功能代码,需要一个功能回调函数来处理,格式如下。

eMBException eMXXXXXX ( UCHAR * pucFrame, USHORT * usLen )

l  需要通过函数eMBRegisterCB(功能代码,函数名)加到处理代码中。具体源码分析从略。

2.4.1.   prvvUARTTxReadyISR()

总线状态改为发送后,会在发送缓冲时,自动调用prvvUARTTxReadyISR()中断服务程序。prvvUARTTxReadyISR()只调用了一个函数,就是pxMBFrameCBTransmitterEmpty ()

2.4.2.   pxMBFrameCBByteReceived ()

pxMBFrameCBTransmitterEmpty ()是一个指针,指向了xMBRTUTransmitFSM函数。

3.   数据链路层协议

数据链路层是最基本的打包部分,将数据打包成帧,送到应用层。在数据链路层协议中,使用中断方式来接受。那么每次接收到字符就自动调用接收字符的ISR程序。按照规定,应该将中断服务程序安装给prvvUARTRxISR(void)函数。实际上这个函数只调用了一个函数:

pxMBFrameCBByteReceived(),这个指针调用了xMBRTUReceiveFSM函数。

3.1.  xMBRTUReceiveFSM()函数

函数首先检查是不是处于发送状态。如果处于发送状态,直接退出。

l  首先调用xMBPortSerialGetByte( ( CHAR * ) & ucByte ),获取从串口读到的字符。

l  然后检查接受状态:

n  如果是错误状态或者处于初始化状态,那么直接等待,错过该帧。

n  如果是STATE_RX_IDLE空闲状态,则将指针重置,将收到的第一个字节存储到缓冲区,并将状态改为STATE_RX_RCV状态。

n  如果处于接收状态,就判断,如果缓冲区未满,就将收到的字节放入缓冲区,否则改为错误状态。

l  不管在任何状态,最后都开启了t35计时器。在t35结束的时候,通过指针调用了xMBRTUTimerT35Expired()函数。

l  xMBRTUTimerT35Expired()函数检查状态,如果是接收状态那就表明,已经有t35这么长的时间里,没有收到任新字节,当前的帧结束。在队列里增加一个EV_FRAME_RECEIVED事件。

l  如果是错误状态,什么都不做。

l  然后关掉计时器,将状态改为空闲。

3.2.  xMBRTUTransmitFSM()函数

xMBRTUTransmitFSM首先判断总线是否忙,如果忙,则终止。如果不忙,则继续,根据发送状态变量:

l  如果当前为STATE_TX_IDLE(空闲)状态,则打开端口发送

l  如果当前状态为STATE_TX_XMIT,则进一步判断发送队列是否为空,

n  如果不空,则发送下一个字符

n  如果空,说明发送完成,关闭发送端口,改为侦听,并将状态改为空闲。

4.   传输控制

除了传输控制以外,还有传输控制的若干函数。通过下面几个指针来调用:

         pvMBFrameStopCur()

         pvMBFrameCloseCur()

4.1.  pvMBFrameStopCur()函数

pvMBFrameStopCur是一个函数指针,在RTU方式下,它指向eMBRTUStop()函数。该函数做下面几件事情:

l  关闭侦听和发送

l  关闭定时器

4.2.  pvMBFrameCloseCur()函数

这个指针指向一个叫做vMBPortClose()的函数,该函数目前只有在mbport.h中的声明,而没有实现。需要等到后面的版本再实现。

你可能感兴趣的:(modbus)