{
  "metadata": {
    "id": "stepperonline-17hs08-1004s",
    "name": "STEPPERONLINE 17HS08-1004S",
    "type": "motor",
    "description": "Short-body NEMA 17 bipolar stepper motor for extruders. 16 N·cm (22.6 oz·in) holding torque, 1.8° step, 1.0 A/phase, 4-wire.",
    "manufacturer": "STEPPERONLINE",
    "part_number": "17HS08-1004S",
    "datasheet_url": "https://www.omc-stepperonline.com/download/17HS08-1004S.pdf",
    "tags": [
      "nema17",
      "stepper",
      "bipolar",
      "extruder",
      "3d-printer"
    ],
    "schema_version": "1.4.0",
    "version": "0.3.0",
    "taxonomy": [
      "actuator.motor.stepper"
    ]
  },
  "domains": [
    {
      "domain": "electrical",
      "power_domains": [
        {
          "id": "phase_coils",
          "name": "Stepper Phase Coils",
          "nominal_voltage_V": 3.7,
          "voltage_range_V": [
            0,
            24
          ],
          "isolation_type": "non_isolated",
          "ground_reference": "floating",
          "description": "Per-phase DC winding. Current-driven; voltage shown is I*R rating."
        }
      ],
      "resources": [
        {
          "id": "lead_black",
          "name": "Lead BLK (A)",
          "functions": [
            {
              "name": "PHASE_A",
              "description": "Phase A lead",
              "direction": "bidirectional",
              "signal_class": "power"
            }
          ],
          "power_domain_id": "phase_coils",
          "current_rating": {
            "source": {
              "max_continuous_mA": 1000
            },
            "sink": {
              "max_continuous_mA": 1000
            }
          },
          "connector_type": "wire",
          "notes": "Black wire per datasheet"
        },
        {
          "id": "lead_green",
          "name": "Lead GRN (Ā)",
          "functions": [
            {
              "name": "PHASE_A_BAR",
              "description": "Phase A complement",
              "direction": "bidirectional",
              "signal_class": "power"
            }
          ],
          "power_domain_id": "phase_coils",
          "current_rating": {
            "source": {
              "max_continuous_mA": 1000
            },
            "sink": {
              "max_continuous_mA": 1000
            }
          },
          "connector_type": "wire",
          "notes": "Green wire per datasheet"
        },
        {
          "id": "lead_red",
          "name": "Lead RED (B)",
          "functions": [
            {
              "name": "PHASE_B",
              "description": "Phase B lead",
              "direction": "bidirectional",
              "signal_class": "power"
            }
          ],
          "power_domain_id": "phase_coils",
          "current_rating": {
            "source": {
              "max_continuous_mA": 1000
            },
            "sink": {
              "max_continuous_mA": 1000
            }
          },
          "connector_type": "wire",
          "notes": "Red wire per datasheet"
        },
        {
          "id": "lead_blue",
          "name": "Lead BLU (B̄)",
          "functions": [
            {
              "name": "PHASE_B_BAR",
              "description": "Phase B complement",
              "direction": "bidirectional",
              "signal_class": "power"
            }
          ],
          "power_domain_id": "phase_coils",
          "current_rating": {
            "source": {
              "max_continuous_mA": 1000
            },
            "sink": {
              "max_continuous_mA": 1000
            }
          },
          "connector_type": "wire",
          "notes": "Blue wire per datasheet"
        }
      ],
      "interfaces": [
        {
          "id": "bipolar_stepper_phases",
          "name": "Bipolar stepper, 2-phase",
          "protocol": {
            "type": "bipolar_stepper_phases",
            "role": "motor"
          },
          "requires": [
            {
              "function": "PHASE_A",
              "count": 1,
              "shareable_with": []
            },
            {
              "function": "PHASE_A_BAR",
              "count": 1,
              "shareable_with": []
            },
            {
              "function": "PHASE_B",
              "count": 1,
              "shareable_with": []
            },
            {
              "function": "PHASE_B_BAR",
              "count": 1,
              "shareable_with": []
            }
          ],
          "constraints": {
            "max_connections": 1,
            "requires_connector_type": "wire",
            "requires_matching_voltage_domain": false
          },
          "description": "Connect to a bipolar stepper driver with current limit set to 1.0 A/phase."
        }
      ],
      "supply_voltage_V": [
        12,
        24
      ],
      "power_consumption_mW": 7400,
      "pin_count": 4,
      "metadata": {
        "package_type": "Motor with flying leads"
      }
    },
    {
      "domain": "mechanical",
      "resources": [
        {
          "id": "front_face_mount",
          "name": "Front face mounting pattern",
          "functions": [
            {
              "name": "MECHANICAL_MOUNT",
              "description": "NEMA 17 front face 4x M3 clearance",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "through_hole",
          "description": "31±0.2 mm bolt circle, 4×M3, min depth 2.5 mm"
        },
        {
          "id": "output_shaft",
          "name": "D-cut output shaft",
          "functions": [
            {
              "name": "SHAFT_OUTPUT",
              "description": "5 mm D-shaft for coupler/gear",
              "direction": "source",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "custom",
          "description": "Ø5 mm shaft, 20 mm length, D-flat 16.5 mm"
        }
      ],
      "interfaces": [
        {
          "id": "mounting_interface",
          "name": "NEMA 17 front mount",
          "protocol": {
            "type": "mechanical_connection",
            "role": "mounting_point"
          },
          "requires": [
            {
              "function": "MECHANICAL_MOUNT",
              "count": 4
            }
          ],
          "max_instances": 1,
          "description": "Use four M3 screws, observe 2.5 mm min thread depth."
        },
        {
          "id": "shaft_interface",
          "name": "Shaft output",
          "protocol": {
            "type": "mechanical_connection",
            "role": "custom"
          },
          "requires": [
            {
              "function": "SHAFT_OUTPUT",
              "count": 1
            }
          ],
          "max_instances": 1,
          "description": "Couple with 5 mm bore coupler or gear. Keep radial/axial loads within motor ratings."
        }
      ],
      "package_type": "NEMA 17 frame",
      "dimensions_mm": {
        "length": 20,
        "width": 42.3,
        "height": 42.3
      },
      "weight_g": 140,
      "mount_holes": [
        {
          "location": "front",
          "diam_mm": 3
        }
      ],
      "metadata": {
        "mounting_method": "Front face 4×M3",
        "field_serviceable": false,
        "requires_special_tools": false
      }
    }
  ],
  "usage_notes": "Set driver current limit to 1.0 A/phase. Typical microstepping 16× or higher. Rated voltage is I×R of a winding; bus voltage of 12–24 V is common with chopper drivers.",
  "application_examples": [
    "3D printer filament extruder",
    "Compact linear stage"
  ],
  "compatibility_notes": "Requires a bipolar stepper driver. Four-lead wiring: BLK=A, GRN=Ā, RED=B, BLU=B̄.",
  "warnings": [
    "Do not exceed 1.0 A/phase without thermal evaluation.",
    "Avoid excessive axial/radial shaft loads; use proper couplers and alignment."
  ]
}