Installing a new Repeater
Installing a node
Take the node from the box and charge it fully over USB-C.
Flashing and configuring
- Connect with USB-C to your computer and open MC flasher in Chrome.
- Repeaters can't be configured in the app, but need their online config tool.
Note to self: we need to have an offline option as well.
When setting up take note to
- Jot down the public key on your laptop so you can later add the repeater to your companion contact list.
- Set preset to EU/UK Narrow.
- Set the location of the node on the map.
Other settings
- set tx 2
- set agc.reset.interval 4
- set multi.acks 1
- set rxdelay 3
- Auto Advert Interval (Flood): Set to 12 hours or more (up to 48 hours).
- Auto Advert Interval (Zero Hop): Set to 0 (disabled).
Public/Private key issues
- Public Key: Check if your auto-generated Public Key prefix (the first two characters) are unique.
- Go to the MeshExplore Stats [1].
- Is there already a repeater using your prefix? If no, you're good to go.
- Is your prefix in use? Scroll down to the MeshExplore Unused Repeater Prefixes.
- Select one you would like to use and the Meshcore Custom Key Generator site will open. You will see the prefix you selected. Click Generate Key.
Copy the public and private keys and save them. We'll finish setting up the repeater and change them at the end using the web console.
- Name: It is helpful if your repeater gives a hint about the location, such as a landmark, neighborhood or cross streets.
- Location: Set the Latitude and Longitude in decimal format (47.xxxx, -122.xxxx).
- Guest and Admin Password: Use a strong password. Repeaters can be administered over the mesh from the Meshcore app.
Radio Settings
- Repeaters and clients use the “USA/Canada (Recommended)” preset.
- Frequency: 910.525 MHz
- Bandwidth: 62.5 kHz
- Spreading Factor: 7
- Coding Rate: 5
Setting Private and Public Keys
If your auto-generated key did not have a unique prefix, you should have generated a new private and public key and saved them. Go back to the Web Flasher [2] and above the list of all the devices, on the right side, click on the Console button and connect to your device. Once you are connected you will see a command prompt:
- At the prompt, type in
set prv.keyand paste in your Private Key. - Type in
reboot. - After your device reboots, verify that the private key is correct by running
get prv.key.
Path hash mode
get path.hash.modeto check current setting (should be 0).- Change it with
set path.hash.mode 1for 2-byte,set path.hash.mode 2for 3-byte.
Region Settings
Should we add `nl-ams` to all repeaters?
Last checks
- Test if you can add the node to your companion user list before you put it in a high and hard-to-reach position.
- Make sure that the solar panel is facing south.
Current issues
- Douwe has to learn how to do OTA updates.
Setup hardware
The setup process is nicely detailed in a booklet in the box.
---
Antenna Docs
Summary
Antennas and their qualities.
Antennas
There are several antennas.
Henk ordered these:
Sensecap Solar P1 OTA
OTA = Over the air
Unfortunately, we first need to flash all the sensecaps with different bootloader firmware.
Adafruit Bootloader
Adafruit Bootloader Repository
Install adafruit-nrfutil
To install the utility, run the following command:
pip3 install adafruit-nrfutil
Download the Firmware
Download the firmware for the Solar P1. Note: the file is named: Seeed Studio XIAO nRF52840 BLE (and Seeed SenseCAP Solar Node). Currently available here:
xiao_nrf52840_ble_bootloader-0.9.2-OTAFIX2.1-BP1.2_s140_7.3.0.zip
Run the following command to flash the firmware:
adafruit-nrfutil --verbose dfu serial --package xiao_nrf52840_ble_bootloader-0.9.2-OTAFIX2.1_s140_7.3.0.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
Flashing Steps
- Open Meshcore Flasher.
- Select the "Sensecap Solar P1".
- Put the Solar P1 in DFU mode.
- ERASE FLASH (Unfortunately, settings and history are lost).
- Flash the (pre-last, not the newest) Meshcore firmware.
- The device will reboot.
OTA (Over the Air - Using Bluetooth to Upgrade Firmware)
- Open the Meshcore client (on your phone).
- Connect the companion device.
- Select the Solar Node in the device list.
- Open "Remote Management".
- Go to "Command Line".
- At the prompt, type:
Start ota.
- It will respond:
OK - mac: xx:xx:xx:xx:xx:xx. - Now open the "Nordic Semiconductor DFU" app.
- Select the ZIP file containing the firmware you want to update.
- Select the device.
- Bluetooth will be turned on.
- Select the Solar P1 (check if the MAC address corresponds with the MAC address you got from the Remote Management command).
- Press "Start".
- Mostly, the first attempt fails...
Retry the Upgrade
- Open the DFU app again.
- Select the device (which is now called "XIAO-DFU").
- Press "Start".
- Wait and monitor the progress until it says "Completed".
- The node will reboot into the freshly installed firmware.