實(shí)用 | 10分鐘教你通過(guò)網(wǎng)頁(yè)點(diǎn)燈
大家好，我是ZhengN。
上一篇我們已經(jīng)基于我們的開(kāi)發(fā)板搭好了一個(gè)基于boa的web服務(wù)器：10分鐘教你搭建一個(gè)嵌入式web服務(wù)器。這一篇接著分享如何使用網(wǎng)頁(yè)來(lái)點(diǎn)燈。
網(wǎng)頁(yè)點(diǎn)燈的整個(gè)流程大致為：
從上到下，前面兩部分我們就是我們上一篇做的實(shí)驗(yàn)，已經(jīng)打通了。而第三部分就是本篇筆記的重點(diǎn)，我們要點(diǎn)燈，自然需要寫(xiě)一個(gè)程序來(lái)解析數(shù)據(jù)及進(jìn)行點(diǎn)燈操作，即這里的CGI程序。
什么是CGI?
CGI即通用網(wǎng)關(guān)接口(Common Gateway Interface)，是一個(gè)Web服務(wù)器主機(jī)提供信息服務(wù)的標(biāo)準(zhǔn)接口。通過(guò)CGI接口，Web服務(wù)器就能夠獲取客戶(hù)端提交的信息，轉(zhuǎn)交給服務(wù)器端的CGI程序進(jìn)行處理，最后返回結(jié)果給客戶(hù)端。
根據(jù)CGI標(biāo)準(zhǔn)，編寫(xiě)外部擴(kuò)展應(yīng)用程序，可以對(duì)客戶(hù)端瀏覽器輸入的數(shù)據(jù)進(jìn)行處理，完成客戶(hù)端與服務(wù)器的交互操作。CGI規(guī)范定義了Web服務(wù)器如何向擴(kuò)展應(yīng)用程序發(fā)送消息，在收到擴(kuò)展應(yīng)用程序的信息后又如何進(jìn)行處理等內(nèi)容。
一般情況下，服務(wù)器和CGI程序之間是通過(guò)標(biāo)準(zhǔn)輸入輸出來(lái)進(jìn)行數(shù)據(jù)傳遞的，CGI程序中的標(biāo)準(zhǔn)輸出stdout是經(jīng)過(guò)重定義了的，它并沒(méi)有在服務(wù)器上產(chǎn)生任何的輸出內(nèi)容，而是被重定向到客戶(hù)瀏覽器。
即我們的CGI程序是在我們的板子服務(wù)器里運(yùn)行，但實(shí)際調(diào)用printf輸出信息時(shí)并不會(huì)輸出到我們的板子終端，而是輸出到客戶(hù)端瀏覽器。
CGI程序小例子
CGI程序可以使用多種語(yǔ)言來(lái)實(shí)現(xiàn)，這里我們選用我們比較熟悉的C語(yǔ)言來(lái)實(shí)現(xiàn)。先來(lái)看一個(gè)簡(jiǎn)單的示例：
「test.c：」
- #include <stdio.h>
- int main()
- {
- printf("Content-type: text/html\n\n") ; // 這一句是必須的，設(shè)定輸出到HTML
- printf("Hello CGI\n") ;
- return 0;
- }
利用交叉編譯工具，編譯上述文件：
- arm-linux-gnueabihf-gcc test.c -o test.cgi
把test.cgi程序傳到開(kāi)發(fā)板上的/www/cgi-bin目錄
- scp test.cgi root@192.168.1.8:/www/cgi-bin
修改權(quán)限;
- chmod 777 test.cgi
瀏覽器進(jìn)行訪(fǎng)問(wèn)：
- http://192.168.1.8/www/cgi-bin/test.cgi
網(wǎng)頁(yè)點(diǎn)燈
我們已經(jīng)知道了CGI程序是什么了。下面我們來(lái)進(jìn)行網(wǎng)頁(yè)點(diǎn)燈。首先，需要說(shuō)明的是，我們有兩種方式來(lái)編寫(xiě)CGI程序。一種是借助環(huán)境變量來(lái)獲取相關(guān)信息;另一種是使用CGIC庫(kù)。
方法一：
對(duì)于CGI程序來(lái)說(shuō)，它繼承了系統(tǒng)的環(huán)境變量。CGI環(huán)境變量在CGI程序啟動(dòng)時(shí)初始化，在結(jié)束時(shí)銷(xiāo)毀。當(dāng)一個(gè)CGI程序不是被服務(wù)器調(diào)用時(shí)，它的環(huán)境變量幾乎是系統(tǒng)環(huán)境變量的復(fù)制。當(dāng)這個(gè)CGI程序被服務(wù)器調(diào)用時(shí)，它的環(huán)境變量就會(huì)多了以下關(guān)于服務(wù)器、客戶(hù)端、CGI傳輸過(guò)程等項(xiàng)目。如：
方法二：
用C語(yǔ)言寫(xiě)CGI程序還可以有比較簡(jiǎn)單的方式，那就是我們可以借助使用第三方庫(kù)CGIC(CGIC是一個(gè)功能比較強(qiáng)大的支持CGI開(kāi)發(fā)的標(biāo)準(zhǔn)C庫(kù)，并支持Linux, Unix 和Windows等多操作系統(tǒng))來(lái)編寫(xiě)，省去了必須自己去遵循CGI規(guī)范來(lái)編碼的痛苦。
CGIC庫(kù)下載地址：
https://github.com/boutell/cgic
這里只是簡(jiǎn)單地介紹了兩種方法。還不理解沒(méi)關(guān)系，下面我們通過(guò)具體的實(shí)例來(lái)認(rèn)識(shí)這兩種方法。
首先，我們需要點(diǎn)燈，自然需要先設(shè)計(jì)一個(gè)簡(jiǎn)單的led.html網(wǎng)頁(yè)。我們要通過(guò)網(wǎng)頁(yè)控制開(kāi)發(fā)板上的led，需要兩條信息：led的序號(hào)及l(fā)ed的狀態(tài)。在網(wǎng)上找到了現(xiàn)成的html代碼，稍微修改一下就直接拿來(lái)用了(文末給出參考的博客)。
led.html：
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <title>led control</title>
- </head>
- <body>
- <h1 align="center">基于ARM的web控制LED燈</h1>
- <!--新建一個(gè)表單，動(dòng)作鏈接到開(kāi)發(fā)板的/cgi-bin/led.cgi，采用的方法為GET-->
- <form action="/cgi-bin/led.cgi" method="get">
- <p align="center">Web端的led的控制測(cè)試</p>
- <p align="center">請(qǐng)輸入需要控制的led <input type="text" name="led_num"/></p>
- <p align="center">請(qǐng)輸入控制led的動(dòng)作 <input type="text" name="led_state"/></p>
- <p align="center"><input type="submit" value="sure"/>
- <input type="reset" value="back"/>
- </p>
- </form>
- </body>
- </html>
把led.html放到我們開(kāi)發(fā)板上的/www/中，通過(guò)瀏覽器訪(fǎng)問(wèn)：
- http://192.168.1.8/led.html
實(shí)際效果如：
下面我們編寫(xiě)我們的CGI程序。
「方法一：借助環(huán)境變量來(lái)獲取相關(guān)信息?！?/strong>
- #include<stdio.h>
- #include <stdlib.h>
- #include <sys/types.h>
- #include <sys/stat.h>
- #include <fcntl.h>
- #include <unistd.h>
- #include <sys/ioctl.h>
- #include <linux/limits.h>
- #include <errno.h>
- int main(int argc, const char *argv[])
- {
- int led_num,led_state;
- char *data;
- printf("Content-type: text/html;charset=utf-8\n\n");
- printf("<html>\n");
- printf("<head><title>cgi control led web</title></head>\n");
- printf("<body>\n");
- printf("<p>led is setted successful! you can watch the led's change</p>\n");
- printf("<p><a herf=led.html><button>get back</button></a></p>\n");
- printf("</body>\n");
- data = getenv("QUERY_STRING"); //getenv()讀取環(huán)境變量的當(dāng)前值的函數(shù)
- if(sscanf(data, "led_num=%d&led_state=%d", &led_num, &led_state) != 2)
- { //利用sscnaf（）函數(shù)的特點(diǎn)將環(huán)境變量分別提取出led_num和led_state這兩個(gè)值
- printf("<p>please input right");
- printf("</p>");
- }
- printf("<p>led_num = %d,led_state = %d</p>", led_num, led_state);
- if(led_num < 2 || led_num > 5)
- {
- printf("<p>Please input 2<=led_num<=5!");
- printf("</p>");
- }
- if(led_state>1)
- {
- printf("<p>Please input 0<=led_state<=1!");
- printf("</p>");
- }
- printf("</html>\n");
- return 0;
- }
這里的getenv函數(shù)就是獲取環(huán)境變量當(dāng)前值的函數(shù)，其中，各環(huán)境變量的意義可以參考上面的表。這里的QUERY_STRING環(huán)境變量就是采用GET時(shí)所傳輸?shù)男畔?。在這個(gè)例子中就是：
- led_num=3&led_state=1
上面的CGI程序把收到網(wǎng)頁(yè)發(fā)送過(guò)來(lái)的led_num及l(fā)ed_state的至再使用printf返回至網(wǎng)頁(yè)中顯示。從網(wǎng)頁(yè)中也可以看到相關(guān)信息，整個(gè)流程也就打通了。
「方法二：使用CGIC庫(kù)?！?/strong>
第二種方法我們使用CGIC庫(kù)來(lái)編寫(xiě)我們的CGI程序。首先我們需要下載CGIC庫(kù)，下載地址如：
https://github.com/boutell/cgic
下載得到：
整個(gè)包的內(nèi)容不多，就幾個(gè)文件。其中：
- cgic.c 函數(shù)庫(kù)。
- capture.c 一個(gè)很簡(jiǎn)單的CGI例子。僅僅輸出兩行提示文字。
- cgictest.c 一個(gè)演示讀取form表單數(shù)據(jù)的CGI例子。
因?yàn)槲覀兊腃GI程序要運(yùn)行在我們的arm板中，當(dāng)然要交叉編譯，首先需要修改Makefile文件，需要修改如下幾處內(nèi)容：
「第①個(gè)修改點(diǎn)：」
- CFLAGS=-g -Wall
- CC=gcc
- AR=ar
- RANLIB=ranlib
- LIBS=-L./ -lcgic
修改為：
- CFLAGS=-g -Wall
- CC=arm-linux-gnueabihf-gcc
- AR=arm-linux-gnueabihf-ar
- RANLIB=arm-linux-gnueabihf-ranlib
- LIBS=-L./ -lcgic
「第②個(gè)修改點(diǎn)：」
- gcc cgictest.o -o cgictest.cgi ${LIBS}
修改為：
- arm-linux-gnueabihf-gcc cgictest.o -o cgictest.cgi ${LIBS}
「第③個(gè)修改點(diǎn)：」
- gcc capture.o -o capture ${LIBS}
修改為：
- arm-linux-gnueabihf-gcc cgictest.o -o cgictest.cgi ${LIBS} capture.o -o capture ${LIBS}
「第④個(gè)修改點(diǎn)：」
- gcc -D UNIT_TEST=1 cgic.c -o cgicunittest
修改為：
- arm-linux-gnueabihf-gcc -D UNIT_TEST=1 cgic.c -o cgicunittest
這里我的編譯器是arm-linux-gnueabihf-gcc，大家需根據(jù)自己的實(shí)際環(huán)境進(jìn)行修改。
make編譯得到cgictest.cgi及capture程序，大家可以自行傳到板子上進(jìn)行測(cè)試。下面我們?cè)谶@個(gè)文件夾下新曾一個(gè)led.c文件，用于編寫(xiě)我們的leg cgi程序：
- #include "cgic.h"
- // cgic程序以cgiMain作為入口點(diǎn), cgic的函數(shù)庫(kù)會(huì)自動(dòng)把cgiMain連接到相應(yīng)的main()上去
- int cgiMain()
- {
- char led_num[10];
- char led_state[10];
- cgiFormString("led_num", led_num, 10); // 從表單中的led_num字段獲取值存入到led_num
- cgiFormString("led_state", led_state, 10);// 從表單中的led_state字段獲取值存入到led_state
- cgiHeaderContentType("text/html"); // 設(shè)定輸出的內(nèi)容格式 這里我們要輸出HTML
- fprintf(cgiOut,"<title>LED Test</title>");
- fprintf(cgiOut,"<p>recv from arm:</p>");
- fprintf(cgiOut,"led_num: %s", led_num);
- fprintf(cgiOut,"<br>");
- fprintf(cgiOut,"led_state: %s", led_state);
- return 0;
- }
修改Makefile，把我們的led.c也加入編譯。編譯得到led.cgi，傳入到板子中的/www/cgi-bin文件夾下：
瀏覽器訪(fǎng)問(wèn)：
- http://192.168.1.8/led.html
led cgi程序可以正確地解析led_num及l(fā)ed_state。有了這兩個(gè)信息，我們就可以愉快地點(diǎn)燈了，這里沒(méi)有加上點(diǎn)燈相關(guān)地操作，大家可以自己加上。
以上就是本次關(guān)于網(wǎng)頁(yè)點(diǎn)燈的實(shí)戰(zhàn)筆記，如有錯(cuò)誤，歡迎指出，謝謝!
本文轉(zhuǎn)載自微信公眾號(hào)「嵌入式大雜燴」，可以通過(guò)以下二維碼關(guān)注。轉(zhuǎn)載本文請(qǐng)聯(lián)系嵌入式大雜燴公眾號(hào)。
