meshtastic-protobuf/admin.proto

75 wiersze
2.3 KiB
Protocol Buffer
Czysty Zwykły widok Historia

2021-02-25 12:35:51 +00:00
syntax = "proto3";
option java_package = "com.geeksville.mesh";
option optimize_for = LITE_RUNTIME;
option go_package = "github.com/meshtastic/gomeshproto";
2021-02-25 12:35:51 +00:00
import "channel.proto";
2021-02-25 12:35:51 +00:00
import "mesh.proto";
import "radioconfig.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
/*
2021-04-20 09:08:28 +00:00
* This message is handled by the Admin plugin and is responsible for all settings/channel read/write operations.
* 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 {
oneof variant {
/*
* Set the radio provisioning for this node
*/
RadioConfig set_radio = 1;
/*
* 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;
/*
* Send the current RadioConfig in the response for this message.
*/
bool get_radio_request = 4;
RadioConfig get_radio_response = 5;
/*
* 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;
2021-03-11 03:11:45 +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;
bool confirm_set_radio = 33;
2021-03-18 11:08:37 +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
/*
* Tell the node to reboot in this many seconds (or <0 to cancel reboot)
*/
int32 reboot_seconds = 35;
}
}