自从开源了我们自己开发的Modbus协议栈之后，有很多朋友建议我针对性的做几个示例。所以我们就基于平时我们的应用整理了几个简单但可以说明基本的应用方法的示例，在这一篇中我们先来使用协议栈实现Modbus RTU主站的示例。

Modbus协议是一个主从协议，那肯定就有主站和从站之分。所谓主站说的简单一点就是能够主动发起通讯的对象，所以主站就是发起通讯的一方。

对于RTU主站来说，自己并不会产生数据，而是要从从站获取数据。在Modbus RTU协议中从站不会主动向外发送数据，所以需要主站发送数据请求，从站才会向其返回请求的数据。这一过程如下图所示：

从上图我们不难看出，首先主站要主动发起数据请求，这也是它为什么被称之为主站的缘由。它首先告诉从站我需要哪些数据。然后从站按照主站的请求返回数据。主站得到响应后解析数据，这样就完成了主从站之间的一次数据通讯。所以主站就需要主动发起每一次数据通讯的对象。

我们已经简单的说明了什么是RTU的主站，那么如何实现这一主站呢？其实在协议栈中，我们已经实现了主站的数据请求命令的合成以及响应数据的解析，所以我们使用协议栈时就是要控制何时将协议栈合成的主站请求命令发出以及如何解析数据响应进而得到想要的数据的过程。

在我们的协议栈中实现了0x01、0x02、0x03、0x04、0x05、0x06、0x0F以及0x10等功能码。也就是说主站对象可以生成面向这些功能码的从站数据请求。也可以解析面向这些功能码的从站数据响应。可以表示为下图所示：

从上图我们很清楚，协议栈已经实现了面向这些功能码的数据请求命令的生成以及数据响应消息的解析。我们使用协议栈时需要做的就是要告诉协议栈我要生成哪些数据请求命令以及如何解析数据响应消息。

对于数据请求，我们不一定需要面向全部功能码的请求，我们只需要根据我们的需求合成我们想要的请求。

在协议栈中，针对数据请求的生成我们定义了一个从站访问命令生成函数。该函数的原型如下：

uint16_t CreateAccessSlaveCommand(ObjAccessInfo objInfo,void *dataList,uint8_t *commandBytes)

该函数有3个参数，其中ObjAccessInfo objInfo为对象访问信息；void *dataList为数据列表指针，该参数主要用于写从站功能的命令生成；uint8_t *commandBytes为返回的从站访问命令。

ObjAccessInfo是一个结构体，向函数传递我们想要生成的从站访问命令的相关信息，包括站地址，功能码，起始地址和数量。该结构体的定义如下：

对于数据响应，我们同样不需要考虑全部的操作码，我们一般需要考虑读请求的响应，因为他们的数据需要解析。而对于写请求返回数响应只是告诉主站成功或者不成功，即使不成功只需要在写一次就可以了，不存在数据更新的问题。

在协议栈中，我们实现了主站解析从站数据响应的解析函数。使用这一函数我们只需要将收到的数据响应报文传递给解析函数就可以完成解析。该函数的原型定义如下：

void ParsingSlaveRespondMessage(RTULocalMasterType *master,uint8_t *recievedMessage,uint8_t *command)

这个函数有3个参数，其中RTULocalMasterType *master为主站对象；uint8_t *recievedMessage为接收到的响应消息；uint8_t *command为发送的命令序列。将这几个参数传递给解析函数就可实现数据响应的解析。

RTULocalMasterType是一个结构体，用以生命一个主站对象，这个对象就是我们要实现各种操作的主站，这一结构体的定义如下：

有了前面的说明，我们基于协议栈实现一个主站应用就很容易了。接下来我们就基于协议栈具体实现一个主站应用。

首先我们要声明一个主站对象，这是我们操作的基础。在接下来的各种操作中我们都是基于这一对象来实现的。具体操作如下：

RTULocalMasterType rtuMaster;

定义了这个主站对象后，我们还需要对这一对象进行初始化。协议栈同样提供了一个主站对象的初始化函数。函数的原型定义如下：

该函数的参数除了主站对象外，还有从站的数量即从站对象列表，还有四个数据更新函数指针。这几个函数指针将应用于数据响应的解析过程中，具体在后面描述。使用这一初始化函数实现对主站对象的初始化，使其能够实现各项操作，具体如下：

/*初始化RTU主站对象*/

  InitializeRTUMasterObject(&hgraMaster,2,hgraSlave,NULL,NULL,NULL,NULL);

这里我们将几个数据处理函数指针变量传入NULL，表示初始化为默认的操作函数，当然我们也可以编写这些函数，在后续的数据解析时将会详细说明。

在前面，我们已经描述了数据请求命令的生成函数，该函数有一个ObjAccessInfo参数，这个参数用于传递需要生成命令的信息。这是一个结构体，我们需要定义一个对象变量。

ObjAccessInfo hgraInfo;

然后使用这个对象来实现数据请求的生成。具体操作如下所示：

生成的数据请求什么时候发送给完全由主进程来实现已经与协议栈没有关系了。

收到数据响应后我们需要对其进行解析。前面我们已经介绍了解析从站数据响应的函数。具体的调用形式如下：

ParsingSlaveRespondMessage(&hgraMaster,hgraRxBuffer,NULL);

我们对hgraMaster主站对象收到的从站响应hgraRxBuffer进行解析。最后传入的NULL表示我们不指定主站发送的数据请求，而是让主站从请求列表中去自己查找。

当然我们需要实现数据更新处理回调函数。这几个函数是在对象初始化的时候以函数指针的形式传递的。原型如下：

我们可根据需要重定义这些函数，当然我们没有响应的数据可以不必实现，如我们没有使用输入寄存器，那么更新输入寄存器的回调函数则可以不用重定义。如下在我们的例子中重定义为：