freebsd-dev/sys/dev/usb/controller/at91dci.h

/* $FreeBSD$ */
/*-
 * Copyright (c) 2006 ATMEL
 * Copyright (c) 2007 Hans Petter Selasky <hselasky@FreeBSD.org>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

/*
 * USB Device Port (UDP) register definition, based on "AT91RM9200.h" provided
 * by ATMEL.
 */

#ifndef _AT9100_DCI_H_
#define	_AT9100_DCI_H_

#define	AT91_MAX_DEVICES (USB_MIN_DEVICES + 1)

#define	AT91_UDP_FRM 	0x00		/* Frame number register */
#define	AT91_UDP_FRM_MASK     (0x7FF <<  0)	/* Frame Number as Defined in
						 * the Packet Field Formats */
#define	AT91_UDP_FRM_ERR      (0x1 << 16)	/* Frame Error */
#define	AT91_UDP_FRM_OK       (0x1 << 17)	/* Frame OK */

#define	AT91_UDP_GSTATE 0x04		/* Global state register */
#define	AT91_UDP_GSTATE_ADDR  (0x1 <<  0)	/* Addressed state */
#define	AT91_UDP_GSTATE_CONFG (0x1 <<  1)	/* Configured */
#define	AT91_UDP_GSTATE_ESR   (0x1 <<  2)	/* Enable Send Resume */
#define	AT91_UDP_GSTATE_RSM   (0x1 <<  3)	/* A Resume Has Been Sent to
						 * the Host */
#define	AT91_UDP_GSTATE_RMW   (0x1 <<  4)	/* Remote Wake Up Enable */

#define	AT91_UDP_FADDR	0x08		/* Function Address Register */
#define	AT91_UDP_FADDR_MASK  (0x7F << 0)/* Function Address Mask */
#define	AT91_UDP_FADDR_EN    (0x1 <<  8)/* Function Enable */

#define	AT91_UDP_RES0	0x0C		/* Reserved 0 */

#define	AT91_UDP_IER	0x10		/* Interrupt Enable Register */
#define	AT91_UDP_IDR	0x14		/* Interrupt Disable Register */
#define	AT91_UDP_IMR	0x18		/* Interrupt Mask Register */
#define	AT91_UDP_ISR	0x1C		/* Interrupt Status Register */
#define	AT91_UDP_ICR	0x20		/* Interrupt Clear Register */
#define	AT91_UDP_INT_EP(n)   (0x1 <<(n))/* Endpoint "n" Interrupt */
#define	AT91_UDP_INT_RXSUSP  (0x1 <<  8)/* USB Suspend Interrupt */
#define	AT91_UDP_INT_RXRSM   (0x1 <<  9)/* USB Resume Interrupt */
#define	AT91_UDP_INT_EXTRSM  (0x1 << 10)/* USB External Resume Interrupt */
#define	AT91_UDP_INT_SOFINT  (0x1 << 11)/* USB Start Of frame Interrupt */
#define	AT91_UDP_INT_END_BR  (0x1 << 12)/* USB End Of Bus Reset Interrupt */
#define	AT91_UDP_INT_WAKEUP  (0x1 << 13)/* USB Resume Interrupt */

#define	AT91_UDP_INT_BUS \
  (AT91_UDP_INT_RXSUSP|AT91_UDP_INT_RXRSM| \
   AT91_UDP_INT_END_BR)

#define	AT91_UDP_INT_EPS \
  (AT91_UDP_INT_EP(0)|AT91_UDP_INT_EP(1)| \
   AT91_UDP_INT_EP(2)|AT91_UDP_INT_EP(3)| \
   AT91_UDP_INT_EP(4)|AT91_UDP_INT_EP(5))

#define	AT91_UDP_INT_DEFAULT \
  (AT91_UDP_INT_EPS|AT91_UDP_INT_BUS)

#define	AT91_UDP_RES1	0x24		/* Reserved 1 */
#define	AT91_UDP_RST	0x28		/* Reset Endpoint Register */
#define	AT91_UDP_RST_EP(n) (0x1 <<  (n))/* Reset Endpoint "n" */

#define	AT91_UDP_RES2	0x2C		/* Reserved 2 */

#define	AT91_UDP_CSR(n) (0x30 + (4*(n)))/* Endpoint Control and Status
					 * Register */
#define	AT91_UDP_CSR_TXCOMP (0x1 <<  0)	/* Generates an IN packet with data
					 * previously written in the DPR */
#define	AT91_UDP_CSR_RX_DATA_BK0 (0x1 <<  1)	/* Receive Data Bank 0 */
#define	AT91_UDP_CSR_RXSETUP     (0x1 <<  2)	/* Sends STALL to the Host
						 * (Control endpoints) */
#define	AT91_UDP_CSR_ISOERROR    (0x1 <<  3)	/* Isochronous error
						 * (Isochronous endpoints) */
#define	AT91_UDP_CSR_STALLSENT   (0x1 <<  3)	/* Stall sent (Control, bulk,
						 * interrupt endpoints) */
#define	AT91_UDP_CSR_TXPKTRDY    (0x1 <<  4)	/* Transmit Packet Ready */
#define	AT91_UDP_CSR_FORCESTALL  (0x1 <<  5)	/* Force Stall (used by
						 * Control, Bulk and
						 * Isochronous endpoints). */
#define	AT91_UDP_CSR_RX_DATA_BK1 (0x1 <<  6)	/* Receive Data Bank 1 (only
						 * used by endpoints with
						 * ping-pong attributes). */
#define	AT91_UDP_CSR_DIR         (0x1 <<  7)	/* Transfer Direction */
#define	AT91_UDP_CSR_ET_MASK     (0x7 <<  8)	/* Endpoint transfer type mask */
#define	AT91_UDP_CSR_ET_CTRL     (0x0 <<  8)	/* Control IN+OUT */
#define	AT91_UDP_CSR_ET_ISO      (0x1 <<  8)	/* Isochronous */
#define	AT91_UDP_CSR_ET_BULK     (0x2 <<  8)	/* Bulk */
#define	AT91_UDP_CSR_ET_INT      (0x3 <<  8)	/* Interrupt */
#define	AT91_UDP_CSR_ET_DIR_OUT  (0x0 <<  8)	/* OUT tokens */
#define	AT91_UDP_CSR_ET_DIR_IN   (0x4 <<  8)	/* IN tokens */
#define	AT91_UDP_CSR_DTGLE       (0x1 << 11)	/* Data Toggle */
#define	AT91_UDP_CSR_EPEDS       (0x1 << 15)	/* Endpoint Enable Disable */
#define	AT91_UDP_CSR_RXBYTECNT   (0x7FF << 16)	/* Number Of Bytes Available
						 * in the FIFO */

#define	AT91_UDP_FDR(n) (0x50 + (4*(n)))/* Endpoint FIFO Data Register */
#define	AT91_UDP_RES3	0x70		/* Reserved 3 */
#define	AT91_UDP_TXVC	0x74		/* Transceiver Control Register */
#define	AT91_UDP_TXVC_DIS      (0x1 <<  8)

#define	AT91_UDP_EP_MAX 6		/* maximum number of endpoints
					 * supported */

#define	AT91_UDP_READ_4(sc, reg) \
  bus_space_read_4((sc)->sc_io_tag, (sc)->sc_io_hdl, reg)

#define	AT91_UDP_WRITE_4(sc, reg, data)	\
  bus_space_write_4((sc)->sc_io_tag, (sc)->sc_io_hdl, reg, data)

struct at91dci_td;
struct at91dci_softc;

typedef uint8_t (at91dci_cmd_t)(struct at91dci_softc *sc, struct at91dci_td *td);

struct at91dci_td {
	struct at91dci_td *obj_next;
	at91dci_cmd_t *func;
	struct usb_page_cache *pc;
	uint32_t offset;
	uint32_t remainder;
	uint16_t max_packet_size;
	uint8_t	status_reg;
	uint8_t	fifo_reg;
	uint8_t	fifo_bank:1;
	uint8_t	error:1;
	uint8_t	alt_next:1;
	uint8_t	short_pkt:1;
	uint8_t	support_multi_buffer:1;
	uint8_t	did_stall:1;
};

struct at91dci_std_temp {
	at91dci_cmd_t *func;
	struct usb_page_cache *pc;
	struct at91dci_td *td;
	struct at91dci_td *td_next;
	uint32_t len;
	uint32_t offset;
	uint16_t max_frame_size;
	uint8_t	short_pkt;
	/*
         * short_pkt = 0: transfer should be short terminated
         * short_pkt = 1: transfer should not be short terminated
         */
	uint8_t	setup_alt_next;
	uint8_t did_stall;
};

struct at91dci_config_desc {
	struct usb_config_descriptor confd;
	struct usb_interface_descriptor ifcd;
	struct usb_endpoint_descriptor endpd;
} __packed;

union at91dci_hub_temp {
	uWord	wValue;
	struct usb_port_status ps;
};

struct at91dci_ep_flags {
	uint8_t	fifo_bank:1;		/* hardware specific */
};

struct at91dci_flags {
	uint8_t	change_connect:1;
	uint8_t	change_suspend:1;
	uint8_t	status_suspend:1;	/* set if suspended */
	uint8_t	status_vbus:1;		/* set if present */
	uint8_t	status_bus_reset:1;	/* set if reset complete */
	uint8_t	remote_wakeup:1;
	uint8_t	self_powered:1;
	uint8_t	clocks_off:1;
	uint8_t	port_powered:1;
	uint8_t	port_enabled:1;
	uint8_t	d_pulled_up:1;
};

struct at91dci_softc {
	struct usb_bus sc_bus;
	union at91dci_hub_temp sc_hub_temp;

	struct usb_device *sc_devices[AT91_MAX_DEVICES];
	struct resource *sc_io_res;
	struct resource *sc_irq_res;
	void   *sc_intr_hdl;
	bus_size_t sc_io_size;
	bus_space_tag_t sc_io_tag;
	bus_space_handle_t sc_io_hdl;

	void    (*sc_clocks_on) (void *arg);
	void    (*sc_clocks_off) (void *arg);
	void   *sc_clocks_arg;

	void    (*sc_pull_up) (void *arg);
	void    (*sc_pull_down) (void *arg);
	void   *sc_pull_arg;

	uint32_t sc_xfer_complete;

	uint8_t	sc_rt_addr;		/* root HUB address */
	uint8_t	sc_dv_addr;		/* device address */
	uint8_t	sc_conf;		/* root HUB config */

	uint8_t	sc_hub_idata[1];

	struct at91dci_flags sc_flags;
	struct at91dci_ep_flags sc_ep_flags[AT91_UDP_EP_MAX];
};

/* prototypes */

usb_error_t at91dci_init(struct at91dci_softc *sc);
void	at91dci_uninit(struct at91dci_softc *sc);
driver_filter_t at91dci_filter_interrupt;
driver_intr_t at91dci_interrupt;
void	at91dci_vbus_interrupt(struct at91dci_softc *sc, uint8_t is_on);

#endif					/* _AT9100_DCI_H_ */