Skip to content

Mac USB mode fix#297

Merged
bmorcelli merged 1 commit intobmorcelli:mainfrom
konsumer:main
Mar 27, 2026
Merged

Mac USB mode fix#297
bmorcelli merged 1 commit intobmorcelli:mainfrom
konsumer:main

Conversation

@konsumer
Copy link
Copy Markdown
Contributor

Per the USB MSC spec, class/subclass/protocol must be defined at the interface level, not the device level. Setting them at the device level (TUSB_CLASS_MSC / MSC_SUBCLASS_SCSI / MSC_PROTOCOL_BOT) causes macOS to reject enumeration of the mass storage interface entirely. The device shows in System Information as 'Removable' but never appears in Finder or Disk Utility.

Setting bDeviceClass=0x00, bDeviceSubClass=0x00, bDeviceProtocol=0x00 tells the host to look at the interface descriptor for class info, which TUD_MSC_DESCRIPTOR already sets correctly. This matches the behavior of CircuitPython and other correct USB MSC implementations, and fixes macOS compatibility without affecting Windows or Linux.

…criptor

Per the USB MSC spec, class/subclass/protocol must be defined at the
interface level, not the device level. Setting them at the device level
(TUSB_CLASS_MSC / MSC_SUBCLASS_SCSI / MSC_PROTOCOL_BOT) causes macOS
to reject enumeration of the mass storage interface entirely — the
device shows in System Information as 'Removable' but never appears in
Finder or Disk Utility.

Setting bDeviceClass=0x00, bDeviceSubClass=0x00, bDeviceProtocol=0x00
tells the host to look at the interface descriptor for class info, which
TUD_MSC_DESCRIPTOR already sets correctly. This matches the behavior of
CircuitPython and other correct USB MSC implementations, and fixes
macOS compatibility without affecting Windows or Linux.
@bmorcelli
Copy link
Copy Markdown
Owner

Thank you brother, it might solve this #184

@bmorcelli bmorcelli merged commit 6d86d4c into bmorcelli:main Mar 27, 2026
63 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants