Moduł Zewnętrznych Powiadomień pozwala podłączyć brzęczyk, głośnik, diodę LED lub inne urządzenia, aby powiadomić Cię o otrzymaniu wiadomości z sieci mesh. Możesz niezależnie włączyć do 3 pinów.
Opcje konfiguracji dla Modułu Zewnętrznych Powiadomień obejmują: Włączony, Aktywny, Alert Bell (Ogólny), Alert Bell Vibra, Alert Bell Buzzer, Alert Message (Ogólny), Alert Message Vibra, Alert Message Buzzer, Output (Ogólny), Output Vibra, Output Buzzer, Output Milliseconds, Use PWM oraz Nag Timeout. Konfiguracja Zewnętrznych Powiadomień używa wiadomości administratora do wysłania protobuf ConfigModule.ExternalNotificationConfig.
Wartości konfiguracji Modułu Zewnętrznych Powiadomień
-
Włączony: Włącza Moduł Zewnętrznych Powiadomień.
-
Aktywny (ogólny / LED tylko): Określa, czy obwód zewnętrzny jest aktywny, gdy GPIO urządzenia jest niskie czy wysokie. Jeśli ustawione na true, pin będzie aktywny na wysokim poziomie; jeśli ustawione na false, oznacza to aktywność na niskim poziomie.
-
Alert przy otrzymaniu dzwonka (ogólne / LED, wibracje i brzęczyk): Określa, czy alert powinien zostać wyzwolony po otrzymaniu przychodzącego dzwonka.
-
Alert przy otrzymaniu wiadomości (ogólne / LED, wibracje i brzęczyk): Określa, czy alert powinien zostać wyzwolony po otrzymaniu przychodzącej wiadomości.
-
Pin GPIO (ogólne / LED, wibracje i brzęczyk): Określa GPIO, do którego podłączony jest Twój zewnętrzny obwód w urządzeniu. Na urządzeniach z brzęczykiem PWM możesz użyć brzęczyka do powiadomień, ustawiając właściwość use_pwm na TRUE. Pin Brzęczyka zostanie zignorowany, a zamiast niego zostanie użyty device.buzzer_gpio. Jeśli włączysz tryb PWM, urządzenie będzie używać dzwonków RTTTL do powiadomień. Przykłady dzwonków RTTTL znajdziesz tutaj i możesz je przesłać do urządzenia za pomocą aplikacji klienckiej. UWAGA: Na płytkach opartych na ESP32 piny GPIO 34 do 39 to GPI – piny tylko do odczytu. Te piny nie mają wewnętrznych rezystorów podciągających ani ściągających i nie mogą być używane jako wyjścia, więc NIE MOŻESZ używać tych pinów jako wyjść.
-
Jak długo monitorowany GPIO jest aktywny: Określa, jak długo w milisekundach chcesz, aby Twoje GPIO były aktywne; w przypadku opcji powtarzania jest to czas trwania każdego tonu i pauzy, z domyślną wartością 0 ustawioną na 1000ms.
-
Powtarzaj (timeout powiadomienia) (ogólne / LED, wibracje i brzęczyk): Określa, czy alert powinien być powtarzany. Jeśli ustawiona wartość jest większa niż zero, alert będzie powtarzany aż do momentu naciśnięcia przycisku użytkownika lub upłynięcia określonej liczby sekund 'value'.
Klient konfiguracji modułu zewnętrznych powiadomień
Android
Opcje Konfiguracji zewnętrznych powiadomień są dostępne dla Androida.
-
Otwórz Aplikację Meshtastic.
-
Przejdź do: Pionowa elipsa (3 kropki w prawym górnym rogu) > Konfiguracja radia > Zewnętrzne powiadomienia.
Apple
Wszystkie opcje konfiguracji zewnętrznego modułu powiadomień są dostępne na iOS, iPadOS oraz macOS w Ustawienia > Konfiguracja modułu > Zewnętrzne powiadomienia.
CLI
Wszystkie opcje konfiguracji zewnętrznego modułu powiadomień są dostępne w Python CLI. Przykładowe polecenia znajdują się poniżej:
| Ustawienie | Akceptowalne wartości | Domyślny |
| external_notification.enabled | prawda, fałsz | FAŁSZ |
| external_notification.active | prawda, fałsz | FAŁSZ |
| external_notification.alert_bell | prawda, fałsz | FAŁSZ |
| external_notification.alert_bell_vibra | prawda, fałsz | FAŁSZ |
| external_notification.alert_bell_buzzer | prawda, fałsz | FAŁSZ |
| external_notification.alert_message | prawda, fałsz | FAŁSZ |
| external_notification.alert_message_vibra | prawda, fałsz | FAŁSZ |
| external_notification.alert_message_buzzer | prawda, fałsz | FAŁSZ |
| external_notification.output | liczba całkowita | 0 |
| external_notification.output_vibra | liczba całkowita | 0 |
| external_notification.output_buzzer | liczba całkowita | 0 |
| external_notification.output_ms | liczba całkowita (milisekundy) | 0 |
| external_notification.use_pwm | prawda, fałsz | FAŁSZ |
| external_notification.nag_timeout | liczba całkowita (sekundy) | 0 |
-
Włącz/Wyłącz moduł powiadomień zewnętrznych
| meshtastic --set external_notification.enabled true meshtastic --set external_notification.enabled false |
-
Włącz/Wyłącz alert przy nadchodzącym dzwonku
| meshtastic --set external_notification.alert_bell true meshtastic --set external_notification.alert_bell false |
-
Ustaw GPIO aktywne wysokie / niskie (domyślnie false to niskie)
| meshtastic --set external_notification.active false meshtastic --set external_notification.active true |
-
Włącz/Wyłącz alert przy nadchodzącej wiadomości
| meshtastic --set external_notification.alert_message true meshtastic --set external_notification.alert_message false |
-
Ustaw GPIO do monitorowania na 21
| meshtastic --set external_notification.output 21 |
-
Ustaw czas trwania monitorowanego wyjścia GPIO (domyślnie 0 to 1000ms)
| meshtastic --set external_notification.output_ms 0 meshtastic --set external_notification.output_ms 1500 |
UWAGA: Ponieważ urządzenie zostanie zrestartowane po wysłaniu każdej komendy przez CLI, zaleca się łączenie poleceń w jedno podczas ustawiania wielu wartości w sekcji konfiguracyjnej. Na przykład:
| meshtastic --set external_notification.enabled true --set external_notification.alert_bell true |
Web
Wszystkie opcje konfiguracji modułu powiadomień zewnętrznych są dostępne w interfejsie Web UI.
Przykłady
Typ alertu
Znak dzwonka to ASCII 0x07. Aby włączyć powiadomienia zewnętrzne, umieść 0x07 gdziekolwiek w wiadomości tekstowej i upewnij się, że ext_notification.alert_bell jest włączone.
Obsługujemy powiadomienia o dwóch zdarzeniach:
-
Przychodząca wiadomość tekstowa.
-
Przychodząca wiadomość tekstowa zawierająca znak dzwonka ASCII. Obecnie tylko API Pythona może wysłać znak dzwonka ASCII, ale w przyszłości może zostać dodane więcej wsparcia.
Sprzęt zewnętrzny
Zwróć uwagę na maksymalne możliwości poboru i źródła prądu GPIO ESP32 . Najprostsze urządzenia do podłączenia to LED lub aktywny brzęczyk.
Oto kilka pomysłów na zewnętrzny sprzęt:
-
LED
-
Aktywny Brzęczyk
-
Miotacz ognia
-
Światło stroboskopowe
-
Syrena
Znane ograniczenia
Ten moduł monitoruje tylko wiadomości tekstowe. Nie wywołamy żadnych innych typów pakietów.
