Workshop: RESTful Services mit Contiki

• Die Installation von Instant Contiki benötigt VMWare Player, oder Virtualbox
• Anmeldung an Instant Contiki mit dem Passwort: user
• Die folgende Beschreibung bezieht sich immer auf das Quellcode-Verzeichnis: /home/user/contiki-2.7/

Im Workshop wollen wir Contiki-Anwendungen direkt auf dem Entwicklungsrechner ausführen. Dazu müssen einige Veränderungen an den Quellcode-Dateien vorgenommen werden, um z.B. eine optimale Netzunterstützung zu gewährleisten.

1. Die Folien zum Vortrag können über diesen Link heruntergeladen werden.
2. Die für diesen Workshop geänderten Contiki Dateien finden Sie hier: contiki-2.7.zip
3. Die Dateien der Webanwendung finden sie hier: rest_demo.zip

Die Netzwerkverbindung zum Host-PC erfolgt über NAT. Die IPv6 Adresse des Ethernet-Interface des Linux Guests wird mit folgendem Kommando konfiguriert:

sudo ifconfig eth0 add fdfa::9/64 

In der Datei /contiki-2.7/platform/minimal-net/contiki-conf.h:

1. Aktivieren des ULA-Präfixes in Zeile 79:

   #define HARD_CODED_ADDRESS      "fdfd::" //assign prefix; address becomes fdfd::206:98ff:fe00:232 }

2. Dektivieren des RPL-Routings in Zeile 93:

   #define UIP_CONF_IPV6_RPL           0

3. Deaktivieren der Router-Funktion in Zeile 94:

   #define RPL_BORDER_ROUTER           0

4. Vergrößern des Paketpuffers durch Einfügen der Zeile 95:

   #define UIP_CONF_BUFFER_SIZE	 1300

In der Datei /contiki-2.7/examples/rest-example/Makefile:

1. Übersetzungsziel des Makefiles ändern:

   all: rest-server-example

2. Kein COAP verwenden:

   WITH_COAP = 0

3. Compileflags für IPv6 hinzufügen:

   CFLAGS += -DUIP_CONF_IPV6=1

Im Anschluss kann der RESTful Webserver von Contiki mit Hilfe des Makefiles übersetzt werden:

make TARGET=minimal-net

Sollte es notwenig sein nachträglich weitere Änderungen am Makefile durchzuführen, kann das Projekt vor der erneuten Übersetzung zurückgesetzt werden:

make TARGET=minimal-net clean

Nach der erfolgreichen Übersetzung kann die Anwendung gestartet werden:

sudo ./rest-server-example.minimal-net

Contiki richtet dabei ein eigenes Netzwerkinterface tap0 ein. Für den Netzzugriff auf die IPv6-ULA muss über ein weiteres Terminalfenster dieses Interface noch entsprechend konfiguriert werden ( Achtung: bei jedem Neustart der Contiki-Anwendung erforderlich):

sudo ifconfig tap0 add fdfd::ff:fe00:10/64

Anschließend kann über den Webbrowser des Entwicklungssystems auf den Contiki-Service zugegriffen werden. Dazu muss in der Adresszeile http://[fdfd::206:98ff:fe00:232]:8080/helloworld eingegeben werden.