330 rader
16 KiB
C
330 rader
16 KiB
C
|
/*******************************************************************************
|
||
|
* 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 */
|