Installation

• clone https://github.com/openwsn-berkeley/openwsn-fw

  • switch to branch pr-cmake-build-system

• install

  • CMake ( >= 3.13)

  • Python 3.9.2

• build library

  • build OpenWSN firmware as Python extension for simulation

    • in repo root, type python3 setup.py install --user

    • creates openmote.so (include the parts from it) allows one to type import openmote

  • test

    • python3 -c “import openmote”

  • clean

    • python3 setup.py clean

Windows Specifics

• install

  • Microsoft Visual Studio toolchain: https://visualstudio.microsoft.com/vs/features/cplusplus/

    • “Community 2019” known to work

    • why?

      • needed because since Python 3.4, Python extension needs to be compiled with MSVC compiler

  • MinGW

    • why?

      • MinGW generates the right Makefiles when running from command line

      • we can also run cmake from an IDE (then the IDE will provide the generator).

    • download from https://sourceforge.net/projects/mingw/

    • install only mingw32-base

  • cmake

    • https://cmake.org/download/

    • cmake-3.20.0-windows-x86_64.msi known to work

    • have install add CMake to the PATH

      

  • Python

    • python-3.9.2-amd64.exe known to work

    • add Python interpreter to PATH environment variable

    • to be able to run OpenWSN Python extension in gdb, select the following from the advanced installation options
      

      

• build

  • type python setup.py install --user

  • build process ends with line Finished processing dependencies for openmote==1.0

  • library ends up in C:\Users\twatteyn\AppData\Roaming\Python\Python39\site-packages

    • openmote-1.0-py3.9-win-amd64.egg/

    • easy-install.pth

• import library

  • verify the following doesn’t fail python -c "import openmote"

MAC OS Specifics

• Use homebrew python (brew install python or brew upgrade python) since MAC OSX system Python seems to lead to unstable results (depending on OS version).

• Python 3.9.1 known to work

• To build (and configure)

  • python3 setup.py install --user --prefix=

  • python3 setup.py install --user --configure --prefix=

• When running into issue where

Issue David:

127.0.0.1 - - [14/Apr/2021 08:57:49] code 400, message Bad request syntax ('\x05\x01\x00')

Installing OpenVisualizer

• clone https://github.com/TimothyClaeys/openvisualizer

• switch to branch python3

• move to root of the openvisualizer repository

• run pip install -e . (Windows) / pip3 install -e .

  • causes the openvisualizer to be installed in Python as a symlink to the current source directory, i.e. this is “installed” but changes to the source code in the repo are reflected

Running Simulation

• on first terminal

  C:\Users\twatteyn\Desktop\openvisualizer>openv-server simulation 2
  
   ___                 _ _ _  ___  _ _
  | . | ___  ___ ._ _ | | | |/ __>| \ |
  | | || . \/ ._>| ' || | | |\__ \|   |
  `___'|  _/\___.|_|_||__/_/ <___/|_\_|
       |_|                  openwsn.org
  
  11:39:41 INFO Starting OpenVisualizer ...
  11:39:41 [SimEngine:INFO] Starting engine (PID = 1988)
  11:39:41 [Topology:DEBUG] create instance
  11:39:42 [multiprocessing:INFO] Booting mote_1 (PID = 7500) ...
  11:39:42 SUCCESS 1 [OPENWSN] booted
  11:39:42 [multiprocessing:INFO] Booting mote_2 (PID = 9584) ...
  11:39:42 SUCCESS 2 [OPENWSN] booted

• on second terminal

  C:\Users\twatteyn\Desktop\openvisualizer>openv-client network root 0001
  Ok!

• this causes mote 0001 to be configured as DAG root, so on the first terminal:
  

  11:40:58 INFO registering DAGroot 14-15-92-cc-00-00-00-01
  11:41:08 SUCCESS 2 [IEEE802154E] synchronized at slotOffset 0 to mote 1
  11:41:08 SUCCESS 2 [SIXTOP] sixtop return code RC_SUCCESS at sixtop state WAIT_ADDRESPONSE
  11:41:11 INFO received RPL DAO from bbbb:0:0:0:1415:92cc:0:2
          - parents:
             bbbb:0:0:0:1415:92cc:0:1
          - children:
  11:41:13 INFO received RPL DAO from bbbb:0:0:0:1415:92cc:0:2
          - parents:
             bbbb:0:0:0:1415:92cc:0:1
          - children:

GitHub actions

Scratchpad

Open Questions

• use of .github directory and GitHub actions

• cross compilation and toolchains used

• OpenMote B and nRF52840-DK support (including toolchain)