You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
182 lines
9.5 KiB
182 lines
9.5 KiB
@verbatim
|
|
******************************************************************************
|
|
*
|
|
* Portions COPYRIGHT 2017 STMicroelectronics
|
|
*
|
|
* @file st_readme.txt
|
|
* @author MCD Application Team
|
|
* @brief This file lists the main modification done by STMicroelectronics on
|
|
* LoRa for integration with STM32Cube solution.
|
|
* For more details on LoRa implementation on STM32Cube, please refer
|
|
* to UM2073 "STM32 LORA01 software expansion for STM32Cube "
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© Copyright (c) 2017 STMicroelectronics International N.V.
|
|
* All rights reserved.</center></h2>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted, provided that the following conditions are met:
|
|
*
|
|
* 1. Redistribution of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* 3. Neither the name of STMicroelectronics nor the names of other
|
|
* contributors to this software may be used to endorse or promote products
|
|
* derived from this software without specific written permission.
|
|
* 4. This software, including modifications and/or derivative works of this
|
|
* software, must execute solely and exclusively on microcontroller or
|
|
* microprocessor devices manufactured by or for STMicroelectronics.
|
|
* 5. Redistribution and use of this software other than as permitted under
|
|
* this license is void and will automatically terminate your rights under
|
|
* this license.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY STMICROELECTRONICS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS, IMPLIED OR STATUTORY WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
|
|
* PARTICULAR PURPOSE AND NON-INFRINGEMENT OF THIRD PARTY INTELLECTUAL PROPERTY
|
|
* RIGHTS ARE DISCLAIMED TO THE FULLEST EXTENT PERMITTED BY LAW. IN NO EVENT
|
|
* SHALL STMICROELECTRONICS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
|
|
* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
******************************************************************************
|
|
@endverbatim
|
|
|
|
### V1.1.2/08-September-2017 ###
|
|
===============================
|
|
+ Implements LoRa Mac 4.4.0 release from Semtech/StackForce
|
|
https://github.com/Lora-net/LoRaMac-node/tree/f42be67be402a40b3586724800771bfe13fb18e6
|
|
|
|
+ AckTimeoutRetriesCounter must be reset every time a new request (unconfirmed or confirmed) is performed.
|
|
+ Added verification for the power parameter in order to check that it is greater or equal to 0.
|
|
|
|
+ Enhancement for regions without FSK modulation support.
|
|
+ Bug fix for RX window 2 in class c mode.
|
|
+ AdrAckReq bit must be set to false as soon as we reach the lowest datarate.
|
|
+ MacCommandsBufferIndex must be reset when the mac commands are being sent on port 0.
|
|
+ Fixed RegionCommonSetBandTxDone in order to also update band->LastTxDoneTime when performing the Join procedure.
|
|
+ Added verification of payload size for Unconfirmed and Confirmed messages depending on Dwell time.
|
|
|
|
+ Added missing Rx1 timeout handling.
|
|
+ Updated all regions to use MAX output power by default.
|
|
+ Merge remote-tracking branch 'origin/develop' into develop
|
|
+ Bug fix in KR920 - update the maxEIRP calculation for continuous wave
|
|
+ Bug fix in IN865 - Update the band of the default channels
|
|
+ Bug fix in AS923 - for RX use always the payload limitation of dwell 0
|
|
+ Update function RegionCommonChanVerifyDr. Perform an 'AND' operation for security
|
|
+ Move the verification of ADR parameters into the common section. Update all regions with the related changes
|
|
+ Update comment for function RegionLinkAdrReq
|
|
+ Apply variables to data structure LinkAdrReqParams_t
|
|
+ Bug fix for KR920
|
|
+ Rename data structure LinkAdrParams_t
|
|
+ Issue(#238): Apply missing variable in sSetBandTxDoneParams
|
|
+ Bug fix in processing MAC commands for case SRV_MAC_TX_PARAM_SETUP_REQ.
|
|
+ Isse(#238): Apply missing variable in struct sBand
|
|
+ Update the MAC to enable the server to control the Channels Mask and the number of transmissions even ADR is off
|
|
+ Issue(#238): Update the backoff procedure for all regions. Move code parts into the common section
|
|
+ Update implementation to allow automatic MAC answers on port 0
|
|
+ Issue(#253): Delete all preconfigured channels when performing a join request
|
|
+ Initialize variable phyParam in functions RegionXXGetPhyParam
|
|
+ Remove assert_param from the radio drivers
|
|
+ Synchronize function RegionXXTxConfig
|
|
+ Update carrier sense functionality for LBT
|
|
+ Issue(#259): Update comment for variable HasLoopedThroughMain
|
|
+ Issue(#257): Fix typo in OnRxWindow2TimerEvent
|
|
+ Change scientific notation to numeric notation
|
|
+ Merge pull request #260 from clmklk/AU915
|
|
|
|
+ AU915: update Datarate limits according to LoRaWan 1.0.2rB
|
|
+ AU915: update Downstream datarate table according to LoRaWan 1.0.2rB
|
|
|
|
+ Merge pull request #225 from OpenChirp/patch_1
|
|
|
|
### V1.1.1/01-June-2017 ###
|
|
===============================
|
|
+ Implements LoRa Mac from Semtech/StackForce develop branch (30-May-2017 commits, 4.4.0 release candidate)
|
|
https://github.com/Lora-net/LoRaMac-node/tree/e2f35db75c1b449379d3b520c2d4e5922a9f5c81
|
|
|
|
+ Issue(235): Update functions RegionXXNextChannel.
|
|
+ Issue(238): Update initialization value of nextTxDelay.
|
|
+ Issue(234): Report back the aggregated time off.
|
|
+ Issue(232): Relocate function call to CalculateBackOff.
|
|
+ Issue(239): Update band TX power to the maximum.
|
|
+ Update LimitTxPower for US915.
|
|
+ Bug fix in function RegionCN470Verify.
|
|
+ Bug fix in function RegionAU915Verify.
|
|
+ Issue(229): Fix issue when receiving frames in second RX2 in Class C.
|
|
+ Add a ommand to get the next lower datarate.
|
|
+ Group initializations
|
|
+ Update regional definitions of KR920.
|
|
+ Update regional definitions of EU868.
|
|
+ Issue(239): Update regional definitions of AU915.
|
|
+ Update regional definitions of AU915.
|
|
+ Update regional definitions of AS923.
|
|
+ Update TX power computations.
|
|
|
|
+ Remove duplicated call to ApplyDrOffset in function RegionRxConfig.
|
|
+ Relocate the datarate, up- and downlink dwell time into a structure.
|
|
+ Change API of RegionGetPhyParam and the related functions.
|
|
+ Bug fix in function LoRaMacQueryTxPossible.
|
|
+ Apply patch for dwell time and minimum datarate.
|
|
+ Change the default datarate to DR_2 for AS923.
|
|
+ Take dwell time for ADR calculations and datarate settings into account.
|
|
+ Update LoRaMacQueryTxPossible to reset the MAC commands buffer.
|
|
|
|
+ Issue(#221): Add the dwell time in function ValidatePayloadLength.
|
|
+ Increase the transmission and reception timeout for KR920.
|
|
+ Bug fix in functions OnRxWindowXTimerEvent.
|
|
+ Remove datarate assignment.
|
|
+ Setup the downlink and uplink dwell time default value to 1.
|
|
+ Add frequency range check for AS923
|
|
+ Issue(#221): Bug fix in max payload size calculation.
|
|
|
|
+ GitHub reported issues corrections.
|
|
+ Changed the AdrAckCounter handling as expected by the test houses.
|
|
+ Fix an issue where the node stopped transmitting.
|
|
+ Removed useless LoRaMacPayload buffer.
|
|
+ MAC layer indications handling simplification.
|
|
+ Relocate parameter settings from ResetMacParameters to the initialization.
|
|
|
|
### V1.1.0/27-February-2017 ###
|
|
===============================
|
|
+ Implements LoRa Mac 4.4.0 from Semtech/StackForce from the develop branch
|
|
|
|
### V1.0.3/01-January-2017 ###
|
|
===============================
|
|
+ Read date between 2 successive read time to make sure date is ok
|
|
|
|
### V1.0.2/15-November-2016 ###
|
|
===============================
|
|
+ Corrected 1 bug in LoRaMac-board.h: RX_WND_2_CHANNEL for EU is now back at DR_0
|
|
+ Corrected 1 bug in LoRaMac.c for dataRate adaptation
|
|
|
|
### V1.0.1/15-September-2016 ###
|
|
===============================
|
|
+ Implements LoRa Mac 4.3.0 from Semtech/StackForce
|
|
|
|
### V1.0.0/01-July-2016 ###
|
|
===============================
|
|
+ First R1.0.0 customized version for STM32Cube solution.
|
|
+ Comissioning_template.h in /Conf contains all Lora Ids to connect on LoRa network
|
|
It is provided as a template. It must be moved to /Projects/inc/ as Comissioning.h
|
|
+ All files in Conf/src are provided as template and must be copied in /Projects/src.
|
|
+ All files in Conf/inc are provided as template and must be copied in /Projects/inc.
|
|
#if 0 and #endif must be removed to enable the template in the user directory
|
|
+ Implements LoRa Mac 4.2.0 from Semtech/StackForce
|
|
+ \Lora\Mac\LoRaMac.c : replace floating exponent e3 and e6 by int number
|
|
+ \Lora\Utilities\delay.c : cast uint32_t
|
|
+ Modified intensively timeServer.c
|
|
+ new low layer interfacing Cube HAL (hw_rtc.c, hw_gpio.c and hw_spi.c)
|
|
+ added lora.c as an interface layer to ease product integration
|
|
|
|
|
|
* <h3><center>© COPYRIGHT STMicroelectronics</center></h3>
|
|
*/
|
|
|