Update bootloader.c

bootloader.c

@@ -1,7 +1,7 @@
 // CH32V UF2 bootloader, size-optimized (target: <= 4096 bytes)
 
 #include <stdint.h>
-
+#include "usbDesc.h"
 typedef struct USBD_descriptor {
     uint32_t addr_tx;
     uint32_t count_tx;
@@ -47,11 +47,11 @@ typedef struct USBD_descriptor {
 // Device descriptor
 const uint8_t USB_DEV_DESC[18] __attribute__((aligned(2))) = {
     18,             // bLength
-    1,              // bDescriptorType
-    0x00, 0x02,     // bcdUSB
-    0,              // bDeviceClass
-    0,              // bDeviceSubClass
-    0,              // bDeviceProtocol
+    DESCRIPTOR_DEVICE,              // bDescriptorType
+    (uint_8)USB20, (uint_8)(USB20 << 8),     // bcdUSB
+    USB_CLASS_PER_INTERFACE,              // bDeviceClass
+    USB_CLASS_PER_INTERFACE,              // bDeviceSubClass
+    USB_CLASS_PER_INTERFACE,              // bDeviceProtocol
     8,              // bMaxPacketSize0
     0x55, 0xf0,     // idVendor
     0x00, 0x00,     // idProduct
@@ -65,38 +65,38 @@ const uint8_t USB_DEV_DESC[18] __attribute__((aligned(2))) = {
 const uint8_t USB_CONF_DESC[0x20] __attribute__((aligned(2))) = {
     // Configuration descriptor
     9,              // bLength
-    2,              // bDescriptorType
+    DESCRIPTOR_CONFIGURATION,              // bDescriptorType
     0x20, 0x00,     // wTotalLength
     1,              // bNumInterfaces
     1,              // bConfigurationValue
     0,              // iConfiguration
-    0x80,           // bmAttributes
+    0x80,           // bmAttributes // Too lazy to enum
     250,            // bMaxPower
 
     // Interface descriptor
     9,              // bLength
-    4,              // bDescriptorType
+    DESCRIPTOR_INTERFACE,              // bDescriptorType
     0,              // bInterfaceNumber
     0,              // bAlternateSetting
     2,              // bNumEndpoints
-    0x08,           // bInterfaceClass
-    0x05,           // bInterfaceSubClass
-    0x50,           // bInterfaceProtocol
+    USB_CLASS_MASS_STORAGE,           // bInterfaceClass
+    MSC_SUBCLASS_SFF8070I,           // bInterfaceSubClass
+    MSC_PROTO_BBB,           // bInterfaceProtocol
     0,              // iInterface
 
     // EP1 IN endpoint descriptor
     7,              // bLength
-    5,              // bDescriptorType
+    DESCRIPTOR_ENDPOINT, // bDescriptorType
     0x81,           // bEndpointAddress
-    2,              // bmAttributes
+    TRANSFER_BULK,              // bmAttributes
     0x40, 0x00,     // wMaxPacketSize
     0,              // bInterval
 
     // EP1 OUT endpoint descriptor
     7,              // bLength
-    5,              // bDescriptorType
+    DESCRIPTOR_ENDPOINT,              // bDescriptorType
     0x01,           // bEndpointAddress
-    2,              // bmAttributes
+    TRANSFER_BULK,              // bmAttributes
     0x40, 0x00,     // wMaxPacketSize
     0,              // bInterval
 };
@@ -112,12 +112,12 @@ const uint8_t HEXLUT[16] = "0123456789ABCDEF";
 
 // SCSI INQUIRY standard response
 const uint8_t INQUIRY_RESPONSE[36] __attribute__((aligned(2))) = {
-    0x00,   // direct access block device
-    0x80,   // RMB removable media
+    SCSI_INQ_DEV_TYPE_DIRECT_ACCESS,   // direct access block device
+    SCSI_INQ_RMB_REMOVABLE,   // RMB removable media
     // (if you don't set the RMB flag, macOS will show an orange drive
     // instead of a grey drive, contrary to expectations of flash drives)
-    0x04,   // SPC-2
-    0x02,   // fixed, response data format
+    SCSI_INQ_VER_SPC_2,   // SPC-2
+    SCSI_INQ_FMT_SCSI2,   // fixed, response data format
     0x1F,   // additional length
     0x00,   // xxx mostly obsolete junk
     0x00,

usbDesc.h

@@ -1,3 +1,78 @@
+enum USB_Class_Codes {
+    USB_CLASS_PER_INTERFACE       = 0x00, // Use class info in Interface Descriptors
+    USB_CLASS_AUDIO               = 0x01, // Audio
+    USB_CLASS_COMM_AND_CDC        = 0x02, // Communications and CDC Control
+    USB_CLASS_HID                 = 0x03, // Human Interface Device
+    USB_CLASS_PHYSICAL            = 0x05, // Physical
+    USB_CLASS_IMAGE               = 0x06, // Image
+    USB_CLASS_PRINTER             = 0x07, // Printer
+    USB_CLASS_MASS_STORAGE        = 0x08, // Mass Storage
+    USB_CLASS_HUB                 = 0x09, // Hub
+    USB_CLASS_CDC_DATA            = 0x0A, // CDC-Data
+    USB_CLASS_SMART_CARD          = 0x0B, // Smart Card
+    USB_CLASS_CONTENT_SECURITY    = 0x0D, // Content Security
+    USB_CLASS_VIDEO               = 0x0E, // Video
+    USB_CLASS_PERSONAL_HEALTHCARE = 0x0F, // Personal Healthcare
+    USB_CLASS_AUDIO_VIDEO         = 0x10, // Audio/Video Devices
+    USB_CLASS_BILLBOARD           = 0x11, // Billboard Device Class
+    USB_CLASS_TYPE_C_BRIDGE       = 0x12, // USB Type-C Bridge Class
+    USB_CLASS_BULK_DISPLAY        = 0x13, // USB Bulk Display Protocol Device Class
+    USB_CLASS_MCTP                = 0x14, // MCTP over USB Protocol Endpoint Device Class
+    USB_CLASS_I3C                 = 0x3C, // I3C Device Class
+    USB_CLASS_DIAGNOSTIC          = 0xDC, // Diagnostic Device
+    USB_CLASS_WIRELESS            = 0xE0, // Wireless Controller
+    USB_CLASS_MISCELLANEOUS       = 0xEF, // Miscellaneous
+    USB_CLASS_APPLICATION_SPEC    = 0xFE, // Application Specific
+    USB_CLASS_VENDOR_SPEC         = 0xFF  // Vendor Specific
+};
+
+enum USB_MassStorage_InterfaceProtocol {
+    MSC_PROTO_CBI_INT    = 0x00, // Control/Bulk/Interrupt (with completion INT)
+    MSC_PROTO_CBI_NO_INT = 0x01, // Control/Bulk/Interrupt (without completion INT)
+    MSC_PROTO_ZIP        = 0x02, // ZIP Drive Protocol (Legacy)
+    MSC_PROTO_BBB        = 0x50, // Bulk-Only Transport (BOT / BBB)
+    MSC_PROTO_BOT        = 0x50, // Alias for Bulk-Only Transport
+    MSC_PROTO_UAS        = 0x62, // USB Attached SCSI Protocol (UASP)
+    MSC_PROTO_VENDOR     = 0xFF  // Vendor Specific Protocol
+};
+
+enum USB_HID_InterfaceProtocol {
+    HID_PROTO_NONE     = 0x00, // No specific boot protocol / Report Protocol
+    HID_PROTO_KEYBOARD = 0x01, // Boot Keyboard Protocol
+    HID_PROTO_MOUSE    = 0x02  // Boot Mouse Protocol
+};
+
+enum USB_MassStorage_SubClass {
+    MSC_SUBCLASS_RBC       = 0x01, // Reduced Block Commands
+    MSC_SUBCLASS_ATAPI     = 0x02, // SFF-8020i / MMC-2 (CD/DVD)
+    MSC_SUBCLASS_QIC157    = 0x03, // QIC-157 (Tape drive)
+    MSC_SUBCLASS_UFI       = 0x04, // Uniform Floppy Interface
+    MSC_SUBCLASS_SFF8070I  = 0x05, // SFF-8070i
+    MSC_SUBCLASS_SCSI      = 0x06, // SCSI Transparent Command Set (Most Common)
+    MSC_SUBCLASS_LESD      = 0x07, // Lockable Storage Devices
+    MSC_SUBCLASS_IEEE1667  = 0x08, // IEEE 1667 Security
+    MSC_SUBCLASS_VENDOR    = 0xFF  // Vendor Specific
+};
+
+enum USB_HID_SubClass {
+    HID_SUBCLASS_NONE = 0x00, // No SubClass (Standard HID device)
+    HID_SUBCLASS_BOOT = 0x01  // Boot Interface Subclass (Keyboards/Mice supported by BIOS)
+};
+
+enum USB_bDescriptorType {
+    DESCRIPTOR_DEVICE = 0x1,
+    DESCRIPTOR_CONFIGURATION = 0x2,
+    DESCRIPTOR_INTERFACE = 0x4,
+    DESCRIPTOR_ENDPOINT = 0x5
+};
+
+enum USB_Type_BCD {
+    USB20 = 0x0200,
+    USB11 = 0x0110,
+    USB10 = 0x0100
+};
+
+
 
 enum USB_PID {
     // Token Packets
@@ -26,10 +101,16 @@ enum USB_PID {
 };
 
 
-enum Configuration_bmAttributes{
-    USB_BUS_POWERED = (1 << 7),
-    SELF_POWERED = (1 << 6),
-    REMOTE_WAKEUP = (1 << 5),
+enum Configuration_bmAttributes_Values {
+    // Standard Bits
+    CONFIG_ATTR_RESERVED_BIT7 = (1 << 7), // Always set to 1 (legacy USB 1.0 bus-powered indicator)
+    CONFIG_ATTR_SELF_POWERED  = (1 << 6), // 1 = Self-powered, 0 = Bus-powered
+    CONFIG_ATTR_REMOTE_WAKEUP = (1 << 5), // 1 = Supports remote wakeup
+
+    // Masks
+    CONFIG_ATTR_POWER_MASK    = (1 << 6),
+    CONFIG_ATTR_WAKEUP_MASK   = (1 << 5),
+    CONFIG_ATTR_RESERVED_MASK = 0b00011111 // Bits 4..0 reserved (set to 0)
 };
 
 
@@ -78,6 +159,52 @@ enum Setup_bmRequestType {
 };
 
 
+// Byte 0: Peripheral Qualifier (Bits 7..5) & Peripheral Device Type (Bits 4..0)
+enum SCSI_Inquiry_Byte0 {
+    // Peripheral Qualifier (Bits 7..5)
+    SCSI_INQ_QUAL_CONNECTED     = (0b000 << 5), // Connected to target device
+    SCSI_INQ_QUAL_NOT_CONNECTED = (0b001 << 5), // Supported, but device not connected
+    SCSI_INQ_QUAL_NOT_CAPABLE   = (0b011 << 5), // Not capable of supporting a physical device
+
+    // Peripheral Device Type (Bits 4..0)
+    SCSI_INQ_DEV_TYPE_DIRECT_ACCESS = 0x00, // Direct access block device (Flash drive, HDD, SSD)
+    SCSI_INQ_DEV_TYPE_SEQUENTIAL    = 0x01, // Sequential-access device (Tape)
+    SCSI_INQ_DEV_TYPE_PRINTER       = 0x02, // Printer device
+    SCSI_INQ_DEV_TYPE_PROCESSOR     = 0x03, // Processor device
+    SCSI_INQ_DEV_TYPE_CD_DVD        = 0x05, // CD/DVD-ROM device
+    SCSI_INQ_DEV_TYPE_OPTICAL       = 0x07, // Optical memory device
+    SCSI_INQ_DEV_TYPE_UNKNOWN       = 0x1F  // Unknown or no device type
+};
+
+// Byte 1: Control & Removable Media Flag
+enum SCSI_Inquiry_Byte1 {
+    SCSI_INQ_RMB_FIXED     = (0 << 7), // Fixed (non-removable) drive
+    SCSI_INQ_RMB_REMOVABLE = (1 << 7)  // Removable media (sets gray icon on macOS)
+};
+
+// Byte 2: ANSI/SPC Standard Compliance Version
+enum SCSI_Inquiry_Byte2_Version {
+    SCSI_INQ_VER_NONE  = 0x00, // No standard compliance claimed
+    SCSI_INQ_VER_SCSI1 = 0x01, // ANSI X3.131-1986 (SCSI-1)
+    SCSI_INQ_VER_SCSI2 = 0x02, // ANSI X3.131-1994 (SCSI-2)
+    SCSI_INQ_VER_SPC   = 0x03, // SPC (SCSI Primary Commands)
+    SCSI_INQ_VER_SPC_2 = 0x04, // SPC-2
+    SCSI_INQ_VER_SPC_3 = 0x05, // SPC-3
+    SCSI_INQ_VER_SPC_4 = 0x06  // SPC-4
+};
+
+// Byte 3: Response Data Format & Control Flags
+enum SCSI_Inquiry_Byte3 {
+    SCSI_INQ_FMT_SCSI1 = 0x00,
+    SCSI_INQ_FMT_CCS   = 0x01, // Common Command Set
+    SCSI_INQ_FMT_SCSI2 = 0x02, // Standard Response Data Format (SCSI-2 / SPC)
+
+    SCSI_INQ_HISUP     = (1 << 4), // Hierarchical Support
+    SCSI_INQ_NORMACA   = (1 << 5)  // Normal ACA Supported
+};
+
+
+
 enum Standard__Device_Requests {
     GET_STATUS = 0x00,
     /**