app-nrf9160-wmbus – collect wMBus telegrams via NB-IoT/LTE-M

This changelog's format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.11.2 - 2022-01-04

Changed

• Reduce program size (no functional changes).

0.11.1 - 2022-01-03

Changed

• Default Configuration now uses LoRaWAN 1.0 exclusively (was LoRaWAN 1.1 with fallback to 1.0).

Fixed

• Fix some issues with LoRaWAN that could prevent Device from working when configured to use LoRaWAN.

0.11.0 - 2021-12-23

Changed

• Switch to use new Hash Store for saving wMBus telegrams (faster, no hard limit on number of telegrams).
• Allow use of external RAM for wMBus store.
• Handling of telegram filters sped up significantly.

Added

• New config parameter ExtRam for making firmware use optionally soldered external SRAM.
• New config parameter verbose for activating more logging messages (reduces device's efficiency).

0.10.1 - 2021-12-06

Added

• Upload of usage statistics with every status message.

0.10.0 - pre-release 2021-12-03

Added

• Add DNS support for platform configuration.
• Multiple values for Host (fallback options).
• DNS-Server configuration (parameter DNS).
• Extend "Lost Reboot" feature to restart after 24h+ network loss.
• For GW v3: New parameter externalAntenna
• Use stored factory test result in boot up testing (written by provisioning firmware).

Changed

• Remove parameter Port (now part of Host)
• "Lost Reboot" feature now also triggers if mobile network is unreachable.

0.9.4 - 2021-11-05

Changed

• Adjust wMBus parameters to better receive som DME meters.

0.9.3 - 2021-11-04

Fixed

• Fix a rare crash in wmbus-Stack

0.9.2 - 2021-10-19

Added

• Support new format for device parameters in log.
• Support for new board nrf9160-sx-gw2 (GW V3).

Dependencies

• Boot Firmware >=1.7.1
• Modem Firmware >=1.1.0

0.9.1 - 2021-10-07

Fixed

• Fix a bug where receiving many long telegrams could lead to an assert.

Changed

• Reduce CoAP log to speed up upload.

0.9.0 - 2021-09-14

Added

• Implement new low voltage protection: reboot on consistent low voltage during normal operations. On boot: turn off device completely when voltage is too low (multiple measurements taken).
• Critical voltage: 2.7V
• Introduce new filter for CI-Field in wMBus-Telegrams.

Changed

• Update boot Firmware to 1.7.0
• Update integrated mcuBoot Firmware to 1.3.0 (supports older versions)

Dependencies

• Boot Firmware >=1.7.0
• Modem Firmware >=1.1.0

0.8.8 - 2021-07-29

Fixed

• Reactivate UDP config (was falsely deactivated in recent release).

Dependencies

• Boot Firmware >=1.6.0
• Modem Firmware >=1.1.0

0.8.7 - 2021-06-08

Fixed

• Fix a memory problem introduced in 0.8.6.

0.8.6 - 2021-05-12

Changed

• Use inner ID and Type for Telegrams with CI 0x72 (repeaters)
• Update nrf9160 HAL

0.8.5 - 2021-04-26

Changed

• Internal changes on how band lock is executed.

0.8.4 - 2021-03-26 (unreleased)

Changed

• Internal changes on how band lock is executed.

0.8.0 - 2021-02-25 (prerelease)

Added

• Full support for LoRaWAN as in dedicated lorawan wmbus bridge. Device can run in two different modes: lte to connect either via NB-IoT or LTE-M, lorawan to connect via LoRaWAN.
• New Config Parameter WAN with values lte and lorawan to change between modes.
• New Config Parameters for LoRaWAN: OTAA, DevEUI, JoinEUI, AppKey, NwkKey, TimeSync, RndDelay, LostReboot, PayloadFormat.
• time information in LTE Status Message.

Fixed

• Filter list for Sensus-RF now supports IDs with prefixes other than 10.

Changed

• Sensus-RF IDs for Filter list must now be given full as 11 digits (without dashes -).

Removed

• Drop support for Hardware Revision HW1.

0.7.2 - 2021-01-27

Added

• Support for Xylem Sensus RF Bubbel Up Telegrams (X-Mode)
• New Config Parameter: xmodeDurSec

Changed

• Config Parameter devFilter now also accepts Sensus RF Meter IDs (9 or 11 digits, no dashes. First two digits of ID are optional and will be ignored).
• Add value mode to telegram upload indicating mode used during reception. Values: C, T, S, X
• Add value type to telegram upload indicating telegram's type. Values: A, B, X

0.7.1 - unreleased

Added

• Include diagnostic information about time syncing.

0.7.0 - 2021-01-14

Changed

• Only support Bands 8 and 20.

Added

• New config parameter PIN to support SIM cards that require a PIN (no support for entering PUK).
• Support for LoRaWAN as alternative upload technology on HW revision 2 (OTAA only) -- activated on special request only!.

0.6.10 - 2020-12-17

Fixed

• Fix filtering of telegrams by manufacturer ID for telegrams that use a non globally unique address (highest bit in M-Field set to 1).

0.6.9 - 2020-10-27

Added

• Include new information in status message: collected indicates if telegrams have just been collected on this activation, telegrams says how many telegrams have been collected on last collection, uploading indicates how many telegrams will be uploaded following this status message (this helps in diagnosing connection lost during upload of telegrams and continuation of transmission on next status upload).

Changed

• Set default config value for listenCron to 0 0 12 * * * to have a value that does not drain your battery too but gives you the ability to queue a downlink for the current day during your office hours. Also collecting during day, because some meters do not send during night hours.
• When uploading telegrams, always send status message first as well.

Fixed

• Fix a bug that prevented the reception of certain wMBus-Telegrams C-Mode Class-A (valid telegrams of a certain length where falsely rejected as having an invalid CRC).
• Fix an issue triggered by certain unusual bytes in the air that could lead to temporary problems on wMBus reception (that could result in receivable telegrams not being received).
• Continuation of failed uploads on next status activation was losing the telegram that failed to upload. Now it will be retransmitted.

0.6.8 - 2020-09-25

Fixed

• Fix handling of Type B Telegrams.

0.6.7 - 2020-09-17

Changed

• Failed data uploads will be retried to upload along with status messages. There will be no new collection for this; telegrams are only collected on data cron (and after boot). On upload failure, collected data is kept until it is uploaded during status or until data cron activates again (if there is still pending data from last activation, that is dropped).

Fixed

• Also evaluate server requests after Status Message only uploads.

0.6.6 - 2020-09-09

Changed

• Enhance timing on handling of incoming wMBus telegrams, so we are less likely to miss any.

0.6.5 - 2020-09-08

Added

• Support CoAP blockwise to enable up-/downloading huge device configs.
• Human readable logging of CoAP options

Changed

• Evaluate downlink after every uplink during telegram upload.
• Only output printable chars in log during CoAP communication

0.6.4 - 2020-08-27

Changed

• Increased size for CoAP buffer to enable upload of config in max size.

0.6.1 - 2020-08-25

Added

• Evaluate downlinks on bootup (after all initial uplinks are sent).

0.6.0 - 2020-08-24

Added

• Daily status uplink to CoAP backend, independent of configuration.
• Initial status uplink to CoAP backend after boot, before initial collection.
• Parsable meta information like connection quality etc (CBOR).

Fixed

• Validate all config values before operation starts (cron was missing in validation)

0.5.6 - 2020-07-14

Changed

• Revert too restrict 3of6 decoding size check
• Use task notification again in virq for more efficiency since it did not affect HF problem

0.5.5 - 2020-07-13

Changed

• Use Newlib allocator for freeRTOS
• Set stack and heap sizes in cmake file of app
• Use queue for sx1272 irq to task synchronisation instead of task notifications before

0.5.4 - 2020-07-08

Changed

• Start lobcom frame counter at 1, not at 0
• Remove diagnostic logs, change version number for release.

0.5.3 - 2020-07-07

Added

• Support new dedicated hardware HW2
• Reboot when losing connection to network (in case modem is stuck)
• Add optional upload per raw UDP (without coap) to alternate address

Changed

• Support only LTE-M/NB-IoT in firmware as supported by current hardware
• Increase config size, up to 175 device IDs
• Disable modem on initial wMBus collection to enhance reception quality

0.4.0 - 2020-05-15

Added

• Start changelog.

Fixed

• Make Firmware work with nrf-Board 1.4 (fix power on logic for module).

Changed

• Removed learning mode.