Settings — Radio & User
Configure your node’s user identity, region and LoRa parameters, position and power behavior, network and Bluetooth connectivity, and security settings.
How these screens work
Everything here is on the Settings screen. User, LoRa, Channels and Security are listed there directly. Device, Position, Power, Network, Display and Bluetooth are one level down, under Settings → Device configuration. Network appears only on nodes with Wi-Fi or Ethernet, and Bluetooth only on nodes with Bluetooth.
Settings use standard preference controls — dropdowns, toggles, and sliders:
| Control | Screenshot |
|---|---|
| Dropdown |  |
| Toggle |  |
| Slider |  |
用户设置
User Profile
On Settings → User.
| Setting | 说明 |
|---|---|
| 长名称 | Your display name (up to 39 characters) |
| 短名称 | 4-character abbreviated name |
| 状态消息 | A short, public free-text status other nodes display alongside your node — up to 80 bytes, cleared with the ✕ in the field. The node broadcasts it to the mesh when you change it and again every 12 hours. Needs firmware 2.8 or newer, and is absent otherwise |
| 无法发送消息 | Marks the node as one nobody should try to message — for an unmonitored or infrastructure node. Other clients hide it from the contact list. Needs supporting firmware |
| Licensed amateur node (Ham) | Enable if you hold an amateur node license (permits higher power). Turning it on is staged behind a confirmation dialog. On your own node it then relabels Long Name as Call sign and adds a separate Long Name field; over remote admin the field stays Long Name |
Applying changes
The footer appears as soon as you change something. Discard throws the change away, and the other button writes it to the node: it reads Save & restart on the screens the firmware applies with a reboot — Position, Network, Bluetooth, Security, and most module screens — and Save everywhere else.
The status message is saved with the same Save, but it never reboots the node — and, like the rest of this screen, it can be edited on a remote node you administer. For your own node there is a shortcut while it is connected: touch & hold your node in the node list and choose Update status. Older firmware and a disconnected node have no shortcut — the field itself is still the way in.
Configuration
设备配置
On Settings → Device configuration → Device.
| Setting | 说明 | 默认 |
|---|---|---|
| 设备角色 | Node behavior. The picker lists the firmware names (CLIENT, ROUTER, ROUTER_LATE, TAK, and so on), and the description of whichever role is selected appears under the field. Choosing ROUTER or ROUTER_LATE asks you to confirm you have read the device-role guidance first | CLIENT |
| 转播模式 | How the node retransmits messages. As with the role, the picker lists the firmware names and describes only the selected one | ALL |
| 节点信息广播间隔 | How often the node re-announces itself. A dropdown of fixed intervals — Unset, then 3 to 72 hours — not a value you type in seconds | 3 hours |
| 双击作为按钮 | Treat a double tap as a button press | 禁用 |
| 快速按3下 向所有节点发送紧急广播 | Send an ad-hoc position ping on a triple click | Enabled |
| LED 心跳 | Blink the status LED periodically | Enabled |
| 时区 | POSIX time-zone string for the device clock, with buttons to copy your phone’s zone or clear it | — |
| Button / Buzzer GPIO | Advanced: which pins the button and buzzer are wired to | — |
LoRa 配置
On Settings → LoRa.
| Setting | 说明 | 默认 |
|---|---|---|
| 区域 | Regulatory region for frequency bands. You must set this before transmitting. On firmware 2.8 or newer, the first region set also creates the node’s identity key and gives it a new node number | Unset (must configure) |
| 预设 | Speed/range tradeoff | LongFast |
| 节点数 | Maximum retransmit hops | 3 |
| Transmit Power (dBm) | Transmission power; 0 = max allowed for region | 0 (region max) |
| 频率覆盖 | Overrides the computed operating frequency outright (MHz). It doesn’t offset the calculated value — leave at 0 unless you know you need a specific frequency | 0 (use calculated) |
| 使用预设 | On by default. Turn it off to set Spread Factor, Coding Rate and Bandwidth by hand instead of taking them from the modem preset | On |
| Coding Rate Override | Preset mode only, firmware 2.7.18 or newer: raises the preset’s coding rate for more error correction while keeping its bandwidth and spread factor. Only rates above the preset’s own are offered, and a preset already at 4/8 has none. Nodes on the same preset still hear each other, but every packet takes longer on air and uses more of the duty cycle. Switching to a preset that already meets the override resets it to the preset default | Preset default |
| 扩散因子 | Manual mode only: 5–12. Higher spreads further but slower. On SX127x (RF95) radios the firmware doesn’t accept 5 or 6 and uses 11 instead | From preset |
| 编码率 | Manual mode only: 5–8. More redundancy costs airtime | From preset |
| 带宽 | Manual mode only: the channel bandwidth in kHz, typed in directly. On the 2.4 GHz region the app offers a list of the bandwidths your node supports instead, and a stored value that isn’t on that list shows as Unsupported and blocks saving until you pick a supported one | From preset |
| 频率时隙 | Which slot within the region’s band to use. 0 derives it from the primary channel name | 0 (automatic) |
| 启用传输 | Turning this off makes the node receive-only | On |
| 覆盖占空比 | Ignores the region’s duty-cycle limit. Illegal in most regions; turn it on only where your license permits | 关闭 |
| 忽略 MQTT | Drop packets that arrived from MQTT rather than over the air. The firmware turns this on for you whenever you set a region that has a duty-cycle limit — the EU bands, Thailand, and Ukraine 433 | Off, until you set a duty-cycle-limited region |
| 使用MQTT | Allow your packets to be forwarded to MQTT by gateways | 关闭 |
| RX 增益 | Extra receive gain on SX126x radios; costs a little current | 关闭 |
| PA风扇已禁用 | Turn off the power-amplifier fan on hardware that has one | 关闭 |
The preset list is also filtered to what your region legally permits, so a preset allowed in one region doesn’t appear in another. Changing region can therefore leave your current preset illegal — the app repairs it for you, switching to the region’s own default rather than leaving an unusable setting in place. The region list itself is filtered by what your firmware supports, so the newer regions appear only on 2.8 or later, alongside whichever region the node already has set.
Some regions are amateur-node allocations whose presets only licensed operators may use. On firmware 2.8 or newer the app knows which regions those are and grays the whole Presets list out until Licensed amateur node (Ham) is turned on for the node you are configuring; the text under the field says so while it is grayed out.
⚠️ Important: Operating without the correct region may violate local radio regulations. See the region configuration guide on meshtastic.org for details.
Modem presets
The Lite, Narrow, Medium Turbo, and Tiny presets need firmware 2.8 or newer — the app hides them on older nodes.
💡 Tip: The SNR Limit values are negative on purpose. LoRa can decode signals below the noise floor, so a more-negative limit means the preset tolerates a weaker, noisier signal (more range). See How the Signal Meter Works for the full explanation.
| Preset | Range | 速度 | SNR Limit | Best For |
|---|---|---|---|---|
| Short Turbo | ~1 km | 21.9 kbps | −7.5 dB | Dense urban with line-of-sight; data-heavy applications |
| Short Fast | ~3 km | 10.9 kbps | −7.5 dB | Urban neighborhoods; buildings within a few blocks |
| Short Slow | ~5 km | 6.25 kbps | −10 dB | Suburban short-range; moderate building density |
| Medium Fast | ~5 km | 3.52 kbps | −12.5 dB | Suburban areas; moderate building density |
| Medium Slow | ~8 km | 1.95 kbps | −15 dB | Suburban/rural; moderate range with slower speed |
| Long Turbo | ~10 km | 1.34 kbps | −17.5 dB | Similar range to Long Fast but with 500 kHz bandwidth; faster throughput |
| Long Fast | ~10 km | 1.1 kbps | −17.5 dB | General use (default) — balanced range and speed |
| Long Moderate | ~20 km | 0.34 kbps | −17.5 dB | Rural with some terrain; occasional use |
| Lite Fast | ~5 km | 1.76 kbps | −12.5 dB | EU 866 MHz SRD band (125 kHz BW); comparable to Medium Fast |
| Lite Slow | ~10 km | 0.98 kbps | −15 dB | EU 866 MHz SRD band (125 kHz BW); comparable to Long Fast |
| Narrow Fast | ~5 km | 2.28 kbps | −7.5 dB | EU 868 MHz band (62.5 kHz BW); avoids interference with other devices |
| Narrow Slow | ~10 km | 1.30 kbps | −10 dB | EU 868 MHz band (62.5 kHz BW); comparable to Long Fast |
| Medium Turbo | ~5 km | 7.0 kbps | −12.5 dB | Like Medium Fast but with 500 kHz bandwidth; not legal in every region. Needs firmware 2.8 or newer |
| Tiny Fast | ~10 km | 0.68 kbps | −7.5 dB | Amateur bands that cap occupied bandwidth; these presets use 15.6 kHz. Needs firmware 2.8 or newer, an SX126x or SX127x radio, and a TCXO of ±5 ppm or better |
| Tiny Slow | ~20 km | 0.33 kbps | −10 dB | Same band restrictions as Tiny Fast, longer range. Same firmware, node, and TCXO requirements |
| ~30 km | 0.18 kbps | −20 dB | ⚠️ Deprecated — still selectable but may be removed in a future firmware release | |
| ~40+ km | 0.09 kbps | −20 dB | ⚠️ Deprecated — still selectable but may be removed in a future firmware release |
ℹ️ Note: This table uses the common short names. The app’s Presets dropdown lists the raw firmware names instead —
SHORT_FAST,LONG_FAST,LITE_FAST,NARROW_FAST, and so on. Local Mesh Discovery shows the same presets as Long Fast and Short Turbo.
Choosing a modem preset
The modem preset controls the fundamental tradeoff between range and data rate:
- Slower presets use more spreading, making signals decodable at weaker signal levels (lower SNR limit). This means longer range but fewer bytes per second.
- Faster presets pack more data per transmission but require a stronger signal to decode.
Practical guidance:
- Urban mesh (many nodes, short distances): Use Long Fast (default) or Short Fast. Higher speed means less airtime congestion when many nodes share the channel.
- Rural/sparse mesh (few nodes, long distances): Use Long Moderate. Range matters more than speed when nodes are far apart.
- EU 866/868 MHz regulatory compliance: Use Lite Fast, Lite Slow, Narrow Fast, or Narrow Slow — these are optimized for the EU SRD/868 MHz bands with narrower bandwidths.
- Fixed infrastructure links: Use Short Turbo or Long Turbo for dedicated point-to-point links with good antennas and line-of-sight.
- Mixed environments: Stick with Long Fast — it’s the community default and ensures compatibility with others in your area.
All nodes on the same channel must use the same modem preset. Nodes with mismatched presets can’t communicate even if they share the same frequency and encryption key.
The range estimates in the Modem Presets table assume flat terrain and modest antennas. Elevation advantage (hilltop, rooftop) dramatically increases effective range. A well-placed Router with Long Fast can often outperform a ground-level node with Long Slow.
屏幕配置
On Settings → Device configuration → Display. These control the node’s own screen, not the app’s.
| Setting | 说明 |
|---|---|
| 开启屏幕 | How long the display stays lit before sleeping |
| 轮播间隔 | How often the node cycles between screens on its own |
| 显示模式 | Screen layout/density used by the firmware |
| 显示单位 | Metric or Imperial on the node’s screen |
| 使用 12 小时制格式 | Show the node’s clock as 12-hour rather than 24-hour |
| 加粗标题 | Draw the screen’s heading text in bold |
| 翻转屏幕 | Rotate the display 180° for an inverted mounting |
| OLED 类型 | Six values, shown as the raw constants: OLED_AUTO, OLED_SSD1306, OLED_SH1106, OLED_SH1107, OLED_SH1107_128_128, OLED_SH1107_ROTATED |
| 点击或移动时唤醒屏幕 | Light the screen when the node is tapped or moved |
| 罗盘方向 | Rotation offset for the compass rose. Eight values, shown as the raw constants DEGREES_0 through DEGREES_270 plus an _INVERTED variant of each |
| 总是朝北 | Locks the compass rose north-up instead of rotating it with your heading. Independent of Compass orientation — neither replaces the other |
定位配置
On Settings → Device configuration → Position.
| Setting | 说明 |
|---|---|
| GPS 模式 (物理硬件) | Three-state: GPS enabled, disabled, or not present. Not a simple on/off |
| GPS 轮询间隔 | How often the node asks its GPS for a fix |
| 广播间隔 | How often the position is shared with the mesh |
| 智能位置 | Broadcast based on movement rather than purely on the clock |
| 自动时间间隔 | With Smart Position on, the shortest gap between broadcasts |
| 自动距离大小 | With Smart Position on, how far you must move before broadcasting |
| 固定位置 | Use a manually entered latitude, longitude and altitude instead of the GPS |
| 位置信息数据包 | A group of toggles choosing which fields ride along with a position — altitude, its reference and precision, satellites in view, timestamp, and so on |
| GPS EN / Receive / Transmit GPIO | Advanced: the pins the GPS module is wired to |
电源配置
On Settings → Device configuration → Power.
| Setting | 说明 |
|---|---|
| 启用节能模式 | Let the node sleep aggressively between activity |
| 断电时关机 | Power the device down after external power disappears |
| 深度睡眠时间 | How long the deepest sleep state lasts |
| 最小唤醒时间 | The shortest time the node stays awake once woken |
| 等待蓝牙持续时间 | How long to wait for a phone to connect before sleeping |
| ADC 倍数覆盖 | Turn on a manual correction for battery-voltage readings |
| ADC乘数修正比率 | The correction factor itself, used only when the override is on |
| 电池INA_2XX I2C 地址 | Address of an external INA-series power sensor, if fitted |
网络配置
On Settings → Device configuration → Network, on nodes with Wi-Fi or Ethernet.
⚠️ Warning: Turning on Wi-Fi enabled or Ethernet enabled ends the Bluetooth connection between your phone and the node. Reconnect over the network afterwards from the Connections screen, or turn Wi-Fi off again from the node’s own screen or over USB. Saving this screen also always reboots the node.
| Setting | 说明 |
|---|---|
| Wi-Fi enabled | Enable the Wi-Fi node (ESP32 nodes) |
| SSID | Network name to connect to. Appears only once Wi-Fi enabled is on, along with Password. Scan Wi-Fi QR code fills both from a standard Wi-Fi QR code; on Android, holding the phone against a Wi-Fi NFC tag while this screen is open fills them the same way, and the app offers to open system settings if NFC is turned off |
| 密码 | 网络密码 |
| 启用以太网 | Use a wired connection on hardware that has one |
| IPv4模式 | DHCP, or a static address configured with the four fields that follow |
| Wi-Fi IP / Subnet / Gateway / DNS | The static address, only used when IPv4 mode is static |
| UDP 广播 | Share mesh traffic with other nodes over the local network |
| NTP 服务器 | Time synchronization server |
| rsyslog 服务器 | Remote logging server |
蓝牙配置
On Settings → Device configuration → Bluetooth, on nodes with Bluetooth.
| Setting | 说明 |
|---|---|
| 启用蓝牙 | Enable/disable BLE radio |
| 配对模式 | Fixed PIN, Random PIN, or No PIN |
| 固定PIN码 | PIN code for pairing. Must be exactly six digits — the field rejects anything else |
安全配置
On Settings → Security. The screen is grouped into cards: Packet authenticity, Direct Message Key (your node’s key pair), Admin Keys, Logs, and Administration.
| Setting | 说明 |
|---|---|
| 公钥 | Your node’s public key (read-only) |
| 管理员密钥 | Keys permitted to administer this node remotely — up to three |
| 私钥 | Your node’s private key (handle securely). Shown redacted when you are viewing another node over remote admin — the firmware doesn’t send it |
| 重新生成私钥 | Issues a new keypair for this node, behind a confirmation. Every peer that knew your old key must learn the new one |
| ⚠️ Removed — now configured automatically when an admin key is set | |
| 串口控制 | Serial console over the Stream API |
| 启用调试日志 API | Output live debug logging over serial, and view and export position-redacted node logs over Bluetooth |
| 管理模式 | Locks the whole Configuration list, not just channels — every setting on the node becomes read-only and only an admin can change anything. Only selectable once an Admin Key is set |
| 备份密钥 | Save an encrypted backup of the node’s keys on this phone (only for your own node) |
| 恢复密钥 | Write the backed-up keys back to the node (available once a backup exists) |
| 删除密钥备份 | Remove the stored key backup from this phone |
| 安全等级 | How unsigned or relayed packets are treated: Strict — Require authentication, Balanced — Prefer authenticated, or Compatible — Accept unsigned (requires supporting firmware; Strict asks for confirmation) |
Lockdown Mode
Lockdown encrypts the device’s storage and requires a passphrase for each connection. It needs supporting firmware; the row doesn’t appear otherwise.
Enabling it asks you to set and confirm a passphrase, and to acknowledge that it locks the debug (SWD) port on hardware where the lockout takes effect. That part isn’t reversible from the app. Turning lockdown off later decrypts your storage and reboots the device, but the port stays locked. Reopening it takes a full chip erase with a debug probe, which destroys everything on the device.
Alongside the passphrase you set the limits that end a session automatically:
| Field | What it does |
|---|---|
| 剩余启动次数 | How many device boots the unlocked state survives |
| 距离失效还有多少小时 | Wall-clock lifetime of the unlocked state |
| 会话上限 (分钟) | A per-boot uptime cap on the unlocked state. 0, the default, means no cap |
Once active, the row reads Active — storage encrypted, this connection authenticated when unlocked, or Active — enter your passphrase to unlock this connection when not. Lock Now ends the current session immediately. Repeated wrong passphrases are rate-limited with a back-off before you can try again.
⚠️ Warning: There is no passphrase recovery. Losing it means erasing the device to get it back, which destroys its keys, channels and settings.
Related Topics
- Settings — Modules & Admin — optional feature modules and device administration
- Signal Meter — how modem presets affect signal quality thresholds
- LoRa configuration — detailed LoRa settings reference on meshtastic.org
- Initial configuration — region setup guide on meshtastic.org