2021-02-25 12:35:51 +00:00
|
|
|
syntax = "proto3";
|
|
|
|
|
|
|
|
option java_package = "com.geeksville.mesh";
|
|
|
|
option optimize_for = LITE_RUNTIME;
|
2021-05-24 00:31:38 +00:00
|
|
|
option go_package = "github.com/meshtastic/gomeshproto";
|
2021-02-25 12:35:51 +00:00
|
|
|
|
2021-11-30 19:45:01 +00:00
|
|
|
import "channel.proto";
|
2022-05-02 00:19:54 +00:00
|
|
|
import "config.proto";
|
2022-08-08 00:46:52 +00:00
|
|
|
import "device_metadata.proto";
|
2021-12-09 08:21:30 +00:00
|
|
|
import "mesh.proto";
|
2022-05-02 11:17:43 +00:00
|
|
|
import "module_config.proto";
|
2021-02-25 12:35:51 +00:00
|
|
|
|
2021-02-27 05:43:36 +00:00
|
|
|
option java_outer_classname = "AdminProtos";
|
|
|
|
|
2021-03-07 08:28:48 +00:00
|
|
|
/*
|
2022-02-27 08:58:46 +00:00
|
|
|
* This message is handled by the Admin module and is responsible for all settings/channel read/write operations.
|
2021-04-20 09:08:28 +00:00
|
|
|
* This message is used to do settings operations to both remote AND local nodes.
|
2021-03-07 08:28:48 +00:00
|
|
|
* (Prior to 1.2 these operations were done via special ToRadio operations)
|
|
|
|
*/
|
2021-02-25 12:35:51 +00:00
|
|
|
message AdminMessage {
|
|
|
|
|
2022-05-01 02:38:23 +00:00
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-01 04:41:22 +00:00
|
|
|
enum ConfigType {
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-02 04:03:57 +00:00
|
|
|
DEVICE_CONFIG = 0;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-07 07:48:51 +00:00
|
|
|
POSITION_CONFIG = 1;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-02 04:03:57 +00:00
|
|
|
POWER_CONFIG = 2;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-02 04:03:57 +00:00
|
|
|
WIFI_CONFIG = 3;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-02 04:03:57 +00:00
|
|
|
DISPLAY_CONFIG = 4;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-05-02 04:03:57 +00:00
|
|
|
LORA_CONFIG = 5;
|
2022-08-15 23:32:32 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
BLUETOOTH_CONFIG = 6;
|
2022-05-02 11:17:43 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
enum ModuleConfigType {
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
MQTT_CONFIG = 0;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
SERIAL_CONFIG = 1;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
EXTNOTIF_CONFIG = 2;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
STOREFORWARD_CONFIG = 3;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
RANGETEST_CONFIG = 4;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
TELEMETRY_CONFIG = 5;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
|
|
|
/*
|
2022-05-02 11:17:43 +00:00
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
|
|
|
CANNEDMSG_CONFIG = 6;
|
2022-05-02 11:19:48 +00:00
|
|
|
}
|
2022-05-01 02:38:23 +00:00
|
|
|
|
2022-02-21 07:48:42 +00:00
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2022-09-07 01:34:18 +00:00
|
|
|
oneof payload_variant {
|
2021-11-30 19:45:01 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Set the owner for this node
|
|
|
|
*/
|
|
|
|
User set_owner = 2;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Set channels (using the new API).
|
|
|
|
* A special channel is the "primary channel".
|
|
|
|
* The other records are secondary channels.
|
|
|
|
* Note: only one channel can be marked as primary.
|
|
|
|
* If the client sets a particular channel to be primary, the previous channel will be set to SECONDARY automatically.
|
|
|
|
*/
|
|
|
|
Channel set_channel = 3;
|
|
|
|
|
|
|
|
/*
|
2021-12-09 08:21:30 +00:00
|
|
|
* Send the specified channel in the response to this message
|
2021-11-30 19:45:01 +00:00
|
|
|
* 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;
|
2022-02-21 07:48:42 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2021-11-30 19:45:01 +00:00
|
|
|
Channel get_channel_response = 7;
|
2021-03-11 03:11:45 +00:00
|
|
|
|
2021-12-09 08:21:30 +00:00
|
|
|
/*
|
|
|
|
* Send the current owner data in the response to this message.
|
|
|
|
*/
|
2021-12-30 17:57:14 +00:00
|
|
|
bool get_owner_request = 8;
|
2022-02-21 07:48:42 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2021-12-30 17:57:14 +00:00
|
|
|
User get_owner_response = 9;
|
2021-12-09 08:21:30 +00:00
|
|
|
|
2022-05-01 02:38:23 +00:00
|
|
|
/*
|
2022-05-01 22:29:10 +00:00
|
|
|
* Ask for the following config data to be sent
|
2022-05-01 02:38:23 +00:00
|
|
|
*/
|
2022-05-01 04:41:22 +00:00
|
|
|
ConfigType get_config_request = 10;
|
|
|
|
|
|
|
|
/*
|
2022-05-01 22:29:10 +00:00
|
|
|
* Send the current Config in the response to this message.
|
2022-05-01 04:41:22 +00:00
|
|
|
*/
|
|
|
|
Config get_config_response = 11;
|
2022-05-01 02:38:23 +00:00
|
|
|
|
2022-05-01 22:29:10 +00:00
|
|
|
/*
|
|
|
|
* Set the current Config
|
|
|
|
*/
|
|
|
|
Config set_config = 12;
|
|
|
|
|
2022-05-01 22:38:22 +00:00
|
|
|
/*
|
|
|
|
* Sent immediatly after a config change has been sent to ensure comms, if this is not recieved, the config will be reverted after 10 mins
|
|
|
|
*/
|
|
|
|
bool confirm_set_config = 13;
|
2022-05-02 11:17:43 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Ask for the following config data to be sent
|
|
|
|
*/
|
|
|
|
ModuleConfigType get_module_config_request = 14;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Send the current Config in the response to this message.
|
|
|
|
*/
|
|
|
|
ModuleConfig get_module_config_response = 15;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Set the current Config
|
|
|
|
*/
|
|
|
|
ModuleConfig set_module_config = 16;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Sent immediatly after a config change has been sent to ensure comms, if this is not recieved, the config will be reverted after 10 mins
|
|
|
|
*/
|
|
|
|
bool confirm_set_module_config = 17;
|
2022-05-01 22:38:22 +00:00
|
|
|
|
2022-08-07 23:34:17 +00:00
|
|
|
/*
|
|
|
|
* Send all channels in the response to this message
|
|
|
|
*/
|
|
|
|
bool get_all_channel_request = 18;
|
|
|
|
|
2021-11-30 19:45:01 +00:00
|
|
|
/*
|
|
|
|
* 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;
|
2022-02-21 07:48:42 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* TODO: REPLACE
|
|
|
|
*/
|
2021-11-30 19:45:01 +00:00
|
|
|
bool confirm_set_radio = 33;
|
2021-03-18 11:08:37 +00:00
|
|
|
|
2021-11-30 19:45:01 +00:00
|
|
|
/*
|
|
|
|
* This message is only supported for the simulator porduino build.
|
|
|
|
* If received the simulator will exit successfully.
|
|
|
|
*/
|
|
|
|
bool exit_simulator = 34;
|
2021-03-27 02:04:22 +00:00
|
|
|
|
2021-11-30 19:45:01 +00:00
|
|
|
/*
|
|
|
|
* Tell the node to reboot in this many seconds (or <0 to cancel reboot)
|
|
|
|
*/
|
|
|
|
int32 reboot_seconds = 35;
|
2022-01-19 01:39:38 +00:00
|
|
|
|
|
|
|
/*
|
2022-08-15 23:03:07 +00:00
|
|
|
* Get the Canned Message Module messages in the response to this message.
|
2022-01-19 01:39:38 +00:00
|
|
|
*/
|
2022-08-15 23:03:07 +00:00
|
|
|
bool get_canned_message_module_messages_request = 36;
|
2022-02-21 07:48:42 +00:00
|
|
|
|
|
|
|
/*
|
2022-08-15 23:03:07 +00:00
|
|
|
* Get the Canned Message Module messages in the response to this message.
|
2022-01-19 23:43:57 +00:00
|
|
|
*/
|
2022-08-15 23:03:07 +00:00
|
|
|
string get_canned_message_module_messages_response = 37;
|
2022-01-19 01:39:38 +00:00
|
|
|
|
2022-01-19 23:43:57 +00:00
|
|
|
/*
|
2022-08-15 23:03:07 +00:00
|
|
|
* Set the Canned Message Module messages text.
|
2022-01-19 23:43:57 +00:00
|
|
|
*/
|
2022-08-15 23:03:07 +00:00
|
|
|
string set_canned_message_module_messages = 44;
|
2022-01-19 01:39:38 +00:00
|
|
|
|
2022-01-21 00:43:16 +00:00
|
|
|
/*
|
|
|
|
* Tell the node to shutdown in this many seconds (or <0 to cancel shutdown)
|
|
|
|
*/
|
|
|
|
int32 shutdown_seconds = 51;
|
2022-08-07 23:39:54 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Request the node to send device metadata (firmware, protobuf version, etc)
|
|
|
|
*/
|
|
|
|
uint32 get_device_metadata_request = 52;
|
2022-08-08 00:43:46 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Device metadata response
|
|
|
|
*/
|
|
|
|
DeviceMetadata get_device_metadata_response = 53;
|
2021-11-30 19:45:01 +00:00
|
|
|
}
|
2022-02-21 07:48:42 +00:00
|
|
|
}
|