Skip to content

docs: Add head stereo camera section for OpenArm 2.0 - #655

Open
kou wants to merge 1 commit into
enactic:mainfrom
kou:head-camera-covers
Open

kou wants to merge 1 commit into
enactic:mainfrom
kou:head-camera-covers

Conversation

@kou

@kou kou commented Nov 10, 2026

Copy link
Copy Markdown
Collaborator

The head cover and the chest cover released before 2026-11-09 had a design error and interfere with the head stereo camera mount. The fixed covers were added to the Options folder in the Drive, but the docs didn't mention the folder or the head stereo camera.

  • hardware/openarm-2.0/general.mdx: Add "Head Stereo Camera" that says the camera is optional, where its parts and CAD data are, which bodies of the covers to print, the assembly order, and that the old covers must be printed again. The covers in OpenArm_2.0_w_Head_Camera.STEP are still the old ones.
  • faq/index.md: Add an entry for the interference. Make it clear that the head stereo camera is optional in "The cameras disconnect." Link to the BOM section instead of the top folder of the Drive.
  • hardware/openarm-2.0/upgrade-from-1.0.mdx: Add the covers as optional parts for the head stereo camera.

The chest cover has two bodies. Body 1 (back) has the same shape as the chest cover in OpenArm_2.0.STEP and Chest-cover_B in 1.1, so only body 2 (front) needs to be printed for the head stereo camera.

Why the front chest cover has a large slit

The fixed front chest cover is attached after the head stereo camera, so it needs a large slit on the top.

We also considered attaching the camera after the front chest cover. It makes the gap on the top smaller, but the front chest cover needs a hole for the tool to tighten the camera screws, and it affects the appearance more.

Extending the frame of the back chest cover toward the front could close the gap, but it makes 3D printing harder, so we didn't adopt it. A lid could cover the gap, but there is no lid yet. Improvements are welcome in the community.

Copilot AI balanced review requested due to automatic review settings November 10, 2026 07:05
@github-actions

Copy link
Copy Markdown

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues remain for the optional head-camera and compatible-cover documentation changes.

No open issues 🎉

What changed in this PR

Documents the optional OpenArm 2.0 head stereo camera and explains how to use the corrected covers to avoid interference with its mount.

Changes:

  • Adds CAD locations, required cover bodies, assembly order, and warnings about outdated covers.
  • Updates the FAQ with interference guidance and clarifies that the head stereo camera is optional.
  • Adds camera-specific covers to the OpenArm 1.x upgrade instructions and printed-parts list.
File Description
website/​docs/​hardware/​openarm-2.0/​upgrade-from-1.0.mdx Lists optional camera covers and front chest-cover replacement instructions.
website/​docs/​hardware/​openarm-2.0/​general.mdx Adds camera setup, printing, and assembly guidance, including outdated-cover warnings.
website/​docs/​faq/​index.md Explains cover interference and updates camera configuration links and wording.

Review effort: Balanced

The head cover and the chest cover released before 2026-11-09 had a
design error and interfere with the head stereo camera mount. The fixed
covers were added to the Options folder in the Drive, but the docs
didn't mention the folder or the head stereo camera.

- `hardware/openarm-2.0/general.mdx`: Add "Head Stereo Camera" that
  says the camera is optional, where its parts and CAD data are, which
  bodies of the covers to print, the assembly order, and how to handle
  the old covers. The covers in `OpenArm_2.0_w_Head_Camera.STEP` are
  still the old ones.
- `faq/index.md`: Add an entry for the interference. Make it clear
  that the head stereo camera is optional in "The cameras disconnect."
  Link to the BOM section instead of the top folder of the Drive.
- `hardware/openarm-2.0/upgrade-from-1.0.mdx`: Add the covers as
  optional parts for the head stereo camera.

The old covers don't need to be replaced if they could be assembled.

The chest cover has two bodies. Body 1 (back) has the same shape as
the chest cover in `OpenArm_2.0.STEP` and `Chest-cover_B` in 1.1, so
only body 2 (front) needs to be printed for the head stereo camera.

## Why the front chest cover has a large slit

The fixed front chest cover is attached after the head stereo camera,
so it needs a large slit on the top.

We also considered attaching the camera after the front chest cover.
It makes the gap on the top smaller, but the front chest cover needs a
hole for the tool to tighten the camera screws, and it affects the
appearance more.

Extending the frame of the back chest cover toward the front could
close the gap, but it makes 3D printing harder, so we didn't adopt it.
A lid could cover the gap, but there is no lid yet. Improvements are
welcome in the community.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kou
kou force-pushed the head-camera-covers branch from 8feb60b to 8507f22 Compare November 10, 2026 07:12
Copilot AI balanced review requested due to automatic review settings November 10, 2026 07:12

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation updates for the optional head stereo camera and compatible covers have no active review issues.

No open issues 🎉

Review effort: Balanced

This branch has not been deployed

No deployments
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