|
|
| (25 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| <noinclude> | | <noinclude> |
| {{TemplateData | | {{TemplateData |
| |description=Boilerplate for product Firmware Changelog page. Follows Keep a Changelog standard + Semantic Versioning. | | |description=Boilerplate for product Firmware Changelog page. |
| }} | | }} |
| </noinclude><includeonly>
| |
|
| |
|
| == Description == | | 4 mandatory sections (== H2 ==): |
| 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).
| | # Description |
| | # Version History |
| | # Compatibility |
| | # Related Pages |
|
| |
|
| For firmware update procedure, see [[{{SUBPAGENAME}} User Guide#Firmware Update|User Guide → Firmware Update]].
| | [[Category:Boilerplates]] |
| | </noinclude><includeonly>== Description == |
| | <div class="dim"> |
|
| |
|
| == Latest Stable Release ==
| | ''Brief intro to the firmware changelog per Keep a Changelog standard.'' |
| {| class="wikitable" style="width:100%; margin-bottom:20px"
| |
| |-
| |
| ! style="width:25%; background:#0054A6; color:white" | Version
| |
| | '''v1.2.0'''
| |
| |-
| |
| ! style="background:#0054A6; color:white" | Release Date
| |
| | 2026-05-01
| |
| |-
| |
| ! style="background:#0054A6; color:white" | Type
| |
| | {{FW-Type|Stable}}
| |
| |-
| |
| ! style="background:#0054A6; color:white" | Status
| |
| | {{FW-Status|Recommended}}
| |
| |-
| |
| ! style="background:#0054A6; color:white" | Download
| |
| | [[Media:Product-Firmware-v1.2.0.zip|Firmware v1.2.0 (ZIP)]]
| |
| |-
| |
| ! style="background:#0054A6; color:white" | Release Notes
| |
| | [[#v1.2.0 .E2.80.94 2026-05-01|Jump to v1.2.0]]
| |
| |}
| |
|
| |
|
| == Version Summary ==
| | '''What to fill in:''' |
| {| class="wikitable sortable" style="width:100%"
| | * 1–2 paragraph intro explaining the purpose of this page |
| |-
| | * Specify which product line this firmware changelog covers |
| ! Version !! Release Date !! Type !! Status !! Download !! Release Notes
| | * Mention the standards used: |
| |-
| | ** [https://keepachangelog.com Keep a Changelog] for format |
| | 1.2.0 || 2026-05-01 || {{FW-Type|Stable}} || {{FW-Status|Recommended}} || [[Media:Product-Firmware-v1.2.0.zip|ZIP]] || [[#v1.2.0 — 2026-05-01|View]]
| | ** [https://semver.org Semantic Versioning] (MAJOR.MINOR.PATCH) for version numbering |
| |-
| | * Note how firmware files are distributed (authorized partners, downloadable links, etc.) |
| | 1.1.2 || 2026-03-20 || {{FW-Type|Stable}} || {{FW-Status|Supported}} || [[Media:Product-Firmware-v1.1.2.zip|ZIP]] || [[#v1.1.2 — 2026-03-20|View]]
| |
| |-
| |
| | 1.1.0 || 2026-02-15 || {{FW-Type|Stable}} || {{FW-Status|Supported}} || [[Media:Product-Firmware-v1.1.0.zip|ZIP]] || [[#v1.1.0 — 2026-02-15|View]]
| |
| |-
| |
| | 1.0.0 || 2025-12-01 || {{FW-Type|Stable}} || {{FW-Status|Deprecated}} || [[Media:Product-Firmware-v1.0.0.zip|ZIP]] || [[#v1.0.0 — 2025-12-01|View]]
| |
| |-
| |
| | 0.9.0 || 2025-10-10 || {{FW-Type|Beta}} || {{FW-Status|EOL}} || — || [[#v0.9.0 — 2025-10-10|View]]
| |
| |}
| |
|
| |
|
| == Versioning Scheme ==
| | '''Example structure:''' "This page lists all firmware releases for the [Product Name] [type]. The changelog follows the Keep a Changelog standard and uses Semantic Versioning (MAJOR.MINOR.PATCH). Firmware files are distributed via authorized SOJI partners — contact your sales representative for access." |
| Firmware versions follow Semantic Versioning '''MAJOR.MINOR.PATCH''':
| |
|
| |
|
| * '''MAJOR''' — Incompatible API/protocol changes, requires re-qualification
| | </div> |
| * '''MINOR''' — New features, backward-compatible
| |
| * '''PATCH''' — Bug fixes only, fully backward-compatible
| |
| | |
| Pre-release versions use suffix: ''-alpha.N'', ''-beta.N'', ''-rc.N''.
| |
|
| |
|
| == Version History == | | == Version History == |
| | <div class="dim"> |
|
| |
|
| === v1.2.0 — 2026-05-01 ===
| | ''Chronological list of all firmware releases (most recent first).'' |
| {{FW-Type|Stable}} {{FW-Status|Recommended}}
| |
|
| |
|
| '''Download:''' [[Media:Product-Firmware-v1.2.0.zip|Product-Firmware-v1.2.0.zip]] (CRC32: XXXXXXXX) | | '''What to fill in:''' sortable table with columns: |
| | * '''Version''' — version number per SemVer (e.g., '''1.2.0''', '''1.1.2''') |
| | * '''Date''' — release date (YYYY-MM-DD) |
| | * '''Description''' — bullet list grouped by change category |
|
| |
|
| ==== Added ====
| | '''Description format — use these standard categories:''' |
| * New BLE pairing mode (fast-connect) reduces pairing time by 60% | | * <code><nowiki>* '''Added'''</nowiki></code> — new features |
| * Support for external temperature probe via 1-Wire interface | | * <code><nowiki>* '''Changed'''</nowiki></code> — behavior changes / improvements |
| * Configurable sampling rate (1Hz / 5Hz / 10Hz) via configuration tool | | * <code><nowiki>* '''Fixed'''</nowiki></code> — bug fixes (link to PCN if applicable) |
| | * <code><nowiki>* '''Security'''</nowiki></code> — security patches (include CVE if applicable) |
| | * <code><nowiki>* '''Known Issues'''</nowiki></code> — limitations with workarounds |
| | * <code><nowiki>* '''Deprecated'''</nowiki></code> — features being phased out |
| | * <code><nowiki>* '''Removed'''</nowiki></code> — features removed in this version |
|
| |
|
| ==== Changed ====
| | '''Versioning rules:''' |
| * Increased measurement accuracy from ±0.5% to ±0.3% (full-scale) | | * MAJOR — incompatible API/protocol changes (requires re-qualification) |
| * Optimized power consumption in sleep mode (-15%) | | * MINOR — new features, backward-compatible |
| | * PATCH — bug fixes only |
| | * Pre-release — append <code>-alpha.N</code>, <code>-beta.N</code>, <code>-rc.N</code> |
|
| |
|
| ==== Fixed ====
| | '''How to add a new version:''' copy a row block (from <code>|-</code> to next <code>|-</code>) and paste at top of table. Update Version, Date, and Description fields. |
| * Fixed occasional BLE disconnection after 30+ days uptime ([[LIGO Air PCN-2025-002|PCN-2025-002]])
| |
| * Resolved memory leak in logging subsystem causing reboot after ~14 days
| |
| * Fixed incorrect temperature compensation at -20°C to -30°C range
| |
|
| |
|
| ==== Security ====
| | </div> |
| * Updated BLE pairing to use LE Secure Connections (replaces legacy pairing)
| |
| * Fixed potential buffer overflow in firmware update routine (CVE-2026-XXXX)
| |
|
| |
|
| ==== Known Issues ==== | | == Compatibility == |
| * OTA update may fail on iOS 17.4.1 (workaround: use Android or USB update)
| | <div class="dim"> |
| * Calibration UI button occasionally unresponsive (fix planned for v1.2.1)
| |
| | |
| ==== Migration Notes ====
| |
| * '''Recommended upgrade from''' v1.1.0 or v1.1.2
| |
| * '''Configuration reset:''' Not required, settings preserved
| |
| * '''Calibration:''' Not required, sensor coefficients preserved
| |
| * '''Downgrade:''' Supported back to v1.1.0 (older versions require factory reset)
| |
|
| |
|
| ---
| | ''Matrix showing which firmware versions work on which hardware revisions.'' |
|
| |
|
| === v1.1.2 — 2026-03-20 ===
| | '''What to fill in:''' table with columns: |
| {{FW-Type|Stable}} {{FW-Status|Supported}}
| | * '''Firmware Version''' — version number |
| | * '''Hardware Rev A''', '''Rev B''', '''Rev C''', etc. — one column per hardware revision |
|
| |
|
| '''Download:''' [[Media:Product-Firmware-v1.1.2.zip|Product-Firmware-v1.1.2.zip]] (CRC32: XXXXXXXX) | | '''Status indicators:''' |
| | * ✅ Supported — works without issues |
| | * ⚠️ Known issue — works but has documented bug |
| | * ❌ Not supported — incompatible |
|
| |
|
| ==== Fixed ====
| | '''Note:''' Add as many hardware revision columns as your product has. Remove unused columns. |
| * Hot-fix for boot loop on hardware revision Rev B (date code 2602 onwards)
| |
| * Corrected time drift after RTC battery low warning
| |
| | |
| ==== Migration Notes ====
| |
| * Mandatory upgrade for units with hardware Rev B
| |
| * Settings preserved, no configuration reset needed
| |
| | |
| ---
| |
| | |
| === v1.1.0 — 2026-02-15 ===
| |
| {{FW-Type|Stable}} {{FW-Status|Supported}}
| |
| | |
| '''Download:''' [[Media:Product-Firmware-v1.1.0.zip|Product-Firmware-v1.1.0.zip]] (CRC32: XXXXXXXX) | |
| | |
| ==== Added ====
| |
| * Support for hardware revision Rev B (improved antenna)
| |
| * Diagnostic mode accessible via long-press button (5 seconds)
| |
| | |
| ==== Changed ====
| |
| * Default BLE TX power reduced from +4 dBm to 0 dBm (regulatory compliance)
| |
| | |
| ==== Fixed ====
| |
| * Fixed incorrect battery percentage reporting below 20%
| |
| * Resolved sporadic disconnection in high-interference environments
| |
| | |
| ==== Known Issues ====
| |
| * Boot loop on certain Rev B units → fixed in v1.1.2 (recommend upgrading)
| |
| | |
| ---
| |
| | |
| === 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
| |
| * BLE 5.0 connectivity
| |
| * USB configuration interface
| |
| * Battery level reporting
| |
| * Standard measurement modes (continuous, on-demand, scheduled)
| |
| | |
| ==== Known Issues ====
| |
| * Battery percentage reporting inaccurate below 20% → fixed in v1.1.0
| |
| | |
| ---
| |
| | |
| === v0.9.0 — 2025-10-10 ===
| |
| {{FW-Type|Beta}} {{FW-Status|EOL}}
| |
| | |
| '''Download:''' Not publicly available (engineering samples only)
| |
| | |
| ==== Note ====
| |
| * Pre-production beta firmware. Not intended for production use.
| |
| * All units shipped with v0.9.0 should be updated to v1.0.0 or later.
| |
| | |
| == Update Procedure ==
| |
| For step-by-step firmware update instructions, see:
| |
| * [[{{SUBPAGENAME}} User Guide#Firmware Update|User Guide → Firmware Update]]
| |
| * [[Media:Product-FW-Update-Guide.pdf|Quick Update Guide (PDF)]]
| |
| | |
| '''Update methods supported:'''
| |
| * USB (cabled, via configuration tool)
| |
| * OTA via BLE (mobile app)
| |
| * OTA via WiFi (for connected models)
| |
| | |
| '''Update time:''' ~30-60 seconds per device.
| |
| | |
| == Compatibility ==
| |
| {| class="wikitable"
| |
| |-
| |
| ! Firmware Version !! Hardware Rev A !! Hardware Rev B !! Hardware Rev C
| |
| |-
| |
| | 1.2.0 || ✅ Supported || ✅ Supported || ✅ Supported
| |
| |-
| |
| | 1.1.2 || ✅ Supported || ✅ Supported || ❌ Not supported
| |
| |-
| |
| | 1.1.0 || ✅ Supported || ⚠️ Boot loop bug || ❌ Not supported
| |
| |-
| |
| | 1.0.0 || ✅ Supported || ❌ Not supported || ❌ Not supported
| |
| |}
| |
|
| |
|
| == Support Lifecycle ==
| | '''Closing note suggestion:''' "If your firmware version is not listed in the compatibility matrix, contact technical support to confirm which hardware revisions are supported." |
| {| class="wikitable"
| |
| |-
| |
| ! Status !! Definition !! Bug Fixes? !! Security Fixes? !! Notes
| |
| |-
| |
| | {{FW-Status|Recommended}} || Latest stable, recommended for all new and existing deployments || ✅ || ✅ || Default for new shipments
| |
| |-
| |
| | {{FW-Status|Supported}} || Stable, receiving critical security fixes only || ❌ || ✅ || Upgrade to Recommended advised
| |
| |-
| |
| | {{FW-Status|Deprecated}} || Older version, no longer receives fixes || ❌ || ❌ || Upgrade required for production
| |
| |-
| |
| | {{FW-Status|EOL}} || End-of-life, no support || ❌ || ❌ || Beta / engineering samples only
| |
| |}
| |
|
| |
|
| | </div> |
| | <div class="noprint"> |
| == Related Documents == | | == Related Documents == |
| * [[{{SUBPAGENAME}} User Guide|User Guide]]
| | ''Cross-references to other documents.'' |
| * [[{{SUBPAGENAME}} Datasheet|Datasheet]]
| | {{RelatedDocuments}} |
| * [[Product Change Notification|PCN List]]
| | </div> |
| * [[Media:Product-FW-Update-Guide.pdf|Firmware Update Guide (PDF)]]
| |
| * [[Media:Product-Configuration-Tool.zip|Configuration Tool (Windows)]]
| |
|
| |
|
| == Document Revision History == | | == Revision History == |
| {| class="wikitable"
| | <div class="revision-history-auto"> |
| |-
| | <span class="dim">Loading revision history...</span> |
| ! Doc Version !! Date !! Author !! Changes
| | </div> |
| |-
| |
| | 1.4 || 2026-05-01 || [Author] || Added v1.2.0 release
| |
| |-
| |
| | 1.3 || 2026-03-20 || [Author] || Added v1.1.2 hotfix
| |
| |-
| |
| | 1.2 || 2026-02-15 || [Author] || Added v1.1.0 release
| |
| |-
| |
| | 1.1 || 2025-12-01 || [Author] || Initial release with v1.0.0
| |
| |}
| |
|
| |
|
| [[Category:Firmware Changelog]] | | [[Category:{{subst:#replace:{{subst:PAGENAME}}| Firmware Changelog|}}]] |
| </includeonly> | | </includeonly> |
