MultiTech / libmDot-Custom

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.

Fork of libmDot-custom by Jason Reiss

Information

Library has been updated to mbed 5.x

The LoRaWAN Certification test mode implementation is built-in to libmDot code. When a start test mode packet is received the library will not return until test mode has ended.

Warning

This library is currently in BETA release. Unresolved issues may be experienced. Software is provided as is with no expectation of support of bug fixes in the future. Please report issues found through the mbed website or directly to support.multitech.com.

Changing of channel plan parameters may cause the device to no longer respect local RF regulations. Please use caution and respect your local regulations.

In AT Command Firmware remove line 803.

CommandTerminal/CommandTerminal.cpp

        delete[] info->RxBuffer;

Likewise, if your application is handling events from the library asynchronously.

Creating new channel plans

Copy EU868 or US915 custom channel plan as a starting point

Import programmDot_AT_firmware_CUSTOM

AT Firmware with custom channel plan support

Last commit 23 Mar 2017 by MultiTech

EU868 provides a framework for a DYNAMIC channel plan with duty-cycle limitations

US915 provides a framework for a FIXED channel plan

RADIO_POWERS are measured output in dBm for each radio tx power setting.

Additional MAC Commands can be implemented by overriding the HandleMacCommand function.

Steps

  1. Setup datarates, duty-cycle bands and channels in ChannelPlan_* constructor
  2. Modify GetJoinDatarate and CalculateJoinBackoff to change join datarates and backoff
  3. Customize HandleJoinAccept datarates
  4. Use GetRxWindow(int) to define how the device open Rx window 1 and 2
  5. GetNextChannel will pick a channel from the enabled channel at the current datarate before each TX

mDot.h@10:0b4eb17d07ae, 2015-09-10 (annotated)

Committer:
Mike Fiore
Date:
Thu Sep 10 13:19:35 2015 -0500
Revision:
10:0b4eb17d07ae
Parent:
7:683dba5d576f
Child:
11:9938ba31d428
update libmDot to version 0.0.9-1

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Mike Fiore 10:0b4eb17d07ae 1 // TODO: add license header
mfiore 0:c62615f15125 2
mfiore 0:c62615f15125 3 #ifndef MDOT_H
mfiore 0:c62615f15125 4 #define MDOT_H
mfiore 0:c62615f15125 5
mfiore 0:c62615f15125 6 #include "mbed.h"
mfiore 0:c62615f15125 7 #include "rtos.h"
mfiore 0:c62615f15125 8 #include <vector>
mfiore 0:c62615f15125 9 #include <map>
mfiore 0:c62615f15125 10 #include <string>
mfiore 0:c62615f15125 11
mfiore 0:c62615f15125 12 class LoRaMacEvent;
mfiore 0:c62615f15125 13 class LoRaConfig;
mfiore 0:c62615f15125 14 class LoRaMac;
mfiore 0:c62615f15125 15 class MdotRadio;
mfiore 0:c62615f15125 16
mfiore 0:c62615f15125 17 class mDot {
mfiore 0:c62615f15125 18
mfiore 0:c62615f15125 19 private:
mfiore 0:c62615f15125 20
mfiore 0:c62615f15125 21 mDot();
mfiore 0:c62615f15125 22 ~mDot();
mfiore 0:c62615f15125 23
mfiore 0:c62615f15125 24 static void idle(void const* args) {
mfiore 0:c62615f15125 25 while (1)
mfiore 0:c62615f15125 26 __WFI();
mfiore 0:c62615f15125 27 }
mfiore 0:c62615f15125 28
mfiore 0:c62615f15125 29 void setLastError(const std::string& str);
mfiore 0:c62615f15125 30
mfiore 0:c62615f15125 31 static bool validateBaudRate(const uint32_t& baud);
mfiore 0:c62615f15125 32 static bool validateFrequencySubBand(const uint8_t& band);
mfiore 0:c62615f15125 33 bool validateDataRate(const uint8_t& dr);
mfiore 0:c62615f15125 34
mfiore 0:c62615f15125 35 int32_t joinBase(const uint32_t& retries);
mfiore 0:c62615f15125 36 int32_t sendBase(const std::vector<uint8_t>& data, const bool& confirmed = false, const bool& blocking = true, const bool& highBw = false);
mfiore 0:c62615f15125 37 void waitForPacket();
mfiore 0:c62615f15125 38 void waitForLinkCheck();
mfiore 0:c62615f15125 39
mfiore 0:c62615f15125 40 void setActivityLedState(const uint8_t& state);
mfiore 0:c62615f15125 41 uint8_t getActivityLedState();
mfiore 0:c62615f15125 42
mfiore 0:c62615f15125 43 void blinkActivityLed(void) {
Mike Fiore 6:390fc83d588d 44 if (_activity_led) {
Mike Fiore 6:390fc83d588d 45 int val = _activity_led->read();
Mike Fiore 6:390fc83d588d 46 _activity_led->write(!val);
Mike Fiore 6:390fc83d588d 47 }
mfiore 0:c62615f15125 48 }
mfiore 0:c62615f15125 49
mfiore 0:c62615f15125 50 mDot(const mDot&);
mfiore 0:c62615f15125 51 mDot& operator=(const mDot&);
mfiore 0:c62615f15125 52
Mike Fiore 7:683dba5d576f 53 uint32_t RTC_ReadBackupRegister(uint32_t RTC_BKP_DR);
Mike Fiore 7:683dba5d576f 54 void RTC_WriteBackupRegister(uint32_t RTC_BKP_DR, uint32_t Data);
Mike Fiore 7:683dba5d576f 55
Mike Fiore 7:683dba5d576f 56 void wakeup();
Mike Fiore 7:683dba5d576f 57
mfiore 0:c62615f15125 58 static mDot* _instance;
mfiore 0:c62615f15125 59
mfiore 0:c62615f15125 60 LoRaMac* _mac;
mfiore 0:c62615f15125 61 MdotRadio* _radio;
mfiore 0:c62615f15125 62 LoRaMacEvent* _events;
mfiore 0:c62615f15125 63 LoRaConfig* _config;
mfiore 0:c62615f15125 64 Thread _idle_thread;
mfiore 0:c62615f15125 65 std::string _last_error;
mfiore 0:c62615f15125 66 static const uint32_t _baud_rates[];
mfiore 0:c62615f15125 67 uint8_t _activity_led_state;
mfiore 0:c62615f15125 68 Ticker _tick;
Mike Fiore 6:390fc83d588d 69 DigitalOut* _activity_led;
Mike Fiore 6:390fc83d588d 70 bool _activity_led_enable;
Mike Fiore 6:390fc83d588d 71 PinName _activity_led_pin;
Mike Fiore 5:0bfe6a650513 72 bool _activity_led_external;
Mike Fiore 10:0b4eb17d07ae 73 uint8_t _linkFailCount;
Mike Fiore 7:683dba5d576f 74 uint8_t _class;
Mike Fiore 7:683dba5d576f 75 InterruptIn* _wakeup;
Mike Fiore 7:683dba5d576f 76 PinName _wakeup_pin;
mfiore 0:c62615f15125 77
mfiore 0:c62615f15125 78 typedef enum {
mfiore 0:c62615f15125 79 OFF, ON, BLINK,
mfiore 0:c62615f15125 80 } state;
mfiore 0:c62615f15125 81
mfiore 0:c62615f15125 82 public:
mfiore 0:c62615f15125 83
mfiore 0:c62615f15125 84 typedef enum {
Mike Fiore 7:683dba5d576f 85 FM_APPEND = (1 << 0),
Mike Fiore 7:683dba5d576f 86 FM_TRUNC = (1 << 1),
Mike Fiore 7:683dba5d576f 87 FM_CREAT = (1 << 2),
Mike Fiore 7:683dba5d576f 88 FM_RDONLY = (1 << 3),
Mike Fiore 7:683dba5d576f 89 FM_WRONLY = (1 << 4),
Mike Fiore 7:683dba5d576f 90 FM_RDWR = (FM_RDONLY | FM_WRONLY),
Mike Fiore 7:683dba5d576f 91 FM_DIRECT = (1 << 5)
Mike Fiore 7:683dba5d576f 92 } FileMode;
Mike Fiore 7:683dba5d576f 93
Mike Fiore 7:683dba5d576f 94 typedef enum {
mfiore 0:c62615f15125 95 MDOT_OK = 0,
mfiore 0:c62615f15125 96 MDOT_INVALID_PARAM = -1,
mfiore 0:c62615f15125 97 MDOT_TX_ERROR = -2,
mfiore 0:c62615f15125 98 MDOT_RX_ERROR = -3,
mfiore 0:c62615f15125 99 MDOT_JOIN_ERROR = -4,
mfiore 0:c62615f15125 100 MDOT_TIMEOUT = -5,
mfiore 0:c62615f15125 101 MDOT_NOT_JOINED = -6,
mfiore 0:c62615f15125 102 MDOT_ENCRYPTION_DISABLED = -7,
mfiore 0:c62615f15125 103 MDOT_NO_FREE_CHAN = -8,
mfiore 0:c62615f15125 104 MDOT_ERROR = -1024,
mfiore 0:c62615f15125 105 } mdot_ret_code;
mfiore 0:c62615f15125 106
mfiore 0:c62615f15125 107 enum JoinMode {
mfiore 0:c62615f15125 108 MANUAL, OTA, AUTO_OTA
mfiore 0:c62615f15125 109 };
mfiore 0:c62615f15125 110
mfiore 0:c62615f15125 111 enum Mode {
mfiore 0:c62615f15125 112 COMMAND_MODE, SERIAL_MODE
mfiore 0:c62615f15125 113 };
mfiore 0:c62615f15125 114
mfiore 0:c62615f15125 115 enum RX_Output {
mfiore 0:c62615f15125 116 HEXADECIMAL, BINARY
mfiore 0:c62615f15125 117 };
mfiore 0:c62615f15125 118
mfiore 0:c62615f15125 119 enum DataRates {
mfiore 0:c62615f15125 120 SF_12, SF_11, SF_10, SF_9, SF_8, SF_7, SF_7H, SF_50
mfiore 0:c62615f15125 121 };
mfiore 0:c62615f15125 122
mfiore 0:c62615f15125 123 enum FrequencyBands {
mfiore 0:c62615f15125 124 FB_868, FB_915
mfiore 0:c62615f15125 125 };
mfiore 0:c62615f15125 126
mfiore 0:c62615f15125 127 enum FrequencySubBands {
mfiore 0:c62615f15125 128 FSB_ALL, FSB_1, FSB_2, FSB_3, FSB_4, FSB_5, FSB_6, FSB_7, FSB_8
mfiore 0:c62615f15125 129 };
mfiore 0:c62615f15125 130
Mike Fiore 6:390fc83d588d 131 enum JoinByteOrder {
Mike Fiore 6:390fc83d588d 132 LSB, MSB
Mike Fiore 6:390fc83d588d 133 };
Mike Fiore 6:390fc83d588d 134
Mike Fiore 7:683dba5d576f 135 enum wakeup_mode {
Mike Fiore 7:683dba5d576f 136 RTC_ALARM, INTERRUPT
Mike Fiore 7:683dba5d576f 137 };
Mike Fiore 7:683dba5d576f 138
Mike Fiore 7:683dba5d576f 139 typedef struct {
Mike Fiore 7:683dba5d576f 140 int16_t fd;
Mike Fiore 7:683dba5d576f 141 char name[30];
Mike Fiore 7:683dba5d576f 142 uint32_t size;
Mike Fiore 7:683dba5d576f 143 } mdot_file;
Mike Fiore 7:683dba5d576f 144
mfiore 0:c62615f15125 145 typedef struct {
mfiore 0:c62615f15125 146 uint32_t Up;
mfiore 0:c62615f15125 147 uint32_t Down;
mfiore 0:c62615f15125 148 uint32_t Joins;
mfiore 0:c62615f15125 149 uint32_t JoinFails;
mfiore 0:c62615f15125 150 uint32_t MissedAcks;
mfiore 0:c62615f15125 151 } mdot_stats;
mfiore 0:c62615f15125 152
mfiore 0:c62615f15125 153 typedef struct {
mfiore 0:c62615f15125 154 int16_t last;
mfiore 0:c62615f15125 155 int16_t min;
mfiore 0:c62615f15125 156 int16_t max;
mfiore 0:c62615f15125 157 int16_t avg;
mfiore 0:c62615f15125 158 } rssi_stats;
mfiore 0:c62615f15125 159
mfiore 0:c62615f15125 160 typedef struct {
mfiore 0:c62615f15125 161 int8_t last;
mfiore 0:c62615f15125 162 int8_t min;
mfiore 0:c62615f15125 163 int8_t max;
mfiore 0:c62615f15125 164 int8_t avg;
mfiore 0:c62615f15125 165 } snr_stats;
mfiore 0:c62615f15125 166
mfiore 0:c62615f15125 167 typedef struct {
mfiore 0:c62615f15125 168 bool status;
mfiore 0:c62615f15125 169 int32_t dBm;
mfiore 0:c62615f15125 170 uint32_t gateways;
mfiore 0:c62615f15125 171 std::vector<uint8_t> payload;
mfiore 0:c62615f15125 172 } link_check;
mfiore 0:c62615f15125 173
mfiore 0:c62615f15125 174 typedef struct {
mfiore 0:c62615f15125 175 int32_t status;
mfiore 0:c62615f15125 176 int16_t rssi;
mfiore 0:c62615f15125 177 int16_t snr;
mfiore 0:c62615f15125 178 } ping_response;
mfiore 0:c62615f15125 179
mfiore 0:c62615f15125 180 static const uint8_t MaxLengths_915[];
mfiore 0:c62615f15125 181 static const uint8_t MaxLengths_868[];
mfiore 0:c62615f15125 182
mfiore 0:c62615f15125 183 static std::string JoinModeStr(uint8_t mode);
mfiore 0:c62615f15125 184 static std::string ModeStr(uint8_t mode);
mfiore 0:c62615f15125 185 static std::string RxOutputStr(uint8_t format);
mfiore 0:c62615f15125 186 static std::string DataRateStr(uint8_t rate);
mfiore 0:c62615f15125 187 static std::string FrequencyBandStr(uint8_t band);
mfiore 0:c62615f15125 188 static std::string FrequencySubBandStr(uint8_t band);
mfiore 0:c62615f15125 189
mfiore 0:c62615f15125 190 /** Get a handle to the singleton object
mfiore 0:c62615f15125 191 * @returns pointer to mDot object
mfiore 0:c62615f15125 192 */
mfiore 0:c62615f15125 193 static mDot* getInstance();
mfiore 0:c62615f15125 194
mfiore 0:c62615f15125 195 /** Get library version information
mfiore 0:c62615f15125 196 * @returns string containing library version information
mfiore 0:c62615f15125 197 */
mfiore 0:c62615f15125 198 std::string getId();
mfiore 0:c62615f15125 199
mfiore 0:c62615f15125 200 /** Perform a soft reset of the system
mfiore 0:c62615f15125 201 */
mfiore 0:c62615f15125 202 void resetCpu();
mfiore 0:c62615f15125 203
mfiore 0:c62615f15125 204 /** Reset config to factory default
mfiore 0:c62615f15125 205 */
mfiore 0:c62615f15125 206 void resetConfig();
mfiore 0:c62615f15125 207
mfiore 0:c62615f15125 208 /** Save config data to non volatile memory
mfiore 0:c62615f15125 209 * @returns true if success, false if failure
mfiore 0:c62615f15125 210 */
mfiore 0:c62615f15125 211 bool saveConfig();
mfiore 0:c62615f15125 212
mfiore 0:c62615f15125 213 /** Set the log level for the library
mfiore 0:c62615f15125 214 * options are:
mfiore 0:c62615f15125 215 * NONE_LEVEL - logging is off at this level
mfiore 0:c62615f15125 216 * FATAL_LEVEL - only critical errors will be reported
mfiore 0:c62615f15125 217 * ERROR_LEVEL
mfiore 0:c62615f15125 218 * WARNING_LEVEL
mfiore 0:c62615f15125 219 * INFO_LEVEL
mfiore 0:c62615f15125 220 * DEBUG_LEVEL
mfiore 0:c62615f15125 221 * TRACE_LEVEL - every detail will be reported
mfiore 0:c62615f15125 222 * @param level the level to log at
mfiore 0:c62615f15125 223 * @returns MDOT_OK if success
mfiore 0:c62615f15125 224 */
mfiore 0:c62615f15125 225 int32_t setLogLevel(const uint8_t& level);
mfiore 0:c62615f15125 226
mfiore 0:c62615f15125 227 /** Get the current log level for the library
mfiore 0:c62615f15125 228 * @returns current log level
mfiore 0:c62615f15125 229 */
Mike Fiore 6:390fc83d588d 230 uint8_t getLogLevel();
Mike Fiore 6:390fc83d588d 231
Mike Fiore 6:390fc83d588d 232 /** Enable or disable the activity LED.
Mike Fiore 6:390fc83d588d 233 * @param enable true to enable the LED, false to disable
Mike Fiore 6:390fc83d588d 234 */
Mike Fiore 6:390fc83d588d 235 void setActivityLedEnable(const bool& enable);
Mike Fiore 4:94969e981dcc 236
Mike Fiore 6:390fc83d588d 237 /** Find out if the activity LED is enabled
Mike Fiore 6:390fc83d588d 238 * @returns true if activity LED is enabled, false if disabled
Mike Fiore 6:390fc83d588d 239 */
Mike Fiore 6:390fc83d588d 240 bool getActivityLedEnable();
Mike Fiore 6:390fc83d588d 241
Mike Fiore 6:390fc83d588d 242 /** Use a different pin for the activity LED.
Mike Fiore 6:390fc83d588d 243 * The default is XBEE_RSSI.
Mike Fiore 6:390fc83d588d 244 * @param pin the new pin to use
Mike Fiore 6:390fc83d588d 245 */
Mike Fiore 6:390fc83d588d 246 void setActivityLedPin(const PinName& pin);
Mike Fiore 6:390fc83d588d 247
Mike Fiore 5:0bfe6a650513 248 /** Use an external DigitalOut object for the activity LED.
Mike Fiore 5:0bfe6a650513 249 * The pointer must stay valid!
Mike Fiore 5:0bfe6a650513 250 * @param pin the DigitalOut object to use
Mike Fiore 5:0bfe6a650513 251 */
Mike Fiore 5:0bfe6a650513 252 void setActivityLedPin(DigitalOut* pin);
Mike Fiore 6:390fc83d588d 253
Mike Fiore 6:390fc83d588d 254 /** Find out what pin the activity LED is on
Mike Fiore 6:390fc83d588d 255 * @returns the pin the activity LED is using
Mike Fiore 6:390fc83d588d 256 */
Mike Fiore 6:390fc83d588d 257 PinName getActivityLedPin();
mfiore 0:c62615f15125 258
mfiore 0:c62615f15125 259 /** Get list of channel frequencies currently in use
mfiore 0:c62615f15125 260 * @returns vector of channels currently in use
mfiore 0:c62615f15125 261 */
mfiore 0:c62615f15125 262 std::vector<uint32_t> getChannels();
mfiore 0:c62615f15125 263
mfiore 0:c62615f15125 264 /** Get frequency band
mfiore 0:c62615f15125 265 * @returns FB_915 if configured for United States, FB_868 if configured for Europe
mfiore 0:c62615f15125 266 */
mfiore 0:c62615f15125 267 uint8_t getFrequencyBand();
mfiore 0:c62615f15125 268
mfiore 0:c62615f15125 269 /** Set frequency sub band
mfiore 0:c62615f15125 270 * only applicable if frequency band is set for United States (FB_915)
mfiore 0:c62615f15125 271 * sub band 0 will allow the radio to use all 64 channels
mfiore 0:c62615f15125 272 * sub band 1 - 8 will allow the radio to use the 8 channels in that sub band
mfiore 0:c62615f15125 273 * for use with Conduit gateway and MTAC_LORA, use sub bands 1 - 8, not sub band 0
mfiore 0:c62615f15125 274 * @param band the sub band to use (0 - 8)
mfiore 0:c62615f15125 275 * @returns MDOT_OK if success
mfiore 0:c62615f15125 276 */
mfiore 0:c62615f15125 277 int32_t setFrequencySubBand(const uint8_t& band);
mfiore 0:c62615f15125 278
mfiore 0:c62615f15125 279 /** Get frequency sub band
mfiore 0:c62615f15125 280 * @returns frequency sub band currently in use
mfiore 0:c62615f15125 281 */
mfiore 0:c62615f15125 282 uint8_t getFrequencySubBand();
mfiore 0:c62615f15125 283
mfiore 0:c62615f15125 284 /** Enable/disable public network mode
mfiore 0:c62615f15125 285 * @param on should be true to enable public network mode
mfiore 0:c62615f15125 286 * @returns MDOT_OK if success
mfiore 0:c62615f15125 287 */
mfiore 0:c62615f15125 288 int32_t setPublicNetwork(const bool& on);
mfiore 0:c62615f15125 289
mfiore 0:c62615f15125 290 /** Get public network mode
mfiore 0:c62615f15125 291 * @returns true if public network mode is enabled
mfiore 0:c62615f15125 292 */
mfiore 0:c62615f15125 293 bool getPublicNetwork();
mfiore 0:c62615f15125 294
mfiore 0:c62615f15125 295 /** Get the device ID
mfiore 0:c62615f15125 296 * @returns vector containing the device ID (size 8)
mfiore 0:c62615f15125 297 */
mfiore 0:c62615f15125 298 std::vector<uint8_t> getDeviceId();
mfiore 0:c62615f15125 299
mfiore 0:c62615f15125 300 /** Set network address
mfiore 0:c62615f15125 301 * for use with MANUAL network join mode, will be assigned in OTA & AUTO_OTA modes
mfiore 0:c62615f15125 302 * @param addr a vector of 4 bytes
mfiore 0:c62615f15125 303 * @returns MDOT_OK if success
mfiore 0:c62615f15125 304 */
mfiore 0:c62615f15125 305 int32_t setNetworkAddress(const std::vector<uint8_t>& addr);
mfiore 0:c62615f15125 306
mfiore 0:c62615f15125 307 /** Get network address
mfiore 0:c62615f15125 308 * @returns vector containing network address (size 4)
mfiore 0:c62615f15125 309 */
mfiore 0:c62615f15125 310 std::vector<uint8_t> getNetworkAddress();
mfiore 0:c62615f15125 311
mfiore 0:c62615f15125 312 /** Set network session key
mfiore 0:c62615f15125 313 * for use with MANUAL network join mode, will be assigned in OTA & AUTO_OTA modes
mfiore 0:c62615f15125 314 * @param key a vector of 16 bytes
mfiore 0:c62615f15125 315 * @returns MDOT_OK if success
mfiore 0:c62615f15125 316 */
mfiore 0:c62615f15125 317 int32_t setNetworkSessionKey(const std::vector<uint8_t>& key);
mfiore 0:c62615f15125 318
mfiore 0:c62615f15125 319 /** Get network session key
mfiore 0:c62615f15125 320 * @returns vector containing network session key (size 16)
mfiore 0:c62615f15125 321 */
mfiore 0:c62615f15125 322 std::vector<uint8_t> getNetworkSessionKey();
mfiore 0:c62615f15125 323
mfiore 0:c62615f15125 324 /** Set data session key
mfiore 0:c62615f15125 325 * for use with MANUAL network join mode, will be assigned in OTA & AUTO_OTA modes
mfiore 0:c62615f15125 326 * @param key a vector of 16 bytes
mfiore 0:c62615f15125 327 * @returns MDOT_OK if success
mfiore 0:c62615f15125 328 */
mfiore 0:c62615f15125 329 int32_t setDataSessionKey(const std::vector<uint8_t>& key);
mfiore 0:c62615f15125 330
mfiore 0:c62615f15125 331 /** Get data session key
mfiore 0:c62615f15125 332 * @returns vector containing data session key (size 16)
mfiore 0:c62615f15125 333 */
mfiore 0:c62615f15125 334 std::vector<uint8_t> getDataSessionKey();
mfiore 0:c62615f15125 335
mfiore 0:c62615f15125 336 /** Set network name
mfiore 0:c62615f15125 337 * for use with OTA & AUTO_OTA network join modes
mfiore 0:c62615f15125 338 * generates network ID (crc64 of name) automatically
mfiore 0:c62615f15125 339 * @param name a string of of at least 8 bytes and no more than 128 bytes
mfiore 0:c62615f15125 340 * @return MDOT_OK if success
mfiore 0:c62615f15125 341 */
mfiore 0:c62615f15125 342 int32_t setNetworkName(const std::string& name);
mfiore 0:c62615f15125 343
mfiore 0:c62615f15125 344 /** Get network name
mfiore 0:c62615f15125 345 * @return string containing network name (size 8 to 128)
mfiore 0:c62615f15125 346 */
mfiore 0:c62615f15125 347 std::string getNetworkName();
mfiore 0:c62615f15125 348
mfiore 0:c62615f15125 349 /** Set network ID
mfiore 0:c62615f15125 350 * for use with OTA & AUTO_OTA network join modes
mfiore 0:c62615f15125 351 * setting network ID via this function sets network name to empty
mfiore 0:c62615f15125 352 * @param id a vector of 8 bytes
mfiore 0:c62615f15125 353 * @returns MDOT_OK if success
mfiore 0:c62615f15125 354 */
mfiore 0:c62615f15125 355 int32_t setNetworkId(const std::vector<uint8_t>& id);
mfiore 0:c62615f15125 356
mfiore 0:c62615f15125 357 /** Get network ID
mfiore 0:c62615f15125 358 * @returns vector containing network ID (size 8)
mfiore 0:c62615f15125 359 */
mfiore 0:c62615f15125 360 std::vector<uint8_t> getNetworkId();
mfiore 0:c62615f15125 361
mfiore 0:c62615f15125 362 /** Set network passphrase
mfiore 0:c62615f15125 363 * for use with OTA & AUTO_OTA network join modes
mfiore 0:c62615f15125 364 * generates network key (cmac of passphrase) automatically
mfiore 0:c62615f15125 365 * @param name a string of of at least 8 bytes and no more than 128 bytes
mfiore 0:c62615f15125 366 * @return MDOT_OK if success
mfiore 0:c62615f15125 367 */
mfiore 0:c62615f15125 368 int32_t setNetworkPassphrase(const std::string& passphrase);
mfiore 0:c62615f15125 369
mfiore 0:c62615f15125 370 /** Get network passphrase
mfiore 0:c62615f15125 371 * @return string containing network passphrase (size 8 to 128)
mfiore 0:c62615f15125 372 */
mfiore 0:c62615f15125 373 std::string getNetworkPassphrase();
mfiore 0:c62615f15125 374
mfiore 0:c62615f15125 375 /** Set network key
mfiore 0:c62615f15125 376 * for use with OTA & AUTO_OTA network join modes
mfiore 0:c62615f15125 377 * setting network key via this function sets network passphrase to empty
mfiore 0:c62615f15125 378 * @param id a vector of 16 bytes
mfiore 0:c62615f15125 379 * @returns MDOT_OK if success
mfiore 0:c62615f15125 380 */
mfiore 0:c62615f15125 381 int32_t setNetworkKey(const std::vector<uint8_t>& id);
mfiore 0:c62615f15125 382
mfiore 0:c62615f15125 383 /** Get network key
mfiore 0:c62615f15125 384 * @returns a vector containing network key (size 16)
mfiore 0:c62615f15125 385 */
mfiore 0:c62615f15125 386 std::vector<uint8_t> getNetworkKey();
mfiore 0:c62615f15125 387
Mike Fiore 6:390fc83d588d 388 /** Set join byte order
Mike Fiore 6:390fc83d588d 389 * @param order 0:LSB 1:MSB
Mike Fiore 6:390fc83d588d 390 */
Mike Fiore 6:390fc83d588d 391 uint32_t setJoinByteOrder(uint8_t order);
Mike Fiore 6:390fc83d588d 392
Mike Fiore 6:390fc83d588d 393 /** Get join byte order
Mike Fiore 6:390fc83d588d 394 * @returns byte order to use in joins 0:LSB 1:MSB
Mike Fiore 6:390fc83d588d 395 */
Mike Fiore 6:390fc83d588d 396 uint8_t getJoinByteOrder();
Mike Fiore 6:390fc83d588d 397
mfiore 0:c62615f15125 398 /** Attempt to join network
mfiore 0:c62615f15125 399 * retries according to configuration set by setJoinRetries()
mfiore 0:c62615f15125 400 * @returns MDOT_OK if success
mfiore 0:c62615f15125 401 */
mfiore 0:c62615f15125 402 int32_t joinNetwork();
mfiore 0:c62615f15125 403
mfiore 0:c62615f15125 404 /** Attempts to join network once
mfiore 0:c62615f15125 405 * @returns MDOT_OK if success
mfiore 0:c62615f15125 406 */
mfiore 0:c62615f15125 407 int32_t joinNetworkOnce();
mfiore 0:c62615f15125 408
mfiore 0:c62615f15125 409 /** Resets current network session, essentially disconnecting from the network
mfiore 0:c62615f15125 410 * has no effect for MANUAL network join mode
mfiore 0:c62615f15125 411 */
mfiore 0:c62615f15125 412 void resetNetworkSession();
mfiore 0:c62615f15125 413
mfiore 0:c62615f15125 414 /** Set number of times joining will retry before giving up
mfiore 0:c62615f15125 415 * @param retries must be between 0 - 255
mfiore 0:c62615f15125 416 * @returns MDOT_OK if success
mfiore 0:c62615f15125 417 */
mfiore 0:c62615f15125 418 int32_t setJoinRetries(const uint8_t& retries);
mfiore 0:c62615f15125 419
mfiore 0:c62615f15125 420 /** Set number of times joining will retry before giving up
mfiore 0:c62615f15125 421 * @returns join retries (0 - 255)
mfiore 0:c62615f15125 422 */
mfiore 0:c62615f15125 423 uint8_t getJoinRetries();
mfiore 0:c62615f15125 424
mfiore 0:c62615f15125 425 /** Set network join mode
mfiore 0:c62615f15125 426 * MANUAL: set network address and session keys manually
mfiore 0:c62615f15125 427 * OTA: User sets network name and passphrase, then attempts to join
mfiore 0:c62615f15125 428 * AUTO_OTA: same as OTA, but network sessions can be saved and restored
mfiore 0:c62615f15125 429 * @param mode MANUAL, OTA, or AUTO_OTA
mfiore 0:c62615f15125 430 * @returns MDOT_OK if success
mfiore 0:c62615f15125 431 */
mfiore 0:c62615f15125 432 int32_t setJoinMode(const uint8_t& mode);
mfiore 0:c62615f15125 433
mfiore 0:c62615f15125 434 /** Get network join mode
mfiore 0:c62615f15125 435 * @returns MANUAL, OTA, or AUTO_OTA
mfiore 0:c62615f15125 436 */
mfiore 0:c62615f15125 437 uint8_t getJoinMode();
mfiore 0:c62615f15125 438
mfiore 0:c62615f15125 439 /** Get network join status
mfiore 0:c62615f15125 440 * @returns true if currently joined to network
mfiore 0:c62615f15125 441 */
mfiore 0:c62615f15125 442 bool getNetworkJoinStatus();
mfiore 0:c62615f15125 443
mfiore 0:c62615f15125 444 /** Do a network link check
mfiore 0:c62615f15125 445 * application data may be returned in response to a network link check command
mfiore 0:c62615f15125 446 * @returns link_check structure containing success, dBm above noise floor, gateways in range, and packet payload
mfiore 0:c62615f15125 447 */
mfiore 0:c62615f15125 448 link_check networkLinkCheck();
mfiore 0:c62615f15125 449
mfiore 0:c62615f15125 450 /** Set network link check count to perform automatic link checks every count packets
mfiore 0:c62615f15125 451 * only applicable if ACKs are disabled
mfiore 0:c62615f15125 452 * @param count must be between 0 - 255
mfiore 0:c62615f15125 453 * @returns MDOT_OK if success
mfiore 0:c62615f15125 454 */
mfiore 0:c62615f15125 455 int32_t setLinkCheckCount(const uint8_t& count);
mfiore 0:c62615f15125 456
mfiore 0:c62615f15125 457 /** Get network link check count
mfiore 0:c62615f15125 458 * @returns count (0 - 255)
mfiore 0:c62615f15125 459 */
mfiore 0:c62615f15125 460 uint8_t getLinkCheckCount();
mfiore 0:c62615f15125 461
mfiore 0:c62615f15125 462 /** Set network link check threshold, number of link check failures or missed acks to tolerate
mfiore 0:c62615f15125 463 * before considering network connection lost
mfiore 0:c62615f15125 464 * @pararm count must be between 0 - 255
mfiore 0:c62615f15125 465 * @returns MDOT_OK if success
mfiore 0:c62615f15125 466 */
mfiore 0:c62615f15125 467 int32_t setLinkCheckThreshold(const uint8_t& count);
mfiore 0:c62615f15125 468
mfiore 0:c62615f15125 469 /** Get network link check threshold
mfiore 0:c62615f15125 470 * @returns threshold (0 - 255)
mfiore 0:c62615f15125 471 */
mfiore 0:c62615f15125 472 uint8_t getLinkCheckThreshold();
mfiore 0:c62615f15125 473
mfiore 0:c62615f15125 474 /** Get UpLinkCounter
mfiore 0:c62615f15125 475 * @returns number of packets sent to the gateway during this network session (sequence number)
mfiore 0:c62615f15125 476 */
mfiore 0:c62615f15125 477 uint32_t getUpLinkCounter();
mfiore 0:c62615f15125 478
mfiore 0:c62615f15125 479 /** Enable/disable AES encryption
mfiore 0:c62615f15125 480 * AES encryption must be enabled for use with Conduit gateway and MTAC_LORA card
mfiore 0:c62615f15125 481 * @param on true for AES encryption to be enabled
mfiore 0:c62615f15125 482 * @returns MDOT_OK if success
mfiore 0:c62615f15125 483 */
mfiore 0:c62615f15125 484 int32_t setAesEncryption(const bool& on);
mfiore 0:c62615f15125 485
mfiore 0:c62615f15125 486 /** Get AES encryption
mfiore 0:c62615f15125 487 * @returns true if AES encryption is enabled
mfiore 0:c62615f15125 488 */
mfiore 0:c62615f15125 489 bool getAesEncryption();
mfiore 0:c62615f15125 490
mfiore 0:c62615f15125 491 /** Get RSSI stats
mfiore 0:c62615f15125 492 * @returns rssi_stats struct containing last, min, max, and avg RSSI
mfiore 0:c62615f15125 493 */
mfiore 0:c62615f15125 494 rssi_stats getRssiStats();
mfiore 0:c62615f15125 495
mfiore 0:c62615f15125 496 /** Get SNR stats
mfiore 0:c62615f15125 497 * @returns snr_stats struct containing last, min, max, and avg SNR
mfiore 0:c62615f15125 498 */
mfiore 0:c62615f15125 499 snr_stats getSnrStats();
mfiore 0:c62615f15125 500
mfiore 0:c62615f15125 501 /** Get ms until next free channel
mfiore 0:c62615f15125 502 * only applicable for European models, US models return 0
mfiore 0:c62615f15125 503 * @returns time (ms) until a channel is free to use for transmitting
mfiore 0:c62615f15125 504 */
mfiore 0:c62615f15125 505 uint32_t getNextTxMs();
mfiore 0:c62615f15125 506
mfiore 0:c62615f15125 507 /** Get data pending
mfiore 0:c62615f15125 508 * only valid after sending data to the gateway
mfiore 0:c62615f15125 509 * @returns true if server has available packet(s)
mfiore 0:c62615f15125 510 */
mfiore 0:c62615f15125 511 bool getDataPending();
mfiore 0:c62615f15125 512
mfiore 0:c62615f15125 513 /** Get transmitting
mfiore 0:c62615f15125 514 * @returns true if currently transmitting
mfiore 0:c62615f15125 515 */
mfiore 0:c62615f15125 516 bool getIsTransmitting();
mfiore 0:c62615f15125 517
mfiore 0:c62615f15125 518 /** Set TX data rate
mfiore 0:c62615f15125 519 * data rates affect maximum payload size
mfiore 0:c62615f15125 520 * @param dr SF_7 - SF_12 for Europe, SF_7 - SF_10 for United States
mfiore 0:c62615f15125 521 * @returns MDOT_OK if success
mfiore 0:c62615f15125 522 */
mfiore 0:c62615f15125 523 int32_t setTxDataRate(const uint8_t& dr);
mfiore 0:c62615f15125 524
mfiore 0:c62615f15125 525 /** Get TX data rate
mfiore 0:c62615f15125 526 * @returns current TX data rate (SF_7 - SF_12)
mfiore 0:c62615f15125 527 */
mfiore 0:c62615f15125 528 uint8_t getTxDataRate();
mfiore 0:c62615f15125 529
mfiore 0:c62615f15125 530 /** Set TX power
mfiore 0:c62615f15125 531 * power affects maximum range
mfiore 0:c62615f15125 532 * @param power 2 dBm - 20 dBm
mfiore 0:c62615f15125 533 * @returns MDOT_OK if success
mfiore 0:c62615f15125 534 */
mfiore 0:c62615f15125 535 int32_t setTxPower(const uint32_t& power);
mfiore 0:c62615f15125 536
mfiore 0:c62615f15125 537 /** Get TX power
mfiore 0:c62615f15125 538 * @returns TX power (2 dBm - 20 dBm)
mfiore 0:c62615f15125 539 */
mfiore 0:c62615f15125 540 uint32_t getTxPower();
mfiore 0:c62615f15125 541
mfiore 0:c62615f15125 542 /** Enable/disable TX waiting for rx windows
mfiore 0:c62615f15125 543 * when enabled, send calls will block until a packet is received or RX timeout
mfiore 0:c62615f15125 544 * @param enable set to true if expecting responses to transmitted packets
mfiore 0:c62615f15125 545 * @returns MDOT_OK if success
mfiore 0:c62615f15125 546 */
mfiore 0:c62615f15125 547 int32_t setTxWait(const bool& enable);
mfiore 0:c62615f15125 548
mfiore 0:c62615f15125 549 /** Get TX wait
mfiore 0:c62615f15125 550 * @returns true if TX wait is enabled
mfiore 0:c62615f15125 551 */
mfiore 0:c62615f15125 552 bool getTxWait();
mfiore 0:c62615f15125 553
mfiore 0:c62615f15125 554 /** Get time on air
mfiore 0:c62615f15125 555 * @returns the amount of time (in ms) it would take to send bytes bytes based on current configuration
mfiore 0:c62615f15125 556 */
mfiore 0:c62615f15125 557 uint32_t getTimeOnAir(uint8_t bytes);
mfiore 0:c62615f15125 558
mfiore 0:c62615f15125 559 /** Get min frequency
mfiore 0:c62615f15125 560 * @returns minimum frequency based on current configuration
mfiore 0:c62615f15125 561 */
mfiore 0:c62615f15125 562 uint32_t getMinFrequency();
mfiore 0:c62615f15125 563
mfiore 0:c62615f15125 564 /** Get max frequency
mfiore 0:c62615f15125 565 * @returns maximum frequency based on current configuration
mfiore 0:c62615f15125 566 */
mfiore 0:c62615f15125 567 uint32_t getMaxFrequency();
mfiore 0:c62615f15125 568
mfiore 0:c62615f15125 569 /** Set forward error correction bytes
mfiore 0:c62615f15125 570 * @param bytes 1 - 4 bytes
mfiore 0:c62615f15125 571 * @returns MDOT_OK if success
mfiore 0:c62615f15125 572 */
mfiore 0:c62615f15125 573 int32_t setFec(const uint8_t& bytes);
mfiore 0:c62615f15125 574
mfiore 0:c62615f15125 575 /** Get forward error correction bytes
mfiore 0:c62615f15125 576 * @returns bytes (1 - 4)
mfiore 0:c62615f15125 577 */
mfiore 0:c62615f15125 578 uint8_t getFec();
mfiore 0:c62615f15125 579
mfiore 0:c62615f15125 580 /** Enable/disable CRC checking of packets
mfiore 0:c62615f15125 581 * CRC checking must be enabled for use with Conduit gateway and MTAC_LORA card
mfiore 0:c62615f15125 582 * @param on set to true to enable CRC checking
mfiore 0:c62615f15125 583 * @returns MDOT_OK if success
mfiore 0:c62615f15125 584 */
mfiore 0:c62615f15125 585 int32_t setCrc(const bool& on);
mfiore 0:c62615f15125 586
mfiore 0:c62615f15125 587 /** Get CRC checking
mfiore 0:c62615f15125 588 * @returns true if CRC checking is enabled
mfiore 0:c62615f15125 589 */
mfiore 0:c62615f15125 590 bool getCrc();
mfiore 0:c62615f15125 591
mfiore 0:c62615f15125 592 /** Set ack
mfiore 0:c62615f15125 593 * @param retries 0 to disable acks, otherwise 1 - 8
mfiore 0:c62615f15125 594 * @returns MDOT_OK if success
mfiore 0:c62615f15125 595 */
mfiore 0:c62615f15125 596 int32_t setAck(const uint8_t& retries);
mfiore 0:c62615f15125 597
mfiore 0:c62615f15125 598 /** Get ack
mfiore 0:c62615f15125 599 * @returns 0 if acks are disabled, otherwise retries (1 - 8)
mfiore 0:c62615f15125 600 */
mfiore 0:c62615f15125 601 uint8_t getAck();
mfiore 0:c62615f15125 602
mfiore 0:c62615f15125 603 /** Send data to the gateway
mfiore 0:c62615f15125 604 * validates data size (based on spreading factor)
mfiore 0:c62615f15125 605 * @param data a vector of up to 242 bytes (may be less based on spreading factor)
mfiore 0:c62615f15125 606 * @returns MDOT_OK if packet was sent successfully (ACKs disabled), or if an ACK was received (ACKs enabled)
mfiore 0:c62615f15125 607 */
mfiore 0:c62615f15125 608 int32_t send(const std::vector<uint8_t>& data, const bool& blocking = true, const bool& highBw = false);
mfiore 0:c62615f15125 609
mfiore 0:c62615f15125 610 /** Fetch data received from the gateway
mfiore 0:c62615f15125 611 * this function only checks to see if a packet has been received - it does not open a receive window
mfiore 0:c62615f15125 612 * send() must be called before recv()
mfiore 0:c62615f15125 613 * @param data a vector to put the received data into
mfiore 0:c62615f15125 614 * @returns MDOT_OK if packet was successfully received
mfiore 0:c62615f15125 615 */
mfiore 0:c62615f15125 616 int32_t recv(std::vector<uint8_t>& data);
mfiore 0:c62615f15125 617
Mike Fiore 6:390fc83d588d 618
mfiore 0:c62615f15125 619 /** Ping
mfiore 0:c62615f15125 620 * status will be MDOT_OK if ping succeeded
mfiore 0:c62615f15125 621 * @returns ping_response struct containing status, RSSI, and SNR
mfiore 0:c62615f15125 622 */
mfiore 0:c62615f15125 623 ping_response ping();
mfiore 0:c62615f15125 624
mfiore 0:c62615f15125 625 /** Get return code string
mfiore 0:c62615f15125 626 * @returns string containing a description of the given error code
mfiore 0:c62615f15125 627 */
mfiore 0:c62615f15125 628 static std::string getReturnCodeString(const int32_t& code);
mfiore 0:c62615f15125 629
mfiore 0:c62615f15125 630 /** Get last error
mfiore 0:c62615f15125 631 * @returns string explaining the last error that occured
mfiore 0:c62615f15125 632 */
mfiore 0:c62615f15125 633 std::string getLastError();
mfiore 0:c62615f15125 634
Mike Fiore 7:683dba5d576f 635 /** Go to sleep
Mike Fiore 7:683dba5d576f 636 * @param interval the number of seconds to sleep before waking up if wakeup_mode == RTC_ALARM, else ignored
Mike Fiore 7:683dba5d576f 637 * @param wakeup_mode RTC_ALARM, INTERRUPT
Mike Fiore 7:683dba5d576f 638 * if RTC_ALARM the real time clock is configured to wake the device up after the specified interval
Mike Fiore 7:683dba5d576f 639 * if INTERRUPT the device will wake up on the rising edge of the interrupt pin
Mike Fiore 7:683dba5d576f 640 * @param deepsleep if true go into deep sleep mode (lowest power, all memory and registers are lost, peripherals turned off)
Mike Fiore 7:683dba5d576f 641 * else go into sleep mode (low power, memory and registers are maintained, peripherals stay on)
Mike Fiore 7:683dba5d576f 642 *
Mike Fiore 7:683dba5d576f 643 * ** CURRENTLY ONLY DEEPSLEEP MODE IS AVAILABLE **
Mike Fiore 7:683dba5d576f 644 *
Mike Fiore 7:683dba5d576f 645 * in sleep mode, the device can be woken up on any of the XBEE pins or by the RTC alarm
Mike Fiore 7:683dba5d576f 646 * in deepsleep mode, the device can only be woken up using the WKUP pin (PA0, XBEE_DIO7) or by the RTC alarm
Mike Fiore 7:683dba5d576f 647 */
Mike Fiore 7:683dba5d576f 648 void sleep(const uint32_t& interval, const uint8_t& wakeup_mode = RTC_ALARM, const bool& deepsleep = true);
Mike Fiore 7:683dba5d576f 649
Mike Fiore 7:683dba5d576f 650 /** Set wake pin
Mike Fiore 7:683dba5d576f 651 * @param pin the pin to use to wake the device from sleep mode
Mike Fiore 7:683dba5d576f 652 */
Mike Fiore 7:683dba5d576f 653 void setWakePin(const PinName& pin);
Mike Fiore 7:683dba5d576f 654
Mike Fiore 7:683dba5d576f 655 /** Get wake pin
Mike Fiore 7:683dba5d576f 656 * @returns the pin to use to wake the device from sleep mode
Mike Fiore 7:683dba5d576f 657 */
Mike Fiore 7:683dba5d576f 658 PinName getWakePin();
Mike Fiore 7:683dba5d576f 659
mfiore 0:c62615f15125 660 /******************************************
mfiore 0:c62615f15125 661 * THESE FEATURES ARE NOT FULLY IMPLEMENTED
mfiore 0:c62615f15125 662 *****************************************/
mfiore 0:c62615f15125 663 // get/set adaptive data rate
mfiore 0:c62615f15125 664 // configure data rates and power levels based on signal to noise information from gateway
mfiore 0:c62615f15125 665 // true == adaptive data rate is on
mfiore 0:c62615f15125 666 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 667 int32_t setAdr(const bool& on);
mfiore 0:c62615f15125 668 bool getAdr();
mfiore 0:c62615f15125 669
mfiore 0:c62615f15125 670 /*************************************************************************
mfiore 0:c62615f15125 671 * The following functions are only used by the AT command application and
mfiore 0:c62615f15125 672 * should not be used by standard applications consuming the mDot library
mfiore 0:c62615f15125 673 ************************************************************************/
Mike Fiore 7:683dba5d576f 674
mfiore 0:c62615f15125 675 // set/get configured baud rate for command port
mfiore 0:c62615f15125 676 // only for use in conjunction with AT interface
mfiore 0:c62615f15125 677 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 678 int32_t setBaud(const uint32_t& baud);
mfiore 0:c62615f15125 679 uint32_t getBaud();
mfiore 0:c62615f15125 680
mfiore 0:c62615f15125 681 // set/get baud rate for debug port
mfiore 0:c62615f15125 682 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 683 int32_t setDebugBaud(const uint32_t& baud);
mfiore 0:c62615f15125 684 uint32_t getDebugBaud();
mfiore 0:c62615f15125 685
mfiore 0:c62615f15125 686 // set/get command terminal echo
mfiore 0:c62615f15125 687 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 688 int32_t setEcho(const bool& on);
mfiore 0:c62615f15125 689 bool getEcho();
mfiore 0:c62615f15125 690
mfiore 0:c62615f15125 691 // set/get command terminal verbose mode
mfiore 0:c62615f15125 692 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 693 int32_t setVerbose(const bool& on);
mfiore 0:c62615f15125 694 bool getVerbose();
mfiore 0:c62615f15125 695
mfiore 0:c62615f15125 696 // set/get startup mode
mfiore 0:c62615f15125 697 // COMMAND_MODE (default), starts up ready to accept AT commands
mfiore 0:c62615f15125 698 // SERIAL_MODE, read serial data and send it as LoRa packets
mfiore 0:c62615f15125 699 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 700 int32_t setStartUpMode(const uint8_t& mode);
mfiore 0:c62615f15125 701 uint8_t getStartUpMode();
mfiore 0:c62615f15125 702
mfiore 0:c62615f15125 703 int32_t setRxDataRate(const uint8_t& dr);
mfiore 0:c62615f15125 704 uint8_t getRxDataRate();
mfiore 0:c62615f15125 705
mfiore 0:c62615f15125 706 // get/set TX/RX frequency
mfiore 0:c62615f15125 707 // if frequency band == FB_868 (Europe), must be between 863000000 - 870000000
mfiore 0:c62615f15125 708 // if frequency band == FB_915 (United States), must be between 902000000-928000000
mfiore 0:c62615f15125 709 // if set to 0, device will hop frequencies
mfiore 0:c62615f15125 710 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 711 int32_t setTxFrequency(const uint32_t& freq);
mfiore 0:c62615f15125 712 uint32_t getTxFrequency();
mfiore 0:c62615f15125 713 int32_t setRxFrequency(const uint32_t& freq);
mfiore 0:c62615f15125 714 uint32_t getRxFrequency();
mfiore 0:c62615f15125 715
mfiore 0:c62615f15125 716 // get/set TX/RX inverted
mfiore 0:c62615f15125 717 // true == signal is inverted
mfiore 0:c62615f15125 718 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 719 int32_t setTxInverted(const bool& on);
mfiore 0:c62615f15125 720 bool getTxInverted();
mfiore 0:c62615f15125 721 int32_t setRxInverted(const bool& on);
mfiore 0:c62615f15125 722 bool getRxInverted();
mfiore 0:c62615f15125 723
mfiore 0:c62615f15125 724 // get/set RX output mode
mfiore 0:c62615f15125 725 // valid options are HEXADECIMAL and BINARY
mfiore 0:c62615f15125 726 // set function returns MDOT_OK if success
mfiore 0:c62615f15125 727 int32_t setRxOutput(const uint8_t& mode);
mfiore 0:c62615f15125 728 uint8_t getRxOutput();
mfiore 0:c62615f15125 729
mfiore 0:c62615f15125 730 // get/set serial wake interval
mfiore 0:c62615f15125 731 // valid values are 2 s - INT_MAX (2147483647) s
mfiore 0:c62615f15125 732 // set function returns MDOT_OK if success
Mike Fiore 7:683dba5d576f 733 int32_t setWakeInterval(const uint32_t& interval);
Mike Fiore 7:683dba5d576f 734 uint32_t getWakeInterval();
mfiore 0:c62615f15125 735
mfiore 0:c62615f15125 736 // get/set serial wake delay
mfiore 0:c62615f15125 737 // valid values are 2 ms - INT_MAX (2147483647) ms
mfiore 0:c62615f15125 738 // set function returns MDOT_OK if success
Mike Fiore 7:683dba5d576f 739 int32_t setWakeDelay(const uint32_t& delay);
Mike Fiore 7:683dba5d576f 740 uint32_t getWakeDelay();
mfiore 0:c62615f15125 741
mfiore 0:c62615f15125 742 // get/set serial receive timeout
mfiore 0:c62615f15125 743 // valid values are 0 ms - 65000 ms
mfiore 0:c62615f15125 744 // set function returns MDOT_OK if success
Mike Fiore 7:683dba5d576f 745 int32_t setWakeTimeout(const uint16_t& timeout);
Mike Fiore 7:683dba5d576f 746 uint16_t getWakeTimeout();
Mike Fiore 7:683dba5d576f 747
Mike Fiore 7:683dba5d576f 748 // get/set serial wake mode
Mike Fiore 7:683dba5d576f 749 // valid values are INTERRUPT or RTC_ALARM
Mike Fiore 7:683dba5d576f 750 // set function returns MDOT_OK if success
Mike Fiore 7:683dba5d576f 751 int32_t setWakeMode(const uint8_t& delay);
Mike Fiore 7:683dba5d576f 752 uint8_t getWakeMode();
Mike Fiore 7:683dba5d576f 753
Mike Fiore 7:683dba5d576f 754 // Save user file data to flash
Mike Fiore 7:683dba5d576f 755 // file - name of file max 30 chars
Mike Fiore 7:683dba5d576f 756 // data - data of file
Mike Fiore 7:683dba5d576f 757 // size - size of file
Mike Fiore 7:683dba5d576f 758 bool saveUserFile(const char* file, void* data, uint32_t size);
Mike Fiore 7:683dba5d576f 759
Mike Fiore 7:683dba5d576f 760 // Append user file data to flash
Mike Fiore 7:683dba5d576f 761 // file - name of file max 30 chars
Mike Fiore 7:683dba5d576f 762 // data - data of file
Mike Fiore 7:683dba5d576f 763 // size - size of file
Mike Fiore 7:683dba5d576f 764 bool appendUserFile(const char* file, void* data, uint32_t size);
Mike Fiore 7:683dba5d576f 765
Mike Fiore 7:683dba5d576f 766 // Read user file data from flash
Mike Fiore 7:683dba5d576f 767 // file - name of file max 30 chars
Mike Fiore 7:683dba5d576f 768 // data - data of file
Mike Fiore 7:683dba5d576f 769 // size - size of file
Mike Fiore 7:683dba5d576f 770 bool readUserFile(const char* file, void* data, uint32_t size);
Mike Fiore 7:683dba5d576f 771
Mike Fiore 7:683dba5d576f 772 // Move a user file in flash
Mike Fiore 7:683dba5d576f 773 // file - name of file
Mike Fiore 7:683dba5d576f 774 // new_name - new name of file
Mike Fiore 7:683dba5d576f 775 bool moveUserFile(const char* file, const char* new_name);
Mike Fiore 7:683dba5d576f 776
Mike Fiore 7:683dba5d576f 777 // Delete user file data from flash
Mike Fiore 7:683dba5d576f 778 // file - name of file max 30 chars
Mike Fiore 7:683dba5d576f 779 bool deleteUserFile(const char* file);
Mike Fiore 7:683dba5d576f 780
Mike Fiore 7:683dba5d576f 781 // Open user file in flash, max of 4 files open concurrently
Mike Fiore 7:683dba5d576f 782 // file - name of file max 30 chars
Mike Fiore 7:683dba5d576f 783 // mode - combination of FM_APPEND | FM_TRUNC | FM_CREAT |
Mike Fiore 7:683dba5d576f 784 // FM_RDONLY | FM_WRONLY | FM_RDWR | FM_DIRECT
Mike Fiore 7:683dba5d576f 785 // returns - mdot_file struct, fd field will be a negative value if file could not be opened
Mike Fiore 7:683dba5d576f 786 mDot::mdot_file openUserFile(const char* file, int mode);
Mike Fiore 7:683dba5d576f 787
Mike Fiore 7:683dba5d576f 788 // Seek an open file
Mike Fiore 7:683dba5d576f 789 // file - mdot file struct
Mike Fiore 7:683dba5d576f 790 // offset - offset in bytes
Mike Fiore 7:683dba5d576f 791 // whence - where offset is based SEEK_SET, SEEK_CUR, SEEK_END
Mike Fiore 7:683dba5d576f 792 bool seekUserFile(mDot::mdot_file& file, size_t offset, int whence);
Mike Fiore 7:683dba5d576f 793
Mike Fiore 7:683dba5d576f 794 // Read bytes from open file
Mike Fiore 7:683dba5d576f 795 // file - mdot file struct
Mike Fiore 7:683dba5d576f 796 // data - mem location to store data
Mike Fiore 7:683dba5d576f 797 // length - number of bytes to read
Mike Fiore 7:683dba5d576f 798 // returns - number of bytes written
Mike Fiore 7:683dba5d576f 799 int readUserFile(mDot::mdot_file& file, void* data, size_t length);
Mike Fiore 7:683dba5d576f 800
Mike Fiore 7:683dba5d576f 801 // Write bytes to open file
Mike Fiore 7:683dba5d576f 802 // file - mdot file struct
Mike Fiore 7:683dba5d576f 803 // data - data to write
Mike Fiore 7:683dba5d576f 804 // length - number of bytes to write
Mike Fiore 7:683dba5d576f 805 // returns - number of bytes written
Mike Fiore 7:683dba5d576f 806 int writeUserFile(mDot::mdot_file& file, void* data, size_t length);
Mike Fiore 7:683dba5d576f 807
Mike Fiore 7:683dba5d576f 808 // Close open file
Mike Fiore 7:683dba5d576f 809 // file - mdot file struct
Mike Fiore 7:683dba5d576f 810 bool closeUserFile(mDot::mdot_file& file);
Mike Fiore 7:683dba5d576f 811
Mike Fiore 7:683dba5d576f 812 // List user files stored in flash
Mike Fiore 7:683dba5d576f 813 std::vector<mDot::mdot_file> listUserFiles();
Mike Fiore 7:683dba5d576f 814
Mike Fiore 7:683dba5d576f 815 // Move file into the firmware upgrade path to be flashed on next boot
Mike Fiore 7:683dba5d576f 816 // file - name of file
Mike Fiore 7:683dba5d576f 817 bool moveUserFileToFirmwareUpgrade(const char* file);
Mike Fiore 7:683dba5d576f 818
Mike Fiore 7:683dba5d576f 819 // get current statistics
Mike Fiore 7:683dba5d576f 820 // Join Attempts, Join Fails, Up Packets, Down Packets, Missed Acks
Mike Fiore 7:683dba5d576f 821 mdot_stats getStats();
Mike Fiore 7:683dba5d576f 822
Mike Fiore 7:683dba5d576f 823 // reset statistics
Mike Fiore 7:683dba5d576f 824 // Join Attempts, Join Fails, Up Packets, Down Packets, Missed Acks
Mike Fiore 7:683dba5d576f 825 void resetStats();
Mike Fiore 7:683dba5d576f 826
Mike Fiore 7:683dba5d576f 827 // Convert pin number 2-8 to pin name DIO2-DI8
Mike Fiore 7:683dba5d576f 828 static PinName pinNum2Name(uint8_t num);
Mike Fiore 7:683dba5d576f 829
Mike Fiore 7:683dba5d576f 830 // Convert pin name DIO2-DI8 to pin number 2-8
Mike Fiore 7:683dba5d576f 831 static uint8_t pinName2Num(PinName name);
Mike Fiore 7:683dba5d576f 832
Mike Fiore 7:683dba5d576f 833 // Convert pin name DIO2-DI8 to string
Mike Fiore 7:683dba5d576f 834 static std::string pinName2Str(PinName name);
Mike Fiore 7:683dba5d576f 835
mfiore 0:c62615f15125 836
mfiore 0:c62615f15125 837 uint64_t crc64(uint64_t crc, const unsigned char *s, uint64_t l);
mfiore 0:c62615f15125 838
mfiore 0:c62615f15125 839 // MTS_RADIO_DEBUG_COMMANDS
Mike Fiore 7:683dba5d576f 840
Mike Fiore 7:683dba5d576f 841 void openRxWindow(uint32_t timeout, uint8_t bandwidth = 0);
Mike Fiore 6:390fc83d588d 842 void sendContinuous();
mfiore 0:c62615f15125 843 int32_t setDeviceId(const std::vector<uint8_t>& id);
mfiore 0:c62615f15125 844 int32_t setFrequencyBand(const uint8_t& band);
mfiore 0:c62615f15125 845 bool saveProtectedConfig();
mfiore 0:c62615f15125 846 void resetRadio();
mfiore 0:c62615f15125 847 int32_t setRadioMode(const uint8_t& mode);
mfiore 0:c62615f15125 848 std::map<uint8_t, uint8_t> dumpRegisters();
mfiore 0:c62615f15125 849 void eraseFlash();
mfiore 0:c62615f15125 850
Mike Fiore 7:683dba5d576f 851
Mike Fiore 7:683dba5d576f 852 // deprecated - use setWakeInterval
Mike Fiore 7:683dba5d576f 853 int32_t setSerialWakeInterval(const uint32_t& interval);
Mike Fiore 7:683dba5d576f 854 // deprecated - use getWakeInterval
Mike Fiore 7:683dba5d576f 855 uint32_t getSerialWakeInterval();
Mike Fiore 6:390fc83d588d 856
Mike Fiore 7:683dba5d576f 857 // deprecated - use setWakeDelay
Mike Fiore 7:683dba5d576f 858 int32_t setSerialWakeDelay(const uint32_t& delay);
Mike Fiore 7:683dba5d576f 859 // deprecated - use setWakeDelay
Mike Fiore 7:683dba5d576f 860 uint32_t getSerialWakeDelay();
Mike Fiore 7:683dba5d576f 861
Mike Fiore 7:683dba5d576f 862 // deprecated - use setWakeTimeout
Mike Fiore 7:683dba5d576f 863 int32_t setSerialReceiveTimeout(const uint16_t& timeout);
Mike Fiore 7:683dba5d576f 864 // deprecated - use getWakeTimeout
Mike Fiore 7:683dba5d576f 865 uint16_t getSerialReceiveTimeout();
mfiore 0:c62615f15125 866
mfiore 0:c62615f15125 867 private:
mfiore 0:c62615f15125 868 mdot_stats _stats;
mfiore 0:c62615f15125 869
mfiore 0:c62615f15125 870 };
mfiore 0:c62615f15125 871
mfiore 0:c62615f15125 872 #endif