Skip to content

v0.5.0 - initial graphs support

Pre-release
Pre-release

Choose a tag to compare

View all tags
@ilyakruchinin ilyakruchinin released this 23 Jul 13:41
· 294 commits to main since this release
v0.5.0
50c4b1d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

SomnoTrace v0.5.0 — Release Notes (changes since v0.4.1)

Breaking changes

SD card storage restructure — action required

All SomnoTrace-managed folders on the SD card now live under a single
.somnotrace/ app-root instead of sitting at the card root. There is no
automatic migration — after updating, the firmware will look in the new
locations and will not see data left in the old ones.

Data Old location (v0.4.1) New location (v0.5.0)
Session streams .sessions/streams/ .somnotrace/sessions/streams/
Daily summaries .sessions/summaries/ .somnotrace/sessions/summaries/
Device logs .logs/ .somnotrace/logs/
Uploader state internal flash (LittleFS) .somnotrace/upload_state/
ResMed/OSCAR export SDCARD/ SDCARD/ (unchanged)

Notes:

  • SDCARD/ (the OSCAR/SleepHQ-ready export) is unchanged — already-exported
    EDF data needs no action and remains readable by OSCAR/SleepHQ.
  • The uploader's record of what was already uploaded is reset (it moved off
    internal flash and is not migrated). After the update the uploader may
    re-upload sessions and/or need its target reconfigured.
  • Folder names beginning with a dot are hidden; enable "show hidden files" on
    your computer to see them.

Keeping your old session data

Recommended — SD card reader

  1. Update the firmware and let the device boot once. This creates the
    .somnotrace/ folder tree automatically.
  2. Power off, remove the SD card, and open it on a computer (show hidden files).
  3. Move the old folders into the new app-root and drop the leading dot:
    • .sessions -> .somnotrace/sessions
    • .logs -> .somnotrace/logs
      (Merge into the folders the firmware just created; keep the same
      streams/ and summaries/ sub-structure.)
  4. Leave SDCARD/ exactly as it is.
  5. Reinsert the card and power on. Old noon-days will now appear in the
    dashboard and can be re-exported/uploaded.

Alternative — FTP (over Wi-Fi)

  1. Connect to the device's FTP server (user anonymous, any password).
  2. Download the old trees from the card root: /.sessions and /.logs.
  3. Re-upload them into /.somnotrace/sessions and /.somnotrace/logs.
    (A card reader is much faster for large stream data.)

If you don't care about historical data, no action is needed — the device
starts fresh and old folders can be deleted at your leisure.

Other notable changes

  • New multi-panel web dashboard: breathing waveform plus pressure, leak,
    flow-limit and snore graphs, with per-pixel envelope decimation to remove
    aliasing/moire on zoom.
  • Noon-day summary panel (AHI, usage, average leak, median pressure, event
    breakdown and a median/95%/99.5% statistics table). Pressure, EPAP, leak and
    respiratory-rate figures are derived from the per-breath (PLD) channels and
    match OSCAR's percentile algorithm.
  • Memory headroom: Wi-Fi, lwIP and the HTTP server allocations were moved to
    PSRAM, freeing internal RAM and improving stability under load.

Upgrade checklist

  • Flash v0.5.0 and boot once (creates .somnotrace/).
  • Move .sessions -> .somnotrace/sessions and .logs -> .somnotrace/logs
    (card reader or FTP), if keeping history.
  • Verify old days appear in the dashboard.
  • Reconfigure/verify the uploader target (upload history was reset).
Assets 3
Loading
4 Join discussion