通讯接口应用笔记3：使用W5500实现Modbus TCP服务器

前面我们设计实现了W5500的驱动程序，也讲解了驱动的使用方式。在最近一次的项目应用中，正好有一个使用W5500实现TCP通讯的需求，所以我们就使用该驱动程序轻松实现。这一篇中我们就来说一说基于我们W5500通讯驱动程序实现TCP通讯的过程。

1、应用需求

在本次应用中，要求实现一个基于W5500的Modbus TCP服务器。这个需求的描述虽然只有一句话，但是这个需求的内容可不简单。我们首先来分析一下这个需求的具体内容。

为了实现基于W5500的Modbus TCP服务器，我们必先须基于W5500实现一个TCP服务器。W5500本身是带硬件协议栈的，但却并不带TCP服务器。不过在我们前面的关于外设驱动库的系列文章中已经封装了W5500的驱动，其中就带有一个TCP服务器，我们可以直接采用就可以了。

其次我们要在TCP服务器的基础上实现Modbus TCP协议。关于Modbus协议栈，我们以前的文章就讲述过Modbus通讯协议栈的开发问题。而且我们已经将我们开发的Modbus通讯协议栈开源。其中已经封装了Modbus TCP服务器对象，所以我们直接采用这一Modbus通讯协议栈就可以了。

有了驱动和协议栈，我们还需要考虑应用层面的具体问题，而且也只需要考虑应用层面的具体问题。这里就看出我们前面封装外设驱动和Modbus通讯协议栈的价值所在了。关于应用层面的问题我们主要需要重点考虑几个问题：

第一，数据的存储类型及地址范围。我们知道Modbus协议常见的数据类型有4种。我们需要考虑在系统中需要使用到的类型及地址，这将决定Modbus协议数据处理回调函数的实现。

第二，网络配置问题，我们需要通过网络访问这台下位机就需要要为其配置网络。这存在静态配置，动态配置和系统自动分配的问题。作为服务器，我们一般不会希望让系统自动分配。所以我们需要考虑的是如何方便使用者为其分配地址的问题。

第三，并发访问的问题。挂载在网络上的服务器肯定面临多个客户端来访问的问题。W5500可以实现8个Socket，而Modbus TCP通用的默认端口号是502，当然也可以使用其它端口，只要不冲突就好。所以我们可以考虑使用不同的Socket和不同的端口号来实现并发访问。

2、功能设计

我们分析了基于W5500实现Modbus TCP服务器的需求。我们现在从硬件和软件两个方面来分析器功能的实现。

2.1、硬件功能设计

我们知道W5500带有硬件协议栈，集成有以太网控制器和物理层，所以对外我们只需要实现以太网变压器和硬件接口就好了。但与控制器部分的连接则采用SPI接口，除此之外还需要提供中断输入和模式设定的相关接口。在这里我们设计器硬件连接如下：

在上图中，我们将中断输入引入到MCU的GPIO端口，而模式设定PMODE0、PMODE1、PMODE2均通过电阻上拉到电源。对于W5500来说PMODE0、PMODE1、PMODE2均为高电平表示开启全部功能，所以我们直接拉高而不是引入到MCU引脚来控制。

2.2、软件功能设计

从需求来说，软件的功能非常简单，就是实现一个Modbus TCP服务器。但实际上，如我们前面所描述的那样，软件需要考虑的问题还是比较多的。从功能实现上主要有3个方面需要考虑：

第一，实现TCP服务器，这个服务器用于在系统中轮询处理，从W5500获取数据和发送数据给W5500都需要通过这部分来实现。

第二，TCP服务器得到数据后，我们需要解析数据，并根据解析的上位数据决定进一步的动作，还需要生成返回信息。这部分对应功能就是Modbus TCP服务器的实现。

第三，根据Modbus TCP服务器解析出的Modbus消息，需要决定下一步的动作，这个具体动作根据功能码的不同可能有不同需求，所以我们需要根据具体的要求实现不同功能码的动作。

根据上述的设计，我们可以简单的将需要实现的软件功能图示如下：

上图中，因为W5500的TCP服务器以及Modbus TCP协议栈的相关函数我们都做了封装，所以它们之间的调用都将以回调函数的方式实现。除了上述的软件实现外，还需要注意必要的初始化配置。

3、应用实现

根据我们前面的设计，接下来我们考虑一下这一需求的具体实现过程。我们将这一过程分为4个部分来分别描述。

3.1、系统的初始化

在实现具体的功能之前，我们需要对硬件以及软件环境做必要的初始化配置。具体到这里就是对W5500作必要的软硬件配置，包括接口、网络以及回调函数等。具体实例代码如下：

/* 以太网通讯配置 */
void McEthernetConfiguration(void)
{
  uint8_t mac[6]={0x01, 0x08, 0xdc,0x00, 0xab, 0xcd}; //本地Mac地址
  uint8_t ip[4]={192, 168, 1, 190};          //本地IP地址
  uint8_t sn[4]={255,255,255,0};           //子网掩码
  uint8_t gw[4]={192, 168, 1, 1};           //网关地址
  uint8_t dns[4]={0,0,0,0};              //DNS服务器地址
  
  /* 以太网使用GPIO初始化 */
  GPIO_Init_Configuration();
  
  /* SPI1端口初始化 */
  SPI1_Init_Configuration();
  
  /*W5500对象初始化函数*/
  W5500Initialization(&w5500,      //W5500对象
                      mac,        //本地Mac地址
                      ip,        //本地IP地址
                      sn,        //子网掩码
                      gw,        //网关地址
                      dns,        //DNS服务器地址
                      NETINFO_STATIC,  //DHCP类型
                      EnterCritical,   //进入临界区
                      ExitCritical,   //退出临界区
                      EnableChipSelect, //片选使能
                      DisableChipSelect, //片选失能
                      ReadByteBySPI,   //SPI读字节
                      WriteByteBySPI,  //SPI写字节
                      W5500DataParsing, //报文解析函数
                      NULL        //数据请求函数
                      );
}

在这个实例中，我们对网络部分采用的是静态配置，就是说网络参数是固定不变的，而且我们的测试环境只限于局域网内。

3.2、数据处理函数

数据处理函数是最灵活的，因为每个项目及每个人对数据处理的要求都是不一样的，只要能符合应用要求就没问题。需要说一下的是，这部分是Modbus协议栈对处理数据的要求，想要详细了解的话，可以看我们以前关于Modbus协议站的文章。对于这个实例，数据处理函数如下：

/*获取想要读取的Coil量的值*/
void GetCoilStatus(uint16_t startAddress,uint16_t quantity,bool *statusList)
{
 uint16_t start;
 uint16_t count;

 /*先判断地址是否处于合法范围*/
 start=(startAddress>CoilStartAddress)?((startAddress<=CoilEndAddress)?startAddress:CoilEndAddress):CoilStartAddress;
 count=((start+quantity-1)<=CoilEndAddress)?quantity:(CoilEndAddress-start);
 
 for(int i=0;i<count;i++)
 {
  statusList[i]=dPara.coil[start+i];
 }
}
 
/*获取想要读取的保持寄存器的值*/
void GetHoldingRegister(uint16_t startAddress,uint16_t quantity,uint16_t *registerValue)
{
 uint16_t start;
 uint16_t count;

 /*先判断地址是否处于合法范围*/
 start=(startAddress>HoldingRegisterStartAddress)?((startAddress<=HoldingRegisterEndAddress)?startAddress:HoldingRegisterEndAddress):HoldingRegisterStartAddress;
 count=((start+quantity-1)<=HoldingRegisterEndAddress)?quantity:(HoldingRegisterEndAddress-start);
 
 for(int i=0;i<count;i++)
 {
  registerValue[i]=aPara.holdingRegister[start+i];
 }
}
 
/*设置单个线圈的值*/
void SetSingleCoil(uint16_t coilAddress,bool coilValue)
{
 /*先判断地址是否处于合法范围*/
 if(coilAddress<=12)
 {
  dPara.coil[coilAddress]=coilValue;
 }
}
 
/*设置多个线圈的值*/
void SetMultipleCoil(uint16_t startAddress,uint16_t quantity,bool *statusValue)
{
 uint16_t endAddress=startAddress+quantity-1;
 if((startAddress<=12)&&(endAddress<=12))
 {
  for(int i=0;i<quantity;i++)
  {
   dPara.coil[i+startAddress]=statusValue[i];
  }
 }
}
 
/*设置单个寄存器的值*/
void SetSingleRegister(uint16_t registerAddress,uint16_t registerValue)
{
 bool noError=(bool)(((50<=registerAddress)&&(registerAddress<=59))
                   ||((73<=registerAddress)&&(registerAddress<=74))
                   ||((90<=registerAddress)&&(registerAddress<=91)));

 if(noError)
 {
  aPara.holdingRegister[registerAddress]=registerValue;
 }
 
}
 
/*设置多个寄存器的值*/
void SetMultipleRegister(uint16_t startAddress,uint16_t quantity,uint16_t *registerValue)
{
 uint16_t endAddress=startAddress+quantity-1;
 
 bool noError=(bool)(((18<=startAddress)&&(startAddress<=28)&&(18<=endAddress)&&(endAddress<=28))
                   ||((50<=startAddress)&&(startAddress<=59)&&(50<=endAddress)&&(endAddress<=59))
                   ||((73<=startAddress)&&(startAddress<=74)&&(73<=endAddress)&&(endAddress<=74))
                   ||((90<=startAddress)&&(startAddress<=91)&&(90<=endAddress)&&(endAddress<=91)));
 if(noError)
 {
  for(int i=0;i<quantity;i++)
  {
   aPara.holdingRegister[startAddress+i]=registerValue[i];
  }
 }
 
}

3.2、数据解析函数

大家可能在前面的初始化函数中发现有一个名为W5500DataParsing的数据解析函数。这个函数是W5500驱动中，TCP服务器的要求，实现对数据的解析。因为具体的应用层协议解析多不胜数，所以设计成了回调函数，其函数原型如下：

/*解析接收到的数据*/
typedef uint16_t (*W5500DataParsingType)(uint8_t *rxBuffer,uint16_t rxSize,uint8_t *txBuffer);

对于我们来说，我们需要根据具体的应用层协议来实现这一函数。不过我们采用的Modbus TCP协议，在我们的Modbus协议栈中已经实现了解析函数，所以我们调用如下：

/*报文解析函数*/
static uint16_t W5500DataParsing(uint8_t *rxBuffer,uint16_t rxSize,uint8_t *txBuffer)
{
  /*解析接收到的信息，返回响应命令的长度*/
  return ParsingClientAccessCommand(rxBuffer,txBuffer);
}

3.3、TCP服务器

我们在前面已经说过了，需要对服务器进行轮询。所以我们需要在一个进程中轮询访问W5500的TCP服务器。同样我们也要考虑多客户端同时访问的问题，我们将轮询函数实现如下：

/* 以太网通讯处理 */
void McEthernetProcess(void)
{
  /*TCP服务器数据通讯*/
  W5500TCPServer(&w5500,Socket0,502);
  
  W5500TCPServer(&w5500,Socket1,503);
  
  W5500TCPServer(&w5500,Socket2,504);
  
  W5500TCPServer(&w5500,Socket3,505);
  
  W5500TCPServer(&w5500,Socket4,506);
  
  W5500TCPServer(&w5500,Socket5,507);
  
  W5500TCPServer(&w5500,Socket6,508);
  
  W5500TCPServer(&w5500,Socket7,509);
}

事实上使用同一个Socket和不同的端口也是可以实现多客户端访问的，但既然有8个Socket，用起来自然更好一点。

4、应用验证

我们已经根据需求实现了一个Modbus TCP服务器，究竟效果如何呢？我们还需要测试一下，以确认设计的正确性。

4.1、通讯测试

我们将目标板连接到局域网中，使用著名的Modbus Poll软件来测试一下我们设计的程序是否符合要求。

我们首先在一台机器上连接端口为504的Modbus TCP服务器，连接正常且数据获取也完全正确。具体如下图所示：

同时，我们采用局域网内的另一台机器连接端口为502的Modbus TCP服务器，连接正常且数据获取也完全正确。具体如下图所示：

经过上述测试，我们可以确定我们实现的Modbus TCP服务器是可行的，而且在多客户端并行访问下也可以正确工作。

4.2、小结

这一篇中，我们实现了可以支持多客户端访问的Modbus TCP服务器，经测试运行也符合设计预期。这里我们将需要考虑的几个问题总结如下：

关于初始化配置的问题，在这个例子中，我们对网络的配置是直接在软件上固定死的，这样做虽然简单直接但并不是一个好的选择。更好的办法是可以让使用者自己配置，方法有多种，可以根据自己的实际情况，在软件上进一步的考虑。

关于数据处理的问题，具体的数据处理与实际的应用需求有关，也与应用层协议的要求有关，这个例子中实现的Modbus的数据处理函数并不是唯一的，但可参考其思路。

关于数据解析的问题，在本例中实现的是Modbus TCP服务器的解析函数。对于不同的应用协议需要编写不同的解析函数，这部分是灵活性最大的，支持所有可运行于TCP应用层的通讯协议。

关于多客户端访问的问题，W5500可以实现8个Socket，而Modbus TCP默认端口号是502，当然也可以使用其它端口。所以我们可以考虑使用不同的Socket和不同的端口号来实现并发访问。事实上，经过我们测试使用同一个Socket和不同的端口也是可以实现多客户端访问的，有兴趣的同仁可以试试。

欢迎关注：

posted @ 2021-08-08 13:25 Moonan 阅读(1604) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

木南创智

惟愿平凡的生活，不以平淡的方式度过！