Installing a new Repeater

From NodeNet
Revision as of 09:31, 18 March 2026 by Douwe (talk | contribs) (Created page with "== 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 [https://flasher.meshcore.co.uk/ MC flasher] in Chrome. * Repeaters can't be configured in the app, but need their [https://config.meshcore.dev/ 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...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

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.key and 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.mode to check current setting (should be 0).
  • Change it with set path.hash.mode 1 for 2-byte, set path.hash.mode 2 for 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:

File:Antenna order.png
Antenna bill


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
File:Adafr dfu.png
adafruit-nrfutil

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.
File:Ota img.png
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.
File:Dfuapp.png
DFU App
  • Select the Solar P1 (check if the MAC address corresponds with the MAC address you got from the Remote Management command).
  • Press "Start".
File:Fwupfault.png
Firmware Upgrade - First Attempt
  • Mostly, the first attempt fails...

Retry the Upgrade

  • Open the DFU app again.
  • Select the device (which is now called "XIAO-DFU").
  • Press "Start".
File:Fwupgrade.png
Firmware Upgrade Progress
File:Fwup.png
Firmware Upgrade Complete
  • Wait and monitor the progress until it says "Completed".
  • The node will reboot into the freshly installed firmware.