Mbed OS Reference | LoRaPHYUS915.h Source File

Go to the documentation of this file.
 /**
  *  @file LoRaPHYUS915.h
  *
  *  @brief Implements LoRaPHY for US 915 MHz band
  *
  *  \code
  *   ______                              _
  *  / _____)             _              | |
  * ( (____  _____ ____ _| |_ _____  ____| |__
  *  \____ \| ___ |    (_   _) ___ |/ ___)  _ \
  *  _____) ) ____| | | || |_| ____( (___| | | |
  * (______/|_____)_|_|_| \__)_____)\____)_| |_|
  *   (C)2013 Semtech
  *  ___ _____ _   ___ _  _____ ___  ___  ___ ___
  * / __|_   _/_\ / __| |/ / __/ _ \| _ \/ __| __|
  * \__ \ | |/ _ \ (__| ' <| _| (_) |   / (__| _|
  * |___/ |_/_/ \_\___|_|\_\_| \___/|_|_\\___|___|
  * embedded.connectivity.solutions===============
  *
  * \endcode
  *
  *
  * License: Revised BSD License, see LICENSE.TXT file include in the project
  *
  * Maintainer: Miguel Luis ( Semtech ), Gregory Cristian ( Semtech ) and Daniel Jaeckle ( STACKFORCE )
  *
  * Copyright (c) 2017, Arm Limited and affiliates.
  * SPDX-License-Identifier: BSD-3-Clause
  *
  */
 
 #ifndef MBED_OS_LORAPHYUS_915_H_
 #define MBED_OS_LORAPHYUS_915_H_
 
 #if !(DOXYGEN_ONLY)
 
 #include "LoRaPHY.h"
 
 /*!
  * LoRaMac maximum number of channels
  */
 #define US915_MAX_NB_CHANNELS                       72
 
 /*!
  * LoRaMac maximum number of bands
  */
 #define US915_MAX_NB_BANDS                          1
 
 #define US915_CHANNEL_MASK_SIZE                    5
 
 
 class LoRaPHYUS915 : public LoRaPHY {
 
 public:
 
     LoRaPHYUS915();
     virtual ~LoRaPHYUS915();
 
     virtual void restore_default_channels();
 
     virtual bool rx_config(rx_config_params_t *config);
 
     virtual bool tx_config(tx_config_params_t *config, int8_t *tx_power,
                            lorawan_time_t *tx_toa);
 
     virtual uint8_t link_ADR_request(adr_req_params_t *params,
                                      int8_t *dr_out, int8_t *tx_power_out,
                                      uint8_t *nb_rep_out,
                                      uint8_t *nb_bytes_parsed);
 
     virtual uint8_t accept_rx_param_setup_req(rx_param_setup_req_t *params);
 
     virtual int8_t get_alternate_DR(uint8_t nb_trials);
 
     virtual lorawan_status_t set_next_channel(channel_selection_params_t *params, uint8_t *channel,
                                               lorawan_time_t *time, lorawan_time_t *aggregate_timeOff);
 
     virtual void set_tx_cont_mode(cw_mode_params_t *continuousWave,
                                   uint32_t frequency = 0);
 
     virtual uint8_t apply_DR_offset(int8_t dr, int8_t dr_offset);
 
 private:
 
     /**
      * Sets the intersection of source and destination channel masks
      * into the destination.
      */
     void intersect_channel_mask(const uint16_t *source, uint16_t *destination,
                                 uint8_t size);
 
     /**
      * Fills channel mask array based upon the provided FSB mask
      */
     void fill_channel_mask_with_fsb(const uint16_t *expectation,
                                     const uint16_t *fsb_mask,
                                     uint16_t *channel_mask, uint8_t size);
 
     /**
      * Fills channel mask array with a given value
      */
     void fill_channel_mask_with_value(uint16_t *channel_mask,
                                       uint16_t value, uint8_t size);
 
     int8_t limit_tx_power(int8_t tx_power, int8_t max_band_tx_power,
                           int8_t datarate);
 
     /*!
      * LoRaMAC channels
      */
     channel_params_t channels[US915_MAX_NB_CHANNELS];
 
     /*!
      * LoRaMac bands
      */
     band_t bands[US915_MAX_NB_BANDS];
 
     /*!
      * LoRaMac channel mask
      */
     uint16_t channel_mask[US915_CHANNEL_MASK_SIZE];
 
     /*!
      * Previously used channel mask
      */
     uint16_t current_channel_mask[US915_CHANNEL_MASK_SIZE];
 
     /*!
      * LoRaMac default channel mask
      */
     uint16_t default_channel_mask[US915_CHANNEL_MASK_SIZE];
 };
 
 #endif /* DOXYGEN_ONLY */
 #endif /* MBED_OS_LORAPHY_US915_H_ */
Important Information for this Arm website
