View source for MeshCore/MeshMapper-Friendly Repeaters

{{DISPLAYTITLE:MeshMapper-Friendly Repeaters}}
<span id="meshmapper-friendly-repeater-configuration-spec-for-scotmesh-meshcore"></span>
== MeshMapper-Friendly Repeater Configuration Spec for Scotmesh MeshCore ==

These are guidelines for a uniform configuration of repeaters taking part in '''Scotmesh MeshCore'''.

These are not hard and fast rules, but certain specifications are necessary for smooth MeshMapper reporting. Using these settings will help ensure a smooth-running mesh.


-----

<span id="identification"></span>
=== Identification ===

Use '''ASCII characters only''' for the repeater name.

This makes MeshMapper management much easier, as most emoji characters are '''not''' read by MeshMapper.

You can use a single emoji to customise your MeshCore app icon on your companion radio, but this has no effect on the repeater name as seen by MeshMapper.


-----

<span id="location"></span>
=== Location ===

Repeater location should be set as accurately as possible, while still protecting the safety and security of the repeater site.

For example, setting the repeater location around '''200 metres''' from the real location gives a search area of approximately '''12.6 hectares'''. This would take a careful walking search of around '''8 hours''' to cover.

Setting the location '''200–250 metres away''' from the real position gives a useful level of obfuscation while still allowing the repeater to appear correctly on MeshMapper.

If no location is set:

* The repeater will be excluded from MeshMapper
* You will not see useful telemetry, such as zero-hop neighbours
* Routing path analysis, enhancements and other mesh planning will not be possible


-----

<span id="basic-owner-information"></span>
=== Basic Owner Information ===

Please ensure basic owner information is set.


-----

<span id="advert-settings"></span>
=== Advert Settings ===

Recommended settings:

* '''Zero-hop advert:''' 60–120 minutes
* '''Flood advert:''' 24 hours


-----

<span id="radio-settings"></span>
=== Radio Settings ===

Please use:

* '''UK / EU Narrow'''
* '''Frequency:''' 869.618 MHz
* '''Spreading Factor:''' SF8
* '''Coding Rate:''' CR8
* '''Bandwidth:''' 62.5 kHz

Recommended CLI settings:

<syntaxhighlight lang="text">set multi.acks 1
set path.hash.mode 2</syntaxhighlight>
This enables:

* '''Multi ACKs'''
* '''3-byte path hash'''

Please keep your repeater updated with the latest firmware whenever possible.

Please also ensure your companion radio or radios are set to:

* '''Double ACKs on'''
* '''3-byte path hash'''


-----

<span id="access"></span>
=== Access ===

Do not leave the guest login with no password.

For continuity, please set the guest password to:

<syntaxhighlight lang="text">hello</syntaxhighlight>
This gives at least some security over the guest login.

Keep your admin password safe.


-----

<span id="region-scope"></span>
=== Region / Scope ===

Please set both the '''default scope''' and '''home scope''' to:

<syntaxhighlight lang="text">sco</syntaxhighlight>
Please also deny flood to:

<syntaxhighlight lang="text">*</syntaxhighlight>
Channels set to region <code>sco</code> are:

* <code>Public</code>
* <code>#scotland</code>

Optionally, you may also add the channel:

<syntaxhighlight lang="text">#ireland</syntaxhighlight>
with region:

<syntaxhighlight lang="text">ioi</syntaxhighlight>
Scotland and the Island of Ireland have collaborated very well to construct a civilised MeshCore environment.

As Scotmesh expands, we may add nested sub-regions within <code>sco</code>.


-----

<span id="time-setting-and-synchronisation-with-meshmapper"></span>
=== Time Setting and Synchronisation with MeshMapper ===

After power-up of the repeater, the time is always incorrect.

Please use the following procedure to set the correct time and synchronise it with MeshMapper.

This process assumes you have already configured the repeater for use.

<span id="phone-app-method"></span>
==== Phone App Method ====

# Open the settings page in the phone app.
# Perform the usual '''Sync Clock''' action.
# Scroll to the bottom of the page.
# Tap '''Reboot'''.

Unlike pressing the physical '''reset''' button on the repeater board, this is a '''soft reset'''.

A soft reset does '''not''' reset the clock, but it appears to be important for finalising certain settings.

For reference:

* Pressing '''Reboot''' in the app is a '''soft reset'''
* Pressing the physical reset button on the board is a '''hard reset'''
* A hard reset resets all settings not stored in flash

You may also use CLI commands to perform the same task if preferred.


-----

<span id="closing-note"></span>
=== Closing Note ===

I hope this helps with the ease of configuration.

This guide assumes you already understand the menu and command structure of MeshCore repeaters, devices and apps.

If there is a menu item you cannot find, ask on the Discord server and one of the admins or knowledgeable users will help you along.ur content here