Skip to content

Commit f71b0a6

Browse files
committed
Update release history and badges for v1.2.0
1 parent ffb948f commit f71b0a6

File tree

1 file changed

+52
-37
lines changed

1 file changed

+52
-37
lines changed

README.md

Lines changed: 52 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Get your node quickly up and running with LMIC-node.
33

44
# LMIC-node
55

6-
[![GitHub release](https://img.shields.io/github/release/lnlp/LMIC-node.svg)](https://github.com/lnlp/LMIC-node/releases/latest) [![GitHub commits](https://img.shields.io/github/commits-since/lnlp/LMIC-node/v1.1.0.svg)](https://github.com/lnlp/LMIC-node/compare/v1.1.0...main)
6+
[![GitHub release](https://img.shields.io/github/release/lnlp/LMIC-node.svg)](https://github.com/lnlp/LMIC-node/releases/latest) [![GitHub commits](https://img.shields.io/github/commits-since/lnlp/LMIC-node/v1.2.0.svg)](https://github.com/lnlp/LMIC-node/compare/v1.2.0...main)
77
One example to rule them all
88

99
## Contents
@@ -879,31 +879,21 @@ The following topics on The Things Network Forum contain useful additional infor
879879
880880
### 6.3 Not yet tested
881881
882-
All supported boards have been tested except for below boards for which hardware was not available.
883-
These boards should work but some may need some extra attention (see _remarks_ below).
884-
885-
- Adafruit Feather M0 RFMx LoRa
886-
- Heltec Wireless Stick and Wireless Stick Lite
887-
_It is assumed that the onboard LED is active-high (like the WiFi LoRa 32 boards).
888-
If incorrect then in BSF file in the led constructor change activeLevel to EasyLed::ActiveLevel::Low._
889-
- BSFrance LoRa32u4 II PCB versions 1.1 and 1.3
890-
_PCB versions 1.0 and 1.2 were tested._
891-
- TTGO LoRa32 V1.3
892-
_It is unknown if this board has an onboard LED and if it is usable. USE_LED is therefore disabled._
893-
- TTGO LoRa32 V2.1.6
894-
_Unknown if LED_BUILTIN is active-low or active-high. Active-low is assumed just like v2.
895-
If incorrect then in BSF file in the led constructor change activeLevel to EasyLed::ActiveLevel::High._
896-
- Lolin D32
897-
_Lolin D32 Pro was tested which is very similar._
898-
- TTGO T-Beam V1.1
899-
_T-Beam V1.1 may work by using board-id ttgo_tbeam_v1 but this has not been tested.
900-
It is currently unknown what the differences between V1.1 and V1.0 are._
882+
All supported boards have been tested except below boards for which hardware was not available.
883+
884+
- Adafruit Feather M0 RFMx LoRa.
885+
- Heltec Wireless Stick and Wireless Stick Lite.
886+
- BSFrance LoRa32u4 II v1.1 and v1.3 *(v1.0 and v1.2 were tested)*.
887+
- TTGO LoRa32 v1.3.
888+
- TTGO LoRa32 v2.1.6.
889+
- Lolin D32 *(Lolink D32 Pro was tested)*.
890+
- TTGO T-Beam V1.1 *(T-Beam v1.0 was tested)*.
901891
902892
### 6.4 Known issues
903893
904894
#### 6.4.1 LMIC-node schedules uplinks while not yet joined
905895
906-
If joining does not directly succeed and takes more time to complete, LMIC-node will try to schedule new uplink messages anyway which results in LMIC_ERROR_TX_BUSY errors (with every new attempt to schedule an uplink message, until the join has completed). This will have to be fixed in a new release. LMIC-node should not schedule uplink messages while the join has not yet successfully completed.
896+
If joining does not directly succeed and joining takes more time to complete, LMIC-node will try to schedule new uplink messages anyway which results in LMIC_ERROR_TX_BUSY errors (with every new attempt to schedule an uplink message, until the join has completed). This will have to be fixed in a new release. LMIC-node should not schedule uplink messages while the join has not yet successfully completed.
907897
908898
#### 6.4.2 LMIC debug output not working with Arduino Zero (USB) and Raspberry Pi Pico boards
909899
@@ -937,7 +927,7 @@ Below are some examples of status output from serial monitor and display.
937927
### 8.1 Serial Monitor
938928
939929
Example output from Raspberry Pi Pico with RFM95 SPI LoRa module.
940-
This is the first serial output after reset. It shows a join, the first two uplinks, then an uplink followed by a downlink containing a counter reset command, and then the next uplink where it is visible that the counter value has been reset. After the third uplink it shows that two downlinks have been received. One was for the reset counter command, the other downlink was for a MAC command that cannot be captured here because the sequence of up and downlinks all occur before the EV_TXCOMPLETE event is generated.
930+
This is the first serial output after reset. It shows a join, the first two uplinks, then an uplink followed by a downlink containing a counter reset command, and then the next uplink where it is visible that the counter value has been reset. After the third uplink it shows that two downlinks have been received. One was for the reset counter command, the other downlink was for a MAC command that cannot be output because the sequence of up and downlinks all occur before the EV_TXCOMPLETE event is generated.
941931
942932
```text
943933
LMIC-node
@@ -1000,21 +990,46 @@ To be added.
1000990

1001991
## 9 Release History
1002992

1003-
- **v1.1.0 Maintenance release**
1004-
- Update README.md and add Release History.
1005-
- Add support for SX1276 Low port and SX1272 in RSSI calculation.
1006-
- Add LMIC library and LMIC debug level (if >0) to print output.
1007-
- Add option to make possible to override in platformio.ini, the value of STM32_POST_INITSERIAL_DELAY_MS defined in BSF of STM32 boards.
1008-
- Add compile error when ABP is used with Classic LMIC because not compliant, generates downlink message for every uplink message because it does not properly handle MAC commands.
1009-
- For STM32 BSF's surround postInitSerial delay with #ifdef USE_SERIAL.
1010-
- In Adafruit Feather M0 LoRa BSF change DIO1 from pin 5 to pin 6 because that is what Adafruit instructs in their tutorial.
1011-
- Fix ABP_DEVICEID not being used if defined in lorawan-keys.h.
1012-
- Fix offset for RSSI calculation when using MCCI LMIC.
1013-
- Fix printEvent() error when no USE_DISPLAY and no USE_SERIAL are defined.
1014-
- Known issue: The MCCI LoRaWAN LMIC library has a problem with SerialUSB on the Arduino Zero (USB) board so LMIC debug output cannot be used.
1015-
1016-
- **v1.0.0 Initial release**
1017-
- First release of LMIC-node.
993+
**Release v1.2.0**
994+
995+
- Added
996+
- Support for Raspberry Pi Pico board.
997+
- Support for Teensy LC board.
998+
- New [pinout diagrams](https://github.com/lnlp/pinout-diagrams) repository.
999+
- Link to pinout diagrams in `README.md`.
1000+
- Links to forum topics in `README.md`.
1001+
- Example output for serial monitor in `README.md`.
1002+
- Improvements in `README.md`.
1003+
- Specify more version numbers for supported boards in `README.md` and platformio.ini.
1004+
- Compile error when `USE_LED` is defined for TTGO T-Beam v1.x boards.
1005+
- Changed
1006+
- Prefix BSF file names with `bsf_`.
1007+
- Rename board-id `ttgo_tbeam` to `ttgo_t_beam`.
1008+
- Rename board-id `ttgo_tbeam_v1` to `ttgo_t_beam_v1`.
1009+
- Rename header guards in BSF files that slipped a previous rename action.
1010+
- Order of some chapters in `README.md`.
1011+
- Fixed
1012+
- Casing in `#include "LMIC-node.h"` statement in .cpp and BSF files.
1013+
- Known issues
1014+
- LMIC debug output currently does not work with Arduino Zero (USB) and Raspberry Pi Pico boards.
1015+
1016+
**Release v1.1.0 - Maintenance release**
1017+
1018+
- Update `README.md` and add Release History.
1019+
- Add support for SX1276 Low port and SX1272 in RSSI calculation.
1020+
- Add LMIC library and LMIC debug level (if >0) to print output.
1021+
- Add option to make possible to override in `platformio.ini`, the value of `STM32_POST_INITSERIAL_DELAY_MS` defined in BSF of STM32 boards.
1022+
- Add compile error when ABP is used with Classic LMIC because not compliant, generates downlink message for every uplink message because it does not properly handle MAC commands.
1023+
- For STM32 BSF's surround postInitSerial delay with `#ifdef USE_SERIAL`.
1024+
- In Adafruit Feather M0 LoRa BSF change DIO1 from pin 5 to pin 6 because that is what Adafruit instructs in their tutorial.
1025+
- Fix `ABP_DEVICEID` not being used if defined in `lorawan-keys.h`.
1026+
- Fix offset for RSSI calculation when using MCCI LMIC.
1027+
- Fix printEvent() error when no `USE_DISPLAY` and no `USE_SERIAL` are defined.
1028+
- Known issue: The MCCI LoRaWAN LMIC library has a problem with SerialUSB on the Arduino Zero (USB) board so LMIC debug output cannot be used.
1029+
1030+
**Release v1.0.0 - Initial release**
1031+
1032+
- First release of LMIC-node.
10181033

10191034
---
10201035

0 commit comments

Comments
 (0)