El Módulo de Notificación Externa te permite conectar un buzzer, altavoz, LED u otros dispositivos para notificarte cuando se recibe un mensaje de la red mesh. Puedes habilitar hasta 3 pines de forma independiente.
Las opciones de configuración para el Módulo de Notificación Externa incluyen: Habilitado, Activo, Campana de Alerta (General), Campana de Alerta Vibra, Campana de Alerta Buzzer, Mensaje de Alerta (General), Mensaje de Alerta Vibra, Mensaje de Alerta Buzzer, Salida (General), Salida Vibra, Salida Buzzer, Salida en Milisegundos, Usar PWM, y Tiempo de Espera Nag. La configuración de Notificación Externa usa un mensaje de administrador para enviar un protobuf ConfigModule.ExternalNotificationConfig.
Valores de Configuración del Módulo de Notificación Externa
-
Habilitado: Habilita el Módulo de Notificación Externa.
-
Activo (general / LED solamente): Especifica si el circuito externo está activo cuando el GPIO del dispositivo está bajo o alto. Si se establece en true, el pin se activará en alto; si se establece en false, significa activo en bajo.
-
Alerta al recibir un timbre (general / LED, vibración y zumbador): Especifica si se debe activar una alerta al recibir un timbre entrante.
-
Alerta al recibir un mensaje (general / LED, vibración y zumbador): Especifica si se debe activar una alerta al recibir un mensaje entrante.
-
Pines GPIO (general / LED, vibración y zumbador): Especifica el GPIO al que está conectado tu circuito externo en el dispositivo. En dispositivos con un zumbador PWM, puedes usar el zumbador para notificaciones configurando la propiedad use_pwm en TRUE. El Pin del zumbador será ignorado y se usará device.buzzer_gpio en su lugar. Si habilitas el modo PWM, el dispositivo usará tonos de llamada RTTTL para notificaciones. Puedes encontrar ejemplos de tonos RTTTL aquí y subirlos al dispositivo mediante una aplicación cliente. NOTA: En placas basadas en ESP32, los GPIOs 34 a 39 son GPIs – pines solo de entrada. Estos pines no tienen resistencias internas pull-up o pull-down y no pueden usarse como salidas, por lo que NO PUEDES usar estos pines como salidas.
-
Cuánto tiempo se activa el GPIO monitoreado: Especifica cuánto tiempo en milisegundos quieres que tus GPIOs estén activos; en el caso de la opción de repetición, esta es la duración de cada tono y pausa, con un valor predeterminado de 0 establecido en 1000ms.
-
Repetir (Tiempo de espera de insistencia) (general / LED, vibración y zumbador): Especifica si la alerta debe repetirse. Si se establece en un valor mayor que cero, la alerta se repetirá hasta que se presione el botón del usuario o haya pasado el número de segundos especificado en 'valor'.
Cliente de configuración del módulo de notificación externa
Android
Las opciones de Configuración de notificación externa están disponibles para Android.
-
Abre la App Meshtastic.
-
Navega a: Elipsis vertical (3 puntos arriba a la derecha) > Configuración de radio > Notificación externa.
Apple
Todas las opciones de configuración del módulo de notificación externa están disponibles en iOS, iPadOS y macOS en Configuración > Configuración del módulo > Notificación externa.
CLI
Todas las opciones de configuración del módulo de notificación externa están disponibles en el CLI de Python. Los comandos de ejemplo están abajo:
| Configuración | Valores aceptables | Predeterminado |
| external_notification.enabled | verdadero, falso | FALSO |
| external_notification.active | verdadero, falso | FALSO |
| external_notification.alert_bell | verdadero, falso | FALSO |
| external_notification.alert_bell_vibra | verdadero, falso | FALSO |
| external_notification.alert_bell_buzzer | verdadero, falso | FALSO |
| external_notification.alert_message | verdadero, falso | FALSO |
| external_notification.alert_message_vibra | verdadero, falso | FALSO |
| external_notification.alert_message_buzzer | verdadero, falso | FALSO |
| external_notification.output | entero | 0 |
| external_notification.output_vibra | entero | 0 |
| external_notification.output_buzzer | entero | 0 |
| external_notification.output_ms | entero (milisegundos) | 0 |
| external_notification.use_pwm | verdadero, falso | FALSO |
| external_notification.nag_timeout | entero (segundos) | 0 |
-
Activar/Desactivar Módulo de Notificación Externa
| meshtastic --set external_notification.enabled true meshtastic --set external_notification.enabled false |
-
Activar/Desactivar alerta en campana entrante
| meshtastic --set external_notification.alert_bell true meshtastic --set external_notification.alert_bell false |
-
Establecer GPIO activo alto/bajo (el valor predeterminado de false es bajo)
| meshtastic --set external_notification.active false meshtastic --set external_notification.active true |
-
Activar/Desactivar alerta en mensaje entrante
| meshtastic --set external_notification.alert_message true meshtastic --set external_notification.alert_message false |
-
Establecer GPIO a monitorear en 21
| meshtastic --set external_notification.output 21 |
-
Establecer duración de salida GPIO monitoreada (el valor predeterminado de 0 es 1000ms)
| meshtastic --set external_notification.output_ms 0 meshtastic --set external_notification.output_ms 1500 |
NOTA: Dado que el dispositivo se reiniciará después de enviar cada comando a través de CLI, se recomienda encadenar los comandos como uno solo al configurar múltiples valores en una sección de configuración. Por ejemplo:
| meshtastic --set external_notification.enabled true --set external_notification.alert_bell true |
Web
Todas las opciones de configuración del módulo de Notificación Externa están disponibles para la Interfaz Web.
Ejemplos
Tipo de alerta
El carácter de campana es ASCII 0x07. Para habilitar notificaciones externas, incluya 0x07 en cualquier parte del mensaje de texto y asegúrese de que ext_notification.alert_bell esté habilitado.
Soportamos alertas en dos eventos:
-
Mensaje de texto entrante.
-
Mensaje de texto entrante que contiene el carácter de campana ASCII. Actualmente, solo la API de Python puede enviar un carácter de campana ASCII, pero se puede agregar más soporte en el futuro.
Hardware externo
Tenga en cuenta la capacidad máxima de absorción y suministro de corriente de los GPIO del ESP32. Los dispositivos más simples para conectar serían un LED o un Zumbador Activo.
Aquí hay algunas ideas para hardware externo:
-
LED
-
Activo Zumbador
-
Lanzallamas
-
Luz estroboscópica
-
Sirena
Limitaciones conocidas
Este módulo solo monitorea mensajes de texto. No activaremos ningún otro tipo de paquete.
