VersaSense IoT Fabric User manual


VersaSense NV, Kapeldreef 60, B-3001 Leuven, [email protected]
Getting Started with the VersaSense IoT Fabric
1. Deploying the VersaSense IoT Fabric:
Figure: The VersaSense IoT Fabric
1. Connect the provided antennas to the VersaSense Edge Gateway (M02) and
VersaSense Wireless devices (P0x).
2. Connect the VersaSense Edge Gateway to mains power via the power adapter
provided.
3. (optional) Connect the M02 VersaSense Edge Gateway to your LAN network
using an Ethernet cable.
4. Connect your sensors and actuators (S01 to S99) to the wireless devices.
5. Deploy the wireless devices at your chosen locations. We recommend a
maximum separation of 10M between each device in the mesh in indoor
environments.
Note 1 – Deep sleep and network formation: VersaSense Wireless devices in development
and demonstration mode save power by automatically entering deep sleep mode if the Edge
Gateway is offline for longer than 15 minutes. To wake your wireless device from deep sleep,
you simply need to (re)connect any sensor peripheral. Wireless devices can be configured
differently for use in production environments.
Note 2 – Wireless devices currently only support one of each peripheral type plugged in at
the same moment: In case you connect multiple peripherals of the same type at once on a
single wireless device; it will only enable data collection from the first peripheral plugged in
of every type.

2. Connecting to the VersaSense IoT Fabric:
2.1. Connecting
There are multiple options to connect to your edge gateway a web browser.
When connecting for the first time with the VersaSense IoT Fabric, we suggest to
connect via WiFi.
WiFi - The VersaSense Edge Gateway offers WiFi access under the SSID ‘versa-gw-XY-XY’
(with XY specific for every kit and labeled on the Edge Gateway) and the WPA key is
‘VersaSenseWiFi’.
When connected over WiFi, you can establish a secure web browser connection to
https://gateway.versasense.com/
Ethernet (LAN): The gateway also automatically requests an IP address via DHCP when
plugged into a LAN network. This IP address is specific to your LAN environment
configuration.
mDNS (Multicast DNS) [IETF RFC-6762] is also used to advertise and connect to edge
1
gateway services regardless whether you are connected via WiFi or Ethernet. Your edge
gateway is available at the following address: https://versa-gw-XY-XY.local. However,
depending on your Operating System, some configuration of mDNS might still be necessary:
●Mac OS X (10.2+) - No configuration is necessary as mDNS is natively supported.
●Microsoft Windows (7+):
oDepending on your Windows version, installed service packs and software
updates, a dedicated mDNS client might be required. In case of problems, we
recommend installing Apple iTunes (which includes the Bonjour mDNS client):
http://www.apple.com/itunes/download/
●Linux - An mDNS client may be necessary depending on your distribution. Installation
instructions vary based upon your distribution. Most newer Linux distributions typically
natively support mDNS.
1 https://tools.ietf.org/html/rfc6762

2.2. Logging in
After you are connected to https://gateway.versasense.com, you can log in using the
following credentials:
username:
manager
password:
manager
It is highly recommended to change this password as soon as possible using the
web interface.
3. Access information using the web interface:
Note – Browser compatibility: The web interface has been intensively tested on Chrome,
Firefox and Safari browsers. Microsoft Internet Explorer and Microsoft Edge browsers may
not always deliver the best viewing experience. Microsoft Internet Explorer versions < 9 are
not supported.

3.1. Introduction screen:
Figure: Introduction page
The basic introduction page gives an overview of:
●Network status: illustrates reliability and associated network metrics provided by
SmartMesh IP™, all devices, their associated information and network topology.
●Peripherals connected: live overview of all peripherals plugged in.
●Live data stream: showcases live peripheral data directly originating from your
network.
●Network security: Allows to securely commission new VersaSense Wireless devices
in the network.
●General configuration: Displays information about the current configuration of the
Edge Gateway. Allows to update the software on individual wireless devices and
expose its APIs remotely.
●About & Documentation: Contains general information and links to documentation
of software interfaces available in this kit.
3.2. Network overview
The network overview page shows generic network statistics together with an up-to-date
overview of all P0x wireless devices and the M02 VersaSense Edge Gateway.

Figure: network status overview
The various network statistics displayed on this page are automatically produced by the M02
Edge Gateway and reflect the current operational situation of the network in terms of
network parameters (reliability, packets arrived and lost, latency), software version, and
battery lifetime.
The current network topology includes information about the actual links between P0x
wireless devices individually and the M02 Edge Gateway.
Note – Network bandwidth versus battery lifetime: Your VersaSense IoT Fabric evaluation
kit is pre-configured with a default network bandwidth rate. Changing this bandwidth is
possible using the APIs, however, influences overall network lifetime as it determines the
duty cycling behaviour of a wireless device.

3.3. Connected peripherals overview
Figure: overview of connected peripherals
The connected peripherals page shows an up-to-date overview of all peripherals in the
VersaSense IoT Fabric. For every peripheral, you can inspect and change its current sampling
rate.
Figure: clicking on a peripheral gives detailed information about current sampling rate
Note 1 – Peripheral overview generation: the overview page is built dynamically with
information provided periodically by the edge gateway. The devices inside the network are
configured to regularly send a full picture of their current peripheral configuration. You may
speed up the overview generation process by (dis)-connecting a peripheral, since P0x
wireless devices immediately report any change to the edge gateway.
Note 2 – Peripheral correctness and responsiveness: The network is carefully configured to
ensure a stable and uniform distribution of bandwidth over the entire network. Therefore,
plugging in/out peripherals very rapidly after each other might not always immediately
represent the right situation on the network overview page. All VersaSense wireless P0x
devices are configured to periodically send their complete configuration in terms of their
connected peripherals. You can always speed up this reporting procedure by replugging a
peripheral.

3.4. Connecting to the live data stream
The live stream page displays a set of individual sensor or actuator panels containing live
data produced by the peripherals present inside the network. This page is dynamically
generated and it might take some time (depending on the current sampling rates) before
you see data appearing on the page.
Figure: example dashboard with live stream of sensor data

Figure: detailed historical graphs associated with each data stream panel
3.5. Secure commissioning of devices
The network security page allows to securely integrate new devices in your network.
Commissioning of a device requires the S00 secure programming and commissioning set.
Figure: overview of the commissioning page

Figure: pairing a wireless device (left) with the edge gateway (right) via the S00 secure
programming and commissioning peripheral
Please ensure that the USB cable is plugged in into the USB port of the edge gateway and the
commissioning peripheral is connected to a wireless device. Next, refresh the commissioning
webpage to initialize the pairing process. Once the wireless device is detected (MAC address
displayed), press the secure commissioning button on the webpage.
During commissioning, please do not press the button on the peripheral
After commissioning, your wireless device will automatically reboot and join the network.
3.6. Securely updating device software
The edge gateway configuration page allows to securely update the software of your
VersaSense Wireless devices:
Procedure to securely update a device:
1. Make sure you have a copy of the device software image (labeled as
mote_A.B.C.D.bin  ) stored on your local machine.
2. Click the textbox labeled as “Select device image file”
3. Browse to the binary device image file stored on your machine
4. Connect the S00 secure programming and commissioning peripheral between the
the edge gateway and the device.

5. Press the “Update” button on the webpage, and press the button on the S00
peripheral within 10 seconds.
4. Integrating the VersaSense IoT Fabric in your LAN
Your M02 Edge Gateway is configured to automatically integrate within your LAN network
via DHCP and IPv6.
Note 1 – IPv6-based LAN networks: In case your LAN is IPv6-enabled, the Edge Gateway will
also grant access to all P0x wireless devices via CoAP. Please contact your network
administrator to configure all routing to the wireless sensor network (fd34::/64) to go via the
Edge Gateway.
Note 2 – WiFi access point: The WiFi network broadcasted by the Edge Gateway is
configured to automatically act as wireless access point for clients when the Edge Gateway is
connected to Ethernet (LAN). In certain cases, the configuration of your LAN network might
prevent this from working correctly. Please contact your network administrator for support.
5. Technical support:
Your satisfaction and feedback is important to us. For technical support, please contact:
[email protected].