contiki/platform/ev-aducrf101mkxz/README.md

160 lines
5.0 KiB
Markdown

Building Contiki for the EV-ADuCRF101MKxZ Board
===============================================
On Debian/Ubuntu Linux:
-----------------------
For older versions of Ubuntu (prior to 14.04), add the external
package repository that provides recent versions of GCC for ARM:
sudo add-apt-repository -y ppa:terry.guo/gcc-arm-embedded
sudo apt-get update
For all systems, install the required development packages:
sudo apt-get install git make gcc-arm-none-eabi python-serial
Obtain the Contiki source code:
git clone https://github.com/contiki-os/contiki.git
Build Contiki's `example-abc`:
make -C contiki/examples/rime \
TARGET=ev-aducrf101mkxz \
example-abc.ev-aducrf101mkxz.hex
The default radio frequency can optionally be specified on the
command-line as follows. A clean rebuild may be needed when changing
it:
make -C contiki/examples/rime \
TARGET=ev-aducrf101mkxz \
RF_CHANNEL=915000000 \
clean \
example-abc.ev-aducrf101mkxz.hex
The code can be flashed to the eval board and tested using
[adi-cm3sd](https://github.com/jimparis/adi-cm3sd.git). Obtain
`adi-cm3sd`:
git clone https://github.com/jimparis/adi-cm3sd.git
Connect the evaluation board using its J-Link board, or any other
serial adapter. Flash `example-adc` and open a terminal by running:
adi-cm3sd/cm3sd.py -a contiki/examples/rime/example-abc.ev-aducrf101mkxz.hex \
/dev/serial/by-id/usb-SEGGER_J-Link_000541011111-if00
replacing `/dev/serial/by-id/usb-SEGGER_J-Link_000541011111-if00` with
the path to the correct serial device. Flash the same code on a
second evaluation board to see them communicate.
### IPv6 Example ###
#### Border Router ####
First, build and run the IPv6 `border-router` example:
make -C contiki/examples/ipv6/rpl-border-router \
TARGET=ev-aducrf101mkxz \
SERIAL_ID='"00001234"' \
border-router.ev-aducrf101mkxz.hex
adi-cm3sd/cm3sd.py -a contiki/examples/ipv6/rpl-border-router/border-router.ev-aducrf101mkxz.hex \
/dev/serial/by-id/usb-SEGGER_J-Link_000541011111-if00
After flashing, close the terminal with `CTRL-C`, then build and run
the SLIP tunnel on the host machine:
make -C contiki/tools tunslip6
sudo contiki/tools/tunslip6 \
-s /dev/serial/by-id/usb-SEGGER_J-Link_000541011111-if00 \
-B 115200 -v3 fd00::1/64
Open the border router's home page at: http://[fd00::3230:3030:3132:3334]/
#### Web Server ####
Then, build and flash the IPv6 `webserver6` example on another eval
board. The different `SERIAL_ID` ensures that the webserver uses a
link-local IP address that is different from that of the border
router:
make -C contiki/examples/webserver-ipv6 \
TARGET=ev-aducrf101mkxz \
SERIAL_ID='"00005678"' \
webserver6.ev-aducrf101mkxz.hex
adi-cm3sd/cm3sd.py -a contiki/examples/webserver-ipv6/webserver6.ev-aducrf101mkxz.hex \
/dev/serial/by-id/usb-SEGGER_J-Link_000541022222-if00
Open the web server's home page at: http://[fd00::3230:3030:3536:3738]/
On Windows:
-----------
### Install prerequisites ###
Install [git](http://git-scm.com/download/win/) with default options.
Install MinGW as follows:
* Download and run [mingw-get-setup.exe](https://sourceforge.net/projects/mingw/files/latest/download).
* Select `Install`, `Continue`, and `Continue` again.
* Click `Basic Setup` on the left panel.
* Click the checkbox next to `mingw32-base`, then click `Mark for Installation`.
* Select 'Installation -> Apply Changes' from the menu bar.
* Click 'Apply', then close and quit the MinGW installer.
### Install toolchain ###
Contiki can be built with either GCC or IAR:
* **GCC**: Install
[GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded/+download).
Use the "Windows installer" version. Ensure that "Add path to
environment variable" is selected in the installer.
* **IAR**: Install
[IAR Embedded Workbench](http://www.iar.com/ewarm/).
### Building `example-abc` ###
Open a shell by right-clicking the desktop or any folder and
selecting `Git Bash`.
Obtain the Contiki source code:
git clone https://github.com/contiki-os/contiki.git
Build Contiki's `example-abc`:
* **GCC**
/c/mingw/bin/mingw32-make -C contiki/examples/rime \
TARGET=ev-aducrf101mkxz \
example-abc.ev-aducrf101mkxz.hex
* **IAR**
/c/mingw/bin/mingw32-make -C contiki/examples/rime \
IAR=1 \
TARGET=ev-aducrf101mkxz \
example-abc.ev-aducrf101mkxz.hex
Other build options like `RF_CHANNEL` and `SERIAL_ID` can be specified
as in the Linux instructions above.
### Flashing and running ###
The resulting file
`contiki/examples/rime/example-abc.ev-aducrf101mkxz.hex` can be
flashed to the evaluation board using ADI's
[CM3WSD](http://www.analog.com/static/imported-files/eval_boards/CM3WSD.zip)
utility.
Use a terminal emulator (e.g. HyperTerminal) at 115200 baud to see the
program output.