usb_host_internal.h

/*
 * USB Host Internal Definitions
 *
 * Internal header for USB Host driver implementation
 */
 
#ifndef _USB_HOST_INTERNAL_H_
#define _USB_HOST_INTERNAL_H_
 
#include <usb_host_config.h>
#include <nbrtos.h>
#include <stdint.h>
 
/* Include NXP USB Host stack headers */
#include "nxp_usb.h"
#include <usb_host.h>
#include <usb_host_msd.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*******************************************************************************
 * MSD Class Definitions
 ******************************************************************************/
 
/* MSD class codes (for reference - also defined in NXP headers) */
#ifndef USB_HOST_MSD_CLASS_CODE
#define USB_HOST_MSD_CLASS_CODE         (0x08U)
#endif
#ifndef USB_HOST_MSD_SUBCLASS_CODE_UFI
#define USB_HOST_MSD_SUBCLASS_CODE_UFI  (0x04U)
#endif
#ifndef USB_HOST_MSD_SUBCLASS_CODE_SCSI
#define USB_HOST_MSD_SUBCLASS_CODE_SCSI (0x06U)
#endif
#ifndef USB_HOST_MSD_PROTOCOL_BULK
#define USB_HOST_MSD_PROTOCOL_BULK      (0x50U)
#endif
 
/* MSD run states for our application */
typedef enum {
    kMSD_AppRunIdle = 0,
    kMSD_AppRunSetInterface,
    kMSD_AppRunWaitSetInterface,
    kMSD_AppRunMassStorageTest,
    kMSD_AppRunReadCapacity,
    kMSD_AppRunReady,
} msd_app_run_state_t;
 
/* Device attach states */
typedef enum {
    kMSD_DevIdle = 0,
    kMSD_DevAttached,
    kMSD_DevDetached,
} msd_dev_state_t;
 
/* Application-level MSD instance structure
 * This wraps the NXP class driver with additional application state */
typedef struct _msd_app_instance {
    /* NXP USB Host handles */
    usb_host_configuration_handle configHandle;
    usb_device_handle deviceHandle;
    usb_host_class_handle classHandle;        /* Pointer to NXP usb_host_msd_instance_t */
    usb_host_interface_handle interfaceHandle;
 
    /* Command buffer for MSD operations */
    uint8_t *commandBuffer;
 
    /* Application state tracking */
    uint8_t prevDeviceState;
    uint8_t deviceState;      /* msd_dev_state_t */
    uint8_t runWaitState;     /* msd_app_run_state_t */
    uint8_t runState;         /* msd_app_run_state_t */
 
    /* Device geometry (from READ CAPACITY) */
    uint32_t sectorSize;
    uint32_t sectorCount;
} msd_app_instance_t;
 
/*******************************************************************************
 * Global Variables (defined in usb_host_init.cpp)
 ******************************************************************************/
 
extern usb_host_handle g_UsbHostHandle;
extern msd_app_instance_t g_MsdAppInstance;
extern OS_SEM *g_MsdEventSem;
extern volatile int g_MsdStatus;
 
/*******************************************************************************
 * Platform Integration Functions (implemented in usb_host_init.cpp)
 ******************************************************************************/
 
/* Clock and PHY initialization */
void USB_HostClockInit(void);
void USB_HostPhyInit(void);
 
/* ISR and interrupt enable */
void USB_HostIsrEnable(void);
void USB_HostIsrDisable(void);
 
/* Internal MSD event callback */
usb_status_t USB_HostMsdEvent(usb_device_handle deviceHandle,
                              usb_host_configuration_handle configurationHandle,
                              uint32_t eventCode);
 
/* MSD task function */
void USB_HostMsdTask(void *param);
 
#ifdef __cplusplus
}
#endif
 
#endif /* _USB_HOST_INTERNAL_H_ */