Skip to content

Commit 37e8fde

Browse files
mluis1mluis1
committed
Update readme.md file for release 4.4.2
1 parent 376b550 commit 37e8fde

File tree

1 file changed

+67
-31
lines changed

1 file changed

+67
-31
lines changed

‎readme.md‎

Lines changed: 67 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
\____ \| ___ | (_ _) ___ |/ ___) _ \
77
_____) ) ____| | | || |_| ____( (___| | | |
88
(______/|_____)_|_|_| \__)_____)\____)_| |_|
9-
(C)2013-2018 Semtech
9+
(C)2013-2019 Semtech
1010

1111
___ _____ _ ___ _ _____ ___ ___ ___ ___
1212
/ __|_ _/_\ / __| |/ / __/ _ \| _ \/ __| __|
@@ -18,19 +18,17 @@
1818

1919
The aim of this project is to show an example of the endpoint LoRaWAN stack implementation.
2020

21-
This project has 3 active branches in place. The **[master](https://github.com/Lora-net/LoRaMac-node/tree/master)** branch which provides the latest released source code ([v4.4.1](https://github.com/Lora-net/LoRaMac-node/releases/tag/v4.4.1)), the **[develop](https://github.com/Lora-net/LoRaMac-node/tree/develop)** branch which provides the current source code development status to be released next ([Milestone 4.4.2](https://github.com/Lora-net/LoRaMac-node/milestone/2)) and the **[feature/5.0.0](https://github.com/Lora-net/LoRaMac-node/tree/feature/5.0.0)** branch which provides a preview of the current source code development status for [LoRaWAN Specification v1.1](https://lora-alliance.org/resource-hub/lorawantm-specification-v11) specification.([Milestone 5.0.0](https://github.com/Lora-net/LoRaMac-node/milestone/3))
21+
This project has 3 active branches in place. The **[master](https://github.com/Lora-net/LoRaMac-node/tree/master)** branch which provides the latest released source code ([v4.4.2](https://github.com/Lora-net/LoRaMac-node/releases/tag/v4.4.2)), the **[develop](https://github.com/Lora-net/LoRaMac-node/tree/develop)** branch which provides the current source code development status to be released next ([Milestone 4.4.3](https://github.com/Lora-net/LoRaMac-node/milestone/4)) and the **[feature/5.0.0](https://github.com/Lora-net/LoRaMac-node/tree/feature/5.0.0)** branch which provides a preview of the current source code development status for [LoRaWAN Specification v1.1](https://lora-alliance.org/resource-hub/lorawantm-specification-v11) specification.([Milestone 5.0.0](https://github.com/Lora-net/LoRaMac-node/milestone/3))
2222

23-
* The [master](https://github.com/Lora-net/LoRaMac-node/tree/master) branch implementation is based on [LoRaWAN Specification v1.0.2](https://lora-alliance.org/resource-hub/lorawantm-specification-v102) and [LoRaWAN Regional Parameters v1.0.2rB](https://www.lora-alliance.org/resource-hub/lorawantm-regional-parameters-v102rb) specifications.
24-
ClassA and ClassC end-device classes are fully implemented.
23+
* The [master](https://github.com/Lora-net/LoRaMac-node/tree/master) branch implementation is based on [LoRaWAN Specification v1.0.3](https://lora-alliance.org/resource-hub/lorawantm-specification-v103) and [LoRaWAN Regional Parameters v1.0.3revA](https://www.lora-alliance.org/resource-hub/lorawantm-regional-parameters-v103reva) specifications.
24+
ClassA, ClassB and ClassC end-device classes are fully implemented.
2525

2626
* The [develop](https://github.com/Lora-net/LoRaMac-node/tree/develop) branch implementation is based on [LoRaWAN Specification v1.0.3](https://lora-alliance.org/resource-hub/lorawantm-specification-v103) and [LoRaWAN Regional Parameters v1.0.3revA](https://lora-alliance.org/resource-hub/lorawan-regional-parameters-v103reva) specifications.
2727
ClassA, ClassB and ClassC end-device classes are fully implemented.
2828

2929
* The [feature/5.0.0](https://github.com/Lora-net/LoRaMac-node/tree/feature/5.0.0) branch implementation is based on [LoRaWAN Specification v1.1](https://lora-alliance.org/resource-hub/lorawantm-specification-v11) and [LoRaWAN Regional Parameters v1.1rB](https://lora-alliance.org/resource-hub/lorawantm-regional-parameters-v11rb) specifications.
3030
ClassA, ClassB and ClassC end-device classes are fully implemented.
3131

32-
The [develop](https://github.com/Lora-net/LoRaMac-node/tree/develop) and [feature/5.0.0](https://github.com/Lora-net/LoRaMac-node/tree/feature/5.0.0) branches both rely on a software emulated secure-element implementation. Please refer to the [Secure element API](https://github.com/Lora-net/LoRaMac-node/wiki/secure-element) document for further information.
33-
3432
This project also provides SX1272/73, SX1276/77/78/79 and SX1261/2 radio drivers.
3533

3634
For each currently supported platform example applications are provided.
@@ -41,13 +39,17 @@ For each currently supported platform example applications are provided.
4139

4240
* **LoRaMac/classC**: ClassC end-device example application.
4341

42+
* **LoRaMac/fuota-test-01**: FUOTA test scenario 01 end-device example application. (Based on provided application common packages)
43+
44+
* **LoRaMac/periodic-uplink-lpp**: ClassA/B/C end-device example application. Periodically uplinks a frame using the Cayenne LPP protocol. (Based on provided application common packages)
45+
4446
* **ping-pong**: Point to point RF link example application.
4547

4648
* **rx-sensi**: Example application useful to measure the radio sensitivity level using an RF generator.
4749

4850
* **tx-cw**: Example application to show how to generate an RF Continuous Wave transmission.
4951

50-
**Note**: *Each LoRaWAN application example (LoRaMac/classX) includes an implementation of the LoRa-Alliacne; LoRaWAN certification protocol.*
52+
**Note**: *Each LoRaWAN application example (LoRaMac/classX) includes an implementation of the LoRa-Alliance; LoRaWAN certification protocol.*
5153

5254
**Note**: *The LoRaWAN stack API documentation can be found at: http://stackforce.github.io/LoRaMac-doc/*
5355

@@ -87,6 +89,44 @@ This program uses the CMAC algorithm implementation
8789

8890
## Changelog
8991

92+
### 2019-07-19, V4.4.2
93+
94+
* General
95+
1. Release based on "LoRaWAN specification 1.0.3" and "LoRaWAN Regional Parameters v1.0.3revA"
96+
2. Examples application refactoring plus the addition of the application status display on the serial port. (921600-8-N-1)
97+
3. Added new refactored application examples
98+
* Added LoRa-Alliance defined application layer protocols support. Only FUOTA test scenario 01 required features are currently implemented.
99+
- "Clock Synchronization" package
100+
- "Fragmented data block transport" package
101+
- "Remote multicast setup" package
102+
4. Added a NVM context management module. (Disabled by default)
103+
5. Added secure-element support
104+
6. Refactored timer.c/h, rtc-driver.c/h and added a systime.c/h module.
105+
7. Functions in ISR context have been moved to main context
106+
8. Replaced BoardDisableIrq and BoardEnableIrq functions by CRITICAL_SECTION_BEGIN and CRITICAL_SECTION_END respectively.
107+
9. Added B-L072Z-LRWAN1 platform support.
108+
10. Added NucleoL476 platform support.
109+
11. Added IMST new platforms.
110+
12. Removed SensorNode platform support
111+
13. Removed MoteII platform support
112+
14. Removed LoRaMote platform support
113+
15. Applied SX1272 and SX1276 radios errata note 3.1 to the radio drivers implementation.
114+
16. Fix printf/scanf functions when GCC is used as compiler.
115+
116+
* LoRaWAN
117+
1. GitHub reported issues corrections. Please refer to [Release Version 4.4.2](https://github.com/Lora-net/LoRaMac-node/milestone/2)
118+
2. Heavily refactored the LoRaMac.c/h implementation.
119+
3. Added RU864 region support.
120+
4. Removed US915-Hybrid region support
121+
5. Added ClassB support.
122+
6. Added a callback to notify the upper layer to call LoRaMacProcess function
123+
7. Implemented the support for RxC windows (ClassC) required by the application layer protocols.
124+
8. Changed multicast channels handling according to the application layer protocols.
125+
126+
**LoRaWAN pre-certification results**
127+
128+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
129+
90130
### 2018-03-07, V4.4.1
91131

92132
* General
@@ -101,19 +141,9 @@ This program uses the CMAC algorithm implementation
101141
* LoRaWAN
102142
1. GitHub reported issues corrections. Please refer to [Release Version 4.4.1](https://github.com/Lora-net/LoRaMac-node/milestone/1)
103143

104-
**LoRaWAN certification results**
144+
**LoRaWAN pre-certification results**
105145

106-
| Region | Verdict | # Test houses | Comments |
107-
| ------------- |:-------------:|:-------------:|:--------------|
108-
| EU868 | <font color='green'>PASS</font> | 2 | - |
109-
| US915 | <font color='green'>PASS</font> | 2 | - |
110-
| CN779 | <font color='green'>PASS</font> | 1 | No certification specification - tests based on EU868 certification |
111-
| EU433 | <font color='orange'>Not tested</font> | 1 | No certification specification - tests based on EU868 certification |
112-
| AU915 | <font color='green'>PASS</font> | 0 | No certification specification - tests based on US915 certification |
113-
| CN470 | <font color='orange'>Not tested</font> | 0 | No certification specification |
114-
| AS923 | <font color='green'>PASS</font> | 2 | - |
115-
| KR920 | <font color='green'>PASS</font> | 1 | - |
116-
| IN865 | <font color='green'>PASS</font> | 2 | - |
146+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
117147

118148
### 2017-09-08, V4.4.0
119149

@@ -128,19 +158,9 @@ This program uses the CMAC algorithm implementation
128158
2. Updated implementation to support 1.0.2 specification additions.
129159
3. Added the support for all "LoRaWAN Regional Parameters v1.0.2rB" document defined regions.
130160

131-
**LoRaWAN certification results**
161+
**LoRaWAN pre-certification results**
132162

133-
| Region | Verdict | # Test houses | Comments |
134-
| ------------- |:-------------:|:-------------:|:--------------|
135-
| EU868 | <font color='green'>PASS</font> | 2 | - |
136-
| US915 | <font color='green'>PASS</font> | 2 | - |
137-
| CN779 | <font color='orange'>Partial PASS</font> | 1 | No certification specification - tests based on EU868 certification - All tests PASS except 1. Join Accept Rx2 parameters not being applied (under investigation) |
138-
| EU433 | <font color='green'>PASS</font> | 1 | No certification specification - tests based on EU868 certification |
139-
| AU915 | <font color='orange'>Not tested yet</font> | 0 | No certification specification |
140-
| CN470 | <font color='orange'>Not tested yet</font> | 0 | No certification specification |
141-
| AS923 | <font color='green'>PASS</font> | 2 | - |
142-
| KR920 | <font color='green'>PASS</font> | 1 | As of today only one test house has sent a report. We decided to perform the release anyway |
143-
| IN865 | <font color='orange'>PASS</font> | 1 | No certification specification - tests based on EU868 certification |
163+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
144164

145165
### 2017-04-19, V4.3.2
146166

@@ -162,6 +182,10 @@ This program uses the CMAC algorithm implementation
162182
5. MAC layer indications handling simplification.
163183
6. Relocate parameter settings from ResetMacParameters to the initialization.
164184

185+
**LoRaWAN pre-certification results**
186+
187+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
188+
165189
### 2017-02-27, V4.3.1
166190

167191
* General
@@ -184,6 +208,10 @@ This program uses the CMAC algorithm implementation
184208
2. GitHub reported issues corrections.
185209
3. Add region CN470 support.
186210

211+
**LoRaWAN pre-certification results**
212+
213+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
214+
187215
### 2016-06-22, V4.3.0
188216

189217
* General
@@ -217,6 +245,10 @@ This program uses the CMAC algorithm implementation
217245
15. Bug fix in OnRadioRxDone. Node now drops frames on port 0 with fOpts > 0.
218246
16. Bug fix in OnRadioRxDone. Node now receives frames with fOpts > 0 when no payload is present.
219247

248+
**LoRaWAN pre-certification results**
249+
250+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
251+
220252
### 2016-05-13, V4.2.0
221253

222254
* General
@@ -250,6 +282,10 @@ This program uses the CMAC algorithm implementation
250282
12. Accept MAC information of duplicated, confirmed downlinks.
251283
13. Issue(#74): Drop frames with a downlink counter difference greater or equal to MAX_FCNT_GAP.
252284

285+
**LoRaWAN pre-certification results**
286+
287+
Please refer to [Releases pre-certification-results](https://github.com/Lora-net/LoRaMac-node/wiki/releases-pre-certification-results) document for further information.
288+
253289
### 2016-03-10, V4.1.0
254290

255291
* General

0 commit comments

Comments
 (0)