Skip to content
Permalink
Browse files
Minor revision of headings, overview, wording
  • Loading branch information
James Brusey committed May 17, 2022
1 parent 78ba269 commit b29ace00c04ccbdef462aa8cb8b94d45ea0b4849
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 11 deletions.
@@ -3,3 +3,6 @@
/figures/*.fdb_latexmk
/figures/*.fls
/figures/*.log
/01-install-contiki.pdf
/01-install-contiki.tex
/_minted-01-install-contiki/
@@ -1,5 +1,5 @@
#+startup: beamer
#+title: Install Contiki
#+title: Install Contiki-NG
#+Author: James Brusey
#+Email: james.brusey@coventry.ac.uk
#+options: toc:nil
@@ -13,13 +13,15 @@
#+latex_compiler: pdflatex
#+latex_header: \usepackage[osf]{mathpazo}
#+property: header-args :eval no-export
* Learning outcomes
* Overview
By the end of this tutorial, you should be able to:
+ Create a virtual machine instance for Contiki-NG

+ Run a basic hello-world program under Contiki-NG

Note: these instructions assume that you are running windows (the install is much easier under Linux or MacOSX and the default instructions are sufficient).
+ Run Contiki-NG's graphical network simulator

Note: these instructions assume that you are running MS-Windows (the install is much easier under Linux or MacOSX and the default instructions are sufficient).
* Many options for installing Contiki-NG
Here are some of them:
1. Install a dual-boot GNU/Linux system (e.g., Ubuntu) (native toolchain)
@@ -77,9 +79,9 @@ We go with option 4 as it allows us to use an up-to-date Contiki-NG but simplifi

- Vagrant is controlled by command line instructions

- *=vagrant -h=* to get a list of commands (such as =vagrant up=)
- =vagrant -h= to get a list of commands (such as =vagrant up=)

- *=vagrant up -h=* to get specific help on the up sub-command
- =vagrant up -h= to get specific help on the up sub-command

* Download contiki
Clone contiki:
@@ -175,7 +177,6 @@ $ cd contiki-ng/examples/hello-world/
$ make TARGET=native
$ ./hello-world.native
#+END_SRC
* Step 6 log back in and try it out

You should get the following output:

@@ -198,7 +199,7 @@ Hello, world

* Step 7 set-up X windows
- Cooja is Contiki-NG's network simulator
- While compiling Contiki doesn't require a windowing display, Cooja /does/
- While compiling Contiki-NG doesn't require a windowing display, Cooja /does/
- We follow the instructions at: https://github.com/contiki-ng/contiki-ng/wiki/Vagrant#provision-a-vm-with-a-desktop-environment

- Adjust the Vagrantfile to uncomment =vb.gui = true=
@@ -208,7 +209,7 @@ Hello, world
vb.gui = true
end
#+END_SRC
* Step 7 set-up X windows (cont)

- On the VM, run the bootstrap script for setting up X packages
#+BEGIN_SRC sh
$ ./contiki-ng/tools/vagrant/bootstrap-vbox-with-x.sh
@@ -224,17 +225,18 @@ $ ./contiki-ng/tools/vagrant/bootstrap-vbox-with-x.sh
$ git submodule update --init --recursive
#+END_SRC

* Create a new simulation
* Step 9 create a new simulation
Follow the tutorial listed here:
https://github.com/contiki-ng/contiki-ng/wiki/Tutorial:-Running-Contiki%E2%80%90NG-in-Cooja

If you encounter errors, try the fix suggested here: https://github.com/contiki-os/contiki/issues/2324

[[file:figures/cooja-new-sim.png]]

* Simple UDP RPL simulation
* Step 10 try out the simulator (optional)
[[https://tools.ietf.org/html/rfc6550][RPL]] is the Routing Protocol for Low power and Lossy Networks

Follow the instructions at:
https://github.com/contiki-ng/contiki-ng/wiki/Tutorial:-running-a-RPL-network-in-Cooja

[[file:figures/cooja-rpl-udp.png]]
@@ -249,7 +251,7 @@ https://github.com/contiki-ng/contiki-ng/wiki/Tutorial:-running-a-RPL-network-in
+ Write out a counter that increments
+ Compile using the =native= target and do a screenshot of it running

+ Also screenshot Cooja running
+ Please also get a screenshot of Cooja running

+ Submit to https://forms.gle/JApFhSKfcD46dTgh6

0 comments on commit b29ace0

Please sign in to comment.