Meach will / libmDot-mbed5

hello 2

Dependents:   ncu_project

Lora.h@64:64982192a2af, 2018-08-23 (annotated)

Committer:
Jenkins@KEILDM1.dc.multitech.prv
Date:
Thu Aug 23 14:18:55 2018 -0500
Revision:
64:64982192a2af
Parent:
60:7985b4783af9
Child:
65:acc0468b9aec
mdot-library revision 3.1.0 and mbed-os revision mbed-os-5.7.7

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Mike Fiore 16:b630e18103e5 1 /** __ ___ ____ _ ______ __ ____ __ ____
Mike Fiore 16:b630e18103e5 2 * / |/ /_ __/ / /_(_)__/_ __/__ ____/ / / __/_ _____ / /____ __ _ ___ / _/__ ____
Mike Fiore 16:b630e18103e5 3 * / /|_/ / // / / __/ /___// / / -_) __/ _ \ _\ \/ // (_-</ __/ -_) ' \(_-< _/ // _ \/ __/ __
Mike Fiore 16:b630e18103e5 4 * /_/ /_/\_,_/_/\__/_/ /_/ \__/\__/_//_/ /___/\_, /___/\__/\__/_/_/_/___/ /___/_//_/\__/ /_/
Mike Fiore 16:b630e18103e5 5 * Copyright (C) 2015 by Multi-Tech Systems /___/
Mike Fiore 16:b630e18103e5 6 *
Mike Fiore 16:b630e18103e5 7 *
Mike Fiore 16:b630e18103e5 8 * @author Jason Reiss
Mike Fiore 16:b630e18103e5 9 * @date 10-31-2015
Mike Fiore 16:b630e18103e5 10 * @brief lora namespace defines global settings, structures and enums for the lora library
Mike Fiore 16:b630e18103e5 11 *
Mike Fiore 16:b630e18103e5 12 * @details
Mike Fiore 16:b630e18103e5 13 *
Mike Fiore 16:b630e18103e5 14 *
Mike Fiore 16:b630e18103e5 15 *
Mike Fiore 16:b630e18103e5 16 */
Mike Fiore 16:b630e18103e5 17
Mike Fiore 16:b630e18103e5 18 #ifndef __LORA_H__
Mike Fiore 16:b630e18103e5 19 #define __LORA_H__
Mike Fiore 16:b630e18103e5 20
Mike Fiore 16:b630e18103e5 21 #include "mbed.h"
Mike Fiore 16:b630e18103e5 22 #include <assert.h>
Mike Fiore 16:b630e18103e5 23 #include "MTSLog.h"
Mike Fiore 16:b630e18103e5 24 //#include <cstring>
Mike Fiore 16:b630e18103e5 25 #include <inttypes.h>
Mike Fiore 16:b630e18103e5 26
Mike Fiore 16:b630e18103e5 27 namespace lora {
Mike Fiore 16:b630e18103e5 28
Mike Fiore 16:b630e18103e5 29 /**
Mike Fiore 16:b630e18103e5 30 * Frequency bandwidth of a Datarate, higher bandwidth gives higher datarate
Mike Fiore 16:b630e18103e5 31 */
Mike Fiore 16:b630e18103e5 32 enum Bandwidth {
Mike Fiore 16:b630e18103e5 33 BW_125,
Mike Fiore 16:b630e18103e5 34 BW_250,
Mike Fiore 16:b630e18103e5 35 BW_500,
Mike Fiore 16:b630e18103e5 36 BW_FSK = 50
Mike Fiore 16:b630e18103e5 37 };
Mike Fiore 16:b630e18103e5 38
Mike Fiore 16:b630e18103e5 39 /**
Mike Fiore 16:b630e18103e5 40 * Spreading factor of a Datarate, lower spreading factor gives higher datarate
Mike Fiore 16:b630e18103e5 41 */
Mike Fiore 16:b630e18103e5 42 enum SpreadingFactors {
Mike Fiore 16:b630e18103e5 43 SF_6 = 6,
Mike Fiore 16:b630e18103e5 44 SF_7,
Mike Fiore 16:b630e18103e5 45 SF_8,
Mike Fiore 16:b630e18103e5 46 SF_9,
Mike Fiore 16:b630e18103e5 47 SF_10,
Mike Fiore 16:b630e18103e5 48 SF_11,
Mike Fiore 16:b630e18103e5 49 SF_12,
Mike Fiore 16:b630e18103e5 50 SF_FSK,
Mike Fiore 16:b630e18103e5 51 SF_INVALID
Mike Fiore 16:b630e18103e5 52 };
Mike Fiore 16:b630e18103e5 53
Mike Fiore 16:b630e18103e5 54 /**
Mike Fiore 16:b630e18103e5 55 * Datarates for use with ChannelPlan
Mike Fiore 16:b630e18103e5 56 */
Mike Fiore 16:b630e18103e5 57 enum Datarates {
Mike Fiore 16:b630e18103e5 58 DR_0 = 0,
Mike Fiore 16:b630e18103e5 59 DR_1,
Mike Fiore 16:b630e18103e5 60 DR_2,
Mike Fiore 16:b630e18103e5 61 DR_3,
Mike Fiore 16:b630e18103e5 62 DR_4,
Mike Fiore 16:b630e18103e5 63 DR_5,
Mike Fiore 16:b630e18103e5 64 DR_6,
Mike Fiore 16:b630e18103e5 65 DR_7,
Mike Fiore 16:b630e18103e5 66 DR_8,
Mike Fiore 16:b630e18103e5 67 DR_9,
Mike Fiore 16:b630e18103e5 68 DR_10,
Mike Fiore 16:b630e18103e5 69 DR_11,
Mike Fiore 16:b630e18103e5 70 DR_12,
Mike Fiore 16:b630e18103e5 71 DR_13,
Mike Fiore 16:b630e18103e5 72 DR_14,
Mike Fiore 16:b630e18103e5 73 DR_15
Mike Fiore 16:b630e18103e5 74 };
Mike Fiore 16:b630e18103e5 75
Mike Fiore 16:b630e18103e5 76 const uint8_t MIN_DATARATE = (uint8_t) DR_0; //!< Minimum datarate
Mike Fiore 16:b630e18103e5 77
Mike Fiore 16:b630e18103e5 78
Mike Fiore 16:b630e18103e5 79 const uint8_t MAX_PHY_PACKET_SIZE = 255; //!< Maximum size for a packet
Mike Fiore 16:b630e18103e5 80 const uint8_t MAX_APPS = 8; //!< Maximum number of apps sessions to save
Mike Fiore 16:b630e18103e5 81 const uint8_t MAX_MULTICAST_SESSIONS = 8; //!< Maximum number of multicast sessions to save
Mike Fiore 16:b630e18103e5 82 const uint8_t EUI_SIZE = 8; //!< Number of bytes in an EUI
Mike Fiore 16:b630e18103e5 83 const uint8_t KEY_SIZE = 16; //!< Number of bytes in an AES key
Mike Fiore 16:b630e18103e5 84
Mike Fiore 16:b630e18103e5 85 const uint8_t DEFAULT_NUM_CHANNELS = 16; //!< Default number of channels in a plan
Mike Fiore 16:b630e18103e5 86 const uint8_t DEFAULT_RX1_DR_OFFSET = 0; //!< Default datarate offset for first rx window
Mike Fiore 16:b630e18103e5 87 const uint8_t DEFAULT_RX2_DATARATE = 0; //!< Default datarate for second rx window
Mike Fiore 16:b630e18103e5 88 const uint8_t DEFAULT_TX_POWER = 14; //!< Default transmit power
Mike Fiore 16:b630e18103e5 89 const uint8_t DEFAULT_CODE_RATE = 1; //!< Default coding rate 1:4/5, 2:4/6, 3:4/7, 4:4/8
Mike Fiore 16:b630e18103e5 90 const uint8_t DEFAULT_PREAMBLE_LEN = 8; //!< Default preamble length
Mike Fiore 16:b630e18103e5 91
Mike Fiore 16:b630e18103e5 92 const int32_t MAX_FCNT_GAP = 16384; //!< Maximum allowed gap in sequence numbers before roll-over
Mike Fiore 16:b630e18103e5 93
Mike Fiore 16:b630e18103e5 94 const uint16_t PRIVATE_JOIN_DELAY = 1000; //!< Default join delay used for private network
Mike Fiore 16:b630e18103e5 95 const uint16_t PUBLIC_JOIN_DELAY = 5000; //!< Default join delay used for public network
Mike Fiore 16:b630e18103e5 96 const uint16_t DEFAULT_JOIN_DELAY = PRIVATE_JOIN_DELAY; //!< Default join delay1
Mike Fiore 16:b630e18103e5 97 const uint16_t DEFAULT_RX_DELAY = 1000; //!< Default delay for first receive window
Mike Fiore 16:b630e18103e5 98 const uint16_t DEFAULT_RX_TIMEOUT = 3000; //!< Default timeout for receive windows
Mike Fiore 16:b630e18103e5 99
Mike Fiore 16:b630e18103e5 100 const uint8_t HI_DR_SYMBOL_TIMEOUT = 12; //!< Symbol timeout for receive at datarate with SF < 11
Mike Fiore 16:b630e18103e5 101 const uint8_t LO_DR_SYMBOL_TIMEOUT = 8; //!< Symbol timeout for receive at datarate with SF > 10
Mike Fiore 16:b630e18103e5 102
Mike Fiore 16:b630e18103e5 103 const uint16_t RX2_DELAY_OFFSET = 1000; //!< Delay between first and second window
Mike Fiore 16:b630e18103e5 104 const uint16_t RXC_OFFSET = 50; //!< Time between end of RXC after TX and RX1
Mike Fiore 16:b630e18103e5 105
Mike Fiore 16:b630e18103e5 106 const uint8_t US915_125K_NUM_CHANS = 64; //!< Number of 125k channels in US915 channel plan
Mike Fiore 16:b630e18103e5 107 const uint8_t US915_500K_NUM_CHANS = 8; //!< Number of 500k channels in US915 channel plan
Mike Fiore 16:b630e18103e5 108
Mike Fiore 16:b630e18103e5 109 const uint32_t US915_125K_FREQ_BASE = 902300000; //!< Frequency base for 125k US915 uplink channels
Mike Fiore 16:b630e18103e5 110 const uint32_t US915_125K_FREQ_STEP = 200000; //!< Frequency step for 125k US915 uplink channels
Mike Fiore 16:b630e18103e5 111
Mike Fiore 16:b630e18103e5 112 const uint32_t US915_500K_FREQ_BASE = 903000000; //!< Frequency base for 500k US915 uplink channels
Mike Fiore 16:b630e18103e5 113 const uint32_t US915_500K_FREQ_STEP = 1600000; //!< Frequency step for 500k US915 uplink channels
Mike Fiore 16:b630e18103e5 114
Mike Fiore 16:b630e18103e5 115 const uint32_t US915_500K_DBASE = 923300000; //!< Frequency base for 500k US915 downlink channels
Mike Fiore 16:b630e18103e5 116 const uint32_t US915_500K_DSTEP = 600000; //!< Frequency step for 500k US915 downlink channels
Mike Fiore 16:b630e18103e5 117
Mike Fiore 16:b630e18103e5 118 const uint32_t US915_FREQ_MIN = 902000000;
Mike Fiore 16:b630e18103e5 119 const uint32_t US915_FREQ_MAX = 928000000;
Mike Fiore 16:b630e18103e5 120
Mike Fiore 16:b630e18103e5 121 const uint8_t US915_MIN_DATARATE = (uint8_t) DR_0; //!< Minimum transmit datarate for US915
Mike Fiore 16:b630e18103e5 122 const uint8_t US915_MAX_DATARATE = (uint8_t) DR_4; //!< Maximum transmit datarate for US915
Mike Fiore 16:b630e18103e5 123
Mike Fiore 16:b630e18103e5 124 const uint8_t US915_MIN_DATARATE_OFFSET = (uint8_t) 0; //!< Minimum transmit datarate for US915
Mike Fiore 16:b630e18103e5 125 const uint8_t US915_MAX_DATARATE_OFFSET = (uint8_t) 3; //!< Maximum transmit datarate for US915
Mike Fiore 16:b630e18103e5 126
Mike Fiore 16:b630e18103e5 127 const uint8_t AU915_125K_NUM_CHANS = 64; //!< Number of 125k channels in AU915 channel plan
Mike Fiore 16:b630e18103e5 128 const uint8_t AU915_500K_NUM_CHANS = 8; //!< Number of 500k channels in AU915 channel plan
Mike Fiore 16:b630e18103e5 129
Mike Fiore 16:b630e18103e5 130 const uint32_t AU915_125K_FREQ_BASE = 915200000; //!< Frequency base for 125k AU915 uplink channels
Mike Fiore 16:b630e18103e5 131 const uint32_t AU915_125K_FREQ_STEP = 200000; //!< Frequency step for 125k AU915 uplink channels
Mike Fiore 16:b630e18103e5 132
Mike Fiore 16:b630e18103e5 133 const uint32_t AU915_500K_FREQ_BASE = 915900000; //!< Frequency base for 500k AU915 uplink channels
Mike Fiore 16:b630e18103e5 134 const uint32_t AU915_500K_FREQ_STEP = 1600000; //!< Frequency step for 500k AU915 uplink channels
Mike Fiore 16:b630e18103e5 135
Mike Fiore 16:b630e18103e5 136 const uint32_t AU915_500K_DBASE = 923300000; //!< Frequency base for 500k AU915 downlink channels
Mike Fiore 16:b630e18103e5 137 const uint32_t AU915_500K_DSTEP = 600000; //!< Frequency step for 500k AU915 downlink channels
Mike Fiore 16:b630e18103e5 138
Mike Fiore 16:b630e18103e5 139 const uint32_t AU915_FREQ_MIN = 915000000;
Mike Fiore 16:b630e18103e5 140 const uint32_t AU915_FREQ_MAX = 928000000;
Mike Fiore 16:b630e18103e5 141
Mike Fiore 16:b630e18103e5 142 const uint8_t AU915_MIN_DATARATE = (uint8_t) DR_0; //!< Minimum transmit datarate for AU915
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 143 const uint8_t AU915_MAX_DATARATE = (uint8_t) DR_6; //!< Maximum transmit datarate for AU915
Mike Fiore 16:b630e18103e5 144
Mike Fiore 16:b630e18103e5 145 const uint8_t AU915_MIN_DATARATE_OFFSET = (uint8_t) 0; //!< Minimum transmit datarate for AU915
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 146 const uint8_t AU915_MAX_DATARATE_OFFSET = (uint8_t) 5; //!< Maximum transmit datarate for AU915
Mike Fiore 16:b630e18103e5 147
Mike Fiore 16:b630e18103e5 148 const uint8_t EU868_125K_NUM_CHANS = 16; //!< Number of 125k channels in EU868 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 149 const uint8_t EU868_DEFAULT_NUM_CHANS = 3; //!< Number of default channels in EU868 channel plan
Mike Fiore 16:b630e18103e5 150 const uint32_t EU868_125K_FREQ_BASE = 868100000; //!< Frequency base for 125k EU868 uplink channels
Mike Fiore 16:b630e18103e5 151 const uint32_t EU868_125K_FREQ_STEP = 200000; //!< Frequency step for 125k EU868 uplink channels
Mike Fiore 16:b630e18103e5 152 const uint32_t EU868_RX2_FREQ = 869525000; //!< Frequency default for second rx window in EU868
Mike Fiore 16:b630e18103e5 153
Mike Fiore 16:b630e18103e5 154 const uint8_t EU868_TX_POWER_MAX = 14; //!< Max power for EU868 channel plan
Mike Fiore 16:b630e18103e5 155
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 156 const uint8_t KR920_125K_NUM_CHANS = 16; //!< Number of 125k channels in KR920 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 157 const uint8_t KR920_DEFAULT_NUM_CHANS = 3; //!< Number of default channels in KR920 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 158 const uint32_t KR920_125K_FREQ_BASE = 868100000; //!< Frequency base for 125k KR920 uplink channels
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 159 const uint32_t KR920_125K_FREQ_STEP = 200000; //!< Frequency step for 125k KR920 uplink channels
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 160 const uint32_t KR920_RX2_FREQ = 869525000; //!< Frequency default for second rx window in KR920
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 161
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 162 const uint8_t KR920_TX_POWER_MAX = 14; //!< Max power for KR920 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 163
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 164 const uint8_t AS923_125K_NUM_CHANS = 16; //!< Number of 125k channels in AS923 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 165 const uint8_t AS923_DEFAULT_NUM_CHANS = 2; //!< Number of default channels in AS923 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 166 const uint32_t AS923_125K_FREQ_BASE = 868100000; //!< Frequency base for 125k AS923 uplink channels
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 167 const uint32_t AS923_125K_FREQ_STEP = 200000; //!< Frequency step for 125k AS923 uplink channels
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 168 const uint32_t AS923_RX2_FREQ = 869525000; //!< Frequency default for second rx window in AS923
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 169
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 170 const uint8_t AS923_TX_POWER_MAX = 14; //!< Max power for AS923 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 171
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 172 const uint8_t IN865_125K_NUM_CHANS = 16; //!< Number of 125k channels in IN865 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 173 const uint8_t IN865_DEFAULT_NUM_CHANS = 3; //!< Number of default channels in IN865 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 174 const uint32_t IN865_125K_DEF_FREQ_1 = 865062500;
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 175 const uint32_t IN865_125K_DEF_FREQ_2 = 865402500;
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 176 const uint32_t IN865_125K_DEF_FREQ_3 = 865985000;
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 177 const uint32_t IN865_RX2_FREQ = 866550000; //!< Frequency default for second rx window in IN865
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 178
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 179 const uint8_t IN865_TX_POWER_MAX = 30; //!< Max power for IN865 channel plan
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 180
Mike Fiore 16:b630e18103e5 181 // 0.1% duty cycle 863-868
Mike Fiore 16:b630e18103e5 182 // Limiting to 865-868 allows for 1% duty cycle
Mike Fiore 16:b630e18103e5 183 const uint32_t EU868_MILLI_FREQ_MIN = 865000000;
Mike Fiore 16:b630e18103e5 184 const uint32_t EU868_MILLI_FREQ_MAX = 868000000;
Mike Fiore 16:b630e18103e5 185
Mike Fiore 16:b630e18103e5 186 const uint32_t EU868_MILLI_1_FREQ_MIN = 868700000;
Mike Fiore 16:b630e18103e5 187 const uint32_t EU868_MILLI_1_FREQ_MAX = 869200000;
Mike Fiore 16:b630e18103e5 188
Mike Fiore 16:b630e18103e5 189 // 1% duty cycle
Mike Fiore 16:b630e18103e5 190 const uint32_t EU868_CENTI_FREQ_MIN = 868000000;
Mike Fiore 16:b630e18103e5 191 const uint32_t EU868_CENTI_FREQ_MAX = 868600000;
Mike Fiore 16:b630e18103e5 192
Mike Fiore 16:b630e18103e5 193 // 10% duty cycle
Mike Fiore 16:b630e18103e5 194 const uint32_t EU868_DECI_FREQ_MIN = 869400000;
Mike Fiore 16:b630e18103e5 195 const uint32_t EU868_DECI_FREQ_MAX = 869650000;
Mike Fiore 16:b630e18103e5 196
Mike Fiore 16:b630e18103e5 197 // Below 7dBm there is no duty cycle for these frequencies
Mike Fiore 16:b630e18103e5 198 // Up to 14dBm there is 1% duty cycle
Mike Fiore 16:b630e18103e5 199 const uint32_t EU868_VAR_FREQ_MIN = 869700000;
Mike Fiore 16:b630e18103e5 200 const uint32_t EU868_VAR_FREQ_MAX = 870000000;
Mike Fiore 16:b630e18103e5 201
Mike Fiore 16:b630e18103e5 202 const uint32_t EU868_FREQ_MIN = 863000000;
Mike Fiore 16:b630e18103e5 203 const uint32_t EU868_FREQ_MAX = 870000000;
Mike Fiore 16:b630e18103e5 204
Mike Fiore 16:b630e18103e5 205 const uint8_t EU868_MIN_DATARATE = (uint8_t) DR_0; //!< Minimum transmit datarate for EU868
Mike Fiore 16:b630e18103e5 206 const uint8_t EU868_MAX_DATARATE = (uint8_t) DR_7; //!< Maximum transmit datarate for EU868
Mike Fiore 16:b630e18103e5 207
Mike Fiore 16:b630e18103e5 208 const uint8_t EU868_MIN_DATARATE_OFFSET = (uint8_t) 0; //!< Minimum transmit datarate for US915
Mike Fiore 16:b630e18103e5 209 const uint8_t EU868_MAX_DATARATE_OFFSET = (uint8_t) 5; //!< Maximum transmit datarate for US915
Mike Fiore 16:b630e18103e5 210
Mike Fiore 16:b630e18103e5 211 const int16_t DEFAULT_FREE_CHAN_RSSI_THRESHOLD = -90; //!< Threshold for channel activity detection (CAD) dBm
Mike Fiore 16:b630e18103e5 212
Mike Fiore 16:b630e18103e5 213 const uint8_t CHAN_MASK_SIZE = 16; //!< Number of bits in a channel mask
Mike Fiore 16:b630e18103e5 214 const uint8_t COMMANDS_BUFFER_SIZE = 15; //!< Size of Mac Command buffer
Mike Fiore 16:b630e18103e5 215
Mike Fiore 16:b630e18103e5 216 const uint8_t PKT_HEADER = 0; //!< Index to packet mHdr field
Mike Fiore 16:b630e18103e5 217 const uint8_t PKT_ADDRESS = 1; //!< Index to first byte of packet address field
Mike Fiore 16:b630e18103e5 218 const uint8_t PKT_FRAME_CONTROL = PKT_ADDRESS + 4; //!< Index to packet fCtrl field @see UplinkControl
Mike Fiore 16:b630e18103e5 219 const uint8_t PKT_FRAME_COUNTER = PKT_FRAME_CONTROL + 1; //!< Index to packet frame counter field
Mike Fiore 16:b630e18103e5 220 const uint8_t PKT_OPTIONS_START = PKT_FRAME_COUNTER + 2; //!< Index to start of optional mac commands
Mike Fiore 16:b630e18103e5 221
Mike Fiore 16:b630e18103e5 222 const uint8_t PKT_JOIN_APP_NONCE = 1; //!< Index to application nonce in Join Accept message
Mike Fiore 16:b630e18103e5 223 const uint8_t PKT_JOIN_NETWORK_ID = 4; //!< Index to network id in Join Accept message
Mike Fiore 16:b630e18103e5 224 const uint8_t PKT_JOIN_NETWORK_ADDRESS = 7; //!< Index to network address in Join Accept message
Mike Fiore 16:b630e18103e5 225 const uint8_t PKT_JOIN_DL_SETTINGS = 11; //!< Index to downlink settings in Join Accept message
Mike Fiore 16:b630e18103e5 226 const uint8_t PKT_JOIN_RX_DELAY = 12; //!< Index to rx delay in Join Accept message
Mike Fiore 16:b630e18103e5 227
Mike Fiore 16:b630e18103e5 228 const uint8_t ADR_ACK_LIMIT = 64; //!< Number of packets without ADR ACK Request
Mike Fiore 16:b630e18103e5 229 const uint8_t ADR_ACK_DELAY = 32; //!< Number of packets to expect ADR ACK Response within
Mike Fiore 16:b630e18103e5 230
Mike Fiore 16:b630e18103e5 231 const uint16_t ACK_TIMEOUT = 2000; //!< Base millisecond timeout to resend after missed ACK
Mike Fiore 16:b630e18103e5 232 const uint16_t ACK_TIMEOUT_RND = 1000; //!< Random millisecond adjustment to resend after missed ACK
Mike Fiore 16:b630e18103e5 233
Mike Fiore 16:b630e18103e5 234 const uint8_t FRAME_OVERHEAD = 13; //!< Bytes of network info overhead in a frame
Mike Fiore 16:b630e18103e5 235
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 236 const uint16_t MAX_OFF_AIR_WAIT = 5000U; //!< Max time in ms to block for a duty cycle restriction to expire before erroring out
Mike Fiore 16:b630e18103e5 237 /**
Mike Fiore 16:b630e18103e5 238 * Settings for type of network
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 239 *
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 240 * PRIVATE_MTS - Sync Word 0x12, US/AU Downlink frequencies per Frequency Sub Band
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 241 * PUBLIC_LORAWAN - Sync Word 0x34
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 242 * PRIVATE_LORAWAN - Sync Word 0x12
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 243 * PEER_TO_PEER - Sync Word 0x56 used for Dot to Dot communication
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 244 *
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 245 * Join Delay window settings are independent of Network Type setting
Mike Fiore 16:b630e18103e5 246 */
Mike Fiore 16:b630e18103e5 247 enum NetworkType {
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 248 PRIVATE_MTS = 0,
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 249 PUBLIC_LORAWAN = 1,
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 250 PRIVATE_LORAWAN = 2,
Mike Fiore 16:b630e18103e5 251 PEER_TO_PEER = 4
Mike Fiore 16:b630e18103e5 252 };
Mike Fiore 16:b630e18103e5 253
Mike Fiore 16:b630e18103e5 254 /**
Mike Fiore 16:b630e18103e5 255 * Enum for on/off settings
Mike Fiore 16:b630e18103e5 256 */
Mike Fiore 16:b630e18103e5 257 enum Enabled {
Mike Fiore 16:b630e18103e5 258 OFF = 0,
Mike Fiore 16:b630e18103e5 259 ON = 1
Mike Fiore 16:b630e18103e5 260 };
Mike Fiore 16:b630e18103e5 261
Mike Fiore 16:b630e18103e5 262 /**
Mike Fiore 16:b630e18103e5 263 * Return status of mac functions
Mike Fiore 16:b630e18103e5 264 */
Mike Fiore 16:b630e18103e5 265 enum MacStatus {
Mike Fiore 16:b630e18103e5 266 LORA_OK = 0,
Mike Fiore 16:b630e18103e5 267 LORA_ERROR = 1,
Mike Fiore 16:b630e18103e5 268 LORA_JOIN_ERROR = 2,
Mike Fiore 16:b630e18103e5 269 LORA_SEND_ERROR = 3,
Mike Fiore 16:b630e18103e5 270 LORA_MIC_ERROR = 4,
Mike Fiore 16:b630e18103e5 271 LORA_ADDRESS_ERROR = 5,
Mike Fiore 16:b630e18103e5 272 LORA_NO_CHANS_ENABLED = 6,
Mike Fiore 16:b630e18103e5 273 LORA_COMMAND_BUFFER_FULL = 7,
Mike Fiore 16:b630e18103e5 274 LORA_UNKNOWN_MAC_COMMAND = 8,
Mike Fiore 16:b630e18103e5 275 LORA_ADR_OFF = 9,
Mike Fiore 16:b630e18103e5 276 LORA_BUSY = 10,
Mike Fiore 16:b630e18103e5 277 LORA_LINK_BUSY = 11,
Mike Fiore 16:b630e18103e5 278 LORA_RADIO_BUSY = 12,
Mike Fiore 16:b630e18103e5 279 LORA_BUFFER_FULL = 13,
Mike Fiore 16:b630e18103e5 280 LORA_JOIN_BACKOFF = 14,
Mike Fiore 16:b630e18103e5 281 LORA_NO_FREE_CHAN = 15,
Mike Fiore 16:b630e18103e5 282 LORA_AGGREGATED_DUTY_CYCLE = 16,
Jenkins@KEILDM1.dc.multitech.prv 26:17479e0039f6 283 LORA_MAC_COMMAND_ERROR = 17,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 284 LORA_MAX_PAYLOAD_EXCEEDED = 18,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 285 LORA_LBT_CHANNEL_BUSY = 19
Mike Fiore 16:b630e18103e5 286 };
Mike Fiore 16:b630e18103e5 287
Mike Fiore 16:b630e18103e5 288 /**
Mike Fiore 16:b630e18103e5 289 * State for Link
Mike Fiore 16:b630e18103e5 290 */
Mike Fiore 16:b630e18103e5 291 enum LinkState {
Mike Fiore 16:b630e18103e5 292 LINK_IDLE = 0, //!< Link ready to send or receive
Mike Fiore 16:b630e18103e5 293 LINK_TX, //!< Link is busy sending
Mike Fiore 16:b630e18103e5 294 LINK_ACK_TX, //!< Link is busy resending after missed ACK
Mike Fiore 16:b630e18103e5 295 LINK_REP_TX, //!< Link is busy repeating
Mike Fiore 16:b630e18103e5 296 LINK_RX, //!< Link has receive window open
Mike Fiore 16:b630e18103e5 297 LINK_RX1, //!< Link has first received window open
Mike Fiore 16:b630e18103e5 298 LINK_RX2, //!< Link has second received window open
Mike Fiore 16:b630e18103e5 299 LINK_RXC, //!< Link has class C received window open
Mike Fiore 16:b630e18103e5 300 LINK_P2P, //!< Link is busy sending
Mike Fiore 16:b630e18103e5 301 };
Mike Fiore 16:b630e18103e5 302
Mike Fiore 16:b630e18103e5 303 /**
Mike Fiore 16:b630e18103e5 304 * State for MAC
Mike Fiore 16:b630e18103e5 305 */
Mike Fiore 16:b630e18103e5 306 enum MacState {
Mike Fiore 16:b630e18103e5 307 MAC_IDLE,
Mike Fiore 16:b630e18103e5 308 MAC_RX1,
Mike Fiore 16:b630e18103e5 309 MAC_RX2,
Mike Fiore 16:b630e18103e5 310 MAC_RXC,
jreiss 17:306ffaa5d79b 311 MAC_TX,
jreiss 17:306ffaa5d79b 312 MAC_JOIN
Mike Fiore 16:b630e18103e5 313 };
Mike Fiore 16:b630e18103e5 314
Mike Fiore 16:b630e18103e5 315 /**
Mike Fiore 16:b630e18103e5 316 * Operation class for device
Mike Fiore 16:b630e18103e5 317 */
Mike Fiore 16:b630e18103e5 318 enum MoteClass {
Mike Fiore 16:b630e18103e5 319 CLASS_A = 0x00, //!< Device can only receive in windows opened after a transmit
Mike Fiore 16:b630e18103e5 320 CLASS_B = 0x01, //!< Device can receive in windows sychronized with gateway beacon
Mike Fiore 16:b630e18103e5 321 CLASS_C = 0x02 //!< Device can receive any time when not transmitting
Mike Fiore 16:b630e18103e5 322 };
Mike Fiore 16:b630e18103e5 323
Mike Fiore 16:b630e18103e5 324 /**
Mike Fiore 16:b630e18103e5 325 * Direction of a packet
Mike Fiore 16:b630e18103e5 326 */
Mike Fiore 16:b630e18103e5 327 enum Direction {
Mike Fiore 16:b630e18103e5 328 DIR_UP = 0, //!< Packet is sent from mote to gateway
Mike Fiore 16:b630e18103e5 329 DIR_DOWN = 1, //!< Packet was received from gateway
Mike Fiore 16:b630e18103e5 330 DIR_PEER = 2 //!< Packet was received from peer
Mike Fiore 16:b630e18103e5 331 };
Mike Fiore 16:b630e18103e5 332
Mike Fiore 16:b630e18103e5 333
Mike Fiore 16:b630e18103e5 334 /**
Mike Fiore 16:b630e18103e5 335 * Received window used by Link
Mike Fiore 16:b630e18103e5 336 */
Mike Fiore 16:b630e18103e5 337 enum ReceiveWindows {
Mike Fiore 16:b630e18103e5 338 RX_1 = 1, //!< First receive window
Mike Fiore 16:b630e18103e5 339 RX_2, //!< Second receive window
Mike Fiore 16:b630e18103e5 340 RX_BEACON, //!< Beacon receive window
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 341 RX_SLOT, //!< Ping Slot receive window
Jenkins@KEILDM1.dc.multitech.prv 64:64982192a2af 342 RXC, //!< Class C continuous window
Mike Fiore 16:b630e18103e5 343 RX_TEST
Mike Fiore 16:b630e18103e5 344 };
Mike Fiore 16:b630e18103e5 345
Mike Fiore 16:b630e18103e5 346 /**
Mike Fiore 16:b630e18103e5 347 * Datarate range for a Channel
Mike Fiore 16:b630e18103e5 348 */
Mike Fiore 16:b630e18103e5 349 typedef union {
Mike Fiore 16:b630e18103e5 350 int8_t Value;
Mike Fiore 16:b630e18103e5 351 struct {
Mike Fiore 16:b630e18103e5 352 int8_t Min :4;
Mike Fiore 16:b630e18103e5 353 int8_t Max :4;
Mike Fiore 16:b630e18103e5 354 } Fields;
Mike Fiore 16:b630e18103e5 355 } DatarateRange;
Mike Fiore 16:b630e18103e5 356
Mike Fiore 16:b630e18103e5 357 /**
Mike Fiore 16:b630e18103e5 358 * Datarate used for transmitting and receiving
Mike Fiore 16:b630e18103e5 359 */
Mike Fiore 16:b630e18103e5 360 typedef struct Datarate {
Mike Fiore 16:b630e18103e5 361 uint8_t Index;
Mike Fiore 16:b630e18103e5 362 uint8_t Bandwidth;
Mike Fiore 16:b630e18103e5 363 uint8_t Coderate;
Mike Fiore 16:b630e18103e5 364 uint8_t PreambleLength;
Mike Fiore 16:b630e18103e5 365 uint8_t SpreadingFactor;
Mike Fiore 16:b630e18103e5 366 uint8_t Crc;
Mike Fiore 16:b630e18103e5 367 uint8_t TxIQ;
Mike Fiore 16:b630e18103e5 368 uint8_t RxIQ;
Mike Fiore 16:b630e18103e5 369 uint8_t SymbolTimeout();
Mike Fiore 16:b630e18103e5 370 Datarate();
Mike Fiore 16:b630e18103e5 371 } Datarate;
Mike Fiore 16:b630e18103e5 372
Mike Fiore 16:b630e18103e5 373 /**
Mike Fiore 16:b630e18103e5 374 * Channel used for transmitting
Mike Fiore 16:b630e18103e5 375 */
Mike Fiore 16:b630e18103e5 376 typedef struct {
Mike Fiore 16:b630e18103e5 377 uint8_t Index;
Mike Fiore 16:b630e18103e5 378 uint32_t Frequency;
Mike Fiore 16:b630e18103e5 379 DatarateRange DrRange;
Mike Fiore 16:b630e18103e5 380 } Channel;
Mike Fiore 16:b630e18103e5 381
Mike Fiore 16:b630e18103e5 382 /**
Mike Fiore 16:b630e18103e5 383 * Receive window
Mike Fiore 16:b630e18103e5 384 */
Mike Fiore 16:b630e18103e5 385 typedef struct {
Mike Fiore 16:b630e18103e5 386 uint8_t Index;
Mike Fiore 16:b630e18103e5 387 uint32_t Frequency;
Mike Fiore 16:b630e18103e5 388 uint8_t DatarateIndex;
Mike Fiore 16:b630e18103e5 389 } RxWindow;
Mike Fiore 16:b630e18103e5 390
Mike Fiore 16:b630e18103e5 391 /**
Mike Fiore 16:b630e18103e5 392 * Duty band for limiting time-on-air for regional regulations
Mike Fiore 16:b630e18103e5 393 */
Mike Fiore 16:b630e18103e5 394 typedef struct {
Mike Fiore 16:b630e18103e5 395 uint8_t Index;
Mike Fiore 16:b630e18103e5 396 uint32_t FrequencyMin;
Mike Fiore 16:b630e18103e5 397 uint32_t FrequencyMax;
Mike Fiore 16:b630e18103e5 398 uint8_t PowerMax;
Mike Fiore 16:b630e18103e5 399 uint16_t DutyCycle; //!< Multiplier of time on air, 0:100%, 1:50%, 2:33%, 10:10%, 100:1%, 1000,0.1%
Mike Fiore 16:b630e18103e5 400 uint32_t TimeOffEnd; //!< Timestamp when this band will be available
Mike Fiore 16:b630e18103e5 401 } DutyBand;
Mike Fiore 16:b630e18103e5 402
Mike Fiore 16:b630e18103e5 403 /**
Mike Fiore 16:b630e18103e5 404 * Device configuration
Mike Fiore 16:b630e18103e5 405 */
Mike Fiore 16:b630e18103e5 406 typedef struct {
Mike Fiore 16:b630e18103e5 407 uint8_t FrequencyBand; //!< Used to choose ChannelPlan
Mike Fiore 16:b630e18103e5 408 uint8_t EUI[8]; //!< Unique identifier assigned to device
Mike Fiore 16:b630e18103e5 409 } DeviceConfig;
Mike Fiore 16:b630e18103e5 410
Mike Fiore 16:b630e18103e5 411 /**
Mike Fiore 16:b630e18103e5 412 * Network configuration
Mike Fiore 16:b630e18103e5 413 */
Mike Fiore 16:b630e18103e5 414 typedef struct {
Mike Fiore 16:b630e18103e5 415 uint8_t Mode; //!< PUBLIC, PRIVATE or PEER_TO_PEER network mode
Mike Fiore 16:b630e18103e5 416 uint8_t Class; //!< Operating class of device
Mike Fiore 16:b630e18103e5 417 uint8_t EUI[8]; //!< Network ID or AppEUI
Mike Fiore 16:b630e18103e5 418 uint8_t Key[16]; //!< Network Key or AppKey
Mike Fiore 16:b630e18103e5 419 uint8_t JoinDelay; //!< Number of seconds to wait before 1st RX Window
Mike Fiore 16:b630e18103e5 420 uint8_t RxDelay; //!< Number of seconds to wait before 1st RX Window
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 421 uint8_t FrequencySubBand; //!< FrequencySubBand used for US915 hybrid operation 0:72 channels, 1:1-8 channels ...
Mike Fiore 16:b630e18103e5 422 uint8_t AckAttempts; //!< Number of attempts to send packet and receive an ACK from server
Mike Fiore 16:b630e18103e5 423 uint8_t Retries; //!< Number of times to resend a packet without receiving an ACK, redundancy
Mike Fiore 16:b630e18103e5 424 uint8_t ADREnabled; //!< Enable adaptive datarate
Mike Fiore 16:b630e18103e5 425 uint8_t CADEnabled; //!< Enable listen before talk/channel activity detection
Mike Fiore 16:b630e18103e5 426 uint8_t RepeaterMode; //!< Limit payloads to repeater compatible sizes
Mike Fiore 16:b630e18103e5 427 uint8_t TxPower; //!< Default radio output power in dBm
Mike Fiore 16:b630e18103e5 428 uint8_t TxPowerMax; //!< Max transmit power
Mike Fiore 16:b630e18103e5 429 uint8_t TxDatarate; //!< Datarate for P2P transmit
Mike Fiore 16:b630e18103e5 430 uint32_t TxFrequency; //!< Frequency for P2P transmit
Mike Fiore 16:b630e18103e5 431 int8_t AntennaGain; //!< Antenna Gain
Mike Fiore 16:b630e18103e5 432 uint8_t DisableEncryption; //!< Disable Encryption
Mike Fiore 16:b630e18103e5 433 uint8_t DisableCRC; //!< Disable CRC on uplink packets
Mike Fiore 16:b630e18103e5 434 uint16_t P2PACKTimeout;
Mike Fiore 16:b630e18103e5 435 uint16_t P2PACKBackoff;
Mike Fiore 16:b630e18103e5 436 uint8_t JoinRx1DatarateOffset; //!< Offset for datarate for first window
Mike Fiore 16:b630e18103e5 437 uint32_t JoinRx2Frequency; //!< Frequency used in second window
Mike Fiore 16:b630e18103e5 438 uint8_t JoinRx2DatarateIndex; //!< Datarate for second window
Mike Fiore 16:b630e18103e5 439 } NetworkConfig;
Mike Fiore 16:b630e18103e5 440
Mike Fiore 16:b630e18103e5 441 /**
Mike Fiore 16:b630e18103e5 442 * Network session info
Mike Fiore 16:b630e18103e5 443 * Some settings are acquired in join message and others may be changed through Mac Commands from server
Mike Fiore 16:b630e18103e5 444 */
Mike Fiore 16:b630e18103e5 445 typedef struct {
Mike Fiore 16:b630e18103e5 446 uint8_t Joined; //!< State of session
Mike Fiore 16:b630e18103e5 447 uint8_t Rx1DatarateOffset; //!< Offset for datarate for first window
Mike Fiore 16:b630e18103e5 448 uint32_t Rx2Frequency; //!< Frequency used in second window
Mike Fiore 16:b630e18103e5 449 uint8_t Rx2DatarateIndex; //!< Datarate for second window
Mike Fiore 16:b630e18103e5 450 uint8_t TxPower; //!< Current total radiated output power in dBm
Mike Fiore 16:b630e18103e5 451 uint8_t TxDatarate; //!< Current datarate can be changed when ADR is enabled
Mike Fiore 16:b630e18103e5 452 uint32_t Address; //!< Network address
Mike Fiore 16:b630e18103e5 453 uint32_t NetworkID; //!< Network ID 24-bits
Mike Fiore 16:b630e18103e5 454 uint8_t NetworkSessionKey[16]; //!< Network session key
Mike Fiore 16:b630e18103e5 455 uint8_t ApplicationSessionKey[16]; //!< Data session key
Mike Fiore 16:b630e18103e5 456 uint16_t ChannelMask[4]; //!< Current channel mask
Mike Fiore 16:b630e18103e5 457 uint16_t ChannelMask500k; //!< Current channel mask for 500k channels
Mike Fiore 16:b630e18103e5 458 uint32_t DownlinkCounter; //!< Downlink counter of last packet received from server
Mike Fiore 16:b630e18103e5 459 uint32_t UplinkCounter; //!< Uplink counter of last packet received from server
Mike Fiore 16:b630e18103e5 460 uint8_t Redundancy; //!< Number of time to repeat an uplink
Mike Fiore 16:b630e18103e5 461 uint8_t MaxDutyCycle; //!< Current Max Duty Cycle value
Mike Fiore 16:b630e18103e5 462 uint32_t JoinTimeOnAir; //!< Balance of time on air used during join attempts
Mike Fiore 16:b630e18103e5 463 uint32_t JoinTimeOffEnd; //!< RTC time of next join attempt
Mike Fiore 16:b630e18103e5 464 uint32_t JoinFirstAttempt; //!< RTC time of first failed join attempt
Mike Fiore 16:b630e18103e5 465 uint32_t AggregatedTimeOffEnd; //!< Time off air expiration for aggregate duty cycle
Mike Fiore 16:b630e18103e5 466 uint16_t AggregateDutyCycle; //!< Used for enforcing time-on-air
Mike Fiore 16:b630e18103e5 467 uint8_t AckCounter; //!< Current number of packets sent without ACK from server
Mike Fiore 16:b630e18103e5 468 uint8_t AdrCounter; //!< Current number of packets received without downlink from server
Mike Fiore 16:b630e18103e5 469 uint8_t RxDelay; //!< Number of seconds to wait before 1st RX Window
Mike Fiore 16:b630e18103e5 470 uint8_t CommandBuffer[COMMANDS_BUFFER_SIZE]; //!< Buffer to hold Mac Commands and parameters to be sent in next packet
Mike Fiore 16:b630e18103e5 471 uint8_t CommandBufferIndex; //!< Index to place next Mac Command, also current size of Command Buffer
Mike Fiore 16:b630e18103e5 472 bool SrvRequestedAck; //!< Indicator of ACK requested by server in last packet received
Mike Fiore 16:b630e18103e5 473 bool DataPending; //!< Indicator of data pending at server
Mike Fiore 16:b630e18103e5 474 uint8_t RxTimingSetupReqReceived; //!< Indicator that RxTimingSetupAns should be included in uplink
Mike Fiore 16:b630e18103e5 475 uint8_t RxParamSetupReqAnswer; //!< Indicator that RxParamSetupAns should be included in uplink
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 476 uint8_t DlChannelReqAnswer; //!< Indicator that DlChannelAns should be included in uplink
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 477 uint8_t DownlinkDwelltime; //!< On air dwell time for downlink packets 0:NONE,1:400ms
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 478 uint8_t UplinkDwelltime; //!< On air dwell time for uplink packets 0:NONE,1:400ms
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 479 uint8_t Max_EIRP; //!< Maximum allowed EIRP for uplink
Mike Fiore 16:b630e18103e5 480 } NetworkSession;
Mike Fiore 16:b630e18103e5 481
Mike Fiore 16:b630e18103e5 482 /**
Mike Fiore 16:b630e18103e5 483 * Multicast session info
Mike Fiore 16:b630e18103e5 484 */
Mike Fiore 16:b630e18103e5 485 typedef struct {
Mike Fiore 16:b630e18103e5 486 uint32_t Address; //!< Network address
Mike Fiore 16:b630e18103e5 487 uint8_t NetworkSessionKey[16]; //!< Network session key
Mike Fiore 16:b630e18103e5 488 uint8_t DataSessionKey[16]; //!< Data session key
Mike Fiore 16:b630e18103e5 489 uint32_t DownlinkCounter; //!< Downlink counter of last packet received from server
Mike Fiore 16:b630e18103e5 490 } MulticastSession;
Mike Fiore 16:b630e18103e5 491
Mike Fiore 16:b630e18103e5 492 /**
Mike Fiore 16:b630e18103e5 493 * Application configuration
Mike Fiore 16:b630e18103e5 494 */
Mike Fiore 16:b630e18103e5 495 typedef struct {
Mike Fiore 16:b630e18103e5 496 uint8_t Port; //!< Port used by application
Mike Fiore 16:b630e18103e5 497 uint8_t AppEUI; //!< Application ID
Mike Fiore 16:b630e18103e5 498 uint8_t AppKey[16]; //!< Application Key
Mike Fiore 16:b630e18103e5 499 } ApplicationConfig;
Mike Fiore 16:b630e18103e5 500
Mike Fiore 16:b630e18103e5 501 /**
Mike Fiore 16:b630e18103e5 502 * Statistics of current network session
Mike Fiore 16:b630e18103e5 503 */
Mike Fiore 16:b630e18103e5 504 typedef struct Statistics {
Mike Fiore 16:b630e18103e5 505 uint32_t Up; //!< Number of uplink packets sent
Mike Fiore 16:b630e18103e5 506 uint32_t Down; //!< Number of downlink packets received
Mike Fiore 16:b630e18103e5 507 uint32_t Joins; //!< Number of join requests sent
Mike Fiore 16:b630e18103e5 508 uint32_t JoinFails; //!< Number of join requests without response or invalid response
Mike Fiore 16:b630e18103e5 509 uint32_t MissedAcks; //!< Number of missed acknowledgement attempts of confirmed packets
Mike Fiore 16:b630e18103e5 510 uint32_t CRCErrors; //!< Number of CRC errors in received packets
Mike Fiore 16:b630e18103e5 511 int32_t AvgCount; //!< Number of packets used to compute rolling average of RSSI and SNR
Mike Fiore 16:b630e18103e5 512 int16_t Rssi; //!< RSSI of last packet received
Mike Fiore 16:b630e18103e5 513 int16_t RssiMin; //!< Minimum RSSI of last AvgCount packets
Mike Fiore 16:b630e18103e5 514 int16_t RssiMax; //!< Maximum RSSI of last AvgCount packets
Mike Fiore 16:b630e18103e5 515 int16_t RssiAvg; //!< Rolling average RSSI of last AvgCount packets
Mike Fiore 16:b630e18103e5 516 int16_t Snr; //!< SNR of last packet received
Mike Fiore 16:b630e18103e5 517 int16_t SnrMin; //!< Minimum SNR of last AvgCount packets
Mike Fiore 16:b630e18103e5 518 int16_t SnrMax; //!< Maximum SNR of last AvgCount packets
Mike Fiore 16:b630e18103e5 519 int16_t SnrAvg; //!< Rolling average SNR of last AvgCount packets
Mike Fiore 16:b630e18103e5 520 } Statistics;
Mike Fiore 16:b630e18103e5 521
Mike Fiore 16:b630e18103e5 522 /**
Mike Fiore 16:b630e18103e5 523 * Testing settings
Mike Fiore 16:b630e18103e5 524 */
Mike Fiore 16:b630e18103e5 525 typedef struct {
Mike Fiore 16:b630e18103e5 526 uint8_t TestMode;
Mike Fiore 16:b630e18103e5 527 uint8_t SkipMICCheck;
Mike Fiore 16:b630e18103e5 528 uint8_t DisableDutyCycle;
Mike Fiore 16:b630e18103e5 529 uint8_t DisableRx1;
Mike Fiore 16:b630e18103e5 530 uint8_t DisableRx2;
Mike Fiore 16:b630e18103e5 531 uint8_t FixedUplinkCounter;
Mike Fiore 16:b630e18103e5 532 uint8_t DisableRandomJoinDatarate;
Mike Fiore 16:b630e18103e5 533 } Testing;
Mike Fiore 16:b630e18103e5 534
Mike Fiore 16:b630e18103e5 535 /**
Mike Fiore 16:b630e18103e5 536 * Combination of device, network, testing settings and statistics
Mike Fiore 16:b630e18103e5 537 */
Mike Fiore 16:b630e18103e5 538 typedef struct {
Mike Fiore 16:b630e18103e5 539 DeviceConfig Device;
Mike Fiore 16:b630e18103e5 540 NetworkConfig Network;
Mike Fiore 16:b630e18103e5 541 NetworkSession Session;
Mike Fiore 16:b630e18103e5 542 ApplicationConfig Applications[MAX_APPS];
Mike Fiore 16:b630e18103e5 543 MulticastSession Multicast[MAX_MULTICAST_SESSIONS];
Mike Fiore 16:b630e18103e5 544 Statistics Stats;
Mike Fiore 16:b630e18103e5 545 Testing Test;
Mike Fiore 16:b630e18103e5 546 } Settings;
Mike Fiore 16:b630e18103e5 547
Mike Fiore 16:b630e18103e5 548 /**
Mike Fiore 16:b630e18103e5 549 * Downlink settings sent in Join Accept message
Mike Fiore 16:b630e18103e5 550 */
Mike Fiore 16:b630e18103e5 551 typedef union {
Mike Fiore 16:b630e18103e5 552 uint8_t Value;
Mike Fiore 16:b630e18103e5 553 struct {
Mike Fiore 16:b630e18103e5 554 uint8_t Rx2Datarate :4;
Mike Fiore 16:b630e18103e5 555 uint8_t Rx1Offset :3;
Mike Fiore 16:b630e18103e5 556 uint8_t RFU :1;
Mike Fiore 16:b630e18103e5 557 };
Mike Fiore 16:b630e18103e5 558 } DownlinkSettings;
Mike Fiore 16:b630e18103e5 559
Mike Fiore 16:b630e18103e5 560 /**
Mike Fiore 16:b630e18103e5 561 * Frame structure for Join Request
Mike Fiore 16:b630e18103e5 562 */
Mike Fiore 16:b630e18103e5 563 typedef struct {
Mike Fiore 16:b630e18103e5 564 uint8_t Type;
Mike Fiore 16:b630e18103e5 565 uint8_t AppEUI[8];
Mike Fiore 16:b630e18103e5 566 uint8_t DevEUI[8];
Mike Fiore 16:b630e18103e5 567 uint8_t Nonce[2];
Mike Fiore 16:b630e18103e5 568 uint8_t MIC[4];
Mike Fiore 16:b630e18103e5 569 } JoinRequestFrame;
Mike Fiore 16:b630e18103e5 570
Mike Fiore 16:b630e18103e5 571 /**
Mike Fiore 16:b630e18103e5 572 * Mac header of uplink and downlink packets
Mike Fiore 16:b630e18103e5 573 */
Mike Fiore 16:b630e18103e5 574 typedef union {
Mike Fiore 16:b630e18103e5 575 uint8_t Value;
Mike Fiore 16:b630e18103e5 576 struct {
Mike Fiore 16:b630e18103e5 577 uint8_t Major :2;
Mike Fiore 16:b630e18103e5 578 uint8_t RFU :3;
Mike Fiore 16:b630e18103e5 579 uint8_t MType :3;
Mike Fiore 16:b630e18103e5 580 } Bits;
Mike Fiore 16:b630e18103e5 581 } MacHeader;
Mike Fiore 16:b630e18103e5 582
Mike Fiore 16:b630e18103e5 583 /**
Mike Fiore 16:b630e18103e5 584 * Frame control field of uplink packets
Mike Fiore 16:b630e18103e5 585 */
Mike Fiore 16:b630e18103e5 586 typedef union {
Mike Fiore 16:b630e18103e5 587 uint8_t Value;
Mike Fiore 16:b630e18103e5 588 struct {
Mike Fiore 16:b630e18103e5 589 uint8_t OptionsLength :4;
Mike Fiore 16:b630e18103e5 590 uint8_t ClassB :1;
Mike Fiore 16:b630e18103e5 591 uint8_t Ack :1;
Mike Fiore 16:b630e18103e5 592 uint8_t AdrAckReq :1;
Mike Fiore 16:b630e18103e5 593 uint8_t Adr :1;
Mike Fiore 16:b630e18103e5 594 } Bits;
Mike Fiore 16:b630e18103e5 595 } UplinkControl;
Mike Fiore 16:b630e18103e5 596
Mike Fiore 16:b630e18103e5 597 /**
Mike Fiore 16:b630e18103e5 598 * Frame control field of downlink packets
Mike Fiore 16:b630e18103e5 599 */
Mike Fiore 16:b630e18103e5 600 typedef union {
Mike Fiore 16:b630e18103e5 601 uint8_t Value;
Mike Fiore 16:b630e18103e5 602 struct {
Mike Fiore 16:b630e18103e5 603 uint8_t OptionsLength :4;
Mike Fiore 16:b630e18103e5 604 uint8_t FPending :1;
Mike Fiore 16:b630e18103e5 605 uint8_t Ack :1;
Mike Fiore 16:b630e18103e5 606 uint8_t RFU :1;
Mike Fiore 16:b630e18103e5 607 uint8_t Adr :1;
Mike Fiore 16:b630e18103e5 608 } Bits;
Mike Fiore 16:b630e18103e5 609 } DownlinkControl;
Mike Fiore 16:b630e18103e5 610
Mike Fiore 16:b630e18103e5 611 /**
Mike Fiore 16:b630e18103e5 612 * Frame type of packet
Mike Fiore 16:b630e18103e5 613 */
Mike Fiore 16:b630e18103e5 614 typedef enum {
Mike Fiore 16:b630e18103e5 615 FRAME_TYPE_JOIN_REQ = 0x00,
Mike Fiore 16:b630e18103e5 616 FRAME_TYPE_JOIN_ACCEPT = 0x01,
Mike Fiore 16:b630e18103e5 617 FRAME_TYPE_DATA_UNCONFIRMED_UP = 0x02,
Mike Fiore 16:b630e18103e5 618 FRAME_TYPE_DATA_UNCONFIRMED_DOWN = 0x03,
Mike Fiore 16:b630e18103e5 619 FRAME_TYPE_DATA_CONFIRMED_UP = 0x04,
Mike Fiore 16:b630e18103e5 620 FRAME_TYPE_DATA_CONFIRMED_DOWN = 0x05,
Mike Fiore 16:b630e18103e5 621 FRAME_TYPE_RFU = 0x06,
Mike Fiore 16:b630e18103e5 622 FRAME_TYPE_PROPRIETARY = 0x07,
Mike Fiore 16:b630e18103e5 623 } FrameType;
Mike Fiore 16:b630e18103e5 624
Mike Fiore 16:b630e18103e5 625 /**
Mike Fiore 16:b630e18103e5 626 * LoRaWAN mote MAC commands
Mike Fiore 16:b630e18103e5 627 */
Mike Fiore 16:b630e18103e5 628 typedef enum {
Mike Fiore 16:b630e18103e5 629 /* Class A */
Mike Fiore 16:b630e18103e5 630 MOTE_MAC_LINK_CHECK_REQ = 0x02,
Mike Fiore 16:b630e18103e5 631 MOTE_MAC_LINK_ADR_ANS = 0x03,
Mike Fiore 16:b630e18103e5 632 MOTE_MAC_DUTY_CYCLE_ANS = 0x04,
Mike Fiore 16:b630e18103e5 633 MOTE_MAC_RX_PARAM_SETUP_ANS = 0x05,
Mike Fiore 16:b630e18103e5 634 MOTE_MAC_DEV_STATUS_ANS = 0x06,
Mike Fiore 16:b630e18103e5 635 MOTE_MAC_NEW_CHANNEL_ANS = 0x07,
Mike Fiore 16:b630e18103e5 636 MOTE_MAC_RX_TIMING_SETUP_ANS = 0x08,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 637 MOTE_MAC_TX_PARAM_SETUP_ANS = 0x09,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 638 MOTE_MAC_DL_CHANNEL_ANS = 0x0A,
Mike Fiore 16:b630e18103e5 639
Mike Fiore 16:b630e18103e5 640 /* Class B */
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 641 MOTE_MAC_PING_SLOT_INFO_REQ = 0x0B,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 642 MOTE_MAC_PING_SLOT_FREQ_ANS = 0x0C,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 643 MOTE_MAC_PING_SLOT_CHANNEL_ANS = 0x0D,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 644 MOTE_MAC_BEACON_TIMING_REQ = 0x0E,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 645 MOTE_MAC_BEACON_FREQ_ANS = 0x0F,
Mike Fiore 16:b630e18103e5 646
Mike Fiore 16:b630e18103e5 647 /* Multitech */
Mike Fiore 16:b630e18103e5 648 MOTE_MAC_PING_REQ = 0x80,
Mike Fiore 16:b630e18103e5 649 MOTE_MAC_CHANGE_CLASS = 0x81,
Mike Fiore 16:b630e18103e5 650 MOTE_MAC_MULTIPART_START_REQ = 0x82,
Mike Fiore 16:b630e18103e5 651 MOTE_MAC_MULTIPART_START_ANS = 0x83,
Mike Fiore 16:b630e18103e5 652 MOTE_MAC_MULTIPART_CHUNK = 0x84,
Mike Fiore 16:b630e18103e5 653 MOTE_MAC_MULTIPART_END_REQ = 0x85,
Mike Fiore 16:b630e18103e5 654 MOTE_MAC_MULTIPART_END_ANS = 0x86
Mike Fiore 16:b630e18103e5 655 } MoteCommand;
Mike Fiore 16:b630e18103e5 656
Mike Fiore 16:b630e18103e5 657 /*!
Mike Fiore 16:b630e18103e5 658 * LoRaWAN server MAC commands
Mike Fiore 16:b630e18103e5 659 */
Mike Fiore 16:b630e18103e5 660 typedef enum {
Mike Fiore 16:b630e18103e5 661 /* Class A */
Mike Fiore 16:b630e18103e5 662 SRV_MAC_LINK_CHECK_ANS = 0x02,
Mike Fiore 16:b630e18103e5 663 SRV_MAC_LINK_ADR_REQ = 0x03,
Mike Fiore 16:b630e18103e5 664 SRV_MAC_DUTY_CYCLE_REQ = 0x04,
Mike Fiore 16:b630e18103e5 665 SRV_MAC_RX_PARAM_SETUP_REQ = 0x05,
Mike Fiore 16:b630e18103e5 666 SRV_MAC_DEV_STATUS_REQ = 0x06,
Mike Fiore 16:b630e18103e5 667 SRV_MAC_NEW_CHANNEL_REQ = 0x07,
Mike Fiore 16:b630e18103e5 668 SRV_MAC_RX_TIMING_SETUP_REQ = 0x08,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 669 SRV_MAC_TX_PARAM_SETUP_REQ = 0x09,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 670 SRV_MAC_DL_CHANNEL_REQ = 0x0A,
Mike Fiore 16:b630e18103e5 671
Mike Fiore 16:b630e18103e5 672 /* Class B */
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 673 SRV_MAC_PING_SLOT_INFO_ANS = 0x0B,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 674 SRV_MAC_PING_SLOT_FREQ_REQ = 0x0C,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 675 SRV_MAC_PING_SLOT_CHANNEL_REQ = 0x0D,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 676 SRV_MAC_BEACON_TIMING_ANS = 0x0E,
Jenkins@KEILDM1.dc.multitech.prv 60:7985b4783af9 677 SRV_MAC_BEACON_FREQ_REQ = 0x0F,
Mike Fiore 16:b630e18103e5 678
Mike Fiore 16:b630e18103e5 679 /* Multitech */
Mike Fiore 16:b630e18103e5 680 SRV_MAC_PING_ANS = 0x80,
Mike Fiore 16:b630e18103e5 681 SRV_MAC_CHANGE_CLASS = 0x81,
Mike Fiore 16:b630e18103e5 682 SRV_MAC_MULTIPART_START_REQ = 0x82,
Mike Fiore 16:b630e18103e5 683 SRV_MAC_MULTIPART_START_ANS = 0x83,
Mike Fiore 16:b630e18103e5 684 SRV_MAC_MULTIPART_CHUNK = 0x84,
Mike Fiore 16:b630e18103e5 685 SRV_MAC_MULTIPART_END_REQ = 0x85,
Mike Fiore 16:b630e18103e5 686 SRV_MAC_MULTIPART_END_ANS = 0x86
Mike Fiore 16:b630e18103e5 687 } ServerCommand;
Mike Fiore 16:b630e18103e5 688
Mike Fiore 16:b630e18103e5 689 /**
Mike Fiore 16:b630e18103e5 690 * Random seed for software RNG
Mike Fiore 16:b630e18103e5 691 */
Mike Fiore 16:b630e18103e5 692 void srand(uint32_t seed);
Mike Fiore 16:b630e18103e5 693
Mike Fiore 16:b630e18103e5 694 /**
Mike Fiore 16:b630e18103e5 695 * Software RNG for consistent results across differing hardware
Mike Fiore 16:b630e18103e5 696 */
Mike Fiore 16:b630e18103e5 697 int rand(void);
Mike Fiore 16:b630e18103e5 698
Mike Fiore 16:b630e18103e5 699 /**
Mike Fiore 16:b630e18103e5 700 * Generate random number bounded by min and max
Mike Fiore 16:b630e18103e5 701 */
Mike Fiore 16:b630e18103e5 702 int32_t rand_r(int32_t min, int32_t max);
Mike Fiore 16:b630e18103e5 703
Mike Fiore 16:b630e18103e5 704 uint8_t CountBits(uint16_t mask);
Mike Fiore 16:b630e18103e5 705
Mike Fiore 16:b630e18103e5 706 /**
Mike Fiore 16:b630e18103e5 707 * Copy 3-bytes network order from array into LSB of integer value
Mike Fiore 16:b630e18103e5 708 */
Mike Fiore 16:b630e18103e5 709 void CopyNetIDtoInt(const uint8_t* arr, uint32_t& val);
Mike Fiore 16:b630e18103e5 710
Mike Fiore 16:b630e18103e5 711 /**
Mike Fiore 16:b630e18103e5 712 * Copy LSB 3-bytes from integer value into array network order
Mike Fiore 16:b630e18103e5 713 */
Mike Fiore 16:b630e18103e5 714 void CopyNetIDtoArray(uint32_t val, uint8_t* arr);
Mike Fiore 16:b630e18103e5 715
Mike Fiore 16:b630e18103e5 716 /**
Mike Fiore 16:b630e18103e5 717 * Copy 4-bytes network order from array in to integer value
Mike Fiore 16:b630e18103e5 718 */
Mike Fiore 16:b630e18103e5 719 void CopyAddrtoInt(const uint8_t* arr, uint32_t& val);
Mike Fiore 16:b630e18103e5 720
Mike Fiore 16:b630e18103e5 721 /**
Mike Fiore 16:b630e18103e5 722 * Copy 4-bytes from integer in to array network order
Mike Fiore 16:b630e18103e5 723 */
Mike Fiore 16:b630e18103e5 724 void CopyAddrtoArray(uint32_t val, uint8_t* arr);
Mike Fiore 16:b630e18103e5 725
Mike Fiore 16:b630e18103e5 726 /**
Mike Fiore 16:b630e18103e5 727 * Copy 3-bytes network order from array into integer value and multiply by 100
Mike Fiore 16:b630e18103e5 728 */
Mike Fiore 16:b630e18103e5 729 void CopyFreqtoInt(const uint8_t* arr, uint32_t& freq);
Mike Fiore 16:b630e18103e5 730
Mike Fiore 16:b630e18103e5 731 /**
Mike Fiore 16:b630e18103e5 732 * Reverse memory copy
Mike Fiore 16:b630e18103e5 733 */
Mike Fiore 16:b630e18103e5 734 void memcpy_r(uint8_t *dst, const uint8_t *src, size_t n);
Mike Fiore 16:b630e18103e5 735
Mike Fiore 16:b630e18103e5 736 }
Mike Fiore 16:b630e18103e5 737
Mike Fiore 16:b630e18103e5 738 #endif
Mike Fiore 16:b630e18103e5 739