mudhorn/meshtastic
1
0
Fork 0
mirror of https://github.com/meshtastic/meshtastic.git synced 2024-09-21 00:27:35 -07:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Merge pull request #297 from prampec/extend_canned_message_length

Browse source
This commit is contained in:
Foster Irwin 2022-03-27 08:04:00 -06:00 committed by GitHub
parent 8ae33c0633 ccce2b50b9
commit 919e3f07c5
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 31 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

44
docs/settings/canned-message-module.md
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_messages | `string` | `""` |
| 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
@ -143,13 +148,16 @@ Configuring this setting is not yet available for the selected platform. If this
</TabItem>
</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
groupId="settings"
@ -162,8 +170,12 @@ values={[
]}>
<TabItem value="cli">
```bash title="Set Canned Messages"
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="Enable Bell Character"
meshtastic --set canned_message_module_send_bell true
```
```bash title="Disable Bell Character"
meshtastic --set canned_message_module_send_bell false
```
</TabItem>
@ -190,12 +202,16 @@ Configuring this setting is not yet available for the selected platform. If this
</TabItem>
</Tabs>
### canned_message_module_send_bell
### Messages
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.
CLI has a dedicated option for canned message module to set predefines messages: `--set-canned-message <message>`
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
groupId="settings"
@ -208,12 +224,8 @@ values={[
]}>
<TabItem value="cli">
```bash title="Enable Bell Character"
meshtastic --set canned_message_module_send_bell true
```
```bash title="Disable Bell Character"
meshtastic --set canned_message_module_send_bell false
```bash title="Set Canned Messages"
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"
```
</TabItem>

6
docs/software/modules/canned-message.md
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_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 "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
You can define up to 50 messages with a total length 200 bytes.
(We are working on a solution to extend total length.)
You can define up to 50 messages with a total length 800 bytes.
Use short texts as end of line will be truncated on the screen.
:::