52 lines
5.0 KiB
Markdown
52 lines
5.0 KiB
Markdown
# Tactility Bible Audio
|
|
|
|
## Status — 2026-11-13
|
|
|
|
User requested an initial audio Bible app using the existing BibleVerse book-selection UI, first on the Mac mini emulator. Implemented a native Tactility app and functionally verified it in the Mac mini simulator. No physical boards were installed or modified, and no server catalog records were changed.
|
|
|
|
Source: `/Users/adolforeyna/Projects/electronics/tactility/tactility_apps/Apps/BibleAudio/`
|
|
App ID: `one.tactility.bibleaudio`
|
|
Simulator package: `Apps/BibleAudio/build/one.tactility.bibleaudio.sim.app`
|
|
Builder: `python3 Apps/BibleAudio/build-simulator.py` from tactility_apps root.
|
|
Evidence: `/Users/adolforeyna/output/bible-audio-simulator/`
|
|
Local simulator viewer: `http://127.0.0.1/sim`
|
|
|
|
## Verified implementation
|
|
|
|
- Same BibleVerse-style horizontal 66-book picker with arrows, scrub slider, dark colors, and embedded Georgia Regular 24 font.
|
|
- Real PocketBase catalog on FamReynaServer `.110:8095`, using `audio_libraries`, `audio_collections`, and `audio_tracks`.
|
|
- Native chapter listing, pagination, back navigation, downloads with exact catalog-size validation, cached-play indicators, stop, clean exit/reopen.
|
|
- Real minimp3 decoding through firmware audio-stream0 → SDL/CoreAudio, not the legacy Mp3Player silent simulator branch.
|
|
- Tested at 480x320 and 320x240. Genesis chapter 1 downloaded 2,070,582 bytes, SHA-256 `5e3dd36bc35dcdf4284bd0d36ccae0c6f59c3d83815244268b7bcdf4fed6e4f5`, exactly matching server bytes.
|
|
- Native audio logs show 44,100 Hz mono output and decoded samples written; tested stop and cached replay. This is output-path verification, not independent microphone confirmation of audibility.
|
|
- Eight tests compile and run actual C book-mapping and PCM-write logic, including partial timeout writes, bounded no-progress retry and fatal driver errors. Two SDL simulator audio suites pass.
|
|
- Delayed review was reconciled with final source: all reviewed alias/lifecycle/download/catalog defects fixed; Back cancels pending download/autoplay, malformed pages fail explicitly, PCM partial writes retry safely. Rebuilt, reinstalled, exact installed/package binary match verified; playback/stop/exit/reopen retested. Final binary SHA-256: `9e46b4842fe13d336bd11f49b7da1f440a0200cd6b5e789d902e6ba924ada6b5`.
|
|
|
|
## Important source-library limitation
|
|
|
|
Live backend: 1 library, 18 collections, 1,167 MP3 tracks. Actual C mapping recognizes 1,163 tracks across 53 canonical books. Four records are general section introductions (history/wisdom/prophets/New Testament), not canonical books.
|
|
|
|
Absent source audio: Daniel, Hosea, Joel, Amos, Obadiah, Jonah, Micah, Nahum, Habakkuk, Zephaniah, Haggai, Zechariah, Malachi. App keeps these books in canonical order and labels them unavailable. Do not describe the hosted library as a complete audio Bible.
|
|
|
|
## Remaining work
|
|
|
|
Persistent catalog/offline restart browsing, resume/history, seeking, pause/volume UI, auto-next chapter, source-audio gap restoration and one-board end-to-end rollout.
|
|
|
|
## ESP32-S3 build — 2026-11-13
|
|
|
|
Latest source built successfully against a fresh SDK from local firmware revision `dcfd4e9bcc12da39f3af8cc80f7bc6388e29b56f`. Package: `/Users/adolforeyna/output/bible-audio-esp32/BibleAudio-0.1.0-esp32s3.app` (71,680 bytes), SHA-256 `3d190068cadb841d5959103f2bb1fa03a8bcf3de10c94e412af72038f4da9857`.
|
|
|
|
- Package manifest and embedded ESP32-S3 ELF match source/build artifacts exactly.
|
|
- Source export audit: 125 imports, 1,662 exports, zero missing imports. Both locally compiled ES3C28P and ES3C35P firmware ELFs contain all imported symbols; this is not proof of the firmware currently flashed on any board.
|
|
- Eight app tests pass. MP3 decoder moved from task stack to heap because it occupies 23,068 bytes vs the 8 KiB ESP-IDF playback stack. Host heap-decoder smoke test decoded 20 real Genesis frames / 23,040 samples.
|
|
- Receipt: `/Users/adolforeyna/output/bible-audio-esp32/build-receipt.json`.
|
|
- Build only: no hardware installs, launches, firmware flashes or device changes performed. Device runtime remains unverified. Simulator was not redeployed for this heap-allocation-only change.
|
|
|
|
## Kitchen installation — 2026-11-13
|
|
|
|
Installed Bible Audio 0.1.0 on Kitchen `kidsos_591c`, exact live Deco MAC `14:C1:9F:D0:59:1C`, resolved IP `192.168.68.113`. Preflight verified ESP32-S3, mounted SD and `/sdcard/tactility/app` listing. App is present in live app inventory. Downloaded installed `bin/esp32s3/BibleAudio.elf` (62,820 bytes) and manifest; both match local artifacts byte-for-byte. ELF SHA-256 `100aec865873adddc1613da43370edeff95ed410d8c0dbe5197097c37d4e8a3d`. Receipt: `/Users/adolforeyna/output/bible-audio-esp32/kitchen-install-receipt.json`. Installation only, as requested: app not launched, no playback test, no reboot or firmware changes.
|
|
|
|
## Continuity
|
|
|
|
Earlier server setup was completed in session `20260919_215532_5e469e` (Extend Discovery Mountain for Bible audio). Audio resides at `/mnt/mydisk/media/podcasts/Bible Message/episodes/`, served through read-only Nginx at `http://192.168.68.110:8098/bible-message/`. Original external-drive archive was preserved.
|