diff --git a/README.md b/README.md index 9b40339..5ad1b03 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ See [docs/design.md](docs/design.md) for the architecture and the reasons behind | `docs/design.md` | Architecture, protocol notes and decisions | | `docs/progress.md` | Status, milestones and a dated log | | `docs/upstream-issues.md` | Problems found in pilot-link, PilRC/prc-tools and MeshCore, with evidence and workarounds, ready to report | -| `docs/reference/` | Third-party reference: Handspring Springboard dev guide and mechanical spec, springSD v1.1 hardware | +| `docs/reference/` | Third-party reference: Handspring Springboard dev guide and mechanical spec, the Handspring SDK (`HsExt.h`, Springboard docs and tools), springSD v1.1 hardware | ## Versioning diff --git a/docs/progress.md b/docs/progress.md index 2b26dea..0001f85 100644 --- a/docs/progress.md +++ b/docs/progress.md @@ -26,7 +26,7 @@ - [x] USB link from the dev Mac: pilot-link (desrod @6d696653 + `tools/pilot-link-darwin-usb-open-retry.patch`) lists the Visor's databases - [x] `make install` puts VisorMesh on the Visor; app launches and shows the main form on the Visor Neo - [ ] Emulator: CloudpilotEmu with a Palm OS 3.5 ROM (the Visor isn't emulated); optionally POSE + a Visor Neo ROM in a Windows VM -- [x] Original Handspring SDK headers (Springboard `HsCard*` APIs; the PalmOne `HsExt.h` lacks them). The calls used are declared in `src/hs_card.h`; the SDK itself isn't in the repo (Handspring EULA) +- [x] Original Handspring SDK headers (Springboard `HsCard*` APIs; the PalmOne `HsExt.h` lacks them). The calls used are declared in `src/hs_card.h`; the SDK is in `docs/reference/Handspring_SDK.zip` - [x] Bus SPI routines and SC16IS740 driver (`sb_spi.c`, `transport_sb.c`); host-tested against a simulated carrier, not on hardware - [x] Companion protocol: framing, builders (DEVICE_QUERY, APP_START, GET_CONTACTS, SYNC_NEXT_MESSAGE), parsers (SELF_INFO, contacts, v3 contact/channel messages); host tests from real captures + MeshCore layouts - [x] USB bench link: app (`HsUd`) → Visor USB cradle → `tools/visor_bridge.py` → FTDI → XIAO D6/D7. Query radio shows `Reply 0x000D, 82 bytes` on the Visor diff --git a/docs/reference/Handspring_SDK.zip b/docs/reference/Handspring_SDK.zip new file mode 100644 index 0000000..04593a1 Binary files /dev/null and b/docs/reference/Handspring_SDK.zip differ diff --git a/palm-client/src/hs_card.h b/palm-client/src/hs_card.h index f821953..51245f9 100644 --- a/palm-client/src/hs_card.h +++ b/palm-client/src/hs_card.h @@ -1,6 +1,6 @@ /* * The few Handspring Springboard card calls VisorMesh uses, declared from the - * Handspring SDK's HsExt.h (not vendored: it's under Handspring's EULA). + * Handspring SDK's HsExt.h (docs/reference/Handspring_SDK.zip). * Calls go through sysTrapOEMDispatch with a 16-bit selector pushed on the * stack, which the dispatcher pops ("unpopped" in HsExt.h). */