Repository navigation
First Setup
Everything below is in Settings. Do these once after the first install.
Settings > Radio. Every node on a mesh must use the same frequency, spreading factor, bandwidth and coding rate, or they can't hear each other. Choose the preset your local mesh uses:
| Preset | Settings | Frequency |
|---|---|---|
| Australia | SF10 BW250 CR5 | 915.800 MHz |
| Australia Vic. | SF7 BW62 CR8 | 916.575 MHz |
| EU/UK Narrow (Rec) (default) | SF8 BW62 CR8 | 869.618 MHz |
| EU/UK Long Range | SF11 BW250 CR5 | 869.525 MHz |
| EU/UK Medium | SF10 BW250 CR5 | 869.525 MHz |
| Czech Narrow | SF7 BW62 CR5 | 869.525 MHz |
| EU 433 Long Range | SF11 BW250 CR5 | 433.650 MHz |
| New Zealand | SF11 BW250 CR5 | 917.375 MHz |
| NZ Narrow | SF7 BW62 CR5 | 917.375 MHz |
| Portugal 433 | SF9 BW62 CR6 | 433.375 MHz |
| Portugal 868 | SF7 BW62 CR6 | 869.618 MHz |
| Switzerland | SF8 BW62 CR8 | 869.618 MHz |
| USA/Canada | SF7 BW62 CR5 | 910.525 MHz |
| Vietnam | SF11 BW250 CR5 | 920.250 MHz |
| Japan | SF10 BW125 CR6 | 921.000 MHz |
| Custom | your own values |
Only use frequencies that are legal where you are. Japan (ARIB STD-T108): transmit power is capped at 13 dBm (20 mW) while this preset is selected, and frequency hopping is not available. The preset matches the Japanese MeshCore community's settings, and even the largest packet (about 2.8 s) stays inside ARIB's 4 s limit per transmission. ARIB also requires listen-before-talk (5 ms carrier sense at -80 dBm, then a 50 ms pause), which Saitama does not do yet.
Settings > Device Name. This is the name other people see on your messages and
adverts. It starts as OMS-0001; change it to something people will recognise.
Settings > Storage Password. The row says Default in red until you change it.
Channel keys, remembered repeater passwords and your identity backup are encrypted
on the SD card with this password. The default (changeme1) is published, so until
you change it, anyone who takes your SD card can read them. Pick a password you'll
remember: you need it to restore your identity onto a new or reflashed device. See
Backup and security.
Settings > Timezone, then Settings > Date / Time. With a GPS fix the time is set from GPS automatically. The clock is used for message times and Night Mode.
Other nodes learn about you from your advert. Until they've heard one, they can't send you a direct message.
- T-Deck: open the Advertise app and send one.
-
Cardputer: Settings > Advert sets how often an advert goes out on its own
(every 12 hours by default). To send one now, type
advertin the Terminal.
- Notifications and Notification Sound: popups and sounds for new messages.
- Night Mode: quiet hours, with sounds muted.
- Bluetooth and Bluetooth PIN: to use the MeshCore phone app with the device.
- Screen Timeout: how long before the screensaver starts (10 s by default).
- Theme, Font, Brightness, Language.
- Telemetry: whether others may ask for your battery level and position.
All of these are explained in the Settings reference.