74 lines
1.9 KiB
ReStructuredText
74 lines
1.9 KiB
ReStructuredText
|
.. _rpl-node-sample:
|
||
|
|
||
|
RPL node
|
||
|
###########
|
||
|
|
||
|
Overview
|
||
|
********
|
||
|
|
||
|
This sample builds a simple RPL node and shows how to join into an RPL
|
||
|
mesh network.
|
||
|
|
||
|
This sample assumes that your chosen platform has networking support.
|
||
|
Some code configuration adjustments may be needed.
|
||
|
|
||
|
The sample will listen for RPL multicast messages and joins with the RPL
|
||
|
Border Router node in DAG network.
|
||
|
|
||
|
The sample exports the following resources through a CoAP server role:
|
||
|
|
||
|
.. code-block:: none
|
||
|
|
||
|
/led
|
||
|
/ipv6/neighbors
|
||
|
/rpl-info
|
||
|
/rpl-info/parent
|
||
|
/rpl-info/rank
|
||
|
/rpl-info/link-metric
|
||
|
|
||
|
These resources allow you to toggle an on-board LED (if available) and build
|
||
|
the RPL mesh network topology from node RPL information.
|
||
|
|
||
|
Building And Running
|
||
|
********************
|
||
|
|
||
|
If you're using a Sparrow border router, follow the steps below to build and
|
||
|
run Sparrow BR. (Sparrow has its own TLV mechanism to build topology that
|
||
|
Zephyr doesn't support.) A patch is provided in the sample folder to to support
|
||
|
building topology with CoAP-based responses.
|
||
|
|
||
|
Running Sparrow BR
|
||
|
==================
|
||
|
|
||
|
.. code-block:: console
|
||
|
|
||
|
git clone https://github.com/sics-iot/sparrow.git
|
||
|
cd sparrow
|
||
|
git am 0001-Added-CoAP-support-for-Sparrow-Border-Router.patch
|
||
|
cd products/sparrow-border-router
|
||
|
sudo make connect-high PORT=/dev/ttyACM0
|
||
|
|
||
|
If your PC is using an http proxy, you should unset it for this sample.
|
||
|
Wait until the border router is up and running. The python script used below
|
||
|
will run a web-based UI.
|
||
|
|
||
|
.. code-block:: console
|
||
|
|
||
|
cd examples/sparrow
|
||
|
./wsdemoserver.py
|
||
|
|
||
|
Wait until you see "Connected" message on console. Unset proxy in browser
|
||
|
and open 127.0.0.1:8000.
|
||
|
|
||
|
Running RPL node
|
||
|
================
|
||
|
|
||
|
To build and run RPL node, follow the below steps to build and install
|
||
|
it on IEEE 802.15.4 radio supported board.
|
||
|
|
||
|
.. code-block:: console
|
||
|
|
||
|
$ make pristine and make flash
|
||
|
|
||
|
Wait until the RPL node joins with Border-Router and updates the list in the web UI.
|