forked from Blendman974/faceclaw
52 lines
3.1 KiB
Markdown
52 lines
3.1 KiB
Markdown
# iOS protocol synchronization — 2026-09-17
|
|
|
|
Merged `main` at `1727474` into `ios-port`. The iOS session now uses the
|
|
same transport contract as Android's `CfwTransport`, `CfwMessageWindow`,
|
|
`OutboundMessage`, and `BleImageOptimizer`.
|
|
|
|
- The EvenHub page contains only the input text container. Display commands
|
|
and cleanup use SID `0xf0`, without image-container or image-update headers.
|
|
- Mode 6 full frames and mode 3 bounding boxes contain uncompressed RLE.
|
|
Persistent zlib with SYNC_FLUSH runs in wire order at the transport layer.
|
|
Record lengths and checksums describe the same data as Android; packet
|
|
sizes respect CoreBluetooth's maximum write value length (ATT MTU minus 3).
|
|
- Commands larger than the uint16 record limit become independent 64-row
|
|
mode 3 bands. Frame metrics advance only when all bands complete.
|
|
- The three-command window requires ACKs for both processing lenses on the
|
|
ingress BLE link, with matching stream ID, ordinal, decoded size, and CRC.
|
|
Primary and redundant ACKs are validated before application; completion
|
|
remains ordered even when replies arrive out of order.
|
|
- NACKs or 500 ms ACK timeouts replay the entire unresolved window, using
|
|
fresh stream IDs and reset compression contexts. Three retries are allowed
|
|
before reconnecting and invalidating the delta base. Deadlines begin after
|
|
writes finish. Old queued attempts and late ACKs cannot complete replays.
|
|
- Firmware acceptance uses shared numeric revision checks (currently
|
|
Faceclaw/13 or newer), replacing the old EVENCFW feature-token check.
|
|
Legacy or stock firmware is rejected before display startup.
|
|
|
|
Merge conflicts retained iOS voice restrictions while preserving main's
|
|
asynchronous transcription finalization. The iOS voice-state bridge supplies
|
|
the new listening/detail fields. Test harnesses account for platform globals
|
|
and the shared SVG rasterizer.
|
|
|
|
Validation: TypeScript checking and signed physical-device iOS build pass.
|
|
The simulator build launches and renders the main screen and shared launcher.
|
|
The final signed app is installed on the development iPhone, but iOS rejects
|
|
automatic launch with a signing/entitlement/developer-trust error. Local code
|
|
signature verification passes; the current provisioning profile includes the
|
|
iPhone and expires September 25. On-phone trust/launch needs checking.
|
|
The transport parity test compiles Android's production Java encoder and
|
|
compares complete packets, including persistent history, reset, MTU limits,
|
|
and raw fallback for incompressible maximum-size records. Session tests cover
|
|
ACK identity, two-lens completion, ordered pipelining, band reconstruction,
|
|
NACK replay, timeout/retry limits, microphone/input responsiveness, and cleanup.
|
|
|
|
The full suite has 420 passing tests and 21 failures. All 21 reproduce on a
|
|
clean archive of main at 1727474: compass, pinball/touch, and terminal test
|
|
harness/behavior checks. There are no additional failing tests from this merge.
|
|
|
|
Hardware acceptance still requires current-firmware glasses: connect, scroll
|
|
and animate the display, check both lenses, exercise mic and ring input, lock
|
|
the phone, and disconnect/reconnect. Automated tests do not establish on-lens
|
|
or radio reliability.
|