Skip to content

Add supervised iPhone 16 and UNO R4 cane demo - #2

Merged
pschmeln merged 1 commit into
mainfrom
cursor/cane-demo-mvp-e781
Nov 7, 2026
Merged

pschmeln merged 1 commit into
mainfrom
cursor/cane-demo-mvp-e781

Conversation

@pschmeln

@pschmeln pschmeln commented Nov 7, 2026 •

Copy link
Copy Markdown
Owner

Summary

Adds the first working slice of a supervised cane demo for a body-mounted standard iPhone 16 and an Arduino UNO R4 WiFi. Collaboration docs stay in place. The phone does not invent an obstacle distance or a safe direction. A human still merges this pull request.

The existing cane remains the mobility aid. This is not a field test for a blind traveler.

Implementation and simulation

  • Camera path: ARKit world tracking when the device supports it, a capability check for LiDAR sceneDepth that this build never enables, camera-step readout between consecutive normal frames, and an optional existing-plane hit shown only as context. The hazard claim stays "no claim". The route cue stays off.
  • Simulation path: explicit on-screen controls for an elevated hazard, a system-unavailable cue, and a manual left or right label. The screen marks these as simulated. They are not camera results.
  • Shared C logic rejects a camera-sourced hazard and a camera-sourced route cue before a packet can be sent.
  • Four logic outputs: D2 hazard, D3 unavailable, D4 demo route, D5 board-owned link heartbeat or link outage. A quiet hazard channel is not an all-clear. Total silence is a power or driver fault.
  • The board watchdog is 500 ms of the board clock after the last valid packet. It does not trust the phone's timestamp.

No metric obstacle distance, velocity, or time-to-contact is produced. No depth model is included. No random avoidance is included. The left/right control is a demo label, not a claim that the direction is clear.

Validation

  • make -C prototype test passed on this machine. The tests cover assessment rules, CRC and packet admissibility, watchdog timing, and the separation of plane-hit context from actuator outputs.
  • python3 scripts/check_workflow.py --external passed, including the official Apple and Arduino links in docs/PROTOTYPE.md.
  • GitHub Actions job Check workflow scaffolding passed on this pull request. That job runs the doc checker and the same host logic tests.
  • This environment has no Xcode and no Arduino toolchain. The iOS app was not compiled, and the firmware was not compiled or flashed.

Manual steps

  • Review and merge only after a human approval.
  • On a Mac, sign and run prototype/ios/CaneDemo/CaneDemo.xcodeproj on the standard iPhone 16. Confirm the screen reports that scene depth is not supported.
  • Flash prototype/firmware/uno_r4_wifi/uno_r4_wifi.ino to an UNO R4 WiFi with ArduinoBLE. Wire four external drivers. Do not power actuators from GPIO. The datasheet limit is 8 mA per pin.
  • Measure phone-to-actuator latency from a video or the serial log during the supervised demo. No latency number is claimed here.

Details, wiring, and the list of what is not implemented are in docs/PROTOTYPE.md.

Open in Web Open in Cursor 

Separate hazard, unavailable, and manual route cues from a board-side link watchdog, and test that the camera path cannot invent an obstacle distance or a safe direction.

Co-authored-by: pschmeln <pschmeln@users.noreply.github.com>
@pschmeln
pschmeln merged commit 7aa0849 into main Nov 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants