umac.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790
  1. /*
  2. * Intel Wireless Multicomm 3200 WiFi driver
  3. *
  4. * Copyright (C) 2009 Intel Corporation. All rights reserved.
  5. *
  6. * Redistribution and use in source and binary forms, with or without
  7. * modification, are permitted provided that the following conditions
  8. * are met:
  9. *
  10. * * Redistributions of source code must retain the above copyright
  11. * notice, this list of conditions and the following disclaimer.
  12. * * Redistributions in binary form must reproduce the above copyright
  13. * notice, this list of conditions and the following disclaimer in
  14. * the documentation and/or other materials provided with the
  15. * distribution.
  16. * * Neither the name of Intel Corporation nor the names of its
  17. * contributors may be used to endorse or promote products derived
  18. * from this software without specific prior written permission.
  19. *
  20. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  21. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  22. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  23. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  24. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  25. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  26. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  27. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  28. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  29. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  30. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31. *
  32. *
  33. * Intel Corporation <ilw@linux.intel.com>
  34. * Samuel Ortiz <samuel.ortiz@intel.com>
  35. * Zhu Yi <yi.zhu@intel.com>
  36. *
  37. */
  38. #ifndef __IWM_UMAC_H__
  39. #define __IWM_UMAC_H__
  40. struct iwm_udma_in_hdr {
  41. __le32 cmd;
  42. __le32 size;
  43. } __packed;
  44. struct iwm_udma_out_nonwifi_hdr {
  45. __le32 cmd;
  46. __le32 addr;
  47. __le32 op1_sz;
  48. __le32 op2;
  49. } __packed;
  50. struct iwm_udma_out_wifi_hdr {
  51. __le32 cmd;
  52. __le32 meta_data;
  53. } __packed;
  54. /* Sequence numbering */
  55. #define UMAC_WIFI_SEQ_NUM_BASE 1
  56. #define UMAC_WIFI_SEQ_NUM_MAX 0x4000
  57. #define UMAC_NONWIFI_SEQ_NUM_BASE 1
  58. #define UMAC_NONWIFI_SEQ_NUM_MAX 0x10
  59. /* MAC address address */
  60. #define WICO_MAC_ADDRESS_ADDR 0x604008F8
  61. /* RA / TID */
  62. #define UMAC_HDI_ACT_TBL_IDX_TID_POS 0
  63. #define UMAC_HDI_ACT_TBL_IDX_TID_SEED 0xF
  64. #define UMAC_HDI_ACT_TBL_IDX_RA_POS 4
  65. #define UMAC_HDI_ACT_TBL_IDX_RA_SEED 0xF
  66. #define UMAC_HDI_ACT_TBL_IDX_RA_UMAC 0xF
  67. #define UMAC_HDI_ACT_TBL_IDX_TID_UMAC 0x9
  68. #define UMAC_HDI_ACT_TBL_IDX_TID_LMAC 0xA
  69. #define UMAC_HDI_ACT_TBL_IDX_HOST_CMD \
  70. ((UMAC_HDI_ACT_TBL_IDX_RA_UMAC << UMAC_HDI_ACT_TBL_IDX_RA_POS) |\
  71. (UMAC_HDI_ACT_TBL_IDX_TID_UMAC << UMAC_HDI_ACT_TBL_IDX_TID_POS))
  72. #define UMAC_HDI_ACT_TBL_IDX_UMAC_CMD \
  73. ((UMAC_HDI_ACT_TBL_IDX_RA_UMAC << UMAC_HDI_ACT_TBL_IDX_RA_POS) |\
  74. (UMAC_HDI_ACT_TBL_IDX_TID_LMAC << UMAC_HDI_ACT_TBL_IDX_TID_POS))
  75. /* STA ID and color */
  76. #define STA_ID_SEED (0x0f)
  77. #define STA_ID_POS (0)
  78. #define STA_ID_MSK (STA_ID_SEED << STA_ID_POS)
  79. #define STA_COLOR_SEED (0x7)
  80. #define STA_COLOR_POS (4)
  81. #define STA_COLOR_MSK (STA_COLOR_SEED << STA_COLOR_POS)
  82. #define STA_ID_N_COLOR_COLOR(id_n_color) \
  83. (((id_n_color) & STA_COLOR_MSK) >> STA_COLOR_POS)
  84. #define STA_ID_N_COLOR_ID(id_n_color) \
  85. (((id_n_color) & STA_ID_MSK) >> STA_ID_POS)
  86. /* iwm_umac_notif_alive.page_grp_state Group number -- bits [3:0] */
  87. #define UMAC_ALIVE_PAGE_STS_GRP_NUM_POS 0
  88. #define UMAC_ALIVE_PAGE_STS_GRP_NUM_SEED 0xF
  89. /* iwm_umac_notif_alive.page_grp_state Super group number -- bits [7:4] */
  90. #define UMAC_ALIVE_PAGE_STS_SGRP_NUM_POS 4
  91. #define UMAC_ALIVE_PAGE_STS_SGRP_NUM_SEED 0xF
  92. /* iwm_umac_notif_alive.page_grp_state Group min size -- bits [15:8] */
  93. #define UMAC_ALIVE_PAGE_STS_GRP_MIN_SIZE_POS 8
  94. #define UMAC_ALIVE_PAGE_STS_GRP_MIN_SIZE_SEED 0xFF
  95. /* iwm_umac_notif_alive.page_grp_state Group max size -- bits [23:16] */
  96. #define UMAC_ALIVE_PAGE_STS_GRP_MAX_SIZE_POS 16
  97. #define UMAC_ALIVE_PAGE_STS_GRP_MAX_SIZE_SEED 0xFF
  98. /* iwm_umac_notif_alive.page_grp_state Super group max size -- bits [31:24] */
  99. #define UMAC_ALIVE_PAGE_STS_SGRP_MAX_SIZE_POS 24
  100. #define UMAC_ALIVE_PAGE_STS_SGRP_MAX_SIZE_SEED 0xFF
  101. /* Barkers */
  102. #define UMAC_REBOOT_BARKER 0xdeadbeef
  103. #define UMAC_ACK_BARKER 0xfeedbabe
  104. #define UMAC_PAD_TERMINAL 0xadadadad
  105. /* UMAC JMP address */
  106. #define UMAC_MU_FW_INST_DATA_12_ADDR 0xBF0000
  107. /* iwm_umac_hdi_out_hdr.cmd OP code -- bits [3:0] */
  108. #define UMAC_HDI_OUT_CMD_OPCODE_POS 0
  109. #define UMAC_HDI_OUT_CMD_OPCODE_SEED 0xF
  110. /* iwm_umac_hdi_out_hdr.cmd End-Of-Transfer -- bits [10:10] */
  111. #define UMAC_HDI_OUT_CMD_EOT_POS 10
  112. #define UMAC_HDI_OUT_CMD_EOT_SEED 0x1
  113. /* iwm_umac_hdi_out_hdr.cmd UTFD only usage -- bits [11:11] */
  114. #define UMAC_HDI_OUT_CMD_UTFD_ONLY_POS 11
  115. #define UMAC_HDI_OUT_CMD_UTFD_ONLY_SEED 0x1
  116. /* iwm_umac_hdi_out_hdr.cmd Non-WiFi HW sequence number -- bits [12:15] */
  117. #define UDMA_HDI_OUT_CMD_NON_WIFI_HW_SEQ_NUM_POS 12
  118. #define UDMA_HDI_OUT_CMD_NON_WIFI_HW_SEQ_NUM_SEED 0xF
  119. /* iwm_umac_hdi_out_hdr.cmd Signature -- bits [31:16] */
  120. #define UMAC_HDI_OUT_CMD_SIGNATURE_POS 16
  121. #define UMAC_HDI_OUT_CMD_SIGNATURE_SEED 0xFFFF
  122. /* iwm_umac_hdi_out_hdr.meta_data Byte count -- bits [11:0] */
  123. #define UMAC_HDI_OUT_BYTE_COUNT_POS 0
  124. #define UMAC_HDI_OUT_BYTE_COUNT_SEED 0xFFF
  125. /* iwm_umac_hdi_out_hdr.meta_data Credit group -- bits [15:12] */
  126. #define UMAC_HDI_OUT_CREDIT_GRP_POS 12
  127. #define UMAC_HDI_OUT_CREDIT_GRP_SEED 0xF
  128. /* iwm_umac_hdi_out_hdr.meta_data RA/TID -- bits [23:16] */
  129. #define UMAC_HDI_OUT_RATID_POS 16
  130. #define UMAC_HDI_OUT_RATID_SEED 0xFF
  131. /* iwm_umac_hdi_out_hdr.meta_data LMAC offset -- bits [31:24] */
  132. #define UMAC_HDI_OUT_LMAC_OFFSET_POS 24
  133. #define UMAC_HDI_OUT_LMAC_OFFSET_SEED 0xFF
  134. /* Signature */
  135. #define UMAC_HDI_OUT_SIGNATURE 0xCBBC
  136. /* buffer alignment */
  137. #define UMAC_HDI_BUF_ALIGN_MSK 0xF
  138. /* iwm_umac_hdi_in_hdr.cmd OP code -- bits [3:0] */
  139. #define UMAC_HDI_IN_CMD_OPCODE_POS 0
  140. #define UMAC_HDI_IN_CMD_OPCODE_SEED 0xF
  141. /* iwm_umac_hdi_in_hdr.cmd Non-WiFi API response -- bits [6:4] */
  142. #define UMAC_HDI_IN_CMD_NON_WIFI_RESP_POS 4
  143. #define UMAC_HDI_IN_CMD_NON_WIFI_RESP_SEED 0x7
  144. /* iwm_umac_hdi_in_hdr.cmd WiFi API source -- bits [5:4] */
  145. #define UMAC_HDI_IN_CMD_SOURCE_POS 4
  146. #define UMAC_HDI_IN_CMD_SOURCE_SEED 0x3
  147. /* iwm_umac_hdi_in_hdr.cmd WiFi API EOT -- bits [6:6] */
  148. #define UMAC_HDI_IN_CMD_EOT_POS 6
  149. #define UMAC_HDI_IN_CMD_EOT_SEED 0x1
  150. /* iwm_umac_hdi_in_hdr.cmd timestamp present -- bits [7:7] */
  151. #define UMAC_HDI_IN_CMD_TIME_STAMP_PRESENT_POS 7
  152. #define UMAC_HDI_IN_CMD_TIME_STAMP_PRESENT_SEED 0x1
  153. /* iwm_umac_hdi_in_hdr.cmd WiFi Non-last AMSDU -- bits [8:8] */
  154. #define UMAC_HDI_IN_CMD_NON_LAST_AMSDU_POS 8
  155. #define UMAC_HDI_IN_CMD_NON_LAST_AMSDU_SEED 0x1
  156. /* iwm_umac_hdi_in_hdr.cmd WiFi HW sequence number -- bits [31:9] */
  157. #define UMAC_HDI_IN_CMD_HW_SEQ_NUM_POS 9
  158. #define UMAC_HDI_IN_CMD_HW_SEQ_NUM_SEED 0x7FFFFF
  159. /* iwm_umac_hdi_in_hdr.cmd Non-WiFi HW sequence number -- bits [12:15] */
  160. #define UDMA_HDI_IN_CMD_NON_WIFI_HW_SEQ_NUM_POS 12
  161. #define UDMA_HDI_IN_CMD_NON_WIFI_HW_SEQ_NUM_SEED 0xF
  162. /* iwm_umac_hdi_in_hdr.cmd Non-WiFi HW signature -- bits [16:31] */
  163. #define UDMA_HDI_IN_CMD_NON_WIFI_HW_SIG_POS 16
  164. #define UDMA_HDI_IN_CMD_NON_WIFI_HW_SIG_SEED 0xFFFF
  165. /* Fixed Non-WiFi signature */
  166. #define UDMA_HDI_IN_CMD_NON_WIFI_HW_SIG 0xCBBC
  167. /* IN NTFY op-codes */
  168. #define UMAC_NOTIFY_OPCODE_ALIVE 0xA1
  169. #define UMAC_NOTIFY_OPCODE_INIT_COMPLETE 0xA2
  170. #define UMAC_NOTIFY_OPCODE_WIFI_CORE_STATUS 0xA3
  171. #define UMAC_NOTIFY_OPCODE_ERROR 0xA4
  172. #define UMAC_NOTIFY_OPCODE_DEBUG 0xA5
  173. #define UMAC_NOTIFY_OPCODE_WIFI_IF_WRAPPER 0xB0
  174. #define UMAC_NOTIFY_OPCODE_STATS 0xB1
  175. #define UMAC_NOTIFY_OPCODE_PAGE_DEALLOC 0xB3
  176. #define UMAC_NOTIFY_OPCODE_RX_TICKET 0xB4
  177. #define UMAC_NOTIFY_OPCODE_MAX (UMAC_NOTIFY_OPCODE_RX_TICKET -\
  178. UMAC_NOTIFY_OPCODE_ALIVE + 1)
  179. #define UMAC_NOTIFY_OPCODE_FIRST (UMAC_NOTIFY_OPCODE_ALIVE)
  180. /* HDI OUT OP CODE */
  181. #define UMAC_HDI_OUT_OPCODE_PING 0x0
  182. #define UMAC_HDI_OUT_OPCODE_READ 0x1
  183. #define UMAC_HDI_OUT_OPCODE_WRITE 0x2
  184. #define UMAC_HDI_OUT_OPCODE_JUMP 0x3
  185. #define UMAC_HDI_OUT_OPCODE_REBOOT 0x4
  186. #define UMAC_HDI_OUT_OPCODE_WRITE_PERSISTENT 0x5
  187. #define UMAC_HDI_OUT_OPCODE_READ_PERSISTENT 0x6
  188. #define UMAC_HDI_OUT_OPCODE_READ_MODIFY_WRITE 0x7
  189. /* #define UMAC_HDI_OUT_OPCODE_RESERVED 0x8..0xA */
  190. #define UMAC_HDI_OUT_OPCODE_WRITE_AUX_REG 0xB
  191. #define UMAC_HDI_OUT_OPCODE_WIFI 0xF
  192. /* HDI IN OP CODE -- Non WiFi*/
  193. #define UMAC_HDI_IN_OPCODE_PING 0x0
  194. #define UMAC_HDI_IN_OPCODE_READ 0x1
  195. #define UMAC_HDI_IN_OPCODE_WRITE 0x2
  196. #define UMAC_HDI_IN_OPCODE_WRITE_PERSISTENT 0x5
  197. #define UMAC_HDI_IN_OPCODE_READ_PERSISTENT 0x6
  198. #define UMAC_HDI_IN_OPCODE_READ_MODIFY_WRITE 0x7
  199. #define UMAC_HDI_IN_OPCODE_EP_MGMT 0x8
  200. #define UMAC_HDI_IN_OPCODE_CREDIT_CHANGE 0x9
  201. #define UMAC_HDI_IN_OPCODE_CTRL_DATABASE 0xA
  202. #define UMAC_HDI_IN_OPCODE_WRITE_AUX_REG 0xB
  203. #define UMAC_HDI_IN_OPCODE_NONWIFI_MAX \
  204. (UMAC_HDI_IN_OPCODE_WRITE_AUX_REG + 1)
  205. #define UMAC_HDI_IN_OPCODE_WIFI 0xF
  206. /* HDI IN SOURCE */
  207. #define UMAC_HDI_IN_SOURCE_FHRX 0x0
  208. #define UMAC_HDI_IN_SOURCE_UDMA 0x1
  209. #define UMAC_HDI_IN_SOURCE_FW 0x2
  210. #define UMAC_HDI_IN_SOURCE_RESERVED 0x3
  211. /* OUT CMD op-codes */
  212. #define UMAC_CMD_OPCODE_ECHO 0x01
  213. #define UMAC_CMD_OPCODE_HALT 0x02
  214. #define UMAC_CMD_OPCODE_RESET 0x03
  215. #define UMAC_CMD_OPCODE_BULK_EP_INACT_TIMEOUT 0x09
  216. #define UMAC_CMD_OPCODE_URB_CANCEL_ACK 0x0A
  217. #define UMAC_CMD_OPCODE_DCACHE_FLUSH 0x0B
  218. #define UMAC_CMD_OPCODE_EEPROM_PROXY 0x0C
  219. #define UMAC_CMD_OPCODE_TX_ECHO 0x0D
  220. #define UMAC_CMD_OPCODE_DBG_MON 0x0E
  221. #define UMAC_CMD_OPCODE_INTERNAL_TX 0x0F
  222. #define UMAC_CMD_OPCODE_SET_PARAM_FIX 0x10
  223. #define UMAC_CMD_OPCODE_SET_PARAM_VAR 0x11
  224. #define UMAC_CMD_OPCODE_GET_PARAM 0x12
  225. #define UMAC_CMD_OPCODE_DBG_EVENT_WRAPPER 0x13
  226. #define UMAC_CMD_OPCODE_TARGET 0x14
  227. #define UMAC_CMD_OPCODE_STATISTIC_REQUEST 0x15
  228. #define UMAC_CMD_OPCODE_GET_CHAN_INFO_LIST 0x16
  229. #define UMAC_CMD_OPCODE_SET_PARAM_LIST 0x17
  230. #define UMAC_CMD_OPCODE_GET_PARAM_LIST 0x18
  231. #define UMAC_CMD_OPCODE_STOP_RESUME_STA_TX 0x19
  232. #define UMAC_CMD_OPCODE_TEST_BLOCK_ACK 0x1A
  233. #define UMAC_CMD_OPCODE_BASE_WRAPPER 0xFA
  234. #define UMAC_CMD_OPCODE_LMAC_WRAPPER 0xFB
  235. #define UMAC_CMD_OPCODE_HW_TEST_WRAPPER 0xFC
  236. #define UMAC_CMD_OPCODE_WIFI_IF_WRAPPER 0xFD
  237. #define UMAC_CMD_OPCODE_WIFI_WRAPPER 0xFE
  238. #define UMAC_CMD_OPCODE_WIFI_PASS_THROUGH 0xFF
  239. /* UMAC WiFi interface op-codes */
  240. #define UMAC_WIFI_IF_CMD_SET_PROFILE 0x11
  241. #define UMAC_WIFI_IF_CMD_INVALIDATE_PROFILE 0x12
  242. #define UMAC_WIFI_IF_CMD_SET_EXCLUDE_LIST 0x13
  243. #define UMAC_WIFI_IF_CMD_SCAN_REQUEST 0x14
  244. #define UMAC_WIFI_IF_CMD_SCAN_CONFIG 0x15
  245. #define UMAC_WIFI_IF_CMD_ADD_WEP40_KEY 0x16
  246. #define UMAC_WIFI_IF_CMD_ADD_WEP104_KEY 0x17
  247. #define UMAC_WIFI_IF_CMD_ADD_TKIP_KEY 0x18
  248. #define UMAC_WIFI_IF_CMD_ADD_CCMP_KEY 0x19
  249. #define UMAC_WIFI_IF_CMD_REMOVE_KEY 0x1A
  250. #define UMAC_WIFI_IF_CMD_GLOBAL_TX_KEY_ID 0x1B
  251. #define UMAC_WIFI_IF_CMD_SET_HOST_EXTENDED_IE 0x1C
  252. #define UMAC_WIFI_IF_CMD_GET_SUPPORTED_CHANNELS 0x1E
  253. #define UMAC_WIFI_IF_CMD_PMKID_UPDATE 0x1F
  254. #define UMAC_WIFI_IF_CMD_TX_PWR_TRIGGER 0x20
  255. /* UMAC WiFi interface ports */
  256. #define UMAC_WIFI_IF_FLG_PORT_DEF 0x00
  257. #define UMAC_WIFI_IF_FLG_PORT_PAN 0x01
  258. #define UMAC_WIFI_IF_FLG_PORT_PAN_INVALID WIFI_IF_FLG_PORT_DEF
  259. /* UMAC WiFi interface actions */
  260. #define UMAC_WIFI_IF_FLG_ACT_GET 0x10
  261. #define UMAC_WIFI_IF_FLG_ACT_SET 0x20
  262. /* iwm_umac_fw_cmd_hdr.meta_data byte count -- bits [11:0] */
  263. #define UMAC_FW_CMD_BYTE_COUNT_POS 0
  264. #define UMAC_FW_CMD_BYTE_COUNT_SEED 0xFFF
  265. /* iwm_umac_fw_cmd_hdr.meta_data status -- bits [15:12] */
  266. #define UMAC_FW_CMD_STATUS_POS 12
  267. #define UMAC_FW_CMD_STATUS_SEED 0xF
  268. /* iwm_umac_fw_cmd_hdr.meta_data full TX command by Driver -- bits [16:16] */
  269. #define UMAC_FW_CMD_TX_DRV_FULL_CMD_POS 16
  270. #define UMAC_FW_CMD_TX_DRV_FULL_CMD_SEED 0x1
  271. /* iwm_umac_fw_cmd_hdr.meta_data TX command by FW -- bits [17:17] */
  272. #define UMAC_FW_CMD_TX_FW_CMD_POS 17
  273. #define UMAC_FW_CMD_TX_FW_CMD_SEED 0x1
  274. /* iwm_umac_fw_cmd_hdr.meta_data TX plaintext mode -- bits [18:18] */
  275. #define UMAC_FW_CMD_TX_PLAINTEXT_POS 18
  276. #define UMAC_FW_CMD_TX_PLAINTEXT_SEED 0x1
  277. /* iwm_umac_fw_cmd_hdr.meta_data STA color -- bits [22:20] */
  278. #define UMAC_FW_CMD_TX_STA_COLOR_POS 20
  279. #define UMAC_FW_CMD_TX_STA_COLOR_SEED 0x7
  280. /* iwm_umac_fw_cmd_hdr.meta_data TX life time (TU) -- bits [31:24] */
  281. #define UMAC_FW_CMD_TX_LIFETIME_TU_POS 24
  282. #define UMAC_FW_CMD_TX_LIFETIME_TU_SEED 0xFF
  283. /* iwm_dev_cmd_hdr.flags Response required -- bits [5:5] */
  284. #define UMAC_DEV_CMD_FLAGS_RESP_REQ_POS 5
  285. #define UMAC_DEV_CMD_FLAGS_RESP_REQ_SEED 0x1
  286. /* iwm_dev_cmd_hdr.flags Aborted command -- bits [6:6] */
  287. #define UMAC_DEV_CMD_FLAGS_ABORT_POS 6
  288. #define UMAC_DEV_CMD_FLAGS_ABORT_SEED 0x1
  289. /* iwm_dev_cmd_hdr.flags Internal command -- bits [7:7] */
  290. #define DEV_CMD_FLAGS_FLD_INTERNAL_POS 7
  291. #define DEV_CMD_FLAGS_FLD_INTERNAL_SEED 0x1
  292. /* Rx */
  293. /* Rx actions */
  294. #define IWM_RX_TICKET_DROP 0x0
  295. #define IWM_RX_TICKET_RELEASE 0x1
  296. #define IWM_RX_TICKET_SNIFFER 0x2
  297. #define IWM_RX_TICKET_ENQUEUE 0x3
  298. /* Rx flags */
  299. #define IWM_RX_TICKET_PAD_SIZE_MSK 0x2
  300. #define IWM_RX_TICKET_SPECIAL_SNAP_MSK 0x4
  301. #define IWM_RX_TICKET_AMSDU_MSK 0x8
  302. #define IWM_RX_TICKET_DROP_REASON_POS 4
  303. #define IWM_RX_TICKET_DROP_REASON_MSK (0x1F << IWM_RX_TICKET_DROP_REASON_POS)
  304. #define IWM_RX_DROP_NO_DROP 0x0
  305. #define IWM_RX_DROP_BAD_CRC 0x1
  306. /* L2P no address match */
  307. #define IWM_RX_DROP_LMAC_ADDR_FILTER 0x2
  308. /* Multicast address not in list */
  309. #define IWM_RX_DROP_MCAST_ADDR_FILTER 0x3
  310. /* Control frames are not sent to the driver */
  311. #define IWM_RX_DROP_CTL_FRAME 0x4
  312. /* Our frame is back */
  313. #define IWM_RX_DROP_OUR_TX 0x5
  314. /* Association class filtering */
  315. #define IWM_RX_DROP_CLASS_FILTER 0x6
  316. /* Duplicated frame */
  317. #define IWM_RX_DROP_DUPLICATE_FILTER 0x7
  318. /* Decryption error */
  319. #define IWM_RX_DROP_SEC_ERR 0x8
  320. /* Unencrypted frame while encryption is on */
  321. #define IWM_RX_DROP_SEC_NO_ENCRYPTION 0x9
  322. /* Replay check failure */
  323. #define IWM_RX_DROP_SEC_REPLAY_ERR 0xa
  324. /* uCode and FW key color mismatch, check before replay */
  325. #define IWM_RX_DROP_SEC_KEY_COLOR_MISMATCH 0xb
  326. #define IWM_RX_DROP_SEC_TKIP_COUNTER_MEASURE 0xc
  327. /* No fragmentations Db is found */
  328. #define IWM_RX_DROP_FRAG_NO_RESOURCE 0xd
  329. /* Fragmention Db has seqCtl mismatch Vs. non-1st frag */
  330. #define IWM_RX_DROP_FRAG_ERR 0xe
  331. #define IWM_RX_DROP_FRAG_LOST 0xf
  332. #define IWM_RX_DROP_FRAG_COMPLETE 0x10
  333. /* Should be handled by UMAC */
  334. #define IWM_RX_DROP_MANAGEMENT 0x11
  335. /* STA not found by UMAC */
  336. #define IWM_RX_DROP_NO_STATION 0x12
  337. /* NULL or QoS NULL */
  338. #define IWM_RX_DROP_NULL_DATA 0x13
  339. #define IWM_RX_DROP_BA_REORDER_OLD_SEQCTL 0x14
  340. #define IWM_RX_DROP_BA_REORDER_DUPLICATE 0x15
  341. struct iwm_rx_ticket {
  342. __le16 action;
  343. __le16 id;
  344. __le16 flags;
  345. u8 payload_offset; /* includes: MAC header, pad, IV */
  346. u8 tail_len; /* includes: MIC, ICV, CRC (w/o STATUS) */
  347. } __packed;
  348. struct iwm_rx_mpdu_hdr {
  349. __le16 len;
  350. __le16 reserved;
  351. } __packed;
  352. /* UMAC SW WIFI API */
  353. struct iwm_dev_cmd_hdr {
  354. u8 cmd;
  355. u8 flags;
  356. __le16 seq_num;
  357. } __packed;
  358. struct iwm_umac_fw_cmd_hdr {
  359. __le32 meta_data;
  360. struct iwm_dev_cmd_hdr cmd;
  361. } __packed;
  362. struct iwm_umac_wifi_out_hdr {
  363. struct iwm_udma_out_wifi_hdr hw_hdr;
  364. struct iwm_umac_fw_cmd_hdr sw_hdr;
  365. } __packed;
  366. struct iwm_umac_nonwifi_out_hdr {
  367. struct iwm_udma_out_nonwifi_hdr hw_hdr;
  368. } __packed;
  369. struct iwm_umac_wifi_in_hdr {
  370. struct iwm_udma_in_hdr hw_hdr;
  371. struct iwm_umac_fw_cmd_hdr sw_hdr;
  372. } __packed;
  373. struct iwm_umac_nonwifi_in_hdr {
  374. struct iwm_udma_in_hdr hw_hdr;
  375. __le32 time_stamp;
  376. } __packed;
  377. #define IWM_UMAC_PAGE_SIZE 0x200
  378. /* Notify structures */
  379. struct iwm_fw_version {
  380. u8 minor;
  381. u8 major;
  382. __le16 id;
  383. };
  384. struct iwm_fw_build {
  385. u8 type;
  386. u8 subtype;
  387. u8 platform;
  388. u8 opt;
  389. };
  390. struct iwm_fw_alive_hdr {
  391. struct iwm_fw_version ver;
  392. struct iwm_fw_build build;
  393. __le32 os_build;
  394. __le32 log_hdr_addr;
  395. __le32 log_buf_addr;
  396. __le32 sys_timer_addr;
  397. };
  398. #define WAIT_NOTIF_TIMEOUT (2 * HZ)
  399. #define SCAN_COMPLETE_TIMEOUT (3 * HZ)
  400. #define UMAC_NTFY_ALIVE_STATUS_ERR 0xDEAD
  401. #define UMAC_NTFY_ALIVE_STATUS_OK 0xCAFE
  402. #define UMAC_NTFY_INIT_COMPLETE_STATUS_ERR 0xDEAD
  403. #define UMAC_NTFY_INIT_COMPLETE_STATUS_OK 0xCAFE
  404. #define UMAC_NTFY_WIFI_CORE_STATUS_LINK_EN 0x40
  405. #define UMAC_NTFY_WIFI_CORE_STATUS_MLME_EN 0x80
  406. #define IWM_MACS_OUT_GROUPS 6
  407. #define IWM_MACS_OUT_SGROUPS 1
  408. #define WIFI_IF_NTFY_ASSOC_START 0x80
  409. #define WIFI_IF_NTFY_ASSOC_COMPLETE 0x81
  410. #define WIFI_IF_NTFY_PROFILE_INVALIDATE_COMPLETE 0x82
  411. #define WIFI_IF_NTFY_CONNECTION_TERMINATED 0x83
  412. #define WIFI_IF_NTFY_SCAN_COMPLETE 0x84
  413. #define WIFI_IF_NTFY_STA_TABLE_CHANGE 0x85
  414. #define WIFI_IF_NTFY_EXTENDED_IE_REQUIRED 0x86
  415. #define WIFI_IF_NTFY_RADIO_PREEMPTION 0x87
  416. #define WIFI_IF_NTFY_BSS_TRK_TABLE_CHANGED 0x88
  417. #define WIFI_IF_NTFY_BSS_TRK_ENTRIES_REMOVED 0x89
  418. #define WIFI_IF_NTFY_LINK_QUALITY_STATISTICS 0x8A
  419. #define WIFI_IF_NTFY_MGMT_FRAME 0x8B
  420. /* DEBUG INDICATIONS */
  421. #define WIFI_DBG_IF_NTFY_SCAN_SUPER_JOB_START 0xE0
  422. #define WIFI_DBG_IF_NTFY_SCAN_SUPER_JOB_COMPLETE 0xE1
  423. #define WIFI_DBG_IF_NTFY_SCAN_CHANNEL_START 0xE2
  424. #define WIFI_DBG_IF_NTFY_SCAN_CHANNEL_RESULT 0xE3
  425. #define WIFI_DBG_IF_NTFY_SCAN_MINI_JOB_START 0xE4
  426. #define WIFI_DBG_IF_NTFY_SCAN_MINI_JOB_COMPLETE 0xE5
  427. #define WIFI_DBG_IF_NTFY_CNCT_ATC_START 0xE6
  428. #define WIFI_DBG_IF_NTFY_COEX_NOTIFICATION 0xE7
  429. #define WIFI_DBG_IF_NTFY_COEX_HANDLE_ENVELOP 0xE8
  430. #define WIFI_DBG_IF_NTFY_COEX_HANDLE_RELEASE_ENVELOP 0xE9
  431. #define WIFI_IF_NTFY_MAX 0xff
  432. /* Notification structures */
  433. struct iwm_umac_notif_wifi_if {
  434. struct iwm_umac_wifi_in_hdr hdr;
  435. u8 status;
  436. u8 flags;
  437. __le16 buf_size;
  438. } __packed;
  439. #define UMAC_ROAM_REASON_FIRST_SELECTION 0x1
  440. #define UMAC_ROAM_REASON_AP_DEAUTH 0x2
  441. #define UMAC_ROAM_REASON_AP_CONNECT_LOST 0x3
  442. #define UMAC_ROAM_REASON_RSSI 0x4
  443. #define UMAC_ROAM_REASON_AP_ASSISTED_ROAM 0x5
  444. #define UMAC_ROAM_REASON_IBSS_COALESCING 0x6
  445. struct iwm_umac_notif_assoc_start {
  446. struct iwm_umac_notif_wifi_if mlme_hdr;
  447. __le32 roam_reason;
  448. u8 bssid[ETH_ALEN];
  449. u8 reserved[2];
  450. } __packed;
  451. #define UMAC_ASSOC_COMPLETE_SUCCESS 0x0
  452. #define UMAC_ASSOC_COMPLETE_FAILURE 0x1
  453. struct iwm_umac_notif_assoc_complete {
  454. struct iwm_umac_notif_wifi_if mlme_hdr;
  455. __le32 status;
  456. u8 bssid[ETH_ALEN];
  457. u8 band;
  458. u8 channel;
  459. } __packed;
  460. #define UMAC_PROFILE_INVALID_ASSOC_TIMEOUT 0x0
  461. #define UMAC_PROFILE_INVALID_ROAM_TIMEOUT 0x1
  462. #define UMAC_PROFILE_INVALID_REQUEST 0x2
  463. #define UMAC_PROFILE_INVALID_RF_PREEMPTED 0x3
  464. struct iwm_umac_notif_profile_invalidate {
  465. struct iwm_umac_notif_wifi_if mlme_hdr;
  466. __le32 reason;
  467. } __packed;
  468. #define UMAC_SCAN_RESULT_SUCCESS 0x0
  469. #define UMAC_SCAN_RESULT_ABORTED 0x1
  470. #define UMAC_SCAN_RESULT_REJECTED 0x2
  471. #define UMAC_SCAN_RESULT_FAILED 0x3
  472. struct iwm_umac_notif_scan_complete {
  473. struct iwm_umac_notif_wifi_if mlme_hdr;
  474. __le32 type;
  475. __le32 result;
  476. u8 seq_num;
  477. } __packed;
  478. #define UMAC_OPCODE_ADD_MODIFY 0x0
  479. #define UMAC_OPCODE_REMOVE 0x1
  480. #define UMAC_OPCODE_CLEAR_ALL 0x2
  481. #define UMAC_STA_FLAG_QOS 0x1
  482. struct iwm_umac_notif_sta_info {
  483. struct iwm_umac_notif_wifi_if mlme_hdr;
  484. __le32 opcode;
  485. u8 mac_addr[ETH_ALEN];
  486. u8 sta_id; /* bits 0-3: station ID, bits 4-7: station color */
  487. u8 flags;
  488. } __packed;
  489. #define UMAC_BAND_2GHZ 0
  490. #define UMAC_BAND_5GHZ 1
  491. #define UMAC_CHANNEL_WIDTH_20MHZ 0
  492. #define UMAC_CHANNEL_WIDTH_40MHZ 1
  493. struct iwm_umac_notif_bss_info {
  494. struct iwm_umac_notif_wifi_if mlme_hdr;
  495. __le32 type;
  496. __le32 timestamp;
  497. __le16 table_idx;
  498. __le16 frame_len;
  499. u8 band;
  500. u8 channel;
  501. s8 rssi;
  502. u8 reserved;
  503. u8 frame_buf[1];
  504. } __packed;
  505. #define IWM_BSS_REMOVE_INDEX_MSK 0x0fff
  506. #define IWM_BSS_REMOVE_FLAGS_MSK 0xfc00
  507. #define IWM_BSS_REMOVE_FLG_AGE 0x1000
  508. #define IWM_BSS_REMOVE_FLG_TIMEOUT 0x2000
  509. #define IWM_BSS_REMOVE_FLG_TABLE_FULL 0x4000
  510. struct iwm_umac_notif_bss_removed {
  511. struct iwm_umac_notif_wifi_if mlme_hdr;
  512. __le32 count;
  513. __le16 entries[0];
  514. } __packed;
  515. struct iwm_umac_notif_mgt_frame {
  516. struct iwm_umac_notif_wifi_if mlme_hdr;
  517. __le16 len;
  518. u8 frame[1];
  519. } __packed;
  520. struct iwm_umac_notif_alive {
  521. struct iwm_umac_wifi_in_hdr hdr;
  522. __le16 status;
  523. __le16 reserved1;
  524. struct iwm_fw_alive_hdr alive_data;
  525. __le16 reserved2;
  526. __le16 page_grp_count;
  527. __le32 page_grp_state[IWM_MACS_OUT_GROUPS];
  528. } __packed;
  529. struct iwm_umac_notif_init_complete {
  530. struct iwm_umac_wifi_in_hdr hdr;
  531. __le16 status;
  532. __le16 reserved;
  533. } __packed;
  534. /* error categories */
  535. enum {
  536. UMAC_SYS_ERR_CAT_NONE = 0,
  537. UMAC_SYS_ERR_CAT_BOOT,
  538. UMAC_SYS_ERR_CAT_UMAC,
  539. UMAC_SYS_ERR_CAT_UAXM,
  540. UMAC_SYS_ERR_CAT_LMAC,
  541. UMAC_SYS_ERR_CAT_MAX
  542. };
  543. struct iwm_fw_error_hdr {
  544. __le32 category;
  545. __le32 status;
  546. __le32 pc;
  547. __le32 blink1;
  548. __le32 blink2;
  549. __le32 ilink1;
  550. __le32 ilink2;
  551. __le32 data1;
  552. __le32 data2;
  553. __le32 line_num;
  554. __le32 umac_status;
  555. __le32 lmac_status;
  556. __le32 sdio_status;
  557. __le32 dbm_sample_ctrl;
  558. __le32 dbm_buf_base;
  559. __le32 dbm_buf_end;
  560. __le32 dbm_buf_write_ptr;
  561. __le32 dbm_buf_cycle_cnt;
  562. } __packed;
  563. struct iwm_umac_notif_error {
  564. struct iwm_umac_wifi_in_hdr hdr;
  565. struct iwm_fw_error_hdr err;
  566. } __packed;
  567. #define UMAC_DEALLOC_NTFY_CHANGES_CNT_POS 0
  568. #define UMAC_DEALLOC_NTFY_CHANGES_CNT_SEED 0xff
  569. #define UMAC_DEALLOC_NTFY_CHANGES_MSK_POS 8
  570. #define UMAC_DEALLOC_NTFY_CHANGES_MSK_SEED 0xffffff
  571. #define UMAC_DEALLOC_NTFY_PAGE_CNT_POS 0
  572. #define UMAC_DEALLOC_NTFY_PAGE_CNT_SEED 0xffffff
  573. #define UMAC_DEALLOC_NTFY_GROUP_NUM_POS 24
  574. #define UMAC_DEALLOC_NTFY_GROUP_NUM_SEED 0xf
  575. struct iwm_umac_notif_page_dealloc {
  576. struct iwm_umac_wifi_in_hdr hdr;
  577. __le32 changes;
  578. __le32 grp_info[IWM_MACS_OUT_GROUPS];
  579. } __packed;
  580. struct iwm_umac_notif_wifi_status {
  581. struct iwm_umac_wifi_in_hdr hdr;
  582. __le16 status;
  583. __le16 reserved;
  584. } __packed;
  585. struct iwm_umac_notif_rx_ticket {
  586. struct iwm_umac_wifi_in_hdr hdr;
  587. u8 num_tickets;
  588. u8 reserved[3];
  589. struct iwm_rx_ticket tickets[1];
  590. } __packed;
  591. /* Tx/Rx rates window (number of max of last update window per second) */
  592. #define UMAC_NTF_RATE_SAMPLE_NR 4
  593. /* Max numbers of bits required to go through all antennae in bitmasks */
  594. #define UMAC_PHY_NUM_CHAINS 3
  595. #define IWM_UMAC_MGMT_TID 8
  596. #define IWM_UMAC_TID_NR 9 /* 8 TIDs + MGMT */
  597. struct iwm_umac_notif_stats {
  598. struct iwm_umac_wifi_in_hdr hdr;
  599. __le32 flags;
  600. __le32 timestamp;
  601. __le16 tid_load[IWM_UMAC_TID_NR + 1]; /* 1 non-QoS + 1 dword align */
  602. __le16 tx_rate[UMAC_NTF_RATE_SAMPLE_NR];
  603. __le16 rx_rate[UMAC_NTF_RATE_SAMPLE_NR];
  604. __le32 chain_energy[UMAC_PHY_NUM_CHAINS];
  605. s32 rssi_dbm;
  606. s32 noise_dbm;
  607. __le32 supp_rates;
  608. __le32 supp_ht_rates;
  609. __le32 missed_beacons;
  610. __le32 rx_beacons;
  611. __le32 rx_dir_pkts;
  612. __le32 rx_nondir_pkts;
  613. __le32 rx_multicast;
  614. __le32 rx_errors;
  615. __le32 rx_drop_other_bssid;
  616. __le32 rx_drop_decode;
  617. __le32 rx_drop_reassembly;
  618. __le32 rx_drop_bad_len;
  619. __le32 rx_drop_overflow;
  620. __le32 rx_drop_crc;
  621. __le32 rx_drop_missed;
  622. __le32 tx_dir_pkts;
  623. __le32 tx_nondir_pkts;
  624. __le32 tx_failure;
  625. __le32 tx_errors;
  626. __le32 tx_drop_max_retry;
  627. __le32 tx_err_abort;
  628. __le32 tx_err_carrier;
  629. __le32 rx_bytes;
  630. __le32 tx_bytes;
  631. __le32 tx_power;
  632. __le32 tx_max_power;
  633. __le32 roam_threshold;
  634. __le32 ap_assoc_nr;
  635. __le32 scan_full;
  636. __le32 scan_abort;
  637. __le32 ap_nr;
  638. __le32 roam_nr;
  639. __le32 roam_missed_beacons;
  640. __le32 roam_rssi;
  641. __le32 roam_unassoc;
  642. __le32 roam_deauth;
  643. __le32 roam_ap_loadblance;
  644. } __packed;
  645. #define UMAC_STOP_TX_FLAG 0x1
  646. #define UMAC_RESUME_TX_FLAG 0x2
  647. #define LAST_SEQ_NUM_INVALID 0xFFFF
  648. struct iwm_umac_notif_stop_resume_tx {
  649. struct iwm_umac_wifi_in_hdr hdr;
  650. u8 flags; /* UMAC_*_TX_FLAG_* */
  651. u8 sta_id;
  652. __le16 stop_resume_tid_msk; /* tid bitmask */
  653. } __packed;
  654. #define UMAC_MAX_NUM_PMKIDS 4
  655. /* WiFi interface wrapper header */
  656. struct iwm_umac_wifi_if {
  657. u8 oid;
  658. u8 flags;
  659. __le16 buf_size;
  660. } __packed;
  661. #define IWM_SEQ_NUM_HOST_MSK 0x0000
  662. #define IWM_SEQ_NUM_UMAC_MSK 0x4000
  663. #define IWM_SEQ_NUM_LMAC_MSK 0x8000
  664. #define IWM_SEQ_NUM_MSK 0xC000
  665. #endif