REL-1.10.0
This release contains code built specifically for the for the ETSI 6TiSCH F-Interop Plugtests, 14-15 July 2017, Prague, Czech Republic. Details about the plugtest are at http://www.etsi.org/news-events/events/1197-6tisch-interop-prague-2017
The code consist of:
- software, meant to run on your computer
- firmware, built for the OpenMote-CC2538 (www.openmote.com) platform
- release at https://github.com/openwsn-berkeley/openwsn-fw/releases/tag/REL-1.10.0
- two firmware images are provided by this release:
- the "golden image", a version of the regular OpenWSN code which implements the protocols for the plugtest
- sniffer firmware, which integrates with Wireshark
golden image
compile/load
To compile and download the golden image onto the OpenMote-CC2538:
scons board=OpenMote-CC2538 toolchain=armgcc goldenImage=root bootload=<port_name> oos_openwsn
Alternatively, the pre-compiled binary is available at https://github.com/openwsn-berkeley/openwsn-fw/releases/download/REL-1.10.0/gd_root.bin
Use the following command to load that image into your OpenMote-CC2538:
openwsn-fw/> bootloader\OpenMote-CC2538\cc2538-bsl.py -e -w -b 115200 -p [port name] --bsl 03oos_openwsn_prog.bin
configure
Use the OpenVisualizer in CLI mode to configure the golden image:
- navigate to
opewsn-sw/software/openvisualizer/
scons runcli
These are the supported configuration commands:
- PHY-layer commands
- set the communication channel
set <port_name> channel <value>
- set the communication channel
- IEEE802.15.4e commands
- set the timeout which the device send a keepAlive(
value
in slots)set <port_name> kaPeriod <value>
- set the period at the which the device sends enhanced beacons (
value
in seconds)set <port_name> ebPeriod <value>
- set the slotframe length
set <port_name> frameLength <value>
- enable/disable link-layer ACK'ing (set
value
to1
to enable,0
to disable)set <port_name> ackReply <value>
- set the slot duration (
value
is 32768Hz ticks, i.e. 30.5 us increments)set <port_name> slotDuration <value>
- set the timeout which the device send a keepAlive(
- 6P commands
- issue a 6P add command to add 1 tx cells among several candidate cells(set
celllist
to6-7-8
for slotoffset 6, 7 and 8 -- channeloffset is always 2). To addrx
, orshared
cell, just replacetx
byrx
orshared
.set <port_name> 6pAdd tx,1,<celllist>
- issue a 6P delete command to delete all specified cells (set
celllist
to6-7
for slotoffset 6 and 7 -- channeloffset is always 2)set <port_name> 6pDelete tx,2,<celllist>
- issue a 6P relocate command to relocate cells from celllist 1 by cells in :
set <port_name> 6pRelocate tx,1,<celllist1>,<celllist2>
- issue a 6P count command to count the number of tx cell:
set <port_name> 6pCount tx
- issue a 6P list command to list 2 tx cell starting from cell 5 :
set <port_name> 6pList tx,5,2
- issue a 6P clear command to clear all cells:
set <port_name> 6pClear all
- enable/disable 6P response (set
value
to1
to enable,0
to disable)set <port_name> 6pResponse <value>
- issue a 6P add command to add 1 tx cells among several candidate cells(set
- RPL commands
- set the period at the which the device sends DIOs (
value
in milli-seconds)set <port_name> dioPeriod <value>
- set the period at the which the device sends DAOs (
value
in milli-seconds)set <port_name> daoPeriod <value>
- set the DAGrank of the device:
set <port_name> dagrank <value>
- set the period at the which the device sends DIOs (
- app-layer commands
- set period of the
uinject
application (value
in number of packets per slotframe)set <port_name> sf0Bandwidth <value>
- set period of the
sniffer
compile/load
To compile and download the sniffer firmware on the OpenMote-CC2538:
scons board=OpenMote-CC2538 toolchain=armgcc bootload=[port name] oos_sniffer
Alternatively, the pre-compiled binary is available at https://github.com/openwsn-berkeley/openwsn-fw/releases/download/REL-1.10.0/gd_sniffer.bin
Use the following command to load that image into your OpenMote-CC2538:
openwsn-fw/> bootloader\OpenMote-CC2538\cc2538-bsl.py -e -w -b 115200 -p [port name] --bsl 03oos_sniffer_prog.bin
The sniffer firmware interacts with the Wireshark with:
- source code: https://github.com/wireshark/wireshark/archive/master.zip
- latest Windows 64-bit build: ftp://builder.openwsn.org/wireshark/Wireshark-win64-6tisch-latest.exe
- latest Windows 32-bit build: ftp://builder.openwsn.org/wireshark/Wireshark-win32-6tisch-latest.exe
configure
Use the OpenVisualizer mode to configure the golden image:
- navigate to
opewsn-sw/software/openvisualizer/
scons runweb
These are the supported configuration commands:
- set the comunication channel
set <port_name> channel <value>
About
The OpenWSN project is to to provide open-source implementations of a complete protocol stack based on Internet of Things standards, on a variety of software and hardware platforms.