{
  "id": "mba-m1-usb-disabled",
  "modelId": "mba-m1",
  "title": "USB Devices Disabled: accessory and hub isolation",
  "intent": "Determine whether the warning follows an accessory, a port or a hub power arrangement.",
  "category": "connections",
  "sourceIds": [
    "mac-usb",
    "mac-spec",
    "mac-safety"
  ],
  "diagramId": "laptop-m1-ports",
  "prerequisites": [
    "Only owned, trusted USB equipment is involved",
    "Any accessible external storage is safely ejected before disconnection"
  ],
  "tools": [
    "Affected accessory",
    "Hub’s documented power supply if it is self-powered"
  ],
  "steps": [
    {
      "id": "inventory",
      "text": "Record whether the warning involves storage, an input device or another peripheral, and whether it was direct or through a hub. Stop transfers before changing the connection.",
      "sourceIds": [
        "mac-usb"
      ],
      "locator": "Opening: external devices and power messages; original worksheet"
    },
    {
      "id": "reconnect",
      "text": "Safely disconnect and reconnect the accessory. If it is storage and cannot be ejected safely, pause and ask for support instead of unplugging during activity.",
      "sourceIds": [
        "mac-usb"
      ],
      "locator": "Troubleshooting → disconnect and reconnect; conservative data-preservation limit"
    },
    {
      "id": "direct",
      "text": "Compare the accessory directly on the Mac, using only its documented adapter if required. Keep other nonessential USB accessories disconnected for a clear result.",
      "sourceIds": [
        "mac-usb"
      ],
      "locator": "Troubleshooting → connect directly instead of hub"
    },
    {
      "id": "port",
      "text": "Compare the same direct accessory on the other USB-C port without changing its cable. If no compatible direct path is available, leave this row Not tested.",
      "sourceIds": [
        "mac-usb",
        "mac-spec"
      ],
      "locator": "Troubleshooting → different port; Charging and Expansion"
    },
    {
      "id": "hub",
      "text": "For a self-powered hub, verify its specified AC supply is connected. Compare the powered hub path only after recording the direct result; persistent warnings go to Apple or the accessory vendor.",
      "sourceIds": [
        "mac-usb"
      ],
      "locator": "Troubleshooting → self-powered hub / contact Apple"
    }
  ],
  "checks": [
    {
      "id": "safety",
      "question": "Is there swelling, a lifted case or trackpad, liquid damage, smoke, a burning smell, or damaged power equipment?",
      "goal": "Establish whether any powered comparison is safe.",
      "sourceIds": [
        "mac-safety"
      ],
      "options": [
        {
          "id": "safe",
          "label": "No visible danger",
          "next": "disconnect"
        },
        {
          "id": "danger",
          "label": "Yes, or suspected damage",
          "next": "stop"
        },
        {
          "id": "unknown",
          "label": "Not checked / unsure",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "disconnect",
      "question": "Can the accessory be disconnected safely, with storage transfers stopped?",
      "goal": "Protect data before changing connections.",
      "sourceIds": [
        "mac-usb"
      ],
      "options": [
        {
          "id": "yes",
          "label": "Ready for a safe comparison",
          "next": "direct"
        },
        {
          "id": "no",
          "label": "Storage busy or safe removal uncertain",
          "next": "attention"
        },
        {
          "id": "unknown",
          "label": "Not checked / unsure",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "direct",
      "question": "Does the same accessory work directly on the Mac?",
      "goal": "Separate hub behavior.",
      "sourceIds": [
        "mac-usb"
      ],
      "options": [
        {
          "id": "yes",
          "label": "Works directly",
          "next": "hub"
        },
        {
          "id": "no",
          "label": "Direct warning/failure on available ports",
          "next": "service"
        },
        {
          "id": "unavailable",
          "label": "No compatible direct path",
          "next": "attention"
        },
        {
          "id": "unknown",
          "label": "Not checked / unsure",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "hub",
      "question": "What is the hub comparison?",
      "goal": "Identify the next accessory support question.",
      "sourceIds": [
        "mac-usb"
      ],
      "options": [
        {
          "id": "works",
          "label": "Works with documented hub power",
          "next": "ready"
        },
        {
          "id": "fails",
          "label": "Direct works; hub still fails",
          "next": "hub-help"
        },
        {
          "id": "none",
          "label": "No hub is involved",
          "next": "ready"
        },
        {
          "id": "unknown",
          "label": "Not checked / unsure",
          "next": "uncertain"
        }
      ]
    }
  ],
  "terminals": {
    "ready": {
      "type": "preparation_saved",
      "title": "USB connection condition saved",
      "text": "Keep the path and power arrangement that worked.",
      "handoff": [
        "Record direct-port results and hub power state.",
        "Repeat only if the warning returns under the same safe conditions."
      ]
    },
    "hub-help": {
      "type": "maintenance_possible",
      "title": "Take the hub result to its vendor",
      "text": "The accessory worked directly but the documented hub path did not.",
      "handoff": [
        "Provide hub model and its power supply details privately.",
        "Include the direct baseline and remaining hub warning."
      ]
    },
    "service": {
      "type": "service_needed",
      "title": "Request a USB accessory review",
      "text": "The available direct comparisons still fail. This result cannot identify a replaceable Mac port.",
      "handoff": [
        "Bring accessory, cable and direct-port results to Apple or its vendor.",
        "Flag storage involvement and any unverified backup before repair."
      ]
    },
    "attention": {
      "type": "maintenance_possible",
      "title": "Preserve the missing comparison",
      "text": "Safe removal or a compatible direct connection is not available.",
      "handoff": [
        "Finish file activity and verify a safe removal path first.",
        "Ask the accessory vendor to confirm the supported direct adapter."
      ]
    },
    "uncertain": {
      "type": "preparation_saved",
      "title": "Keep the unanswered checks visible",
      "text": "The direct path, safe-removal state or hub power requirement is still unknown.",
      "handoff": [
        "Identify accessory category and original direct/hub path.",
        "Provide the safe-removal limitation and tested ports without device contents.",
        "Keep unperformed conditions marked Not tested. Ask the provider to confirm these before further changes."
      ]
    },
    "stop": {
      "type": "service_needed",
      "title": "Stop the powered checks",
      "text": "Stop using or charging damaged equipment. Keep away from hot or smoking equipment; obtain emergency help for an immediate fire risk. Arrange manufacturer guidance before handling or transport.",
      "handoff": [
        "Tell Apple about the visible damage before arranging a MacBook Air service.",
        "Identify accessory category and original direct/hub path.",
        "Do not open the case, remove the battery, press a lifted surface, or continue a test to complete this record."
      ]
    }
  },
  "missing": "The direct path, safe-removal state or hub power requirement is still unknown.",
  "handoff": [
    "Identify accessory category and original direct/hub path.",
    "Provide the safe-removal limitation and tested ports without device contents."
  ],
  "outcomeChecks": [
    "Hub power and direct-port results are separate.",
    "Storage was not disconnected during transfers."
  ],
  "workflow": {
    "family": "power-comparison",
    "summary": "Trace the same accessory through direct ports and its documented powered hub.",
    "osOptions": [
      "macos26-plus",
      "macos-earlier",
      "macos-unknown"
    ],
    "fields": [
      {
        "id": "usb-kind",
        "label": "Accessory category",
        "type": "select",
        "options": [
          {
            "value": "unknown",
            "label": "Not identified"
          },
          {
            "value": "storage",
            "label": "External storage"
          },
          {
            "value": "input",
            "label": "Keyboard/mouse"
          },
          {
            "value": "camera-audio",
            "label": "Camera/audio"
          },
          {
            "value": "other",
            "label": "Another trusted peripheral"
          }
        ]
      },
      {
        "id": "hub-power",
        "label": "Hub power arrangement",
        "type": "select",
        "options": [
          {
            "value": "unknown",
            "label": "Unknown"
          },
          {
            "value": "no-hub",
            "label": "No hub"
          },
          {
            "value": "bus",
            "label": "Bus-powered hub"
          },
          {
            "value": "self-powered",
            "label": "Self-powered with specified supply"
          }
        ]
      },
      {
        "id": "warning-scope",
        "label": "Warning follows",
        "type": "select",
        "options": [
          {
            "value": "unknown",
            "label": "Not established"
          },
          {
            "value": "hub-only",
            "label": "Hub path only"
          },
          {
            "value": "one-port",
            "label": "One direct port"
          },
          {
            "value": "both-ports",
            "label": "Both direct ports"
          },
          {
            "value": "cleared",
            "label": "No warning now"
          }
        ]
      }
    ],
    "matrix": {
      "title": "Same accessory, different path",
      "rows": [
        {
          "id": "direct-a",
          "label": "First direct USB-C port",
          "condition": "Same accessory/cable, no hub"
        },
        {
          "id": "direct-b",
          "label": "Other direct USB-C port",
          "condition": "Same accessory/cable, no hub"
        },
        {
          "id": "powered-hub",
          "label": "Documented powered hub",
          "condition": "Same accessory with hub’s specified supply connected"
        }
      ],
      "results": [
        {
          "value": "not-tested",
          "label": "Not tested"
        },
        {
          "value": "works",
          "label": "Works in this condition"
        },
        {
          "value": "fails",
          "label": "Fails in this condition"
        },
        {
          "value": "intermittent",
          "label": "Intermittent"
        },
        {
          "value": "not-applicable",
          "label": "Not applicable"
        }
      ]
    },
    "reportFocus": [
      "Accessory category",
      "Direct versus hub result",
      "Port comparison and storage limits"
    ],
    "notDoneGuidance": [
      "Do not force a plug or test an undocumented power supply.",
      "If safe storage removal is unavailable, keep further rows Not tested."
    ]
  },
  "entityKind": "task",
  "version": "2.0.0",
  "deviceFamily": "laptop",
  "modelApplicability": {
    "id": "mba-m1",
    "name": "MacBook Air M1",
    "family": "laptop",
    "revision": "MacBook Air (M1, 2020), Apple M1 chip",
    "os": "macOS Big Sur or later; Ventura and later call the preferences app System Settings. Diagnostic screens vary by macOS.",
    "region": "US-first; local repair provider requirements vary.",
    "help": "Choose Apple menu → About This Mac. Confirm MacBook Air (M1, 2020) and Chip: Apple M1. An Intel processor or another chip does not match.",
    "exclusions": [
      "MacBook Air Intel 2020",
      "MacBook Air M2",
      "MacBook Pro M1"
    ],
    "sourceIds": [
      "mac-id",
      "mac-spec",
      "mac-diagnostics"
    ]
  },
  "exclusions": [
    "MacBook Air Intel 2020",
    "MacBook Air M2",
    "MacBook Pro M1"
  ],
  "materials": [
    "Keep any existing backup accessible to you.",
    "Keep credentials and personal files outside this record."
  ],
  "stopConditions": [
    "Stop using and charging equipment with swelling, casing separation, smoke, a burning smell or suspected battery damage. Do not open or press on it.",
    "Set damaged accessories aside. Do not open mains adapters or force connectors.",
    "Do not erase, reset, flash firmware or bypass a lock as a default diagnostic step."
  ],
  "branches": [
    {
      "from": "safety",
      "answer": "safe",
      "to": "disconnect"
    },
    {
      "from": "safety",
      "answer": "danger",
      "to": "stop"
    },
    {
      "from": "safety",
      "answer": "unknown",
      "to": "uncertain"
    },
    {
      "from": "disconnect",
      "answer": "yes",
      "to": "direct"
    },
    {
      "from": "disconnect",
      "answer": "no",
      "to": "attention"
    },
    {
      "from": "disconnect",
      "answer": "unknown",
      "to": "uncertain"
    },
    {
      "from": "direct",
      "answer": "yes",
      "to": "hub"
    },
    {
      "from": "direct",
      "answer": "no",
      "to": "service"
    },
    {
      "from": "direct",
      "answer": "unavailable",
      "to": "attention"
    },
    {
      "from": "direct",
      "answer": "unknown",
      "to": "uncertain"
    },
    {
      "from": "hub",
      "answer": "works",
      "to": "ready"
    },
    {
      "from": "hub",
      "answer": "fails",
      "to": "hub-help"
    },
    {
      "from": "hub",
      "answer": "none",
      "to": "ready"
    },
    {
      "from": "hub",
      "answer": "unknown",
      "to": "uncertain"
    }
  ],
  "sources": [
    {
      "id": "mac-usb",
      "title": "USB Devices Disabled on Mac",
      "url": "https://support.apple.com/en-us/102204",
      "locator": "Troubleshooting list",
      "purpose": "Other port, direct accessory and documented self-powered hub supply",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-spec",
      "title": "MacBook Air (M1, 2020) technical specifications",
      "url": "https://support.apple.com/en-us/111883",
      "locator": "Charging and Expansion / Display Support",
      "purpose": "Two USB-C Thunderbolt/USB4 ports and one native external display up to 6K at 60 Hz",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-safety",
      "title": "Important safety information for your Mac",
      "url": "https://support.apple.com/guide/macbook-air/important-safety-information-apd9b8f7aa11/mac",
      "locator": "Handling / Built-in battery / Charging",
      "purpose": "General damaged-equipment and moisture safety only; M1-specific connections are sourced from mac-spec",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-id",
      "title": "Identify MacBook Air model",
      "url": "https://support.apple.com/en-ie/102869",
      "locator": "Find model / MacBook Air M1 2020",
      "purpose": "Model and chip confirmation",
      "checkedAt": "2026-10-04",
      "reuse": "Reference only. Original paraphrase; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-diagnostics",
      "title": "Use Apple Diagnostics to test your Mac",
      "url": "https://support.apple.com/en-gb/102550",
      "locator": "Prepare / Apple silicon / Run Apple Diagnostics / Results",
      "purpose": "M1 Options then Command-D; Tahoe 26+ selected tests versus earlier automatic testing; preserve reference code",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    },
    {
      "id": "mac-display",
      "title": "External display dark or low resolution",
      "url": "https://support.apple.com/en-gb/102501",
      "locator": "Connections / Support limits / Detection / Accessory permission",
      "purpose": "Direct video path, Detect Displays and detection versus image",
      "checkedAt": "2026-10-13",
      "reuse": "Reference only. Original paraphrase and observation worksheets; no copied images or manual pages.",
      "licenseStatus": "Public support document; no redistribution license assumed."
    }
  ],
  "assets": [
    {
      "id": "laptop-m1-ports",
      "path": "/assets/laptop-m1-ports.svg",
      "title": "M1 Air connection map",
      "alt": "Original schematic showing two left USB-C ports, right headphone jack and a direct one-display comparison.",
      "sourceIds": [
        "mac-spec",
        "mac-display"
      ],
      "caption": "Original schematic, not to scale. MacBook Air M1 (2020); one native external display. Inspect the real connector before use.",
      "kind": "Original schematic"
    }
  ],
  "relatedIds": [
    "mba-m1-usbc-charge",
    "mba-m1-diagnostics",
    "mba-m1-safe-mode"
  ],
  "estimatedDuration": {
    "minutes": 20,
    "label": "Planning estimate for recording observations; excludes charging, backups, drying and service. Not a measured repair time."
  },
  "legacyVersion": "1.0.0",
  "legacyChecks": [
    {
      "id": "safety",
      "goal": "Separate unsafe hardware from routine preparation.",
      "question": "Any swelling, casing separation, liquid damage, smoke, burning smell, or damaged battery/adapter?",
      "sourceIds": [
        "mac-charge"
      ],
      "options": [
        {
          "id": "safe",
          "label": "No visible danger",
          "next": "check-1"
        },
        {
          "id": "danger",
          "label": "Yes, or suspected damage",
          "next": "stop"
        },
        {
          "id": "unknown",
          "label": "I cannot confirm",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "check-1",
      "goal": "Isolate hub power and connection.",
      "question": "Have you compared one device directly rather than through an unpowered hub?",
      "sourceIds": [
        "mac-usb"
      ],
      "options": [
        {
          "id": "yes",
          "label": "Yes",
          "next": "check-2"
        },
        {
          "id": "no",
          "label": "No",
          "next": "attention"
        },
        {
          "id": "unknown",
          "label": "Not checked / unsure",
          "next": "uncertain"
        }
      ]
    },
    {
      "id": "check-2",
      "goal": "Observe recognition.",
      "question": "Is the accessory recognized without the disabled-device alert?",
      "sourceIds": [
        "mac-usb"
      ],
      "options": [
        {
          "id": "yes",
          "label": "Recognized normally",
          "next": "ready"
        },
        {
          "id": "no",
          "label": "Alert or failure remains",
          "next": "service"
        },
        {
          "id": "unknown",
          "label": "Not checked / unsure",
          "next": "uncertain"
        }
      ]
    }
  ],
  "legacyPreparation": [
    "Only owned trusted accessories are used",
    "Storage devices are safely ejected before disconnecting",
    "Affected USB accessory",
    "Its required power supply, if self-powered",
    "A private place to keep your findings",
    "A current backup if the device is accessible"
  ]
}