Konfiguracja urządzenia Meshtastic ⚙️ obejmuje podstawowe parametry, takie jak Rola 🎭, Tryb retransmisji 🔁, przypisania GPIO 🔌, interwały nadawania ⏱️ oraz zachowanie zasilania 🔋. Te ustawienia definiują, jak każde urządzenie działa w sieci Meshtastic 🕸️ — czy jako Klient 👤, Router 📡, Repeater 🔄, Czujnik 🌡️, czy Tracker 📍 — oraz jak obsługuje retransmisję wiadomości. Konfiguracja jest stosowana za pomocą wiadomości administracyjnej 🛠️ wykorzystującej strukturę protobuf Config.Device.
📑 Parametry konfiguracji urządzenia
🎭 Role urządzeń Meshtastic
| Rola urządzenia | Opis | Najlepsze zastosowania |
| 👤 KLIENT | Standardowy węzeł do przesyłania wiadomości, połączony z aplikacją 📱 lub samodzielny. Retransmituje pakiety, jeśli żaden inny węzeł tego nie zrobił. | Rola ogólnego przeznaczenia dla osób korzystających z aplikacji klienckich do komunikacji 💬 w sieci mesh. |
| 🤫 KLIENT_WYCISZONY | Węzeł, który nie retransmituje pakietów 🚫, zmniejszając zużycie czasu nadawania ⏳. | Idealne do gęstych wdrożeń 🏙️, gdzie ważne jest minimalizowanie ruchu retransmisji. |
| 🙈 KLIENT_UKRYTY | Urządzenie, które nadaje tylko w razie potrzeby, wspierając tryb ukryty 🕵️ lub oszczędzanie energii 🔋. | Przydatny dla ukrytych lub niskomocowych ról wymagających udziału w sieci mesh. |
| 📍 TRACKER | Priorytetowo traktuje pakiety pozycji GPS 🛰️ dla niezawodnego śledzenia lokalizacji. | Najlepszy do śledzenia zasobów 📦 lub osób 🚶, gdzie ważne są terminowe aktualizacje. |
| 🆘 ZNALEZIONE_I_LOST | Regularnie nadaje lokalizację 📡 na domyślny kanał, aby ułatwić odzyskanie. | Używany do lokalizowania zagubionych węzłów w terenie 🌲. |
| 🌡️ CZUJNIK | Priorytetowo traktuje pakiety telemetryczne 📊, takie jak dane środowiskowe lub sensoryczne. | Idealny do zbierania danych 🌱 z efektywnym zużyciem energii 🔋 i częstymi aktualizacjami. |
| 🎖️ TAK | Optymalizowany pod integrację z systemem ATAK, minimalizując rutynowe transmisje. | Używany w taktycznych wdrożeniach 🪖 wymagających wsparcia wtyczki ATAK. |
| 🎯 TAK_TRACKER | Automatycznie wysyła transmisje TAK PLI 📡, jednocześnie redukując rutynowy ruch. | Samodzielna integracja z systemami ATAK dla taktycznych operacji lokalizacyjnych. |
| 🔄 REPEATER | Węzeł infrastruktury, który zawsze jednokrotnie przekazuje pakiety dalej 🔁, rozszerzając zasięg. Nie jest widoczny w topologii. | Strategicznie rozmieszczone repeatery 🏔️ maksymalizujące zasięg bez pojawiania się na liście węzłów. |
| 📡 ROUTER | Węzeł infrastruktury, który zawsze jednokrotnie przekazuje pakiety dalej. Widoczny 👀 w topologii i liście węzłów. | Najlepiej używać w stałych lokalizacjach 🏠, aby rozszerzyć zasięg i poprawić niezawodność routingu. |
| ⏳ ROUTER_LATE | Przekazuje pakiety dalej dopiero po innych rolach, zwiększając zasięg lokalnych klastrów 🌐. | Idealne do wypełniania luk w zasięgu 🕳️ lub wspierania izolowanych klastrów. |
📊 Porównawcza analiza ról
Ta tabela wyświetla wartości domyślne po wybraniu presetu ⚙️. Jak zawsze, poszczególne ustawienia można dostosować 🛠️ po wyborze presetu.
| Rola urządzenia 🎭 | BLE/WiFi/Serial 📡 | Ekran włączony 🖥️ | Zużycie energii 🔋 | Retransmisja 🔁 | Priorytetowe trasowanie 🚦 | Widoczne na liście węzłów 👀 |
| 👤 KLIENT | Tak ✅ | Tak ✅ | Regularny ⚡ | Tak 🔁 | Nie 🚫 | Tak 👀 |
| 🤫 KLIENT_WYCISZONY | Tak ✅ | Tak ✅ | Najniższy ⏳ | Nie 🚫 | Nie 🚫 | Tak 👀 |
| 🙈 KLIENT_UKRYTY | Tak ✅ | Tak ✅ | Najniższy ⏳ | Tylko lokalnie 📍 | Nie 🚫 | Nie 🚫 |
| 📍 TRACKER | Tak ✅ | Nie 🚫 | Regularny / Niski 🔋 | Tylko podczas czuwania ⏱️ | Nie 🚫 | Tak 👀 |
| 🆘 ZNALEZIONE_I_LOST | Tak ✅ | Nie 🚫 | Regularny ⚡ | Tak 🔁 | Nie 🚫 | Tak 👀 |
| 🌡️ CZUJNIK | Tak ✅ | Nie 🚫 | Regularny / Niski 🔋 | Tylko podczas czuwania ⏱️ | Nie 🚫 | Tak 👀 |
| 🎖️ TAK | Tak ✅ | Opcjonalne ⚙️ | Regularny ⚡ | Tak 🔁 | Nie 🚫 | Tak 👀 |
| 🎯 TAK_TRACKER | Tak ✅ | Opcjonalne ⚙️ | Regularny ⚡ | Tak 🔁 | Nie 🚫 | Tak 👀 |
| 📡 ROUTER | Nie 🚫 | Nie 🚫 | Wysoki ⚡⚡ | Tak 🔁 | Tak ✅ | Tak 👀 |
| ⏳ ROUTER_LATE | Tak ✅ | Tak ✅ | Wysoki ⚡⚡ | Tak 🔁 | Nie 🚫 | Tak 👀 |
| 🔄 REPEATER | Tak ✅ | Nie 🚫 | Wysoki ⚡⚡ | Tak 🔁 | Tak ✅ | Nie 🚫 |
🔋 Zrozumienie oszczędzania energii i wydajności ról
⚙️ Tylko platforma ESP32 – Zarządzanie energią Meshtastic
Na platformie ESP32 💻 wszystkie role — z wyjątkiem TRACKER 📍 i SENSOR 🌡️ — obsługują tryb niskiego zużycia energii za pomocą power.is_power_saving 💤. Po włączeniu urządzenie przechodzi w tryb uśpienia 😴, wyłączając peryferia 🔌, GPS 🛰️ i radia 📡, aby oszczędzać energię 🔋.
Parametry timeout ⏱️ takie jak display.screen_on_secs, power.min_wake_secs, oraz power.wait_bluetooth_secs wpływają na moment uśpienia urządzenia. Zewnętrzne zdarzenia, takie jak odbiór pakietu 📦, naciśnięcia przycisków 🔘 lub połączenia Bluetooth 📱 mogą zresetować odliczanie.
Dla roli ROUTER 📡 oszczędzanie energii jest zawsze włączone ✅, aby zapewnić efektywne wykorzystanie energii przy jednoczesnym utrzymaniu sieci mesh 🕸️.
🌐 Platformy ESP32 i NRF52 – Zachowanie snu Tracker i Sensor
Na platformach ESP32 💻 i NRF52 🔋 role TRACKER 📍 i SENSOR 🌡️ korzystają ze specjalnych cykli snu 💤. Trackery śpią do następnej transmisji GPS 🛰️, potem budzą się, aby wysłać pakiety pozycji 📍. Sensory śpią do następnego interwału telemetrycznego 📊, potem budzą się, aby zebrać i przesłać dane 🌱.
W przeciwieństwie do innych ról, te węzły nie utrzymują radia LoRa w trybie czuwania 🚫, budząc się tylko w skonfigurowanych odstępach ⏱️. Czyni je to idealnymi do niskiego zużycia energii i okresowego raportowania 🔋.
- 📌 Tryb Awake Only pozwala na retransmisje tylko podczas aktywnych okresów, nie podczas snu 😴.
- 📡 Dla węzłów ROUTER na ESP32 oszczędzanie energii jest domyślnie włączone ⚡. Aby zaktualizować przez Bluetooth 🔗, tymczasowo zmień rolę na tryb bez uśpienia, a następnie przywróć ją po zakończeniu ✅.
⚙️ Inne parametry konfiguracji urządzenia
- 🔁 Konfiguracja ponownego nadawania Meshtastic: Definiuje sposób przekazywania wiadomości w sieci mesh 🕸️.
| Wartość | Opis |
| WSZYSTKIE 📡 | Domyślnie – przekazuje wszystkie wiadomości z lokalnych i obcych sieci mesh 🌍, nawet jeśli szyfrowanie się różni. |
| ALL_SKIP_DECODING 🚫 | Tak jak ALL, ale pomija dekodowanie, przekazuje dalej bez analizy 👀. Tylko dla roli Repeater 🔄. |
| LOCAL_ONLY 📍 | Przekazuje dalej tylko wiadomości z lokalnych kanałów, ignoruje obce sieci mesh 🚫. |
| KNOWN_ONLY 🧩 | Filtruje pakiety z nieznanych węzłów ❌, przekazuje dalej tylko z znanych wpisów NodeDB. |
| NONE 🚫 | Wyłącza ponowne nadawanie. Tylko dla ról takich jak SENSOR 🌡️, TRACKER 📍 oraz TAK_TRACKER 🎯. |
| CORE_PORTNUMS_ONLY 🎯 | Przekazuje dalej tylko podstawowe typy pakietów: NodeInfo ℹ️, Tekst 💬, Pozycja 📍, Telemetria 📊, Routing 🔄. |
- 🔘 Ustawienia GPIO przycisku użytkownika: Definiuje numer pinu GPIO dla przycisku użytkownika, jeśli brak.
- 🔔 Konfiguracja GPIO brzęczyka PWM: Przypisuje pin GPIO dla alertów brzęczyka 📢.
- ⏱️ Interwał nadawania NodeInfo: Ustawia odstęp czasu dla automatycznych transmisji NodeInfo ℹ️.
- 👆 Podwójne stuknięcie jako naciśnięcie przycisku: Włącza gest podwójnego stuknięcia, jeśli jest obecny akcelerometr.
- 🚫 Wyłącz funkcję potrójnego kliknięcia: Wyłącza skrót potrójnego kliknięcia do przełączania GPS 📍.
- 🌍 Definicja strefy czasowej (TZDEF): Definiuje lokalne przesunięcia czasu ⏰ za pomocą ciągów POSIX TZ.
- 💡 Wyłączony migający LED: Zatrzymuje miganie diody LED ✨ dla trybu ukrycia lub oszczędzania energii 🔋.
📱 Dostępność klienta konfiguracji urządzenia
🤖 Android
- Otwórz Meshtastic App 📲.
- Nawiguj: ⋮ (3 kropki) ➡️ Konfiguracja radia ➡️ Urządzenie.
🍎 Apple
Wszystkie opcje konfiguracji (oprócz NTP Server 🌐) są dostępne na iOS, iPadOS i macOS w Ustawienia ➡️ Konfiguracja urządzenia ➡️ Urządzenie.
💻 CLI
Wszystkie opcje są dostępne przez Python CLI 🐍. Przykładowe polecenia poniżej:
| Ustawienie ⚙️ | Akceptowalne wartości ✅ | Domyślne 📌 |
| device.role 🎭 | KLIENT 👤, CLIENT_MUTE 🤫, ROUTER 📡, REPEATER 🔄, TRACKER 📍, SENSOR 🌡️ | KLIENT 👤 |
| device.rebroadcast_mode 🔁 | WSZYSTKIE 📡, ALL_SKIP_DECODING 🚫, TYLKO_LOKALNE 📍 | WSZYSTKIE 📡 |
| device.button_gpio 🔘 | 0 – 34 🔢 | 0 |
| device.buzzer_gpio 🔔 | 0 – 34 🔢 | 0 |
