Merge pull request #297 from prampec/extend_canned_message_length

This commit is contained in:
Foster Irwin 2022-03-27 08:04:00 -06:00 committed by GitHub
commit 919e3f07c5
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 31 additions and 19 deletions

View file

@ -35,6 +35,11 @@ Once module settings are changed, a **reset** is required for them to take effec
| canned_message_module_enabled | `true`, `false` | `false` | | canned_message_module_enabled | `true`, `false` | `false` |
| canned_message_module_messages | `string` | `""` | | canned_message_module_messages | `string` | `""` |
| canned_message_module_send_bell | `true`, `false` | `false` | | canned_message_module_send_bell | `true`, `false` | `false` |
| (Messages)* | `string` | `""` |
- Messages can be set with a dedicated option:
`--set-canned-message "<messages>"`
### canned_message_module_allow_input_source ### canned_message_module_allow_input_source
@ -143,13 +148,16 @@ Configuring this setting is not yet available for the selected platform. If this
</TabItem> </TabItem>
</Tabs> </Tabs>
### canned_message_module_messages ### canned_message_module_send_bell
Predefined messages for CannedMessageModule separated by `|` characters. CannedMessageModule also sends a "bell character" with the messages.
The [External Notification Module](external-notification-module) can benefit from this feature as it utilizes the bell character.
You can define up to 50 messages with a total length 1024 bytes. _We have an "External Notification Module", that can be set up to beep, when new message arrives.
This module can also be configured to beep only when message contains the "bell character".
See module documentation (link above) for details._
#### Set canned messages #### Enable/Disable bell character
<Tabs <Tabs
groupId="settings" groupId="settings"
@ -162,8 +170,12 @@ values={[
]}> ]}>
<TabItem value="cli"> <TabItem value="cli">
```bash title="Set Canned Messages" ```bash title="Enable Bell Character"
meshtastic --set canned_message_module_messages "I'm fine|I'm out|I'm back|Need helping hand|Help me with saw|I need an alpinist|I need ambulance|Keep Calm|On my way|I will be late|I'm already waiting|We have company|Beer is cold|Roger" meshtastic --set canned_message_module_send_bell true
```
```bash title="Disable Bell Character"
meshtastic --set canned_message_module_send_bell false
``` ```
</TabItem> </TabItem>
@ -190,12 +202,16 @@ Configuring this setting is not yet available for the selected platform. If this
</TabItem> </TabItem>
</Tabs> </Tabs>
### canned_message_module_send_bell ### Messages
CannedMessageModule also sends a bell character with the messages. CLI has a dedicated option for canned message module to set predefines messages: `--set-canned-message <message>`
The [External Notification Module](external-notification-module) can benefit from this feature as it utilizes the bell character. Predefined messages separated by `|` characters.
#### Enable/Disable bell character You can define up to 50 messages with a total length 800 bytes.
Existing configuration can be queried with CLI option: `--get-canned-message`
#### Set canned messages
<Tabs <Tabs
groupId="settings" groupId="settings"
@ -208,12 +224,8 @@ values={[
]}> ]}>
<TabItem value="cli"> <TabItem value="cli">
```bash title="Enable Bell Character" ```bash title="Set Canned Messages"
meshtastic --set canned_message_module_send_bell true meshtastic --set canned_message_module_messages "I'm fine|I'm out|I'm back|Need helping hand|Help me with saw|I need an alpinist|I need ambulance|Keep Calm|On my way|I will be late|I'm already waiting|We have company|Beer is cold|Roger"
```
```bash title="Disable Bell Character"
meshtastic --set canned_message_module_send_bell false
``` ```
</TabItem> </TabItem>

View file

@ -133,12 +133,12 @@ need to execute a sequence like this:
meshtastic --set canned_message_module_allow_input_source "_any" meshtastic --set canned_message_module_allow_input_source "_any"
meshtastic --set canned_message_module_messages "I'm fine|I'm out|I'm back|Need helping hand|Help me with saw|I need an alpinist|I need ambulance|Keep Calm|On my way|I will be late|I'm already waiting|We have company|Beer is cold|Roger" meshtastic --set canned_message_module_messages "I'm fine|I'm out|I'm back|Need helping hand|Help me with saw|I need an alpinist|I need ambulance|Keep Calm|On my way|I will be late|I'm already waiting|We have company|Beer is cold|Roger"
meshtastic --set canned_message_module_send_bell False
meshtastic --set canned_message_module_enabled True meshtastic --set canned_message_module_enabled True
meshtastic --set-canned-message "What am I doing?|I'm fine|Don't follow me|I'm out|I'm back|Need helping hand|Help me with saw|I need an alpinist|I need ambulance|Keep Calm|On my way|Need 5 mins|I will be late|I'm already waiting|I couldn't join|We have company|Beer is cold|Roger"
:::note :::note
You can define up to 50 messages with a total length 200 bytes. You can define up to 50 messages with a total length 800 bytes.
(We are working on a solution to extend total length.)
Use short texts as end of line will be truncated on the screen. Use short texts as end of line will be truncated on the screen.
::: :::