docs/reference: Handspring SDK (HsExt.h, Springboard docs and tools)

This commit is contained in:
rich committed 2026-11-02 10:28:07 -05:00
1 parent 4c66088eff
commit dbf8995433
4 files changed
+3 -3

No files matched your search

+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
Binary file not shown.
+1 -1
View File
@@ -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).
*/