Rishin Amin / LoRaWAN-lib

LoRaWAN-lib publish

Fork of LoRaWAN-lib by Christopher De Bank

LoRaMac.h@0:91d1a7783bb9, 2015-10-20 (annotated)

Committer:
mluis
Date:
Tue Oct 20 13:21:26 2015 +0000
Revision:
0:91d1a7783bb9
Child:
1:91e4e6c60d1e
Library creation synchronized with GitHub LoRaMac-node v3.4 (https://github.com/Lora-net/LoRaMac-node)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mluis 0:91d1a7783bb9 1 /*
mluis 0:91d1a7783bb9 2 / _____) _ | |
mluis 0:91d1a7783bb9 3 ( (____ _____ ____ _| |_ _____ ____| |__
mluis 0:91d1a7783bb9 4 \____ \| ___ | (_ _) ___ |/ ___) _ \
mluis 0:91d1a7783bb9 5 _____) ) ____| | | || |_| ____( (___| | | |
mluis 0:91d1a7783bb9 6 (______/|_____)_|_|_| \__)_____)\____)_| |_|
mluis 0:91d1a7783bb9 7 (C)2013 Semtech
mluis 0:91d1a7783bb9 8
mluis 0:91d1a7783bb9 9 Description: LoRa MAC layer implementation
mluis 0:91d1a7783bb9 10
mluis 0:91d1a7783bb9 11 License: Revised BSD License, see LICENSE.TXT file include in the project
mluis 0:91d1a7783bb9 12
mluis 0:91d1a7783bb9 13 Maintainer: Miguel Luis and Gregory Cristian
mluis 0:91d1a7783bb9 14 */
mluis 0:91d1a7783bb9 15 #ifndef __LORAMAC_H__
mluis 0:91d1a7783bb9 16 #define __LORAMAC_H__
mluis 0:91d1a7783bb9 17
mluis 0:91d1a7783bb9 18 // Includes board dependent definitions such as channels frequencies
mluis 0:91d1a7783bb9 19 #include "LoRaMac-board.h"
mluis 0:91d1a7783bb9 20
mluis 0:91d1a7783bb9 21 /*!
mluis 0:91d1a7783bb9 22 * Beacon interval in us
mluis 0:91d1a7783bb9 23 */
mluis 0:91d1a7783bb9 24 #define BEACON_INTERVAL 128000000
mluis 0:91d1a7783bb9 25
mluis 0:91d1a7783bb9 26 /*!
mluis 0:91d1a7783bb9 27 * Class A&B receive delay in us
mluis 0:91d1a7783bb9 28 */
mluis 0:91d1a7783bb9 29 #define RECEIVE_DELAY1 1000000
mluis 0:91d1a7783bb9 30 #define RECEIVE_DELAY2 2000000
mluis 0:91d1a7783bb9 31
mluis 0:91d1a7783bb9 32 /*!
mluis 0:91d1a7783bb9 33 * Join accept receive delay in us
mluis 0:91d1a7783bb9 34 */
mluis 0:91d1a7783bb9 35 #define JOIN_ACCEPT_DELAY1 5000000
mluis 0:91d1a7783bb9 36 #define JOIN_ACCEPT_DELAY2 6000000
mluis 0:91d1a7783bb9 37
mluis 0:91d1a7783bb9 38 /*!
mluis 0:91d1a7783bb9 39 * Class A&B maximum receive window delay in us
mluis 0:91d1a7783bb9 40 */
mluis 0:91d1a7783bb9 41 #define MAX_RX_WINDOW 3000000
mluis 0:91d1a7783bb9 42
mluis 0:91d1a7783bb9 43 /*!
mluis 0:91d1a7783bb9 44 * Maximum allowed gap for the FCNT field
mluis 0:91d1a7783bb9 45 */
mluis 0:91d1a7783bb9 46 #define MAX_FCNT_GAP 16384
mluis 0:91d1a7783bb9 47
mluis 0:91d1a7783bb9 48 /*!
mluis 0:91d1a7783bb9 49 * ADR acknowledgement counter limit
mluis 0:91d1a7783bb9 50 */
mluis 0:91d1a7783bb9 51 #define ADR_ACK_LIMIT 64
mluis 0:91d1a7783bb9 52
mluis 0:91d1a7783bb9 53 /*!
mluis 0:91d1a7783bb9 54 * Number of ADR acknowledgement requests before returning to default datarate
mluis 0:91d1a7783bb9 55 */
mluis 0:91d1a7783bb9 56 #define ADR_ACK_DELAY 32
mluis 0:91d1a7783bb9 57
mluis 0:91d1a7783bb9 58 /*!
mluis 0:91d1a7783bb9 59 * Number of seconds after the start of the second reception window without
mluis 0:91d1a7783bb9 60 * receiving an acknowledge.
mluis 0:91d1a7783bb9 61 * AckTimeout = ACK_TIMEOUT + Random( -ACK_TIMEOUT_RND, ACK_TIMEOUT_RND )
mluis 0:91d1a7783bb9 62 */
mluis 0:91d1a7783bb9 63 #define ACK_TIMEOUT 2000000
mluis 0:91d1a7783bb9 64
mluis 0:91d1a7783bb9 65 /*!
mluis 0:91d1a7783bb9 66 * Random number of seconds after the start of the second reception window without
mluis 0:91d1a7783bb9 67 * receiving an acknowledge
mluis 0:91d1a7783bb9 68 * AckTimeout = ACK_TIMEOUT + Random( -ACK_TIMEOUT_RND, ACK_TIMEOUT_RND )
mluis 0:91d1a7783bb9 69 */
mluis 0:91d1a7783bb9 70 #define ACK_TIMEOUT_RND 1000000
mluis 0:91d1a7783bb9 71
mluis 0:91d1a7783bb9 72 /*!
mluis 0:91d1a7783bb9 73 * Check the Mac layer state every MAC_STATE_CHECK_TIMEOUT
mluis 0:91d1a7783bb9 74 */
mluis 0:91d1a7783bb9 75 #define MAC_STATE_CHECK_TIMEOUT 1000000
mluis 0:91d1a7783bb9 76
mluis 0:91d1a7783bb9 77 /*!
mluis 0:91d1a7783bb9 78 * Maximum number of times the MAC layer tries to get an acknowledge.
mluis 0:91d1a7783bb9 79 */
mluis 0:91d1a7783bb9 80 #define MAX_ACK_RETRIES 8
mluis 0:91d1a7783bb9 81
mluis 0:91d1a7783bb9 82 /*!
mluis 0:91d1a7783bb9 83 * RSSI free threshold
mluis 0:91d1a7783bb9 84 */
mluis 0:91d1a7783bb9 85 #define RSSI_FREE_TH ( int8_t )( -90 ) // [dBm]
mluis 0:91d1a7783bb9 86
mluis 0:91d1a7783bb9 87 /*!
mluis 0:91d1a7783bb9 88 * Frame direction definition
mluis 0:91d1a7783bb9 89 */
mluis 0:91d1a7783bb9 90 #define UP_LINK 0
mluis 0:91d1a7783bb9 91 #define DOWN_LINK 1
mluis 0:91d1a7783bb9 92
mluis 0:91d1a7783bb9 93 /*!
mluis 0:91d1a7783bb9 94 * Sets the length of the LoRaMAC footer field.
mluis 0:91d1a7783bb9 95 * Mainly indicates the MIC field length
mluis 0:91d1a7783bb9 96 */
mluis 0:91d1a7783bb9 97 #define LORAMAC_MFR_LEN 4
mluis 0:91d1a7783bb9 98
mluis 0:91d1a7783bb9 99 /*!
mluis 0:91d1a7783bb9 100 * Syncword for Private LoRa networks
mluis 0:91d1a7783bb9 101 */
mluis 0:91d1a7783bb9 102 #define LORA_MAC_PRIVATE_SYNCWORD 0x12
mluis 0:91d1a7783bb9 103
mluis 0:91d1a7783bb9 104 /*!
mluis 0:91d1a7783bb9 105 * Syncword for Public LoRa networks
mluis 0:91d1a7783bb9 106 */
mluis 0:91d1a7783bb9 107 #define LORA_MAC_PUBLIC_SYNCWORD 0x34
mluis 0:91d1a7783bb9 108
mluis 0:91d1a7783bb9 109 /*!
mluis 0:91d1a7783bb9 110 * LoRaWAN devices classes definition
mluis 0:91d1a7783bb9 111 */
mluis 0:91d1a7783bb9 112 typedef enum
mluis 0:91d1a7783bb9 113 {
mluis 0:91d1a7783bb9 114 CLASS_A,
mluis 0:91d1a7783bb9 115 CLASS_B,
mluis 0:91d1a7783bb9 116 CLASS_C,
mluis 0:91d1a7783bb9 117 }DeviceClass_t;
mluis 0:91d1a7783bb9 118
mluis 0:91d1a7783bb9 119 /*!
mluis 0:91d1a7783bb9 120 * LoRaMAC channels parameters definition
mluis 0:91d1a7783bb9 121 */
mluis 0:91d1a7783bb9 122 typedef union
mluis 0:91d1a7783bb9 123 {
mluis 0:91d1a7783bb9 124 int8_t Value;
mluis 0:91d1a7783bb9 125 struct
mluis 0:91d1a7783bb9 126 {
mluis 0:91d1a7783bb9 127 int8_t Min : 4;
mluis 0:91d1a7783bb9 128 int8_t Max : 4;
mluis 0:91d1a7783bb9 129 }Fields;
mluis 0:91d1a7783bb9 130 }DrRange_t;
mluis 0:91d1a7783bb9 131
mluis 0:91d1a7783bb9 132 typedef struct
mluis 0:91d1a7783bb9 133 {
mluis 0:91d1a7783bb9 134 uint16_t DCycle;
mluis 0:91d1a7783bb9 135 int8_t TxMaxPower;
mluis 0:91d1a7783bb9 136 uint64_t LastTxDoneTime;
mluis 0:91d1a7783bb9 137 uint64_t TimeOff;
mluis 0:91d1a7783bb9 138 }Band_t;
mluis 0:91d1a7783bb9 139
mluis 0:91d1a7783bb9 140 typedef struct
mluis 0:91d1a7783bb9 141 {
mluis 0:91d1a7783bb9 142 uint32_t Frequency; // Hz
mluis 0:91d1a7783bb9 143 DrRange_t DrRange; // Max datarate [0: SF12, 1: SF11, 2: SF10, 3: SF9, 4: SF8, 5: SF7, 6: SF7, 7: FSK]
mluis 0:91d1a7783bb9 144 // Min datarate [0: SF12, 1: SF11, 2: SF10, 3: SF9, 4: SF8, 5: SF7, 6: SF7, 7: FSK]
mluis 0:91d1a7783bb9 145 uint8_t Band; // Band index
mluis 0:91d1a7783bb9 146 }ChannelParams_t;
mluis 0:91d1a7783bb9 147
mluis 0:91d1a7783bb9 148 typedef struct
mluis 0:91d1a7783bb9 149 {
mluis 0:91d1a7783bb9 150 uint32_t Frequency; // Hz
mluis 0:91d1a7783bb9 151 uint8_t Datarate; // [0: SF12, 1: SF11, 2: SF10, 3: SF9, 4: SF8, 5: SF7, 6: SF7, 7: FSK]
mluis 0:91d1a7783bb9 152 }Rx2ChannelParams_t;
mluis 0:91d1a7783bb9 153
mluis 0:91d1a7783bb9 154 typedef struct MulticastParams_s
mluis 0:91d1a7783bb9 155 {
mluis 0:91d1a7783bb9 156 uint32_t Address;
mluis 0:91d1a7783bb9 157 uint8_t NwkSKey[16];
mluis 0:91d1a7783bb9 158 uint8_t AppSKey[16];
mluis 0:91d1a7783bb9 159 uint32_t DownLinkCounter;
mluis 0:91d1a7783bb9 160 struct MulticastParams_s *Next;
mluis 0:91d1a7783bb9 161 }MulticastParams_t;
mluis 0:91d1a7783bb9 162
mluis 0:91d1a7783bb9 163 /*!
mluis 0:91d1a7783bb9 164 * LoRaMAC frame types
mluis 0:91d1a7783bb9 165 */
mluis 0:91d1a7783bb9 166 typedef enum
mluis 0:91d1a7783bb9 167 {
mluis 0:91d1a7783bb9 168 FRAME_TYPE_JOIN_REQ = 0x00,
mluis 0:91d1a7783bb9 169 FRAME_TYPE_JOIN_ACCEPT = 0x01,
mluis 0:91d1a7783bb9 170 FRAME_TYPE_DATA_UNCONFIRMED_UP = 0x02,
mluis 0:91d1a7783bb9 171 FRAME_TYPE_DATA_UNCONFIRMED_DOWN = 0x03,
mluis 0:91d1a7783bb9 172 FRAME_TYPE_DATA_CONFIRMED_UP = 0x04,
mluis 0:91d1a7783bb9 173 FRAME_TYPE_DATA_CONFIRMED_DOWN = 0x05,
mluis 0:91d1a7783bb9 174 FRAME_TYPE_RFU = 0x06,
mluis 0:91d1a7783bb9 175 FRAME_TYPE_PROPRIETARY = 0x07,
mluis 0:91d1a7783bb9 176 }LoRaMacFrameType_t;
mluis 0:91d1a7783bb9 177
mluis 0:91d1a7783bb9 178 /*!
mluis 0:91d1a7783bb9 179 * LoRaMAC mote MAC commands
mluis 0:91d1a7783bb9 180 */
mluis 0:91d1a7783bb9 181 typedef enum
mluis 0:91d1a7783bb9 182 {
mluis 0:91d1a7783bb9 183 MOTE_MAC_LINK_CHECK_REQ = 0x02,
mluis 0:91d1a7783bb9 184 MOTE_MAC_LINK_ADR_ANS = 0x03,
mluis 0:91d1a7783bb9 185 MOTE_MAC_DUTY_CYCLE_ANS = 0x04,
mluis 0:91d1a7783bb9 186 MOTE_MAC_RX_PARAM_SETUP_ANS = 0x05,
mluis 0:91d1a7783bb9 187 MOTE_MAC_DEV_STATUS_ANS = 0x06,
mluis 0:91d1a7783bb9 188 MOTE_MAC_NEW_CHANNEL_ANS = 0x07,
mluis 0:91d1a7783bb9 189 MOTE_MAC_RX_TIMING_SETUP_ANS = 0x08,
mluis 0:91d1a7783bb9 190 }LoRaMacMoteCmd_t;
mluis 0:91d1a7783bb9 191
mluis 0:91d1a7783bb9 192 /*!
mluis 0:91d1a7783bb9 193 * LoRaMAC server MAC commands
mluis 0:91d1a7783bb9 194 */
mluis 0:91d1a7783bb9 195 typedef enum
mluis 0:91d1a7783bb9 196 {
mluis 0:91d1a7783bb9 197 SRV_MAC_LINK_CHECK_ANS = 0x02,
mluis 0:91d1a7783bb9 198 SRV_MAC_LINK_ADR_REQ = 0x03,
mluis 0:91d1a7783bb9 199 SRV_MAC_DUTY_CYCLE_REQ = 0x04,
mluis 0:91d1a7783bb9 200 SRV_MAC_RX_PARAM_SETUP_REQ = 0x05,
mluis 0:91d1a7783bb9 201 SRV_MAC_DEV_STATUS_REQ = 0x06,
mluis 0:91d1a7783bb9 202 SRV_MAC_NEW_CHANNEL_REQ = 0x07,
mluis 0:91d1a7783bb9 203 SRV_MAC_RX_TIMING_SETUP_REQ = 0x08,
mluis 0:91d1a7783bb9 204 }LoRaMacSrvCmd_t;
mluis 0:91d1a7783bb9 205
mluis 0:91d1a7783bb9 206 /*!
mluis 0:91d1a7783bb9 207 * LoRaMAC Battery level indicator
mluis 0:91d1a7783bb9 208 */
mluis 0:91d1a7783bb9 209 typedef enum
mluis 0:91d1a7783bb9 210 {
mluis 0:91d1a7783bb9 211 BAT_LEVEL_EXT_SRC = 0x00,
mluis 0:91d1a7783bb9 212 BAT_LEVEL_EMPTY = 0x01,
mluis 0:91d1a7783bb9 213 BAT_LEVEL_FULL = 0xFE,
mluis 0:91d1a7783bb9 214 BAT_LEVEL_NO_MEASURE = 0xFF,
mluis 0:91d1a7783bb9 215 }LoRaMacBatteryLevel_t;
mluis 0:91d1a7783bb9 216
mluis 0:91d1a7783bb9 217 /*!
mluis 0:91d1a7783bb9 218 * LoRaMAC header field definition
mluis 0:91d1a7783bb9 219 */
mluis 0:91d1a7783bb9 220 typedef union
mluis 0:91d1a7783bb9 221 {
mluis 0:91d1a7783bb9 222 uint8_t Value;
mluis 0:91d1a7783bb9 223 struct
mluis 0:91d1a7783bb9 224 {
mluis 0:91d1a7783bb9 225 uint8_t Major : 2;
mluis 0:91d1a7783bb9 226 uint8_t RFU : 3;
mluis 0:91d1a7783bb9 227 uint8_t MType : 3;
mluis 0:91d1a7783bb9 228 }Bits;
mluis 0:91d1a7783bb9 229 }LoRaMacHeader_t;
mluis 0:91d1a7783bb9 230
mluis 0:91d1a7783bb9 231 /*!
mluis 0:91d1a7783bb9 232 * LoRaMAC frame header field definition
mluis 0:91d1a7783bb9 233 */
mluis 0:91d1a7783bb9 234 typedef union
mluis 0:91d1a7783bb9 235 {
mluis 0:91d1a7783bb9 236 uint8_t Value;
mluis 0:91d1a7783bb9 237 struct
mluis 0:91d1a7783bb9 238 {
mluis 0:91d1a7783bb9 239 uint8_t FOptsLen : 4;
mluis 0:91d1a7783bb9 240 uint8_t FPending : 1;
mluis 0:91d1a7783bb9 241 uint8_t Ack : 1;
mluis 0:91d1a7783bb9 242 uint8_t AdrAckReq : 1;
mluis 0:91d1a7783bb9 243 uint8_t Adr : 1;
mluis 0:91d1a7783bb9 244 }Bits;
mluis 0:91d1a7783bb9 245 }LoRaMacFrameCtrl_t;
mluis 0:91d1a7783bb9 246
mluis 0:91d1a7783bb9 247 /*!
mluis 0:91d1a7783bb9 248 * LoRaMAC event flags
mluis 0:91d1a7783bb9 249 */
mluis 0:91d1a7783bb9 250 typedef union
mluis 0:91d1a7783bb9 251 {
mluis 0:91d1a7783bb9 252 uint8_t Value;
mluis 0:91d1a7783bb9 253 struct
mluis 0:91d1a7783bb9 254 {
mluis 0:91d1a7783bb9 255 uint8_t Tx : 1;
mluis 0:91d1a7783bb9 256 uint8_t Rx : 1;
mluis 0:91d1a7783bb9 257 uint8_t RxData : 1;
mluis 0:91d1a7783bb9 258 uint8_t Multicast : 1;
mluis 0:91d1a7783bb9 259 uint8_t RxSlot : 2;
mluis 0:91d1a7783bb9 260 uint8_t LinkCheck : 1;
mluis 0:91d1a7783bb9 261 uint8_t JoinAccept : 1;
mluis 0:91d1a7783bb9 262 }Bits;
mluis 0:91d1a7783bb9 263 }LoRaMacEventFlags_t;
mluis 0:91d1a7783bb9 264
mluis 0:91d1a7783bb9 265 typedef enum
mluis 0:91d1a7783bb9 266 {
mluis 0:91d1a7783bb9 267 LORAMAC_EVENT_INFO_STATUS_OK = 0,
mluis 0:91d1a7783bb9 268 LORAMAC_EVENT_INFO_STATUS_ERROR,
mluis 0:91d1a7783bb9 269 LORAMAC_EVENT_INFO_STATUS_TX_TIMEOUT,
mluis 0:91d1a7783bb9 270 LORAMAC_EVENT_INFO_STATUS_RX2_TIMEOUT,
mluis 0:91d1a7783bb9 271 LORAMAC_EVENT_INFO_STATUS_RX2_ERROR,
mluis 0:91d1a7783bb9 272 LORAMAC_EVENT_INFO_STATUS_JOIN_FAIL,
mluis 0:91d1a7783bb9 273 LORAMAC_EVENT_INFO_STATUS_DOWNLINK_FAIL,
mluis 0:91d1a7783bb9 274 LORAMAC_EVENT_INFO_STATUS_ADDRESS_FAIL,
mluis 0:91d1a7783bb9 275 LORAMAC_EVENT_INFO_STATUS_MIC_FAIL,
mluis 0:91d1a7783bb9 276 }LoRaMacEventInfoStatus_t;
mluis 0:91d1a7783bb9 277
mluis 0:91d1a7783bb9 278 /*!
mluis 0:91d1a7783bb9 279 * LoRaMAC event information
mluis 0:91d1a7783bb9 280 */
mluis 0:91d1a7783bb9 281 typedef struct
mluis 0:91d1a7783bb9 282 {
mluis 0:91d1a7783bb9 283 LoRaMacEventInfoStatus_t Status;
mluis 0:91d1a7783bb9 284 bool TxAckReceived;
mluis 0:91d1a7783bb9 285 uint8_t TxNbRetries;
mluis 0:91d1a7783bb9 286 uint8_t TxDatarate;
mluis 0:91d1a7783bb9 287 uint8_t RxPort;
mluis 0:91d1a7783bb9 288 uint8_t *RxBuffer;
mluis 0:91d1a7783bb9 289 uint8_t RxBufferSize;
mluis 0:91d1a7783bb9 290 int16_t RxRssi;
mluis 0:91d1a7783bb9 291 uint8_t RxSnr;
mluis 0:91d1a7783bb9 292 uint16_t Energy;
mluis 0:91d1a7783bb9 293 uint8_t DemodMargin;
mluis 0:91d1a7783bb9 294 uint8_t NbGateways;
mluis 0:91d1a7783bb9 295 }LoRaMacEventInfo_t;
mluis 0:91d1a7783bb9 296
mluis 0:91d1a7783bb9 297 /*!
mluis 0:91d1a7783bb9 298 * LoRaMAC events structure
mluis 0:91d1a7783bb9 299 * Used to notify upper layers of MAC events
mluis 0:91d1a7783bb9 300 */
mluis 0:91d1a7783bb9 301 typedef struct sLoRaMacEvent
mluis 0:91d1a7783bb9 302 {
mluis 0:91d1a7783bb9 303 /*!
mluis 0:91d1a7783bb9 304 * MAC layer event callback prototype.
mluis 0:91d1a7783bb9 305 *
mluis 0:91d1a7783bb9 306 * \param [IN] flags Bit field indicating the MAC events occurred
mluis 0:91d1a7783bb9 307 * \param [IN] info Details about MAC events occurred
mluis 0:91d1a7783bb9 308 */
mluis 0:91d1a7783bb9 309 void ( *MacEvent )( LoRaMacEventFlags_t *flags, LoRaMacEventInfo_t *info );
mluis 0:91d1a7783bb9 310 }LoRaMacEvent_t;
mluis 0:91d1a7783bb9 311
mluis 0:91d1a7783bb9 312 /*!
mluis 0:91d1a7783bb9 313 * LoRaMAC layer initialization
mluis 0:91d1a7783bb9 314 *
mluis 0:91d1a7783bb9 315 * \param [IN] events Pointer to a structure defining the LoRaMAC
mluis 0:91d1a7783bb9 316 * callback functions.
mluis 0:91d1a7783bb9 317 * \param [IN] getBatteryLevel Function callback to get the current
mluis 0:91d1a7783bb9 318 * battery level
mluis 0:91d1a7783bb9 319 */
mluis 0:91d1a7783bb9 320 void LoRaMacInit( LoRaMacEvent_t *events, uint8_t ( *getBatteryLevel )( ) );
mluis 0:91d1a7783bb9 321
mluis 0:91d1a7783bb9 322 /*!
mluis 0:91d1a7783bb9 323 * Enables/Disables the ADR (Adaptive Data Rate)
mluis 0:91d1a7783bb9 324 *
mluis 0:91d1a7783bb9 325 * \param [IN] enable [true: ADR ON, false: ADR OFF]
mluis 0:91d1a7783bb9 326 */
mluis 0:91d1a7783bb9 327 void LoRaMacSetAdrOn( bool enable );
mluis 0:91d1a7783bb9 328
mluis 0:91d1a7783bb9 329 /*!
mluis 0:91d1a7783bb9 330 * Initializes the network IDs. Device address,
mluis 0:91d1a7783bb9 331 * network session AES128 key and application session AES128 key.
mluis 0:91d1a7783bb9 332 *
mluis 0:91d1a7783bb9 333 * \remark To be only used when Over-the-Air activation isn't used.
mluis 0:91d1a7783bb9 334 *
mluis 0:91d1a7783bb9 335 * \param [IN] netID 24 bits network identifier
mluis 0:91d1a7783bb9 336 * ( provided by network operator )
mluis 0:91d1a7783bb9 337 * \param [IN] devAddr 32 bits device address on the network
mluis 0:91d1a7783bb9 338 * (must be unique to the network)
mluis 0:91d1a7783bb9 339 * \param [IN] nwkSKey Pointer to the network session AES128 key array
mluis 0:91d1a7783bb9 340 * ( 16 bytes )
mluis 0:91d1a7783bb9 341 * \param [IN] appSKey Pointer to the application session AES128 key array
mluis 0:91d1a7783bb9 342 * ( 16 bytes )
mluis 0:91d1a7783bb9 343 */
mluis 0:91d1a7783bb9 344 void LoRaMacInitNwkIds( uint32_t netID, uint32_t devAddr, uint8_t *nwkSKey, uint8_t *appSKey );
mluis 0:91d1a7783bb9 345
mluis 0:91d1a7783bb9 346 /*
mluis 0:91d1a7783bb9 347 * TODO: Add documentation
mluis 0:91d1a7783bb9 348 */
mluis 0:91d1a7783bb9 349 void LoRaMacMulticastChannelAdd( MulticastParams_t *channelParam );
mluis 0:91d1a7783bb9 350
mluis 0:91d1a7783bb9 351 /*
mluis 0:91d1a7783bb9 352 * TODO: Add documentation
mluis 0:91d1a7783bb9 353 */
mluis 0:91d1a7783bb9 354 void LoRaMacMulticastChannelRemove( MulticastParams_t *channelParam );
mluis 0:91d1a7783bb9 355
mluis 0:91d1a7783bb9 356 /*!
mluis 0:91d1a7783bb9 357 * Initiates the Over-the-Air activation
mluis 0:91d1a7783bb9 358 *
mluis 0:91d1a7783bb9 359 * \param [IN] devEui Pointer to the device EUI array ( 8 bytes )
mluis 0:91d1a7783bb9 360 * \param [IN] appEui Pointer to the application EUI array ( 8 bytes )
mluis 0:91d1a7783bb9 361 * \param [IN] appKey Pointer to the application AES128 key array ( 16 bytes )
mluis 0:91d1a7783bb9 362 *
mluis 0:91d1a7783bb9 363 * \retval status [0: OK, 1: Tx error, 2: Already joined a network]
mluis 0:91d1a7783bb9 364 */
mluis 0:91d1a7783bb9 365 uint8_t LoRaMacJoinReq( uint8_t *devEui, uint8_t *appEui, uint8_t *appKey );
mluis 0:91d1a7783bb9 366
mluis 0:91d1a7783bb9 367 /*!
mluis 0:91d1a7783bb9 368 * Sends a LinkCheckReq MAC command on the next uplink frame
mluis 0:91d1a7783bb9 369 *
mluis 0:91d1a7783bb9 370 * \retval status Function status [0: OK, 1: Busy]
mluis 0:91d1a7783bb9 371 */
mluis 0:91d1a7783bb9 372 uint8_t LoRaMacLinkCheckReq( void );
mluis 0:91d1a7783bb9 373
mluis 0:91d1a7783bb9 374 /*!
mluis 0:91d1a7783bb9 375 * LoRaMAC layer send frame
mluis 0:91d1a7783bb9 376 *
mluis 0:91d1a7783bb9 377 * \param [IN] fPort MAC payload port (must be > 0)
mluis 0:91d1a7783bb9 378 * \param [IN] fBuffer MAC data buffer to be sent
mluis 0:91d1a7783bb9 379 * \param [IN] fBufferSize MAC data buffer size
mluis 0:91d1a7783bb9 380 *
mluis 0:91d1a7783bb9 381 * \retval status [0: OK, 1: Busy, 2: No network joined,
mluis 0:91d1a7783bb9 382 * 3: Length or port error, 4: Unknown MAC command
mluis 0:91d1a7783bb9 383 * 5: Unable to find a free channel
mluis 0:91d1a7783bb9 384 * 6: Device switched off]
mluis 0:91d1a7783bb9 385 */
mluis 0:91d1a7783bb9 386 uint8_t LoRaMacSendFrame( uint8_t fPort, void *fBuffer, uint16_t fBufferSize );
mluis 0:91d1a7783bb9 387
mluis 0:91d1a7783bb9 388 /*!
mluis 0:91d1a7783bb9 389 * LoRaMAC layer send frame
mluis 0:91d1a7783bb9 390 *
mluis 0:91d1a7783bb9 391 * \param [IN] fPort MAC payload port (must be > 0)
mluis 0:91d1a7783bb9 392 * \param [IN] fBuffer MAC data buffer to be sent
mluis 0:91d1a7783bb9 393 * \param [IN] fBufferSize MAC data buffer size
mluis 0:91d1a7783bb9 394 * \param [IN] fBufferSize MAC data buffer size
mluis 0:91d1a7783bb9 395 * \param [IN] nbRetries Number of retries to receive the acknowledgement
mluis 0:91d1a7783bb9 396 *
mluis 0:91d1a7783bb9 397 * \retval status [0: OK, 1: Busy, 2: No network joined,
mluis 0:91d1a7783bb9 398 * 3: Length or port error, 4: Unknown MAC command
mluis 0:91d1a7783bb9 399 * 5: Unable to find a free channel
mluis 0:91d1a7783bb9 400 * 6: Device switched off]
mluis 0:91d1a7783bb9 401 */
mluis 0:91d1a7783bb9 402 uint8_t LoRaMacSendConfirmedFrame( uint8_t fPort, void *fBuffer, uint16_t fBufferSize, uint8_t nbRetries );
mluis 0:91d1a7783bb9 403
mluis 0:91d1a7783bb9 404 /*!
mluis 0:91d1a7783bb9 405 * ============================================================================
mluis 0:91d1a7783bb9 406 * = LoRaMac test functions =
mluis 0:91d1a7783bb9 407 * ============================================================================
mluis 0:91d1a7783bb9 408 */
mluis 0:91d1a7783bb9 409
mluis 0:91d1a7783bb9 410 /*!
mluis 0:91d1a7783bb9 411 * LoRaMAC layer generic send frame
mluis 0:91d1a7783bb9 412 *
mluis 0:91d1a7783bb9 413 * \param [IN] macHdr MAC header field
mluis 0:91d1a7783bb9 414 * \param [IN] fOpts MAC commands buffer
mluis 0:91d1a7783bb9 415 * \param [IN] fPort MAC payload port
mluis 0:91d1a7783bb9 416 * \param [IN] fBuffer MAC data buffer to be sent
mluis 0:91d1a7783bb9 417 * \param [IN] fBufferSize MAC data buffer size
mluis 0:91d1a7783bb9 418 * \retval status [0: OK, 1: Busy, 2: No network joined,
mluis 0:91d1a7783bb9 419 * 3: Length or port error, 4: Unknown MAC command
mluis 0:91d1a7783bb9 420 * 5: Unable to find a free channel
mluis 0:91d1a7783bb9 421 * 6: Device switched off]
mluis 0:91d1a7783bb9 422 */
mluis 0:91d1a7783bb9 423 uint8_t LoRaMacSend( LoRaMacHeader_t *macHdr, uint8_t *fOpts, uint8_t fPort, void *fBuffer, uint16_t fBufferSize );
mluis 0:91d1a7783bb9 424
mluis 0:91d1a7783bb9 425 /*!
mluis 0:91d1a7783bb9 426 * LoRaMAC layer frame buffer initialization.
mluis 0:91d1a7783bb9 427 *
mluis 0:91d1a7783bb9 428 * \param [IN] channel Channel parameters
mluis 0:91d1a7783bb9 429 * \param [IN] macHdr MAC header field
mluis 0:91d1a7783bb9 430 * \param [IN] fCtrl MAC frame control field
mluis 0:91d1a7783bb9 431 * \param [IN] fOpts MAC commands buffer
mluis 0:91d1a7783bb9 432 * \param [IN] fPort MAC payload port
mluis 0:91d1a7783bb9 433 * \param [IN] fBuffer MAC data buffer to be sent
mluis 0:91d1a7783bb9 434 * \param [IN] fBufferSize MAC data buffer size
mluis 0:91d1a7783bb9 435 * \retval status [0: OK, 1: N/A, 2: No network joined,
mluis 0:91d1a7783bb9 436 * 3: Length or port error, 4: Unknown MAC command]
mluis 0:91d1a7783bb9 437 */
mluis 0:91d1a7783bb9 438 uint8_t LoRaMacPrepareFrame( ChannelParams_t channel,LoRaMacHeader_t *macHdr, LoRaMacFrameCtrl_t *fCtrl, uint8_t *fOpts, uint8_t fPort, void *fBuffer, uint16_t fBufferSize );
mluis 0:91d1a7783bb9 439
mluis 0:91d1a7783bb9 440 /*!
mluis 0:91d1a7783bb9 441 * LoRaMAC layer prepared frame buffer transmission with channel specification
mluis 0:91d1a7783bb9 442 *
mluis 0:91d1a7783bb9 443 * \remark LoRaMacPrepareFrame must be called at least once before calling this
mluis 0:91d1a7783bb9 444 * function.
mluis 0:91d1a7783bb9 445 *
mluis 0:91d1a7783bb9 446 * \param [IN] channel Channel parameters
mluis 0:91d1a7783bb9 447 * \retval status [0: OK, 1: Busy]
mluis 0:91d1a7783bb9 448 */
mluis 0:91d1a7783bb9 449 uint8_t LoRaMacSendFrameOnChannel( ChannelParams_t channel );
mluis 0:91d1a7783bb9 450
mluis 0:91d1a7783bb9 451 /*!
mluis 0:91d1a7783bb9 452 * LoRaMAC layer generic send frame with channel specification
mluis 0:91d1a7783bb9 453 *
mluis 0:91d1a7783bb9 454 * \param [IN] channel Channel parameters
mluis 0:91d1a7783bb9 455 * \param [IN] macHdr MAC header field
mluis 0:91d1a7783bb9 456 * \param [IN] fCtrl MAC frame control field
mluis 0:91d1a7783bb9 457 * \param [IN] fOpts MAC commands buffer
mluis 0:91d1a7783bb9 458 * \param [IN] fPort MAC payload port
mluis 0:91d1a7783bb9 459 * \param [IN] fBuffer MAC data buffer to be sent
mluis 0:91d1a7783bb9 460 * \param [IN] fBufferSize MAC data buffer size
mluis 0:91d1a7783bb9 461 * \retval status [0: OK, 1: Busy, 2: No network joined,
mluis 0:91d1a7783bb9 462 * 3: Length or port error, 4: Unknown MAC command]
mluis 0:91d1a7783bb9 463 */
mluis 0:91d1a7783bb9 464 uint8_t LoRaMacSendOnChannel( ChannelParams_t channel, LoRaMacHeader_t *macHdr, LoRaMacFrameCtrl_t *fCtrl, uint8_t *fOpts, uint8_t fPort, void *fBuffer, uint16_t fBufferSize );
mluis 0:91d1a7783bb9 465
mluis 0:91d1a7783bb9 466 /*!
mluis 0:91d1a7783bb9 467 * ============================================================================
mluis 0:91d1a7783bb9 468 * = LoRaMac setup functions =
mluis 0:91d1a7783bb9 469 * ============================================================================
mluis 0:91d1a7783bb9 470 */
mluis 0:91d1a7783bb9 471
mluis 0:91d1a7783bb9 472 /*
mluis 0:91d1a7783bb9 473 * TODO: Add documentation
mluis 0:91d1a7783bb9 474 */
mluis 0:91d1a7783bb9 475 void LoRaMacSetDeviceClass( DeviceClass_t deviceClass );
mluis 0:91d1a7783bb9 476
mluis 0:91d1a7783bb9 477 /*
mluis 0:91d1a7783bb9 478 * TODO: Add documentation
mluis 0:91d1a7783bb9 479 */
mluis 0:91d1a7783bb9 480 void LoRaMacSetPublicNetwork( bool enable );
mluis 0:91d1a7783bb9 481
mluis 0:91d1a7783bb9 482 /*
mluis 0:91d1a7783bb9 483 * TODO: Add documentation
mluis 0:91d1a7783bb9 484 */
mluis 0:91d1a7783bb9 485 void LoRaMacSetChannel( uint8_t id, ChannelParams_t params );
mluis 0:91d1a7783bb9 486
mluis 0:91d1a7783bb9 487 /*
mluis 0:91d1a7783bb9 488 * TODO: Add documentation
mluis 0:91d1a7783bb9 489 */
mluis 0:91d1a7783bb9 490 void LoRaMacSetRx2Channel( Rx2ChannelParams_t param );
mluis 0:91d1a7783bb9 491
mluis 0:91d1a7783bb9 492 /*!
mluis 0:91d1a7783bb9 493 * Sets channels tx output power
mluis 0:91d1a7783bb9 494 *
mluis 0:91d1a7783bb9 495 * \param [IN] txPower [TX_POWER_20_DBM, TX_POWER_14_DBM,
mluis 0:91d1a7783bb9 496 TX_POWER_11_DBM, TX_POWER_08_DBM,
mluis 0:91d1a7783bb9 497 TX_POWER_05_DBM, TX_POWER_02_DBM]
mluis 0:91d1a7783bb9 498 */
mluis 0:91d1a7783bb9 499 void LoRaMacSetChannelsTxPower( int8_t txPower );
mluis 0:91d1a7783bb9 500
mluis 0:91d1a7783bb9 501 /*!
mluis 0:91d1a7783bb9 502 * Sets channels datarate
mluis 0:91d1a7783bb9 503 *
mluis 0:91d1a7783bb9 504 * \param [IN] datarate eu868 - [DR_0, DR_1, DR_2, DR_3, DR_4, DR_5, DR_6, DR_7]
mluis 0:91d1a7783bb9 505 * us915 - [DR_0, DR_1, DR_2, DR_3, DR_4]
mluis 0:91d1a7783bb9 506 */
mluis 0:91d1a7783bb9 507 void LoRaMacSetChannelsDatarate( int8_t datarate );
mluis 0:91d1a7783bb9 508
mluis 0:91d1a7783bb9 509 /*
mluis 0:91d1a7783bb9 510 * TODO: Add documentation
mluis 0:91d1a7783bb9 511 */
mluis 0:91d1a7783bb9 512 void LoRaMacSetChannelsMask( uint16_t *mask );
mluis 0:91d1a7783bb9 513
mluis 0:91d1a7783bb9 514 /*
mluis 0:91d1a7783bb9 515 * TODO: Add documentation
mluis 0:91d1a7783bb9 516 */
mluis 0:91d1a7783bb9 517 void LoRaMacSetChannelsNbRep( uint8_t nbRep );
mluis 0:91d1a7783bb9 518
mluis 0:91d1a7783bb9 519 /*
mluis 0:91d1a7783bb9 520 * TODO: Add documentation
mluis 0:91d1a7783bb9 521 */
mluis 0:91d1a7783bb9 522 void LoRaMacSetMaxRxWindow( uint32_t delay );
mluis 0:91d1a7783bb9 523
mluis 0:91d1a7783bb9 524 /*
mluis 0:91d1a7783bb9 525 * TODO: Add documentation
mluis 0:91d1a7783bb9 526 */
mluis 0:91d1a7783bb9 527 void LoRaMacSetReceiveDelay1( uint32_t delay );
mluis 0:91d1a7783bb9 528
mluis 0:91d1a7783bb9 529 /*
mluis 0:91d1a7783bb9 530 * TODO: Add documentation
mluis 0:91d1a7783bb9 531 */
mluis 0:91d1a7783bb9 532 void LoRaMacSetReceiveDelay2( uint32_t delay );
mluis 0:91d1a7783bb9 533
mluis 0:91d1a7783bb9 534 /*
mluis 0:91d1a7783bb9 535 * TODO: Add documentation
mluis 0:91d1a7783bb9 536 */
mluis 0:91d1a7783bb9 537 void LoRaMacSetJoinAcceptDelay1( uint32_t delay );
mluis 0:91d1a7783bb9 538
mluis 0:91d1a7783bb9 539 /*
mluis 0:91d1a7783bb9 540 * TODO: Add documentation
mluis 0:91d1a7783bb9 541 */
mluis 0:91d1a7783bb9 542 void LoRaMacSetJoinAcceptDelay2( uint32_t delay );
mluis 0:91d1a7783bb9 543
mluis 0:91d1a7783bb9 544 /*
mluis 0:91d1a7783bb9 545 * TODO: Add documentation
mluis 0:91d1a7783bb9 546 */
mluis 0:91d1a7783bb9 547 uint32_t LoRaMacGetUpLinkCounter( void );
mluis 0:91d1a7783bb9 548
mluis 0:91d1a7783bb9 549 /*
mluis 0:91d1a7783bb9 550 * TODO: Add documentation
mluis 0:91d1a7783bb9 551 */
mluis 0:91d1a7783bb9 552 uint32_t LoRaMacGetDownLinkCounter( void );
mluis 0:91d1a7783bb9 553
mluis 0:91d1a7783bb9 554 /*
mluis 0:91d1a7783bb9 555 * ============================================================================
mluis 0:91d1a7783bb9 556 * = LoRaMac test functions =
mluis 0:91d1a7783bb9 557 * ============================================================================
mluis 0:91d1a7783bb9 558 */
mluis 0:91d1a7783bb9 559
mluis 0:91d1a7783bb9 560 /*!
mluis 0:91d1a7783bb9 561 * Disables/Enables the duty cycle enforcement (EU868)
mluis 0:91d1a7783bb9 562 *
mluis 0:91d1a7783bb9 563 * \param [IN] enable - Enabled or disables the duty cycle
mluis 0:91d1a7783bb9 564 */
mluis 0:91d1a7783bb9 565 void LoRaMacTestSetDutyCycleOn( bool enable );
mluis 0:91d1a7783bb9 566
mluis 0:91d1a7783bb9 567 /*!
mluis 0:91d1a7783bb9 568 * Disables/Enables the reception windows opening
mluis 0:91d1a7783bb9 569 *
mluis 0:91d1a7783bb9 570 * \param [IN] enable [true: enable, false: disable]
mluis 0:91d1a7783bb9 571 */
mluis 0:91d1a7783bb9 572 void LoRaMacTestRxWindowsOn( bool enable );
mluis 0:91d1a7783bb9 573
mluis 0:91d1a7783bb9 574 /*!
mluis 0:91d1a7783bb9 575 * Enables the MIC field test
mluis 0:91d1a7783bb9 576 *
mluis 0:91d1a7783bb9 577 * \param [IN] upLinkCounter Fixed Tx packet counter value
mluis 0:91d1a7783bb9 578 */
mluis 0:91d1a7783bb9 579 void LoRaMacTestSetMic( uint16_t upLinkCounter );
mluis 0:91d1a7783bb9 580
mluis 0:91d1a7783bb9 581 #endif // __LORAMAC_H__