Ryo Iizuka / Mbed 2 deprecated MbedFileServer Featured

The program publishes files at local directory and SD filesystem. It is a full-fledged webServer somewhat.

Dependencies:   libMiMic mbed-rtos mbed NyFileSystems

English

This program is simple webserver to provides contents on local file system and SD card through HTTP to network. The application is demonstration of libMiMic library that includes uIP based TCP/IP stack and fast httpd server.

It has auto platform detection function. It works on mbed and LPCXpresso1769 both platform in the same binary.

/media/uploads/nyatla/this_server.jpg

Feature

  • Automatic platform detection. for mbed and LPCXpresso.
  • SD card/LlocalFileSystem support. LocalfileSystem is accessable when mbed. Otherwise ignored.
  • Mbed RTOS based Multithread.
  • Original TCP/IP stack(MiMicIP). It is based on uIP.
  • Fast HTTPD (HTTP/1.1 , Persistent connection , RTT<=10ms , Maximum throughput 8Mbps ,SDCard throughput 600Kbps , Chunked encoding, Maximum content size 4GB)
  • RAM usage 16KB+16KB(AHB SRAM - bank 0)
  • ROM 70KB

Demonstration

This is temporary demonstration website. Mmedwebserver demonstration.

The server hosted MiMicRemoteMCU-for-Mbed sample content. You can browse sample pages.

Getting started

  • Connect to mbed Ethernet connector. See also. (SD card is optional)
  • Import program to mbed Compiler and compile it.
  • Copy bin file to mbed.
  • Write configuration to "mimic.cfg" and save it to mbed local file system. (If nothing, Setting is 192.168.0.39,255.255.255.0,192.168.0.254,[mbed mac address]) See also

sample of mimic.cfg

ipaddr=192.168.0.40
netmask=255.255.255.0
gateway=192.168.0.254
macaddr=02:01:02:03:04:05

Any values can be omit. If omit elements,on-chip values is used.

  • Reset mbed.
  • Open "http://[address]/" via Browser(do not use Internet exproler!), You can browse index page.

Appendix

How to connect to SD card.

Check http://www.eleki-jack.com/arm/2010/12/mbed-5.html (Japanese) Maximum length of path name is 512 characters.

How to run on LPCXpresso1769.

MbedFileServer binary file is run on LPCXpresso as is. LocalFileSystem(semihosting SVC) is ignored and LAN peripheral is detected automatically. Mac Address and setting will be on-chip setting. If you want set configuration by file, connect SD card and save "mimic.cfg" to root directory.

日本語

このプログラムは、SDカードとmbedLocalFileSystemにあるファイルを公開するシンプルなWebサーバです。 このWebサーバはlibMiMicライブラリを使用した高速なHTTPDのデモンストレーションです。

MbedFileServerは実行時にmbedとLPCXpressoを自動で認識できます。mbedコンパイラで作成したバイナリファイルをそのままLPCXpressoで動作させることが出来ます。

/media/uploads/nyatla/this_server.jpg

仕様

  • 自動プラットフォーム認識機能(mbed ,LPCXpresso1769)
  • SDカード、 LlocalFileSystem サポート。(LocalFileSystemはmbedの時だけ使用できます。LPCXpressoでは無視されます。)
  • Mbed RTOS ベースのマルチスレッドが利用できます。
  • uIPベースの独自 TCP/IP stack(MiMicIP)を搭載しています。
  • 高速なHTTPDサーバを搭載しています。(HTTP/1.1 , 持続性接続 ,同時セッション数4, RTT<=10ms , 最大転送速度 8Mbps ,SDCard 経由の転送速度 600Kbps , Chunked encoding, 最大コンテンツ転送サイズ 4GB)
  • RAM使用量 16KB+16KB(AHB SRAM - bank 0)
  • ROM使用量 70KB

デモサイト

不定期でMiMicRemoteMCU-for-Mbedのデモサイトを公開しています。http://nyatla3939.no-ip.biz/sd/index.html

このデモサイトはSDカードに保存したコンテンツを、MbedFileServerでホストしています。

Getting started

  • mbedにイーサネットコネクタを接続します。参考。SDカードは無くても動きます。
  • プログラムをImportしてコンパイルします。
  • binファイルをmbedにインストールします。
  • 初期IPアドレスの設定ファイルを書いて、"mimic.cfg"の名前でmbedドライブのルートディレクトリに入れます。 (ファイルの無い場合の設定値は、192.168.0.39,255.255.255.0,192.168.0.254,[mbed内蔵MACアドレス]になります。)参考

mimic.cfg

ipaddr=192.168.0.40
netmask=255.255.255.0
gateway=192.168.0.254
macaddr=02:01:02:03:04:05

設定値は省略できます。省略した場合は、オンチップコンフィギュレーションの値が使われます。

追加資料

SDカードの接続方法

こちらの方法でお願いします。 SDカードのサブディレクトリには対応していますが、URLが512文字以上にならないようにしてください。

LPCXpresso1769で実行する場合

MbedFileServerのバイナリはそのままLPCXpresso1769で動作します。 LocalFileSystem(semihosting SVC) の無効化とLANペリフェラルの認識は起動時に自動的に行われます。 Mac Addressはオンチップコンフィギュレーションの値が設定されます。もしファイルによって値を変更したい場合は、SDカードを接続して、"mimic.cfg" をルートディレクトリに保存してください。

See also

main.cpp@10:80c05810f911, 2013-05-05 (annotated)

Committer:
nyatla
Date:
Sun May 05 03:32:31 2013 +0000
Revision:
10:80c05810f911
Parent:
6:20dcb08e1b43
Child:
12:218b57d9a6d4
update libMiMic; Add platform auto detection.; The completely same binary runs on mbed and LPCXpresso1769.;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
nyatla 4:0a280ed0a848 1 /**
nyatla 4:0a280ed0a848 2 * @file * This is ModLocalFileSystem sample program.
nyatla 4:0a280ed0a848 3 *
nyatla 4:0a280ed0a848 4 * <pre>
nyatla 4:0a280ed0a848 5 * 1. Compile this program and write to your mbed.
nyatla 4:0a280ed0a848 6 * 2. Write files for testing to mbed disk.
nyatla 4:0a280ed0a848 7 * 2. Access via web browser to http://192.168.0.39/local/<filename>
nyatla 4:0a280ed0a848 8 * 3. You can see <filename> file on browser.
nyatla 4:0a280ed0a848 9 * </pre>
nyatla 4:0a280ed0a848 10 */
nyatla 5:6a2a1644ea2c 11 #include "mbed.h"
nyatla 5:6a2a1644ea2c 12 #include "SDFileSystem.h"
nyatla 0:ec1e45489427 13 #include "mimic.h"
nyatla 10:80c05810f911 14 #include "utils/PlatformInfo.h"
nyatla 10:80c05810f911 15 DigitalOut mbedled(LED1);
nyatla 10:80c05810f911 16 DigitalOut lpcxled(P0_22);
nyatla 0:ec1e45489427 17
nyatla 3:77431c2bd9cb 18 /**
nyatla 3:77431c2bd9cb 19 * local filesystem support.
nyatla 3:77431c2bd9cb 20 */
nyatla 10:80c05810f911 21 LocalFileSystem2 lf("local");
nyatla 5:6a2a1644ea2c 22 SDFileSystem sd(p5, p6, p7, p8,"sd");
nyatla 6:20dcb08e1b43 23 unsigned int p;
nyatla 0:ec1e45489427 24 /**
nyatla 0:ec1e45489427 25 * MiMic RemoteMCU httpd.<br/>
nyatla 5:6a2a1644ea2c 26 * Number of simultaneous connections:4
nyatla 0:ec1e45489427 27 * <p>Service list</p>
nyatla 0:ec1e45489427 28 * <pre>
nyatla 0:ec1e45489427 29 * /local/ - mbed LocalFileSystem
nyatla 0:ec1e45489427 30 * </pre>
nyatla 0:ec1e45489427 31 */
nyatla 5:6a2a1644ea2c 32 class FsHttpd:public MiMic::Httpd
nyatla 0:ec1e45489427 33 {
nyatla 0:ec1e45489427 34 private:
nyatla 5:6a2a1644ea2c 35 ModLocalFileSystem modlocal;
nyatla 5:6a2a1644ea2c 36 ModLocalFileSystem modsd;
nyatla 0:ec1e45489427 37 public:
nyatla 5:6a2a1644ea2c 38 FsHttpd():Httpd(80)
nyatla 0:ec1e45489427 39 {
nyatla 3:77431c2bd9cb 40 //bind local file system path to /local/*
nyatla 5:6a2a1644ea2c 41 modlocal.setParam("local");
nyatla 5:6a2a1644ea2c 42 modsd.setParam("sd");
nyatla 0:ec1e45489427 43 }
nyatla 0:ec1e45489427 44 virtual void onRequest(HttpdConnection& i_connection)
nyatla 0:ec1e45489427 45 {
nyatla 6:20dcb08e1b43 46 p++;
nyatla 10:80c05810f911 47 switch(PlatformInfo::getPlatformType()){
nyatla 10:80c05810f911 48 case PlatformInfo::PF_MBED:
nyatla 10:80c05810f911 49 mbedled = p%2;
nyatla 10:80c05810f911 50 break;
nyatla 10:80c05810f911 51 case PlatformInfo::PF_LPCXPRESSO:
nyatla 10:80c05810f911 52 lpcxled = p%2;
nyatla 10:80c05810f911 53 break;
nyatla 10:80c05810f911 54 }
nyatla 5:6a2a1644ea2c 55 //try to ModLocalFileSystem
nyatla 5:6a2a1644ea2c 56 if(this->modlocal.execute(i_connection)){
nyatla 5:6a2a1644ea2c 57 return;
nyatla 5:6a2a1644ea2c 58 }
nyatla 5:6a2a1644ea2c 59 //try to ModLocalFileSystem(SD)
nyatla 5:6a2a1644ea2c 60 if(this->modsd.execute(i_connection)){
nyatla 0:ec1e45489427 61 return;
nyatla 0:ec1e45489427 62 }
nyatla 5:6a2a1644ea2c 63 //Otherwise, Send simple top index page.
nyatla 5:6a2a1644ea2c 64 i_connection.sendHeader(200,"text/html",NULL);
nyatla 5:6a2a1644ea2c 65 if(i_connection.isMethodType(Http::MT_GET)){
nyatla 5:6a2a1644ea2c 66 i_connection.sendBodyF(
nyatla 5:6a2a1644ea2c 67 "<!DOCTYPE html>"
nyatla 5:6a2a1644ea2c 68 "<html lang=\"ja\">"
nyatla 5:6a2a1644ea2c 69 "<head></head>"
nyatla 5:6a2a1644ea2c 70 "<body>"
nyatla 5:6a2a1644ea2c 71 "<h1>This is MiMic Server!</h1>"
nyatla 5:6a2a1644ea2c 72 "<hr/>"
nyatla 5:6a2a1644ea2c 73 "<ul>"
nyatla 5:6a2a1644ea2c 74 "<li><a href=\"/local/\">mbed Local Filesystem</a></li>"
nyatla 5:6a2a1644ea2c 75 "<li><a href=\"/sd/\">SDCard</a></li>"
nyatla 5:6a2a1644ea2c 76 "</ul></body>");
nyatla 5:6a2a1644ea2c 77 }
nyatla 0:ec1e45489427 78 }
nyatla 0:ec1e45489427 79 };
nyatla 0:ec1e45489427 80
nyatla 0:ec1e45489427 81 int main()
nyatla 0:ec1e45489427 82 {
nyatla 0:ec1e45489427 83 NetConfig cfg; //create network configulation
nyatla 0:ec1e45489427 84 Net net(cfg); //create a net instance.
nyatla 5:6a2a1644ea2c 85 //try to override setting by local file.
nyatla 5:6a2a1644ea2c 86 if(!cfg.loadFromFile("/local/mimic.cfg")){
nyatla 10:80c05810f911 87 wait_ms(1000);
nyatla 5:6a2a1644ea2c 88 cfg.loadFromFile("/sd/mimic.cfg");
nyatla 5:6a2a1644ea2c 89 }
nyatla 5:6a2a1644ea2c 90 FsHttpd httpd; //create a httpd instance.
nyatla 0:ec1e45489427 91 httpd.loop(); //start httpd loop.
nyatla 0:ec1e45489427 92 return 0;
nyatla 0:ec1e45489427 93 }