usb.h

Go to the documentation of this file.

/* Copyright (c) 2026 Zane A. Maple
   Licensed under the MIT license. See LICENSE in the main repository for more information. */
 
#ifndef W_HAL_USB_H
#define W_HAL_USB_H
 
#include "shared.h"

#define USB_LANG_CODE { 0x04, 0x09 }
#define USB_MANUFACTURER_STRING "vllabs"
#define USB_PRODUCT_STRING "\'whiskers\'"
/* Turns out you only need custom PIDs and VIDs if your device either follows the USB standard to a tee (it doesn't) or you use the USB trademark (which we aren't) */
#define USB_PID 0x0400
#define USB_VID 0xcafe

typedef struct usb_mods
{
    char lang[2]; 
    /* Note the +1 here is for the string end */
    char manu_string[32 + 1]; 
    char prod_string[32 + 1]; 
    char serial_string[32 + 1]; 
 
    uint16_t vid; 
    uint16_t pid; 
} w_usb_mods;

typedef struct usb_callbacks
{
    void (*mounted_cb)(void); 
    void (*unmounted_cb)(void); 
    void (*suspend_cb)(bool); 
    void (*unsuspend_cb)(void); 
} w_usb_cbs;

void usb_setup_msc(char vendor_string[8], char product_string[16], _DISK_INFO *di);

void usb_initialize_defaults(w_usb_cbs *cbs);

void usb_initialize_custom(w_usb_cbs *cbs, w_usb_mods *mods);
void usb_keyboard_send_report(const uint8_t rep[8]);
void usb_loop();  
void usb_remote_wakeup_host();
#endif