From 3162f74945a4e15b45d7e7585d419d01c8213d6e Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Sat, 30 Jan 2021 09:32:04 -0800 Subject: [PATCH 1/2] Create External Notification documentation. --- docs/software/plugins/ExternalNotification.md | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 docs/software/plugins/ExternalNotification.md diff --git a/docs/software/plugins/ExternalNotification.md b/docs/software/plugins/ExternalNotification.md new file mode 100644 index 00000000..2afb52d4 --- /dev/null +++ b/docs/software/plugins/ExternalNotification.md @@ -0,0 +1,67 @@ +Documentation for ExternalNotification Plugin + +# Configuration + +These are the settings that can be configured. + + ext_notification_plugin_enabled + Is the plugin enabled? + + 0 = Disabled (Default) + 1 = Enabled + + ext_notification_plugin_active + Is your external circuit triggered when our GPIO is low or high? + + 0 = Active Low (Default) + 1 = Active High + + ext_notification_plugin_alert_message + Do you want to be notified on an incoming message? + + 0 = Disabled (Default) + 1 = Alert when a text message comes + + ext_notification_plugin_alert_bell + Do you want to be notified on an incoming bell? + + 0 = Disabled (Default) + 1 = Alert when the bell character is received + + ext_notification_plugin_output + What GPIO is your external circuit attached? + + GPIO of the output. (Default = 13) + + ext_notification_plugin_output_ms + How long do you want us to trigger your external circuit? + + Amount of time in ms for the alert. Default is 1000. + + +# Usage Notes + +For basic usage, start with: + + ext_notification_plugin_enabled = 1 + ext_notification_plugin_alert_message = 1 + +Depending on how your external configured is configured, you may need to set the active state to true. + + ext_notification_plugin_active = 1 + +# External Hardware + +Be mindful of the max current sink and source of the esp32 GPIO. The easiest devices to interface with would be either an LED or Active Buzzer. + + +# Known Problems + +* This won't directly support an passive (normal) speaker as it does not generate any audio wave forms. +* This currently only supports the esp32. Other targets may be possible, I just don't have to test with. + +# Need more help? + +Go to the Meshtastic Discourse Group if you have any questions or to share how you have used this. + +https://meshtastic.discourse.group From f45ffc8773d0330e525a057a6446f79a75dcdfb3 Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Sat, 30 Jan 2021 09:32:44 -0800 Subject: [PATCH 2/2] Rename documentation --- .../{ExternalNotification.md => ExternalNotificationPlugin.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/software/plugins/{ExternalNotification.md => ExternalNotificationPlugin.md} (100%) diff --git a/docs/software/plugins/ExternalNotification.md b/docs/software/plugins/ExternalNotificationPlugin.md similarity index 100% rename from docs/software/plugins/ExternalNotification.md rename to docs/software/plugins/ExternalNotificationPlugin.md