The Modules page allows you to
- view a module’s details
- upgrade, downgrade and reload a module’s firmware (PG required)
- enable or disable module functionality
- calibrate sensors (TPH only)
- set modules options
- attach a label to a module
- replace a defective module with a new module
- turn on or off the module locate function
- turn on or off network test to a module
- add new modules
- watch the progress of module enrolment or replacement in real-time
- watch network statistics in real-time
We’ll start with viewing a module’s details. Simply select the module from the drop-down menu and you’ll see a page similar to this:
In a style similar to most pages, you have a top line that contains a module drop-down menu and New module, In progress and Network links.
Below that you have the module’s details, including an edit label link to add or change the module’s label, a replace link to begin the process of replacing a defective module with a new one, a network test to turn on or off the half-second blue LED flash, and a locate link to turn the module’s LED solid blue.
Locate can either be turned off by hitting the locate link again or by the module’s button (not the reset button) should it have one. With locate on the module will show as blue-dot on the status panel.
Below that you have the list of major functions the module provides, each of which can be enabled or disabled.
At the bottom of the page is the list of updates. You will only see a list here if you’ve uploaded a SHU file to HQ that contains updates for this module type. SHU (SharksHead Update) files are available in the Downloads tab of this web site. All SHU files are encrypted and signed to ensure only valid update files produced by the SharksHead team are loaded onto HQ and ultimately onto your modules.
To upgrade, reload or downgrade a module you will first need to plug the Programmer (PG) into the module. Your module will then go violet-dot on the status panel, and then you may upgrade, reload or downgrade.
Upgrades and downgrades do not need intervening versions. For example, if your module is running firmware version 0.1 and you have uploaded a SHU file containing version 0.5, you can upgrade directly to this version. You do not need versions 0.2, 0.3 and 0.4. Same rules apply for downgrades, you do not need the intervening versions.
Next, the New module page:
This page allows you to enter the serial number of new modules. If you have multiple serial numbers to enter, only enter one at a time. The list of serial numbers will appear at the bottom of the window, as in the above image, along with their status.
The In progress page is very simple and contains the same serial number list that the New module page contains:
Finally, the Network page. This details the number of packets received by HQ along with the number of packets missed by HQ (lost in transmission):
This page shows 3 sets of numbers, “5 minutes”, “1 hour” and “1 day”, each containing “Received” and “Lost” counts, with a tally on the last line.
The 5 minute columns are updated every 15 seconds, the 1 hour columns are updated every minute, and the 1 day columns are updated every 15 minutes.
A note about the “Lost” columns. The HQ can only tell when packets have been lost if it is still receiving packets from the module. That’s because there’s a sequence number in each packet, so if HQ receives a packet with sequence number 123, and the next packet it receives has sequence number 125 it knows there has been one packet lost. If the HQ does not receive any packets from a module, either because the module is off or because of connectivity problems, then the HQ will not, and can not, know how many packets were lost, so it will show zero lost.
That’s it for the Modules page. Almost. Check out a TPH module, it has a couple more interesting things to see and do, like calibrating its barometer and configuring its power saving mode.