v0.5.0 - initial graphs support

[ilyakruchinin]

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).

---

This discussion was created from the release v0.5.0 - initial graphs support.

[ilyakruchinin]

[ilyakruchinin]

Report any differences you see between internal graphs vs OSCAR (or SleepHQ).
Some differences are expected, however.

[ilyakruchinin]

Let me know what you thing about the usability (UI/UX) of the web interface/graphs on the desktop as well as mobile interface.
Is it easy to use? Any bugs? Is it convenient? What would you recommend to improve?

[ilyakruchinin]

v0.5.1 has been released: #42