docs: sync control source to AK60 RPi5 BiSS-C

docs/nick-generated/2026-07-06-ak60-rpi5-bissc-source-sync.md

@@ -0,0 +1,44 @@
+---
+title: AK60 / Raspberry Pi 5 / BiSS-C Source Sync
+status: draft
+requested_by: Antoine Letarte
+generated_by: Nick / Hermes
+project: P11-Polisher-Fullum
+repo: polisher-control
+source_truth: false
+created: 2026-07-06
+privacy: technical-only
+---
+
+# AK60 / Raspberry Pi 5 / BiSS-C Source Sync
+
+## Purpose
+
+Align the repo foundation with Antoine's accepted hardware corrections before Cédric writes firmware against stale assumptions.
+
+## Source references
+
+- P11 firmware source: `software-suite/control/firmware/Fullum-Polisher-Machine-Control-Firmware-Spec-v1.md`
+- Repo mirror: `docs/reference/fullum-control-firmware-spec/Fullum-Polisher-Machine-Control-Firmware-Spec-v1.md`
+- Electrical audit TLDR: `2026-07-06-Polisher-Control-Electrical-Audit-TLDR.md`
+- Change gate: `CEDRIC-PROP-20260609-001`
+
+## Accepted corrections now reflected here
+
+1. Host computer is **Raspberry Pi 5 + touchscreen**, not Raspberry Pi 4.
+2. Toolhead spindle path is **CubeMars AK60-6 V1.1 KV80**, not ODrive S1 + M8325s.
+3. Table encoder order is `DHR162DB20BAAS30DA02` + `SAR162C143AF14WAP00`, which means **BiSS-C / RS422**.
+4. Arm encoder order is `BR10DCD14B12DH00` + `BM120A190A1ABA00`, which means **BiSS-C / RS422**.
+
+## Cédric implementation cautions
+
+- Do not treat CAN stop/disable as a safety-rated AK60 stop. The safety basis must remove AK60 power through the hardwired safety-controlled post-contactor path and be bench-tested.
+- Freeze AK60 CAN topology before firmware lock: IDs, frame rates, stale-frame timeouts, fault handling, startup behavior, and whether AK60 shares a CAN bus with KWR75B.
+- Freeze BiSS-C implementation details before encoder firmware lock: frame timing, CRC/status bits, RS422 transceiver/pinout, shielding, and error handling.
+- Preserve `cw` / `ccw` as explicit direction enums separate from non-negative RPM; bench-map them to physical rotation.
+
+## Acceptance checks
+
+- Firmware source and repo mirror no longer name ODrive/M8325s as the current spindle basis.
+- Repo start docs, LLM context, roadmap, commissioning checklist, open questions, and machine capability profile now use AK60/RPi5/BiSS-C language.
+- Host-side tests and JSON validation should still pass after this docs/source refresh.