a5cf3a190c
* Fix mistake in gitignore file and add in missing core files. The missing leading slash on "lib" meant all folders names lib in the directory tree are ignored, rather than just the top level PlatformIO lib folder * Add LiquidCrystal Library and associated headers modified to compile.
115 lines
5.2 KiB
C
115 lines
5.2 KiB
C
/*----------------------------------------------------------------------------
|
|
* U S B - K e r n e l
|
|
*----------------------------------------------------------------------------
|
|
* Name: usbhw.h
|
|
* Purpose: USB Hardware Layer Definitions
|
|
* Version: V1.20
|
|
*----------------------------------------------------------------------------
|
|
* This software is supplied "AS IS" without any warranties, express,
|
|
* implied or statutory, including but not limited to the implied
|
|
* warranties of fitness for purpose, satisfactory quality and
|
|
* noninfringement. Keil extends you a royalty-free right to reproduce
|
|
* and distribute executable files created using this software for use
|
|
* on NXP Semiconductors LPC family microcontroller devices only. Nothing
|
|
* else gives you the right to use this software.
|
|
*
|
|
* Copyright (c) 2009 Keil - An ARM Company. All rights reserved.
|
|
*----------------------------------------------------------------------------
|
|
* History:
|
|
* V1.20 Added USB_ClearEPBuf
|
|
* V1.00 Initial Version
|
|
*----------------------------------------------------------------------------*/
|
|
|
|
#ifndef __USBHW_H__
|
|
#define __USBHW_H__
|
|
extern "C" {
|
|
#include "lpc_types.h"
|
|
}
|
|
/* USB RAM Definitions */
|
|
#define USB_RAM_ADR 0x2007C000 /* USB RAM Start Address */
|
|
#define USB_RAM_SZ 0x00004000 /* USB RAM Size (16kB) */
|
|
|
|
/* DMA Endpoint Descriptors */
|
|
#define DD_NISO_CNT 16 /* Non-Iso EP DMA Descr. Count (max. 32) */
|
|
#define DD_ISO_CNT 8 /* Iso EP DMA Descriptor Count (max. 32) */
|
|
#define DD_NISO_SZ (DD_NISO_CNT * 16) /* Non-Iso DMA Descr. Size */
|
|
#define DD_ISO_SZ (DD_ISO_CNT * 20) /* Iso DMA Descriptor Size */
|
|
#define DD_NISO_ADR (USB_RAM_ADR + 128) /* Non-Iso DMA Descr. Address */
|
|
#define DD_ISO_ADR (DD_NISO_ADR + DD_NISO_SZ) /* Iso DMA Descr. Address */
|
|
#define DD_SZ (128 + DD_NISO_SZ + DD_ISO_SZ) /* Descr. Size */
|
|
|
|
/* DMA Buffer Memory Definitions */
|
|
#define DMA_BUF_ADR (USB_RAM_ADR + DD_SZ) /* DMA Buffer Start Address */
|
|
#define DMA_BUF_SZ (USB_RAM_SZ - DD_SZ) /* DMA Buffer Size */
|
|
|
|
/* USB Error Codes */
|
|
#define USB_ERR_PID 0x0001 /* PID Error */
|
|
#define USB_ERR_UEPKT 0x0002 /* Unexpected Packet */
|
|
#define USB_ERR_DCRC 0x0004 /* Data CRC Error */
|
|
#define USB_ERR_TIMOUT 0x0008 /* Bus Time-out Error */
|
|
#define USB_ERR_EOP 0x0010 /* End of Packet Error */
|
|
#define USB_ERR_B_OVRN 0x0020 /* Buffer Overrun */
|
|
#define USB_ERR_BTSTF 0x0040 /* Bit Stuff Error */
|
|
#define USB_ERR_TGL 0x0080 /* Toggle Bit Error */
|
|
|
|
/* USB DMA Status Codes */
|
|
#define USB_DMA_INVALID 0x0000 /* DMA Invalid - Not Configured */
|
|
#define USB_DMA_IDLE 0x0001 /* DMA Idle - Waiting for Trigger */
|
|
#define USB_DMA_BUSY 0x0002 /* DMA Busy - Transfer in progress */
|
|
#define USB_DMA_DONE 0x0003 /* DMA Transfer Done (no Errors)*/
|
|
#define USB_DMA_OVER_RUN 0x0004 /* Data Over Run */
|
|
#define USB_DMA_UNDER_RUN 0x0005 /* Data Under Run (Short Packet) */
|
|
#define USB_DMA_ERROR 0x0006 /* Error */
|
|
#define USB_DMA_UNKNOWN 0xFFFF /* Unknown State */
|
|
|
|
/* USB DMA Descriptor */
|
|
typedef struct _USB_DMA_DESCRIPTOR {
|
|
uint32_t BufAdr; /* DMA Buffer Address */
|
|
uint16_t BufLen; /* DMA Buffer Length */
|
|
uint16_t MaxSize; /* Maximum Packet Size */
|
|
uint32_t InfoAdr; /* Packet Info Memory Address */
|
|
union { /* DMA Configuration */
|
|
struct {
|
|
uint32_t Link : 1; /* Link to existing Descriptors */
|
|
uint32_t IsoEP : 1; /* Isonchronous Endpoint */
|
|
uint32_t ATLE : 1; /* ATLE (Auto Transfer Length Extract) */
|
|
uint32_t Rsrvd : 5; /* Reserved */
|
|
uint32_t LenPos : 8; /* Length Position (ATLE) */
|
|
} Type;
|
|
uint32_t Val;
|
|
} Cfg;
|
|
} USB_DMA_DESCRIPTOR;
|
|
|
|
extern "C" {
|
|
/* USB Hardware Functions */
|
|
extern void USB_Init (void);
|
|
extern void USB_Connect (uint32_t con);
|
|
extern void USB_Reset (void);
|
|
extern void USB_Suspend (void);
|
|
extern void USB_Resume (void);
|
|
extern void USB_WakeUp (void);
|
|
extern void USB_WakeUpCfg (uint32_t cfg);
|
|
extern void USB_SetAddress (uint32_t adr);
|
|
extern void USB_Configure (uint32_t cfg);
|
|
extern void USB_ConfigEP (USB_ENDPOINT_DESCRIPTOR *pEPD);
|
|
extern void USB_DirCtrlEP (uint32_t dir);
|
|
extern void USB_EnableEP (uint32_t EPNum);
|
|
extern void USB_DisableEP (uint32_t EPNum);
|
|
extern void USB_ResetEP (uint32_t EPNum);
|
|
extern void USB_SetStallEP (uint32_t EPNum);
|
|
extern void USB_ClrStallEP (uint32_t EPNum);
|
|
extern void USB_ClearEPBuf (uint32_t EPNum);
|
|
extern uint32_t USB_ReadEP (uint32_t EPNum, uint8_t *pData);
|
|
extern uint32_t USB_WriteEP (uint32_t EPNum, uint8_t *pData, uint32_t cnt);
|
|
extern uint32_t USB_DMA_Setup (uint32_t EPNum, USB_DMA_DESCRIPTOR *pDD);
|
|
extern void USB_DMA_Enable (uint32_t EPNum);
|
|
extern void USB_DMA_Disable(uint32_t EPNum);
|
|
extern uint32_t USB_DMA_Status (uint32_t EPNum);
|
|
extern uint32_t USB_DMA_BufAdr (uint32_t EPNum);
|
|
extern uint32_t USB_DMA_BufCnt (uint32_t EPNum);
|
|
extern uint32_t USB_GetFrame (void);
|
|
extern void USB_IRQHandler (void);
|
|
}
|
|
|
|
#endif /* __USBHW_H__ */
|