feat: add spindle direction selection contract

This commit is contained in:
Nick Hermes
2026-06-02 15:40:16 +00:00
parent 02d9323c43
commit beeb521ca7
21 changed files with 689 additions and 133 deletions

View File

@@ -12,7 +12,8 @@
"supported_motion_families",
"force_range_n",
"table_rpm_range",
"spindle_rpm_range"
"spindle_rpm_range",
"supported_spindle_directions"
],
"properties": {
"schema_version": {
@@ -38,7 +39,9 @@
},
"supported_motion_families": {
"type": "array",
"items": { "type": "string" },
"items": {
"type": "string"
},
"minItems": 1
},
"force_range_n": {
@@ -60,22 +63,36 @@
"type": "object",
"description": "Force modulation capabilities. Omit entirely if unknown.",
"properties": {
"supported": { "type": "boolean" },
"max_harmonics": { "type": "integer" },
"max_amplitude_n": { "type": "number" },
"notes": { "type": "string" }
"supported": {
"type": "boolean"
},
"max_harmonics": {
"type": "integer"
},
"max_amplitude_n": {
"type": "number"
},
"notes": {
"type": "string"
}
}
},
"supported_dither_profiles": {
"type": "array",
"items": { "type": "string" },
"items": {
"type": "string"
},
"description": "List of dither profile names the controller can handle. Empty = none supported."
},
"segment_duration_limits": {
"type": "object",
"properties": {
"min_s": { "type": "number" },
"max_s": { "type": "number" }
"min_s": {
"type": "number"
},
"max_s": {
"type": "number"
}
}
},
"pause_resume_support": {
@@ -85,12 +102,23 @@
"type": "array",
"items": {
"type": "object",
"required": ["name", "unit"],
"required": [
"name",
"unit"
],
"properties": {
"name": { "type": "string" },
"unit": { "type": "string" },
"sample_rate_hz": { "type": "number" },
"notes": { "type": "string" }
"name": {
"type": "string"
},
"unit": {
"type": "string"
},
"sample_rate_hz": {
"type": "number"
},
"notes": {
"type": "string"
}
}
}
},
@@ -98,21 +126,46 @@
"type": "object",
"description": "Hard safety limits that the controller enforces regardless of job requests.",
"properties": {
"max_force_n": { "type": "number" },
"max_table_rpm": { "type": "number" },
"max_spindle_rpm": { "type": "number" },
"notes": { "type": "string" }
"max_force_n": {
"type": "number"
},
"max_table_rpm": {
"type": "number"
},
"max_spindle_rpm": {
"type": "number"
},
"notes": {
"type": "string"
}
}
},
"known_constraints": {
"type": "array",
"items": { "type": "string" },
"items": {
"type": "string"
},
"description": "Free-text list of known limitations, quirks, or warnings."
},
"unknowns": {
"type": "array",
"items": { "type": "string" },
"items": {
"type": "string"
},
"description": "Capabilities that have NOT been verified. Explicit unknowns prevent fake certainty."
},
"supported_spindle_directions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"cw",
"ccw"
]
},
"minItems": 1,
"uniqueItems": true,
"description": "Toolhead spindle rotation directions supported by the controller UI/protocol."
}
},
"$defs": {
@@ -120,7 +173,9 @@
"oneOf": [
{
"type": "array",
"items": { "type": "number" },
"items": {
"type": "number"
},
"minItems": 2,
"maxItems": 2,
"description": "[min, max] range."