Przewodnik Meshtastic - Wskazówki dotyczące konfiguracji modułu Wiadom

Moduł gotowych wiadomości pozwala wysyłać wiadomości do sieci mesh z urządzenia bez użycia aplikacji na telefon. Możesz zdefiniować wcześniej teksty wiadomości do wyboru.

Opcje konfiguracji modułu gotowych wiadomości obejmują: Włączony, Wyślij dzwonek, Wiadomości, Źródło wejścia, Włączony enkoder obrotowy, Włączony enkoder góra-dół, Pin A brokera wejścia, Pin B brokera wejścia, Pin naciśnięcia brokera wejścia, Zdarzenie brokera wejścia zgodnie z ruchem wskazówek zegara, Zdarzenie brokera wejścia przeciwnie do ruchu wskazówek zegara oraz Zdarzenie brokera wejścia naciśnięcia. Konfiguracja gotowych wiadomości wykorzystuje wiadomość administratora do wysłania protobuf ConfigModule.CannedMessage.

Wartości konfiguracji modułu gotowych wiadomości

Włączony: Włącza moduł gotowych wiadomości.
Wyślij dzwonek: Wysyła znak dzwonka z każdą wiadomością. Moduł powiadomień zewnętrznych może być skonfigurowany tak, aby wydawał dźwięk, gdy nadejdzie nowa wiadomość. Dodatkowo, moduł ten może być ustawiony tak, aby dzwonił tylko wtedy, gdy wiadomość zawiera znak dzwonka.
Wiadomości: Lista ustawionych wiadomości skonfigurowanych przez użytkownika. Wiadomości powinny być oddzielone znakami |. Całkowita liczba bajtów listy wiadomości może wynosić do 200 bajtów.
Źródło wejścia: Akceptowane źródła zdarzeń wejściowych przez moduł gotowych wiadomości.

Wartość	Opis
_any	Domyślnie. Pozwala na dowolne urządzenie peryferyjne podłączone do urządzenia.
rotEnc1	Podstawowy enkoder obrotowy
upDownEnc1	Enkoder góra-dół (użyj także dla RAK14006 Rotary Encoder)
scanAndSelect	Pojedynczy przycisk (krótkie i długie naciśnięcie)
cardkb	M5 Stack CardKB (obejmuje RAK14004 Keymatrix)
serialkb	Klawiatura szeregowa Chatter

Włączony enkoder obrotowy: Włącz domyślny enkoder obrotowy.
Włączony enkoder góra/dół: Włącz enkoder góra/dół.
Wejście Broker Pin A: Wartość pinu GPIO (1-39) dla portu A enkodera.
Wejście Broker Pin B: Wartość pinu GPIO (1-39) dla portu B enkodera.
Wejście Broker Pin Press: Wartość pinu GPIO (1-39) dla portu naciśnięcia enkodera.
Wejście Broker Event Clockwise: Generuj zdarzenie obrotu zgodnie z ruchem wskazówek zegara.
Wejście Broker Event Counter Clockwise: Generuj zdarzenie obrotu przeciwnie do ruchu wskazówek zegara.
Wejście Broker Event Press: Generuj zdarzenie wejściowe przy naciśnięciu tego typu.

Klient konfiguracji modułu gotowych wiadomości

Android

Opcje konfiguracji gotowych wiadomości są dostępne dla Android.

Otwórz aplikację Meshtastic.
Przejdź do: Pionowa elipsa (3 kropki w prawym górnym rogu) > Konfiguracja radia > Gotowa wiadomość.

Apple

Wszystkie opcje konfiguracji modułu gotowych wiadomości są dostępne na iOS, iPadOS oraz macOS w Ustawienia > Konfiguracja modułu > Gotowe wiadomości.

CLI

Wszystkie opcje konfiguracji modułu gotowych wiadomości są dostępne w Python CLI.

Ustawienie	Akceptowalne wartości	Domyślny
canned_message.enabled	true, false	FALSE
canned_message.send_bell	true, false	FALSE
canned_message.allow_input_source	rotEnc1, _any, upDownEnc1, cardkb	_any
--set-canned-message	łańcuch znaków	"" (oddzielone za pomocą pionowych kresek)
canned_message.inputbroker_event_cw	InputEventChar	(nie zdefiniowano)
canned_message.inputbroker_event_ccw	InputEventChar	(nie zdefiniowano)
canned_message.inputbroker_event_press	InputEventChar	(nie zdefiniowano)
canned_message.inputbroker_pin_a	liczba całkowita	(nie zdefiniowano)
canned_message.inputbroker_pin_b	liczba całkowita	(nie zdefiniowano)
canned_message.inputbroker_pin_press	liczba całkowita	(nie zdefiniowano)

Włącz/Wyłącz moduł gotowych wiadomości

meshtastic --set canned_message.enabled true
meshtastic --set canned_message.enabled false

Włącz/Wyłącz znak dzwonka wysyłania

meshtastic --set canned_message.send_bell true
meshtastic --set canned_message.send_bell false

Ustaw wiadomości

meshtastic --set-canned-message "Potrzebuję alpinisty!|Zadzwoń do mnie|Roger Roger|Zachowaj spokój|W drodze

Ustaw źródło wejścia

meshtastic --set canned_message.allow_input_source "_any"
meshtastic --set canned_message.allow_input_source "rotEnc1"

Włącz/Wyłącz rotary1

meshtastic --set canned_message.rotary1_enabled 1

Ustaw/Wyłącz pin A enkodera

meshtastic --set canned_message.inputbroker_pin_a 17
meshtastic --set canned_message.inputbroker_pin_a 0

Ustaw/Wyłącz pin B enkodera

meshtastic --set canned_message.inputbroker_pin_b 39
meshtastic --set canned_message.inputbroker_pin_b 0

Ustaw/Wyłącz naciśnięcie pinu enkodera

meshtastic --set canned_message.inputbroker_pin_press 21
meshtastic --set canned_message.inputbroker_pin_press 0

Ustaw/Wyłącz zdarzenie Input Broker CW

meshtastic --set canned_message.inputbroker_event_cw UP
meshtastic --set canned_message.inputbroker_event_cw ""

Ustaw/Wyłącz zdarzenie Input Broker CCW

meshtastic --set canned_message.inputbroker_event_ccw DOWN
meshtastic --set canned_message.inputbroker_event_ccw ""

Ustaw/Wyłącz zdarzenie naciśnięcia Input Broker

meshtastic --set canned_message.inputbroker_event_press SELECT
meshtastic --set canned_message.inputbroker_event_press ""

UWAGA: Ponieważ urządzenie uruchomi się ponownie po każdym poleceniu wysłanym przez CLI, zaleca się łączenie poleceń w jedno podczas ustawiania wielu wartości w sekcji konfiguracji. Na przykład:

meshtastic --set canned_message.enabled true --set canned_message.send_bell true

Web

Wszystkie opcje konfiguracji modułu wiadomości szablonowych są dostępne w interfejsie Web UI.

Sprzęt

Aby nawigować po wiadomościach i wybrać jedną, potrzebujesz sprzętu podłączonego do urządzenia. Obecnie moduł testowany jest z uniwersalnym enkoderem obrotowym, logiką 3 przycisków góra/dół/wybierz oraz kilkoma klawiaturami I2C. W przyszłości zostaną dodane dodatkowe metody wejścia.

Macierz klawiszy I2C

Testowano to z klawiaturą RAK14004. Naciśnięcie klawisza natychmiast wyśle wiadomość przypisaną do odpowiedniego numeru przycisku. Przyciski są ponumerowane od lewego górnego do prawego dolnego na panelach klawiszy. Dlatego naciśnięcie lewego górnego przycisku wyśle pierwszą wiadomość, drugi przycisk wyśle drugą wiadomość i tak dalej.

Uwaga: Macierz klawiszy 3x4 RAK nie posiada czwartego rzędu przycisków podczas skanowania, więc musisz pominąć każdy czwarty slot wiadomości. Przycisk 1 wysyła wiadomość 1, a przycisk 4 wyśle wiadomość 5. Na przykład: 1|2|3||5|6|7||9|10|11||13|14|15 — sloty 4, 8 i 12 nie mogą być używane.

CardKB

CardKB jest w pełni obsługiwany w trybie tekstowym oraz trybie wyboru. Użyj GÓRA/DÓŁ/ENTER, aby wybrać zdefiniowaną wiadomość i ją wysłać. Dla wiadomości tekstowej po prostu ją wpisz i naciśnij ENTER, aby wysłać.

Jeśli wolisz nie nadawać swojej wiadomości tekstowej publicznie, możesz użyć CardKB, aby wysłać ją do konkretnego węzła. Wystarczy nacisnąć TAB i wybrać docelowy węzeł za pomocą klawiszy LEWO/PRAWO. Wiadomość zostanie wysłana do węzła o pasującej nazwie i numerze. Docelowy węzeł zostanie zapamiętany dla następnej wiadomości.

3 przyciski góra/dół oraz enkoder obrotowy RAK

Po prostu użyj GÓRA/DÓŁ/ENTER, aby wybrać zdefiniowaną wiadomość i ją wysłać.

Skanuj i wybierz

Użyj pojedynczego przycisku do wyboru i wysyłania predefiniowanych wiadomości.

Konfiguracja

Podłącz normalnie otwarty przycisk między masą a wybranym pinem GPIO.
Skonfiguruj moduł gotowych wiadomości. 1. Ustaw Źródło wejścia na scanAndSelect. 2. Ustaw Pin naciśnięcia brokera wejścia na wybrany GPIO. 3. Zdefiniuj listę predefiniowanych wiadomości.

Użytkowanie

Krótkie naciśnięcie: Przewijaj wiadomości.
Długie naciśnięcie: Wyślij aktualnie podświetloną wiadomość do swojego głównego kanału.

Enkoder obrotowy

Meshtastic obsługuje przewodowe enkodery obrotowe jako urządzenia wejściowe.

Będziesz potrzebować uniwersalnego enkodera obrotowego. Typy wymienione poniżej mają pięć nóżek, z dwoma przeznaczonymi do akcji "naciśnięcia", ale inne typy prawdopodobnie też będą działać. Możesz też użyć wersji z trzema nóżkami, gdzie akcja "naciśnięcia" powinna być podłączona z niezależnego przełącznika.

Podłącz swój enkoder obrotowy w następujący sposób: enkoder obrotowy ma dwa rzędy nóżek. Jeden rząd zawiera dwie nóżki, a drugi trzy. Widok od spodu:

B o --- o PRESS
GND o | |
A o --- o GND

Dwie nóżki służą do wykrywania naciśnięcia (lub przycisku). Podłącz jedną z dwóch nóżek do MASY, a drugą do pinu GPIO (nie ma znaczenia, która gdzie). Te podłączone porty nazwiemy 'PRESS'.

Trzy nóżki służą do wykrywania ruchu obrotowego. Podłącz środkową nóżkę do MASY, a boczne do pinów GPIO. Oznaczymy te porty jako 'A' i 'B', zgodnie z poniższym schematem.

A --||
GND --||]========
B --||

Zalecane piny GPIO do podłączenia enkodera obrotowego:

TTGO LoRa V1:

A - GPIO-22
B - GPIO-23
PRZYCISK - GPIO-21

Istnieje referencyjny projekt 3D obudowy wykorzystujący enkoder obrotowy dla TTGO LoRa V1: Obudowa dla TTGO-ESP32-LORA-OLED-v1.0 z enkoderem obrotowym.

Przykłady

Podłącz kompatybilne urządzenie peryferyjne. Zwróć uwagę na numery GPIO, których używasz, ponieważ będą potrzebne w następnym kroku.

Uwaga: Zamień każde GPIO (x3) poniżej na numery GPIO z twojej konfiguracji sprzętowej.

Oto Moduł Wiadomości Szablonowych - Wymagane ustawienia modułu enkodera obrotowego.

meshtastic --set canned_message.inputbroker_pin_a GPIO
meshtastic --set canned_message.inputbroker_pin_b GPIO
meshtastic --set canned_message.inputbroker_pin_press GPIO
meshtastic --set canned_message.inputbroker_event_cw UP
meshtastic --set canned_message.inputbroker_event_ccw DOWN
meshtastic --set canned_message.inputbroker_event_press SELECT
meshtastic --set canned_message.rotary1_enabled True

To wszystko! Z działającym i włączonym enkoderem obrotowym jesteś gotowy, aby zacząć konfigurować Moduł Wiadomości Szablonowych.

Przewodnik Meshtastic - Wskazówki dotyczące konfiguracji modułu Wiadomości Szablonowych

Wartości konfiguracji modułu gotowych wiadomości