From 753d80640038ed5e53d0a4fc9215bcd1cc9fba64 Mon Sep 17 00:00:00 2001 From: seveibar Date: Fri, 2 Oct 2026 17:32:21 -0700 Subject: [PATCH 1/2] Document assembly.motor and motor board mounting --- docs/elements/assembly-device.mdx | 4 +- docs/elements/assembly-motor.mdx | 115 +++++++++++++++ docs/elements/board.mdx | 2 + .../assembly-previews/assembly-motor-1.json | 136 ++++++++++++++++++ ...ly-motor-board-mounting-annotated.snap.png | Bin 0 -> 102955 bytes 5 files changed, 255 insertions(+), 2 deletions(-) create mode 100644 docs/elements/assembly-motor.mdx create mode 100644 src/data/assembly-previews/assembly-motor-1.json create mode 100644 static/img/elements/assembly-motor-board-mounting-annotated.snap.png diff --git a/docs/elements/assembly-device.mdx b/docs/elements/assembly-device.mdx index abaedc69..b54196cb 100644 --- a/docs/elements/assembly-device.mdx +++ b/docs/elements/assembly-device.mdx @@ -35,7 +35,7 @@ export default () => ( | `name` | Optional device name. | | `model` | Modelprinter string or HTTP(S) model URL. | | `modelUrl` | Imported CAD model URL. Use either `model` or `modelUrl`. | -| `children` | Boards, subassemblies, and screens. | +| `children` | Boards, motors, subassemblies, and screens. | ## Modelprinter strings @@ -59,4 +59,4 @@ export default () => ( Assembly models add 3D geometry without creating PCB footprints or electrical connections. For imported models, see [`cadmodel`](./cadmodel.mdx) for supported formats. -Use [`assembly.subassembly`](./assembly-subassembly.mdx) to group mechanical parts, or [`assembly.screen`](./assembly-screen.mdx) to attach a display to a connector. See [Mounting 3D models](../guides/tscircuit-essentials/mounting-3d-models.mdx) for screws aligned with board holes. +Use [`assembly.motor`](./assembly-motor.mdx) to add a NEMA motor and mount a controller to its backface, [`assembly.subassembly`](./assembly-subassembly.mdx) to group mechanical parts, or [`assembly.screen`](./assembly-screen.mdx) to attach a display to a connector. See [Mounting 3D models](../guides/tscircuit-essentials/mounting-3d-models.mdx) for screws aligned with board holes. diff --git a/docs/elements/assembly-motor.mdx b/docs/elements/assembly-motor.mdx new file mode 100644 index 00000000..e6102458 --- /dev/null +++ b/docs/elements/assembly-motor.mdx @@ -0,0 +1,115 @@ +--- +title: +description: Add a NEMA stepper motor to an assembly and mount a PCB to its backface. +--- + +import CircuitPreview from "@site/src/components/CircuitPreview" +import preview1 from "@site/src/data/assembly-previews/assembly-motor-1.json" + +`assembly.motor` adds a NEMA stepper motor to an [`assembly.device`](./assembly-device.mdx). Choose a standard frame or customize the body and shaft with a modelprinter string. The motor has no PCB footprint or schematic symbol. + +![TSX examples on the left and 3D renders on the right comparing a NEMA17 above and below a PCB, with 6 mm clearance from the motor backface to the nearest PCB surface.](/img/elements/assembly-motor-board-mounting-annotated.snap.png) + +## Mount a controller to the motor + +Give the motor a `name`, then set the board's `mountedTo` to that name followed by `.backface`. A controller component must forward `mountedTo` and `mountGap` to its underlying [`board`](./board.mdx), as `MotorController` does here: + + ( + + + + + + {/* Add your controller components and traces here. */} + +) + +export default () => ( + + + + +)`} +/> + +`backface` is the face opposite the shaft. `mountGap` is the clearance between that face and the nearest PCB surface, rather than the PCB center plane. The example places a 1.6 mm board 6 mm from the motor's rear face, with the shaft pointing below the board. + +Mounting keeps the board's PCB layout in the XY plane at Z = 0. The motor follows the board's center and rotation in that plane. Add mounting holes and standoffs yourself; mounting props do not create them. The example's four holes use the default NEMA17 rear-hole spacing of 31 mm. + +## Motor properties + +| Property | Type | Description | +|----------|------|-------------| +| `name` | `string` | Required motor name, used by board mount references. | +| `displayName` | `string` | Optional display label. | +| `standard` | `"nema8" \| "nema17" \| "nema23"` | Standard modelprinter motor dimensions. Use either `standard` or `model`. | +| `model` | `string` | NEMA modelprinter string for custom dimensions. | +| `shaftFacingDirection` | `"x+" \| "x-" \| "y+" \| "y-" \| "z+" \| "z-"` | Optional shaft direction; defaults to `"z+"`. | + +Supply exactly one of `standard` or `model`. The standard selects representative dimensions; choose a custom `model` when your motor has a different body or shaft length. + +## Customize the body and shaft + +Use `model` to specify dimensions without generating or supplying a model URL: + +```tsx +import { assembly } from "@tscircuit/core" + +const model = + "nema17_bodylength38mm_shaftlength24mm" + + "_flatdepth0.5mm_flatlength15mm" + +export default () => ( + + + +) +``` + +This model has a 38 mm body, a 24 mm shaft, and a D-flat 0.5 mm deep over the last 15 mm of the shaft. The `nema8`, `nema17`, and `nema23` standards can all be customized with modelprinter parameters. + +## Shaft directions and board mounting + +Directions use circuit coordinates: +X right, +Y top, and +Z above. + +| Direction | Shaft points | +|-----------|--------------| +| `x+`, `x-` | Right, left | +| `y+`, `y-` | Toward +Y, toward −Y | +| `z+`, `z-` | Above, below | + +All six directions render motor models. Board backface mounting currently supports `z+` and `z-`: the motor is above the PCB for `z+`, and below it for `z-`. Mounting a board to a sideways motor reports an error until rotated PCB boards are supported. + +| Board property | Type | Description | +|----------------|------|-------------| +| `mountedTo` | `string` | Motor face reference, such as `"NEMA17.backface"`. | +| `mountGap` | `string \| number` | Nonnegative distance in millimetres, such as `"6mm"` or `6`. Defaults to zero when mounted; only meaningful with `mountedTo`. | + +Mount references resolve by exact motor name within the nearest `assembly.device`, regardless of declaration order. Names in sibling devices remain independent. Missing or duplicate targets, unsupported faces, and multiple boards trying to position one motor report errors. + +An unmounted motor's origin is at the world origin on its shaft-side mounting face. Its backface lies one body length behind that face, so changing `bodylength` also changes the placement needed for a mounted board. diff --git a/docs/elements/board.mdx b/docs/elements/board.mdx index 415ffb47..716e5fce 100644 --- a/docs/elements/board.mdx +++ b/docs/elements/board.mdx @@ -48,6 +48,8 @@ import CircuitPreview from '@site/src/components/CircuitPreview' | `outlineOffsetX`, `outlineOffsetY` | `string \| number` | Offset a custom outline relative to the bounding box origin. | | `material` | `'fr4' \| 'fr1' \| 'flex'` | PCB substrate material. Defaults to `'fr4'`. | | `thickness` | `string \| number` | Board thickness in millimeters. | +| `mountedTo` | `string` | Mount to a named motor face, such as `"NEMA17.backface"`. See [`assembly.motor`](./assembly-motor.mdx). | +| `mountGap` | `string \| number` | Clearance from the motor backface to the nearest PCB surface, in millimeters. Defaults to zero when `mountedTo` is set. | | `title` | `string` | Title for the board, displayed in documentation and exports. | | `solderMaskColor` | `string` | Color applied to both top and bottom solder masks. | | `topSolderMaskColor` | `string` | Color of the top solder mask. | diff --git a/src/data/assembly-previews/assembly-motor-1.json b/src/data/assembly-previews/assembly-motor-1.json new file mode 100644 index 00000000..1df70148 --- /dev/null +++ b/src/data/assembly-previews/assembly-motor-1.json @@ -0,0 +1,136 @@ +[ + { + "type": "source_project_metadata", + "source_project_metadata_id": "source_project_metadata_0", + "software_used_string": "@tscircuit/core@0.0.2058" + }, + { + "type": "source_group", + "source_group_id": "source_group_0", + "is_subcircuit": true, + "was_automatically_named": true, + "subcircuit_id": "subcircuit_source_group_0" + }, + { + "type": "source_component", + "source_component_id": "source_component_0", + "ftype": "simple_chip", + "name": "NEMA17" + }, + { + "type": "source_board", + "source_board_id": "source_board_0", + "source_group_id": "source_group_0" + }, + { + "type": "schematic_group", + "schematic_group_id": "schematic_group_0", + "is_subcircuit": true, + "subcircuit_id": "subcircuit_source_group_0", + "name": "unnamed_board1", + "center": { + "x": 0, + "y": 0 + }, + "width": 0, + "height": 0, + "schematic_component_ids": [], + "source_group_id": "source_group_0", + "show_as_schematic_box": false + }, + { + "type": "pcb_board", + "pcb_board_id": "pcb_board_0", + "source_board_id": "source_board_0", + "subcircuit_id": "subcircuit_source_group_0", + "center": { + "x": 0, + "y": 0 + }, + "thickness": 1.6, + "num_layers": 2, + "width": 42, + "height": 42, + "material": "fr4", + "min_trace_width": 0.1, + "min_via_hole_diameter": 0.2, + "min_via_pad_diameter": 0.3, + "min_via_hole_edge_to_via_hole_edge_clearance": 0.1, + "min_trace_to_hole_edge_clearance": 0.2, + "min_trace_to_pad_edge_clearance": 0.1, + "min_pad_edge_to_pad_edge_clearance": 0.1, + "min_plated_hole_drill_edge_to_drill_edge_clearance": 0.15, + "min_board_edge_clearance": 0.2 + }, + { + "type": "pcb_hole", + "pcb_hole_id": "pcb_hole_0", + "pcb_component_id": null, + "hole_shape": "circle", + "hole_diameter": 3.2, + "x": -15.5, + "y": -15.5, + "is_covered_with_solder_mask": false, + "subcircuit_id": "subcircuit_source_group_0" + }, + { + "type": "pcb_hole", + "pcb_hole_id": "pcb_hole_1", + "pcb_component_id": null, + "hole_shape": "circle", + "hole_diameter": 3.2, + "x": -15.5, + "y": 15.5, + "is_covered_with_solder_mask": false, + "subcircuit_id": "subcircuit_source_group_0" + }, + { + "type": "pcb_hole", + "pcb_hole_id": "pcb_hole_2", + "pcb_component_id": null, + "hole_shape": "circle", + "hole_diameter": 3.2, + "x": 15.5, + "y": -15.5, + "is_covered_with_solder_mask": false, + "subcircuit_id": "subcircuit_source_group_0" + }, + { + "type": "pcb_hole", + "pcb_hole_id": "pcb_hole_3", + "pcb_component_id": null, + "hole_shape": "circle", + "hole_diameter": 3.2, + "x": 15.5, + "y": 15.5, + "is_covered_with_solder_mask": false, + "subcircuit_id": "subcircuit_source_group_0" + }, + { + "type": "cad_component", + "cad_component_id": "cad_component_0", + "model_glb_url": "https://modelcdn.tscircuit.com/jscad_models/nema17.glb", + "position": { + "x": 0, + "y": 0, + "z": -44.8 + }, + "rotation": { + "x": 0, + "y": 180, + "z": 0 + }, + "layer": "bottom", + "source_component_id": "source_component_0", + "subcircuit_id": "subcircuit_source_group_0", + "model_origin_position": { + "x": 0, + "y": 0, + "z": 0 + }, + "model_unit_to_mm_scale_factor": 1, + "model_object_fit": "contain_within_bounds", + "anchor_alignment": "center", + "show_as_translucent_model": false + } +] diff --git a/static/img/elements/assembly-motor-board-mounting-annotated.snap.png b/static/img/elements/assembly-motor-board-mounting-annotated.snap.png new file mode 100644 index 0000000000000000000000000000000000000000..9a97ea3416fbf49214dca51b58a1abdaebd5334c GIT binary patch literal 102955 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 literal 0 HcmV?d00001 From 1bdae5e206b990c39207ad15b9b502a052346f42 Mon Sep 17 00:00:00 2001 From: seveibar Date: Fri, 2 Oct 2026 17:48:56 -0700 Subject: [PATCH 2/2] Clarify built-in motor options and current custom CAD limitations --- docs/elements/assembly-device.mdx | 2 +- docs/elements/assembly-motor.mdx | 18 ++++++++++++------ 2 files changed, 13 insertions(+), 7 deletions(-) diff --git a/docs/elements/assembly-device.mdx b/docs/elements/assembly-device.mdx index b54196cb..caaf2575 100644 --- a/docs/elements/assembly-device.mdx +++ b/docs/elements/assembly-device.mdx @@ -59,4 +59,4 @@ export default () => ( Assembly models add 3D geometry without creating PCB footprints or electrical connections. For imported models, see [`cadmodel`](./cadmodel.mdx) for supported formats. -Use [`assembly.motor`](./assembly-motor.mdx) to add a NEMA motor and mount a controller to its backface, [`assembly.subassembly`](./assembly-subassembly.mdx) to group mechanical parts, or [`assembly.screen`](./assembly-screen.mdx) to attach a display to a connector. See [Mounting 3D models](../guides/tscircuit-essentials/mounting-3d-models.mdx) for screws aligned with board holes. +Use [`assembly.motor`](./assembly-motor.mdx) to add a motor and mount a controller to its backface, [`assembly.subassembly`](./assembly-subassembly.mdx) to group mechanical parts, or [`assembly.screen`](./assembly-screen.mdx) to attach a display to a connector. See [Mounting 3D models](../guides/tscircuit-essentials/mounting-3d-models.mdx) for screws aligned with board holes. diff --git a/docs/elements/assembly-motor.mdx b/docs/elements/assembly-motor.mdx index e6102458..c014e50a 100644 --- a/docs/elements/assembly-motor.mdx +++ b/docs/elements/assembly-motor.mdx @@ -1,12 +1,12 @@ --- title: -description: Add a NEMA stepper motor to an assembly and mount a PCB to its backface. +description: Represent a motor in an assembly and mount a PCB to its backface. --- import CircuitPreview from "@site/src/components/CircuitPreview" import preview1 from "@site/src/data/assembly-previews/assembly-motor-1.json" -`assembly.motor` adds a NEMA stepper motor to an [`assembly.device`](./assembly-device.mdx). Choose a standard frame or customize the body and shaft with a modelprinter string. The motor has no PCB footprint or schematic symbol. +`assembly.motor` represents a motor in an [`assembly.device`](./assembly-device.mdx). `standard` selects a built-in NEMA model; `model` supplies your own model specification. The examples below use a NEMA17 motor. The motor has no PCB footprint or schematic symbol. ![TSX examples on the left and 3D renders on the right comparing a NEMA17 above and below a PCB, with 6 mm clearance from the motor backface to the nearest PCB surface.](/img/elements/assembly-motor-board-mounting-annotated.snap.png) @@ -63,13 +63,19 @@ Mounting keeps the board's PCB layout in the XY plane at Z = 0. The motor follow |----------|------|-------------| | `name` | `string` | Required motor name, used by board mount references. | | `displayName` | `string` | Optional display label. | -| `standard` | `"nema8" \| "nema17" \| "nema23"` | Standard modelprinter motor dimensions. Use either `standard` or `model`. | -| `model` | `string` | NEMA modelprinter string for custom dimensions. | +| `standard` | `"nema8" \| "nema17" \| "nema23"` | Optional shortcut to a built-in motor model. Use either `standard` or `model`. | +| `model` | `string` | Custom modelprinter specification. The current motor renderer accepts NEMA specifications. | | `shaftFacingDirection` | `"x+" \| "x-" \| "y+" \| "y-" \| "z+" \| "z-"` | Optional shaft direction; defaults to `"z+"`. | -Supply exactly one of `standard` or `model`. The standard selects representative dimensions; choose a custom `model` when your motor has a different body or shaft length. +Supply exactly one of `standard` or `model`. A built-in standard selects representative dimensions; choose a custom `model` when your motor has a different body or shaft length. -## Customize the body and shaft +:::note Current custom CAD support + +The current `assembly.motor` implementation accepts NEMA modelprinter specifications and does not yet accept imported model URLs or `cadModel`. For an arbitrary motor CAD file, use [`assembly.subassembly`](./assembly-subassembly.mdx) with `model`, `modelUrl`, or `cadModel`. Board-to-motor backface mounting requires `assembly.motor`. + +::: + +## Customize a NEMA model Use `model` to specify dimensions without generating or supplying a model URL: