Observed Symptoms & Error Messages
Users encountering this problem typically observe one or more of the following behaviors when running AirCard on macOS:
- The iPhone is connected via USB, but AirCard shows an empty dashboard with no cards or device info.
- The "Connect iPhone" animation continues looping indefinitely.
- The iPhone charges, but neither Finder nor AirCard registers the device.
- No trust dialogue appears on the iPhone screen when plugging the cable in.
Confirmed Technical Context
Documented in GitHub Issue #26. Affects users across macOS Ventura, Sonoma, and Sequoia when device pairing records are out of sync or when security restrictions prevent USB accessory interaction.
Step-by-Step Diagnostic Checklist
Work through the following checklist in sequence. Each step is designed to be safe, reversible, and targeted toward identifying the exact point of communication failure:
Check Lock Screen & USB Restricted Mode
Safe & ReversibleiOS includes a security feature called USB Restricted Mode that disables USB data accessories if your iPhone has been locked for more than an hour. Unlock your iPhone with Face ID, Touch ID, or your passcode before opening AirCard. On your iPhone, verify Settings > Face ID & Passcode > "Accessories" (or "USB Accessories") is toggled ON.
Reset Location & Privacy Trust Settings on iPhone
Safe & ReversibleIf the "Trust This Computer?" prompt previously failed to appear or was accidentally dismissed, reset your pairing trust. On your iPhone, open Settings > General > Transfer or Reset iPhone > Reset > Reset Location & Privacy. Enter your passcode. Unplug and replug the USB cable, and tap "Trust" when the prompt appears.
Inspect Device in macOS System Information
Safe & ReversibleOn your Mac, hold the Option (⌥) key, click the Apple logo () in the top-left menu bar, and select "System Information". Under "Hardware", click "USB". Check whether your iPhone appears in the USB device tree.
Ensure Finder Device Communication is Operational
Safe & ReversibleOpen a new Finder window. Check if your iPhone is visible under "Locations" in the sidebar. If Finder displays a button saying "Trust", click it. AirCard relies on the same system-level MobileDevice framework that Finder uses.
Close Conflicting Mobile Management Applications
Safe & ReversibleQuit third-party software that creates exclusive USB handles with iOS devices, such as Xcode, Apple Configurator, iMazing, or 3uTools. These utilities can lock the usbmuxd port and prevent AirCard from querying pass bundles.
What the Upstream GitHub Issue Confirms
Issue #26 confirms that AirCard does not require jailbreak or developer mode on the iPhone. When detection fails, the problem is almost universally at the iOS trust handshake level or an accessory permission block inside macOS System Settings.
If the Issue Persists
If your iPhone still fails to be detected after trying all steps, restart both your Mac and your iPhone. A clean reboot clears stuck background usbmuxd and lockdown sockets.
If you have exhausted all steps without success, you can gather non-sensitive macOS Console diagnostic messages (filter by process name usbmuxd or AirCard) and contribute your findings to the upstream issue tracker at Issue #26 on GitHub.
Technical Evidence & Verification
✓ Verified SourceThis document adheres to the AirCardGuide factual verification policy. Conclusions, system requirements, and diagnostic procedures are confirmed against official upstream releases and technical issue discussions.