{
  "metadata": {
    "id": "rev-11-2828-neo-vortex-solo-adapter",
    "name": "NEO Vortex Solo Adapter",
    "type": "adapter",
    "categories": [
      "FRC",
      "adapter",
      "motor"
    ],
    "description": "Breakout/docking adapter that mates to a REV NEO Vortex brushless motor and provides three external phase leads for use with non-docking controllers (e.g., SPARK MAX). Includes 4x mounting holes and 4x docking screw clearance holes for securing to the motor.",
    "manufacturer": "REV Robotics",
    "part_number": "REV-11-2828",
    "datasheet_url": "https://docs.revrobotics.com/brushless/neo/vortex/solo-adapter",
    "tags": [
      "REV",
      "NEO Vortex",
      "FRC",
      "brushless",
      "adapter",
      "phase leads"
    ],
    "schema_version": "1.4.0",
    "version": "1.2"
  },
  "domains": [
    {
      "domain": "electrical",
      "resources": [
        {
          "id": "motor_phase_a_bullet",
          "name": "Motor phase A bullet (dock side)",
          "functions": [
            {
              "name": "phase_a",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "phase_bullet",
          "description": "Dock-side phase bullet that mates to the NEO Vortex motor phase bullet."
        },
        {
          "id": "motor_phase_b_bullet",
          "name": "Motor phase B bullet (dock side)",
          "functions": [
            {
              "name": "phase_b",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "phase_bullet",
          "description": "Dock-side phase bullet that mates to the NEO Vortex motor phase bullet."
        },
        {
          "id": "motor_phase_c_bullet",
          "name": "Motor phase C bullet (dock side)",
          "functions": [
            {
              "name": "phase_c",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "phase_bullet",
          "description": "Dock-side phase bullet that mates to the NEO Vortex motor phase bullet."
        },
        {
          "id": "neo_vortex_brushless_motor_connector",
          "name": "NEO Vortex brushless motor connector",
          "description": "Connector for the NEO Vortex brushless motor.",
          "connector_type": "neo_vortex_brushless_motor_connector",
          "functions": [
            {
              "name": "neo_vortex_brushless_motor_connector"
            }
          ]
        },
        {
          "id": "controller_phase_a_lead",
          "name": "Controller phase A lead",
          "functions": [
            {
              "name": "phase_a",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "bare_lead",
          "description": "12 AWG phase lead intended to be terminated for connection to a motor controller phase output."
        },
        {
          "id": "controller_phase_b_lead",
          "name": "Controller phase B lead",
          "functions": [
            {
              "name": "phase_b",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "bare_lead",
          "description": "12 AWG phase lead intended to be terminated for connection to a motor controller phase output."
        },
        {
          "id": "controller_phase_c_lead",
          "name": "Controller phase C lead",
          "functions": [
            {
              "name": "phase_c",
              "direction": "bidirectional",
              "signal_class": "mechanical_drive"
            }
          ],
          "connector_type": "bare_lead",
          "description": "12 AWG phase lead intended to be terminated for connection to a motor controller phase output."
        }
      ],
      "interfaces": [
        {
          "id": "neo_vortex_motor_interface_connector",
          "name": "NEO Vortex motor docking interface",
          "protocol": {
            "type": "custom",
            "role": "peer"
          },
          "requires": [
            {
              "function": "neo_vortex_brushless_motor_connector",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "neo_vortex_brushless_motor_connector"
          },
          "description": "Docking interface to NEO Vortex motor using 4x M3 x 25 mm socket head cap screws inserted through counterbored clearance holes; tighten evenly (ideal torque 11.5 ±0.9 in-lb / 1.3 ±0.1 Nm per REV documentation)."
        },
        {
          "id": "brushless_phase_leads",
          "name": "Brushless motor phase leads (to controller)",
          "protocol": {
            "type": "custom",
            "role": "peer"
          },
          "requires": [
            {
              "function": "phase_a",
              "count": 1
            },
            {
              "function": "phase_b",
              "count": 1
            },
            {
              "function": "phase_c",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "bare_lead",
            "min_wire_gauge_awg": 12
          },
          "description": "External 3-phase leads (12 AWG) for connecting the docked motor phases to a compatible 3-phase BLDC motor controller."
        }
      ]
    },
    {
      "domain": "mechanical",
      "resources": [
        {
          "id": "mount_holes_x4",
          "name": "Mounting holes x4",
          "functions": [
            {
              "name": "mounting_holes_x4",
              "direction": "sink"
            }
          ],
          "connector_type": "threaded_hole",
          "description": "#10-32 threaded mounting hole on 2 in bolt circle; max thread engagement depth 0.25 in."
        },
        {
          "id": "docking_holes_x4",
          "name": "Docking screw clearance hole x4",
          "functions": [
            {
              "name": "docking_holes_x4",
              "direction": "sink"
            }
          ],
          "connector_type": "through_hole",
          "description": "Counterbored docking screw clearance hole for M3 x 25 mm SHCS (threads into motor)."
        }
      ],
      "interfaces": [
        {
          "id": "mounting_holes",
          "name": "Mounting holes (4x #10-32)",
          "protocol": {
            "type": "threaded_connection",
            "role": "mounting_point"
          },
          "requires": [
            {
              "function": "mounting_holes_x4",
              "count": 1
            }
          ],
          "description": "4x #10-32 threaded mounting holes on a 2 in bolt circle; max depth 0.25 in (per REV documentation)."
        },
        {
          "id": "neo_vortex_docking",
          "name": "Docking to NEO Vortex (4x M3 screws)",
          "protocol": {
            "type": "threaded_connection",
            "role": "mounting_point"
          },
          "requires": [
            {
              "function": "docking_holes_x4",
              "count": 1
            }
          ],
          "description": "Docking interface to NEO Vortex motor using 4x M3 x 25 mm socket head cap screws inserted through counterbored clearance holes; tighten evenly (ideal torque 11.5 ±0.9 in-lb / 1.3 ±0.1 Nm per REV documentation)."
        }
      ]
    }
  ],
  "design_rules": [
    "Each dock-side phase bullet is internally connected one-to-one to its corresponding external phase lead (A↔A, B↔B, C↔C).",
    "Do not run the NEO Vortex motor while docked unless all four docking screws are installed and tightened."
  ],
  "warnings": [
    "DO NOT run the motor without the docking screws installed; doing so may cause damage and an unreliable electrical connection."
  ],
  "usage_notes": "This definition models the Solo Adapter as a passive dock/breakout: it does not add commutation electronics, sensing, or protection.\nPhase lead termination (e.g., ferrules, ring lugs, bullets) is application-specific and not included in this definition.",
  "compatibility_notes": "Designed to dock to REV NEO Vortex brushless motor and provide external 3-phase leads for connection to a compatible BLDC motor controller.\nMounting hole pattern and docking hardware are per REV documentation; verify clearances in your mechanical assembly."
}