Hugin NFC app

1Introduction

Hugin is the Android app for working on site with Square, Puck Radar and Prism sensors. You hold the phone against a sensor and Hugin talks to it over NFC. On the phone the app is called Sensative NFC Application.

With Hugin you can:

• read the sensor’s serial number, DevEUI, LoRaWAN region, firmware and VSM application
• read and change the application’s settings, and turn the sensor off and on
• write a predefined configuration profile
• update the sensor’s time, assistance position and GNSS almanac
• flash a new VSM application or firmware
• make the radar board in Puck Radar or Prism advertise on Bluetooth, so that SweIoT Toolbox can find it.

Hugin is not the same as Munin. Munin is an MQTT client that decodes data and manages sensors over the air (see Which app for what).

2What you need

• An Android phone with NFC. The current version of Hugin does not work on iPhone. Hugin uses the phone’s location for the GNSS assistance position.
• An internet connection on the phone. Hugin checks each sensor with the Sensative server before it can talk to it.
• An Yggio user account on public.yggio.net: a username (your email address) and a password. Without it, Hugin reads basic sensor information only.
• Your sensors shared with that account. Hugin only gives access to a sensor that is shared with your account. Sensative shares the sensors you buy with your account.
• The Hugin APK file.

Your Sensative contact provides the account and the APK, and shares your sensors with the account.

3Install and sign in

Hugin works without the Yggio sign-in, but with it Hugin can also:

• find the sensor in Yggio when you tap it, by DevEUI, and show its Yggio name, last-seen time and RSSI with the sensor information
• keep Yggio decoding the sensor correctly: when the application on the sensor does not match the application description on its Yggio node, for example after a reflash, Hugin writes the right one to the node
• use the application description from the Yggio node when the image server does not have one, for example for a customer-specific build; App Settings and Activate Radar Bluetooth then work for that sensor
• check and fix the sensor’s Yggio node under Advanced, Mesh Status: node name, secret (must be the serial number) and device model (must be sensative-vsm-lora).

The sensor must be shared with your Yggio account for any of this to work. NFC App Version at the bottom of the Account tab shows which build of Hugin you have; give it to Sensative support when you report a problem.

4Connect to a sensor

The NFC antenna is in a different place on each product:

The phone’s NFC antenna is on the back, and its position differs between models; the phone’s manual shows where.

If anything fails or stops responding, lift the phone away and hold it against the sensor again: a new NFC connection starts a new session.

Below the fields are the Configure button, the Activate Radar Bluetooth button (sensors with a radar board only), and three sections you can expand: View Details, Profiles and Advanced. View Details shows the full sensor information:

5Change application settings

Configure opens App Settings: a list of the settings in the sensor’s VSM application, with their current values. Hugin needs your image server sign-in to read the list.

1. Hold the phone against the sensor and press Configure.
2. Tap a setting to change its value. Hugin writes it to the sensor.
3. Press Close when you are done.

App Settings also has:

• ON / OFF turns the sensor off, or on again. Turning a sensor off and on makes it send a new join request, for example after you move it to another LoRaWAN network server. The sensor does not work while it is off.
• Go to VSM tools opens the VSM Configuration Tool, which builds configuration downlinks for sensors already in the field.

6Write a configuration profile

The Profiles section shows the sensor’s current configuration profile and lets you write a different one. The profiles are predefined sets of settings for each application, the same ones the VSM Configuration Tool offers. Current Config Profile shows the application, the profile name and its status:

Profiles exist only for applications that Sensative has published profiles for, and many applications have none. Hugin gets the list from the image server for the application’s App CRC. A profile made in the VSM Configuration Tool can also be sent to the phone as a QR code; Hugin lists it first, as “QR:” followed by its name. If there are no profiles for the application, or the sensor’s configuration matches none of them, the list shows Custom Profile and Write and Restart is not available; change the configuration by downlink instead.

1. Expand Profiles.
2. Select a profile in Select Config Profile.
3. Press Write and Restart.
4. Wait a few seconds for the sensor to restart, then hold the phone against it again. The restart replaces the NFC session keys, so the old connection does not continue.

7GNSS almanac, position and time

For sensors with assisted GNSS (GPS or BeiDou), such as Square Tracker Xtreme. They need:

• a GNSS almanac, valid for about three months
• an assistance position, updated when the sensor moves more than about 100 km
• the correct time.

You can keep these up to date over the air instead, without visiting the sensor: in Yggio with Almanac Fleet, or with Munin. Use Hugin when you are at the sensor anyway.

1. Hold the phone against the sensor.
2. Expand Advanced and select GPS Assist, Almanac & Device Time.
3. Press Update GNSS Almanac.
4. Keep the phone in place until the title shows READY. This takes several seconds.

Hugin first writes the phone’s time and position to the sensor, then streams the new almanac (about 2.6 kB). The status box shows the device time, the position written, the almanac progress in bytes, and finally “GNSS Almanac updated, valid for about 3 months”.

8Flash an application or firmware

The Flashing tab loads new firmware and VSM applications onto the sensor. Which versions you can flash depends on your image server account. Ask your Sensative contact which application, version and region to use: not every combination has been verified on every product.

1. Open the Flashing tab and check that the mode drop-down at the top shows Regular.
2. Hold the phone against the sensor. Hugin shows the hardware under Device Status, then ACCESS GRANTED, and downloads the versions available for the sensor.
3. Select Version first. App and Region stay greyed out until a version is selected; Image Status then shows how many applications and regions the version has, for example “Got 16 rule files and 4 regions”.
4. Select the App, for example Motion-spectrum.vso, and the Region, for example eu868 or us915.
5. Press Flash. It turns active once Version, App and Region are set and the status shows “Image ready”.
6. Keep the phone in place until “Flash completed” appears. A VSM application takes a few seconds; firmware takes about a minute.
7. Wait a few seconds for the sensor to restart, then hold the phone against it again.
8. If you flashed a new application, write a configuration profile (section 6): profiles belong to a specific application and version.

Hugin remembers the last Version, App and Region, and keeps the downloaded image. To flash the same software onto the next sensor, hold the phone against it and press Flash.

The mode drop-down has two more modes:

• Application flashes only the VSM application, not the firmware. Select Version and Application, then press Flash Application.
• Handless flashes the same selection onto many sensors in a row. Select Region, App and Version in Regular mode first, then switch to Handless and hold the phone against each sensor in turn. Flashing starts by itself.

9Advanced

The Advanced section on the Home tab has diagnostic, measurement and production tools. The ones you are most likely to need:

The other items (power statistics, registers and sensors, debug, crash log, radio tests, product test, battery capacity) are for Sensative support. Use them when support asks you to.

10Data, updates and accounts

Hugin logs events to the Sensative server, such as which firmware was flashed and which configuration was written to a sensor. It also collects statistics from the sensor, such as power consumption and diagnostics. The data is linked to the sensor’s serial number. By using the app you consent to this logging; you can ask Sensative to erase the collected data under the GDPR (see our privacy policy).

Sensative may update Hugin without notice, for security or other reasons. Your Sensative contact tells you when you need a new version. If your account details are compromised, Sensative may block the account temporarily.

11Questions and troubleshooting

The first thing to try for most problems is to reconnect: lift the phone away and hold it against the sensor again.

Connecting a radar board to SweIoT Toolbox

The radar board in Puck Radar and Prism is configured with the SweIoT Toolbox app over Bluetooth, not with Hugin. SweIoT Toolbox needs its own account, and it only shows radar boards that belong to that account: a radar whose Bluetooth MAC address is not assigned to your SweIoT account is ignored, even when it is advertising.

Before the first connection, read the radar’s Bluetooth MAC address in Hugin (Advanced, Radar Status, or BLE MAC on the Home tab) and send it with the serial number to your Sensative contact, to have the radar assigned to your SweIoT account. Then:

1. Hold the phone against the sensor with Hugin open.
2. Press Activate Radar Bluetooth. The radar board advertises for 20 seconds by default.
3. Scan for it in SweIoT Toolbox straight away. It shows the radar by its MAC address.

Activate Radar Bluetooth shows only when Hugin is signed in to the image server and knows the sensor’s application. If SweIoT Toolbox finds nothing although a generic Bluetooth scanner such as nRF Connect sees the radar, its MAC address is not assigned to your SweIoT account; send it to your Sensative contact, and when they confirm, activate Bluetooth again and scan.

12Which app for what

Questions about Hugin go to Sensative support; give the NFC App Version from the Account tab.