大家好,我是ZhengN,本次来教大家在10分钟内使用开发板搭建一个web服务器。

 

之前分享的文章:常见的嵌入式web服务器有哪些?中分享了几种可以在嵌入式中使用的web服务器。

 

嵌入式 Web 服务器就是把 web 服务器移植到嵌入式系统的服务器。它仍然是基于http文本协议进行通信的,具有标准的接口形式,对客户端来说,访问嵌入式 web服务器就和访问普通的web 服务一样。

 

我们在实际工作中也有在板子上搭建web服务器,给我们调试带来了一些便利,可以通过网页与板子进行交互,板子在没有显示屏的情况下,也可以作为一种方案来进行功能展示。

 

web服务器——boa

 

 

本文演示如何把boa移植到开发板上,boa 是一个小巧的web 服务器,可执行代码只有70KB,占用的系统资源少,速度快安全性能高。

 

boa官网:

www.boa.org

 

下载的版本:

boa-0.94.13.tar.gz

 

本片文章关于web服务器地使用需要依赖于网络,可以参考我们上一篇笔记搭建开发板地WiFi环境:实用 | 如何远程登录开发板?。

 

boa交叉编译

下载得到boa-0.94.13.tar.gz,解压后进入boa-0.94.13/src目录,执行如下命令生成Makefile文件:

 

./configure

 

修改 Makefile, 设置交叉编译器 。找到 CC 和 CPP 变量 ,修改为:

 

CC = arm-linux-gnueabihf-gcc 
CPP = arm-linux-gnueabihf-gcc -E

 

执行make编译。编译报错如:

 

arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o response.o response.c
arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o select.o select.c
arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o signals.o signals.c
arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o util.o util.c
In file included from boa.h:50:0,
                 from util.c:26:
util.c: In function 'get_commonlog_time':
util.c:100:39: error: pasting "t" and "->" does not give a valid preprocessing token
         time_offset = TIMEZONE_OFFSET(t);
                                       ^
compat.h:120:30: note: in definition of macro 'TIMEZONE_OFFSET'
 #define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
                              ^~~
<内置>: recipe for target 'util.o' failed

 

把compat.h  文件里的:

 

#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff 

 

修改为:

 

#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff 

 

再次编译,可以编译通过则会在当前路径下生成boa可执行文件:

 

 

boa配置

把Ubuntu 的/etc 目录下的 mime.types 文件传到开发板的/etc目录下。注:这是MIME(多用途因特网邮件扩展),这是web服务器支持的规范。

 

在开发板/etc目录下创建boa文件夹(用于存放boa的配置文件及log文件):

cd /etc
mkdir boa

 

在开发板根目录下建立 www 文件夹  ,www 目录下面建立文件夹 cgi-bin 目录 (用于存放后期页面及交互代码):

mkdir -p /www/cgi-bin

 

把boa-0.94.13目录下的boa.conf 文件传到开发板的/etc/boa目录下。

scp boa.conf root@192.168.1.10:/etc/boa

 

把boa 可执行程序传到开发板的 bin 目录下 。

scp boa root@192.168.1.10:/bin

 

在开发板/etc目录下创建group文件:

cd /etc
touch group

 

在开发板上使用vi编辑器打开/etc/boa目录下的boa.conf文件,需要做如下修改:

① 把里面的Group nogroup 改为Group 0  。

②把ErrorLog  和 AccessLog 这两行, 指定 log 文件的路径,把log保存到/etc/boa目录下,修改如下:

ErrorLog /etc/boa/error_log
# Please NOTE: Sending the logs to a pipe ('|'), as shown below,
#  is somewhat experimental and might fail under heavy load.
# "Usual libc implementations of printf will stall the whole
#  process if the receiving end of a pipe stops reading."
#ErrorLog "|/usr/sbin/cronolog --symlink=/var/log/boa/error_log /var/log/boa/error-%Y%m%d.log"

# AccessLog: The location of the access log file. If this does not
# start with /, it is considered relative to the server root.
# Comment out or set to /dev/null (less effective) to disable
# Access logging.

AccessLog /etc/boa/access_log

③ 把#ServerName www.your.org.here这一行, 修改为ServerName www.your.org.here

# ServerName: the name of this server that should be sent back to
# clients if different than that returned by gethostname + gethostbyname

ServerName www.your.org.here

④ 然后找到DocumentRoot /var/www这一行, 修改为DocumentRoot /www

DocumentRoot /www

⑤ 然后找到ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/这一行, 修改为ScriptAlias /cgi-bin/ /www/cgi-bin/

ScriptAlias /cgi-bin/ /www/cgi-bin/

 

上面就是boa.conf配置文件需要修改的几点内容。

 

最后,进入我们前面创建的 www 目录, 然后使用 vi index.html 命令建立 index.html 网页文件进行测试,关于简单网页的设计大家可以上网搜一些教程。这里我们设计一个简单的网页如:

<html>
 <head>
  <title>
  boa服务器测试
  </title>
 </head>
 <body style="background-color:#000000;padding-left:300px; padding-top:100px;">
  <p style="color:white; text-align:left; width:190px; height:45px; font-size:30px; font-family:微软雅黑; padding-left:5px;">嵌入式大杂烩</p>
  <p style="color:red; font-size:20px; font-family:微软雅黑;">ZhengN</p>
  <p style="color:yellow; font-size:20px; font-family:微软雅黑; text-align:left;">本公众号专注于嵌入式技术,包括但不限于C/C++、嵌入式、物联网、Linux。</p>
 </body>
</html>

 

保存并退出 index.html。到了这一步我们的web服务器就大致搭建完成了,服务器上有一个简单的网页文件index.html。

 

下面进行简单的测试:

 

在我们的开发板上输入boa 命令启动 web 服务器 。

 

输入 如下命令查看boa程序是否启动成功:

 

ps - e | grep "boa"

 

boa 进程启动成功后,在浏览器中输入我们开发板的 IP 地址就可以访问到 index.html 网页:

 

 

可见,我们可以通过浏览器访问我们使用开发板搭建的web服务器上的网页,表明我们已经成功在开发板搭建了基于boa的web服务器。

 

本文只是简单地演示打通开发板web服务器环境并设计了一个简单地网页,后续我们再继续来探究如何通过网页来与我们地开发板进行交互,如:通过网页点亮开发板上地led、把开发板上地一些数据传到网页上进行显示等内容。