lorawan-stack/api/lorawan.proto at develop · mmastora/lorawan-stack

781 lines (688 loc) · 27.4 KB
// Copyright © 2019 The Things Network Foundation, The Things Industries B.V.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//     http://www.apache.org/licenses/LICENSE-2.0
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
syntax = "proto3";
import "github.com/envoyproxy/protoc-gen-validate/validate/validate.proto";
import "github.com/gogo/protobuf/gogoproto/gogo.proto";
import "google/protobuf/struct.proto";
import "google/protobuf/timestamp.proto";
import "lorawan-stack/api/identifiers.proto";
package ttn.lorawan.v3;
option go_package = "go.thethings.network/lorawan-stack/v3/pkg/ttnpb";
message Message {
  option (gogoproto.populate) = false;
  MHDR m_hdr = 1 [(gogoproto.embed) = true, (gogoproto.nullable) = false, (validate.rules).message.required = true];
  bytes mic = 2 [(gogoproto.customname) = "MIC", (validate.rules).bytes.len = 4];
  // Payload represents either MACPayload, RejoinRequestPayload, JoinRequestPayload or JoinAcceptPayload
  // - MACPayload length is in range [7:M] bytes, where M is PHY specific.
  // - JoinRequestPayload length is 18 bytes.
  // - JoinAcceptPayload length is either 12 or 28 bytes.
  // - RejoinRequestPayload length is 14 for Type 0 and 2, 19 for Type 1.
  oneof Payload {
    option (validate.required) = true;
    MACPayload mac_payload = 3 [(gogoproto.customname) = "MACPayload"];
    JoinRequestPayload join_request_payload = 4;
    JoinAcceptPayload join_accept_payload = 5;
    RejoinRequestPayload rejoin_request_payload = 6;
  reserved 7; // Reserved for proprietary payload.
enum MType {
  JOIN_REQUEST = 0;
  JOIN_ACCEPT = 1;
  UNCONFIRMED_UP = 2;
  UNCONFIRMED_DOWN = 3;
  CONFIRMED_UP = 4;
  CONFIRMED_DOWN = 5;
  REJOIN_REQUEST = 6;
  PROPRIETARY = 7;
enum Major {
  LORAWAN_R1 = 0;
enum MACVersion {
  option (gogoproto.goproto_enum_prefix) = false;
  option (gogoproto.enum_stringer) = false;
  MAC_UNKNOWN = 0;
  MAC_V1_0 = 1;
  MAC_V1_0_1 = 2;
  MAC_V1_0_2 = 3;
  MAC_V1_1 = 4;
  MAC_V1_0_3 = 5;
  MAC_V1_0_4 = 6;
enum PHYVersion {
  option (gogoproto.goproto_enum_prefix) = false;
  option (gogoproto.enum_stringer) = false;
  PHY_UNKNOWN = 0;
  PHY_V1_0 = 1;
  PHY_V1_0_1 = 2;
  PHY_V1_0_2_REV_A = 3;
  PHY_V1_0_2_REV_B = 4;
  PHY_V1_1_REV_A = 5;
  PHY_V1_1_REV_B = 6;
  PHY_V1_0_3_REV_A = 7;
enum DataRateIndex {
  option (gogoproto.goproto_enum_prefix) = false;
  option (gogoproto.enum_stringer) = false;
  DATA_RATE_0 = 0;
  DATA_RATE_1 = 1;
  DATA_RATE_2 = 2;
  DATA_RATE_3 = 3;
  DATA_RATE_4 = 4;
  DATA_RATE_5 = 5;
  DATA_RATE_6 = 6;
  DATA_RATE_7 = 7;
  DATA_RATE_8 = 8;
  DATA_RATE_9 = 9;
  DATA_RATE_10 = 10;
  DATA_RATE_11 = 11;
  DATA_RATE_12 = 12;
  DATA_RATE_13 = 13;
  DATA_RATE_14 = 14;
  DATA_RATE_15 = 15;
message MHDR {
  MType m_type = 1 [(validate.rules).enum.defined_only = true];
  Major major = 2 [(validate.rules).enum.defined_only = true];
message MACPayload {
  option (gogoproto.populate) = false;
  FHDR f_hdr = 1 [(gogoproto.embed) = true, (gogoproto.nullable) = false, (validate.rules).message.required = true];
  uint32 f_port = 2 [(validate.rules).uint32.lte = 255];
  bytes frm_payload = 3 [(gogoproto.customname) = "FRMPayload"];
  google.protobuf.Struct decoded_payload = 4;
message FHDR {
  option (gogoproto.populate) = false;
  bytes dev_addr = 1 [(gogoproto.nullable) = false, (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.DevAddr"];
  FCtrl f_ctrl = 2 [(gogoproto.embed) = true, (gogoproto.nullable) = false, (validate.rules).message.required = true];
  uint32 f_cnt = 3 [(validate.rules).uint32.lte = 65535];
  bytes f_opts = 4 [(validate.rules).bytes.max_len = 15];
message FCtrl {
  bool adr = 1 [(gogoproto.customname) = "ADR"];
  bool adr_ack_req = 2 [(gogoproto.customname) = "ADRAckReq"]; // Only on uplink.
  bool ack = 3;
  bool f_pending = 4; // Only on downlink.
  bool class_b = 5; // Only on uplink.
message JoinRequestPayload {
  option (gogoproto.populate) = false;
  bytes join_eui = 1 [(gogoproto.nullable) = false, (gogoproto.customname) = "JoinEUI", (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.EUI64"];
  bytes dev_eui = 2 [(gogoproto.nullable) = false, (gogoproto.customname) = "DevEUI", (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.EUI64"];
  bytes dev_nonce = 3 [(gogoproto.nullable) = false, (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.DevNonce"];
enum RejoinType {
  CONTEXT = 0; // Resets DevAddr, Session Keys, Frame Counters, Radio Parameters.
  SESSION = 1; // Equivalent to the initial JoinRequest.
  KEYS = 2; // Resets DevAddr, Session Keys, Frame Counters, while keeping the Radio Parameters.
message RejoinRequestPayload {
  option (gogoproto.populate) = false;
  RejoinType rejoin_type = 1 [(validate.rules).enum.defined_only = true];
  bytes net_id = 2 [(gogoproto.nullable) = false, (gogoproto.customname) = "NetID", (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.NetID"];
  bytes join_eui = 3 [(gogoproto.nullable) = false, (gogoproto.customname) = "JoinEUI", (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.EUI64"];
  bytes dev_eui = 4 [(gogoproto.nullable) = false, (gogoproto.customname) = "DevEUI", (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.EUI64"];
  uint32 rejoin_cnt = 5; // Contains RJCount0 or RJCount1 depending on rejoin_type.
message JoinAcceptPayload {
  option (gogoproto.populate) = false;
  bytes encrypted = 1;
  bytes join_nonce = 2 [(gogoproto.nullable) = false, (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.JoinNonce"];
  bytes net_id = 3 [(gogoproto.nullable) = false, (gogoproto.customname) = "NetID", (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.NetID"];
  bytes dev_addr = 4 [(gogoproto.nullable) = false, (gogoproto.customtype) = "go.thethings.network/lorawan-stack/v3/pkg/types.DevAddr"];
  DLSettings dl_settings = 5 [(gogoproto.embed) = true, (gogoproto.nullable) = false, (validate.rules).message.required = true];
  RxDelay rx_delay = 6 [(validate.rules).enum.defined_only = true];
  CFList cf_list = 7 [(gogoproto.customname) = "CFList"];
message DLSettings {
  option (gogoproto.populate) = false;
  uint32 rx1_dr_offset = 1 [(gogoproto.customname) = "Rx1DROffset", (validate.rules).uint32.lte = 7];
  DataRateIndex rx2_dr = 2 [(gogoproto.customname) = "Rx2DR", (validate.rules).enum.defined_only = true];
  // OptNeg is set if Network Server implements LoRaWAN 1.1 or greater.
  bool opt_neg = 3 [(gogoproto.customname) = "OptNeg"];
enum CFListType {
  FREQUENCIES = 0;
  CHANNEL_MASKS = 1;
message CFList {
  option (gogoproto.populate) = false;
  CFListType type = 1 [(validate.rules).enum.defined_only = true];
  // Frequencies to be broadcasted, in hecto-Hz.
  // These values are broadcasted as 24 bits unsigned integers.
  // This field should not contain default values.
  repeated uint32 freq = 2;
  // ChMasks controlling the channels to be used.
  // Length of this field must be equal to the amount of uplink channels
  // defined by the selected frequency plan.
  repeated bool ch_masks = 3;
enum Class {
  option (gogoproto.goproto_enum_prefix) = false;
  CLASS_A = 0;
  CLASS_B = 1;
  CLASS_C = 2;
enum TxSchedulePriority {
  LOWEST = 0;
  BELOW_NORMAL = 2;
  NORMAL = 3;
  ABOVE_NORMAL = 4;
  HIGH = 5;
  HIGHEST = 6;
message LoRaDataRate {
  // Bandwidth (Hz).
  uint32 bandwidth = 1;
  uint32 spreading_factor = 2;
message FSKDataRate {
  // Bit rate (bps).
  uint32 bit_rate = 1;
message DataRate {
  oneof modulation {
    option (validate.required) = true;
    LoRaDataRate lora = 1 [(gogoproto.customname) = "LoRa"];
    FSKDataRate fsk = 2 [(gogoproto.customname) = "FSK"];
// TxSettings contains the settings for a transmission.
// This message is used on both uplink and downlink.
// On downlink, this is a scheduled transmission.
message TxSettings {
  option (gogoproto.populate) = false;
  // Transmission settings for downlink.
  message Downlink{
    // Index of the antenna on which the uplink was received and/or downlink must be sent.
    uint32 antenna_index = 1;
      // Transmission power (dBm). Only on downlink.
    float tx_power = 2;
    // Invert LoRa polarization; false for LoRaWAN uplink, true for downlink.
    bool invert_polarization = 3;
  // Data rate.
  DataRate data_rate = 1 [(gogoproto.nullable) = false, (validate.rules).message.required = true];
  // LoRaWAN data rate index.
  DataRateIndex data_rate_index = 2 [(validate.rules).enum.defined_only = true];
  // LoRa coding rate.
  string coding_rate = 3;
  // Frequency (Hz).
  uint64 frequency = 4;
  // Send a CRC in the packet; only on uplink; on downlink, CRC should not be enabled.
  bool enable_crc = 5 [(gogoproto.customname) = "EnableCRC"];
  // Timestamp of the gateway concentrator when the uplink message was received, or when the downlink message should be transmitted (microseconds).
  // On downlink, set timestamp to 0 and time to null to use immediate scheduling.
  uint32 timestamp = 6;
  // Time of the gateway when the uplink message was received, or when the downlink message should be transmitted.
  // For downlink, this requires the gateway to have GPS time synchronization.
  google.protobuf.Timestamp time = 7 [(gogoproto.stdtime) = true];
  // Transmission settings for downlink.
  Downlink downlink = 8;
message GatewayAntennaIdentifiers {
  GatewayIdentifiers gateway_ids = 1 [(gogoproto.embed) = true, (gogoproto.nullable) = false, (validate.rules).message.required = true];
  uint32 antenna_index = 2;
message UplinkToken {
  GatewayAntennaIdentifiers ids = 1 [(gogoproto.embed) = true, (gogoproto.nullable) = false, (validate.rules).message.required = true];
  uint32 timestamp = 2;
message DownlinkPath {
  // Set uplink token for class A, B or C downlink to the uplink token received from the corresponding RxMetadata. Uplink tokens are opaque to the Network Server.
  // Set fixed to force using the specified gateway antenna identifiers for downlink. This can only be used for class B or C downlinks.
  oneof path {
    option (validate.required) = true;
    bytes uplink_token = 1;
    GatewayAntennaIdentifiers fixed = 2;
// TxRequest is a request for transmission.
// If sent to a roaming partner, this request is used to generate the DLMetadata Object (see Backend Interfaces 1.0, Table 22).
// If the gateway has a scheduler, this request is sent to the gateway, in the order of gateway_ids.
// Otherwise, the Gateway Server attempts to schedule the request and creates the TxSettings.
message TxRequest {
  option (gogoproto.populate) = false;
  Class class = 1;
  // Downlink paths used to select a gateway for downlink.
  // In class A, the downlink paths are required to only contain uplink tokens.
  // In class B and C, the downlink paths may contain uplink tokens and fixed gateways antenna identifiers.
  repeated DownlinkPath downlink_paths = 2;
  // Rx1 delay (Rx2 delay is Rx1 delay + 1 second).
  RxDelay rx1_delay = 3 [(validate.rules).enum.defined_only = true];
  // LoRaWAN data rate index for Rx1.
  DataRateIndex rx1_data_rate_index = 4 [(validate.rules).enum.defined_only = true];
  // Frequency (Hz) for Rx1.
  uint64 rx1_frequency = 5;
  // LoRaWAN data rate index for Rx2.
  DataRateIndex rx2_data_rate_index = 6 [(validate.rules).enum.defined_only = true];
  // Frequency (Hz) for Rx2.
  uint64 rx2_frequency = 7;
  // Priority for scheduling.
  // Requests with a higher priority are allocated more channel time than messages with a lower priority, in duty-cycle limited regions.
  // A priority of HIGH or higher sets the HiPriorityFlag in the DLMetadata Object.
  TxSchedulePriority priority = 8 [(validate.rules).enum.defined_only = true];
  // Time when the downlink message should be transmitted.
  // This value is only valid for class C downlink; class A downlink uses uplink tokens and class B downlink is scheduled on ping slots.
  // This requires the gateway to have GPS time sychronization.
  // If the absolute time is not set, the first available time will be used that does not conflict or violate regional limitations.
  google.protobuf.Timestamp absolute_time = 9 [(gogoproto.stdtime) = true];
  // Frequency plan ID from which the frequencies in this message are retrieved.
  string frequency_plan_id = 10 [(gogoproto.customname) = "FrequencyPlanID", (validate.rules).string.max_len = 64];
  // Advanced metadata fields
  // - can be used for advanced information or experimental features that are not yet formally defined in the API
  // - field names are written in snake_case
  google.protobuf.Struct advanced = 99;
enum MACCommandIdentifier {
  option (gogoproto.goproto_enum_prefix) = false;
  CID_RFU_0 = 0;
  CID_RESET = 1;
  CID_LINK_CHECK = 2;
  CID_LINK_ADR = 3;
  CID_DUTY_CYCLE = 4;
  CID_RX_PARAM_SETUP = 5;
  CID_DEV_STATUS = 6;
  CID_NEW_CHANNEL = 7;
  CID_RX_TIMING_SETUP = 8;
  CID_TX_PARAM_SETUP = 9;
  CID_DL_CHANNEL = 10;
  CID_REKEY = 11;
  CID_ADR_PARAM_SETUP = 12;
  CID_DEVICE_TIME = 13;
  CID_FORCE_REJOIN = 14;
  CID_REJOIN_PARAM_SETUP = 15;
  CID_PING_SLOT_INFO = 16;
  CID_PING_SLOT_CHANNEL = 17;
  CID_BEACON_TIMING = 18; // Deprecated
  CID_BEACON_FREQ = 19;
  CID_DEVICE_MODE = 32;
message MACCommand {
  option (gogoproto.populate) = false;
  MACCommandIdentifier cid = 1 [(gogoproto.customname) = "CID", (validate.rules).enum = {defined_only: true, not_in:[0]}];
  oneof payload {
    bytes raw_payload = 2;
    ResetInd reset_ind = 3;
    ResetConf reset_conf = 4;
    LinkCheckAns link_check_ans = 5;
    LinkADRReq link_adr_req = 6 [(gogoproto.customname) = "LinkADRReq"];
    LinkADRAns link_adr_ans = 7 [(gogoproto.customname) = "LinkADRAns"];
    DutyCycleReq duty_cycle_req = 8;
    RxParamSetupReq rx_param_setup_req = 9;
    RxParamSetupAns rx_param_setup_ans = 10;
    DevStatusAns dev_status_ans = 11;
    NewChannelReq new_channel_req = 12;
    NewChannelAns new_channel_ans = 13;
    DLChannelReq dl_channel_req = 14 [(gogoproto.customname) = "DLChannelReq"];
    DLChannelAns dl_channel_ans = 15 [(gogoproto.customname) = "DLChannelAns"];
    RxTimingSetupReq rx_timing_setup_req = 16;
    TxParamSetupReq tx_param_setup_req = 17;
    RekeyInd rekey_ind = 18;
    RekeyConf rekey_conf = 19;
    ADRParamSetupReq adr_param_setup_req = 20 [(gogoproto.customname) = "ADRParamSetupReq"];
    DeviceTimeAns device_time_ans = 21;
    ForceRejoinReq force_rejoin_req = 22;
    RejoinParamSetupReq rejoin_param_setup_req = 23;
    RejoinParamSetupAns rejoin_param_setup_ans = 24;
    PingSlotInfoReq ping_slot_info_req = 25;
    PingSlotChannelReq ping_slot_channel_req = 26;
    PingSlotChannelAns ping_slot_channel_ans = 27;
    BeaconTimingAns beacon_timing_ans = 28;
    BeaconFreqReq beacon_freq_req = 29;
    BeaconFreqAns beacon_freq_ans = 30;
    DeviceModeInd device_mode_ind = 31;
    DeviceModeConf device_mode_conf = 32;
  message ResetInd {
    option (gogoproto.populate) = false;
    Minor minor_version = 1 [(validate.rules).enum = {defined_only: true, in:[1]}];
  message ResetConf {
    option (gogoproto.populate) = false;
    Minor minor_version = 1 [(validate.rules).enum = {defined_only: true, in:[1]}];
  message LinkCheckAns {
    option (gogoproto.populate) = false;
    // Indicates the link margin in dB of the received LinkCheckReq, relative to the demodulation floor.
    uint32 margin = 1 [(validate.rules).uint32.lte = 254];
    uint32 gateway_count = 2 [(validate.rules).uint32.lte = 255];
  message LinkADRReq {
    option (gogoproto.populate) = false;
    DataRateIndex data_rate_index = 1 [(validate.rules).enum.defined_only = true];
    uint32 tx_power_index = 2 [(validate.rules).uint32.lte = 15];
    repeated bool channel_mask = 3 [(validate.rules).repeated.max_items = 16];
    reserved 4; // For RFU 7th bit of Redundancy.
    uint32 channel_mask_control = 5 [(validate.rules).uint32.lte = 7];
    uint32 nb_trans = 6 [(validate.rules).uint32.lte = 15];
  message LinkADRAns {
    bool channel_mask_ack = 1;
    bool data_rate_index_ack = 2;
    bool tx_power_index_ack = 3;
  message DutyCycleReq {
    AggregatedDutyCycle max_duty_cycle = 1 [(validate.rules).enum.defined_only = true];
  message RxParamSetupReq {
    option (gogoproto.populate) = false;
    DataRateIndex rx2_data_rate_index = 1 [(validate.rules).enum.defined_only = true];
    uint32 rx1_data_rate_offset = 2 [(validate.rules).uint32.lte = 7];
    uint64 rx2_frequency = 3 [(validate.rules).uint64.gte = 100000]; // Rx2 frequency (Hz).
  message RxParamSetupAns {
    bool rx2_data_rate_index_ack = 1;
    bool rx1_data_rate_offset_ack = 2;
    bool rx2_frequency_ack = 3;
  message DevStatusAns {
    option (gogoproto.populate) = false;
    // Device battery status.
    // 0 indicates that the device is connected to an external power source.
    // 1..254 indicates a battery level.
    // 255 indicates that the device was not able to measure the battery level.
    uint32 battery = 1 [(validate.rules).uint32.lte = 255];
    // SNR of the last downlink (dB; [-32, +31]).
    int32 margin = 2 [(validate.rules).int32 = {gte: -32, lte: 31}];
  message NewChannelReq {
    option (gogoproto.populate) = false;
    uint32 channel_index = 1 [(validate.rules).uint32.lte = 255];
    uint64 frequency = 2 [(validate.rules).uint64 = { lte: 0, gte: 100000 }]; // Channel frequency (Hz).
    DataRateIndex min_data_rate_index = 3 [(validate.rules).enum.defined_only = true];
    DataRateIndex max_data_rate_index = 4 [(validate.rules).enum.defined_only = true];
  message NewChannelAns {
    bool frequency_ack = 1;
    bool data_rate_ack = 2;
  message DLChannelReq {
    option (gogoproto.populate) = false;
    uint32 channel_index = 1 [(validate.rules).uint32.lte = 255];
    uint64 frequency = 2 [(validate.rules).uint64.gte = 100000]; // Downlink channel frequency (Hz).
  message DLChannelAns {
    bool channel_index_ack = 1;
    bool frequency_ack = 2;
  message RxTimingSetupReq {
    RxDelay delay = 1 [(validate.rules).enum.defined_only = true];
  message TxParamSetupReq {
    // Indicates the maximum EIRP value in dBm, indexed by the following vector:
    DeviceEIRP max_eirp_index = 1 [(gogoproto.customname) = "MaxEIRPIndex", (validate.rules).enum.defined_only = true];
    bool uplink_dwell_time = 2;
    bool downlink_dwell_time = 3;
  message RekeyInd {
    Minor minor_version = 1 [(validate.rules).enum.defined_only = true];
  message RekeyConf {
    Minor minor_version = 1 [(validate.rules).enum.defined_only = true];
  message ADRParamSetupReq {
    // Exponent e that configures the ADR_ACK_LIMIT = 2^e messages.
    ADRAckLimitExponent adr_ack_limit_exponent = 1 [(gogoproto.customname) = "ADRAckLimitExponent", (validate.rules).enum.defined_only = true];
    // Exponent e that configures the ADR_ACK_DELAY = 2^e messages.
    ADRAckDelayExponent adr_ack_delay_exponent = 2 [(gogoproto.customname) = "ADRAckDelayExponent", (validate.rules).enum.defined_only = true];
  message DeviceTimeAns {
    google.protobuf.Timestamp time = 7 [(gogoproto.nullable) = false, (gogoproto.stdtime) = true, (validate.rules).timestamp.required = true];
  message ForceRejoinReq {
    option (gogoproto.populate) = false;
    RejoinType rejoin_type = 1 [(validate.rules).enum.defined_only = true];
    DataRateIndex data_rate_index = 2 [(validate.rules).enum.defined_only = true];
    uint32 max_retries = 3 [(validate.rules).uint32.lte = 7];
    // Exponent e that configures the rejoin period = 32 * 2^e + rand(0,32) seconds.
    RejoinPeriodExponent period_exponent = 4 [(validate.rules).enum.defined_only = true];
  message RejoinParamSetupReq {
    // Exponent e that configures the rejoin counter = 2^(e+4) messages.
    RejoinCountExponent max_count_exponent = 1 [(validate.rules).enum.defined_only = true];
    // Exponent e that configures the rejoin timer = 2^(e+10) seconds.
    RejoinTimeExponent max_time_exponent = 2 [(validate.rules).enum.defined_only = true];
  message RejoinParamSetupAns {
    bool max_time_exponent_ack = 1;
  message PingSlotInfoReq {
    PingSlotPeriod period = 1 [(validate.rules).enum.defined_only = true];
  message PingSlotChannelReq {
    option (gogoproto.populate) = false;
    uint64 frequency = 1 [(validate.rules).uint64 = { lte: 0, gte: 100000 }]; // Ping slot channel frequency (Hz).
    DataRateIndex data_rate_index = 2 [(validate.rules).enum.defined_only = true];
  message PingSlotChannelAns {
    bool frequency_ack = 1;
    bool data_rate_index_ack = 2;
  message BeaconTimingAns {
    option (gogoproto.populate) = false;
    uint32 delay = 1 [(validate.rules).uint32.lte = 65535]; // (uint16) See LoRaWAN specification.
    uint32 channel_index = 2 [(validate.rules).uint32.lte = 255];
  message BeaconFreqReq {
    option (gogoproto.populate) = false;
    uint64 frequency = 1 [(validate.rules).uint64 = { lte: 0, gte: 100000 }]; // Frequency of the Class B beacons (Hz).
  message BeaconFreqAns {
    bool frequency_ack = 1;
  message DeviceModeInd {
    Class class = 1 [(validate.rules).enum.defined_only = true];
  message DeviceModeConf {
    Class class = 1 [(validate.rules).enum.defined_only = true];
enum AggregatedDutyCycle {
  option (gogoproto.goproto_enum_prefix) = false;
  DUTY_CYCLE_1 = 0;      // 100%.
  DUTY_CYCLE_2 = 1;      // 50%.
  DUTY_CYCLE_4 = 2;      // 25%.
  DUTY_CYCLE_8 = 3;      // 12.5%.
  DUTY_CYCLE_16 = 4;     // 6.25%.
  DUTY_CYCLE_32 = 5;     // 3.125%.
  DUTY_CYCLE_64 = 6;     // 1.5625%.
  DUTY_CYCLE_128 = 7;    // Roughly 0.781%.
  DUTY_CYCLE_256 = 8;    // Roughly 0.390%.
  DUTY_CYCLE_512 = 9;    // Roughly 0.195%.
  DUTY_CYCLE_1024 = 10;  // Roughly 0.098%.
  DUTY_CYCLE_2048 = 11;  // Roughly 0.049%.
  DUTY_CYCLE_4096 = 12;  // Roughly 0.024%.
  DUTY_CYCLE_8192 = 13;  // Roughly 0.012%.
  DUTY_CYCLE_16384 = 14; // Roughly 0.006%.
  DUTY_CYCLE_32768 = 15; // Roughly 0.003%.
enum PingSlotPeriod {
  option (gogoproto.goproto_enum_prefix) = false;
  PING_EVERY_1S = 0;   // Every second.
  PING_EVERY_2S = 1;   // Every 2 seconds.
  PING_EVERY_4S = 2;   // Every 4 seconds.
  PING_EVERY_8S = 3;   // Every 8 seconds.
  PING_EVERY_16S = 4;  // Every 16 seconds.
  PING_EVERY_32S = 5;  // Every 32 seconds.
  PING_EVERY_64S = 6;  // Every 64 seconds.
  PING_EVERY_128S = 7; // Every 128 seconds.
enum RejoinCountExponent {
  option (gogoproto.goproto_enum_prefix) = false;
  REJOIN_COUNT_16 = 0;
  REJOIN_COUNT_32 = 1;
  REJOIN_COUNT_64 = 2;
  REJOIN_COUNT_128 = 3;
  REJOIN_COUNT_256 = 4;
  REJOIN_COUNT_512 = 5;
  REJOIN_COUNT_1024 = 6;
  REJOIN_COUNT_2048 = 7;
  REJOIN_COUNT_4096 = 8;
  REJOIN_COUNT_8192 = 9;
  REJOIN_COUNT_16384 = 10;
  REJOIN_COUNT_32768 = 11;
  REJOIN_COUNT_65536 = 12;
  REJOIN_COUNT_131072 = 13;
  REJOIN_COUNT_262144 = 14;
  REJOIN_COUNT_524288 = 15;
enum RejoinTimeExponent {
  option (gogoproto.goproto_enum_prefix) = false;
  REJOIN_TIME_0 = 0;   // Every ~17.1 minutes.
  REJOIN_TIME_1 = 1;   // Every ~34.1 minutes.
  REJOIN_TIME_2 = 2;   // Every ~1.1 hours.
  REJOIN_TIME_3 = 3;   // Every ~2.3 hours.
  REJOIN_TIME_4 = 4;   // Every ~4.6 hours.
  REJOIN_TIME_5 = 5;   // Every ~9.1 hours.
  REJOIN_TIME_6 = 6;   // Every ~18.2 hours.
  REJOIN_TIME_7 = 7;   // Every ~1.5 days.
  REJOIN_TIME_8 = 8;   // Every ~3.0 days.
  REJOIN_TIME_9 = 9;   // Every ~6.1 days.
  REJOIN_TIME_10 = 10; // Every ~12.1 days.
  REJOIN_TIME_11 = 11; // Every ~3.5 weeks.
  REJOIN_TIME_12 = 12; // Every ~1.6 months.
  REJOIN_TIME_13 = 13; // Every ~3.2 months.
  REJOIN_TIME_14 = 14; // Every ~6.4 months.
  REJOIN_TIME_15 = 15; // Every ~1.1 year.
enum RejoinPeriodExponent {
  option (gogoproto.goproto_enum_prefix) = false;
  REJOIN_PERIOD_0 = 0; // Every 32 to 64 seconds.
  REJOIN_PERIOD_1 = 1; // Every 64 to 96 seconds.
  REJOIN_PERIOD_2 = 2; // Every 128 to 160 seconds.
  REJOIN_PERIOD_3 = 3; // Every 256 to 288 seconds.
  REJOIN_PERIOD_4 = 4; // Every 512 to 544 seconds.
  REJOIN_PERIOD_5 = 5; // Every 1024 to 1056 seconds.
  REJOIN_PERIOD_6 = 6; // Every 2048 to 2080 seconds.
  REJOIN_PERIOD_7 = 7; // Every 4096 to 4128 seconds.
enum DeviceEIRP {
  option (gogoproto.goproto_enum_prefix) = false;
  DEVICE_EIRP_8 = 0;   // 8 dBm.
  DEVICE_EIRP_10 = 1;  // 10 dBm.
  DEVICE_EIRP_12 = 2;  // 12 dBm.
  DEVICE_EIRP_13 = 3;  // 13 dBm.
  DEVICE_EIRP_14 = 4;  // 14 dBm.
  DEVICE_EIRP_16 = 5;  // 16 dBm.
  DEVICE_EIRP_18 = 6;  // 18 dBm.
  DEVICE_EIRP_20 = 7;  // 20 dBm.
  DEVICE_EIRP_21 = 8;  // 21 dBm.
  DEVICE_EIRP_24 = 9;  // 24 dBm.
  DEVICE_EIRP_26 = 10; // 26 dBm.
  DEVICE_EIRP_27 = 11; // 27 dBm.
  DEVICE_EIRP_29 = 12; // 29 dBm.
  DEVICE_EIRP_30 = 13; // 30 dBm.
  DEVICE_EIRP_33 = 14; // 33 dBm.
  DEVICE_EIRP_36 = 15; // 36 dBm.
enum ADRAckLimitExponent {
  option (gogoproto.goproto_enum_prefix) = false;
  ADR_ACK_LIMIT_1 = 0;
  ADR_ACK_LIMIT_2 = 1;
  ADR_ACK_LIMIT_4 = 2;
  ADR_ACK_LIMIT_8 = 3;
  ADR_ACK_LIMIT_16 = 4;
  ADR_ACK_LIMIT_32 = 5;
  ADR_ACK_LIMIT_64 = 6;
  ADR_ACK_LIMIT_128 = 7;
  ADR_ACK_LIMIT_256 = 8;
  ADR_ACK_LIMIT_512 = 9;
  ADR_ACK_LIMIT_1024 = 10;
  ADR_ACK_LIMIT_2048 = 11;
  ADR_ACK_LIMIT_4096 = 12;
  ADR_ACK_LIMIT_8192 = 13;
  ADR_ACK_LIMIT_16384 = 14;
  ADR_ACK_LIMIT_32768 = 15;
enum ADRAckDelayExponent {
  option (gogoproto.goproto_enum_prefix) = false;
  ADR_ACK_DELAY_1 = 0;
  ADR_ACK_DELAY_2 = 1;
  ADR_ACK_DELAY_4 = 2;
  ADR_ACK_DELAY_8 = 3;
  ADR_ACK_DELAY_16 = 4;
  ADR_ACK_DELAY_32 = 5;
  ADR_ACK_DELAY_64 = 6;
  ADR_ACK_DELAY_128 = 7;
  ADR_ACK_DELAY_256 = 8;
  ADR_ACK_DELAY_512 = 9;
  ADR_ACK_DELAY_1024 = 10;
  ADR_ACK_DELAY_2048 = 11;
  ADR_ACK_DELAY_4096 = 12;
  ADR_ACK_DELAY_8192 = 13;
  ADR_ACK_DELAY_16384 = 14;
  ADR_ACK_DELAY_32768 = 15;
enum RxDelay {
  option (gogoproto.goproto_enum_prefix) = false;
  option (gogoproto.enum_stringer) = false;
  RX_DELAY_0 = 0;   // 1 second.
  RX_DELAY_1 = 1;   // 1 second.
  RX_DELAY_2 = 2;   // 2 seconds.
  RX_DELAY_3 = 3;   // 3 seconds.
  RX_DELAY_4 = 4;   // 4 seconds.
  RX_DELAY_5 = 5;   // 5 seconds.
  RX_DELAY_6 = 6;   // 6 seconds.
  RX_DELAY_7 = 7;   // 7 seconds.
  RX_DELAY_8 = 8;   // 8 seconds.
  RX_DELAY_9 = 9;   // 9 seconds.
  RX_DELAY_10 = 10; // 10 seconds.
  RX_DELAY_11 = 11; // 11 seconds.
  RX_DELAY_12 = 12; // 12 seconds.
  RX_DELAY_13 = 13; // 13 seconds.
  RX_DELAY_14 = 14; // 14 seconds.
  RX_DELAY_15 = 15; // 15 seconds.
enum Minor {
  option (gogoproto.goproto_enum_prefix) = false;
  MINOR_RFU_0 = 0;
  MINOR_1 = 1;
  MINOR_RFU_2 = 2;
  MINOR_RFU_3 = 3;
  MINOR_RFU_4 = 4;
  MINOR_RFU_5 = 5;
  MINOR_RFU_6 = 6;
  MINOR_RFU_7 = 7;
  MINOR_RFU_8 = 8;
  MINOR_RFU_9 = 9;
  MINOR_RFU_10 = 10;
  MINOR_RFU_11 = 11;
  MINOR_RFU_12 = 12;
  MINOR_RFU_13 = 13;
  MINOR_RFU_14 = 14;
  MINOR_RFU_15 = 15;
message DataRateIndexValue {
  DataRateIndex value = 1 [(validate.rules).enum.defined_only = true];
message PingSlotPeriodValue {
  PingSlotPeriod value = 1 [(validate.rules).enum.defined_only = true];
message AggregatedDutyCycleValue {
  AggregatedDutyCycle value = 1 [(validate.rules).enum.defined_only = true];
message RxDelayValue {
  RxDelay value = 1 [(validate.rules).enum.defined_only = true];
message ADRAckLimitExponentValue {
  ADRAckLimitExponent value = 1 [(validate.rules).enum.defined_only = true];
message ADRAckDelayExponentValue {
  ADRAckDelayExponent value = 1 [(validate.rules).enum.defined_only = true];
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

lorawan.proto

Latest commit

History

lorawan.proto

File metadata and controls
