device-version-notes.json

{
  "notes": [
    {
      "id": "open-collar-8-2-0-beta",
      "title": "Open Collar 8.2.0: pre-release build (beta)",
      "appliesTo": {
        "fwVersions": [
          "8.2.0"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Beta: this firmware is not released yet and is flashed manually; the app offers no built-in DFU for it. The app treats a device reporting 8.1 or newer as this firmware.",
        "Added: LP0 offload clusters. A tracker sends its saved records over LoRa to an offload station, which stores them on a microSD card. The LP0 offload panel and card in this app are only shown on this firmware.",
        "Added: log transfers by delivery state. Every saved record remembers over which medium it was confirmed received (Bluetooth, LoRaWAN, LP0 station, satellite). The Logs card can download only the records not yet downloaded over Bluetooth, and the LP0 card can delete the logs that were confirmed over a chosen medium.",
        "Added settings: lp0_master_key (one random key per cluster), lp0_signal_checks, lp0_focus_offloading, lp0_statistics_interval, lp0_gps_before_start (a station takes a u-blox GPS fix before offloading so its clock is set), lp0_discovery_retry_count (extra discovery attempts per interval, 0 by default), lr_enabled (LoRaWAN master switch) and ublox_require_time.",
        "Added commands: start transfer (0xCF), cancel transfer (0xD1), delete confirmed logs (0xD2), recover SD card (0xD3).",
        "Added message: LP0 station statistics on port 23 (id 0x9D, version 3 with the SD card state), decoded in the Logs card and shown as the station status in the LP0 offload card.",
        "Changed defaults: flash_store_flag and lp0_send_flag include port 23 (a device updated from 8.0 keeps its saved masks); the LP0 background signal margin check is off by default (lp0_signal_checks 1 1 1 100 0 20); the minimum RSSI check defaults to -100 dBm.",
        "Changed: the first boot of this firmware clears all stored logs (new log format with delivery flags); export the logs before updating. AirQ builds carry S-Band only, without LP0 offloading or SD card support.",
        "Settings schema: scripts/settings/settings.json of branch fix/existing-lp0-implementation at commit 4b58e4f (2026-11-04), bundled as settings-v8.2.0.json. Replace it when the 8.2.0 release asset appears."
      ]
    },
    {
      "id": "open-collar-8-0-0-settings",
      "title": "Open Collar 8.0.0 settings migration",
      "appliesTo": {
        "fwVersionMin": "8.0.0",
        "fwVersionMax": null,
        "fwVersions": [],
        "hwVersions": [],
        "hwTypes": []
      },
      "body": [
        "The firmware automatically migrates saved settings to the new family-based storage format.",
        "Export a settings profile before changing firmware. Downgrading to firmware v7.3 or earlier can restore defaults because those versions use the old storage addresses."
      ]
    },
    {
      "id": "flash-get-from-head-offset",
      "title": "Flash logs: CMD_FLASH_GET_FROM_HEAD start offset bug",
      "appliesTo": {
        "fwVersions": [
          "4.4.2",
          "5.0.1",
          "6.8.1",
          "6.9.0",
          "6.10.0",
          "6.11.0",
          "6.12.1",
          "6.14.1",
          "6.15.0"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Bug: the start index is shifted by the requested count.",
        "Impact: a request for start X and count N is treated as start X+N.",
        "Workaround: for the latest N entries, use start=0 and count=N."
      ]
    },
    {
      "id": "firmware-test-warning",
      "title": "Firmware status: test build",
      "appliesTo": {
        "fwVersions": [
          "7.0.0"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "This firmware is a test build.",
        "Expect incomplete or unstable behavior."
      ]
    },
    {
      "id": "open-collar-7-1-0-release-notes",
      "title": "Open Collar 7.1.0 release notes",
      "appliesTo": {
        "fwVersions": [
          "7.1.0"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Added: external switch user-configurable power control (toggle external switch power on/off).",
        "Added: LoRa TX/RX tests in provisioning firmware.",
        "Added: flash size printout as a separate provisioning test.",
        "Added: freeedge_nrf52840 v1.6.0 board files with ambiguous flash support.",
        "Added: collaredge_nrf52840 v1.5.0 board files with ambiguous flash support.",
        "Added: RF front end module as a standalone module in a separate lib folder.",
        "Fixed: AirQ report-sending interval overflow.",
        "Fixed: flash read from head now starts at the specified message.",
        "Fixed: external switch GPIO pin initialization.",
        "Fixed: unnecessary uart0 (serial-uart) toggling when sending s-band messages.",
        "Removed: RF scanner and related components (RF Open Sky Detection, EWMA partition).",
        "AirQ: rangeredge_airq_nrf52840 is a use-case-specific build with an external I2C board (BME690, BMV080); to fit firmware size, it disables non-EU868 LoRa regions, BT_CMDQ, RF scanning/Open Sky Detection, and outdoor detection.",
        "AirQ DFU files: see air_quality-v7.1.0."
      ]
    },
    {
      "id": "open-collar-7-2-0-release-notes",
      "title": "Open Collar 7.2.0 release notes",
      "appliesTo": {
        "fwVersions": [
          "7.2.0"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Added: SDFS UART (SD card writer) module and sample.",
        "Added: updates to main README.md.",
        "Added: support for multiple LED colors (magenta, yellow, and cyan).",
        "Added: LP0 lib with packetization and communication modules.",
        "Added: LP0 feature in main app for ABP message sending and offloading logic.",
        "Fixed: device rebooting on ungraceful Bluetooth disconnection (for example when out of range).",
        "Removed: remaining RF Open Sky detection user settings not removed in v7.1.0.",
        "DFU files: see open-collar-v7.2.0."
      ]
    },
    {
      "id": "open-collar-8-0-1-release-notes",
      "title": "Open Collar 8.0.1 release notes",
      "appliesTo": {
        "fwVersions": [
          "8.0.1"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Fixed: GPS time is validated from a single fresh NAV-PVT epoch, and large corrections are confirmed with consecutive readings.",
        "Fixed: the application clock can recover from future timestamps; clock reference updates and reads are serialized.",
        "Settings: the v8.0.1 settings schema is identical to v8.0.0.",
        "DFU files: see open-collar-v8.0.1.",
        "AirQ DFU files: see air-quality-v8.0.1."
      ]
    },
    {
      "id": "open-collar-8-0-2-release-notes",
      "title": "Open Collar 8.0.2 release notes",
      "appliesTo": {
        "fwVersions": [
          "8.0.2"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Fixed: device_eui is no longer overwritten with zeros after restoring a LoRaWAN session; the chip EUI is read and the stored value is kept on invalid reads.",
        "Fixed: settings migration no longer fails on legacy settings with incompatible lengths; those entries are deleted and migration continues.",
        "Fixed: legacy numeric and boolean settings are validated against current min/max limits during migration; out-of-range values are replaced with compiled defaults.",
        "Fixed: the GPS minimum-satellites timer (legacy ID 0x38) and external-switch power setting (legacy ID 0x60) are reset to compiled defaults when migrating from older firmware, even when the stored values look valid.",
        "Settings: the v8.0.2 settings schema is identical to v8.0.0 and v8.0.1.",
        "DFU files: not bundled; update to 8.0.3 instead (open-collar-v8.0.3 and air-quality-v8.0.3), which fixes the missing error_ublox status flag."
      ]
    },
    {
      "id": "open-collar-8-0-3-release-notes",
      "title": "Open Collar 8.0.3 release notes",
      "appliesTo": {
        "fwVersions": [
          "8.0.3"
        ],
        "fwVersionMin": null,
        "fwVersionMax": null,
        "hwVersions": [],
        "hwVersionMin": null,
        "hwVersionMax": null,
        "hwTypes": []
      },
      "body": [
        "Fixed: error_ublox is reported in status messages again when the automatic GPS fix retries are exhausted.",
        "Fixed: error_ublox is cleared when the retries are restarted on an enabled receiver or a later fix succeeds.",
        "Settings: the v8.0.3 settings schema is identical to v8.0.0, v8.0.1 and v8.0.2.",
        "DFU files: see open-collar-v8.0.3.",
        "AirQ DFU files: see air-quality-v8.0.3."
      ]
    }
  ]
}