1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /****************************************************************************** 3 * 4 * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved. 5 * 6 ******************************************************************************/ 7 8 #ifndef _RTW_IO_H_ 9 #define _RTW_IO_H_ 10 11 #define NUM_IOREQ 8 12 13 #define MAX_PROT_SZ (64-16) 14 15 #define _IOREADY 0 16 #define _IO_WAIT_COMPLETE 1 17 #define _IO_WAIT_RSP 2 18 19 /* IO COMMAND TYPE */ 20 #define _IOSZ_MASK_ (0x7F) 21 #define _IO_WRITE_ BIT(7) 22 #define _IO_FIXED_ BIT(8) 23 #define _IO_BURST_ BIT(9) 24 #define _IO_BYTE_ BIT(10) 25 #define _IO_HW_ BIT(11) 26 #define _IO_WORD_ BIT(12) 27 #define _IO_SYNC_ BIT(13) 28 #define _IO_CMDMASK_ (0x1F80) 29 30 31 /* 32 For prompt mode accessing, caller shall free io_req 33 Otherwise, io_handler will free io_req 34 */ 35 36 37 38 /* IO STATUS TYPE */ 39 #define _IO_ERR_ BIT(2) 40 #define _IO_SUCCESS_ BIT(1) 41 #define _IO_DONE_ BIT(0) 42 43 44 #define IO_RD32 (_IO_SYNC_ | _IO_WORD_) 45 #define IO_RD16 (_IO_SYNC_ | _IO_HW_) 46 #define IO_RD8 (_IO_SYNC_ | _IO_BYTE_) 47 48 #define IO_RD32_ASYNC (_IO_WORD_) 49 #define IO_RD16_ASYNC (_IO_HW_) 50 #define IO_RD8_ASYNC (_IO_BYTE_) 51 52 #define IO_WR32 (_IO_WRITE_ | _IO_SYNC_ | _IO_WORD_) 53 #define IO_WR16 (_IO_WRITE_ | _IO_SYNC_ | _IO_HW_) 54 #define IO_WR8 (_IO_WRITE_ | _IO_SYNC_ | _IO_BYTE_) 55 56 #define IO_WR32_ASYNC (_IO_WRITE_ | _IO_WORD_) 57 #define IO_WR16_ASYNC (_IO_WRITE_ | _IO_HW_) 58 #define IO_WR8_ASYNC (_IO_WRITE_ | _IO_BYTE_) 59 60 /* 61 62 Only Sync. burst accessing is provided. 63 64 */ 65 66 #define IO_WR_BURST(x) (_IO_WRITE_ | _IO_SYNC_ | _IO_BURST_ | ((x) & _IOSZ_MASK_)) 67 #define IO_RD_BURST(x) (_IO_SYNC_ | _IO_BURST_ | ((x) & _IOSZ_MASK_)) 68 69 70 71 /* below is for the intf_option bit defition... */ 72 73 #define _INTF_ASYNC_ BIT(0) /* support async io */ 74 75 struct intf_priv; 76 struct intf_hdl; 77 struct io_queue; 78 79 struct _io_ops { 80 u8 (*_read8)(struct intf_hdl *pintfhdl, u32 addr); 81 u16 (*_read16)(struct intf_hdl *pintfhdl, u32 addr); 82 u32 (*_read32)(struct intf_hdl *pintfhdl, u32 addr); 83 84 int (*_write8)(struct intf_hdl *pintfhdl, u32 addr, u8 val); 85 int (*_write16)(struct intf_hdl *pintfhdl, u32 addr, u16 val); 86 int (*_write32)(struct intf_hdl *pintfhdl, u32 addr, u32 val); 87 int (*_writeN)(struct intf_hdl *pintfhdl, u32 addr, u32 length, u8 *pdata); 88 89 int (*_write8_async)(struct intf_hdl *pintfhdl, u32 addr, u8 val); 90 int (*_write16_async)(struct intf_hdl *pintfhdl, u32 addr, u16 val); 91 int (*_write32_async)(struct intf_hdl *pintfhdl, u32 addr, u32 val); 92 93 void (*_read_mem)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, u8 *pmem); 94 void (*_write_mem)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, u8 *pmem); 95 96 void (*_sync_irp_protocol_rw)(struct io_queue *pio_q); 97 98 u32 (*_read_interrupt)(struct intf_hdl *pintfhdl, u32 addr); 99 100 u32 (*_read_port)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, u8 *pmem); 101 u32 (*_write_port)(struct intf_hdl *pintfhdl, u32 addr, u32 cnt, u8 *pmem); 102 103 u32 (*_write_scsi)(struct intf_hdl *pintfhdl, u32 cnt, u8 *pmem); 104 105 void (*_read_port_cancel)(struct intf_hdl *pintfhdl); 106 void (*_write_port_cancel)(struct intf_hdl *pintfhdl); 107 108 u8 (*_sd_f0_read8)(struct intf_hdl *pintfhdl, u32 addr); 109 }; 110 111 struct io_req { 112 struct list_head list; 113 u32 addr; 114 volatile u32 val; 115 u32 command; 116 u32 status; 117 u8 *pbuf; 118 _sema sema; 119 120 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt); 121 u8 *cnxt; 122 }; 123 124 struct intf_hdl { 125 struct adapter *padapter; 126 struct dvobj_priv *pintf_dev;/* pointer to &(padapter->dvobjpriv); */ 127 128 struct _io_ops io_ops; 129 }; 130 131 struct reg_protocol_rd { 132 133 #ifdef __LITTLE_ENDIAN 134 135 /* DW1 */ 136 u32 NumOfTrans:4; 137 u32 Reserved1:4; 138 u32 Reserved2:24; 139 /* DW2 */ 140 u32 ByteCount:7; 141 u32 WriteEnable:1; /* 0:read, 1:write */ 142 u32 FixOrContinuous:1; /* 0:continuous, 1: Fix */ 143 u32 BurstMode:1; 144 u32 Byte1Access:1; 145 u32 Byte2Access:1; 146 u32 Byte4Access:1; 147 u32 Reserved3:3; 148 u32 Reserved4:16; 149 /* DW3 */ 150 u32 BusAddress; 151 /* DW4 */ 152 /* u32 Value; */ 153 #else 154 155 156 /* DW1 */ 157 u32 Reserved1 :4; 158 u32 NumOfTrans :4; 159 160 u32 Reserved2 :24; 161 162 /* DW2 */ 163 u32 WriteEnable : 1; 164 u32 ByteCount :7; 165 166 167 u32 Reserved3 : 3; 168 u32 Byte4Access : 1; 169 170 u32 Byte2Access : 1; 171 u32 Byte1Access : 1; 172 u32 BurstMode :1 ; 173 u32 FixOrContinuous : 1; 174 175 u32 Reserved4 : 16; 176 177 /* DW3 */ 178 u32 BusAddress; 179 180 /* DW4 */ 181 /* u32 Value; */ 182 183 #endif 184 185 }; 186 187 188 struct reg_protocol_wt { 189 190 191 #ifdef __LITTLE_ENDIAN 192 193 /* DW1 */ 194 u32 NumOfTrans:4; 195 u32 Reserved1:4; 196 u32 Reserved2:24; 197 /* DW2 */ 198 u32 ByteCount:7; 199 u32 WriteEnable:1; /* 0:read, 1:write */ 200 u32 FixOrContinuous:1; /* 0:continuous, 1: Fix */ 201 u32 BurstMode:1; 202 u32 Byte1Access:1; 203 u32 Byte2Access:1; 204 u32 Byte4Access:1; 205 u32 Reserved3:3; 206 u32 Reserved4:16; 207 /* DW3 */ 208 u32 BusAddress; 209 /* DW4 */ 210 u32 Value; 211 212 #else 213 /* DW1 */ 214 u32 Reserved1 :4; 215 u32 NumOfTrans :4; 216 217 u32 Reserved2 :24; 218 219 /* DW2 */ 220 u32 WriteEnable : 1; 221 u32 ByteCount :7; 222 223 u32 Reserved3 : 3; 224 u32 Byte4Access : 1; 225 226 u32 Byte2Access : 1; 227 u32 Byte1Access : 1; 228 u32 BurstMode :1 ; 229 u32 FixOrContinuous : 1; 230 231 u32 Reserved4 : 16; 232 233 /* DW3 */ 234 u32 BusAddress; 235 236 /* DW4 */ 237 u32 Value; 238 239 #endif 240 241 }; 242 #define SD_IO_TRY_CNT (8) 243 #define MAX_CONTINUAL_IO_ERR SD_IO_TRY_CNT 244 245 int rtw_inc_and_chk_continual_io_error(struct dvobj_priv *dvobj); 246 void rtw_reset_continual_io_error(struct dvobj_priv *dvobj); 247 248 /* 249 Below is the data structure used by _io_handler 250 251 */ 252 253 struct io_queue { 254 _lock lock; 255 struct list_head free_ioreqs; 256 struct list_head pending; /* The io_req list that will be served in the single protocol read/write. */ 257 struct list_head processing; 258 u8 *free_ioreqs_buf; /* 4-byte aligned */ 259 u8 *pallocated_free_ioreqs_buf; 260 struct intf_hdl intf; 261 }; 262 263 struct io_priv{ 264 265 struct adapter *padapter; 266 267 struct intf_hdl intf; 268 269 }; 270 271 extern uint ioreq_flush(struct adapter *adapter, struct io_queue *ioqueue); 272 extern void sync_ioreq_enqueue(struct io_req *preq, struct io_queue *ioqueue); 273 extern uint sync_ioreq_flush(struct adapter *adapter, struct io_queue *ioqueue); 274 275 276 extern uint free_ioreq(struct io_req *preq, struct io_queue *pio_queue); 277 extern struct io_req *alloc_ioreq(struct io_queue *pio_q); 278 279 extern uint register_intf_hdl(u8 *dev, struct intf_hdl *pintfhdl); 280 extern void unregister_intf_hdl(struct intf_hdl *pintfhdl); 281 282 extern void _rtw_attrib_read(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 283 extern void _rtw_attrib_write(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 284 285 extern u8 _rtw_read8(struct adapter *adapter, u32 addr); 286 extern u16 _rtw_read16(struct adapter *adapter, u32 addr); 287 extern u32 _rtw_read32(struct adapter *adapter, u32 addr); 288 289 extern int _rtw_write8(struct adapter *adapter, u32 addr, u8 val); 290 extern int _rtw_write16(struct adapter *adapter, u32 addr, u16 val); 291 extern int _rtw_write32(struct adapter *adapter, u32 addr, u32 val); 292 293 extern u8 _rtw_sd_f0_read8(struct adapter *adapter, u32 addr); 294 295 extern u32 _rtw_write_port(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 296 297 #define rtw_read8(adapter, addr) _rtw_read8((adapter), (addr)) 298 #define rtw_read16(adapter, addr) _rtw_read16((adapter), (addr)) 299 #define rtw_read32(adapter, addr) _rtw_read32((adapter), (addr)) 300 301 #define rtw_write8(adapter, addr, val) _rtw_write8((adapter), (addr), (val)) 302 #define rtw_write16(adapter, addr, val) _rtw_write16((adapter), (addr), (val)) 303 #define rtw_write32(adapter, addr, val) _rtw_write32((adapter), (addr), (val)) 304 305 #define rtw_write_port(adapter, addr, cnt, mem) _rtw_write_port((adapter), (addr), (cnt), (mem)) 306 307 #define rtw_sd_f0_read8(adapter, addr) _rtw_sd_f0_read8((adapter), (addr)) 308 309 extern void rtw_write_scsi(struct adapter *adapter, u32 cnt, u8 *pmem); 310 311 /* ioreq */ 312 extern void ioreq_read8(struct adapter *adapter, u32 addr, u8 *pval); 313 extern void ioreq_read16(struct adapter *adapter, u32 addr, u16 *pval); 314 extern void ioreq_read32(struct adapter *adapter, u32 addr, u32 *pval); 315 extern void ioreq_write8(struct adapter *adapter, u32 addr, u8 val); 316 extern void ioreq_write16(struct adapter *adapter, u32 addr, u16 val); 317 extern void ioreq_write32(struct adapter *adapter, u32 addr, u32 val); 318 319 320 extern uint async_read8(struct adapter *adapter, u32 addr, u8 *pbuff, 321 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt), u8 *cnxt); 322 extern uint async_read16(struct adapter *adapter, u32 addr, u8 *pbuff, 323 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt), u8 *cnxt); 324 extern uint async_read32(struct adapter *adapter, u32 addr, u8 *pbuff, 325 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt), u8 *cnxt); 326 327 extern void async_read_mem(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 328 extern void async_read_port(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 329 330 extern void async_write8(struct adapter *adapter, u32 addr, u8 val, 331 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt), u8 *cnxt); 332 extern void async_write16(struct adapter *adapter, u32 addr, u16 val, 333 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt), u8 *cnxt); 334 extern void async_write32(struct adapter *adapter, u32 addr, u32 val, 335 void (*_async_io_callback)(struct adapter *padater, struct io_req *pio_req, u8 *cnxt), u8 *cnxt); 336 337 extern void async_write_mem(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 338 extern void async_write_port(struct adapter *adapter, u32 addr, u32 cnt, u8 *pmem); 339 340 341 int rtw_init_io_priv(struct adapter *padapter, void (*set_intf_ops)(struct adapter *padapter, struct _io_ops *pops)); 342 343 344 extern uint alloc_io_queue(struct adapter *adapter); 345 extern void free_io_queue(struct adapter *adapter); 346 extern void async_bus_io(struct io_queue *pio_q); 347 extern void bus_sync_io(struct io_queue *pio_q); 348 extern u32 _ioreq2rwmem(struct io_queue *pio_q); 349 extern void dev_power_down(struct adapter * Adapter, u8 bpwrup); 350 351 #define PlatformEFIOWrite1Byte(_a, _b, _c) \ 352 rtw_write8(_a, _b, _c) 353 #define PlatformEFIOWrite2Byte(_a, _b, _c) \ 354 rtw_write16(_a, _b, _c) 355 #define PlatformEFIOWrite4Byte(_a, _b, _c) \ 356 rtw_write32(_a, _b, _c) 357 358 #define PlatformEFIORead1Byte(_a, _b) \ 359 rtw_read8(_a, _b) 360 #define PlatformEFIORead2Byte(_a, _b) \ 361 rtw_read16(_a, _b) 362 #define PlatformEFIORead4Byte(_a, _b) \ 363 rtw_read32(_a, _b) 364 365 #endif /* _RTL8711_IO_H_ */ 366