Page History

# Changelog

`app-hybrid-modbus` – Modbus over various WAN technologies.

This changelog's format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres
to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## Planed features
- Execute Modbus Commands per LTE-Downlink
- Modbus TCP (DIN-rail only).
- "auto" wan feature.
- Enhanced dialog mode.

## 0.8.5 - 2023-01-12
### Changed
- Changed LED pattern on battery version. First 15 minutes, the LED will signal 
  sensor/uplink state every 2 seconds. After 15 minutes, it will only blink once 
  every minute (to save battery power).
### Fixed
- Optimise RF-Switch control to reduce power consumption on sleep without losing connection 
  quality during communication.
- Fix upload of Sensus-RF (X-Mode) and Müller Funk (U-Mode) telegrams.
- (battery only): remove high power consumption after collecting wMBus-telegrams.

## 0.8.3 - 2022-12-14
### Fixed
- Fix handling of large batch uploads of wMBus-Telegrams via LTE (batches are now split 
  into multiple uplinks correctly).

## 0.8.2 - 2022-12-12
### Fixed
- Fix LTE-connection issues that could lead to bad reception (DIN-Rail only).

## 0.8.1 - 2022-12-02
### Added
- Add internal testing-registers 8192-9215 (0x2000-0x23ff) with uint16 numbers 0-1023.

## 0.8.0 - 2022-11-28
### Added
- LAN connection to backend (DIN-rail only). Set `WAN` to `ethernet`.
### Fixed
- Do not execute same command twice on App level if received a second time.
- (LoRaWAN) responses to DL-Modbus-Commands (via port 4) are now responded to on 
  port 4, as intended.

## 0.7.3 - 2022-10-07
### Fixed
- Fix broken upload that happened when wired MBus discovery was used and no device was found.
- Fix antenna configuration that was broken on some older hardware revisions (DIN-rail only).

## 0.7.2 - 2022-09-28
### Changed
- Change time sync requests on startup, to better cope with network servers that
  cannot handle time sync requests well. If time sync on initial status message 
  fails, retries on port 0. Gives up after 3 retries.

## 0.7.1 - 2022-09-27
### Fixed
- Fix handling of wMBus telegrams with App-Level ID/Manufacturer.
- Fix handling of Sensus-RF IDs.
- Fix filtering of Sensus-RF (X-Mode) and Mueller-RF (U-Mode) telegrams.
- Fix handling of Qundis IDs on DifVif level.

## 0.7.0 - 2022-09-08
### Added
- Support collection and upload of wMBus telegrams.
### Changed
- Update nordic modem lib to v2.1.3
- Enhanced uplink retries and dial-up logic.
- Use high precision clock when communicating via Modbus. This will make communication
  consistently work with devices  that communicate far outside the proclaimed Baud rate.
- Use language standards C17 and C++20.

## 0.6.1 - 2022-08-22
### Fixed
- Execute confirmation of Firmware and Config change in all configurations.

## 0.6.0 - 2022-08-18
### Changed
- **breaking**: Changed LTE-Uplink format for supporting batch uploads. 
  Individual readouts for all supported data uplink types 
  (`modbus`, `mbus`, `wmbus`) are groups in a cbor-array, that
  is sent under the key `batch`.
- Change LTE dial-up logic and uplink logic, to work better with Firmware concept.
### Added
- Retries (potentially with reconnect) for each Uplink on upload failure.
- Retry/reconnect during FW update, when connection breaks.
- Multiple config-parameters added, that will be used for wireless M-Bus support
  (wMBus mode is still WIP and experimental - parameter names might change in 
  the future).
### Fixed
- Adopt remote config when using LoRaWAN.
- Check for Duty-Cycle for each individual Uplink before uploading for remote command responses
  (did lead to reboots in certain situations).

## 0.5.1 - 2022-05-06
### Changed
- Adjust to changes in Modem driver.
- Adjust to new modem firmware version.
### Fixed
- Fix Modbus with UART 7E1 (was not working in previous version).

## 0.5.0 - 2022-04-19 prerelease 
### Added
- Support wired MBus readout (REQ_UD2) via RS-485 (needs adapter hardware).
- New Config Parameter `MbusCmd`.
- Autodetect feature for discovering wired MBus-Slaves.
- New uplink types `mbus` and `mbus-scan`.
- Caching of Operator/Band LTE parameters after first connection (if not set explicitly).
- Autodetect APN when using special value `*` for APN config parameter (currently working for 1nce cards only).
### Changed
- LTE Modbus uplinks are now identified in envelope by `"q":"modbus"` (was: no `"q"` entry).

## 0.4.0 - 2022-03-17
### Changed
- Change LTE upload format to put Modbus Commands/Responses of a single entry in the same uplink as array (up to 10kB).

## 0.3.1 - 2022-03-16
### Changed
- Increase size usable for config (allow for much bigger config/longer modbus commands).
- Verify on boot that secure firmware is of sufficient version.

## 0.3.0 - 2022-03-11
### Added
- DNS and DTLS support for NB-IoT/LTE-M.
- Revert temporary config (from remote command), if backend cannot be reached.
- Revert temporary firmware (from remote update), if backend cannot be reached.
- Add virtual internal modbus device to bridge, that can be addressed to read internal values
  (current time, internal modem temperature, current voltage) on address 0xfa=250 (configurable).
- New config parameter `InternalAddress`.
- Add Lost Reboot feature for LoRaWAN that resets device if LoRaWAN is network connection is lost.
- New config parameter `LostReboot`.
- (battery only) Add config parameter `ExternalAntenna` to support use of external antenna.
- Feedback for power on self test of modbus commands.
### Changed
- (battery only) Adjust power-off-setting for new addon to avoid leakage.
- Config parameter `Host` now supports optional protocol prefixes `coap://` and `coaps://`.
- Set default host configuration to `coaps://platform.lobaro.com`.
- Add voltage and temperature to LoRaWAN status message.

## 0.2.1 - 2022-02-14
### Added
- Support for LoRaWAN Class C.
- New Config Parameter `OpMode` for selecting Class A or Class C operation mode for LoRaWAN.
- Add Lost-Network feature for LTE.
### Fixed
- Removed double status message uplink on boot for LoRaWAN.

## 0.2.0
### Added
- Support for battery powered hardware variant, using 
  mikrobus-rs485-var nrf-addon-rs485-VBat-rev1.
- (Battery only) Add config parameter `PowerOnDelay` for letting attached slaves power up.

## 0.1.5
### Added
- Allow 8E1 in UART config.

## 0.1.4 - pre-release 2021-11-23
### Added
- Add additional compact LoRaWAN payload formats known from the LoRaWAN Bridge device.
- Add config parameters `PlFmt`, `PlMax`, `PlId` for controlling the LoRaWAN payload format.
### Fixed
- A timing issue could lead to the dialog mode not working properly.

## 0.1.3 - pre-release 2021-11-17
### Added
- Interactive Dialog Mode for testing setups.
- LED feedback about state of Modbus and WAN connections.
- Execute Modbus Commands remotely via LoRaWAN Downlink.

## 0.1.2 - pre-release 2021-11-15
- This is a pre-release! It is neither complete nor fully tested!
### Added
- Support for NB-IoT, LTE-M, and LoRaWAN.
- Downlinks for remote config (all WAN technologies) and firmware updates (NB-IoT and LTE-M only)
### Dependencies
- Boot Firmware >=1.7.1
- Modem Firmware >=1.2.0

## 0.1.0 - 2021-07-02
### Added
- Start new app for Hybrid NB-IoT/LoRaWAN Modbus Gateway.