Installing a new Repeater

From NodeNet
Revision as of 13:55, 23 March 2026 by Douwe (talk | contribs)
Jump to navigationJump to search

Installing a node

Look here to update a note.

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 12

Sets the LoRa transmit power level in dBm. This setting only controls the power level of the LoRa chip; some nodes have an additional power amplifier stage that increases the total output. For a SenseCap solar node, a low TX setting like 2 conserves battery but limits range. Most EU repeaters use values between 10–20.

set agc.reset.interval 4

Sets the interval (in seconds, rounded down to a multiple of 4) at which the Auto Gain Controller is reset. Default is 0 (disabled).The AGC controls the receiver's sensitivity to incoming signals. After exposure to a strong nearby signal, the receiver can become "deaf" — it lowers its gain and doesn't recover. Setting agc.reset.interval 4 periodically resets the AGC to cure this deafness, and it is a very low-cost operation.

set multi.acks 1

Enables or disables the "double ACKs" feature. Values: 0 = disable, 1 = enable. Default is 0. When enabled, the node sends an acknowledgement packet twice, improving the chance that the sender actually receives confirmation in a lossy radio environment.

set rxdelay 3

Sets an experimental receive delay base (range 0–20, default 0) that applies a slight delay to received packets before retransmitting, based on signal strength. Stronger signals get shorter delays; weaker signals get longer ones. This helps prevent repeaters from immediately reacting to low-quality packets while ensuring the stronger, more central paths transmit first. Is On A value of 3 is moderate.

= Auto Advert settings

  • Auto Advert Interval (Flood): Set to 162 hours (max)
  • Auto Advert Interval (Zero Hop): Set to 48.

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 “EU/UK Narrow” preset.
    • Frequency: 869.618 MHz
    • Bandwidth: 62.5 kHz
    • Spreading Factor: 8
    • Coding Rate: 8

= Explenation of settings

Spreading Factor: 8 The spreading factor controls the chirp rate in LoRa's Chirp Spread Spectrum modulation, and thus controls the speed of data transmission. Lower spreading factors mean faster data rates but shorter range; higher ones mean longer range but slower transmission. SF8 is a mid-low value that favours reasonable data speed over maximum range — suitable for urban or semi-urban mesh networks.

Coding Rate: 8 — This refers to a coding rate of 4/8 (also written as CR=4). LoRa adds forward error correction by encoding 4 bits of data into 5, 6, 7, or 8 bits of redundancy. A higher coding rate improves link reliability in the presence of interference but reduces data throughput. Josef Matondang CR 4/8 is the maximum redundancy setting — half the transmitted data is error correction. This is an aggressive choice that prioritises reliability over speed, appropriate for the narrow 62.5 kHz bandwidth used here.


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

  • none

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