{"docs":[{"id":160,"title":"USB and HID Devices on macOS: When You Need a Driver and When You Do Not","heading":"USB and HID Devices on macOS: When You Need a Driver and When You Do Not","subheading":null,"category":"Device Drivers","body":{"root":{"type":"root","children":[{"type":"heading","tag":"h3","version":1,"children":[{"type":"text","text":"Choosing the path","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"If the device fits a standard class, such as HID, CDC ACM serial, audio, video, mass storage, MIDI or CDC networking, implement that class in the firmware and test it with the built-in drivers. For custom HID devices, a vendor-defined usage page lets an app exchange reports through Apple HID APIs with no driver. Reading keyboard input requires the user to grant the app Input Monitoring permission.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"For a vendor-specific interface used by one application, open it from the app with the IOUSBHost framework or libusb; sandboxed apps also need the USB device entitlement. Write a DriverKit extension only when the device must act as a system-wide resource with no class driver, such as a non-standard serial bridge, a network interface or an audio device that is not class compliant, where an audio server plug-in may also be an option.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"tags":"Device Drivers, macOS, USB, HID","cardCta":{"label":null,"link":null},"pageCta":{"label":"Talk to AAVICO engineering","link":"/contact"},"excerpt":"Many USB devices work on macOS with no custom driver at all. Designing to a standard class, or talking to the device from an app, often removes the driver from the plan.","featuredImage":null,"type":"Blog","readTime":"3 min read","publishedAt":"2026-11-15T18:27:00.000Z","heroImage":null,"introText":"Before writing a DriverKit extension for a USB device, it is worth asking whether macOS needs one. macOS includes drivers for the standard USB classes, and applications can open vendor-specific devices directly through Apple frameworks or libraries such as libusb. A driver is only necessary when the device must appear to the whole system as something macOS does not already support.","metrics":[{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-metric-1","value":"HID","label":"Handled by the built-in HID driver and readable from apps.","icon":null},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-metric-2","value":"CDC ACM","label":"USB serial devices using this class appear as serial ports without a custom driver.","icon":null},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-metric-3","value":"UAC 2","label":"USB Audio Class 2 devices work with the built-in audio support.","icon":null},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-metric-4","value":"libusb","label":"A portable user-space library for vendor-specific USB devices.","icon":null}],"gallery":[],"challenge":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"A common pattern is a custom USB protocol designed early in a project, followed by the discovery that every operating system now needs its own driver. Each brings signing, installation and maintenance, for a device that could have used a standard class.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"The reverse also happens: an app tries to open a device that a built-in driver has already claimed, such as a keyboard-class HID device or a mass storage interface, and finds it cannot get exclusive access or is blocked by privacy controls.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"blockquote":{"quote":"The cheapest macOS driver is the one you never write.","author":"","role":"AAVICO Engineering"},"supportImage1":null,"deliverables":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Decide the USB class at the firmware design stage, with every target operating system in mind, not only macOS.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Prototype host access from a simple app and check permissions and entitlements on a release build.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Only if that cannot meet the requirement, scope a DriverKit extension and start the entitlement request.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"results":[{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-result-1","title":"No Driver to Ship","description":"Class-compliant devices work as soon as they are plugged in."},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-result-2","title":"Cross-Platform","description":"Common classes work with built-in drivers on macOS, Windows and Linux."},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-result-3","title":"Simpler Releases","description":"App-level access avoids extension approval and entitlement delays."},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-result-4","title":"Lower Maintenance","description":"There is no driver to update for each new macOS release."}],"lookingAhead":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Give each unit a unique serial number string so apps can tell several connected units apart.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"If a browser-based tool is planned, note that WebUSB and WebHID are supported only in some browsers, and not in Safari.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"supportImage2":null,"testimonial":{"quote":null,"author":null,"role":null,"photo":null},"challengesSolved":[{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-challenge-1","title":"A custom protocol that needs a driver on every OS","description":null,"icon":null},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-challenge-2","title":"Apps blocked from devices a system driver has claimed","description":null,"icon":null},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-challenge-3","title":"Release builds failing on missing entitlements","description":null,"icon":null},{"id":"usb-and-hid-devices-on-macos-when-you-need-a-dri-challenge-4","title":"A dext written for a class macOS already supports","description":null,"icon":null}],"relatedPosts":[],"contactUs":{"show":true},"updatedAt":"2026-11-15T17:32:32.682Z","createdAt":"2026-11-15T17:32:32.682Z"}],"hasNextPage":false,"hasPrevPage":false,"limit":10,"nextPage":null,"page":1,"pagingCounter":1,"prevPage":null,"totalDocs":1,"totalPages":1}