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@6:20dcb08e1b43, 2013-04-29 (annotated)

Committer:
nyatla
Date:
Mon Apr 29 02:05:11 2013 +0000
Revision:
6:20dcb08e1b43
Parent:
5:6a2a1644ea2c
Child:
10:80c05810f911
Add LED blinking

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 0:ec1e45489427 14
nyatla 0:ec1e45489427 15
nyatla 3:77431c2bd9cb 16 /**
nyatla 3:77431c2bd9cb 17 * local filesystem support.
nyatla 3:77431c2bd9cb 18 */
nyatla 3:77431c2bd9cb 19 LocalFileSystem lf("local");
nyatla 5:6a2a1644ea2c 20 SDFileSystem sd(p5, p6, p7, p8,"sd");
nyatla 6:20dcb08e1b43 21 DigitalOut led1(LED1);
nyatla 6:20dcb08e1b43 22 unsigned int p;
nyatla 0:ec1e45489427 23 /**
nyatla 0:ec1e45489427 24 * MiMic RemoteMCU httpd.<br/>
nyatla 5:6a2a1644ea2c 25 * Number of simultaneous connections:4
nyatla 0:ec1e45489427 26 * <p>Service list</p>
nyatla 0:ec1e45489427 27 * <pre>
nyatla 0:ec1e45489427 28 * /local/ - mbed LocalFileSystem
nyatla 0:ec1e45489427 29 * </pre>
nyatla 0:ec1e45489427 30 */
nyatla 5:6a2a1644ea2c 31 class FsHttpd:public MiMic::Httpd
nyatla 0:ec1e45489427 32 {
nyatla 0:ec1e45489427 33 private:
nyatla 5:6a2a1644ea2c 34 ModLocalFileSystem modlocal;
nyatla 5:6a2a1644ea2c 35 ModLocalFileSystem modsd;
nyatla 0:ec1e45489427 36 public:
nyatla 5:6a2a1644ea2c 37 FsHttpd():Httpd(80)
nyatla 0:ec1e45489427 38 {
nyatla 3:77431c2bd9cb 39 //bind local file system path to /local/*
nyatla 5:6a2a1644ea2c 40 modlocal.setParam("local");
nyatla 5:6a2a1644ea2c 41 modsd.setParam("sd");
nyatla 0:ec1e45489427 42 }
nyatla 0:ec1e45489427 43 virtual void onRequest(HttpdConnection& i_connection)
nyatla 0:ec1e45489427 44 {
nyatla 6:20dcb08e1b43 45 p++;
nyatla 6:20dcb08e1b43 46 led1=p%2;
nyatla 5:6a2a1644ea2c 47 //try to ModLocalFileSystem
nyatla 5:6a2a1644ea2c 48 if(this->modlocal.execute(i_connection)){
nyatla 5:6a2a1644ea2c 49 return;
nyatla 5:6a2a1644ea2c 50 }
nyatla 5:6a2a1644ea2c 51 //try to ModLocalFileSystem(SD)
nyatla 5:6a2a1644ea2c 52 if(this->modsd.execute(i_connection)){
nyatla 0:ec1e45489427 53 return;
nyatla 0:ec1e45489427 54 }
nyatla 5:6a2a1644ea2c 55 //Otherwise, Send simple top index page.
nyatla 5:6a2a1644ea2c 56 i_connection.sendHeader(200,"text/html",NULL);
nyatla 5:6a2a1644ea2c 57 if(i_connection.isMethodType(Http::MT_GET)){
nyatla 5:6a2a1644ea2c 58 i_connection.sendBodyF(
nyatla 5:6a2a1644ea2c 59 "<!DOCTYPE html>"
nyatla 5:6a2a1644ea2c 60 "<html lang=\"ja\">"
nyatla 5:6a2a1644ea2c 61 "<head></head>"
nyatla 5:6a2a1644ea2c 62 "<body>"
nyatla 5:6a2a1644ea2c 63 "<h1>This is MiMic Server!</h1>"
nyatla 5:6a2a1644ea2c 64 "<hr/>"
nyatla 5:6a2a1644ea2c 65 "<ul>"
nyatla 5:6a2a1644ea2c 66 "<li><a href=\"/local/\">mbed Local Filesystem</a></li>"
nyatla 5:6a2a1644ea2c 67 "<li><a href=\"/sd/\">SDCard</a></li>"
nyatla 5:6a2a1644ea2c 68 "</ul></body>");
nyatla 5:6a2a1644ea2c 69 }
nyatla 0:ec1e45489427 70 }
nyatla 0:ec1e45489427 71 };
nyatla 0:ec1e45489427 72
nyatla 0:ec1e45489427 73 int main()
nyatla 0:ec1e45489427 74 {
nyatla 0:ec1e45489427 75 NetConfig cfg; //create network configulation
nyatla 0:ec1e45489427 76 Net net(cfg); //create a net instance.
nyatla 5:6a2a1644ea2c 77 //try to override setting by local file.
nyatla 5:6a2a1644ea2c 78 if(!cfg.loadFromFile("/local/mimic.cfg")){
nyatla 5:6a2a1644ea2c 79 cfg.loadFromFile("/sd/mimic.cfg");
nyatla 5:6a2a1644ea2c 80 }
nyatla 5:6a2a1644ea2c 81 FsHttpd httpd; //create a httpd instance.
nyatla 0:ec1e45489427 82 httpd.loop(); //start httpd loop.
nyatla 0:ec1e45489427 83 return 0;
nyatla 0:ec1e45489427 84 }