Průvodce Meshtastic – Tipy pro nastavení modulu přednastavených zpráv

Modul přednastavených zpráv umožňuje odesílat zprávy do mesh sítě ze zařízení bez použití mobilní aplikace. Můžete předdefinovat textové zprávy, ze kterých lze vybírat.

Možnosti konfigurace modulu přednastavených zpráv zahrnují: Povoleno, Odeslat zvonek, Zprávy, Vstupní zdroj, Povoleno rotačního encoderu, Povoleno encoderu nahoru dolů, Vstupní broker pin A, Vstupní broker pin B, Vstupní broker pin stisk, Vstupní broker událost po směru hodinových ručiček, Vstupní broker událost proti směru hodinových ručiček a Vstupní broker událost stisk. Konfigurace modulu přednastavených zpráv využívá administrátorskou zprávu k odeslání ConfigModule.CannedMessage protobufu.

Konfigurační hodnoty modulu přednastavených zpráv

Povoleno: Aktivuje modul přednastavených zpráv.
Odeslat zvonek: Odesílá znak zvonku s každou zprávou. Externí notifikační modul lze nastavit tak, aby pípnul při příchodu nové zprávy. Navíc lze tento modul nastavit tak, aby pípnul pouze tehdy, když zpráva obsahuje znak zvonku.
Zprávy: Seznam přednastavených zpráv nakonfigurovaných uživatelem. Zprávy by měly být odděleny oddělovači |. Celkový počet bajtů pro seznam zpráv může být až 200 bajtů.
Vstup Zdroj: Přijímané zdroje vstupních událostí modulem přednastavených zpráv.

Hodnota	Popis
_any	Výchozí. Umožňuje jakékoli periferní vstupní zařízení připojené k zařízení.
rotEnc1	Základní rotační encoder
upDownEnc1	Encoder nahoru dolů (použijte také pro RAK14006 Rotary Encoder)
scanAndSelect	Jednotlačítko (krátké a dlouhé stisknutí)
cardkb	M5 Stack CardKB (toto zahrnuje RAK14004 Keymatrix)
serialkb	Sériová klávesnice Chatter

Zapnutý rotační enkodér: Povolí výchozí rotační enkodér.
Zapnutý enkodér nahoru/dolů: Povolí enkodér nahoru/dolů.
Vstup Broker Pin A: Hodnota GPIO pinu (1-39) pro port enkodéru A.
Vstup Broker Pin B: Hodnota GPIO pinu (1-39) pro port enkodéru B.
Vstup Broker Pin Stisk: Hodnota GPIO pinu (1-39) pro port stisku enkodéru.
Vstup Broker Event Po směru hodinových ručiček: Vygeneruje rotační událost po směru hodinových ručiček.
Vstup Broker Event Proti směru hodinových ručiček: Vygeneruje rotační událost proti směru hodinových ručiček.
Vstup Broker Event Stisk: Vygeneruje vstupní událost při stisku tohoto typu.

Klient konfigurace modulu přednastavených zpráv

Android

Konfigurační možnosti přednastavených zpráv jsou dostupné pro Android.

Otevřete aplikaci Meshtastic.
Přejděte na: Vertikální elipsa (3 tečky vpravo nahoře) > Konfigurace rádia > Přednastavená zpráva.

Apple

Všechny konfigurační možnosti modulu přednastavených zpráv jsou dostupné na iOS, iPadOS a macOS v Nastavení > Konfigurace modulu > Přednastavené zprávy.

CLI

Všechny konfigurační možnosti modulu přednastavených zpráv jsou dostupné v Python CLI.

Nastavení	Přijatelné hodnoty	Výchozí
canned_message.enabled	pravda, nepravda	NEPRAVDA
canned_message.send_bell	pravda, nepravda	NEPRAVDA
canned_message.allow_input_source	rotEnc1, _any, upDownEnc1, cardkb	_any
--set-canned-message	řetězec	"" (odděleno pomocí svislítka)
canned_message.inputbroker_event_cw	InputEventChar	(není definováno)
canned_message.inputbroker_event_ccw	InputEventChar	(není definováno)
canned_message.inputbroker_event_press	InputEventChar	(není definováno)
canned_message.inputbroker_pin_a	celé číslo	(není definováno)
canned_message.inputbroker_pin_b	celé číslo	(není definováno)
canned_message.inputbroker_pin_press	celé číslo	(není definováno)

Povolit/zakázat modul přednastavených zpráv

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

Povolit/zakázat znak odesílacího zvonku

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

Nastavit zprávy

meshtastic --set-canned-message "Potřebuji horolezce!|Zavolej mi|Roger Roger|Zůstaň v klidu|Jdu na to"

Nastavit zdroj vstupu

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

Povolit/zakázat rotary1

meshtastic --set canned_message.rotary1_enabled 1

Nastavit/Zrušit pin A enkodéru

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

Nastavit/Zrušit pin B enkodéru

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

Nastavit/Zrušit stisk pinů enkodéru

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

Nastavit/Odstranit událost Input Broker CW

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

Nastavit/Odstranit událost Input Broker CCW

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

Nastavit/Odstranit událost stisku Input Broker

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

POZNÁMKA: Protože se zařízení restartuje po každém příkazu zaslaném přes CLI, doporučuje se spojit příkazy dohromady do jednoho při nastavování více hodnot v konfigurační sekci. Například:

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

Web

Všechny konfigurační možnosti modulu předdefinovaných zpráv jsou dostupné v Web UI.

Hardware

Pro navigaci mezi zprávami a výběr jedné budete potřebovat nějaký hardware připojený k vašemu zařízení. V současné době je modul testován s obecným rotačním enkodérem, logikou 3 tlačítek nahoru/dolů/výběr a několika I2C klávesnicemi. Další vstupní metody budou přidány v budoucnu.

I2C klávesová matice

Toto bylo testováno s RAK14004 klávesnicí. Stisk klávesy okamžitě odešle zprávu přiřazenou k příslušnému číslu tlačítka. Tlačítka jsou číslována z levého horního rohu do pravého dolního na klávesnicových panelech. Proto stisknutí levého horního tlačítka odešle první zprávu, druhé tlačítko odešle druhou zprávu a tak dále.

Upozornění: RAK 3x4 klávesová matice postrádá při skenování 4. řadu tlačítek, takže musíte přeskočit každé 4. místo pro zprávu. Tlačítko 1 odešle zprávu 1 a tlačítko 4 odešle zprávu 5. Například: 1|2|3||5|6|7||9|10|11||13|14|15 — místa 4, 8 a 12 nelze použít.

CardKB

CardKB je plně podporován v režimu volného textu a režimu výběru. Použijte NAHORU/DOLŮ/ENTER pro výběr předdefinované zprávy a její odeslání. Pro volnou textovou zprávu ji jednoduše napište a stiskněte ENTER pro odeslání.

Pokud nechcete vysílat svou volnou textovou zprávu, můžete použít CardKB k odeslání na konkrétní uzel. Stačí stisknout TAB a vybrat cílový uzel pomocí kláves VLEVO/VPRAVO. Zpráva bude odeslána uzlu se shodným názvem a číslem uzlu. Cílový uzel bude zapamatován pro vaši další zprávu.

3 tlačítka nahoru/dolů a RAK rotační enkodér

Jednoduše použijte NAHORU/DOLŮ/ENTER pro výběr předdefinované zprávy a její odeslání.

Skenovat a vybrat

Použijte jedno tlačítko pro výběr a odeslání předdefinovaných zpráv.

Nastavení

Připojte normálně otevřené tlačítko mezi zem a GPIO pin dle vašeho výběru.
Nakonfigurujte modul přednastavených zpráv. 1. Nastavte Zdroj vstupu na scanAndSelect. 2. Nastavte Vstupní pin pro stisk tlačítka na vámi zvolený GPIO. 3. Definujte seznam přednastavených zpráv.

Použití

Krátký stisk: Prochází zprávy.
Dlouhý stisk: Odešle aktuálně zvýrazněnou zprávu do vašeho primárního kanálu.

Rotační enkodér

Meshtastic podporuje pevně zapojené rotační enkodéry jako vstupní zařízení.

Budete potřebovat obecný rotační enkodér. Níže uvedené typy mají pět nožiček, z nichž dvě jsou určeny pro akci "stisknutí", ale pravděpodobně budou fungovat i jiné typy. Můžete také použít verzi s třemi nožičkami, kde by akce "stisknutí" měla být připojena z nezávislého spínače.

Připojte svůj rotační enkodér následovně: rotační enkodér má dva řady nožiček. Jedna řada obsahuje dvě nožičky, druhá tři nožičky. Pohled ze spodní strany:

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

Dvě nožičky slouží k detekci stisknutí (nebo tlačení). Připojte jednu z nožiček k ZEMI a druhou k GPIO pinu (nezáleží, která kam). Tyto připojené porty budeme označovat jako 'PRESS'.

Tři nožičky slouží k detekci otáčivého pohybu. Připojte střední nožičku k ZEMI a ty po stranách k GPIO pinům. Tyto porty označíme jako 'A' a 'B' podle níže uvedeného schématu.

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

Doporučené piny GPIO pro připojení rotačního enkodéru:

TTGO LoRa V1:

A - GPIO-22
B - GPIO-23
STISKNOUT - GPIO-21

Existuje referenční 3D design používající rotační enkodér pro TTGO LoRa V1: Pouzdro pro TTGO-ESP32-LORA-OLED-v1.0 s rotačním enkodérem.

Příklady

Připojte kompatibilní periferní zařízení. Věnujte pozornost číslům GPIO, která použijete, protože budou potřeba v následujícím kroku.

Poznámka: Nahraďte každé GPIO (x3) níže čísly GPIO z vašeho hardwarového nastavení.

Zde je modul přednastavených zpráv - Požadovaná nastavení rotačního enkodéru modulu.

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 je ono! S funkčním a povoleným rotačním enkodérem jste připraveni začít konfigurovat modul přednastavených zpráv.

Průvodce Meshtastic – Tipy pro nastavení modulu přednastavených zpráv

Konfigurační hodnoty modulu přednastavených zpráv