The library with which to make your mbed a HTTP Server which just reads HTML files in the mbed and sends it to the clients.
Dependents: httpserversample SIMPLE_WSS
Quote:
This library depends on EthernetInterface class, TCPSocketServer class and TCPSocketConnection class. These classes can be imported at EthernetInterface library. Moreover, the EthernetInterface library depends on the mbed-rtos library, so import it here.
Abstract
This is the library to make a mbed a simple HTTP server. With this library, a mbed can understand only GET requests, and can send clients htm or jpg files as a response.
Handleable Requests:
- GET
Handleable files:
- html
- jpg
Note the length of the Filename
A mbed can handle only 8.3 filename (also called as "short filename" or SFN), such as index.htm (in this case, length of the filename is 5.3).
Sample Code
Running the code below, if your mbed is connected to a network, you can see an IP address of the mbed on your console. (When connecting the mbed to a PC with USB, the baud rate should be 9600)
Hello World
#include "mbed.h" #include "HTTP_SERVER.h" int main() { HttpServer httpsvr; if(httpsvr.init()){ if(httpsvr.run() == 0) printf("end\r\n"); else printf("error end\r\n"); } return 0; }
As an example, make a index.htm like below (NOT .html; the reason is referred above) in the mbed, and access to <the IP address>/index.htm with a web browser on your PC or any terminals on the network the mbed is connected to, then you would be able to see the page.
index.htm in mbed
<!DOCTYPE html> <html> <head> <title>mbed http server demo</title> </head> <body> <h1>Mbed Simple HTTP Server</h1> hello world<br /> <a href="./index.htm" terget="self">Hyper Link Test</a><br /> </body> </html>
HTTP_SERVER.h@12:cbf97b865d76, 2018-03-16 (annotated)
- Committer:
- aktk
- Date:
- Fri Mar 16 21:50:43 2018 +0000
- Revision:
- 12:cbf97b865d76
- Parent:
- 9:84aca9965f9f
modified the type of req_buf[1024] : char* -> char; ; I have no idea why the type was pointer of array. whichever the type is, the program work well somewhat, anyway.
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
aktk | 0:cc483bea4fe3 | 1 | //HTTP_SERVER.h |
aktk | 0:cc483bea4fe3 | 2 | #ifndef HTTP_SERVER_H |
aktk | 0:cc483bea4fe3 | 3 | #define HTTP_SERVER_H |
aktk | 0:cc483bea4fe3 | 4 | #include "mbed.h" |
aktk | 0:cc483bea4fe3 | 5 | #include "EthernetInterface.h" |
aktk | 0:cc483bea4fe3 | 6 | #include "ResponseMessenger.h" |
aktk | 0:cc483bea4fe3 | 7 | #include "FileHandler.h" |
aktk | 0:cc483bea4fe3 | 8 | #include "string.h" |
aktk | 0:cc483bea4fe3 | 9 | #include <stdlib.h> |
aktk | 0:cc483bea4fe3 | 10 | using namespace std; |
aktk | 0:cc483bea4fe3 | 11 | |
aktk | 0:cc483bea4fe3 | 12 | enum PortNum { |
aktk | 0:cc483bea4fe3 | 13 | TCP_PORT = 80 |
aktk | 0:cc483bea4fe3 | 14 | }; |
aktk | 9:84aca9965f9f | 15 | /** HttpServer class |
aktk | 9:84aca9965f9f | 16 | * |
aktk | 9:84aca9965f9f | 17 | * This is the class to make a mbed a simple HTTP Server. |
aktk | 9:84aca9965f9f | 18 | */ |
aktk | 0:cc483bea4fe3 | 19 | class HttpServer |
aktk | 0:cc483bea4fe3 | 20 | { |
aktk | 0:cc483bea4fe3 | 21 | public: |
aktk | 0:cc483bea4fe3 | 22 | HttpServer(); |
aktk | 0:cc483bea4fe3 | 23 | ~HttpServer(); |
aktk | 9:84aca9965f9f | 24 | /** HTTP SERVER Initialization. |
aktk | 9:84aca9965f9f | 25 | * |
aktk | 9:84aca9965f9f | 26 | * This function should be called first of all. |
aktk | 0:cc483bea4fe3 | 27 | * @return result of init() as boolean. |
aktk | 0:cc483bea4fe3 | 28 | * @retval TRUE SACCESS |
aktk | 0:cc483bea4fe3 | 29 | * @retval FALSE |
aktk | 0:cc483bea4fe3 | 30 | */ |
aktk | 0:cc483bea4fe3 | 31 | bool init(); |
aktk | 9:84aca9965f9f | 32 | /** Run the surver service while listening flag is true. |
aktk | 9:84aca9965f9f | 33 | * |
aktk | 0:cc483bea4fe3 | 34 | * @return state ending. |
aktk | 0:cc483bea4fe3 | 35 | * @retval TRUE at error end. |
aktk | 0:cc483bea4fe3 | 36 | * @retval FALSE at normal end. |
aktk | 0:cc483bea4fe3 | 37 | */ |
aktk | 0:cc483bea4fe3 | 38 | bool run(); |
aktk | 0:cc483bea4fe3 | 39 | |
aktk | 0:cc483bea4fe3 | 40 | private: |
aktk | 0:cc483bea4fe3 | 41 | // Handlers |
aktk | 0:cc483bea4fe3 | 42 | EthernetInterface eth; // Eternet |
aktk | 0:cc483bea4fe3 | 43 | TCPSocketServer tcpsvr; // TCP server |
aktk | 0:cc483bea4fe3 | 44 | TCPSocketConnection tcpcon; // TCP server connection clerk |
aktk | 0:cc483bea4fe3 | 45 | ResponseMessenger msger; // Messenger for a client |
aktk | 0:cc483bea4fe3 | 46 | FileHandler fhandl; // |
aktk | 0:cc483bea4fe3 | 47 | // Param |
aktk | 0:cc483bea4fe3 | 48 | bool keep_alive; |
aktk | 0:cc483bea4fe3 | 49 | bool listening_flag; |
aktk | 12:cbf97b865d76 | 50 | char req_buf[1024]; |
aktk | 0:cc483bea4fe3 | 51 | }; |
aktk | 0:cc483bea4fe3 | 52 | |
aktk | 0:cc483bea4fe3 | 53 | #endif |