HTTPD - Revision history

Coffee: Transfer image from old wiki

2014-08-13T21:25:55Z

Transfer image from old wiki

GooPie4o at 13:30, 12 August 2014

2014-08-12T13:30:10Z

Coffee: translate page into English

2014-08-12T13:02:26Z

translate page into English

Thrawnhex: Replaced content with "{{i18n|HTTPD}}"

2012-06-04T15:26:33Z

Replaced content with "{{i18n|HTTPD}}"

Thrawnhex: transfered Page from old wiki

2012-06-04T15:20:18Z

transfered Page from old wiki

New page

== Webserver auf dem ethersex ==
Der Webserver der in ethersex eingebaut ist kann von verschiedenen Orten die Daten lesen, die er ausliefern soll:

* Aus einem externen Dataflash
* Dateien die im Flash des Controllers nach der Firmware abgelegt sind
* ECMD Befehle absetzen und die Resultate erhalten ( fuer Ajax )

Jede dieser Quellen fuer Daten kann unabhaenig von den anderen eingeschaltet werden. Die einfachste Variante ist wohl zu Beginn die Dateien im internen Flash zu halten und dynamische Inhalte ueber das Http ECMD Interface abzurufen.

=== Konfiguration ===

<pre>
General Setup --->
[*] VFS (Virtual File System) support --->
| | [ ] Atmel SPI Dataflash |
| | [*] VFS File Inlining |
| | [ ] SD/MMC-Card Access |
| | [ ] EEPROM (24cxx) Raw Access |
| | [-] DC3840 Camera |

Applications --->
| | [*] HTTP Server |
| | [ ] Basic Authentication |

Applications --->
Etherrape Control Interface (ECMD) --->
| | [*] ECMD support |
</pre>

=== Dateien einbinden ===
Falls die Option ''Supply Inline Files'' aktiviert ist, werden alle Dateien, die unter ''vfs/embed/'' abgelegt sind, automatisch beim Erstellen des Images mit gzip gepackt und an das Ende der Firmware angehängt. Die Dateinamen bleiben dabei unverändert, jedoch muss beachtet werden, dass die maximale Länge der Dateinamen 6 Zeichen beträgt.

=== Dateien mit dem C Preprocessor oder m4 vorverarbeiten ===
Um Dateien abhängig von den Konfigurationsoptionen einzubinden (oder nicht) bzw. nur Teile mit einzubauen, wenn eine gewisse Option aktiviert ist, kann man diese durch cpp oder m4 vorverarbeiten lassen, bevor die Ausgabe gepackt und an die Firmware angefügt wird. Dazu muss die Datei auf .cpp bzw auf .m4 enden. Bei cpp sind alle defines aus der config.h/autoconf.h erreichbar (z. B. ~np~ONEWIRE_SUPPORT~/np~). Bei m4 wird aus ~np~ONEWIRE_SUPPORT conf_ONEWIRE ~/np~.

=== Content Type der Dateien ===
Da der Webserver den Content-Type nicht dynamisch erkennen kann, muss man ihm diese Informationen etwas vorkauen. Der Content-Type wird am ersten Buchstaben des Dateinamens festgemacht:
* S (z.B Sty.c): text/css
* X (z.B Xow.ht): application/xhtml+xml;
* Ansonsten wird alles mit text/html ausgeliefert

=== Dateien von SD-Card Aufrufen ===
Damit Datein von einer SD-Card ausgeliefert werden, kopiert man diese einfach auf die SD-Card.
Sie können dann im Browser über folgende URL aufgerufen werden.(die IP, der Dateiname müssen natürlich geändert werden) <pre>http://192.168.23.244/Dateiname</pre>
Wen die Datei in einem Ordner auf der SD-Card liegt ist kann sie über folgende URL aufgerufen werden.<pre>http://192.168.23.244/Ordnername/Dateiname</pre>
Die Länge des Dateinamens ist bei der SD-Card nicht auf 6 Zeichen begrenzt.

=== ECMD-Befehle per Hand auslösen (über http) ===
Um die IP per ecmd abzufragen, kann man die folgende URL (die IP muss natürlich geändert werden) im Browser eingeben und man bekommt die Ausgabe per http zurück.

<pre>http://192.168.23.244/ecmd?ip</pre>

Möchte man Befehle verwenden, welche ein Leerzeichen beinhalten, wie z.B. "1w list", dann muss das Leerzeichen durch ein "+" bzw. "%20" ersetzt werden. Folgender Befehl listet angeschlossene 1-wire Sensoren auf, falls vorhanden.

<pre>http://192.168.23.244/ecmd?1w+list</pre>

oder

<pre>http://192.168.23.244/ecmd?1w%20list</pre>

=== Startseite von Ethersex ===

Ist der Webserver einkompiliert sollte beim Aufruf von <nowiki>http://YOUR_ETHERSEX_IP/</nowiki> im Browser so eine Seite erscheinen:

[[Bild:Ethersex-screen-startseite.png|600px]]

=== Dataflash ===

'''TODO'''

[[Category:Ethersex]]
[[Category:StepByStep]]
[[Category:Network]]

@@ Line 93: / Line 93: @@
 <nowiki>http://YOUR_ETHERSEX_IP/</nowiki> the browser should show such a page:
-[[Bild:Ethersex-screen-startseite.png|600px]]
+[[File:Ethersex-screen-startseite.png|600px]]
 ===  Dataflash ===

@@ Line 4: / Line 4: @@
 |MENUCONFIG={{Applications}}->HTTP Server->HTTPD
 |STATUS={{stable}}
-|PINNING=?
+|PINNING=-
-|ECMD=?
+|ECMD=-
-|CONTROL6=?
+|CONTROL6=-
 |DEPENDS=?
 |REQUIRES=?
@@ Line 14: / Line 14: @@
 ==  Web server on the ethersex ==
-The built-in web servir in ethersex can read the files it should serve from various locations:
+The built-in web server in [[Ethersex]] can read the files it should serve from various locations:
 * from an external dataflash

← Older revision		Revision as of 13:02, 12 August 2014
Line 1:		Line 1:
	{{i18n\|HTTPD}}		{{i18n\|HTTPD}}
		+	{{Module
		+	\|NAME=HTTPD
		+	\|MENUCONFIG={{Applications}}->HTTP Server->HTTPD
		+	\|STATUS={{stable}}
		+	\|PINNING=?
		+	\|ECMD=?
		+	\|CONTROL6=?
		+	\|DEPENDS=?
		+	\|REQUIRES=?
		+	\|CODE=?
		+	}}
		+
		+
		+	== Web server on the ethersex ==
		+	The built-in web servir in ethersex can read the files it should serve from various locations:
		+
		+	* from an external dataflash
		+	* files stored in the flash memory of the MCU right after the firmware
		+	* run ECMD commands and serve the results (for AJAX)
		+
		+	Any of these sources for data can be enabled independent of the others. The easiest option is to initially keep the files in the internal flash memory and to access dynamic content via the HTTP ECMD interface.
		+
		+	=== Configuration ===
		+	<pre>
		+	General Setup --->
		+	[*] VFS (Virtual File System) support --->
		+	\| \| [ ] Atmel SPI Dataflash \|
		+	\| \| [*] VFS File Inlining \|
		+	\| \| [ ] SD/MMC-Card Access \|
		+	\| \| [ ] EEPROM (24cxx) Raw Access \|
		+	\| \| [-] DC3840 Camera \|
		+	...
		+	Applications --->
		+	\| \| [*] HTTP Server \|
		+	\| \| [ ] Basic Authentication \|
		+	...
		+	Applications --->
		+	Etherrape Control Interface (ECMD) --->
		+	\| \| [*] ECMD support \|
		+	</pre>
		+
		+	=== Embedding files ===
		+	If the option ''Supply Inline Files'' is enabled, all files stored in
		+	''vfs/embed/'' will be automatically packed with gzip and appended to the end
		+	of the firmware when building the image.
		+	Filenames remain unchanged, however the maximum length of filenames is 6
		+	characters.
		+
		+	=== Preprocess files with the C preprocessor or m4 ===
		+	To include files dependent on configuration options (or not) respectively
		+	including only parts, if a certain option is enabled, they can be preprocessed
		+	by cpp or m4, before the output is packed and appended to the firmware.
		+	For that, the file must end in .cpp or .m4. When using cpp, all defines from
		+	config.h/autoconf.h are accessible (e.g. ~np~ONEWIRE_SUPPORT~/np~).
		+	When using m4, ~np~ONEWIRE_SUPPORT turns into conf_ONEWIRE ~/np~.
		+
		+	=== Content type of the files ===
		+	Because the web server can not dynamically determine the content type, this
		+	information needs to be supplied in advance.
		+	The content type is determined by the first character of the file name:
		+	* S (e.g. Sty.c): text/css
		+	* X (e.g. Xow.ht): application/xhtml+xml;
		+	* everything else is served as text/html
		+
		+	=== Access files from the SD card ===
		+	To serve files from an SD card, they are copied to the SD card.
		+	These can then be accessed by the browser via the following URL (IP and file
		+	name must of course be changed) <pre>http://192.168.23.244/Filename</pre>
		+	If the file is located in a folder on the SD card, it can be accessed via the
		+	following URL. <pre>http://192.168.23.244/Foldername/Filename</pre>
		+	The length of filenames is not limited to 6 characters with the SD card.
		+
		+	=== Manually triggering ECMD commands (via HTTP) ===
		+	To query the IP via ECMD, the following URL (the IP must of course be changed)
		+	can be accessed with the browser, returning the output via HTTP.
		+
		+	<pre>http://192.168.23.244/ecmd?ip</pre>
		+
		+	In order to use commands containing spaces, e.g. "1w list", the spaces must be
		+	replaced with "+" or "%20". The following command lists 1-wire sensors, if
		+	any are present:
		+
		+	<pre>http://192.168.23.244/ecmd?1w+list</pre>
		+
		+	or
		+
		+	<pre>http://192.168.23.244/ecmd?1w%20list</pre>
		+
		+	=== Ethersex start page ===
		+
		+	If the web server is compiled in, when accessing
		+	<nowiki>http://YOUR_ETHERSEX_IP/</nowiki> the browser should show such a page:
		+
		+	[[Bild:Ethersex-screen-startseite.png\|600px]]
		+
		+	=== Dataflash ===
		+
		+	'''TODO'''
		+
		+	[[Category:Ethersex]]
		+	[[Category:StepByStep]]
		+	[[Category:Network]]

← Older revision		Revision as of 15:26, 4 June 2012
Line 1:		Line 1:
−	~~== Webserver auf dem ethersex ==~~	+	{{i18n\|HTTPD}}
−	~~Der Webserver der in ethersex eingebaut ist kann von verschiedenen Orten die Daten lesen, die er ausliefern soll:~~
−
−	* Aus einem externen Dataflash
−	* Dateien die im Flash des Controllers nach der Firmware abgelegt sind
−	* ECMD Befehle absetzen und die Resultate erhalten ( fuer Ajax )
−
−	Jede dieser Quellen fuer Daten kann unabhaenig von den anderen eingeschaltet werden. Die einfachste Variante ist wohl zu Beginn die Dateien im internen Flash zu halten und dynamische Inhalte ueber das Http ECMD Interface abzurufen.
−
−	~~=== Konfiguration ===~~
−
−	~~<pre>~~
−	~~General Setup --->~~
−	~~[*] VFS (Virtual File System) support --->~~
−	\| ~~\| [ ] Atmel SPI Dataflash \|~~
−	~~\| \| [*] VFS File Inlining \|~~
−	~~\| \| [ ] SD/MMC-Card Access \|~~
−	~~\| \| [ ] EEPROM (24cxx) Raw Access \|~~
−	~~\| \| [-] DC3840 Camera \|~~
−
−	~~Applications --->~~
−	~~\| \| [*] HTTP Server \|~~
−	~~\| \| [ ] Basic Authentication \|~~
−
−	~~Applications --->~~
−	~~Etherrape Control Interface (ECMD) --->~~
−	~~\| \| [*] ECMD support \|~~
−	~~</pre>~~
−
−	~~=== Dateien einbinden ===~~
−	Falls die Option ''Supply Inline Files'' aktiviert ist, werden alle Dateien, die unter ''vfs/embed/'' abgelegt sind, automatisch beim Erstellen des Images mit gzip gepackt und an das Ende der Firmware angehängt. Die Dateinamen bleiben dabei unverändert, jedoch muss beachtet werden, dass die maximale Länge der Dateinamen 6 Zeichen beträgt.
−
−	~~=== Dateien mit dem C Preprocessor oder m4 vorverarbeiten ===~~
−	Um Dateien abhängig von den Konfigurationsoptionen einzubinden (oder nicht) bzw. nur Teile mit einzubauen, wenn eine gewisse Option aktiviert ist, kann man diese durch cpp oder m4 vorverarbeiten lassen, bevor die Ausgabe gepackt und an die Firmware angefügt wird. Dazu muss die Datei auf .cpp bzw auf .m4 enden. Bei cpp sind alle defines aus der config.h/autoconf.h erreichbar (z. B. ~np~ONEWIRE_SUPPORT~/np~). Bei m4 wird aus ~np~ONEWIRE_SUPPORT conf_ONEWIRE ~/np~.
−
−	~~=== Content Type der Dateien ===~~
−	~~Da der Webserver den Content-Type nicht dynamisch erkennen kann, muss man ihm diese Informationen etwas vorkauen. Der Content-Type wird am ersten Buchstaben des Dateinamens festgemacht:~~
−	* S (z.B Sty.c): text/css
−	* X (z.B Xow.ht): application/xhtml+xml;
−	* Ansonsten wird alles mit text/html ausgeliefert
−
−	~~=== Dateien von SD-Card Aufrufen ===~~
−	~~Damit Datein von einer SD-Card ausgeliefert werden, kopiert man diese einfach auf die SD-Card.~~
−	~~Sie können dann im Browser über folgende URL aufgerufen werden.(die IP, der Dateiname müssen natürlich geändert werden) <pre>http://192.168.23.244/Dateiname</pre>~~
−	~~Wen die Datei in einem Ordner auf der SD-Card liegt ist kann sie über folgende URL aufgerufen werden.<pre>http://192.168.23.244/Ordnername/Dateiname</pre>~~
−	~~Die Länge des Dateinamens ist bei der SD-Card nicht auf 6 Zeichen begrenzt.~~
−
−	~~=== ECMD-Befehle per Hand auslösen (über http) ===~~
−	~~Um die IP per ecmd abzufragen, kann man die folgende URL (die IP muss natürlich geändert werden) im Browser eingeben und man bekommt die Ausgabe per http zurück.~~
−
−	~~<pre>http://192.168.23.244/ecmd?ip</pre>~~
−
−	Möchte man Befehle verwenden, welche ein Leerzeichen beinhalten, wie z.B. "1w list", dann muss das Leerzeichen durch ein "+" bzw. "%20" ersetzt werden. Folgender Befehl listet angeschlossene 1-wire Sensoren auf, falls vorhanden.
−
−	~~<pre>http://192.168.23.244/ecmd?1w+list</pre>~~
−
−	~~oder~~
−
−	~~<pre>http://192.168.23.244/ecmd?1w%20list</pre>~~
−
−	~~=== Startseite von Ethersex ===~~
−
−	~~Ist der Webserver einkompiliert sollte beim Aufruf von <nowiki>http://YOUR_ETHERSEX_IP/</nowiki> im Browser so eine Seite erscheinen:~~
−
−	~~[[Bild:Ethersex-screen-startseite.png\|600px]]~~
−
−	~~=== Dataflash ===~~
−
−	~~'''TODO'''~~
−
−	~~[[Category:Ethersex]]~~
−	~~[[Category:StepByStep]]~~
−	~~[[Category:Network]]~~