wehub-resource-sync
73 lines
4.3 KiB
Markdown
73 lines
4.3 KiB
Markdown
# Source 3D Models (STEP) for Off-the-Shelf BOM Parts (procurement)
|
||
|
||
To design printed mounts and the chassis that *fit real sourced parts*, we need accurate
|
||
3D models (*STEP*) of the off-the-shelf components in the [BOM](../../BOM.md) — the
|
||
drive-wheel assembly, the suction fan/blower (several candidate models), the caster wheel,
|
||
the side-brush motor, and more. Manufacturers rarely publish these, so the community needs
|
||
to *obtain, measure, and model* them. Every printed mount and the chassis references this
|
||
geometry — see [ARCHITECTURE.md](../../docs/ARCHITECTURE.md) §5.2 (mechanical interface
|
||
standard). Missing models block or force guesswork on the mechanical modules.
|
||
|
||
This is a great *first contribution* for anyone with CAD skills and calipers — no
|
||
robotics or programming needed, and the modules can be modeled *in parallel*.
|
||
|
||
## Priority parts (from the [BOM](../../BOM.md))
|
||
|
||
Start with the "ready now" mechanical parts:
|
||
- *Drive wheel assembly pair* (e.g. Roborock S5/S50/S55/S6/S7-family modules)
|
||
- *Caster / universal wheel* (e.g. Roomba i/j/e/500–900 caster)
|
||
- *Suction fan / blower* — model the option(s) we shortlist (e.g. Dreame L10s / Nidec /
|
||
Roborock S8-family blowers listed in the BOM)
|
||
- *Side-brush motor*, *main-brush assembly*, *water pump*, *battery pack*, etc.
|
||
|
||
See [BOM.md](../../BOM.md) for the full list, the exact candidate models, and AliExpress
|
||
search links, plus [docs/ali_express_research.md](../../docs/ali_express_research.md) for
|
||
sourcing notes.
|
||
|
||
# Request for Contribution - Instructions
|
||
|
||
- *Pick a part* from the [BOM](../../BOM.md) and *claim it* in
|
||
[Project Discussions](https://github.com/makerspet/oomwoo/discussions?discussions_q=) or
|
||
[Discord](https://discord.gg/3y2JKz5T25) so two people don't model the same thing. Post progress too.
|
||
- *Get an accurate model* — two paths:
|
||
1. *Find an existing STEP* (manufacturer site, GrabCAD, etc.) and *verify it against the
|
||
real part* (dimensions match). Fastest — but confirm it's the same model/revision.
|
||
2. *Model it yourself*: order the exact part (AliExpress links are in the BOM), measure
|
||
with calipers, optionally use a 3D scanner and build an accurate STEP.
|
||
- *Capture the interface-relevant geometry* (external only — internal detail is not needed):
|
||
- Overall *bounding envelope* (so it fits the chassis space / height budget)
|
||
- *Mounting features*: holes, bosses, clips, bolt pattern — and their exact positions
|
||
- *Functional interfaces*: axle/shaft position + axis, wheel contact plane, fan air
|
||
inlet/outlet, connector / wire-exit locations
|
||
- *Mating faces* where other modules attach
|
||
- Note the *key overall dimensions*
|
||
- *Record provenance* — the exact vendor + link + which model/revision you measured. Parts
|
||
vary between sellers and revisions; say which one this model represents.
|
||
- *Submit a PR* to `contributions/source-3d-models/<your-github-username>/<part-name>/`:
|
||
- the *STEP* file (primary deliverable) + native CAD source (Fusion/SolidWorks/etc.) if you modeled it
|
||
- a *photo* of the real part (ideally next to your model / with calipers)
|
||
- the *source link* (AliExpress/vendor) and *key dimensions*
|
||
- notes on tolerances and how you measured
|
||
- announce it in [Project Discussions](https://github.com/makerspet/oomwoo/discussions?discussions_q=)
|
||
- Iterate with review.
|
||
- TBD, expect the RFC to evolve.
|
||
|
||
(*) If you have a strong reason to model a different variant than the BOM lists, post your
|
||
rationale in [discussions](https://github.com/makerspet/oomwoo/discussions?discussions_q=) first.
|
||
|
||
## Acceptance criteria
|
||
|
||
Objective, measurable. Examples:
|
||
- Accurate *STEP* of the specified part — bounding envelope, mounting features, and
|
||
functional interfaces match the measured real part (within a stated tolerance)
|
||
- Includes the *exact source link*, *key dimensions*, and a *photo* of the real part
|
||
- Please make sure the model is licensed as open-source
|
||
- *Verifiable/reproducible* by someone else who buys the same part
|
||
- STEP provided (+ native CAD source if self-modeled)
|
||
- Documented well enough that a mount designer can build against it with confidence
|
||
- TBD, expect criteria to evolve
|
||
|
||
The maintainer selects among compliant candidates using these criteria. Multiple attempts
|
||
are welcome and useful even if not selected — models are swappable, and a non-selected
|
||
model is still a valid reference and a fallback.
|