Jump to content

Template:Boilerplate-Firmware-Changelog: Difference between revisions

From SOJI ELECTRONICS
[checked revision][checked revision]
Created page with "<noinclude> {{TemplateData |description=Boilerplate for product Firmware Changelog page. Follows Keep a Changelog standard + Semantic Versioning. }} </noinclude><includeonly> == Description == This page lists all firmware releases for the [Product Name] product line. The changelog follows the [https://keepachangelog.com Keep a Changelog] standard and uses [https://semver.org Semantic Versioning] (MAJOR.MINOR.PATCH). For firmware update procedure, see {{SUBPAGENAME}}..."
 
No edit summary
Line 59: Line 59:
== Version History ==
== Version History ==


=== v1.2.0 2026-05-01 ===
{| class="wikitable sortable" style="width:100%; font-size:0.95em"
{{FW-Type|Stable}} {{FW-Status|Recommended}}
|-
 
! style="width:7%"  | Version
'''Download:''' [[Media:Product-Firmware-v1.2.0.zip|Product-Firmware-v1.2.0.zip]] (CRC32: XXXXXXXX)
! style="width:8%"  | Date
 
! style="width:8%"  | Type
==== Added ====
! style="width:10%" | Status
* New BLE pairing mode (fast-connect) reduces pairing time by 60%
! style="background:#4CAF50; color:white"  | Added
* Support for external temperature probe via 1-Wire interface
! style="background:#2196F3; color:white"  | Changed
* Configurable sampling rate (1Hz / 5Hz / 10Hz) via configuration tool
! style="background:#FFC107; color:black"  | Fixed
 
! style="background:#F44336; color:white"  | Security
==== Changed ====
! style="background:#9E9E9E; color:white"  | Known Issues
* Increased measurement accuracy from ±0.5% to ±0.3% (full-scale)
! style="width:8%" | Download
* Optimized power consumption in sleep mode (-15%)
|-
 
| '''1.2.0'''
==== Fixed ====
| 2026-05-01
* Fixed occasional BLE disconnection after 30+ days uptime ([[LIGO Air PCN-2025-002|PCN-2025-002]])
| {{FW-Type|Stable}}
* Resolved memory leak in logging subsystem causing reboot after ~14 days
| {{FW-Status|Recommended}}
* Fixed incorrect temperature compensation at -20°C to -30°C range
|
 
* BLE fast-connect pairing (-60% time)
==== Security ====
* External 1-Wire temperature probe
* Updated BLE pairing to use LE Secure Connections (replaces legacy pairing)
* Configurable sampling rate (1/5/10 Hz)
* Fixed potential buffer overflow in firmware update routine (CVE-2026-XXXX)
|
 
* Accuracy ±0.5% ±0.3% (full-scale)
==== Known Issues ====
* Sleep power consumption −15%
* OTA update may fail on iOS 17.4.1 (workaround: use Android or USB update)
|
* Calibration UI button occasionally unresponsive (fix planned for v1.2.1)
* BLE disconnect after 30+ days uptime [[LIGO Air PCN-2025-002|PCN-2025-002]]
 
* Memory leak in logging causing reboot
==== Migration Notes ====
* Temperature compensation at −20 to −30 °C
* '''Recommended upgrade from''' v1.1.0 or v1.1.2
|
* '''Configuration reset:''' Not required, settings preserved
* LE Secure Connections (replaces legacy pairing)
* '''Calibration:''' Not required, sensor coefficients preserved
* Buffer overflow in OTA routine (CVE-2026-XXXX)
* '''Downgrade:''' Supported back to v1.1.0 (older versions require factory reset)
|
 
* OTA fails on iOS 17.4.1 use Android/USB
---
* Calibration UI button unresponsive
 
| [[Media:Product-Firmware-v1.2.0.zip|v1.2.0 ZIP]]
=== v1.1.2 — 2026-03-20 ===
|-
{{FW-Type|Stable}} {{FW-Status|Supported}}
| '''1.1.2'''
 
| 2026-03-20
'''Download:''' [[Media:Product-Firmware-v1.1.2.zip|Product-Firmware-v1.1.2.zip]] (CRC32: XXXXXXXX)
| {{FW-Type|Stable}}
 
| {{FW-Status|Supported}}
==== Fixed ====
|
* Hot-fix for boot loop on hardware revision Rev B (date code 2602 onwards)
|
* Corrected time drift after RTC battery low warning
|
 
* Boot loop on HW Rev B (date code 2602+)
==== Migration Notes ====
* Time drift after RTC battery low
* Mandatory upgrade for units with hardware Rev B
| —
* Settings preserved, no configuration reset needed
| —
 
| [[Media:Product-Firmware-v1.1.2.zip|v1.1.2 ZIP]]
---
|-
 
| '''1.1.0'''
=== v1.1.0 2026-02-15 ===
| 2026-02-15
{{FW-Type|Stable}} {{FW-Status|Supported}}
| {{FW-Type|Stable}}
 
| {{FW-Status|Supported}}
'''Download:''' [[Media:Product-Firmware-v1.1.0.zip|Product-Firmware-v1.1.0.zip]] (CRC32: XXXXXXXX)
|
 
* Support for HW Rev B (improved antenna)
==== Added ====
* Diagnostic mode (long-press 5s)
* Support for hardware revision Rev B (improved antenna)
|
* Diagnostic mode accessible via long-press button (5 seconds)
* Default BLE TX power +4 0 dBm
 
|
==== Changed ====
* Battery % reporting below 20%
* Default BLE TX power reduced from +4 dBm to 0 dBm (regulatory compliance)
* Sporadic disconnect in high-interference env
 
| —
==== Fixed ====
|
* Fixed incorrect battery percentage reporting below 20%
* Boot loop on certain Rev B → fixed in 1.1.2
* Resolved sporadic disconnection in high-interference environments
| [[Media:Product-Firmware-v1.1.0.zip|v1.1.0 ZIP]]
 
|-
==== Known Issues ====
| '''1.0.0'''
* Boot loop on certain Rev B units → fixed in v1.1.2 (recommend upgrading)
| 2025-12-01
 
| {{FW-Type|Stable}}
---
| {{FW-Status|Deprecated}}
 
|
=== v1.0.0 2025-12-01 ===
{{FW-Type|Stable}} {{FW-Status|Deprecated}}
 
'''Download:''' [[Media:Product-Firmware-v1.0.0.zip|Product-Firmware-v1.0.0.zip]] (CRC32: XXXXXXXX)
 
==== Added ====
* Initial production release
* Initial production release
* BLE 5.0 connectivity
* BLE 5.0 connectivity
* USB configuration interface
* USB configuration interface
* Battery level reporting
* Battery level reporting
* Standard measurement modes (continuous, on-demand, scheduled)
* Measurement modes (continuous / on-demand / scheduled)
 
| —
==== Known Issues ====
| —
* Battery percentage reporting inaccurate below 20% → fixed in v1.1.0
| —
 
|
---
* Battery % inaccurate < 20% → fixed in 1.1.0
 
| [[Media:Product-Firmware-v1.0.0.zip|v1.0.0 ZIP]]
=== v0.9.0 2025-10-10 ===
|-
{{FW-Type|Beta}} {{FW-Status|EOL}}
| '''0.9.0'''
 
| 2025-10-10
'''Download:''' Not publicly available (engineering samples only)
| {{FW-Type|Beta}}
| {{FW-Status|EOL}}
| ''Pre-production beta — engineering samples only''
| —
| —
| —
| —
| —
|}


==== Note ====
=== Migration Notes ===
* Pre-production beta firmware. Not intended for production use.
Chú ý đặc biệt khi upgrade giữa các version:
* All units shipped with v0.9.0 should be updated to v1.0.0 or later.


== Update Procedure ==
{| class="wikitable"
For step-by-step firmware update instructions, see:
|-
* [[{{SUBPAGENAME}} User Guide#Firmware Update|User Guide Firmware Update]]
! From → To !! Settings Preserved? !! Calibration Reset? !! Downgrade Path !! Notes
* [[Media:Product-FW-Update-Guide.pdf|Quick Update Guide (PDF)]]
|-
| 1.1.x → 1.2.0 || ✅ Yes || ❌ No || Supported back to 1.1.0
|
* Recommended upgrade
* OTA + USB both supported
|-
| 1.1.0 1.1.2 || ✅ Yes || ❌ No || ✅ Supported
|
* '''Mandatory''' for HW Rev B units
|-
| 1.0.0 → 1.1.0 || ✅ Yes || ❌ No || ✅ Supported
|
* HW Rev B requires firmware ≥ 1.1.2 instead
|-
| 0.9.x → 1.0.0 || ❌ Factory reset required || ✅ Yes (re-calibrate) || ❌ Not supported
|
* Engineering samples only
|}


'''Update methods supported:'''
=== Removed & Deprecated ===
* USB (cabled, via configuration tool)
Tính năng đã bỏ hoặc sắp bỏ — khách hàng nên migrate khỏi:
* OTA via BLE (mobile app)
* OTA via WiFi (for connected models)


'''Update time:''' ~30-60 seconds per device.
{| class="wikitable"
|-
! Feature !! Status !! Since !! Removed In !! Alternative
|-
| Legacy BLE pairing (without LE SC) || {{FW-Status|Deprecated}} || 1.2.0 || 2.0.0 (planned) || Use LE Secure Connections
|-
| Old AT command set v1 || {{FW-Status|Deprecated}} || 1.1.0 || 1.3.0 (planned) || Migrate to AT v2 (see [[Configuration#AT Commands]])
|-
| HTTP cloud reporting || ❌ Removed || — || 1.2.0 || Use MQTT (see [[Configuration#MQTT]])
|}


== Compatibility ==
== Compatibility ==

Revision as of 04:33, 15 May 2026

SOJI Electronics