mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-09-28 22:55:03 -04:00
2 lines
59 KiB
HTML
2 lines
59 KiB
HTML
<!DOCTYPE html> <html lang="en-US"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> <link rel="stylesheet" href="/Meshtastic-Android/main/assets/css/just-the-docs-default.css"> <link rel="stylesheet" href="/Meshtastic-Android/main/assets/css/just-the-docs-head-nav.css" id="jtd-head-nav-stylesheet"> <style id="jtd-nav-activation"> .site-nav ul li a { background-image: none; } </style> <script src="/Meshtastic-Android/main/assets/js/vendor/lunr.min.js"></script> <script src="/Meshtastic-Android/main/assets/js/just-the-docs.js"></script> <meta name="viewport" content="width=device-width, initial-scale=1"> <!-- Begin Jekyll SEO tag v2.9.0 --> <title>Settings — Modules & Admin | Meshtastic Android</title> <meta name="generator" content="Jekyll v4.4.1" /> <meta property="og:title" content="Settings — Modules & Admin" /> <meta property="og:locale" content="be_rBY" /> <meta name="description" content="Configure optional feature modules (MQTT, telemetry, canned messages, TAK, and more) and perform device administration." /> <meta name="twitter:description" property="og:description" content="Configure optional feature modules (MQTT, telemetry, canned messages, TAK, and more) and perform device administration." /> <link rel="canonical" href="/Meshtastic-Android/main/be-rBY/user/settings-module-admin.html" /> <meta property="og:url" content="/Meshtastic-Android/main/be-rBY/user/settings-module-admin.html" /> <meta property="og:site_name" content="Meshtastic Android" /> <meta property="og:type" content="website" /> <meta name="twitter:card" content="summary" /> <meta name="twitter:title" content="Settings — Modules & Admin" /> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"WebPage","description":"Configure optional feature modules (MQTT, telemetry, canned messages, TAK, and more) and perform device administration.","headline":"Settings — Modules & Admin","url":"/Meshtastic-Android/main/be-rBY/user/settings-module-admin.html"}</script> <!-- End Jekyll SEO tag --> <!-- Inter font from Google Fonts --> <link rel="preconnect" href="https://fonts.googleapis.com"> <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet"> <style> /* M3-inspired typography */ :root { --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif; --font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', ui-monospace, monospace; } body, .site-title, .search-input { font-family: var(--font-sans) !important; } code, pre, .highlight { font-family: var(--font-mono) !important; font-size: 0.875em; } /* M3 surface elevation & rounding */ .main-content table { border-radius: 12px; overflow: hidden; } .main-content blockquote { border-radius: 12px; padding: 1rem 1.25rem; border-left-width: 4px; } .main-content pre { border-radius: 12px; } .main-content code { border-radius: 6px; padding: 0.15em 0.4em; } /* Smooth transitions for theme switching */ body, .side-bar, .main, .main-content, .site-header, .search-input, .search-results, a { transition: background-color 0.2s ease, color 0.2s ease, border-color 0.2s ease; } /* Theme toggle button styling */ .theme-toggle { background: none; border: 1px solid var(--border-color, #D5D6E0); border-radius: 20px; padding: 6px 12px; cursor: pointer; font-family: var(--font-sans); font-size: 0.75rem; font-weight: 500; display: inline-flex; align-items: center; gap: 6px; color: inherit; margin: 0 auto; transition: background-color 0.2s ease, border-color 0.2s ease; } .theme-toggle:hover { background-color: rgba(128, 128, 128, 0.1); } .theme-toggle-wrap { text-align: center; padding: 12px 0 4px; } /* Heading weight refinement */ h1, h2, h3, h4, h5, h6 { font-weight: 600; letter-spacing: -0.01em; } h1 { font-weight: 700; letter-spacing: -0.02em; } /* Smooth anchor scroll */ html { scroll-behavior: smooth; } /* Language switcher */ .language-switcher { display: inline-block; position: relative; margin-left: 8px; } .language-switcher-btn { cursor: pointer; font-size: 0.8rem; font-weight: 500; font-family: var(--font-sans); list-style: none; padding: 4px 10px; border: 1px solid var(--border-color, #D5D6E0); border-radius: 16px; display: inline-flex; align-items: center; gap: 4px; transition: background-color 0.2s ease; } .language-switcher-btn:hover { background-color: rgba(128, 128, 128, 0.1); } .language-switcher[open] .language-switcher-list { display: block; } .language-switcher-list { position: absolute; top: 100%; right: 0; left: auto; z-index: 100; list-style: none; padding: 8px 0; margin: 4px 0 0; min-width: 140px; background: var(--body-background-color, #fff); border: 1px solid var(--border-color, #D5D6E0); border-radius: 12px; box-shadow: 0 4px 12px rgba(0,0,0,0.1); } .language-switcher-list li { padding: 0; } .language-switcher-list a { display: block; padding: 6px 16px; text-decoration: none; font-size: 0.85rem; color: inherit; } .language-switcher-list a:hover { background-color: rgba(103, 234, 148, 0.15); } /* Version switcher (shares the language-switcher dropdown styling) */ .version-switcher { margin-left: 8px; } .version-switcher[hidden] { display: none; } /* Link out to the upstream meshtastic.org docs */ .upstream-docs-link { display: inline-flex; align-items: center; margin-left: 8px; padding: 4px 10px; border: 1px solid var(--border-color, #D5D6E0); border-radius: 16px; font-size: 0.8rem; font-weight: 500; font-family: var(--font-sans); text-decoration: none; color: inherit; transition: background-color 0.2s ease; } .upstream-docs-link:hover { background-color: rgba(128, 128, 128, 0.1); } </style> <script> // Respect OS preference on first visit, then remember user choice (function() { var stored = localStorage.getItem('jtd-theme'); if (stored) return; // will be applied by jtd.setTheme below if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) { localStorage.setItem('jtd-theme', 'meshtastic-dark'); } })(); </script> </head> <body> <a class="skip-to-main" href="#main-content">Skip to main content</a> <svg xmlns="http://www.w3.org/2000/svg" class="d-none"> <symbol id="svg-link" viewBox="0 0 24 24"> <title>Link</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"> <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path> </svg> </symbol> <symbol id="svg-menu" viewBox="0 0 24 24"> <title>Menu</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu"> <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line> </svg> </symbol> <symbol id="svg-arrow-right" viewBox="0 0 24 24"> <title>Expand</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right"> <polyline points="9 18 15 12 9 6"></polyline> </svg> </symbol> <!-- Feather. MIT License: https://github.com/feathericons/feather/blob/master/LICENSE --> <symbol id="svg-external-link" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-external-link"> <title id="svg-external-link-title">(external link)</title> <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line> </symbol> <symbol id="svg-doc" viewBox="0 0 24 24"> <title>Document</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file"> <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline> </svg> </symbol> <symbol id="svg-search" viewBox="0 0 24 24"> <title>Search</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search"> <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </symbol> <!-- Bootstrap Icons. MIT License: https://github.com/twbs/icons/blob/main/LICENSE.md --> <symbol id="svg-copy" viewBox="0 0 16 16"> <title>Copy</title> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard" viewBox="0 0 16 16"> <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1v-1z"/> <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3z"/> </svg> </symbol> <symbol id="svg-copied" viewBox="0 0 16 16"> <title>Copied</title> <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard-check-fill" viewBox="0 0 16 16"> <path d="M6.5 0A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3Zm3 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3Z"/> <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1A2.5 2.5 0 0 1 9.5 5h-3A2.5 2.5 0 0 1 4 2.5v-1Zm6.854 7.354-3 3a.5.5 0 0 1-.708 0l-1.5-1.5a.5.5 0 0 1 .708-.708L7.5 10.793l2.646-2.647a.5.5 0 0 1 .708.708Z"/> </svg> </symbol> </svg> <header class="side-bar"> <div class="site-header"> <a href="/Meshtastic-Android/main/" class="site-title lh-tight"> Meshtastic Android </a> <button id="menu-button" class="site-button btn-reset" aria-label="Menu" aria-expanded="false"> <svg viewBox="0 0 24 24" class="icon" aria-hidden="true"><use xlink:href="#svg-menu"></use></svg> </button> </div> <nav aria-label="Main" id="site-nav" class="site-nav"> <ul class="nav-list"><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/" class="nav-list-link">Home</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/" class="nav-list-link">Home</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="User Guide submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/Meshtastic-Android/main/en/user.html" class="nav-list-link">User Guide</a><ul class="nav-list"><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/onboarding.html" class="nav-list-link">Getting Started</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/onboarding.html" class="nav-list-link">Getting Started</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/connections.html" class="nav-list-link">Connexions</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/connections.html" class="nav-list-link">Connections</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/messages-and-channels.html" class="nav-list-link">Messages & Channels</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/messages-and-channels.html" class="nav-list-link">Messages & Channels</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/nodes.html" class="nav-list-link">Nœuds</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/nodes.html" class="nav-list-link">Nodes</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/node-metrics.html" class="nav-list-link">Node Metrics</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/node-metrics.html" class="nav-list-link">Node Metrics</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/map-and-waypoints.html" class="nav-list-link">Map & Waypoints</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/map-and-waypoints.html" class="nav-list-link">Map & Waypoints</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/settings-radio-user.html" class="nav-list-link">Settings — Radio & User</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/settings-radio-user.html" class="nav-list-link">Settings — Radio & User</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/settings-module-admin.html" class="nav-list-link">Settings — Modules & Admin</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/settings-module-admin.html" class="nav-list-link">Settings — Modules & Admin</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/telemetry-and-sensors.html" class="nav-list-link">Telemetry & Sensors</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/telemetry-and-sensors.html" class="nav-list-link">Telemetry & Sensors</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/tak.html" class="nav-list-link">TAK Integration</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/tak.html" class="nav-list-link">TAK Integration</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/mqtt.html" class="nav-list-link">MQTT</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/mqtt.html" class="nav-list-link">MQTT</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/discovery.html" class="nav-list-link">Découverte de maille locale</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/discovery.html" class="nav-list-link">Local Mesh Discovery</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/firmware.html" class="nav-list-link">Firmware Updates</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/firmware.html" class="nav-list-link">Firmware Updates</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/desktop.html" class="nav-list-link">Desktop App</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/desktop.html" class="nav-list-link">Desktop App</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/signal-meter.html" class="nav-list-link">How the Meshtastic Signal Meter Works</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/signal-meter.html" class="nav-list-link">How the Meshtastic Signal Meter Works</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/units-and-locale.html" class="nav-list-link">Units, Measurement & Locale</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/units-and-locale.html" class="nav-list-link">Units, Measurement & Locale</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/fr-rCA/user/translate.html" class="nav-list-link">Translate the App</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/translate.html" class="nav-list-link">Translate the App</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/app-functions.html" class="nav-list-link">App Functions</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/widget.html" class="nav-list-link">Home Screen Widget</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/help-and-docs.html" class="nav-list-link">Help & In-App Docs</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/user/debug-logs.html" class="nav-list-link">Debug Logs</a></li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Developer Guide submenu" aria-expanded="false"> <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg> </button><a href="/Meshtastic-Android/main/en/developer.html" class="nav-list-link">Developer Guide</a><ul class="nav-list"><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/architecture.html" class="nav-list-link">Architecture</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/codebase.html" class="nav-list-link">Codebase</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/adding-a-feature-module.html" class="nav-list-link">Adding a Feature Module</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/navigation-and-deep-links.html" class="nav-list-link">Navigation & Deep Links</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/transport.html" class="nav-list-link">Transport</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/persistence.html" class="nav-list-link">Persistence</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/testing.html" class="nav-list-link">Testing</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/contributing.html" class="nav-list-link">Contributing</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/measurement.html" class="nav-list-link">Measurement & Formatting</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/test-builds.html" class="nav-list-link">Test Builds & Obtainium</a></li><li class="nav-list-item"><a href="/Meshtastic-Android/main/en/developer/documentation-style.html" class="nav-list-link">Documentation Style</a></li></ul></li></ul> </nav> <div class="d-md-block d-sm-none"> <div class="site-footer"> This site uses <a href="https://github.com/just-the-docs/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll. </div> </div> </header> <div class="main" id="top"> <div id="main-header" class="main-header"> <div class="search" role="search"> <div class="search-input-wrap"> <input type="text" id="search-input" class="search-input" tabindex="0" placeholder="Search Meshtastic Android" autocomplete="off"> <label for="search-input" class="search-label"> <span class="sr-only">Search Meshtastic Android</span> <svg viewBox="0 0 24 24" class="search-icon" aria-hidden="true"><use xlink:href="#svg-search"></use></svg> </label> </div> <div id="search-results" class="search-results"></div> </div> <div class="theme-toggle-wrap"> <button class="theme-toggle" id="theme-toggle" aria-label="Toggle dark mode" title="Toggle light/dark theme" onclick="toggleMeshtasticTheme()"> <span id="theme-icon">🌙</span> <span id="theme-label">Dark</span> </button> <details class="language-switcher version-switcher" id="version-switcher" aria-label="Documentation version" hidden> <summary class="language-switcher-btn" title="Switch documentation version"> 🏷️ <span id="version-current"></span> </summary> <ul class="language-switcher-list" id="version-switcher-list"></ul> </details> <script> (function() { var baseurl = '/Meshtastic-Android/main'; var root = baseurl; var channel = 'latest'; // /main/, /vX.Y.Z/ or a prerelease snapshot like /v2.8.0-open.1/. var match = baseurl.match(/^(.*)\/(main|v\d+\.\d+\.\d+(?:-(?:open|closed)\.\d+)?)$/); if (match) { root = match[1]; channel = match[2]; } fetch(root + '/versions.json') .then(function(res) { return res.ok ? res.json() : Promise.reject(); }) .then(function(data) { var switcher = document.getElementById('version-switcher'); var list = document.getElementById('version-switcher-list'); var current = document.getElementById('version-current'); if (!switcher || !list || !current) return; // Keep the reader on the same page when switching channels; a page // that doesn't exist in the target version lands on the 404 page. var relativePath = location.pathname.slice(baseurl.length) + location.hash; var entries = []; if (data.latest) { entries.push({ id: 'latest', label: 'latest (v' + data.latest + ')', base: root }); } // Prereleases are documented ahead of general availability, so the track // is always spelled out — a reader must not mistake a closed-testing // snapshot for a shipped release. (data.prereleases || []).forEach(function(p) { entries.push({ id: p.dir, label: p.dir.replace(/^v/, 'v') + ' — ' + p.track + ' testing', base: root + '/' + p.dir }); }); if (data.hasMain) { entries.push({ id: 'main', label: 'main (unreleased snapshot)', base: root + '/main' }); } (data.versions || []).forEach(function(v) { entries.push({ id: 'v' + v, label: 'v' + v, base: root + '/v' + v }); }); var currentEntry = entries.filter(function(e) { return e.id === channel; })[0]; current.textContent = currentEntry ? currentEntry.label : channel; var others = entries.filter(function(e) { return e.id !== channel; }); if (others.length === 0) return; others.forEach(function(e) { var li = document.createElement('li'); var a = document.createElement('a'); a.href = e.base + relativePath; a.textContent = e.label; li.appendChild(a); list.appendChild(li); }); switcher.hidden = false; }) .catch(function() { /* no manifest (local build) — leave switcher hidden */ }); })(); </script> <details class="language-switcher" aria-label="Language options"> <summary class="language-switcher-btn" title="View in another language"> 🌐 <span class="lang-current">Беларуская</span> </summary> <ul class="language-switcher-list"> <li><a href="/Meshtastic-Android/main/en/user/settings-module-admin" lang="en">English</a></li> <li><a href="/Meshtastic-Android/main/ar-rSA/user/settings-module-admin" lang="ar-rSA" dir="rtl">العربية</a></li> <li><a href="/Meshtastic-Android/main/bg-rBG/user/settings-module-admin" lang="bg-rBG" >Български</a></li> <li><a href="/Meshtastic-Android/main/ca-rES/user/settings-module-admin" lang="ca-rES" >Català</a></li> <li><a href="/Meshtastic-Android/main/cs-rCZ/user/settings-module-admin" lang="cs-rCZ" >Čeština</a></li> <li><a href="/Meshtastic-Android/main/de-rDE/user/settings-module-admin" lang="de-rDE" >Deutsch</a></li> <li><a href="/Meshtastic-Android/main/el-rGR/user/settings-module-admin" lang="el-rGR" >Ελληνικά</a></li> <li><a href="/Meshtastic-Android/main/es-rES/user/settings-module-admin" lang="es-rES" >Español</a></li> <li><a href="/Meshtastic-Android/main/et-rEE/user/settings-module-admin" lang="et-rEE" >Eesti</a></li> <li><a href="/Meshtastic-Android/main/fi-rFI/user/settings-module-admin" lang="fi-rFI" >Suomi</a></li> <li><a href="/Meshtastic-Android/main/fr-rFR/user/settings-module-admin" lang="fr-rFR" >Français</a></li> <li><a href="/Meshtastic-Android/main/ga-rIE/user/settings-module-admin" lang="ga-rIE" >Gaeilge</a></li> <li><a href="/Meshtastic-Android/main/gl-rES/user/settings-module-admin" lang="gl-rES" >Galego</a></li> <li><a href="/Meshtastic-Android/main/iw-rIL/user/settings-module-admin" lang="iw-rIL" dir="rtl">עברית</a></li> <li><a href="/Meshtastic-Android/main/hr-rHR/user/settings-module-admin" lang="hr-rHR" >Hrvatski</a></li> <li><a href="/Meshtastic-Android/main/ht-rHT/user/settings-module-admin" lang="ht-rHT" >Kreyòl Ayisyen</a></li> <li><a href="/Meshtastic-Android/main/hu-rHU/user/settings-module-admin" lang="hu-rHU" >Magyar</a></li> <li><a href="/Meshtastic-Android/main/is-rIS/user/settings-module-admin" lang="is-rIS" >Íslenska</a></li> <li><a href="/Meshtastic-Android/main/it-rIT/user/settings-module-admin" lang="it-rIT" >Italiano</a></li> <li><a href="/Meshtastic-Android/main/ja-rJP/user/settings-module-admin" lang="ja-rJP" >日本語</a></li> <li><a href="/Meshtastic-Android/main/ko-rKR/user/settings-module-admin" lang="ko-rKR" >한국어</a></li> <li><a href="/Meshtastic-Android/main/lt-rLT/user/settings-module-admin" lang="lt-rLT" >Lietuvių</a></li> <li><a href="/Meshtastic-Android/main/nl-rNL/user/settings-module-admin" lang="nl-rNL" >Nederlands</a></li> <li><a href="/Meshtastic-Android/main/no-rNO/user/settings-module-admin" lang="no-rNO" >Norsk</a></li> <li><a href="/Meshtastic-Android/main/pl-rPL/user/settings-module-admin" lang="pl-rPL" >Polski</a></li> <li><a href="/Meshtastic-Android/main/pt-rBR/user/settings-module-admin" lang="pt-rBR" >Português (Brasil)</a></li> <li><a href="/Meshtastic-Android/main/pt-rPT/user/settings-module-admin" lang="pt-rPT" >Português</a></li> <li><a href="/Meshtastic-Android/main/ro-rRO/user/settings-module-admin" lang="ro-rRO" >Română</a></li> <li><a href="/Meshtastic-Android/main/ru-rRU/user/settings-module-admin" lang="ru-rRU" >Русский</a></li> <li><a href="/Meshtastic-Android/main/sk-rSK/user/settings-module-admin" lang="sk-rSK" >Slovenčina</a></li> <li><a href="/Meshtastic-Android/main/sl-rSI/user/settings-module-admin" lang="sl-rSI" >Slovenščina</a></li> <li><a href="/Meshtastic-Android/main/sq-rAL/user/settings-module-admin" lang="sq-rAL" >Shqip</a></li> <li><a href="/Meshtastic-Android/main/sr-rLatn/user/settings-module-admin" lang="sr-rLatn" >Српски (Latinica)</a></li> <li><a href="/Meshtastic-Android/main/srp/user/settings-module-admin" lang="srp" >Српски (Ћирилица)</a></li> <li><a href="/Meshtastic-Android/main/sv-rSE/user/settings-module-admin" lang="sv-rSE" >Svenska</a></li> <li><a href="/Meshtastic-Android/main/tr-rTR/user/settings-module-admin" lang="tr-rTR" >Türkçe</a></li> <li><a href="/Meshtastic-Android/main/uk-rUA/user/settings-module-admin" lang="uk-rUA" >Українська</a></li> <li><a href="/Meshtastic-Android/main/zh-rCN/user/settings-module-admin" lang="zh-rCN" >中文 (简体)</a></li> <li><a href="/Meshtastic-Android/main/zh-rTW/user/settings-module-admin" lang="zh-rTW" >中文 (繁體)</a></li> </ul> </details> <a class="upstream-docs-link" href="https://meshtastic.org/docs/" title="Official Meshtastic documentation (meshtastic.org)">Meshtastic Docs ↗</a> </div> <script> function toggleMeshtasticTheme() { var current = localStorage.getItem('jtd-theme') || 'meshtastic'; var next = (current === 'meshtastic-dark') ? 'meshtastic' : 'meshtastic-dark'; if (typeof jtd !== 'undefined' && typeof jtd.setTheme === 'function') { jtd.setTheme(next); } localStorage.setItem('jtd-theme', next); var icon = document.getElementById('theme-icon'); var label = document.getElementById('theme-label'); if (icon && label) { icon.textContent = (next === 'meshtastic-dark') ? '☀️' : '🌙'; label.textContent = (next === 'meshtastic-dark') ? 'Light' : 'Dark'; } } // Apply stored/OS theme on page load (function() { var theme = localStorage.getItem('jtd-theme') || 'meshtastic'; // Sync toggle label immediately var icon = document.getElementById('theme-icon'); var label = document.getElementById('theme-label'); if (icon && label) { icon.textContent = (theme === 'meshtastic-dark') ? '☀️' : '🌙'; label.textContent = (theme === 'meshtastic-dark') ? 'Light' : 'Dark'; } // Apply theme once jtd is ready function tryApply() { if (typeof jtd !== 'undefined' && typeof jtd.setTheme === 'function') { jtd.setTheme(theme); } else { setTimeout(tryApply, 50); } } tryApply(); })(); </script> </div> <div class="main-content-wrap"> <nav aria-label="Breadcrumb" class="breadcrumb-nav"> <ol class="breadcrumb-nav-list"> <li class="breadcrumb-nav-list-item"><a href="/Meshtastic-Android/main/en/user.html">User Guide</a></li> <li class="breadcrumb-nav-list-item"><span>Settings — Modules & Admin</span></li> </ol> </nav> <div id="main-content" class="main-content"> <main> <div class="locale-page-banner" > <p class="locale-notice"> 🌐 <strong>Беларуская</strong> — Community translation <a href="/Meshtastic-Android/main/en/user/settings-module-admin">View in English</a> </p> </div> <div lang="be-rBY"> <h1 id="settings--modules--admin"> <a href="#settings--modules--admin" class="anchor-heading" aria-labelledby="settings--modules--admin"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Settings — Modules & Admin </h1> <p>Configure optional feature modules and perform device administration. Modules extend Meshtastic with specialized capabilities — each can be independently enabled or disabled.</p> <blockquote> <p>💡 <strong>Tip:</strong> You only need to enable the modules you actually use. Disabling unused modules reduces airtime, saves battery, and simplifies your configuration. A module you expect can be missing for three reasons: your node’s role does not enable it, your firmware is older than the release that added it, or the firmware build excludes it for this hardware.</p> </blockquote> <p>Module settings use a card-based layout with toggle switches, dropdowns, text fields, and sliders:</p> <p><img src="../../assets/screenshots/settings_switch.png" alt="A toggle setting in the on position" /></p> <p><img src="../../assets/screenshots/settings_dropdown.png" alt="A dropdown setting, expanded to show its list of options" /></p> <p><img src="../../assets/screenshots/settings_text_field.png" alt="A text field setting with a value entered" /></p> <p><img src="../../assets/screenshots/settings_titled_card.png" alt="A module settings card with its title and grouped controls" /></p> <h2 id="module-configuration"> <a href="#module-configuration" class="anchor-heading" aria-labelledby="module-configuration"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Module Configuration </h2> <p>Every module lives under <strong>Settings → Module configuration</strong>.</p> <blockquote> <p>⚠️ <strong>Important:</strong> Saving a module screen restarts the radio — the button reads <strong>Save & restart</strong>, and the radio is unreachable for a few seconds afterwards. External Notification and Mesh Beacon are the exceptions: their button reads <strong>Save</strong>, and the radio may still restart for some changes.</p> </blockquote> <h3 id="mqtt-module"> <a href="#mqtt-module" class="anchor-heading" aria-labelledby="mqtt-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> MQTT Module </h3> <p>Bridges mesh messages to and from an MQTT broker for internet connectivity. This is how you extend your mesh beyond radio range or integrate with home automation systems.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>MQTT enabled</td> <td>Toggle MQTT bridge</td> </tr> <tr> <td>Address</td> <td>MQTT broker address</td> </tr> <tr> <td>Імя карыстальніка</td> <td>Authentication username</td> </tr> <tr> <td>Пароль</td> <td>Authentication password</td> </tr> <tr> <td>Encryption enabled</td> <td>Encrypt MQTT payloads</td> </tr> <tr> <td>JSON output enabled</td> <td>Publish and consume MQTT messages as JSON. Marked deprecated in the protobuf schema, but it is still the only toggle for this behavior and the firmware still honors it</td> </tr> <tr> <td>TLS enabled</td> <td>Use secure connection</td> </tr> <tr> <td>Root topic</td> <td>Base MQTT topic path</td> </tr> <tr> <td>Proxy to client enabled</td> <td>Let a connected phone carry the node’s MQTT traffic, instead of the node reaching the broker itself</td> </tr> <tr> <td>MQTT proxy on this phone</td> <td>The phone-side half of <strong>Proxy to client enabled</strong>: whether this phone acts as that relay. See <a href="mqtt">MQTT</a></td> </tr> <tr> <td>Map reporting</td> <td>Publish position to the public map — see the Map reporting group that follows</td> </tr> </tbody> </table></div> <p>Turning <strong>Map reporting</strong> on reveals a consent card headed <em>Consent to Share Unencrypted Node Data via MQTT</em>, with an <strong>I agree.</strong> switch under it. The rest of the card does not exist on screen until you agree:</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>I agree.</td> <td>Explicit consent to transmit your node data, including an approximate position, unencrypted. Map reporting does not start without it</td> </tr> <tr> <td>Precision slider</td> <td>The slider has no label of its own. It sets how coarsely your position is published, from 12 to 15; the line beneath reads <em>±</em> the resulting distance, in your own units</td> </tr> <tr> <td>Map reporting interval (seconds)</td> <td>How often to report. A dropdown of fixed intervals from 1 hour to 72 hours — nothing shorter is offered</td> </tr> </tbody> </table></div> <p>See <a href="mqtt">MQTT</a> for a detailed usage guide including encryption, privacy, and broker setup.</p> <h3 id="serial-module"> <a href="#serial-module" class="anchor-heading" aria-labelledby="serial-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Serial Module </h3> <p>Enables serial port communication for external device integrations (GPS modules, sensors, or custom hardware). When enabled, the node’s serial port can send and receive protobuf or text data, allowing external microcontrollers or computers to interact with the mesh.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Serial enabled</td> <td>Activate serial communication</td> </tr> <tr> <td>Echo enabled</td> <td>Echo received serial data back</td> </tr> <tr> <td>Serial mode</td> <td>Which protocol the port speaks — Default, Simple, Proto, Text message, NMEA, CalTopo, WS85 weather station, VE.Direct, MeshSolar config, Log, or Log (text only)</td> </tr> <tr> <td>RX / TX</td> <td>GPIO pins for the serial connection</td> </tr> <tr> <td>Serial baud rate</td> <td>Port speed</td> </tr> <tr> <td>Скончыўся час чакання</td> <td>How long to wait before considering an incoming message complete</td> </tr> <tr> <td>Override console serial port</td> <td>Take over the port the debug console normally uses</td> </tr> </tbody> </table></div> <h3 id="external-notification-module"> <a href="#external-notification-module" class="anchor-heading" aria-labelledby="external-notification-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> External Notification Module </h3> <p>Controls buzzer, LED, or vibration alerts on your radio hardware. Useful for devices that need to physically signal when a message arrives — particularly helpful for unattended or outdoor installations.</p> <p>There are two independent triggers — an incoming <strong>message</strong>, and a received <strong>bell</strong> character — and each can drive the LED, the buzzer and the vibration motor separately, giving six toggles.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>External notification enabled</td> <td>Master toggle for the module</td> </tr> <tr> <td>Alert message LED / buzzer / vibra</td> <td>Which outputs fire on an incoming message</td> </tr> <tr> <td>Alert bell LED / buzzer / vibra</td> <td>Which outputs fire on a received bell character</td> </tr> <tr> <td>Output LED (GPIO)</td> <td>Pin the LED is wired to</td> </tr> <tr> <td>Output LED active high</td> <td>Whether the LED pin is active high or low</td> </tr> <tr> <td>Output buzzer (GPIO)</td> <td>Pin the buzzer is wired to</td> </tr> <tr> <td>Output vibra (GPIO)</td> <td>Pin the vibration motor is wired to</td> </tr> <tr> <td>Use PWM buzzer</td> <td>Drive the buzzer with PWM, which allows tones rather than a single pitch</td> </tr> <tr> <td>Use I2S as buzzer</td> <td>Send the alert through an I2S audio output instead</td> </tr> <tr> <td>Output duration (milliseconds)</td> <td>How long a single alert lasts</td> </tr> <tr> <td>Nag timeout (seconds)</td> <td>Keep repeating the alert for this long until it is acknowledged. 0 disables nagging</td> </tr> <tr> <td>Ringtone</td> <td>The tone played on a PWM buzzer, in RTTTL. Can be imported from a file</td> </tr> </tbody> </table></div> <h3 id="store--forward-module"> <a href="#store--forward-module" class="anchor-heading" aria-labelledby="store--forward-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Store & Forward Module </h3> <p>Buffers messages for nodes that were temporarily offline, then replays them when those nodes reconnect. Essential for meshes where nodes go in and out of range regularly — ensures messages aren’t lost during brief disconnections.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Store & Forward enabled</td> <td>Activate store and forward</td> </tr> <tr> <td>Heartbeat</td> <td>Periodically announce this node’s store-and-forward capability</td> </tr> <tr> <td>Number of records</td> <td>Maximum stored messages</td> </tr> <tr> <td>History return max</td> <td>Max messages to replay</td> </tr> <tr> <td>History return window</td> <td>Time window for replay</td> </tr> <tr> <td>Сервер</td> <td>Act as a store-and-forward server for the mesh (requires ample memory, e.g. ESP32 with PSRAM)</td> </tr> </tbody> </table></div> <blockquote> <p>💡 <strong>Tip:</strong> Store and Forward works best on nodes with ample memory (ESP32 with PSRAM). Router nodes are ideal candidates since they’re typically always-on.</p> </blockquote> <h3 id="range-test-module"> <a href="#range-test-module" class="anchor-heading" aria-labelledby="range-test-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Range Test Module </h3> <blockquote> <p>⚠️ <strong>Warning:</strong> Range Test only works on a secured primary channel. As long as your primary channel still uses the default channel key, the interval and CSV controls stay disabled — you can still switch an already-enabled module off — and saving force-disables the module if the channel has reverted to public.</p> </blockquote> <p>Automated range testing tool for evaluating link quality between nodes. When enabled, the node periodically transmits test messages with incrementing counters. A receiver node logs these messages, allowing you to walk or drive away and later analyze at what distance messages stopped arriving.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Range test enabled</td> <td>Activate range testing</td> </tr> <tr> <td>Sender message interval (seconds)</td> <td>Time between test transmissions, chosen from a dropdown of fixed intervals</td> </tr> <tr> <td>Save .CSV in storage (ESP32 only)</td> <td>Log received test data to the radio’s own filesystem. ESP32 hardware only</td> </tr> </tbody> </table></div> <h3 id="telemetry-module"> <a href="#telemetry-module" class="anchor-heading" aria-labelledby="telemetry-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Telemetry Module </h3> <p>Controls what telemetry data your node shares with the mesh. Telemetry includes device health (battery, uptime) and environmental sensor data (temperature, humidity, pressure).</p> <p>Each of the four metric groups has its own enable toggle and its own interval, so you can report battery health often and sensors rarely.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Send Device Telemetry</td> <td>Master toggle for device metrics. Only shown on firmware 2.7.12 and newer</td> </tr> <tr> <td>Device metrics update interval</td> <td>How often to report battery, uptime and channel utilization</td> </tr> <tr> <td>Environment metrics module enabled</td> <td>Report the attached environment sensors</td> </tr> <tr> <td>Environment metrics update interval</td> <td>How often to report them</td> </tr> <tr> <td>Environment metrics on-screen enabled</td> <td>Also show these readings on the device’s own display</td> </tr> <tr> <td>Environment metrics use Fahrenheit</td> <td>Use °F on the device’s display. This is the radio’s screen only — the app follows your phone’s locale, see <a href="units-and-locale">Units & Locale</a></td> </tr> <tr> <td>Air quality metrics module enabled</td> <td>Report particulate and CO₂ sensor data</td> </tr> <tr> <td>Air quality metrics update interval</td> <td>How often to report them</td> </tr> <tr> <td>Power metrics module enabled</td> <td>Report the per-channel voltage and current readings</td> </tr> <tr> <td>Power metrics update interval</td> <td>How often to report them</td> </tr> <tr> <td>Power metrics on-screen enabled</td> <td>Also show power readings on the device’s display</td> </tr> </tbody> </table></div> <p>See <a href="telemetry-and-sensors">Telemetry & Sensors</a> for supported sensors and configuration recommendations.</p> <h3 id="canned-message-module"> <a href="#canned-message-module" class="anchor-heading" aria-labelledby="canned-message-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Canned Message Module </h3> <p>Pre-configured messages accessible from the radio’s physical buttons (for radios with rotary encoders, keypads, or similar input hardware). Define a list of quick-send messages that can be transmitted without a phone connected — ideal for field use.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td><del>Canned message enabled</del></td> <td>⚠️ <strong>Deprecated</strong> in the protobuf schema</td> </tr> <tr> <td>Паведамленні</td> <td>Newline-separated list of messages</td> </tr> <tr> <td>Send bell</td> <td>Send a bell character alongside the message, so a receiving node’s External Notification module can sound</td> </tr> <tr> <td>Rotary encoder #1 enabled</td> <td>Use a rotary encoder as the input device</td> </tr> <tr> <td>GPIO pin for rotary encoder A / B / Press port</td> <td>The three pins the encoder is wired to</td> </tr> <tr> <td>Generate input event on Press / CW / CCW</td> <td>Which key event each encoder action produces</td> </tr> <tr> <td>Up/Down/Select input enabled</td> <td>A separate, simpler input scheme using up/down/select buttons rather than an encoder</td> </tr> <tr> <td><del>Allow input source</del></td> <td>⚠️ <strong>Deprecated</strong> in the protobuf schema</td> </tr> </tbody> </table></div> <h3 id="audio-module"> <a href="#audio-module" class="anchor-heading" aria-labelledby="audio-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Audio Module </h3> <p>Codec2 audio support for low-bandwidth voice communication over the mesh. This is an <strong>experimental</strong> feature that encodes voice into very small data packets using the Codec2 codec.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>CODEC 2 enabled</td> <td>Activate audio module</td> </tr> <tr> <td>CODEC2 sample rate</td> <td>Audio quality/bandwidth tradeoff</td> </tr> <tr> <td>PTT pin</td> <td>GPIO pin for the push-to-talk button</td> </tr> <tr> <td>I2S word select</td> <td>GPIO pin for I2S WS</td> </tr> <tr> <td>I2S data in</td> <td>GPIO pin for I2S DIN</td> </tr> <tr> <td>I2S data out</td> <td>GPIO pin for I2S DOUT</td> </tr> <tr> <td>I2S clock</td> <td>GPIO pin for the I2S bit clock</td> </tr> </tbody> </table></div> <blockquote> <p>ℹ️ <strong>Note:</strong> Audio requires specific hardware (I2S microphone and speaker). Voice quality is very low-bandwidth — think “understandable radio voice,” not phone-call quality.</p> </blockquote> <h3 id="remote-hardware-module"> <a href="#remote-hardware-module" class="anchor-heading" aria-labelledby="remote-hardware-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Remote Hardware Module </h3> <p>GPIO control over the mesh network. Allows a remote node to read or write GPIO pins on another node — useful for activating relays, reading switches, or controlling external hardware from a distance.</p> <blockquote> <p>⚠️ <strong>Warning:</strong> Turning on <strong>Allow undefined pin access</strong> gives remote nodes access to all GPIO pins, which could interfere with the radio’s own hardware. Turn it on only on dedicated GPIO nodes.</p> </blockquote> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Remote Hardware enabled</td> <td>Activate remote GPIO access</td> </tr> <tr> <td>Allow undefined pin access</td> <td>Allow access to any GPIO pin (security risk)</td> </tr> <tr> <td>Available pins</td> <td>Up to 4 GPIO pins this node exposes for remote read/write</td> </tr> </tbody> </table></div> <h3 id="neighbor-info-module"> <a href="#neighbor-info-module" class="anchor-heading" aria-labelledby="neighbor-info-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Neighbor Info Module </h3> <p>Broadcasts information about directly heard neighbors, enabling mesh topology mapping. Each enabled node periodically shares a list of the other nodes it can hear and their signal quality.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Neighbor Info enabled</td> <td>Activate neighbor broadcasting</td> </tr> <tr> <td>Update interval (seconds)</td> <td>How often to broadcast neighbor list</td> </tr> <tr> <td>Transmit over LoRa</td> <td>Also broadcast neighbor info over LoRa, not just MQTT/phone. Unavailable on a channel using the default key and name</td> </tr> </tbody> </table></div> <p>See <a href="discovery">Local Mesh Discovery</a> for how to use neighbor data for mesh topology exploration.</p> <h3 id="ambient-lighting-module"> <a href="#ambient-lighting-module" class="anchor-heading" aria-labelledby="ambient-lighting-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Ambient Lighting Module </h3> <p>Controls onboard NeoPixel or other addressable RGB LEDs on supported hardware. Can be used for visual status indicators, notification lights, or decorative effects.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>LED state</td> <td>Turn the LED on or off</td> </tr> <tr> <td>3</td> <td>LED current limit (0–31)</td> </tr> <tr> <td>Red / Green / Blue</td> <td>Individual color channel values (0–255)</td> </tr> </tbody> </table></div> <h3 id="detection-sensor-module"> <a href="#detection-sensor-module" class="anchor-heading" aria-labelledby="detection-sensor-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Detection Sensor Module </h3> <p>Turns your node into a motion or door sensor alert system. When a GPIO pin detects a state change (motion detected, door opened), the node broadcasts an alert message over the mesh.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Detection Sensor enabled</td> <td>Activate detection sensor</td> </tr> <tr> <td>GPIO pin to monitor</td> <td>GPIO pin connected to sensor</td> </tr> <tr> <td>Detection trigger type</td> <td>How the pin’s state maps to a detection event (e.g. active high/low, edge-triggered)</td> </tr> <tr> <td>Use INPUT_PULLUP mode</td> <td>Enable the pin’s internal pull-up resistor</td> </tr> <tr> <td>Minimum broadcast (seconds)</td> <td>Minimum time between alert broadcasts</td> </tr> <tr> <td>State broadcast (seconds)</td> <td>Periodic state broadcast interval</td> </tr> <tr> <td>Send bell with alert message</td> <td>Include bell character in alerts</td> </tr> <tr> <td>Friendly name</td> <td>Custom name for this sensor</td> </tr> </tbody> </table></div> <h3 id="paxcounter-module"> <a href="#paxcounter-module" class="anchor-heading" aria-labelledby="paxcounter-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Paxcounter Module </h3> <p>People counter using Wi-Fi and BLE probe requests. Counts nearby devices by passively listening for probe requests that phones and laptops emit when scanning for networks. Available only on ESP32 devices.</p> <div class="table-wrapper"><table> <thead> <tr> <th>Setting</th> <th>Апісанне</th> </tr> </thead> <tbody> <tr> <td>Paxcounter enabled</td> <td>Activate people counting</td> </tr> <tr> <td>Update interval (seconds)</td> <td>How often to report counts</td> </tr> <tr> <td>Wi-Fi RSSI threshold</td> <td>Ignore Wi-Fi probes weaker than this, so distant devices are not counted (defaults to −80 dBm)</td> </tr> <tr> <td>BLE RSSI threshold</td> <td>The same cut-off for BLE advertisements (defaults to −80 dBm)</td> </tr> </tbody> </table></div> <blockquote> <p>💡 <strong>Tip:</strong> Paxcounter is useful for estimating foot traffic at trailheads, event venues, or other locations. Counts are approximate — one person may carry multiple devices.</p> </blockquote> <h3 id="status-message-module"> <a href="#status-message-module" class="anchor-heading" aria-labelledby="status-message-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Status Message Module </h3> <p>The status message has no module screen. It is edited with the rest of the node’s identity, on <a href="settings-radio-user#user-profile">Settings — Radio & User</a>.</p> <h3 id="mesh-beacon-module"> <a href="#mesh-beacon-module" class="anchor-heading" aria-labelledby="mesh-beacon-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Mesh Beacon Module </h3> <p>Broadcasts an invitation to your mesh, and receives invitations from others. The entry appears only on radios running firmware 2.8.0 or newer. See <a href="discovery">Local Mesh Discovery</a> for the full walkthrough.</p> <h3 id="tak-module"> <a href="#tak-module" class="anchor-heading" aria-labelledby="tak-module"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> TAK Module </h3> <p>Team Awareness Kit integration for interoperability with ATAK and WinTAK. Two things have to be true before the entry appears in the module list: the radio runs firmware 2.8.0 or newer, and its <strong>Device Role</strong> on <strong>Settings → Device configuration → Device</strong> is set to <code class="language-plaintext highlighter-rouge">TAK</code> or <code class="language-plaintext highlighter-rouge">TAK_TRACKER</code>. See <a href="tak">TAK Integration</a> for detailed setup and usage.</p> <h2 id="administration"> <a href="#administration" class="anchor-heading" aria-labelledby="administration"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Administration </h2> <h3 id="remote-administration"> <a href="#remote-administration" class="anchor-heading" aria-labelledby="remote-administration"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Remote Administration </h3> <p>Remotely configure nodes that share your admin key:</p> <ol> <li>Select the target node in the node list.</li> <li>Navigate to <strong>Settings</strong> for that node.</li> <li>Modify configuration.</li> <li>Tap <strong>Save</strong> — changes are sent over the mesh.</li> </ol> <blockquote> <p>⚠️ <strong>Important:</strong> Requires an admin key configured on both your node and the target node.</p> </blockquote> <h3 id="device-actions"> <a href="#device-actions" class="anchor-heading" aria-labelledby="device-actions"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Device Actions </h3> <p><strong>Settings → Administration</strong> holds five one-shot actions, each behind a confirmation dialog:</p> <div class="table-wrapper"><table> <thead> <tr> <th>Action</th> <th>What it does</th> </tr> </thead> <tbody> <tr> <td>Set time</td> <td>Sends your phone’s clock to the radio</td> </tr> <tr> <td>Перазагрузіць</td> <td>Restarts the radio</td> </tr> <tr> <td>Shutdown</td> <td>Powers the radio down</td> </tr> <tr> <td>Factory reset</td> <td>Returns every setting to its factory default</td> </tr> <tr> <td>NodeDB reset</td> <td>Clears the radio’s node database. This dialog carries a <strong>Preserve Favorites?</strong> switch</td> </tr> </tbody> </table></div> <blockquote> <p>⚠️ <strong>Warning:</strong> Factory reset erases all settings, channels, and keys, and cannot be undone. Before you reset, use <strong>Export configuration</strong> to save the radio’s settings and <strong>Backup Keys</strong> on the Security screen to save its keys, so you can put both back afterwards.</p> </blockquote> <h3 id="backup--restore"> <a href="#backup--restore" class="anchor-heading" aria-labelledby="backup--restore"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Backup & Restore </h3> <p><strong>Settings → Backup & Restore</strong> writes the connected radio’s whole configuration to a file with <strong>Export configuration</strong>, and reads a saved file back in with <strong>Import configuration</strong>. Export before a factory reset, or to copy one radio’s setup onto another. The section is shown for your own radio only, not over remote admin.</p> <h3 id="advanced"> <a href="#advanced" class="anchor-heading" aria-labelledby="advanced"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Advanced </h3> <p><strong>Settings → Advanced</strong> collects the tools that read or rewrite local state, and is likewise shown for your own radio only: <strong>Firmware Update</strong> on OTA-capable hardware, <strong>Clean Node Database</strong>, <strong>TAK Server</strong>, <strong>Local Mesh Discovery</strong>, and the <strong>Debug Panel</strong>.</p> <h4 id="clean-node-database"> <a href="#clean-node-database" class="anchor-heading" aria-labelledby="clean-node-database"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Clean Node Database </h4> <p>Prunes nodes from your node database — from the app’s copy <em>and</em> from the radio’s own, so this is not a display-only cleanup. The two filters combine rather than acting separately; the screen puts it as <em>Selections are additive</em>.</p> <ul> <li><strong>Clean up nodes last seen older than N days</strong> — always applied. The slider runs from 7 days to 365 and starts at 30; with <strong>Clean up only unknown nodes</strong> turned on, its floor drops to 0.</li> <li><strong>Clean up only unknown nodes</strong> — narrows the same purge to nodes that never sent their user info. The age limit still applies on top of it.</li> </ul> <p>The screen lists the nodes queued for deletion as you move the filters. <strong>Clean Now</strong> carries the purge out, after one more confirmation, and it cannot be undone. Favorited nodes, ignored nodes, and nodes with a public key heard in the last seven days are never removed, whatever the filters say — that is why the queued list can be shorter than you expect.</p> <h4 id="панэль-адладкі"> <a href="#панэль-адладкі" class="anchor-heading" aria-labelledby="панэль-адладкі"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Панэль адладкі </h4> <p>Opens the <strong>Packets</strong> and <strong>App logs</strong> tabs for viewing, filtering, and exporting diagnostic output. See <a href="debug-logs">Debug Logs</a> for the full walkthrough.</p> <h3 id="app-settings"> <a href="#app-settings" class="anchor-heading" aria-labelledby="app-settings"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> App Settings </h3> <p>Two easy-to-miss entries on the <strong>Settings</strong> screen configure the app rather than the radio, and appear only when your own node is selected:</p> <ul> <li><strong>Node Layout</strong> — how much detail each row of the node list shows.</li> <li><strong>Message Filter</strong> — hides incoming messages that contain words you list. With no words configured it does nothing.</li> </ul> <h3 id="о-нас"> <a href="#о-нас" class="anchor-heading" aria-labelledby="о-нас"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> О нас </h3> <p><strong>Settings → About</strong> carries the app’s own identity rather than the radio’s:</p> <p>Three sections:</p> <ul> <li><strong>What is Meshtastic?</strong> — a short description of the project.</li> <li><strong>Apps</strong> — opens with <strong>Need Hardware?</strong>, a rotating carousel of popular devices that links out to where to buy one. It also lists the GitHub repository, the running app version, and <strong>Acknowledgements</strong> (see the next section).</li> <li><strong>Project information</strong> — links to the website and to this documentation.</li> </ul> <h3 id="acknowledgements"> <a href="#acknowledgements" class="anchor-heading" aria-labelledby="acknowledgements"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Acknowledgements </h3> <p>Reached from <strong>About</strong>, this lists every open-source library the app ships, with its license, generated at build time by AboutLibraries. It was previously called the license screen.</p> <h3 id="troubleshooting-remote-admin"> <a href="#troubleshooting-remote-admin" class="anchor-heading" aria-labelledby="troubleshooting-remote-admin"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Troubleshooting Remote Admin </h3> <ul> <li><strong>“No response from target node”</strong> — the target may be out of range, offline, or have a mismatched admin key. Verify the admin key matches on both nodes.</li> <li><strong>Changes not applying</strong> — some settings require a reboot to take effect. Try the Reboot action after saving.</li> <li><strong>Can’t see remote settings</strong> — ensure your node has the admin key for the target node. The admin channel is configured automatically when an admin key is set.</li> </ul> <h2 id="related-topics"> <a href="#related-topics" class="anchor-heading" aria-labelledby="related-topics"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Related Topics </h2> <ul> <li><a href="settings-radio-user">Settings — Radio & User</a> — core radio and user profile settings</li> <li><a href="https://meshtastic.org/docs/configuration/module">Module configuration reference</a> — detailed module docs on meshtastic.org</li> <li><a href="https://meshtastic.org/docs/faq/">FAQ</a> — common questions on meshtastic.org</li> </ul> </div> <style> .locale-page-banner { background: rgba(103, 234, 148, 0.1); border: 1px solid rgba(103, 234, 148, 0.3); border-radius: 12px; padding: 10px 16px; margin-bottom: 1.5rem; font-size: 0.85rem; } .locale-notice a { margin-left: 12px; font-weight: 500; } </style> </main> <hr> <footer> <footer class="site-footer"> Copyright © 2026 Meshtastic LLC. Distributed under the <a href="https://www.gnu.org/licenses/gpl-3.0.html">GPL v3 License.</a> </footer> <div class="d-sm-block d-md-none"> <div class="mt-4 fs-2"> This site uses <a href="https://github.com/just-the-docs/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll. </div> </div> </footer> </div> </div> <div class="search-overlay"></div> </div> </body> </html>
|