the node firmware of ChiaYi Xingang
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?
User | Revision | Line number | New 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 |