A simple web server mainly based on ideas from Jasper Schuurmans Netduino web server
Dependents: RdBlindsServer SpideyWallWeb RdGasUseMonitor
A fast and reliable web server for MBED! http://robdobson.com/2015/08/a-reliable-mbed-webserver/
It has a very neat way to implement REST commands and can serve files from local storage (on LPC1768 for instance) and from SD cards. It also has a caching facility which is particularly useful for serving files from local storage.
The server can be run in the main() thread (and has a sub-2ms response time if this is done) or in a mbed-rtos thread which increases the response time to (a still respectable) 30ms or so.
The latest project that uses this is here - https://developer.mbed.org/users/Bobty/code/SpideyWallWeb/
int main (void) { // Ethernet interface EthernetInterface::init(); // Connect ethernet EthernetInterface::connect(); // Init the web server pc.printf("Starting web server\r\n"); char* baseWebFolder = "/sd/"; // should be /sd/ for SDcard files - not used for local file system RdWebServer webServer; // Add commands to handle the home page and favicon webServer.addCommand("", RdWebServerCmdDef::CMD_LOCALFILE, NULL, "index.htm", true); webServer.addCommand("favicon.ico", RdWebServerCmdDef::CMD_LOCALFILE, NULL, NULL, true); // Add the lightwall control commands webServer.addCommand("name", RdWebServerCmdDef::CMD_CALLBACK, &lightwallGetSystemName); webServer.addCommand("clear", RdWebServerCmdDef::CMD_CALLBACK, &lightwallClear); webServer.addCommand("rawfill", RdWebServerCmdDef::CMD_CALLBACK, &lightwallRawFill); webServer.addCommand("fill", RdWebServerCmdDef::CMD_CALLBACK, &lightwallFill); webServer.addCommand("showleds", RdWebServerCmdDef::CMD_CALLBACK, &lightwallShowLeds); // Start the server webServer.init(WEBPORT, &led4, baseWebFolder); webServer.run(); } // Get system name - No arguments required char* lightwallGetSystemName(int method, char*cmdStr, char* argStr, char* msgBuffer, int msgLen, int contentLen, unsigned char* pPayload, int payloadLen, int splitPayloadPos) { // Perform any required actions here .... // ... // Return the system name return systemName; }
This server was originally based on a Netduino web server from Jasper Schuurmans but has been optimised for speed.
RdWebServer.h
- Committer:
- Bobty
- Date:
- 2015-08-31
- Revision:
- 23:0fc3d7b5e596
- Parent:
- 21:2dfb56648b93
- Child:
- 24:27800de38eab
File content as of revision 23:0fc3d7b5e596:
// RdWebServer - Simple Web Server for MBED // Copyright (C) Rob Dobson 2013-2015, MIT License // Inspired by Jasper Schuurmans multi-threaded web server for Netduino which now seems to have gone from ... // http://www.schuurmans.cc/multi-threaded-web-server-for-netduino-plus // More details at http://robdobson.com/2013/10/moving-my-window-shades-control-to-mbed/ #ifndef RD_WEB_SERVER #define RD_WEB_SERVER #include <vector> #include "mbed.h" #include "EthernetInterface.h" // Debug level #ifdef RDWEB_DEBUG #if (RDWEB_DEBUG > 3) #define RD_DBG(x, ...) std::printf("[RD_DBG: %s:%d]" x "\r\n", __FILE__, __LINE__, ##__VA_ARGS__); #else #define RD_DBG(x, ...) #endif #else #define RD_DBG(x, ...) #endif #ifdef RDWEB_DEBUG #if (RDWEB_DEBUG > 2) #define RD_INFO(x, ...) std::printf("[RD_INFO: %s:%d]" x "\r\n", __FILE__, __LINE__, ##__VA_ARGS__); #else #define RD_INFO(x, ...) #endif #else #define RD_INFO(x, ...) #endif #ifdef RDWEB_DEBUG #if (RDWEB_DEBUG > 1) #define RD_WARN(x, ...) std::printf("[RD_WARNING: %s:%d]" x "\r\n", __FILE__, __LINE__, ##__VA_ARGS__); #else #define RD_WARN(x, ...) #endif #else #define RD_WARN(x, ...) #endif #ifdef RDWEB_DEBUG #if (RDWEB_DEBUG > 0) #define RD_ERR(x, ...) std::printf("[RD_ERR: %s:%d]" x "\r\n", __FILE__, __LINE__, ##__VA_ARGS__); #else #define RD_ERR(x, ...) #endif #else #define RD_ERR(x, ...) #endif const int SUBST_MAX_FNAME_LEN = 40; // note local files on MBED are 8.3 but this might include other files extern RawSerial pc; class RdFileCacheEntry { public: RdFileCacheEntry(char* pFileName) { _bCacheValid = false; strncpy(_fileName, pFileName, SUBST_MAX_FNAME_LEN-1); _fileName[SUBST_MAX_FNAME_LEN-1] = '\0'; _pFileContent = NULL; } ~RdFileCacheEntry() { delete _pFileContent; } bool readLocalFileIntoCache(char* fileName); public: bool _bCacheValid; char _fileName[SUBST_MAX_FNAME_LEN]; char* _pFileContent; int _nFileLen; }; typedef char* (*CmdCallbackType)(int method, char*cmdStr, char* argStr, char* msgBuffer); class RdWebServerCmdDef { public: static const int CMD_LOCALFILE = 1; static const int CMD_CALLBACK = 2; static const int CMD_SDORUSBFILE = 3; RdWebServerCmdDef(char* pStr, int cmdType, CmdCallbackType callback, char* substFileName = NULL, bool bCacheIfPossible = false) { _pCmdStr = pStr; _cmdType = cmdType; _callback = callback; _substFileName[0] = '\0'; if (substFileName != NULL) { strncpy(_substFileName, substFileName, SUBST_MAX_FNAME_LEN); _substFileName[SUBST_MAX_FNAME_LEN-1] = '\0'; } _bCacheIfPossible = bCacheIfPossible; }; char* _pCmdStr; int _cmdType; CmdCallbackType _callback; char _substFileName[SUBST_MAX_FNAME_LEN]; bool _bCacheIfPossible; }; const int HTTPD_MAX_HDR_LENGTH = 255; // The FRDM-K64F has more memory than the LPC1768 so allow a larger buffer #ifdef MCU_MK64F12 const int HTTPD_MAX_REQ_LENGTH = 2048; #warning("TCP Request Length 2048") #else const int HTTPD_MAX_REQ_LENGTH = 1024; #warning("TCP Request Length 1024") #endif class RdWebServer { public : static const int METHOD_OTHER = 0; static const int METHOD_GET = 1; static const int METHOD_POST = 2; static const int METHOD_OPTIONS = 3; RdWebServer(); virtual ~RdWebServer(); bool init(int port, DigitalOut* pStatusLed, char* pBaseWebFolder); void run(); void addCommand(char* pCmdStr, int cmdType, CmdCallbackType callback = NULL, char* substFileName = NULL, bool cacheIfPossible = false); static unsigned char* getPayloadDataFromMsg(char* msgBuf); static int getPayloadLengthFromMsg(char* msgBuf); private : int _port; DigitalOut* _pStatusLed; TCPSocketServer _serverSocket; bool _initOk; std::vector<RdWebServerCmdDef*> _commands; std::vector<RdFileCacheEntry*> _cachedFiles; bool extractCmdArgs(char* buf, char* pCmdStr, int maxCmdStrLen, char* pArgStr, int maxArgStrLen); char* _pBaseWebFolder; char _httpHeader[HTTPD_MAX_HDR_LENGTH+1]; char _buffer[HTTPD_MAX_REQ_LENGTH+1]; bool handleLocalFileRequest(char* cmdStr, char* argStr, TCPSocketConnection &client, bool bCacheIfPossible); bool handleSDFileRequest(char* cmdStr, char* argStr, TCPSocketConnection &client); void handleCGIRequest(char* pUriStr, char* pQueryStr); void sendFromCache(RdFileCacheEntry* pCacheEntry, TCPSocketConnection &client); bool handleReceivedHttp(TCPSocketConnection &client); void formHTTPHeader(const char* rsltCode, const char* contentType, int contentLen); // Settings - see the constructor bool _blockingOnAccept; bool _blockingOnReceive; int _timeoutOnBlocking; bool _closeConnAfterSend; bool _closeConnOnReceiveFail; }; #endif