Skip to content

docs(extras): Prime real-hardware bringup page#11

Open
T-K-233 wants to merge 1 commit into
mainfrom
docs/prime-bringup-extra
Open

docs(extras): Prime real-hardware bringup page#11
T-K-233 wants to merge 1 commit into
mainfrom
docs/prime-bringup-extra

Conversation

@T-K-233

@T-K-233 T-K-233 commented Jun 30, 2026

Copy link
Copy Markdown
Member

Summary

Adds an Extras page, docs/extras/prime_bringup.md, documenting the Prime real-hardware bringup knowledge (eRob over EtherCAT + Sito over SocketCAN) — the Prime counterpart of the Lite first_real_bringup how-to. Filed under a new Extras sidebar category and flagged experimental, since on real silicon only a single eRob has been jogged so far.

The page covers

  • How Prime differs from Lite — two concurrent <ros2_control> blocks (PrimeEtherCATSide / ethercat_driver for the 10 eRob CiA402 joints + PrimeSitoCAN / SitoSystem for the 4 Sito wrists), one flat 14-joint list, and the hybrid command-surface caveat (eRob expose no stiffness/damping).
  • Bus topology — eRob ring positions 0–9 and the four Sito ids on can2, straight from prime_hardware.yaml.
  • Prereqs → Steps — build with the EtherCAT/Prime packages; start & verify the host IgH master (ethercat master / ethercat slaves); bring can2 up; ros2 launch humanoid_bringup_prime real.launch.py with its args; what to expect (sequenced spawners, ~13.6 s eRob activation, /prime/joint_states); verify.
  • Single-bus diagnostic modes (backends:=ec|can), eRob per-mode impedance (erob_impedance_manager / SDO loop gains), and common failures linking the Prime troubleshooting entries.
  • The control_frequency = update_rate (50 Hz) constraint that avoids CiA402 Fault 4616.

Also

  • Fixes a dangling cross-link: calibrate_prime_erob.md listed "EtherCAT master running + drives powered → see First real-hardware bringup", but that page is Lite-only and never covers the master. It now points to this new page.

Sourced from humanoid_bringup_prime (launch/config) + existing concepts/calibration/troubleshooting docs. No local Node available; CI (typecheck + build, onBrokenLinks: 'throw') is the validation gate.

🤖 Generated with Claude Code

https://claude.ai/code/session_01D48ZKKVV3BSb2wukP4ka3y

Document the Prime bringup knowledge (eRob over EtherCAT + Sito over
SocketCAN) as an Extras page, mirroring the Lite first_real_bringup
how-to:

- bus topology (10 eRob ring pos 0-9 + 4 Sito on can2), 14 flat joints,
  the hybrid CiA402 / MIT command-surface caveat
- prereqs (host IgH master, can2 up, software calibration), start/verify
  the master, launch real.launch.py + its args, what to expect, verify
- single-bus diagnostic modes, eRob per-mode impedance, common failures
- flagged experimental (only one eRob jogged on silicon so far)

Add an Extras sidebar category, and repoint calibrate_prime_erob's
prerequisite link: it pointed at the Lite-only first_real_bringup for
"EtherCAT master running + drives powered", which that page never covers.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D48ZKKVV3BSb2wukP4ka3y
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.

1 participant