第47章 RL-TCPnet之Web服务器的CGI实现

STM32

转帖

本章节为大家讲解RL-TCPnet的CGI脚本实现动态网页，前面第44章讲解了静态网页的设计，本章的动态网页是在静态网页的基础上实现，所以学习本章节前，务必保证已经掌握了静态网页的设计方法。

本章教程含STM32F407开发板和STM32F429开发板。

47.1 初学者重要提示

47.2 CGI函数

47.3 HTTP配置说明（Net_Config.c）

47.4 HTTP调试说明（Net_Debug.c）

47.5 制作HTML和CGI脚本文件

47.6 访问开发板Web服务器的方法

47.7 HTTP_CGI.c文件中接口函数讲解说明

47.8 实验例程说明（RTX）

47.9 总结

lee_st · 2018-1-14 04:55:42

47.2.4 函数http_accept_host
函数原型：
BOOL http_accept_host (

U8* rem_ip, /* 远程设备IP地址 */

U16 rem_port ); /* 远程设备端口号 */

lee_st · 2018-1-14 04:56:01

函数描述：
函数http_accept_host用于设置是否接受远程连接，用户可以通过此函数选择允许哪些设备可以连接，哪些不可以连接。
1、第1个参数是远程设备的IP地址。
2、第2个参数是远程设备的端口号。
3、返回值，返回__TRUE表示允许此远程连接，返回__FALSE表示不允许此远程连接。
使用这个函数要注意以下问题：
1. 此函数是可选的，如果大家在工程中没有写这个函数，RL-TCPnet库会调用默认的函数，允许所有的连接请求，如果在工程中写了此函数，会执行新写的这个函数。

lee_st · 2018-1-14 04:56:24

使用举例：
BOOL http_accept_host (U8 *rem_ip, U16 rem_port) {

  if (rem_ip[0] == 192  &&

   rem_ip[1] == 168  &&

   rem_ip[2] == 1 &&

   rem_ip[3] == 1) {

/* 接受此连接. */

return (__TRUE);

  }

  /* 拒绝此连接 */

  return (__FALSE);

}

lee_st · 2018-1-14 04:56:40

47.2.5 函数cgx_content_type
函数原型：
U8 *cgx_content_type (void);

lee_st · 2018-1-14 04:56:56

函数描述：
函数cgx_content_type允许用户对Silverlight Web serviceapplication请求的响应中更改Content-Type HTML头。该函数返回一个指向新的Content-Type HTML头的指针。使用了此函数，将覆盖RL-TCPnet库中的默认Content-Type头。这个Content-Type头用于cgx脚本响应，默认的响应如下：
Content-Type: text/xmlrn

lee_st · 2018-1-14 04:57:12

如果大家在工程中没有写函数cgx_content_type，RL-TCPnet库会调用上面默认的响应，如果在工程中写了此函数，会执行新写的这个函数。另外，如果这个函数返回值为空指针的话，也是执行默认的响应。
使用这个函数要注意以下问题：
1. 如果大家在工程中没有写函数cgx_content_type，RL-TCPnet库会调用上面默认的响应。

lee_st · 2018-1-14 04:57:26

使用举例：
U8 *cgx_content_type (void) {

  /* User configurable Content-type for CGX script files. If this function */

  /* is missing, or returns a NULL pointer, the default 'text/xml' content */

  /* type from the library is used for xml-script file types.             */

  return ("text/xml; charset=utf-8");

}

lee_st · 2018-1-14 04:57:42

47.2.6 函数http_get_var
函数原型：
U8* http_get_var (

U8* env, /* 环境变量字符串地址 */

void* ansi, /* 存储环境字符串的缓冲地址 */

U16 maxlen ); /* 存储环境变量字符串的缓冲区大小，单位字节 */

lee_st · 2018-1-14 04:58:00

函数描述：
函数http_get_var处理包含环境变量的字符串env，并标识第一个变量的结尾。函数获取第一个变量及其数值后以ANSI格式存储到指针变量ansi所指向的存储单元中。
1、第1个参数是环境变量字符串地址。
2、第2个参数存储环境变量字符串的缓冲地址。
3、第3个参数指定存储环境变量字符串的缓冲大小，如果解析的环境变量字符串超过此大小，则该函数会仅存储maxlen大小的字符串。
4、返回值，返回环境变量字符串中下一个变量的地址，如果没有要处理的环境变量了，则返回NULL。

lee_st · 2018-1-14 04:58:16

使用这个函数要注意以下问题：
1.    函数http_get_var可以处理GET和POST方式的环境变量。
2.    此函数在HTTP_CGI.c文件中调用。
3.    Web浏览器使用环境变量来返回HTTP输入表单（如单选按钮、复选框、选择列表等）中用户输入的信息给Web服务器。

lee_st · 2018-1-14 14:12:44

使用举例：
void cgi_process_var (U8 *qs) {

  /* This function is called by HTTP server to process the Querry_String */

  /* for the CGI Form GET method. It is called on SUBMIT from the browser. */

  /*.The Querry_String.is SPACE terminated.                               */

  U8 *var;

  int s[4];

  var = (U8 *)alloc_mem (40);

  do {

/* Loop through all the parameters. */

qs = http_get_var (qs, var, 40);

/* Check the returned string, 'qs' now points to the next. */

if (var[0] != 0) {

   /* Returned string is non 0-length. */

   if (str_scomp (var, "ip=") == __TRUE) {

      /* My IP address parameter. */

      sscanf ((const char *)&var[3], "%d.%d.%d.%d",&s[0],&s[1],&s[2],&s[3]);

      LocM.IpAdr[0] = s[0];

      LocM.IpAdr[1] = s[1];

      LocM.IpAdr[2] = s[2];

      LocM.IpAdr[3] = s[3];

   }

   else if (str_scomp (var, "msk=") == __TRUE) {

      /* Net mask parameter. */

      sscanf ((const char *)&var[4], "%d.%d.%d.%d",&s[0],&s[1],&s[2],&s[3]);

      LocM.NetMask[0] = s[0];

      LocM.NetMask[1] = s[1];

      LocM.NetMask[2] = s[2];

      LocM.NetMask[3] = s[3];

   }

   else if (str_scomp (var, "gw=") == __TRUE) {

      /* Default gateway parameter. */

      sscanf ((const char *)&var[3], "%d.%d.%d.%d",&s[0],&s[1],&s[2],&s[3]);

      LocM.DefGW[0] = s[0];

      LocM.DefGW[1] = s[1];

      LocM.DefGW[2] = s[2];

      LocM.DefGW[3] = s[3];

   }

   else if (str_scomp (var, "pdns=") == __TRUE) {

      /* Default gateway parameter. */

      sscanf ((const char *)&var[5], "%d.%d.%d.%d",&s[0],&s[1],&s[2],&s[3]);

      LocM.PriDNS[0]  = s[0];

      LocM.PriDNS[1]  = s[1];

      LocM.PriDNS[2]  = s[2];

      LocM.PriDNS[3]  = s[3];

   }

   else if (str_scomp (var, "sdns=") == __TRUE) {

      /* Default gateway parameter. */

      sscanf ((const char *)&var[5], "%d.%d.%d.%d",&s[0],&s[1],&s[2],&s[3]);

      LocM.SecDNS[0]  = s[0];

      LocM.SecDNS[1]  = s[1];

      LocM.SecDNS[2]  = s[2];

      LocM.SecDNS[3]  = s[3];

   }

}

  }while (qs);

  free_mem ((OS_FRAME *)var);

}

lee_st · 2018-1-14 14:13:30

47.3 HTTP配置说明（Net_Config.c）

（本章节配套例子的配置与本小节的说明相同）

RL-TCPnet的配置工作是通过配置文件Net_Config.c实现。在MDK工程中打开文件Net_Config.c，可以看到下图所示的工程配置向导：

lee_st · 2018-1-14 14:14:36

47.3 HTTP配置说明（Net_Config.c）

（本章节配套例子的配置与本小节的说明相同）

RL-TCPnet的配置工作是通过配置文件Net_Config.c实现。在MDK工程中打开文件Net_Config.c，可以看到下图所示的工程配置向导：

lee_st · 2018-1-14 14:17:32

RL-TCPnet要配置的选项非常多，我们这里把几个主要的配置选项简单介绍下。

lee_st · 2018-1-14 20:55:57

RL-TCPnet要配置的选项非常多，我们这里把几个主要的配置选项简单介绍下。

lee_st · 2018-1-14 20:56:19

System Definitions
（1）Local Host Name
   局域网域名。
   这里起名为armfly，使用局域网域名限制为15个字符。
（2）Memory Pool size
   参数范围1536-262144字节。
   内存池大小配置，单位字节。另外注意一点，配置向导这里显示的单位是字节，如果看原始定义，MDK会做一个自动的4字节倍数转换，比如我们这里配置的是8192字节，那么原始定义是#define MEM_SIZE  2048，也就是8192/4 = 2048。

lee_st · 2018-1-14 20:56:37

（3）Tick Timer interval

可取10，20，25，40，50，100，200，单位ms。

系统滴答时钟间隔，也就是网络协议栈的系统时间基准，默认情况下，取值100ms。

lee_st · 2018-1-14 20:56:52

Ethernet Network Interface
   以太网接口配置，勾选了此选项就可以配置了，如果没有使能DHCP的话，将使用这里配置的固定IP。
（1）MAC Address
   局域网内可以随意配置，只要不跟局域网内其它设备的MAC地址冲突即可。
（2）IP Address
   IP地址。
（3）Subnet mask
   子网掩码。