USBHost library. NOTE: This library is only officially supported on the LPC1768 platform. For more information, please see the handbook page.

Dependencies:   FATFileSystem mbed-rtos

Dependents:   BTstack WallbotWii SD to Flash Data Transfer USBHost-MSD_HelloWorld ... more

Legacy Warning

This is an mbed 2 library. To learn more about mbed OS 5, visit the docs.

Pull requests against this repository are no longer supported. Please raise against mbed OS 5 as documented above.

Revision:
39:d96aa62afc5b
Parent:
38:d66f404b66d4
Child:
40:7c3b59bb364e
--- a/USBHost/TARGET_RENESAS/TARGET_VK_RZ_A1H/inc/devdrv_usb_host_api.h	Thu Jul 20 12:21:36 2017 +0100
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,329 +0,0 @@
-/*******************************************************************************
-* DISCLAIMER
-* This software is supplied by Renesas Electronics Corporation and is only
-* intended for use with Renesas products. No other uses are authorized. This
-* software is owned by Renesas Electronics Corporation and is protected under
-* all applicable laws, including copyright laws.
-* THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
-* THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
-* LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
-* AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
-* TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
-* ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
-* FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
-* ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
-* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-* Renesas reserves the right, without notice, to make changes to this software
-* and to discontinue the availability of this software. By using this software,
-* you agree to the additional terms and conditions found by accessing the
-* following link:
-* http://www.renesas.com/disclaimer
-* Copyright (C) 2012 - 2014 Renesas Electronics Corporation. All rights reserved.
-*******************************************************************************/
-/*******************************************************************************
-* File Name    : devdrv_usb_host_api.h
-* $Rev: 1116 $
-* $Date:: 2014-07-09 16:29:19 +0900#$
-* Description  : RZ/A1H R7S72100 USB Sample Program
-*******************************************************************************/
-#ifndef USB_HOST_API_H
-#define USB_HOST_API_H
-
-#include "r_typedefs.h"
-
-
-/*******************************************************************************
-Typedef definitions
-*******************************************************************************/
-
-
-/*******************************************************************************
-Macro definitions
-*******************************************************************************/
-#define USB_HOST_PORTNUM                            (2)
-
-#define USB_HOST_ELT_INTERRUPT_LEVEL                (9)
-
-#define USBHCLOCK_X1_48MHZ                          (0x0000u)       /* USB_X1_48MHz */
-#define USBHCLOCK_EXTAL_12MHZ                       (0x0004u)       /* EXTAL_12MHz  */
-
-#define USB_HOST_MAX_DEVICE                         (10)
-
-#define USB_HOST_ON                                 (1)
-#define USB_HOST_OFF                                (0)
-#define USB_HOST_YES                                (1)
-#define USB_HOST_NO                                 (0)
-
-#define USB_HOST_NON_SPEED                          (0)
-#define USB_HOST_LOW_SPEED                          (1)
-#define USB_HOST_FULL_SPEED                         (2)
-#define USB_HOST_HIGH_SPEED                         (3)
-
-/* DEVDRV_SUCCESS(0) & DEVDRV_ERROR(-1) is dev_drv.h */
-#define DEVDRV_USBH_STALL                           (-2)
-#define DEVDRV_USBH_TIMEOUT                         (-3)
-#define DEVDRV_USBH_NAK_TIMEOUT                     (-4)
-#define DEVDRV_USBH_DETACH_ERR                      (-5)
-#define DEVDRV_USBH_SETUP_ERR                       (-6)
-#define DEVDRV_USBH_CTRL_COM_ERR                    (-7)
-#define DEVDRV_USBH_COM_ERR                         (-8)
-#define DEVDRV_USBH_DEV_ADDR_ERR                    (-9)
-
-#define USB_HOST_ATTACH                             (1)
-#define USB_HOST_DETACH                             (0)
-
-#define USB_HOST_MAX_PIPE_NO                        (9u)
-#define USB_HOST_PIPE0                              (0)
-#define USB_HOST_PIPE1                              (1)
-#define USB_HOST_PIPE2                              (2)
-#define USB_HOST_PIPE3                              (3)
-#define USB_HOST_PIPE4                              (4)
-#define USB_HOST_PIPE5                              (5)
-#define USB_HOST_PIPE6                              (6)
-#define USB_HOST_PIPE7                              (7)
-#define USB_HOST_PIPE8                              (8)
-#define USB_HOST_PIPE9                              (9)
-
-#define USB_HOST_ISO                                (0xc000u)
-#define USB_HOST_INTERRUPT                          (0x8000u)
-#define USB_HOST_BULK                               (0x4000u)
-
-#define USB_HOST_PIPE_IDLE                          (0x00)
-#define USB_HOST_PIPE_WAIT                          (0x01)
-#define USB_HOST_PIPE_DONE                          (0x02)
-#define USB_HOST_PIPE_NORES                         (0x03)
-#define USB_HOST_PIPE_STALL                         (0x04)
-#define USB_HOST_PIPE_ERROR                         (0x05)
-
-#define USB_HOST_NONE                               (0x0000u)
-#define USB_HOST_BFREFIELD                          (0x0400u)
-#define USB_HOST_BFREON                             (0x0400u)
-#define USB_HOST_BFREOFF                            (0x0000u)
-#define USB_HOST_DBLBFIELD                          (0x0200u)
-#define USB_HOST_DBLBON                             (0x0200u)
-#define USB_HOST_DBLBOFF                            (0x0000u)
-#define USB_HOST_CNTMDFIELD                         (0x0100u)
-#define USB_HOST_CNTMDON                            (0x0100u)
-#define USB_HOST_CNTMDOFF                           (0x0000u)
-#define USB_HOST_SHTNAKON                           (0x0080u)
-#define USB_HOST_SHTNAKOFF                          (0x0000u)
-#define USB_HOST_DIRFIELD                           (0x0010u)
-#define USB_HOST_DIR_H_OUT                          (0x0010u)
-#define USB_HOST_DIR_H_IN                           (0x0000u)
-#define USB_HOST_EPNUMFIELD                         (0x000fu)
-
-#define USB_HOST_CUSE                               (0)
-#define USB_HOST_D0USE                              (1)
-#define USB_HOST_D0DMA                              (2)
-#define USB_HOST_D1USE                              (3)
-#define USB_HOST_D1DMA                              (4)
-
-#define USB_HOST_CFIFO_USE                          (0x0000)
-#define USB_HOST_D0FIFO_USE                         (0x1000)
-#define USB_HOST_D1FIFO_USE                         (0x2000)
-#define USB_HOST_D0FIFO_DMA                         (0x5000)
-#define USB_HOST_D1FIFO_DMA                         (0x6000)
-
-#define USB_HOST_BUF2FIFO                           (0)
-#define USB_HOST_FIFO2BUF                           (1)
-
-#define USB_HOST_DRV_DETACHED                       (0x0000)
-#define USB_HOST_DRV_ATTACHED                       (0x0001)
-#define USB_HOST_DRV_GET_DEVICE_DESC_64             (0x0002)
-#define USB_HOST_DRV_POWERED                        (0x0003)
-#define USB_HOST_DRV_DEFAULT                        (0x0004)
-#define USB_HOST_DRV_SET_ADDRESS                    (0x0005)
-#define USB_HOST_DRV_ADDRESSED                      (0x0006)
-#define USB_HOST_DRV_GET_DEVICE_DESC_18             (0x0007)
-#define USB_HOST_DRV_GET_CONGIG_DESC_9              (0x0008)
-#define USB_HOST_DRV_GET_CONGIG_DESC                (0x0009)
-#define USB_HOST_DRV_SET_CONFIG                     (0x000a)
-#define USB_HOST_DRV_CONFIGURED                     (0x000b)
-#define USB_HOST_DRV_SUSPEND                        (0x1000)
-#define USB_HOST_DRV_NORES                          (0x0100)
-#define USB_HOST_DRV_STALL                          (0x0200)
-
-#define USB_HOST_TESTMODE_FORCE                     (0x000du)
-#define USB_HOST_TESTMODE_TESTPACKET                (0x000cu)
-#define USB_HOST_TESTMODE_SE0_NAK                   (0x000bu)
-#define USB_HOST_TESTMODE_K                         (0x000au)
-#define USB_HOST_TESTMODE_J                         (0x0009u)
-#define USB_HOST_TESTMODE_NORMAL                    (0x0000u)
-
-#define USB_HOST_DT_DEVICE                          (0x01)
-#define USB_HOST_DT_CONFIGURATION                   (0x02)
-#define USB_HOST_DT_STRING                          (0x03)
-#define USB_HOST_DT_INTERFACE                       (0x04)
-#define USB_HOST_DT_ENDPOINT                        (0x05)
-#define USB_HOST_DT_DEVICE_QUALIFIER                (0x06)
-#define USB_HOST_DT_OTHER_SPEED_CONFIGURATION       (0x07)
-#define USB_HOST_DT_INTERFACE_POWER                 (0x08)
-
-#define USB_HOST_IF_CLS_NOT                         (0x00)
-#define USB_HOST_IF_CLS_AUDIO                       (0x01)
-#define USB_HOST_IF_CLS_CDC_CTRL                    (0x02)
-#define USB_HOST_IF_CLS_HID                         (0x03)
-#define USB_HOST_IF_CLS_PHYSICAL                    (0x05)
-#define USB_HOST_IF_CLS_IMAGE                       (0x06)
-#define USB_HOST_IF_CLS_PRINTER                     (0x07)
-#define USB_HOST_IF_CLS_MASS                        (0x08)
-#define USB_HOST_IF_CLS_HUB                         (0x09)
-#define USB_HOST_IF_CLS_CDC_DATA                    (0x0a)
-#define USB_HOST_IF_CLS_CRAD                        (0x0b)
-#define USB_HOST_IF_CLS_CONTENT                     (0x0d)
-#define USB_HOST_IF_CLS_VIDEO                       (0x0e)
-#define USB_HOST_IF_CLS_DIAG                        (0xdc)
-#define USB_HOST_IF_CLS_WIRELESS                    (0xe0)
-#define USB_HOST_IF_CLS_APL                         (0xfe)
-#define USB_HOST_IF_CLS_VENDOR                      (0xff)
-#define USB_HOST_IF_CLS_HELE                        (0xaa)
-
-#define USB_HOST_EP_DIR_MASK                        (0x80)
-#define USB_HOST_EP_OUT                             (0x00)
-#define USB_HOST_EP_IN                              (0x80)
-#define USB_HOST_EP_TYPE                            (0x03)
-#define USB_HOST_EP_CNTRL                           (0x00)
-#define USB_HOST_EP_ISO                             (0x01)
-#define USB_HOST_EP_BULK                            (0x02)
-#define USB_HOST_EP_INT                             (0x03)
-#define USB_HOST_EP_NUM_MASK                        (0x0f)
-
-#define USB_HOST_PIPE_IN                            (0)
-#define USB_HOST_PIPE_OUT                           (1)
-
-#define USB_END_POINT_ERROR                         (0xffff)
-
-#define USB_HOST_REQ_GET_STATUS                     (0x0000)
-#define USB_HOST_REQ_CLEAR_FEATURE                  (0x0100)
-#define USB_HOST_REQ_RESERVED2                      (0x0200)
-#define USB_HOST_REQ_SET_FEATURE                    (0x0300)
-#define USB_HOST_REQ_RESERVED4                      (0x0400)
-#define USB_HOST_REQ_SET_ADDRESS                    (0x0500)
-#define USB_HOST_REQ_GET_DESCRIPTOR                 (0x0600)
-#define USB_HOST_REQ_SET_DESCRIPTOR                 (0x0700)
-#define USB_HOST_REQ_GET_CONFIGURATION              (0x0800)
-#define USB_HOST_REQ_SET_CONFIGURATION              (0x0900)
-#define USB_HOST_REQ_GET_INTERFACE                  (0x0a00)
-#define USB_HOST_REQ_SET_INTERFACE                  (0x0b00)
-#define USB_HOST_REQ_SYNCH_FRAME                    (0x0c00)
-
-#define USB_HOST_REQTYPE_HOST_TO_DEVICE             (0x0000)
-#define USB_HOST_REQTYPE_DEVICE_TO_HOST             (0x0080)
-#define USB_HOST_REQTYPE_STANDARD                   (0x0020)
-#define USB_HOST_REQTYPE_CLASS                      (0x0040)
-#define USB_HOST_REQTYPE_VENDOR                     (0x0060)
-#define USB_HOST_REQTYPE_DEVICE                     (0x0000)
-#define USB_HOST_REQTYPE_INTERFACE                  (0x0001)
-#define USB_HOST_REQTYPE_ENDPOINT                   (0x0002)
-#define USB_HOST_REQTYPE_OTHER                      (0x0003)
-
-#define USB_HOST_DESCTYPE_DEVICE                    (0x0100)
-#define USB_HOST_DESCTYPE_CONFIGURATION             (0x0200)
-#define USB_HOST_DESCTYPE_STRING                    (0x0300)
-#define USB_HOST_DESCTYPE_INTERFACE                 (0x0400)
-#define USB_HOST_DESCTYPE_ENDPOINT                  (0x0500)
-#define USB_HOST_DESCTYPE_DEVICE_QUALIFIER          (0x0600)
-#define USB_HOST_DESCTYPE_OTHER_SPEED_CONFIGURATION (0x0700)
-#define USB_HOST_DESCTYPE_INTERFACE_POWER           (0x0800)
-
-
-/*******************************************************************************
-Variable Externs
-*******************************************************************************/
-typedef struct
-{
-    uint16_t    pipe_number;
-    uint16_t    pipe_cfg;
-    uint16_t    pipe_buf;
-    uint16_t    pipe_max_pktsize;
-    uint16_t    pipe_cycle;
-    uint16_t    fifo_port;
-} USB_HOST_CFG_PIPETBL_t;
-
-typedef struct
-{
-    uint32_t    fifo;
-    uint32_t    buffer;
-    uint32_t    bytes;
-    uint32_t    dir;
-    uint32_t    size;
-} USB_HOST_DMA_t;
-
-
-/*******************************************************************************
-Imported global variables and functions (from other files)
-*******************************************************************************/
-uint16_t R_USB_api_host_init(uint16_t root, uint8_t int_level, uint16_t mode, uint16_t clockmode);
-int32_t R_USB_api_host_enumeration(uint16_t root, uint16_t devadr);
-int32_t R_USB_api_host_detach(uint16_t root);
-int32_t R_USB_api_host_data_in(uint16_t root, uint16_t devadr, uint16_t Pipe, uint32_t Size, uint8_t *data_buf);
-int32_t R_USB_api_host_data_in2(uint16_t root, uint16_t devadr, uint16_t Pipe, uint32_t Size, uint8_t *data_buf, uint32_t *bytes);
-int32_t R_USB_api_host_data_out(uint16_t root, uint16_t devadr, uint16_t Pipe, uint32_t Size, uint8_t *data_buf);
-int32_t R_USB_api_host_control_transfer(uint16_t root, uint16_t devadr, uint16_t Req, uint16_t Val, uint16_t Indx, uint16_t Len, uint8_t *Buf);
-int32_t R_USB_api_host_set_endpoint(uint16_t root, uint16_t devadr, USB_HOST_CFG_PIPETBL_t *user_table, uint8_t *configdescriptor);
-int32_t R_USB_api_host_clear_endpoint(uint16_t root, USB_HOST_CFG_PIPETBL_t *user_table);
-int32_t R_USB_api_host_clear_endpoint_pipe(uint16_t root, uint16_t pipe_sel, USB_HOST_CFG_PIPETBL_t *user_table);
-uint16_t R_USB_api_host_SetEndpointTable(uint16_t root, uint16_t devadr, USB_HOST_CFG_PIPETBL_t *user_table, uint8_t* Table);
-
-int32_t R_USB_api_host_GetDeviceDescriptor(uint16_t root, uint16_t devadr, uint16_t size, uint8_t *buf);
-int32_t R_USB_api_host_GetConfigDescriptor(uint16_t root, uint16_t devadr, uint16_t size, uint8_t *buf);
-int32_t R_USB_api_host_SetConfig(uint16_t root, uint16_t devadr, uint16_t confignum);
-int32_t R_USB_api_host_SetInterface(uint16_t root, uint16_t devadr, uint16_t interface_alt, uint16_t interface_index);
-int32_t R_USB_api_host_ClearStall(uint16_t root, uint16_t devadr, uint16_t ep_dir);
-uint16_t R_USB_api_host_GetUsbDeviceState(uint16_t root);
-
-void    R_USB_api_host_elt_clocksel(uint16_t clockmode);
-void    R_USB_api_host_elt_4_4(uint16_t root);
-void    R_USB_api_host_elt_4_5(uint16_t root);
-void    R_USB_api_host_elt_4_6(uint16_t root);
-void    R_USB_api_host_elt_4_7(uint16_t root);
-void    R_USB_api_host_elt_4_8(uint16_t root);
-void    R_USB_api_host_elt_4_9(uint16_t root);
-void    R_USB_api_host_elt_get_desc(uint16_t root);
-
-
-/*******************************************************************************
-Includes   <System Includes> , "Project Includes"
-*******************************************************************************/
-#include "usb0_host_api.h"
-#include "usb1_host_api.h"
-
-
-/*******************************************************************************
-Imported global variables and functions (from other files)
-*******************************************************************************/
-#ifdef USB0_HOST_API_H
-uint16_t Userdef_USB_usb0_host_d0fifo_dmaintid(void);
-uint16_t Userdef_USB_usb0_host_d1fifo_dmaintid(void);
-void     Userdef_USB_usb0_host_attach(void);
-void     Userdef_USB_usb0_host_detach(void);
-void     Userdef_USB_usb0_host_delay_1ms(void);
-void     Userdef_USB_usb0_host_delay_xms(uint32_t msec);
-void     Userdef_USB_usb0_host_delay_10us(uint32_t usec);
-void     Userdef_USB_usb0_host_delay_500ns(void);
-void     Userdef_USB_usb0_host_start_dma(USB_HOST_DMA_t * dma, uint16_t dfacc);
-uint32_t Userdef_USB_usb0_host_stop_dma0(void);
-uint32_t Userdef_USB_usb0_host_stop_dma1(void);
-void     Userdef_USB_usb0_host_notice(const char * format);
-void     Userdef_USB_usb0_host_user_rdy(const char * format, uint16_t data);
-#endif
-
-#ifdef USB1_HOST_API_H
-uint16_t Userdef_USB_usb1_host_d0fifo_dmaintid(void);
-uint16_t Userdef_USB_usb1_host_d1fifo_dmaintid(void);
-void     Userdef_USB_usb1_host_attach(void);
-void     Userdef_USB_usb1_host_detach(void);
-void     Userdef_USB_usb1_host_delay_1ms(void);
-void     Userdef_USB_usb1_host_delay_xms(uint32_t msec);
-void     Userdef_USB_usb1_host_delay_10us(uint32_t usec);
-void     Userdef_USB_usb1_host_delay_500ns(void);
-void     Userdef_USB_usb1_host_start_dma(USB_HOST_DMA_t * dma, uint16_t dfacc);
-uint32_t Userdef_USB_usb1_host_stop_dma0(void);
-uint32_t Userdef_USB_usb1_host_stop_dma1(void);
-void     Userdef_USB_usb1_host_notice(const char * format);
-void     Userdef_USB_usb1_host_user_rdy(const char * format, uint16_t data);
-#endif
-
-#endif /* USB_HOST_API_H */
-
-/* End of File */