From 361312ac5c9de9f5b7f2be6d5ea1363ef112b696 Mon Sep 17 00:00:00 2001 From: Kevin Hester Date: Thu, 11 Mar 2021 11:11:45 +0800 Subject: [PATCH] add confirm messages --- admin.proto | 14 ++++++++++++-- mesh.proto | 2 ++ 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/admin.proto b/admin.proto index 55a04e7..4ae4a1d 100644 --- a/admin.proto +++ b/admin.proto @@ -43,7 +43,17 @@ message AdminMessage { * Send the specified channel in the response for this message * NOTE: This field is sent with the channel index + 1 (to ensure we never try to send 'zero' - which protobufs treats as not present) */ - uint32 get_channel_request = 6; - Channel get_channel_response = 7; + uint32 get_channel_request = 6; + Channel get_channel_response = 7; + + /* Setting channels/radio config remotely carries the risk that you might + * send an invalid config and the radio never talks to your mesh again. + * Therefore if setting either of these properties remotely, you must send + * a confirm_xxx message within 10 minutes. If you fail to do so, the radio + * will assume loss of comms and revert your changes. + * These messages are optional when changing the local node. + */ + bool confirm_set_channel = 32; + bool confirm_set_radio = 33; } } \ No newline at end of file diff --git a/mesh.proto b/mesh.proto index 5fca4f1..e33f030 100644 --- a/mesh.proto +++ b/mesh.proto @@ -106,6 +106,8 @@ message User { * A globally unique ID string for this user. In the case of * Signal that would mean +16504442323, for the default macaddr * derived id it would be !<8 hexidecimal bytes> + * Note: app developers are encouraged to also use the following standard + * node IDs "^all" (for broadcast), "^local" (for the locally connected node) */ string id = 1;