SafeDetect / serial_to_lora

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

plans/ChannelPlan_AS923.h@16:4a382fe8f51b, 2019-04-23 (annotated)

Committer:
Jenkins@KEILDM1.dc.multitech.prv
Date:
Tue Apr 23 08:51:44 2019 -0500
Revision:
16:4a382fe8f51b
Parent:
14:f0c24ce93427
Child:
18:d7332302f5f1
mdot-library revision 3.2.0 and mbed-os revision mbed-os-5.11.1

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 1 /**********************************************************************
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 2 * COPYRIGHT 2015 MULTI-TECH SYSTEMS, INC.
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 3 *
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 4 * Redistribution and use in source and binary forms, with or without modification,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 5 * are permitted provided that the following conditions are met:
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 6 * 1. Redistributions of source code must retain the above copyright notice,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 7 * this list of conditions and the following disclaimer.
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 8 * 2. Redistributions in binary form must reproduce the above copyright notice,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 9 * this list of conditions and the following disclaimer in the documentation
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 10 * and/or other materials provided with the distribution.
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 11 * 3. Neither the name of MULTI-TECH SYSTEMS, INC. nor the names of its contributors
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 12 * may be used to endorse or promote products derived from this software
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 13 * without specific prior written permission.
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 14 *
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 16 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 18 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 21 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 22 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 23 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 24 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 25 *
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 26 ******************************************************************************
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 27 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 28 * @author Jason Reiss
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 29 * @date 10-31-2015
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 30 * @brief lora::ChannelPlan provides an interface for LoRaWAN channel schemes
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 31 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 32 * @details
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 33 *
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 34 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 35
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 36 #ifndef __CHANNEL_PLAN_AS923_H__
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 37 #define __CHANNEL_PLAN_AS923_H__
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 38
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 39 #include "Lora.h"
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 40 #include "SxRadio.h"
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 41 #include <vector>
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 42 #include "ChannelPlan.h"
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 43
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 44 namespace lora {
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 45
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 46 const uint8_t AS923_125K_NUM_CHANS = 16; //!< Number of 125k channels in AS923 channel plan
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 47 const uint8_t AS923_DEFAULT_NUM_CHANS = 2; //!< Number of default channels in AS923 channel plan
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 48 const uint32_t AS923_125K_FREQ_BASE = 923200000; //!< Frequency base for 125k AS923 uplink channels
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 49 const uint32_t AS923_125K_FREQ_STEP = 200000; //!< Frequency step for 125k AS923 uplink channels
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 50 const uint32_t AS923_RX2_FREQ = 923200000; //!< Frequency default for second rx window in AS923
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 51 const uint8_t AS923_BEACON_DR = DR_3; //!< Default beacon datarate
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 52 const uint32_t AS923_BEACON_FREQ = 923400000U; //!< Default beacon broadcast frequency
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 53
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 54 class ChannelPlan_AS923: public lora::ChannelPlan {
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 55 public:
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 56 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 57 * ChannelPlan constructor
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 58 * @param radio SxRadio object used to set Tx/Rx config
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 59 * @param settings Settings object
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 60 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 61 ChannelPlan_AS923();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 62 ChannelPlan_AS923(Settings* settings);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 63 ChannelPlan_AS923(SxRadio* radio, Settings* settings);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 64
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 65 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 66 * ChannelPlan destructor
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 67 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 68 virtual ~ChannelPlan_AS923();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 69
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 70 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 71 * Initialize channels, datarates and duty cycle bands according to current channel plan in settings
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 72 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 73 virtual void Init();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 74
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 75 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 76 * Get the next channel to use to transmit
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 77 * @return LORA_OK if channel was found
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 78 * @return LORA_NO_CHANS_ENABLED
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 79 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 80 virtual uint8_t GetNextChannel();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 81
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 82 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 83 * Add a channel to the ChannelPlan
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 84 * @param index of channel, use -1 to add to end
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 85 * @param channel settings to add
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 86 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 87 virtual uint8_t AddChannel(int8_t index, Channel channel);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 88
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 89 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 90 * Get channel at index
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 91 * @return Channel
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 92 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 93 virtual Channel GetChannel(int8_t index);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 94
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 95 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 96 * Get rx window settings for requested window
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 97 * RX_1, RX_2, RX_BEACON, RX_SLOT
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 98 * @param window
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 99 * @return RxWindow
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 100 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 101 virtual RxWindow GetRxWindow(uint8_t window);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 102
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 103 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 104 * Get datarate to use on the join request
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 105 * @return datarate index
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 106 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 107 virtual uint8_t GetJoinDatarate();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 108
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 109 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 110 * Calculate the next time a join request is possible
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 111 * @param size of join frame
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 112 * @returns LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 113 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 114 virtual uint8_t CalculateJoinBackoff(uint8_t size);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 115
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 116 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 117 * Get next channel and set the SxRadio tx config with current settings
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 118 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 119 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 120 virtual uint8_t SetTxConfig();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 121
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 122 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 123 * Set the SxRadio rx config provided window
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 124 * @param window to be opened
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 125 * @param continuous keep window open
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 126 * @param wnd_growth factor to increase the rx window by
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 127 * @param pad_ms time in milliseconds to add to computed window size
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 128 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 129 */
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 130 virtual uint8_t SetRxConfig(uint8_t window,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 131 bool continuous,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 132 uint16_t wnd_growth,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 133 uint16_t pad_ms);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 134
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 135 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 136 * Set frequency sub band if supported by plan
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 137 * @param sub_band
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 138 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 139 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 140 virtual uint8_t SetFrequencySubBand(uint8_t sub_band);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 141
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 142 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 143 * Callback for ACK timeout event
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 144 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 145 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 146 virtual uint8_t HandleAckTimeout();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 147
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 148 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 149 * Callback for Join Accept packet to load optional channels
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 150 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 151 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 152 virtual uint8_t HandleJoinAccept(const uint8_t* buffer, uint8_t size);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 153
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 154 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 155 * Callback to for rx parameter setup ServerCommand
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 156 * @param payload packet data
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 157 * @param index of start of command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 158 * @param size number of bytes in command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 159 * @param[out] status to be returned in MoteCommand answer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 160 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 161 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 162 virtual uint8_t HandleRxParamSetup(const uint8_t* payload, uint8_t index, uint8_t size, uint8_t& status);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 163
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 164 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 165 * Callback to for new channel ServerCommand
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 166 * @param payload packet data
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 167 * @param index of start of command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 168 * @param size number of bytes in command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 169 * @param[out] status to be returned in MoteCommand answer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 170 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 171 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 172 virtual uint8_t HandleNewChannel(const uint8_t* payload, uint8_t index, uint8_t size, uint8_t& status);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 173
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 174 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 175 * Callback to for ping slot channel request ServerCommand
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 176 * @param payload packet data
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 177 * @param index of start of command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 178 * @param size number of bytes in command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 179 * @param[out] status to be returned in MoteCommand answer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 180 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 181 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 182 virtual uint8_t HandlePingSlotChannelReq(const uint8_t* payload, uint8_t index, uint8_t size, uint8_t& status);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 183
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 184 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 185 * Callback to for beacon frequency request ServerCommand
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 186 * @param payload packet data
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 187 * @param index of start of command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 188 * @param size number of bytes in command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 189 * @param[out] status to be returned in MoteCommand answer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 190 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 191 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 192 virtual uint8_t HandleBeaconFrequencyReq(const uint8_t* payload, uint8_t index, uint8_t size, uint8_t& status);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 193
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 194 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 195 * Callback to for adaptive datarate ServerCommand
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 196 * @param payload packet data
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 197 * @param index of start of command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 198 * @param size number of bytes in command buffer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 199 * @param[out] status to be returned in MoteCommand answer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 200 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 201 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 202 virtual uint8_t HandleAdrCommand(const uint8_t* payload, uint8_t index, uint8_t size, uint8_t& status);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 203
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 204 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 205 * Validate the configuration after multiple ADR commands have been applied
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 206 * @return status to be returned in MoteCommand answer
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 207 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 208 virtual uint8_t ValidateAdrConfiguration();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 209
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 210 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 211 * Update duty cycle with at given frequency and time on air
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 212 * @param freq frequency
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 213 * @param time_on_air_ms tx time on air
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 214 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 215 virtual void UpdateDutyCycle(uint32_t freq, uint32_t time_on_air_ms);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 216
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 217 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 218 * Get the time the radio must be off air to comply with regulations
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 219 * Time to wait may be dependent on duty-cycle restrictions per channel
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 220 * Or duty-cycle of join requests if OTAA is being attempted
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 221 * @return ms of time to wait for next tx opportunity
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 222 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 223 virtual uint32_t GetTimeOffAir();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 224
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 225 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 226 * Get the channels in use by current channel plan
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 227 * @return channel frequencies
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 228 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 229 virtual std::vector<uint32_t> GetChannels();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 230
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 231 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 232 * Get the channel datarate ranges in use by current channel plan
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 233 * @return channel datarate ranges
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 234 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 235 virtual std::vector<uint8_t> GetChannelRanges();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 236
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 237 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 238 * Print log message for given rx window
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 239 * @param wnd 1 or 2
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 240 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 241 virtual void LogRxWindow(uint8_t wnd);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 242
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 243 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 244 * Enable the default channels of the channel plan
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 245 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 246 virtual void EnableDefaultChannels();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 247
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 248 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 249 * Called when MAC layer doesn't know about a command.
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 250 * Use to add custom or new mac command handling
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 251 * @return LORA_OK
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 252 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 253 virtual uint8_t HandleMacCommand(uint8_t* payload, uint8_t& index);
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 254
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 255 /**
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 256 * Get max payload size for current datarate
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 257 * @return size in bytes
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 258 */
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 259 virtual uint8_t GetMaxPayloadSize();
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 260
Jenkins@KEILDM1.dc.multitech.prv 14:f0c24ce93427 261 /**
Jenkins@KEILDM1.dc.multitech.prv 14:f0c24ce93427 262 * Decrements the datarate based on TxDwellTime
Jenkins@KEILDM1.dc.multitech.prv 14:f0c24ce93427 263 */
Jenkins@KEILDM1.dc.multitech.prv 14:f0c24ce93427 264 virtual void DecrementDatarate();
Jenkins@KEILDM1.dc.multitech.prv 14:f0c24ce93427 265
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 266 /**
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 267 * Check if this packet is a beacon and if so extract parameters needed
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 268 * @param payload of potential beacon
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 269 * @param size of the packet
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 270 * @param [out] data extracted from the beacon if this packet was indeed a beacon
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 271 * @return true if this packet is beacon, false if not
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 272 */
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 273 virtual bool DecodeBeacon(const uint8_t* payload,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 274 size_t size,
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 275 BeaconData_t& data);
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 276
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 277
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 278 virtual uint8_t GetMinDatarate();
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 279
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 280 protected:
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 281
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 282 static const uint8_t AS923_TX_POWERS[8]; //!< List of available tx powers
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 283 static const uint8_t AS923_RADIO_POWERS[21]; //!< List of calibrated tx powers
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 284 static const uint8_t AS923_MAX_PAYLOAD_SIZE[]; //!< List of max payload sizes for each datarate
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 285 static const uint8_t AS923_MAX_PAYLOAD_SIZE_400[]; //!< List of max payload sizes for each datarate
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 286 static const uint8_t AS923_MAX_PAYLOAD_SIZE_REPEATER[]; //!< List of repeater compatible max payload sizes for each datarate
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 287 static const uint8_t AS923_MAX_PAYLOAD_SIZE_REPEATER_400[]; //!< List of repeater compatible max payload sizes for each datarate
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 288 static const uint8_t MAX_ERP_VALUES[]; //!< Lookup table for Max EIRP (dBm) codes
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 289 typedef struct __attribute__((packed)) {
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 290 uint8_t RFU[2];
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 291 uint8_t Time[4];
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 292 uint8_t CRC1[2];
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 293 uint8_t GwSpecific[7];
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 294 uint8_t CRC2[2];
Jenkins@KEILDM1.dc.multitech.prv 16:4a382fe8f51b 295 } BCNPayload;
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 296 };
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 297 }
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 298
Jenkins@KEILDM1.dc.multitech.prv 11:be2a6466d680 299 #endif //__CHANNEL_PLAN_AS923_H__