1 /****************************************************************************** 2 * 3 * Copyright(c) 2007 - 2010 Realtek Corporation. All rights reserved. 4 * 5 * This program is free software; you can redistribute it and/or modify it 6 * under the terms of version 2 of the GNU General Public License as 7 * published by the Free Software Foundation. 8 * 9 * This program is distributed in the hope that it will be useful, but WITHOUT 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 12 * more details. 13 * 14 * You should have received a copy of the GNU General Public License along with 15 * this program; if not, write to the Free Software Foundation, Inc., 16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA 17 * 18 * Modifications for inclusion into the Linux staging tree are 19 * Copyright(c) 2010 Larry Finger. All rights reserved. 20 * 21 * Contact information: 22 * WLAN FAE <wlanfae@realtek.com> 23 * Larry Finger <Larry.Finger@lwfinger.net> 24 * 25 ******************************************************************************/ 26 #ifndef _IO_H_ 27 #define _IO_H_ 28 29 #include "osdep_service.h" 30 #include "osdep_intf.h" 31 32 #define NUM_IOREQ 8 33 34 #define MAX_PROT_SZ (64-16) 35 36 #define _IOREADY 0 37 #define _IO_WAIT_COMPLETE 1 38 #define _IO_WAIT_RSP 2 39 40 /* IO COMMAND TYPE */ 41 #define _IOSZ_MASK_ (0x7F) 42 #define _IO_WRITE_ BIT(7) 43 #define _IO_FIXED_ BIT(8) 44 #define _IO_BURST_ BIT(9) 45 #define _IO_BYTE_ BIT(10) 46 #define _IO_HW_ BIT(11) 47 #define _IO_WORD_ BIT(12) 48 #define _IO_SYNC_ BIT(13) 49 #define _IO_CMDMASK_ (0x1F80) 50 51 /* 52 For prompt mode accessing, caller shall free io_req 53 Otherwise, io_handler will free io_req 54 */ 55 /* IO STATUS TYPE */ 56 #define _IO_ERR_ BIT(2) 57 #define _IO_SUCCESS_ BIT(1) 58 #define _IO_DONE_ BIT(0) 59 #define IO_RD32 (_IO_SYNC_ | _IO_WORD_) 60 #define IO_RD16 (_IO_SYNC_ | _IO_HW_) 61 #define IO_RD8 (_IO_SYNC_ | _IO_BYTE_) 62 #define IO_RD32_ASYNC (_IO_WORD_) 63 #define IO_RD16_ASYNC (_IO_HW_) 64 #define IO_RD8_ASYNC (_IO_BYTE_) 65 #define IO_WR32 (_IO_WRITE_ | _IO_SYNC_ | _IO_WORD_) 66 #define IO_WR16 (_IO_WRITE_ | _IO_SYNC_ | _IO_HW_) 67 #define IO_WR8 (_IO_WRITE_ | _IO_SYNC_ | _IO_BYTE_) 68 #define IO_WR32_ASYNC (_IO_WRITE_ | _IO_WORD_) 69 #define IO_WR16_ASYNC (_IO_WRITE_ | _IO_HW_) 70 #define IO_WR8_ASYNC (_IO_WRITE_ | _IO_BYTE_) 71 /* 72 Only Sync. burst accessing is provided. 73 */ 74 #define IO_WR_BURST(x) (IO_WRITE_ | _IO_SYNC_ | _IO_BURST_ | \ 75 ((x) & _IOSZ_MASK_)) 76 #define IO_RD_BURST(x) (_IO_SYNC_ | _IO_BURST_ | ((x) & _IOSZ_MASK_)) 77 /*below is for the intf_option bit defition...*/ 78 #define _INTF_ASYNC_ BIT(0) /*support async io*/ 79 struct intf_priv; 80 struct intf_hdl; 81 struct io_queue; 82 struct _io_ops { 83 uint (*_sdbus_read_bytes_to_membuf)(struct intf_priv *pintfpriv, 84 u32 addr, u32 cnt, u8 *pbuf); 85 uint (*_sdbus_read_blocks_to_membuf)(struct intf_priv *pintfpriv, 86 u32 addr, u32 cnt, u8 *pbuf); 87 u8 (*_read8)(struct intf_hdl *pintfhdl, u32 addr); 88 u16 (*_read16)(struct intf_hdl *pintfhdl, u32 addr); 89 u32 (*_read32)(struct intf_hdl *pintfhdl, u32 addr); 90 uint (*_sdbus_write_blocks_from_membuf)(struct intf_priv *pintfpriv, 91 u32 addr, u32 cnt, u8 *pbuf, 92 u8 async); 93 uint (*_sdbus_write_bytes_from_membuf)(struct intf_priv *pintfpriv, 94 u32 addr, u32 cnt, u8 *pbuf); 95 u8 (*_cmd52r)(struct intf_priv *pintfpriv, u32 addr); 96 void (*_cmd52w)(struct intf_priv *pintfpriv, u32 addr, u8 val8); 97 u8 (*_cmdfunc152r)(struct intf_priv *pintfpriv, u32 addr); 98 void (*_cmdfunc152w)(struct intf_priv *pintfpriv, u32 addr, u8 val8); 99 void (*_write8)(struct intf_hdl *pintfhdl, u32 addr, u8 val); 100 void (*_write16)(struct intf_hdl *pintfhdl, u32 addr, u16 val); 101 void (*_write32)(struct intf_hdl *pintfhdl, u32 addr, u32 val); 102 void (*_read_mem)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, 103 u8 *pmem); 104 void (*_write_mem)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, 105 u8 *pmem); 106 void (*_sync_irp_protocol_rw)(struct io_queue *pio_q); 107 u32 (*_read_port)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, 108 u8 *pmem); 109 u32 (*_write_port)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, 110 u8 *pmem); 111 }; 112 113 struct io_req { 114 struct list_head list; 115 u32 addr; 116 /*volatile*/ u32 val; 117 u32 command; 118 u32 status; 119 u8 *pbuf; 120 void (*_async_io_callback)(struct _adapter *padapter, 121 struct io_req *pio_req, u8 *cnxt); 122 u8 *cnxt; 123 }; 124 125 struct intf_hdl { 126 u32 intf_option; 127 u8 *adapter; 128 u8 *intf_dev; 129 struct intf_priv *pintfpriv; 130 void (*intf_hdl_init)(u8 *priv); 131 void (*intf_hdl_unload)(u8 *priv); 132 void (*intf_hdl_open)(u8 *priv); 133 void (*intf_hdl_close)(u8 *priv); 134 struct _io_ops io_ops; 135 }; 136 137 struct reg_protocol_rd { 138 139 #ifdef __LITTLE_ENDIAN 140 /* DW1 */ 141 u32 NumOfTrans:4; 142 u32 Reserved1:4; 143 u32 Reserved2:24; 144 /* DW2 */ 145 u32 ByteCount:7; 146 u32 WriteEnable:1; /*0:read, 1:write*/ 147 u32 FixOrContinuous:1; /*0:continuous, 1: Fix*/ 148 u32 BurstMode:1; 149 u32 Byte1Access:1; 150 u32 Byte2Access:1; 151 u32 Byte4Access:1; 152 u32 Reserved3:3; 153 u32 Reserved4:16; 154 /*DW3*/ 155 u32 BusAddress; 156 /*DW4*/ 157 #else 158 /*DW1*/ 159 u32 Reserved1:4; 160 u32 NumOfTrans:4; 161 u32 Reserved2:24; 162 /*DW2*/ 163 u32 WriteEnable:1; 164 u32 ByteCount:7; 165 u32 Reserved3:3; 166 u32 Byte4Access:1; 167 u32 Byte2Access:1; 168 u32 Byte1Access:1; 169 u32 BurstMode:1; 170 u32 FixOrContinuous:1; 171 u32 Reserved4:16; 172 /*DW3*/ 173 u32 BusAddress; 174 /*DW4*/ 175 #endif 176 }; 177 178 struct reg_protocol_wt { 179 #ifdef __LITTLE_ENDIAN 180 /*DW1*/ 181 u32 NumOfTrans:4; 182 u32 Reserved1:4; 183 u32 Reserved2:24; 184 /*DW2*/ 185 u32 ByteCount:7; 186 u32 WriteEnable:1; /*0:read, 1:write*/ 187 u32 FixOrContinuous:1; /*0:continuous, 1: Fix*/ 188 u32 BurstMode:1; 189 u32 Byte1Access:1; 190 u32 Byte2Access:1; 191 u32 Byte4Access:1; 192 u32 Reserved3:3; 193 u32 Reserved4:16; 194 /*DW3*/ 195 u32 BusAddress; 196 /*DW4*/ 197 u32 Value; 198 #else 199 /*DW1*/ 200 u32 Reserved1:4; 201 u32 NumOfTrans:4; 202 u32 Reserved2:24; 203 /*DW2*/ 204 u32 WriteEnable:1; 205 u32 ByteCount:7; 206 u32 Reserved3:3; 207 u32 Byte4Access:1; 208 u32 Byte2Access:1; 209 u32 Byte1Access:1; 210 u32 BurstMode:1; 211 u32 FixOrContinuous:1; 212 u32 Reserved4:16; 213 /*DW3*/ 214 u32 BusAddress; 215 /*DW4*/ 216 u32 Value; 217 #endif 218 }; 219 220 /* 221 Below is the data structure used by _io_handler 222 */ 223 224 struct io_queue { 225 spinlock_t lock; 226 struct list_head free_ioreqs; 227 /*The io_req list that will be served in the single protocol r/w.*/ 228 struct list_head pending; 229 struct list_head processing; 230 u8 *free_ioreqs_buf; /* 4-byte aligned */ 231 u8 *pallocated_free_ioreqs_buf; 232 struct intf_hdl intf; 233 }; 234 235 u8 r8712_read8(struct _adapter *adapter, u32 addr); 236 u16 r8712_read16(struct _adapter *adapter, u32 addr); 237 u32 r8712_read32(struct _adapter *adapter, u32 addr); 238 void r8712_read_mem(struct _adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 239 void r8712_read_port(struct _adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 240 void r8712_write8(struct _adapter *adapter, u32 addr, u8 val); 241 void r8712_write16(struct _adapter *adapter, u32 addr, u16 val); 242 void r8712_write32(struct _adapter *adapter, u32 addr, u32 val); 243 void r8712_write_mem(struct _adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 244 void r8712_write_port(struct _adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 245 /*ioreq */ 246 uint r8712_alloc_io_queue(struct _adapter *adapter); 247 void r8712_free_io_queue(struct _adapter *adapter); 248 249 #endif /*_RTL8711_IO_H_*/ 250 251