usbd.h

Go to the documentation of this file.

/*
# _____     ___ ____     ___ ____
#  ____|   |    ____|   |        | |____|
# |     ___|   |____ ___|    ____| |    \    PS2DEV Open Source Project.
#-----------------------------------------------------------------------
# Copyright 2001-2004, ps2dev - http://www.ps2dev.org
# Licenced under Academic Free License version 2.0
# Review ps2sdk README & LICENSE files for further details.
*/

 
#ifndef __USBD_H__
#define __USBD_H__
 
#include <types.h>
#include <irx.h>
 
typedef struct
{
    u8 requesttype;
    u8 request;
    u16 value;
    u16 index;
    u16 length;
} UsbDeviceRequest;
 
typedef void (*sceUsbdDoneCallback)(int result, int count, void *arg);
 
typedef struct
{
    u8 bLength;
    u8 bDescriptorType;
    u8 bNbrPorts;
    u8 wHubCharacteristicsLb;
    u8 wHubCharacteristicsHb;
    u8 bPwrOn2PwrGood;
    u8 bHubContrCurrent;
    u8 deviceRemovable[32]; // arbitrary number, depends on number of ports
} UsbHubDescriptor;
 

typedef struct _UsbDriver
{
    struct _UsbDriver *next, *prev;
    char *name;
    int (*probe)(int devID);
    int (*connect)(int devID);
    int (*disconnect)(int devID);
    u32 reserved1;
    u32 reserved2;
    u32 reserved3;
    u32 reserved4;
    u32 reserved5;
    void *gp;
} sceUsbdLddOps;
 
typedef struct
{
    u8 bLength;
    u8 bDescriptorType;
    u16 bcdUSB;
    u8 bDeviceClass;
    u8 bDeviceSubClass;
    u8 bDeviceProtocol;
    u8 bMaxPacketSize0;
    u16 idVendor;
    u16 idProduct;
    u16 bcdDevice;
    u8 iManufacturer;
    u8 iProduct;
    u8 iSerialNumber;
    u8 bNumConfigurations;
} UsbDeviceDescriptor;
 
typedef struct
{
    u8 bLength;
    u8 bDescriptorType;
    // u8 wTotalLengthLb;
    // u8 wTotalLengthHb;
    u16 wTotalLength; // apparently we can expect this to be aligned, for some reason
    u8 bNumInterfaces;
    u8 bConfigurationValue;
    u8 iConfiguration;
    u8 bmAttributes;
    u8 maxPower;
} UsbConfigDescriptor;
 
typedef struct
{
    u8 bLength;
    u8 bDescriptorType;
    u8 bInterfaceNumber;
    u8 bAlternateSetting;
    u8 bNumEndpoints;
    u8 bInterfaceClass;
    u8 bInterfaceSubClass;
    u8 bInterfaceProtocol;
    u8 iInterface;
} UsbInterfaceDescriptor;
 
typedef struct
{
    u8 bLength;
    u8 bDescritorLength;
    u8 bEndpointAddress;
    u8 bmAttributes;
    u8 wMaxPacketSizeLB;
    u8 wMaxPacketSizeHB;
    u8 bInterval;
} UsbEndpointDescriptor;
 
typedef struct
{
    u8 bLength;
    u8 bDescriptorType;
    u16 wData[1];
} UsbStringDescriptor;
 
typedef struct _usbHidDescriptorItem
{
    u8 bDescriptorType;
    u8 wDescriptorLengthLb;
    u8 wDescriptorLengthHb;
} UsbHidDescriptorItem;
 
typedef struct _usbHidDescriptor
{
    u8 bLength;
    u8 bDescriptorType;
    u16 bcdHID;
    u8 bCountryCode;
    u8 bNumDescriptors;
    UsbHidDescriptorItem items[];
} UsbHidDescriptor;
 
typedef struct
{
    u16 bLength  : 11;
    u16 reserved : 1;
    u16 PSW      : 4;
} sceUsbdIsochronousPswLen;
 
#define USB_MAX_ISOCH_PACKETS 8
 
typedef struct
{
    void *bBufStart;
    u32 bRelStartFrame;
    u32 bNumPackets;
    sceUsbdIsochronousPswLen Packets[USB_MAX_ISOCH_PACKETS];
} sceUsbdMultiIsochronousRequest;
 
typedef void (*sceUsbdMultiIsochronousDoneCallback)(int result, sceUsbdMultiIsochronousRequest *req, void *arg);
 
/*
 * Device and/or Interface Class codes
 */
#define USB_CLASS_PER_INTERFACE 0 /* for DeviceClass */
#define USB_CLASS_AUDIO         1
#define USB_CLASS_COMM          2
#define USB_CLASS_HID           3
#define USB_CLASS_PHYSICAL      5
#define USB_CLASS_PRINTER       7
#define USB_CLASS_MASS_STORAGE  8
#define USB_CLASS_HUB           9
#define USB_CLASS_DATA          10
#define USB_CLASS_APP_SPEC      0xfe
#define USB_CLASS_VENDOR_SPEC   0xff
 
/*
 * USB types
 */
#define USB_TYPE_STANDARD (0x00 << 5)
#define USB_TYPE_CLASS    (0x01 << 5)
#define USB_TYPE_VENDOR   (0x02 << 5)
#define USB_TYPE_RESERVED (0x03 << 5)
 
/*
 * USB recipients
 */
#define USB_RECIP_DEVICE    0x00
#define USB_RECIP_INTERFACE 0x01
#define USB_RECIP_ENDPOINT  0x02
#define USB_RECIP_OTHER     0x03
 
#define USB_ENDPOINT_XFER_CONTROL  0
#define USB_ENDPOINT_XFER_ISOC     1
#define USB_ENDPOINT_XFER_BULK     2
#define USB_ENDPOINT_XFER_INT      3
#define USB_ENDPOINT_XFERTYPE_MASK 3
 
#define USB_REQ_GET_REPORT   0x01
#define USB_REQ_GET_IDLE     0x02
#define USB_REQ_GET_PROTOCOL 0x03
#define USB_REQ_SET_REPORT   0x09
#define USB_REQ_SET_IDLE     0x0A
#define USB_REQ_SET_PROTOCOL 0x0B
 
/*
 * USB directions
 */
#define USB_DIR_OUT           0
#define USB_DIR_IN            0x80
#define USB_ENDPOINT_DIR_MASK 0x80
 
#define USB_DT_DEVICE    1
#define USB_DT_CONFIG    2
#define USB_DT_STRING    3
#define USB_DT_INTERFACE 4
#define USB_DT_ENDPOINT  5
#define USB_DT_HUB       0x29
 
#define USB_CLASS_HUB 9
 
#define USB_RT_HUB  (USB_TYPE_CLASS | USB_RECIP_DEVICE)
#define USB_RT_PORT (USB_TYPE_CLASS | USB_RECIP_OTHER)
 
#define USB_REQ_GET_STATUS        0x00
#define USB_REQ_CLEAR_FEATURE     0x01
#define USB_REQ_SET_FEATURE       0x03
#define USB_REQ_SET_ADDRESS       0x05
#define USB_REQ_GET_DESCRIPTOR    0x06
#define USB_REQ_SET_DESCRIPTOR    0x07
#define USB_REQ_GET_CONFIGURATION 0x08
#define USB_REQ_SET_CONFIGURATION 0x09
#define USB_REQ_GET_INTERFACE     0x0A
#define USB_REQ_SET_INTERFACE     0x0B
#define USB_REQ_SYNCH_FRAME       0x0C

#define USB_RC_OK           0x000
#define USB_RC_CRC          0x001
#define USB_RC_BITSTUFF     0x002
#define USB_RC_TOGGLE       0x003
#define USB_RC_STALL        0x004
#define USB_RC_NORESPONSE   0x005
#define USB_RC_BADPID       0x006
#define USB_RC_WRONGPID     0x007
#define USB_RC_DATAOVER     0x008
#define USB_RC_DATAUNDER    0x009
#define USB_RC_BUFFOVER     0x00C
#define USB_RC_BUFFUNDER    0x00D
#define USB_RC_NOTACCESSED  0x00E
#define USB_RC_NOTACCESSED2 0x00F

#define USB_RC_BADDEV      0x101
#define USB_RC_BADPIPE     0x102
#define USB_RC_BADLENGTH   0x103
#define USB_RC_BADDRIVER   0x104
#define USB_RC_BADCONTEXT  0x105
#define USB_RC_BADALIGN    0x106
#define USB_RC_BADHUBDEPTH 0x107

#define USB_RC_ED        0x111
#define USB_RC_IOREQ     0x112
#define USB_RC_BADOPTION 0x113

#define USB_RC_BUSY    0x121
#define USB_RC_ABORTED 0x122

#define USB_RC_NOSUPPORT 0x131
#define USB_RC_UNKNOWN   0x132
 
extern int sceUsbdRegisterLdd(sceUsbdLddOps *driver);
extern int sceUsbdUnregisterLdd(sceUsbdLddOps *driver);
extern void *sceUsbdScanStaticDescriptor(int devId, void *data, u8 type);
extern int sceUsbdGetDeviceLocation(int devId, u8 *path);
extern int sceUsbdSetPrivateData(int devId, void *data);
extern void *sceUsbdGetPrivateData(int devId);
extern int sceUsbdOpenPipe(int devId, UsbEndpointDescriptor *desc);
extern int sceUsbdOpenPipeAligned(int devId, UsbEndpointDescriptor *desc);
extern int sceUsbdClosePipe(int id);
extern int sceUsbdTransferPipe(int id, void *data, u32 len, void *option, sceUsbdDoneCallback callback, void *cbArg);
 
extern int sceUsbdRegisterAutoloader(sceUsbdLddOps *drv); // Arbitrarily named
extern int sceUsbdUnregisterAutoloader(void);             // Arbitrarily named
extern int sceUsbdChangeThreadPriority(int prio1, int prio2);
 
// These have been added in 1.2 export version
extern int sceUsbdGetReportDescriptor(int devId, int cfgNum, int ifNum, void **desc, u32 *len);
extern int sceUsbdMultiIsochronousTransfer(int pipeId, sceUsbdMultiIsochronousRequest *request, sceUsbdMultiIsochronousDoneCallback callback, void *cbArg);
 
// For backwards compatibility:
#define UsbCallbackProc                 sceUsbdDoneCallback
#define UsbDriver                       sceUsbdLddOps
#define UsbIsochronousPswLen            sceUsbdIsochronousPswLen
#define UsbMultiIsochronousRequest      sceUsbdMultiIsochronousRequest
#define UsbMultiIsochronousDoneCallback sceUsbdMultiIsochronousDoneCallback
#define UsbRegisterDriver               sceUsbdRegisterLdd
#define UsbUnregisterDriver             sceUsbdUnregisterLdd
#define UsbGetDeviceStaticDescriptor    sceUsbdScanStaticDescriptor
#define UsbGetDeviceLocation            sceUsbdGetDeviceLocation
#define UsbSetDevicePrivateData         sceUsbdSetPrivateData
#define UsbGetDevicePrivateData         sceUsbdGetPrivateData
#define UsbOpenEndpoint                 sceUsbdOpenPipe
#define UsbOpenEndpointAligned          sceUsbdOpenPipeAligned
#define UsbCloseEndpoint                sceUsbdClosePipe
#define UsbTransfer                     sceUsbdTransferPipe
#define UsbRegisterAutoloader           sceUsbdRegisterAutoloader
#define UsbUnregisterAutoloader         sceUsbdUnregisterAutoloader
#define UsbChangeThreadPriority         sceUsbdChangeThreadPriority
#define UsbGetReportDescriptor          sceUsbdGetReportDescriptor
#define UsbMultiIsochronousTransfer     sceUsbdMultiIsochronousTransfer
 
#define usbd_IMPORTS_start DECLARE_IMPORT_TABLE(usbd, 1, 2)
#define usbd_IMPORTS_end   END_IMPORT_TABLE
 
#define I_sceUsbdRegisterLdd              DECLARE_IMPORT(4, sceUsbdRegisterLdd)
#define I_sceUsbdUnregisterLdd            DECLARE_IMPORT(5, sceUsbdUnregisterLdd)
#define I_sceUsbdScanStaticDescriptor     DECLARE_IMPORT(6, sceUsbdScanStaticDescriptor)
#define I_sceUsbdSetPrivateData           DECLARE_IMPORT(7, sceUsbdSetPrivateData)
#define I_sceUsbdGetPrivateData           DECLARE_IMPORT(8, sceUsbdGetPrivateData)
#define I_sceUsbdOpenPipe                 DECLARE_IMPORT(9, sceUsbdOpenPipe)
#define I_sceUsbdClosePipe                DECLARE_IMPORT(10, sceUsbdClosePipe)
#define I_sceUsbdTransferPipe             DECLARE_IMPORT(11, sceUsbdTransferPipe)
#define I_sceUsbdOpenPipeAligned          DECLARE_IMPORT(12, sceUsbdOpenPipeAligned)
#define I_sceUsbdGetDeviceLocation        DECLARE_IMPORT(13, sceUsbdGetDeviceLocation)
#define I_sceUsbdRegisterAutoloader       DECLARE_IMPORT(14, sceUsbdRegisterAutoloader)
#define I_sceUsbdUnregisterAutoloader     DECLARE_IMPORT(15, sceUsbdUnregisterAutoloader)
#define I_sceUsbdChangeThreadPriority     DECLARE_IMPORT(16, sceUsbdChangeThreadPriority)
#define I_sceUsbdGetReportDescriptor      DECLARE_IMPORT(17, sceUsbdGetReportDescriptor)
#define I_sceUsbdMultiIsochronousTransfer DECLARE_IMPORT(18, sceUsbdMultiIsochronousTransfer)
 
// For backwards compatibility:
#define I_UsbCallbackProc                 I_sceUsbdDoneCallback
#define I_UsbDriver                       I_sceUsbdLddOps
#define I_UsbIsochronousPswLen            I_sceUsbdIsochronousPswLen
#define I_UsbMultiIsochronousRequest      I_sceUsbdMultiIsochronousRequest
#define I_UsbMultiIsochronousDoneCallback I_sceUsbdMultiIsochronousDoneCallback
#define I_UsbRegisterDriver               I_sceUsbdRegisterLdd
#define I_UsbUnregisterDriver             I_sceUsbdUnregisterLdd
#define I_UsbGetDeviceStaticDescriptor    I_sceUsbdScanStaticDescriptor
#define I_UsbGetDeviceLocation            I_sceUsbdGetDeviceLocation
#define I_UsbSetDevicePrivateData         I_sceUsbdSetPrivateData
#define I_UsbGetDevicePrivateData         I_sceUsbdGetPrivateData
#define I_UsbOpenEndpoint                 I_sceUsbdOpenPipe
#define I_UsbOpenEndpointAligned          I_sceUsbdOpenPipeAligned
#define I_UsbCloseEndpoint                I_sceUsbdClosePipe
#define I_UsbTransfer                     I_sceUsbdTransferPipe
#define I_UsbRegisterAutoloader           I_sceUsbdRegisterAutoloader
#define I_UsbUnregisterAutoloader         I_sceUsbdUnregisterAutoloader
#define I_UsbChangeThreadPriority         I_sceUsbdChangeThreadPriority
#define I_UsbGetReportDescriptor          I_sceUsbdGetReportDescriptor
#define I_UsbMultiIsochronousTransfer     I_sceUsbdMultiIsochronousTransfer
 
#endif /* __USBD_H__ */