{ "model": { "rank": 6155, "code": "thing-q178805", "model_id": "vr.tr.joystick", "name": "joystick", "purpose": "Enable an AI agent to recognise a joystick, assess whether its directional input is usable and appropriate, and determine how it may be connected, configured, operated or serviced.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/q178805/", "tier": 2, "score": 62, "payload": { "layer": "wikidata", "aliases": [ "Spectravideo Quickshot II Turbo", "Spectravideo QuickShot I", "Microsoft SideWinder 3D Pro", "Circle Pad", "Logitech WingMan Joystick", "Logitech WingMan Extreme", "Logitech Wingman Extreme Digital", "Logitech WingMan Force 3D", "Logitech WingMan Attack 2", "Logitech Attack 3", "Logitech Freedom 2.4", "Logitech WingMan Warrior", "Logitech Wingman Force", "Logitech WingMan Extreme Digital 3D", "Logitech WingMan Attack", "SPJ-1", "pointing stick", "analog stick", "Atari CX40 joystick", "Kempston Interface", "TAC-2", "Logitech Extreme 3D Pro", "Spaceball 2003", "Ace Combat 6 Flight Stick", "Panther XL", "Saitek X52", "Super Advantage", "The Arcade", "Sega Dreamcast Twin Stick", "Control Stick", "C-Stick" ], "aliasCount": 31, "merged": 31, "knownIn": 62, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": null, "source": { "dataset": "wikidata", "item": "Q178805", "url": "https://www.wikidata.org/wiki/Q178805", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T11:52:33Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00996914, "turns": 1, "seconds": 124.1, "error": null }, "codex": { "seconds": 82.9, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.3\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a07bb1-dcc3-79b0-baf7-2fd06baa7be9\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: joystick\nRegistry id: vr.tr.joystick\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Vercy" } } }, "metaModel": { "id": "THING-Q178805", "registryId": "vr.tr.joystick", "name": "joystick", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q178805/", "model": { "registry_id": "vr.tr.joystick", "name": "joystick", "purpose": "Enable an AI agent to recognise a joystick, assess whether its directional input is usable and appropriate, and determine how it may be connected, configured, operated or serviced.", "definition": "A joystick is a human inceptor in which a lever, constrained by a gimbal or equivalent kinematics and usually spring-returned to a defined null, converts operator displacement or applied force about two or more axes (sometimes with a twist axis) into discrete or continuous command signals for a vehicle, cursor, camera, or machine.", "scope_statement": "This model owns the physical joystick assembly, its hand-operated directional mechanism, input characteristics, integrated controls, interfaces and operating condition, including a joystick module embedded in a larger controller.", "in_scope": [ "The stick, grip, pivot or force-sensing mechanism, base and mounting arrangement", "Directional axes, permitted movement, gates, centring and position retention", "Translation of stick movement or applied force into control signals", "Buttons, triggers, hats and feedback mechanisms integrated into the joystick assembly", "Connection, calibration, input faults and readiness for an identified use" ], "out_of_scope": [ "The complete gamepad, console, cockpit or control panel surrounding an embedded joystick", "The vehicle, machine, game or software receiving joystick commands", "Application command mappings and control laws beyond their relationship to joystick inputs", "The operator's skills, qualifications and medical condition", "Standalone pedals, throttles, steering wheels and other neighbouring input devices" ], "distinguishing_features": [ "A projecting stick or handle accepts directional deflection or directional force relative to a supporting base; a force-sensing joystick need not visibly move.", "Directional input comes from the stick mechanism rather than solely from pressing separate directional keys, as on a directional pad.", "The primary action is pushing or tilting a handle directionally rather than rolling a ball, rotating a wheel or sliding a finger across a surface.", "The device supplies control input to another system; a superficially similar lever that directly moves a load through a linkage needs an explicit boundary decision.", "A joystick can be identified as a component within a gamepad or panel without treating every control on that surrounding assembly as part of the joystick." ], "characteristics": [ { "name": "Assembly boundary", "kind": "category", "unit_or_values": "standalone device | embedded module | integrated machine control | unresolved", "why_it_matters": "Determines which housing, controls, connections and service actions belong to this joystick." }, { "name": "Directional input principle", "kind": "category", "unit_or_values": "displacement-sensitive | force-sensitive | hybrid | unknown", "why_it_matters": "Determines whether movement, applied force or both must be assessed." }, { "name": "Input axes and controls", "kind": "category", "unit_or_values": "Named directional axes, optional twist axis, and integrated buttons, triggers or hats", "why_it_matters": "Identifies the independently observable inputs and prevents confusing a hat switch with a primary axis." }, { "name": "Travel and gate", "kind": "measurement", "unit_or_values": "Angular travel in degrees or linear travel in mm by axis, with permitted direction or gate description; not applicable where appropriate", "why_it_matters": "Constrains reachable positions and helps distinguish intended stops from restricted movement." }, { "name": "Rest behaviour", "kind": "category", "unit_or_values": "spring-centred | position-retaining | detented | mixed by axis | unknown", "why_it_matters": "Establishes what should happen when the operator releases the stick." }, { "name": "Operating force", "kind": "measurement", "unit_or_values": "N at a specified grip point, direction and displacement; torque in N·m where relevant", "why_it_matters": "Supports assessment of controllability, stiffness and changes in mechanical condition." }, { "name": "Output behaviour", "kind": "category", "unit_or_values": "Discrete directions or proportional values, with documented ranges, resolution and polarity per channel", "why_it_matters": "Determines how physical input can be interpreted and whether full command range is available." }, { "name": "Neutral stability", "kind": "measurement", "unit_or_values": "Offset and variation in raw counts, documented signal units or percent of full scale under stated test conditions", "why_it_matters": "Helps detect unintended input at the documented rest or neutral condition." }, { "name": "Connection and host compatibility", "kind": "relation", "unit_or_values": "Connected host or controller, physical interface, protocol and required adapter or driver", "why_it_matters": "Distinguishes a physically connected joystick from one whose inputs the receiving system can correctly interpret." }, { "name": "Feedback capability", "kind": "category", "unit_or_values": "none | passive resistance | vibration | active force feedback | combination | unknown", "why_it_matters": "Identifies additional power, configuration and movement considerations." }, { "name": "Operational condition", "kind": "state", "unit_or_values": "untested | usable for stated task | degraded | intermittent | unusable, with observed symptoms", "why_it_matters": "Makes readiness conditional on evidence and intended use rather than appearance alone." } ], "affordances": [ "Mount or position the joystick so its intended movement and integrated controls remain accessible.", "Connect it to a compatible receiver and inspect available input channels.", "Exercise its axes and integrated controls while observing output in a suitable test context.", "Calibrate supported axes and adjust supported dead zones or response settings.", "Use directional input and integrated controls to issue commands within the receiving system's permitted operation.", "Diagnose drift, sticking, missing input or feedback faults and perform supported maintenance or replacement." ] }, "sources": [ { "id": "usb-hid-usage-tables", "title": "HID Usage Tables (Generic Desktop: Joystick, Game Pad, Multi-axis Controller)", "url": "https://www.usb.org/hid", "what_it_supports": "Canonical device-class identity of a joystick versus a game pad or multi-axis controller in USB HID, including usage IDs used as product identifiers.", "url_status": "unverified" }, { "id": "iso-9355-3", "title": "ISO 9355-3: Ergonomic requirements for the design of displays and control actuators - Part 3: Control actuators", "url": "", "what_it_supports": "Treats the joystick as a two-axis control actuator and supplies the ergonomic quantities (travel, force, null) that industrial and machinery practice records." }, { "id": "iec-60204-1", "title": "IEC 60204-1: Safety of machinery - Electrical equipment of machines", "url": "", "what_it_supports": "Places operator control devices, including joysticks on machinery, under electrical-equipment and stop/enable rules used on industrial sticks." }, { "id": "wikipedia-joystick", "title": "Joystick", "url": "https://en.wikipedia.org/wiki/Joystick", "what_it_supports": "Historical split of contact versus analog sticks, aviation and game use, and the common neighbour terms (yoke, D-pad, pointing stick) checked against specialist usage.", "url_status": "live" } ], "structure": { "bundles": [ { "id": "joystick-identity-and-boundary", "name": "Joystick identity and boundary", "description": "Establishes which physical mechanism is the joystick and which controls belong to it.", "rationale": "Embedded sticks and lever-like controls are easily confused with their surrounding controller or with mechanically acting levers.", "layers": [ { "id": "directional-control-identity", "name": "Directional control identity", "description": "Tests whether the candidate functions as a joystick.", "findings": [ { "id": "stick-input-principle", "name": "Stick input principle", "description": "Record how directional movement or force applied to the handle produces an input.", "questions": [ { "text": "Does the handle produce directional control input through deflection, applied force or both?", "kind": "definition", "id": "stick-input-principle-q01" }, { "text": "What distinguishes this mechanism from a directional pad, rotary control or directly acting mechanical lever?", "kind": "boundary", "id": "stick-input-principle-q02" } ] } ] }, { "id": "assembly-membership", "name": "Assembly membership", "description": "Locates the joystick within a standalone device or larger control assembly.", "findings": [ { "id": "included-controls-and-housing", "name": "Included controls and housing", "description": "Record the stick module, grip controls, base and enclosing assembly without conflating their identities.", "questions": [ { "text": "Which grip, base, buttons, triggers and hats are included in this joystick's boundary?", "kind": "boundary", "id": "included-controls-and-housing-q01" }, { "text": "Which label, manual or assembly drawing establishes the joystick's manufacturer, model and variant?", "kind": "provenance", "id": "included-controls-and-housing-q02" } ] } ] } ] }, { "id": "directional-mechanics", "name": "Directional mechanics", "description": "Describes permitted stick movement, resistance and behaviour on release.", "rationale": "A joystick's mechanical constraints determine reachable inputs and whether observed resistance or return behaviour indicates a fault.", "layers": [ { "id": "axes-and-travel", "name": "Axes and travel", "description": "Identifies independent motions or force directions and their limits.", "findings": [ { "id": "movement-envelope", "name": "Movement envelope", "description": "Record axes, twist capability, gates, stops and any coupling between directions.", "questions": [ { "text": "Which directional and twist inputs are independent, and which combinations does the gate permit?", "kind": "definition", "id": "movement-envelope-q01" }, { "text": "What travel or force range is available along each input direction under a stated measurement method?", "kind": "measurement", "id": "movement-envelope-q02" } ] } ] }, { "id": "centring-and-feel", "name": "Centring and feel", "description": "Distinguishes intended rest behaviour and resistance from mechanical degradation.", "findings": [ { "id": "release-and-resistance-behaviour", "name": "Release and resistance behaviour", "description": "Record centring, retention, detents, free play and operating resistance by axis.", "questions": [ { "text": "When released from different positions, where should each axis settle and where does it actually settle?", "kind": "measurement", "id": "release-and-resistance-behaviour-q01" }, { "text": "What evidence distinguishes designed detents or resistance from sticking, looseness or obstruction?", "kind": "provenance", "id": "release-and-resistance-behaviour-q02" } ] } ] } ] }, { "id": "input-signal-and-calibration", "name": "Input signal and calibration", "description": "Connects physical stick input to the values observed by the receiver.", "rationale": "Free movement alone cannot establish that a joystick reports neutral, direction or magnitude correctly.", "layers": [ { "id": "channel-interpretation", "name": "Channel interpretation", "description": "Makes the meaning of each reported channel explicit.", "findings": [ { "id": "axis-and-button-output", "name": "Axis and button output", "description": "Record proportional or discrete outputs, polarity, range and integrated control events.", "questions": [ { "text": "Which observed channels correspond to each stick direction, twist motion and integrated control?", "kind": "definition", "id": "axis-and-button-output-q01" }, { "text": "What values or events occur at rest, intermediate inputs and reachable limits?", "kind": "measurement", "id": "axis-and-button-output-q02" } ] } ] }, { "id": "neutral-and-response-quality", "name": "Neutral and response quality", "description": "Assesses drift, noise, discontinuities and calibration dependence.", "findings": [ { "id": "calibrated-input-fidelity", "name": "Calibrated input fidelity", "description": "Record whether repeatable physical inputs produce expected outputs and where corrective settings apply.", "questions": [ { "text": "How stable and repeatable are neutral and axis outputs during rest, repeated sweeps and return to the same position?", "kind": "measurement", "id": "calibrated-input-fidelity-q01" }, { "text": "Which supported calibration or dead-zone changes address the observed problem, and are they stored in the joystick or receiving system?", "kind": "action", "id": "calibrated-input-fidelity-q02" } ] } ] } ] }, { "id": "connection-mounting-and-feedback", "name": "Connection, mounting and feedback", "description": "Establishes the physical and electrical conditions required for usable input and supported feedback.", "rationale": "Mount movement, interface mismatches and feedback configuration can change joystick behaviour even when the stick mechanism is intact.", "layers": [ { "id": "installation-and-interface", "name": "Installation and interface", "description": "Relates mounting, orientation and connection to the receiving system.", "findings": [ { "id": "installed-input-path", "name": "Installed input path", "description": "Record support, clearance, orientation and the interface path through which inputs reach the host.", "questions": [ { "text": "Does the installed position support full intended operation without base movement, cable strain or grip interference?", "kind": "measurement", "id": "installed-input-path-q01" }, { "text": "What documented connector, power supply, protocol, adapter or driver is required for this receiver to read the joystick?", "kind": "provenance", "id": "installed-input-path-q02" } ] } ] }, { "id": "feedback-operation", "name": "Feedback operation", "description": "Identifies passive and powered effects acting through the joystick.", "findings": [ { "id": "feedback-capability-and-test", "name": "Feedback capability and test", "description": "Record whether resistance, vibration or active forces are present and how their operation can be assessed.", "questions": [ { "text": "Which felt effects arise from passive mechanics, vibration or commanded force feedback?", "kind": "definition", "id": "feedback-capability-and-test-q01" }, { "text": "What supported procedure enables, limits, tests or disables powered feedback for this installation?", "kind": "action", "id": "feedback-capability-and-test-q02" } ] } ] } ] }, { "id": "condition-and-permitted-use", "name": "Condition and permitted use", "description": "Turns joystick-specific observations into decisions about operation, troubleshooting and service.", "rationale": "A joystick may remain partly functional while producing unintended commands or losing a direction needed for its assigned task.", "layers": [ { "id": "fault-evidence", "name": "Fault evidence", "description": "Separates mechanical, signal, connection and configuration symptoms.", "findings": [ { "id": "input-failure-localisation", "name": "Input failure localisation", "description": "Record drift, dead directions, intermittent controls, sticking and connection loss with reproducible conditions.", "questions": [ { "text": "Under what stick positions, button actions, cable movements or operating durations does the symptom occur?", "kind": "measurement", "id": "input-failure-localisation-q01" }, { "text": "Which supported test can distinguish a joystick fault from host mapping, calibration or connection problems?", "kind": "action", "id": "input-failure-localisation-q02" } ] } ] }, { "id": "readiness-and-service", "name": "Readiness and service", "description": "Connects observed capability to the intended task and supported maintenance.", "findings": [ { "id": "task-specific-operability", "name": "Task-specific operability", "description": "Record usable input capabilities, unresolved limitations and evidence required before returning the joystick to use.", "questions": [ { "text": "Which required directions, precision, rest behaviour and integrated controls must work for the identified task?", "kind": "boundary", "id": "task-specific-operability-q01" }, { "text": "Given the observed condition and applicable service instructions, should the joystick be used, recalibrated, serviced or replaced, and what retest is required?", "kind": "action", "id": "task-specific-operability-q02" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Contact (digital/switch) stick with on-off gates, as in arcade and early home computers", "Resistive analog stick using potentiometers on each axis", "Contactless magnetic (Hall-effect or inductive) analog stick", "Isometric / force-sensing stick with negligible travel (strain-gauge or similar)", "Gamepad analog thumbstick (short-throw, finger-operated)", "Flight stick and HOTAS / aircraft sidestick or centre-stick inceptor, often with hats, triggers and trim", "Industrial and mobile-machine stick (IP-rated, often 12-24 V, with enable or dead-man functions)", "Assistive / powered-wheelchair proportional stick" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-identifiers", "name": "Identifiers and schemes", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "scheme": "Wikidata", "value_or_pattern": "Q178005", "note": "Item for the device class 'joystick'." }, { "scheme": "USB HID Usage Tables, Generic Desktop Page (0x01)", "value_or_pattern": "Usage 0x04 Joystick (distinct from 0x05 Game Pad and 0x08 Multi-axis Controller)", "note": "How a USB device declares itself as a joystick to hosts." } ], "questions": [ { "id": "evidence-identifiers-q01", "text": "Which of these identifiers and schemes hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "USB Device Class Definition for HID / HID Usage Tables - USB Implementers Forum (device identity and report descriptors).", "ISO 9355-3 - International Organization for Standardization (ergonomics of control actuators, including joysticks).", "IEC 60204-1 - International Electrotechnical Commission (electrical equipment of machines; operator controls).", "ISO 13849-1 - International Organization for Standardization (safety-related parts of control systems when a stick is an enabling or safety inceptor).", "IEC 60529 - International Electrotechnical Commission (IP code widely specified on industrial sticks).", "ISO 7176-14 - International Organization for Standardization (power and control systems of electrically powered wheelchairs, including joystick controls).", "14 CFR Part 25 / EASA CS-25 - FAA and EASA (flight-control inceptors on transport aeroplanes; aviation practice avoids the consumer word 'joystick' in certification text)." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Arcade cabinets and home game controllers, including dual analog thumbsticks on current gamepads.", "Desktop flight-simulation HOTAS and, in certified aircraft, sidestick or centre-stick inceptors commanding pitch and roll.", "Mobile machinery (excavators, cranes, telehandlers, forklifts) for boom, slew and travel, often with a dead-man or seat switch.", "Powered wheelchairs and other assistive vehicles as the primary directional control.", "Remote manipulators, camera pan-tilt, marine thrusters, and radio-controlled models." ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "quantity": "Angular travel per axis (displacement sticks)", "typical_range": "about ±15 to ±30 (thumbsticks often near ±20)", "unit": "degree" }, { "quantity": "Force at full deflection", "typical_range": "about 0.5-3 (thumbstick) to 5-20 (industrial or flight)", "unit": "newton" }, { "quantity": "Analog electrical output (5 V industrial/game pots or Hall)", "typical_range": "0.5-4.5 (with a centre near 2.5)", "unit": "volt" }, { "quantity": "Digitized axis resolution (HID / ADC)", "typical_range": "8-16", "unit": "bit" }, { "quantity": "Mechanical life (specified cycles to a given wear limit)", "typical_range": "1e6-1e7 (contactless industrial often specified at the high end)", "unit": "cycle" }, { "quantity": "Ingress protection (industrial)", "typical_range": "IP40 (desktop) through IP65-IP67, occasionally IP69K", "unit": "IP code (IEC 60529)" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "Potentiometer track wear or contamination causing jitter, dropouts, or an axis jump.", "Return-spring fatigue or breakage leaving a residual off-null command.", "Gimbal play and hysteresis that grow the deadband and hide small commands.", "Hall-sensor offset drift with temperature, read as a phantom deflection.", "Uncommanded motion of a vehicle, crane, wheelchair, or aircraft if a failed stick is treated as a valid inceptor.", "Cable and connector fatigue at the boot; contact bounce on digital gates.", "Electromagnetic interference on analog lines producing false commands.", "Operator repetitive-strain injury from high-force or poorly placed sticks." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "In certified aviation English the device is a control stick, sidestick, or centre stick; 'joystick' is mainly a consumer and simulation word.", "German usage splits Joystick (games, HID) from Steuerknüppel (aircraft) and Industriesteuerknüppel (machinery catalogues).", "Console and Japanese practice name the embedded finger control an analog stick / アナログスティック rather than a joystick.", "EU machinery suppliers almost always quote an IP code and often a SIL/PL claim; North American game and PC sticks are specified as USB HID devices with cycle life and USB voltage only." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ { "name": "Control yoke (control wheel)", "difference": "A two-handed wheel or ram's-horn rotating about a shaft plus a pitch axis; not a single pivoted lever in a gimbal." }, { "name": "Directional pad (D-pad)", "difference": "A discrete four- or eight-way switch field with no pivoting shaft and no analog travel." }, { "name": "Trackball", "difference": "A free-rolling sphere without a centering spring or stick; position is integrated from rotation, not from lever angle." }, { "name": "Pointing stick (e.g. TrackPoint)", "difference": "An isometric nipple on a keyboard that reports force only; it is not a handheld or panel lever on a gimbal." }, { "name": "Throttle / thrust lever", "difference": "Typically a one-axis linear or gated lever for power, not a two-axis direction inceptor (though a twist or slider on a stick may duplicate a throttle axis)." }, { "name": "6-DoF compliant cap (e.g. 3D mouse)", "difference": "A low-travel cap sensing translation and rotation in six axes, not a stick constrained to a two-axis gimbal." }, { "name": "Gamepad (as a whole device)", "difference": "USB HID usage 0x05; it may contain thumbsticks, but the enclosure, D-pad and button set are the game pad, not the joystick class (usage 0x04)." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of joystick this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry intend joystick to include hydraulic or pneumatic pilot controls and mechanically linked control sticks, or should those link to neighbouring models?", "Should an embedded thumbstick receive an independent instance identity when it cannot be serviced separately from its parent controller?", "Which measurements and acceptance thresholds are appropriate across gaming, assistive, industrial and vehicle-control joysticks?", "Where should persistent calibration and response settings be owned when device firmware, drivers and applications each transform the same input?", "Which manufacturer evidence is needed to distinguish intended force feedback, detents and position retention from faults for each joystick variant?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 28 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "device, machine or tool", "method": "Written from the archetype playbook - what this kind of thing needs beyond identity and provenance - and from the structure that recurred across 6,333 models already researched by two engines. Applied to this entry by rule. No source was read for this thing and no claim here is researched. This entry carries no facets of its own, so they were inferred from its domain - a guess about a whole domain applied to one thing.", "facetsInferred": true, "nextPass": "A researcher replaces this draft with a sourced specification. Treat every sentence below as a proposal to argue with.", "purpose": "Give an agent a durable, checkable way to recognise a joystick, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to recognise a joystick, assess whether its directional input is usable and appropriate, and determine how it may be connected, configured, operated or serviced.", "characteristics": { "substance": "material", "origin": "manufactured", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: Spectravideo Quickshot II Turbo, Spectravideo QuickShot I, Microsoft SideWinder 3D Pro, Circle Pad, Logitech WingMan Joystick, Logitech WingMan Extreme, Logitech Wingman Extreme Digital, Logitech WingMan Force 3D, Logitech WingMan Attack 2, Logitech Attack 3, Logitech Freedom 2.4, Logitech WingMan Warrior.", "31 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 62 Wikipedia languages, which is a measure of how widely the thing is known, not of how important it is." ], "openQuestionsForResearch": [ "Which of the bundles below does a real task actually need, and which are ceremony?", "What does this thing have that the facets do not capture at all?", "Which neighbouring kind is most often confused with a joystick, and on what evidence are they told apart?" ], "whatItIsMadeOf": "matter you can touch", "physicalCharacter": [ "Mobility varies between examples.", "Does nothing on its own; everything it does, something else did to it.", "These come from the domain this entry sits in rather than from the entry itself, so treat them as a first guess about the whole domain applied to one thing." ], "whatCanBeDoneWithIt": [ "observe it, measure it, record its state" ], "howItIsRecognised": [ "Recognised by form, by the arrangement of its controls, and by markings - a plate, a model number, a certification mark. Form alone rarely separates two models that do very different things." ], "relatedModels": [ { "relation": "covers", "note": "Finer kinds folded into this entry because telling them apart needs a task that asks for it. Each is a model waiting to be split out when one does.", "targets": [ "Spectravideo Quickshot II Turbo", "Spectravideo QuickShot I", "Microsoft SideWinder 3D Pro", "Circle Pad", "Logitech WingMan Joystick", "Logitech WingMan Extreme", "Logitech Wingman Extreme Digital", "Logitech WingMan Force 3D", "Logitech WingMan Attack 2", "Logitech Attack 3", "Logitech Freedom 2.4", "Logitech WingMan Warrior" ] } ], "standing": "Described in 62 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 31 finer distinctions are held inside this entry as names rather than as separate models.", "structure": { "bundles": [ { "id": "identity-and-classification", "name": "Identity, naming and classification", "description": "How an agent tells one joystick from another, and a joystick from things that resemble it.", "rationale": "Recognition comes before every other claim. Without stable identity nothing else in the model can be trusted to be about the same thing twice.", "layers": [ { "id": "naming-and-identifiers", "name": "Names and identifiers", "description": "The names this thing goes by and the identifiers that survive translation and time.", "findings": [ { "id": "preferred-name-and-aliases", "name": "Preferred name, aliases and local names", "description": "Which name to use, which names mean the same thing, and which merely sound similar.", "questions": [ { "id": "preferred-name-and-aliases-q01", "text": "What identifies and describes the name of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "preferred-name-and-aliases-q02", "text": "Who or what asserted this about the name of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "preferred-name-and-aliases-q03", "text": "What may an agent decide or do once the name of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "stable-identifiers", "name": "Stable identifiers and external keys", "description": "Identifiers that keep pointing at this kind of thing across systems and languages.", "questions": [ { "id": "stable-identifiers-q01", "text": "What identifies and describes an identifier for a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stable-identifiers-q02", "text": "Who or what asserted this about an identifier for a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stable-identifiers-q03", "text": "What may an agent decide or do once an identifier for a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "classification-and-granularity", "name": "Classification and granularity", "description": "Where a joystick sits among kinds, and how finely a task needs to cut it.", "findings": [ { "id": "kind-and-parents", "name": "Kind, parents and neighbouring kinds", "description": "The classes this thing belongs to and the ones it is next to.", "questions": [ { "id": "kind-and-parents-q01", "text": "What identifies and describes the kind of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "kind-and-parents-q02", "text": "Who or what asserted this about the kind of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "kind-and-parents-q03", "text": "What may an agent decide or do once the kind of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "distinguishing-features", "name": "Distinguishing features", "description": "What separates a joystick from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "distinguishing-features-q02", "text": "Who or what asserted this about what distinguishes a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "distinguishing-features-q03", "text": "What may an agent decide or do once what distinguishes a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "form-and-composition", "name": "Form, composition and condition", "description": "What a joystick is made of, what shape and size it takes, and what state it is in.", "rationale": "A physical thing can be measured, and a model that cannot record its measurements cannot support any decision that depends on them.", "layers": [ { "id": "form-and-dimensions", "name": "Form and dimensions", "description": "Shape, size, mass and the ranges these take across examples.", "findings": [ { "id": "measurable-dimensions", "name": "Measurable dimensions and their units", "description": "The quantities worth recording and the units they are recorded in.", "questions": [ { "id": "measurable-dimensions-q01", "text": "What identifies and describes the dimensions of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "measurable-dimensions-q02", "text": "Who or what asserted this about the dimensions of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "measurable-dimensions-q03", "text": "What may an agent decide or do once the dimensions of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "material-and-composition", "name": "Material and composition", "description": "Materials, parts and how they are put together.", "findings": [ { "id": "parts-and-materials", "name": "Parts and materials", "description": "What a joystick is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "parts-and-materials-q02", "text": "Who or what asserted this about the composition of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "parts-and-materials-q03", "text": "What may an agent decide or do once the composition of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "condition-and-integrity", "name": "Condition and integrity", "description": "Wear, damage, health and the difference between working and broken.", "findings": [ { "id": "condition-assessment", "name": "Condition, damage and health", "description": "How the condition of a joystick is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "condition-assessment-q02", "text": "Who or what asserted this about the condition of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "condition-assessment-q03", "text": "What may an agent decide or do once the condition of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "place-and-movement", "name": "Place and movement", "description": "Where a joystick is, how it got there and where it may go (varies).", "rationale": "A thing that can move needs its position recorded with a time, or every later claim about it is about a place it has left.", "layers": [ { "id": "location-and-placement", "name": "Location and placement", "description": "Position, containment and the reference frame the position is given in.", "findings": [ { "id": "position-and-frame", "name": "Position, container and reference frame", "description": "Where a joystick is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "position-and-frame-q02", "text": "Who or what asserted this about the location of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "position-and-frame-q03", "text": "What may an agent decide or do once the location of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "movement-and-transfer", "name": "Movement and transfer", "description": "How a joystick is carried, installed or relocated.", "findings": [ { "id": "movement-events", "name": "Movement events and constraints", "description": "What counts as a movement, what records it and what limits it.", "questions": [ { "id": "movement-events-q01", "text": "What identifies and describes the movement of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "movement-events-q02", "text": "Who or what asserted this about the movement of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "movement-events-q03", "text": "What may an agent decide or do once the movement of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "state-and-lifecycle", "name": "State and lifecycle", "description": "The states a joystick passes through and the events that move it between them.", "rationale": "Most decisions about a thing depend on what state it is in now, which is a claim with a time on it, not a property.", "layers": [ { "id": "lifecycle-stages", "name": "Lifecycle stages", "description": "From coming into existence to ceasing to be one of these.", "findings": [ { "id": "stages-and-transitions", "name": "Stages and transitions", "description": "The stages worth naming and what moves a joystick between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stages-and-transitions-q02", "text": "Who or what asserted this about the lifecycle of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stages-and-transitions-q03", "text": "What may an agent decide or do once the lifecycle of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "observations-and-status", "name": "Observations and current status", "description": "What is observed about a joystick, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a joystick is recorded so that it can be superseded rather than overwritten.", "questions": [ { "id": "observation-record-q01", "text": "What identifies and describes an observation of a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "observation-record-q02", "text": "Who or what asserted this about an observation of a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "observation-record-q03", "text": "What may an agent decide or do once an observation of a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "function-and-principle", "name": "Function and operating principle", "description": "What joystick is for and how it achieves it.", "rationale": "Two devices with the same name can work on different principles, and the principle is what predicts failure and constrains use.", "layers": [ { "id": "intended-function", "name": "Intended function", "description": "The job it does, and the jobs it is used for anyway.", "findings": [ { "id": "function-record", "name": "Function, principle and variants", "description": "What it does, how, and which variants do it differently.", "questions": [ { "id": "function-record-q01", "text": "What function does joystick perform, on what operating principle, and which variants differ in that principle?", "kind": "definition" }, { "id": "function-record-q02", "text": "What use falls outside the intended function but happens in practice?", "kind": "boundary" } ] } ] }, { "id": "capacity-and-rating", "name": "Capacity and rating", "description": "The numbers that say what it can do and where it stops.", "findings": [ { "id": "ratings", "name": "Ratings and their conditions", "description": "Rated capacity, power, throughput and the conditions each assumes.", "questions": [ { "id": "ratings-q01", "text": "What ratings characterise joystick, in what units, and under what stated conditions?", "kind": "measurement" }, { "id": "ratings-q02", "text": "What happens beyond the rating - degradation, refusal, damage - and how is that detected?", "kind": "action" } ] } ] } ] }, { "id": "operation-and-state", "name": "Operation, controls and state", "description": "How joystick is operated and what state it is in right now.", "rationale": "An agent acting on a device needs its current state and the controls that change it, not just its specification.", "layers": [ { "id": "controls-and-modes", "name": "Controls and modes", "description": "What can be set, what that changes, and what is interlocked.", "findings": [ { "id": "control-surface", "name": "Control surface and interlocks", "description": "The settings available and the conditions that block them.", "questions": [ { "id": "control-surface-q01", "text": "What controls and modes does joystick have, and what does each change?", "kind": "definition" }, { "id": "control-surface-q02", "text": "Which actions are interlocked or forbidden in which state, and what must be true before acting?", "kind": "action" } ] } ] }, { "id": "condition-and-maintenance", "name": "Condition and maintenance", "description": "Wear, service intervals, consumables and the line between working and broken.", "findings": [ { "id": "service-record", "name": "Condition, service and consumables", "description": "What is consumed, what is serviced, and how condition is judged.", "questions": [ { "id": "service-record-q01", "text": "What consumables and service does joystick need, at what interval, and on whose authority?", "kind": "measurement" }, { "id": "service-record-q02", "text": "What evidence separates a unit that is working from one that is out of service?", "kind": "boundary" } ] } ] } ] }, { "id": "kind-model-unit", "name": "Kind, model and unit", "description": "Whether a claim about joystick is about the kind, a product line, or one physical unit.", "rationale": "This is the boundary most often got wrong for made things, and getting it wrong mixes a catalogue entry with the machine in the yard.", "layers": [ { "id": "level-of-reference", "name": "Level of reference", "description": "The three levels and what belongs at each.", "findings": [ { "id": "level-rules", "name": "What belongs to kind, model and unit", "description": "Which properties are shared by all of them and which are not.", "questions": [ { "id": "level-rules-q01", "text": "Which facts about joystick hold for every one of them, which for a model, and which only for one unit?", "kind": "boundary" }, { "id": "level-rules-q02", "text": "What identifies an individual unit, and what should an agent do when it has only the kind?", "kind": "action" } ] } ] }, { "id": "standards-and-conformity", "name": "Standards and conformity", "description": "The standards a working example must meet and who attests it.", "findings": [ { "id": "conformity", "name": "Standards, marks and attestation", "description": "Which standard applies, who certifies, and what the mark means.", "questions": [ { "id": "conformity-q01", "text": "Which standards govern joystick, issued by whom, and what does conformity actually assert?", "kind": "provenance" }, { "id": "conformity-q02", "text": "What may an agent conclude from a certification mark, and what may it not?", "kind": "boundary" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a joystick came from and when it held.", "rationale": "A claim without a source and a time cannot be superseded, only overwritten, and an agent that overwrites loses the ability to explain itself.", "layers": [ { "id": "source-and-authority", "name": "Source and authority", "description": "Who said it, on what evidence, and how strongly.", "findings": [ { "id": "claim-provenance", "name": "Claim provenance and confidence", "description": "The authority behind each claim about a joystick and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "claim-provenance-q02", "text": "Who or what asserted this about a claim about a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "claim-provenance-q03", "text": "What may an agent decide or do once a claim about a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "time-and-versions", "name": "Time, versions and supersession", "description": "When a claim was true, when it was learnt, and what replaced it.", "findings": [ { "id": "validity-and-supersession", "name": "Validity period and supersession", "description": "How an old claim about a joystick is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a joystick, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "validity-and-supersession-q02", "text": "Who or what asserted this about the validity of a claim about a joystick, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "validity-and-supersession-q03", "text": "What may an agent decide or do once the validity of a claim about a joystick is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 8, "layers": 17, "findings": 19, "questions": 51 } } } }