Home | History | Annotate | Line # | Download | only in sdmmc
      1 /*	$OpenBSD: if_bwfm_sdio.h,v 1.2 2018/05/19 10:43:10 patrick Exp $	*/
      2 /*
      3  * Copyright (c) 2010-2016 Broadcom Corporation
      4  * Copyright (c) 2018 Patrick Wildt <patrick (at) blueri.se>
      5  *
      6  * Permission to use, copy, modify, and/or distribute this software for any
      7  * purpose with or without fee is hereby granted, provided that the above
      8  * copyright notice and this permission notice appear in all copies.
      9  *
     10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
     11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
     12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
     13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
     15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
     16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
     17  */
     18 
     19 /* Registers */
     20 #define BWFM_SDIO_CCCR_CARDCAP			0xf0
     21 #define  BWFM_SDIO_CCCR_CARDCAP_CMD14_SUPPORT		(1 << 1)
     22 #define  BWFM_SDIO_CCCR_CARDCAP_CMD14_EXT		(1 << 2)
     23 #define  BWFM_SDIO_CCCR_CARDCAP_CMD_NODEC		(1 << 3)
     24 #define BWFM_SDIO_CCCR_CARDCTRL			0xf1
     25 #define  BWFM_SDIO_CCCR_CARDCTRL_WLANRESET		(1 << 1)
     26 #define BWFM_SDIO_CCCR_SEPINT			0xf2
     27 #define  BWFM_SDIO_CCCR_SEPINT_MASK			0x01
     28 #define  BWFM_SDIO_CCCR_SEPINT_OE			(1 << 1)
     29 #define  BWFM_SDIO_CCCR_SEPINT_ACT_HI			(1 << 2)
     30 
     31 #define BWFM_SDIO_WATERMARK			0x10008
     32 #define BWFM_SDIO_DEVICE_CTL			0x10009
     33 #define  BWFM_SDIO_DEVICE_CTL_SETBUSY				0x01
     34 #define  BWFM_SDIO_DEVICE_CTL_SPI_INTR_SYNC			0x02
     35 #define  BWFM_SDIO_DEVICE_CTL_CA_INT_ONLY			0x04
     36 #define  BWFM_SDIO_DEVICE_CTL_PADS_ISO				0x08
     37 #define  BWFM_SDIO_DEVICE_CTL_SB_RST_CTL			0x30
     38 #define  BWFM_SDIO_DEVICE_CTL_RST_CORECTL			0x00
     39 #define  BWFM_SDIO_DEVICE_CTL_RST_BPRESET			0x10
     40 #define  BWFM_SDIO_DEVICE_CTL_RST_NOBPRESET			0x20
     41 #define BWFM_SDIO_FUNC1_SBADDRLOW		0x1000A
     42 #define BWFM_SDIO_FUNC1_SBADDRMID		0x1000B
     43 #define BWFM_SDIO_FUNC1_SBADDRHIGH		0x1000C
     44 #define BWFM_SDIO_FUNC1_FRAMECTRL		0x1000D
     45 #define  BWFM_SDIO_FUNC1_FRAMECTRL_RF_TERM		(1 << 0)
     46 #define  BWFM_SDIO_FUNC1_FRAMECTRL_WF_TERM		(1 << 1)
     47 #define  BWFM_SDIO_FUNC1_FRAMECTRL_CRC4WOOS		(1 << 2)
     48 #define  BWFM_SDIO_FUNC1_FRAMECTRL_ABORTALL		(1 << 3)
     49 #define BWFM_SDIO_FUNC1_CHIPCLKCSR		0x1000E
     50 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_FORCE_ALP			0x01
     51 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_FORCE_HT			0x02
     52 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_FORCE_ILP			0x04
     53 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_ALP_AVAIL_REQ		0x08
     54 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_HT_AVAIL_REQ		0x10
     55 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_FORCE_HW_CLKREQ_OFF		0x20
     56 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_ALP_AVAIL			0x40
     57 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_HT_AVAIL			0x80
     58 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_CSR_MASK			0x1F
     59 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_AVBITS				\
     60 		(BWFM_SDIO_FUNC1_CHIPCLKCSR_HT_AVAIL | \
     61 		 BWFM_SDIO_FUNC1_CHIPCLKCSR_ALP_AVAIL)
     62 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_ALPAV(regval)			\
     63 		((regval) & BWFM_SDIO_FUNC1_CHIPCLKCSR_AVBITS)
     64 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_HTAV(regval)			\
     65 		(((regval) & BWFM_SDIO_FUNC1_CHIPCLKCSR_AVBITS) == BWFM_SDIO_FUNC1_CHIPCLKCSR_AVBITS)
     66 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_ALPONLY(regval)			\
     67 		(BWFM_SDIO_FUNC1_CHIPCLKCSR_ALPAV(regval) && \
     68 		 !BWFM_SDIO_FUNC1_CHIPCLKCSR_HTAV(regval))
     69 #define  BWFM_SDIO_FUNC1_CHIPCLKCSR_CLKAV(regval, alponly) \
     70 		(BWFM_SDIO_FUNC1_CHIPCLKCSR_ALPAV(regval) && \
     71 		 (alponly ? 1 : BWFM_SDIO_FUNC1_CHIPCLKCSR_HTAV(regval)))
     72 #define BWFM_SDIO_FUNC1_SDIOPULLUP		0x1000F
     73 #define BWFM_SDIO_FUNC1_WFRAMEBCLO		0x10019
     74 #define BWFM_SDIO_FUNC1_WFRAMEBCHI		0x1001A
     75 #define BWFM_SDIO_FUNC1_RFRAMEBCLO		0x1001B
     76 #define BWFM_SDIO_FUNC1_RFRAMEBCHI		0x1001C
     77 #define BWFM_SDIO_FUNC1_MESBUSYCTRL		0x1001D
     78 #define BWFM_SDIO_FUNC1_WAKEUPCTRL		0x1001E
     79 #define  BWFM_SDIO_FUNC1_WAKEUPCTRL_HTWAIT		(1 << 1)
     80 #define BWFM_SDIO_FUNC1_SLEEPCSR		0x1001F
     81 #define  BWFM_SDIO_FUNC1_SLEEPCSR_KSO		(1 << 0)
     82 #define  BWFM_SDIO_FUNC1_SLEEPCSR_DEVON		(1 << 1)
     83 
     84 #define BWFM_SDIO_SB_OFT_ADDR_PAGE		0x08000
     85 #define BWFM_SDIO_SB_OFT_ADDR_MASK		0x07FFF
     86 #define BWFM_SDIO_SB_ACCESS_2_4B_FLAG		0x08000
     87 
     88 /* Protocol defines */
     89 #define SDPCM_PROT_VERSION			4
     90 #define SDPCM_PROT_VERSION_SHIFT		16
     91 #define SDPCM_PROT_VERSION_MASK			0x00ff0000
     92 #define SDPCM_SHARED_VERSION			0x0003
     93 #define SDPCM_SHARED_VERSION_MASK		0x00FF
     94 #define SDPCM_SHARED_ASSERT_BUILT		0x0100
     95 #define SDPCM_SHARED_ASSERT			0x0200
     96 #define SDPCM_SHARED_TRAP			0x0400
     97 
     98 #define SDPCMD_INTSTATUS			0x020
     99 #define  SDPCMD_INTSTATUS_SMB_SW0			(1 << 0) /* To SB Mail S/W interrupt 0 */
    100 #define  SDPCMD_INTSTATUS_SMB_SW1			(1 << 1) /* To SB Mail S/W interrupt 1 */
    101 #define  SDPCMD_INTSTATUS_SMB_SW2			(1 << 2) /* To SB Mail S/W interrupt 2 */
    102 #define  SDPCMD_INTSTATUS_SMB_SW3			(1 << 3) /* To SB Mail S/W interrupt 3 */
    103 #define  SDPCMD_INTSTATUS_SMB_SW_MASK			0x0000000f /* To SB Mail S/W interrupts mask */
    104 #define  SDPCMD_INTSTATUS_SMB_SW_SHIFT			0	 /* To SB Mail S/W interrupts shift */
    105 #define  SDPCMD_INTSTATUS_HMB_SW0			(1 << 4) /* To Host Mail S/W interrupt 0 */
    106 #define  SDPCMD_INTSTATUS_HMB_SW1			(1 << 5) /* To Host Mail S/W interrupt 1 */
    107 #define  SDPCMD_INTSTATUS_HMB_SW2			(1 << 6) /* To Host Mail S/W interrupt 2 */
    108 #define  SDPCMD_INTSTATUS_HMB_SW3			(1 << 7) /* To Host Mail S/W interrupt 3 */
    109 #define  SDPCMD_INTSTATUS_HMB_FC_STATE			SDPCMD_INTSTATUS_HMB_SW0
    110 #define  SDPCMD_INTSTATUS_HMB_FC_CHANGE			SDPCMD_INTSTATUS_HMB_SW1
    111 #define  SDPCMD_INTSTATUS_HMB_FRAME_IND			SDPCMD_INTSTATUS_HMB_SW2
    112 #define  SDPCMD_INTSTATUS_HMB_HOST_INT			SDPCMD_INTSTATUS_HMB_SW3
    113 #define  SDPCMD_INTSTATUS_HMB_SW_MASK			0x000000f0 /* To Host Mail S/W interrupts mask */
    114 #define  SDPCMD_INTSTATUS_HMB_SW_SHIFT			4	 /* To Host Mail S/W interrupts shift */
    115 #define  SDPCMD_INTSTATUS_WR_OOSYNC			(1 << 8) /* Write Frame Out Of Sync */
    116 #define  SDPCMD_INTSTATUS_RD_OOSYNC			(1 << 9) /* Read Frame Out Of Sync */
    117 #define  SDPCMD_INTSTATUS_PC				(1 << 10)/* descriptor error */
    118 #define  SDPCMD_INTSTATUS_PD				(1 << 11)/* data error */
    119 #define  SDPCMD_INTSTATUS_DE				(1 << 12)/* Descriptor protocol Error */
    120 #define  SDPCMD_INTSTATUS_RU				(1 << 13)/* Receive descriptor Underflow */
    121 #define  SDPCMD_INTSTATUS_RO				(1 << 14)/* Receive fifo Overflow */
    122 #define  SDPCMD_INTSTATUS_XU				(1 << 15)/* Transmit fifo Underflow */
    123 #define  SDPCMD_INTSTATUS_RI				(1 << 16)/* Receive Interrupt */
    124 #define  SDPCMD_INTSTATUS_BUSPWR			(1 << 17)/* SDIO Bus Power Change (rev 9) */
    125 #define  SDPCMD_INTSTATUS_XMTDATA_AVAIL			(1 << 23)/* bits in fifo */
    126 #define  SDPCMD_INTSTATUS_XI				(1 << 24)/* Transmit Interrupt */
    127 #define  SDPCMD_INTSTATUS_RF_TERM			(1 << 25)/* Read Frame Terminate */
    128 #define  SDPCMD_INTSTATUS_WF_TERM			(1 << 26)/* Write Frame Terminate */
    129 #define  SDPCMD_INTSTATUS_PCMCIA_XU			(1 << 27)/* PCMCIA Transmit FIFO Underflow */
    130 #define  SDPCMD_INTSTATUS_SBINT				(1 << 28)/* sbintstatus Interrupt */
    131 #define  SDPCMD_INTSTATUS_CHIPACTIVE			(1 << 29)/* chip from doze to active state */
    132 #define  SDPCMD_INTSTATUS_SRESET			(1 << 30)/* CCCR RES interrupt */
    133 #define  SDPCMD_INTSTATUS_IOE2				(1U << 31)/* CCCR IOE2 Bit Changed */
    134 #define  SDPCMD_INTSTATUS_ERRORS			(SDPCMD_INTSTATUS_PC | \
    135 							 SDPCMD_INTSTATUS_PD | \
    136 							 SDPCMD_INTSTATUS_DE | \
    137 							 SDPCMD_INTSTATUS_RU | \
    138 							 SDPCMD_INTSTATUS_RO | \
    139 							 SDPCMD_INTSTATUS_XU)
    140 #define  SDPCMD_INTSTATUS_DMA				(SDPCMD_INTSTATUS_RI | \
    141 							 SDPCMD_INTSTATUS_XI | \
    142 							 SDPCMD_INTSTATUS_ERRORS)
    143 #define SDPCMD_HOSTINTMASK			0x024
    144 #define SDPCMD_INTMASK				0x028
    145 #define SDPCMD_SBINTSTATUS			0x02c
    146 #define SDPCMD_SBINTMASK			0x030
    147 #define SDPCMD_FUNCTINTMASK			0x034
    148 #define SDPCMD_TOSBMAILBOX			0x040
    149 #define  SDPCMD_TOSBMAILBOX_NAK				(1 << 0)
    150 #define  SDPCMD_TOSBMAILBOX_INT_ACK			(1 << 1)
    151 #define  SDPCMD_TOSBMAILBOX_USE_OOB			(1 << 2)
    152 #define  SDPCMD_TOSBMAILBOX_DEV_INT			(1 << 3)
    153 #define SDPCMD_TOHOSTMAILBOX			0x044
    154 #define SDPCMD_TOSBMAILBOXDATA			0x048
    155 #define SDPCMD_TOHOSTMAILBOXDATA		0x04C
    156 #define  SDPCMD_TOHOSTMAILBOXDATA_NAKHANDLED		(1 << 0)
    157 #define  SDPCMD_TOHOSTMAILBOXDATA_DEVREADY		(1 << 1)
    158 #define  SDPCMD_TOHOSTMAILBOXDATA_FC			(1 << 2)
    159 #define  SDPCMD_TOHOSTMAILBOXDATA_FWREADY		(1 << 3)
    160 #define  SDPCMD_TOHOSTMAILBOXDATA_FWHALT		(1 << 4)
    161 
    162 struct bwfm_sdio_hwhdr {
    163 	uint16_t frmlen;
    164 	uint16_t cksum;
    165 };
    166 
    167 struct bwfm_sdio_hwexthdr {
    168 	uint16_t pktlen;
    169 	uint8_t res0;
    170 	uint8_t flags;
    171 	uint16_t res1;
    172 	uint16_t padlen;
    173 };
    174 
    175 struct bwfm_sdio_swhdr {
    176 	uint8_t seqnr;
    177 	uint8_t chanflag; /* channel + flag */
    178 #define BWFM_SDIO_SWHDR_CHANNEL_CONTROL		0x00
    179 #define BWFM_SDIO_SWHDR_CHANNEL_EVENT		0x01
    180 #define BWFM_SDIO_SWHDR_CHANNEL_DATA		0x02
    181 #define BWFM_SDIO_SWHDR_CHANNEL_GLOM		0x03
    182 #define BWFM_SDIO_SWHDR_CHANNEL_TEST		0x0F
    183 #define BWFM_SDIO_SWHDR_CHANNEL_MASK		0x0F
    184 	uint8_t nextlen;
    185 	uint8_t dataoff;
    186 	uint8_t flowctl;
    187 	uint8_t maxseqnr;
    188 	uint16_t res0;
    189 };
    190 
    191 struct bwfm_sdio_sdpcm {
    192 	uint32_t flags;
    193 	uint32_t trap_addr;
    194 	uint32_t assert_exp_addr;
    195 	uint32_t assert_file_addr;
    196 	uint32_t assert_line;
    197 	uint32_t console_addr;
    198 	uint32_t msgtrace_addr;
    199 	uint8_t tag[32];
    200 	uint32_t brpt_addr;
    201 };
    202 
    203 struct bwfm_sdio_console {
    204 	uint32_t vcons_in;
    205 	uint32_t vcons_out;
    206 	uint32_t log_buf;
    207 	uint32_t log_bufsz;
    208 	uint32_t log_idx;
    209 };
    210