Skip to content

docs: BOM/hardware corrections + Valar store links + wiki sync - #37

Merged
daniel-frenkel merged 7 commits into
mainfrom
docs/bom-hardware-corrections
Jul 29, 2026
Merged

daniel-frenkel merged 7 commits into
mainfrom
docs/bom-hardware-corrections

Conversation

@daniel-frenkel

Copy link
Copy Markdown
Member

Documentation-only corrections from the confirmed hardware facts (ROPENER-DOC-UPDATE work order, confirmed 2026-07-28). No firmware / STEP / STL changes.

Changes

  • Mounting — 3M command strips → five 1" foam mounting squares (BOM-V2.0, wiki Build-Guide, README). Build step now says to wipe the surface clean/dry and press firmly (the squares ship loose with no instructions).
  • Arm screw — corrected to M3 × 15 mm button head (BOM-V2.0 was 16 mm; Build-Guide prose was 12 mm).
  • 35 mm screw — Build-Guide prose corrected 30 → 35 mm (arm-attach + bottom-join), and the third M3 × 35 mm screw is now documented as the clamp screw that threads into a square nut seated in one arm to pull the arm pair against the drive pulley.
  • M3 square nuts — Body Assembly 1 → 3 in BOM-V2.0 (curtain stays 1; total 4). Build-Guide now tells the builder to seat the third nut before the arms mate (the pocket is inaccessible afterward).
  • Power adapter — 24 V 1.5 A (was "12 V / 2A+"; dropped the stale "12 V is best" note).
  • Product links — every purchasable BOM row now links to the Valar Systems store; all Amazon affiliate links removed. make_bom.py intro text updated to match.
  • Wiki mirror sync — docs/wiki-* brought up to the live wiki's own edits (redesigned Home + foam line, Firmware-Guide select: edit, de-emojified sidebar) so the repo mirror is the single source of truth.

The live wiki is being synced separately from this corrected mirror.

Flags (not changed — need your call)

  1. Arm screw qty: BOM-V2.0 lists the M3 × 15 mm arm screw at qty 2 (one per arm); the wiki tables say 3. Per your instruction I left the wiki at 3 and left BOM-V2.0 at 2 — but the build prose only places 2 (one per arm), so the third's location is unaccounted. Confirm the real count.
  2. Wire nail count: BOM-V2.0 says 3; the old README said "4 small nails." I dropped the count from the README prose rather than guess.
  3. arm-to-motor rename (work-order CHANGE 4b): the string appears nowhere in repo or wiki — no-op.
  4. README McMaster-Carr mention (prose, "sourced in bulk from places like McMaster-Carr") left as-is — it's a cost illustration, not a BOM link.
  5. Glide-tape "available on Amazon" prose in Build-Guide left as-is (glide tape has no Valar SKU). The amzn.to affiliate link in the wiki Installation-Guide is being removed during the wiki sync.
  6. Generated docs/dist/ docx/PDF still carry the old data — regenerate with python make_bom.py (needs the toolchain) to refresh the binaries.

🤖 Generated with Claude Code

daniel-frenkel and others added 6 commits July 28, 2026 09:18
… + third clamp nut

Build-Guide mirror: replace 3M Command Strips (x4) with five 1" foam
mounting squares (wipe clean/dry, press firmly); correct the arm-screw
prose 12 -> 15 mm; correct the arm-attach and bottom-join prose 30 -> 35 mm;
document the third M3 square nut seated in one arm's pocket (must go in
before the arms mate) that the M3 x 35 mm screw clamps into against the
drive pulley.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… adapter, store links

BOM-V2.0 (the .docx source of truth): replace command strips with five 1"
foam mounting squares; correct the Body Assembly arm screw 16 -> 15 mm;
raise the Body Assembly M3 square nut count 1 -> 3 (curtain stays 1, total 4);
change the power adapter to 24 V 1.5 A (drops the stale "12 V is best" note);
point every purchasable row at the Valar Systems store and remove all Amazon
affiliate links. Links stay in the Description column so make_bom.py renders
them as hyperlinks; its intro line updated to say "Valar Systems store."

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Bring the docs/wiki-* mirror up to the live wiki's own edits so the mirror
is the single source of truth: adopt the redesigned Home (and change its
"command strips" line to foam mounting squares), the Firmware-Guide select:
edit, and the de-emojified sidebar.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Caught during the wiki sync sweep: the firmware overview still described the
v1.0 MK7 gear. v1.1 ships the MK8 (matches BOM-V2.0 and Build-Guide).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… M3x12 flat-head

Owner-confirmed fastener map: M3x15 button head x3 = one per arm (2) + curtain
pulley (1); M3 square nut x4 = per arm (2) + clamp nut (1) + curtain pulley (1);
every nut pairs with exactly one screw.

- BOM-V2.0 Body: M3x15 button head 2 -> 3 (adds the pulley screw).
- BOM-V2.0 Curtain: DELETE "M3 x 12 mm flat head | 1" — it was the pulley screw
  misidentified; it does not exist as a separate part.
- Build-Guide pulley-end step + image: the V-groove pulley is held by an
  M3 x 15 mm button-head screw (not M3 x 12 mm flat-head), into an M3 square nut.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@daniel-frenkel

Copy link
Copy Markdown
Member Author

Flag #1 resolved (owner-confirmed) + one new flag

Arm-screw qty — resolved. The wiki was right: M3 × 15 mm button head = qty 3 = one per arm (2) + the curtain-pulley screw (1), threaded into the 4th square nut.

Applied (commits d4f0dc8, wiki 95d07aa):

  • BOM-V2.0 Body: M3 × 15 button head 2 → 3.
  • BOM-V2.0 Curtain: deleted the phantom M3 × 12 mm flat head | 1 — it was the pulley screw misidentified, not a separate part (no store link created).
  • Build-Guide pulley-end step + image: pulley is held by an M3 × 15 mm button-head screw into an M3 square nut (was "M3 × 12 mm flat-head").

Confirmed fastener map now reconciles across every table — each of the 4 square nuts pairs with exactly one screw (2× M3×15 arm, 1× M3×35 clamp, 1× M3×15 pulley):

Fastener Total Where
M3 × 15 mm button head 3 arm (2) + curtain pulley (1)
M3 × 35 mm button head 3 arms-to-motor (2) + arm-bottom clamp (1)
M3 square nut 4 arm (2) + clamp (1) + curtain pulley (1)
633ZZ bearing 2 one per arm

New flag (pre-existing, not changed): thread-forming/self-tapping M3 × 10 count disagrees — wiki quick-BOM says 23, BOM-V2.0 says 8 (body) + 11 (curtain) = 19. These don't pair with nuts so the pairing rule doesn't pin them; the counts need a physical confirm. Left both as-is pending your word.

…e nail

Owner-confirmed: 22 thread-forming screws total. BOM-V2.0 Curtain 11 -> 14
(Body stays 8: 4 PCB + 4 wall-plate; the 2 motor-mount screws are machine
screws into the motor, not thread-forming). Wiki quick-BOM aggregate 23 -> 22.

Wire nail removed from the BOM Mounting Hardware — no longer included in the kit.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@daniel-frenkel

Copy link
Copy Markdown
Member Author

Remaining flags resolved (owner-confirmed)

  • Thread-forming M3 × 10 screws = 22 total. BOM-V2.0 split Body 8 / Curtain 14 (Body = 4 PCB + 4 wall-plate; the 2 motor-mount screws are machine screws into the motor, not thread-forming). Wiki quick-BOM aggregate 23 → 22.
  • Wire nail: removed from the BOM. It was 4, but nails are no longer included in the kit, so the row is gone from Mounting Hardware. README still lists "small nails" only as a user-supplied drywall option (foam is the only "included" item).

All fastener counts now cross-check. Remaining non-blocking item: docs/dist/ docx/PDF still hold old data — regenerate with python make_bom.py.

@daniel-frenkel
daniel-frenkel merged commit c670870 into main Jul 29, 2026
2 checks 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.

1 participant