最近在學(xué)習(xí) ETH 模塊,ETH 模塊具有 HTTP 服務(wù)的功能,我將在本帖中探討如何使用 HTTP 服務(wù)搭建一個(gè)本地 Web網(wǎng)站,并分享一些我所獲得的經(jīng)驗(yàn)。
1. HTTP介紹:
HTTP是超文本傳輸協(xié)議(HypertextTransfer Protocol)的縮寫,它是用于傳輸超文本(如 HTML)數(shù)據(jù)的應(yīng)用層協(xié)議。HTTP是萬(wàn)維網(wǎng)上數(shù)據(jù)通信的基礎(chǔ),它被用于在Web瀏覽器和Web服務(wù)器之間傳輸信息。
HTTP是一個(gè)無(wú)狀態(tài)協(xié)議,這意味著每個(gè)單獨(dú)的請(qǐng)求都是獨(dú)立的,服務(wù)器不會(huì)在多個(gè)請(qǐng)求之間保留任何數(shù)據(jù)。每個(gè)HTTP請(qǐng)求從客戶端(例如Web瀏覽器)發(fā)送到服務(wù)器,然后服務(wù)器返回一個(gè)響應(yīng)。這種請(qǐng)求-響應(yīng)模型使得客戶端可以從服務(wù)器獲取各種信息,如網(wǎng)頁(yè)、圖像、視頻等。
HTTP通常使用TCP作為其傳輸層協(xié)議,通過(guò)使用標(biāo)準(zhǔn)端口號(hào)80進(jìn)行通信(HTTPS使用端口號(hào)443)。近年來(lái),隨著對(duì)安全性的需求增加,基于HTTP的加密版本HTTPS也變得越來(lái)越普遍,它通過(guò)使用SSL/TLS協(xié)議來(lái)加密數(shù)據(jù)傳輸,確保數(shù)據(jù)的機(jī)密性和完整性。
HTTP服務(wù)特點(diǎn):
HTTP服務(wù)具有以下幾個(gè)主要特點(diǎn):
1. 無(wú)連接:HTTP是一種無(wú)連接的協(xié)議,即每個(gè)請(qǐng)求和響應(yīng)之間都是獨(dú)立的,服務(wù)器不會(huì)保留關(guān)于客戶端的任何狀態(tài)信息。這種無(wú)連接的特性使得服務(wù)器能夠更有效地處理大量的并發(fā)請(qǐng)求。
2. 無(wú)狀態(tài):HTTP是一種無(wú)狀態(tài)的協(xié)議,即服務(wù)器不會(huì)在請(qǐng)求之間保留任何狀態(tài)信息。每個(gè)請(qǐng)求都是獨(dú)立的,服務(wù)器不會(huì)記住之前的請(qǐng)求信息。這種設(shè)計(jì)簡(jiǎn)化了服務(wù)器的管理和維護(hù),但也意味著服務(wù)器無(wú)法跟蹤客戶端的狀態(tài),需要使用其他機(jī)制來(lái)實(shí)現(xiàn)狀態(tài)管理,如使用Cookies或Session。
3. 簡(jiǎn)單靈活:HTTP的設(shè)計(jì)簡(jiǎn)單且靈活,易于實(shí)現(xiàn)和使用。它使用文本格式的請(qǐng)求和響應(yīng)消息,易于調(diào)試和理解。同時(shí),HTTP也支持多種不同的請(qǐng)求方法(如GET、POST、PUT、DELETE等),以及多種不同的內(nèi)容類型(如文本、圖像、音頻、視頻等),使得其適用于各種不同的應(yīng)用場(chǎng)景。
4. 基于請(qǐng)求-響應(yīng)模型:HTTP是基于請(qǐng)求-響應(yīng)模型的協(xié)議,即客戶端發(fā)送一個(gè)請(qǐng)求給服務(wù)器,服務(wù)器處理請(qǐng)求并返回一個(gè)響應(yīng)給客戶端。這種模型使得客戶端能夠從服務(wù)器獲取各種信息,如網(wǎng)頁(yè)、圖像、視頻等。
5. 支持多媒體內(nèi)容:HTTP不僅可以傳輸文本數(shù)據(jù)(如HTML),還可以傳輸圖像、視頻、音頻等多媒體內(nèi)容。這使得互聯(lián)網(wǎng)上的各種資源可以通過(guò)HTTP服務(wù)進(jìn)行傳輸和訪問(wèn)。
6. 基于TCP協(xié)議:HTTP通常使用TCP作為其傳輸層協(xié)議,通過(guò)使用標(biāo)準(zhǔn)端口號(hào)80進(jìn)行通信(HTTPS使用端口號(hào)443)。TCP協(xié)議提供了可靠的數(shù)據(jù)傳輸機(jī)制,確保數(shù)據(jù)的可靠性和完整性。
綜上所述,HTTP服務(wù)具有無(wú)連接、無(wú)狀態(tài)、簡(jiǎn)單靈活等特點(diǎn),適用于各種不同的應(yīng)用場(chǎng)景,是互聯(lián)網(wǎng)上數(shù)據(jù)通信的基礎(chǔ)。
LWIP1.4.1的HTTP服務(wù)介紹
lwIP(lightweight IP)是一個(gè)輕量級(jí)的開(kāi)源TCP/IP協(xié)議棧,用于嵌入式系統(tǒng)和小型設(shè)備。lwIP1.4.1版本中包含了一個(gè)簡(jiǎn)單的HTTP服務(wù)器,可以用于在嵌入式設(shè)備上搭建基本的Web服務(wù)器。
lwIP1.4.1版本的HTTP服務(wù)器具有以下特點(diǎn):
1.輕量級(jí):lwIP是一個(gè)輕量級(jí)的TCP/IP協(xié)議棧,適用于資源受限的嵌入式系統(tǒng)和小型設(shè)備。其HTTP服務(wù)器也是精簡(jiǎn)設(shè)計(jì),適合在資源有限的環(huán)境下運(yùn)行。
2.基于C語(yǔ)言:lwIP的HTTP服務(wù)器是用C語(yǔ)言編寫的,易于移植和集成到各種嵌入式系統(tǒng)中。
3.支持基本功能:lwIP的HTTP服務(wù)器支持基本的HTTP功能,如處理GET請(qǐng)求、發(fā)送靜態(tài)內(nèi)容(如HTML頁(yè)面、圖像等)、處理簡(jiǎn)單的動(dòng)態(tài)內(nèi)容等。
4.定制化:雖然lwIP的HTTP服務(wù)器功能相對(duì)簡(jiǎn)單,但可以根據(jù)需要進(jìn)行定制和擴(kuò)展,以滿足特定應(yīng)用場(chǎng)景的需求。
5.適用性:lwIP的HTTP服務(wù)器適用于嵌入式設(shè)備上需要提供簡(jiǎn)單Web服務(wù)的場(chǎng)景,如遠(yuǎn)程監(jiān)控、配置管理、固件升級(jí)等。
總的來(lái)說(shuō),lwIP1.4.1版本的HTTP服務(wù)器是一個(gè)簡(jiǎn)單而實(shí)用的工具,適合在資源受限的嵌入式系統(tǒng)中搭建基本的Web服務(wù)器功能。
2. 本地 Web 服務(wù)器搭建的步驟
1.新建工程,移植lwip庫(kù),并包含其所需要的組件。
2.準(zhǔn)備一些html文件,用于界面顯示和控制。
3. 使用makefsdata將html 文件轉(zhuǎn)化為c語(yǔ)言數(shù)組形式。(附件含 makefsdata工具)
首先打開(kāi)makefsdata目錄,新建fs文件夾。
把準(zhǔn)備好的文件復(fù)制到fs文件夾中。
退回上一級(jí)目錄,即makefsdata根目錄下,打開(kāi)cmd,輸入“makefsdata“,即可把fs文件夾中的html文件轉(zhuǎn)化為fsdata.c文件,該文件包含了其轉(zhuǎn)化后的c語(yǔ)言數(shù)組。
生成的 fsdata.c 文件,就是我們需要的源文件。
這樣我們的基礎(chǔ)文件數(shù)據(jù)就準(zhǔn)備好了。
4. 編寫httpd_cgi_ssi.c文件
HTTP的SSI和CGI介紹:
當(dāng)涉及到 Web 服務(wù)器上的動(dòng)態(tài)內(nèi)容處理時(shí),兩種常見(jiàn)的方法是Server Side Includes (SSI) 和 Common GatewayInterface(CGI)。
### 1. Server Side Includes (SSI):
SSI 是一種簡(jiǎn)單的動(dòng)態(tài)內(nèi)容生成技術(shù),它允許在 HTML 頁(yè)面中嵌入動(dòng)態(tài)內(nèi)容。SSI 在 HTML 文件中通過(guò)特殊的標(biāo)簽實(shí)現(xiàn),服務(wù)器在響應(yīng)客戶端請(qǐng)求時(shí)動(dòng)態(tài)地處理這些標(biāo)簽。
#### 如何使用SSI:
- SSI 標(biāo)簽通常以 結(jié)束。
- 常見(jiàn)的SSI指令包括:
- #include:包含其他文件的內(nèi)容。
- #echo:輸出環(huán)境變量或者其他值。
- #exec:執(zhí)行外部命令并將結(jié)果輸出。
- SSI 通常在服務(wù)器配置中啟用,并且需要指定哪些文件擴(kuò)展名應(yīng)該被解析為SSI。
#### 優(yōu)點(diǎn):
- 簡(jiǎn)單易用,無(wú)需編寫額外的代碼。
- 可以直接在 HTML 文件中嵌入動(dòng)態(tài)內(nèi)容,方便快捷。
#### 缺點(diǎn):
- 功能有限,主要用于簡(jiǎn)單的動(dòng)態(tài)內(nèi)容生成。
- 對(duì)服務(wù)器性能有一定影響,因?yàn)樾枰诿總€(gè)請(qǐng)求中動(dòng)態(tài)解析處理SSI標(biāo)簽。
### 2. Common Gateway Interface (CGI):
CGI 是一種更為靈活和強(qiáng)大的動(dòng)態(tài)內(nèi)容生成技術(shù)。它允許服務(wù)器調(diào)用外部程序來(lái)處理客戶端請(qǐng)求,并生成動(dòng)態(tài)內(nèi)容。CGI程序可以用任何編程語(yǔ)言編寫,只要能夠通過(guò)標(biāo)準(zhǔn)輸入和輸出與 Web 服務(wù)器通信即可。
#### 如何使用CGI:
- CGI 程序通常位于 Web 服務(wù)器的特定目錄中(如`cgi-bin` 目錄)。
- 當(dāng)服務(wù)器收到客戶端請(qǐng)求時(shí),會(huì)調(diào)用相應(yīng)的 CGI 程序來(lái)處理請(qǐng)求,并將結(jié)果返回給客戶端。
- CGI 程序通過(guò)環(huán)境變量獲取客戶端請(qǐng)求信息,并通過(guò)標(biāo)準(zhǔn)輸出返回動(dòng)態(tài)生成的內(nèi)容。
#### 優(yōu)點(diǎn):
- 靈活多樣,可以使用各種編程語(yǔ)言編寫CGI 程序。
- 可以處理復(fù)雜的動(dòng)態(tài)內(nèi)容生成需求,如表單處理、數(shù)據(jù)庫(kù)查詢等。
#### 缺點(diǎn):
- 比較復(fù)雜,需要編寫額外的程序。
- 對(duì)服務(wù)器性能影響較大,每個(gè) CGI請(qǐng)求都需要啟動(dòng)一個(gè)新的進(jìn)程來(lái)處理。
綜上所述,SSI 適用于簡(jiǎn)單的動(dòng)態(tài)內(nèi)容生成需求,而CGI 則更適合處理復(fù)雜的動(dòng)態(tài)內(nèi)容生成任務(wù)。選擇哪種方法取決于具體的需求和服務(wù)器環(huán)境。
在了解這些之后,我們看看下面編寫的httpd_cgi_ssi.c文件源碼。
#include"lwip/debug.h"
#include"httpd.h"
#include"lwip/tcp.h"
#include"fs.h"
#include"main.h"
#include"Board.h"
#include
#include
tSSIHandlerADC_Page_SSI_Handler;
uint32_tADC_not_configured=1;
/* wewill use character "t" as tag for CGI */
charconst* TAGCHAR="t";
charconst** TAGS=&TAGCHAR;
/*CGI handler for LED control */
constchar * LEDS_CGI_Handler(int iIndex, int iNumParams, char *pcParam[], char*pcValue[]);
/*Html request for "/leds.cgi" will start LEDS_CGI_Handler */
consttCGI LEDS_CGI={"/leds.cgi", LEDS_CGI_Handler};
/*Cgi call table, only one CGI used */
tCGICGI_TAB[1];
/**
*[url=home.php?mod=space&uid=247401]@brief[/url] Configures the ADC.
* @paramNone
* @retval None
*/
staticvoid ADC_Configuration(void)
{
ADC_Config_TadcConfig;
ADC_CommonConfig_TadcCommonConfig;
GPIO_Config_TgpioConfig;
RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_ADC3);
RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOF);
gpioConfig.pin= GPIO_PIN_9;
gpioConfig.mode= GPIO_MODE_AN;
gpioConfig.pupd= GPIO_PUPD_NOPULL;
GPIO_Config(GPIOF,&gpioConfig);
ADC_CommonConfigStructInit(&adcCommonConfig);
adcCommonConfig.mode= ADC_MODE_INDEPENDENT;
adcCommonConfig.prescaler= ADC_PRESCALER_DIV6;
adcCommonConfig.accessMode= ADC_ACCESS_MODE_DISABLED;
adcCommonConfig.twoSampling= ADC_TWO_SAMPLING_5CYCLES;
ADC_CommonConfig(&adcCommonConfig);
ADC_ConfigStructInit(&adcConfig);
adcConfig.resolution= ADC_RESOLUTION_12BIT;
adcConfig.scanConvMode= DISABLE;
adcConfig.continuousConvMode= ENABLE;
adcConfig.extTrigEdge= ADC_EXT_TRIG_EDGE_NONE;
adcConfig.dataAlign= ADC_DATA_ALIGN_RIGHT;
adcConfig.nbrOfChannel= 1;
ADC_Config(ADC3,&adcConfig);
ADC_ConfigRegularChannel(ADC3,ADC_CHANNEL_7,1,ADC_SAMPLETIME_56CYCLES);
ADC_Enable(ADC3);
/*ADC3 regular Software Start Conv */
ADC_SoftwareStartConv(ADC3);
}
/**
* [url=home.php?mod=space&uid=247401]@brief[/url] ADC_Handler : SSI handler for ADC page
*/
u16_tADC_Handler(int iIndex, char *pcInsert, int iInsertLen)
{
/* We have only one SSI handler iIndex = 0 */
if (iIndex ==0)
{
charDigit1=0, Digit2=0, Digit3=0, Digit4=0;
uint32_tADCVal = 0;
/* configure ADC if not yet configured */
if (ADC_not_configured ==1)
{
ADC_Configuration();
ADC_not_configured=0;
}
/* get ADC conversion value */
ADCVal = ADC_ReadConversionValue(ADC3);
/* convert to Voltage, step = 0.8 mV */
ADCVal = (uint32_t)(ADCVal * 0.8);
printf("ADC Value: %d ",ADCVal);
/* get digits to display */
Digit1= ADCVal/1000;
Digit2= (ADCVal-(Digit1*1000))/100 ;
Digit3=(ADCVal-((Digit1*1000)+(Digit2*100)))/10;
Digit4= ADCVal -((Digit1*1000)+(Digit2*100)+(Digit3*10));
/* prepare data to be inserted in html */
*pcInsert= (char)(Digit1+0x30);
*(pcInsert + 1) = (char)(Digit2+0x30);
*(pcInsert + 2) = (char)(Digit3+0x30);
*(pcInsert + 3) = (char)(Digit4+0x30);
/* 4characters need to be inserted in html*/
return4;
}
return 0;
}
/**
*[url=home.php?mod=space&uid=247401]@brief[/url] CGI handler for LEDs control
*/
constchar * LEDS_CGI_Handler(int iIndex, int iNumParams, char *pcParam[], char*pcValue[])
{
uint32_t i=0;
/* We have only one SSI handler iIndex = 0 */
if (iIndex==0)
{
/*All leds off */
APM_TINY_LEDOff(LED2);
APM_TINY_LEDOff(LED3);
/*Check cgi parameter : example GET /leds.cgi?led=2&led=4 */
for(i=0; i
{
/* check parameter "led" */
if (strcmp(pcParam[i] ,"led")==0)
{
/*switch led2 ON if 2 */
if(strcmp(pcValue[i],"2") ==0)
APM_TINY_LEDOn(LED2);
/*switch led3 ON if 3 */
elseif(strcmp(pcValue[i], "3") ==0)
APM_TINY_LEDOn(LED3);
}
}
}
/* uri to send after cgi call*/
return "/APM32F407LED.html";
}
/**
* Initialize SSI handlers
*/
voidhttpd_ssi_init(void)
{
/* configure SSI handlers (ADC page SSI) */
http_set_ssi_handler(ADC_Handler, (char const**)TAGS, 1);
}
/**
* Initialize CGI handlers
*/
voidhttpd_cgi_init(void)
{
/* configure CGI handlers (LEDs control CGI)*/
CGI_TAB[0] = LEDS_CGI;
http_set_cgi_handlers(CGI_TAB, 1);
}
這段代碼是一個(gè)基于lwIP(LightweightIP)的HTTP服務(wù)器的實(shí)現(xiàn),它允許通過(guò)網(wǎng)頁(yè)控制單片機(jī)上的LED,并且能夠?qū)崟r(shí)獲取ADC(模數(shù)轉(zhuǎn)換器)的值并顯示在網(wǎng)頁(yè)上。讓我們逐個(gè)分析每個(gè)函數(shù)及其功能:
- ADC_Configuration():
- 這個(gè)函數(shù)配置了微控制器的ADC模塊,使其準(zhǔn)備好進(jìn)行模擬信號(hào)的數(shù)字化轉(zhuǎn)換。
- 配置了ADC3通道7,并啟動(dòng)了ADC轉(zhuǎn)換。
-ADC_Handler():
- 這個(gè)函數(shù)是SSI(Server Side Include)的處理函數(shù),用于處理ADC頁(yè)面的SSI標(biāo)簽。
- 它讀取ADC轉(zhuǎn)換的值,將其轉(zhuǎn)換為電壓值,并將其插入到HTML頁(yè)面的指定位置。
- 該函數(shù)返回要插入的字符數(shù)量。
-LEDS_CGI_Handler():
- 這個(gè)函數(shù)是CGI(Common Gateway Interface)的處理函數(shù),用于處理LED控制的CGI請(qǐng)求。
- 它檢查CGI參數(shù),根據(jù)參數(shù)設(shè)置LED的狀態(tài)(開(kāi)或關(guān))。
- 返回一個(gè)字符串,指示CGI調(diào)用完成后應(yīng)該跳轉(zhuǎn)的頁(yè)面。
- httpd_ssi_init():
- 這個(gè)函數(shù)初始化SSI處理程序,將ADC頁(yè)面的SSI處理函數(shù)注冊(cè)到HTTP服務(wù)器。
-httpd_cgi_init():
- 這個(gè)函數(shù)初始化CGI處理程序,將LED控制的CGI處理函數(shù)注冊(cè)到HTTP服務(wù)器。
總體來(lái)說(shuō),這段代碼實(shí)現(xiàn)了一個(gè)基本的HTTP服務(wù)器,可以通過(guò)網(wǎng)頁(yè)界面控制LED,并實(shí)時(shí)顯示ADC轉(zhuǎn)換的值。通過(guò)SSI和CGI,可以動(dòng)態(tài)地生成網(wǎng)頁(yè)內(nèi)容,并實(shí)現(xiàn)與單片機(jī)硬件的交互。
5.編寫main函數(shù)
intmain(void)
{
charLCDDisplayBuf[100] = {0};
structip_addr DestIPaddr;
uint8_tflag = 0;
USART_Config_TusartConfig;
/*User config the different system Clock */
UserRCMClockConfig();
/*Configure SysTick */
ConfigSysTick();
/*Configure USART */
usartConfig.baudRate= 115200;
usartConfig.wordLength= USART_WORD_LEN_8B;
usartConfig.stopBits= USART_STOP_BIT_1;
usartConfig.parity= USART_PARITY_NONE ;
usartConfig.mode= USART_MODE_TX_RX;
usartConfig.hardwareFlow= USART_HARDWARE_FLOW_NONE;
APM_BOARD_COMInit(COM1,&usartConfig);
/*Configures LED2 and LED3 */
APM_BOARD_LEDInit(LED2);
APM_BOARD_LEDInit(LED3);
/*KEY init*/
APM_BOARD_PBInit(BUTTON_KEY1,BUTTON_MODE_GPIO);
APM_BOARD_PBInit(BUTTON_KEY2,BUTTON_MODE_GPIO);
printf("Thisis a Demo! ");
/*Configure ethernet (GPIOs, clocks, MAC, DMA) */
ConfigEthernet();
/*Initilaize the LwIP stack */
LwIP_Init();
httpd_init();
/*Use Com printf static IP address*/
sprintf(LCDDisplayBuf,"TINYboard Static IP address ");
printf("%s",LCDDisplayBuf);
sprintf(LCDDisplayBuf,"IP:%d.%d.%d.%d ",
IP_ADDR0,
IP_ADDR1,
IP_ADDR2,
IP_ADDR3);
printf("%s",LCDDisplayBuf);
sprintf(LCDDisplayBuf,"NETMASK:%d.%d.%d.%d ",
NETMASK_ADDR0,
NETMASK_ADDR1,
NETMASK_ADDR2,
NETMASK_ADDR3);
printf("%s",LCDDisplayBuf);
sprintf(LCDDisplayBuf,"Gateway:%d.%d.%d.%d ",
GW_ADDR0,
GW_ADDR1,
GW_ADDR2,
GW_ADDR3);
printf("%s",LCDDisplayBuf);
while(1)
{
/*check if any packet received */
if(ETH_CheckReceivedFrame())
{
/*process received ethernet packet */
LwIP_Pkt_Handle();
}
/*handle periodic timers for LwIP */
LwIP_Periodic_Handle(ETHTimer);
}
}
6.配置開(kāi)發(fā)板靜態(tài)IP地址
3. 實(shí)驗(yàn)現(xiàn)象:
1.用以太網(wǎng)接口線,連接開(kāi)發(fā)板與PC端,打開(kāi)瀏覽器,輸入開(kāi)發(fā)板的IP地址,進(jìn)入網(wǎng)頁(yè)端。
2.在網(wǎng)頁(yè)端點(diǎn)擊Led control,跳轉(zhuǎn)到led控制界面。
3.點(diǎn)擊ADC StatusBar,跳轉(zhuǎn)到ADC采集界面。
-
嵌入式
+關(guān)注
關(guān)注
5082文章
19115瀏覽量
304925 -
Web
+關(guān)注
關(guān)注
2文章
1263瀏覽量
69451 -
服務(wù)器
+關(guān)注
關(guān)注
12文章
9138瀏覽量
85369 -
HTTP
+關(guān)注
關(guān)注
0文章
505瀏覽量
31204
原文標(biāo)題:APM32芯得 EP.49 | 探索使用以太網(wǎng)(ETH),搭建一個(gè)簡(jiǎn)單的本地HTTP服務(wù)器
文章出處:【微信號(hào):geehysemi,微信公眾號(hào):Geehy極海半導(dǎo)體】歡迎添加關(guān)注!文章轉(zhuǎn)載請(qǐng)注明出處。
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論