defs.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * This header file contains global constant/enum definitions,
  4. * global variable declaration.
  5. */
  6. #ifndef _LBS_DEFS_H_
  7. #define _LBS_DEFS_H_
  8. #include <linux/spinlock.h>
  9. #ifdef CONFIG_LIBERTAS_DEBUG
  10. #define DEBUG
  11. #define PROC_DEBUG
  12. #endif
  13. #ifndef DRV_NAME
  14. #define DRV_NAME "libertas"
  15. #endif
  16. #define LBS_DEB_ENTER 0x00000001
  17. #define LBS_DEB_LEAVE 0x00000002
  18. #define LBS_DEB_MAIN 0x00000004
  19. #define LBS_DEB_NET 0x00000008
  20. #define LBS_DEB_MESH 0x00000010
  21. #define LBS_DEB_WEXT 0x00000020
  22. #define LBS_DEB_IOCTL 0x00000040
  23. #define LBS_DEB_SCAN 0x00000080
  24. #define LBS_DEB_ASSOC 0x00000100
  25. #define LBS_DEB_JOIN 0x00000200
  26. #define LBS_DEB_11D 0x00000400
  27. #define LBS_DEB_DEBUGFS 0x00000800
  28. #define LBS_DEB_ETHTOOL 0x00001000
  29. #define LBS_DEB_HOST 0x00002000
  30. #define LBS_DEB_CMD 0x00004000
  31. #define LBS_DEB_RX 0x00008000
  32. #define LBS_DEB_TX 0x00010000
  33. #define LBS_DEB_USB 0x00020000
  34. #define LBS_DEB_CS 0x00040000
  35. #define LBS_DEB_FW 0x00080000
  36. #define LBS_DEB_THREAD 0x00100000
  37. #define LBS_DEB_HEX 0x00200000
  38. #define LBS_DEB_SDIO 0x00400000
  39. #define LBS_DEB_SYSFS 0x00800000
  40. #define LBS_DEB_SPI 0x01000000
  41. #define LBS_DEB_CFG80211 0x02000000
  42. extern unsigned int lbs_debug;
  43. #ifdef DEBUG
  44. #define LBS_DEB_LL(grp, grpnam, fmt, args...) \
  45. do { if ((lbs_debug & (grp)) == (grp)) \
  46. printk(KERN_DEBUG DRV_NAME grpnam ": " fmt, ## args); } while (0)
  47. #else
  48. #define LBS_DEB_LL(grp, grpnam, fmt, args...) do {} while (0)
  49. #endif
  50. #define lbs_deb_main(fmt, args...) LBS_DEB_LL(LBS_DEB_MAIN, " main", fmt, ##args)
  51. #define lbs_deb_net(fmt, args...) LBS_DEB_LL(LBS_DEB_NET, " net", fmt, ##args)
  52. #define lbs_deb_mesh(fmt, args...) LBS_DEB_LL(LBS_DEB_MESH, " mesh", fmt, ##args)
  53. #define lbs_deb_wext(fmt, args...) LBS_DEB_LL(LBS_DEB_WEXT, " wext", fmt, ##args)
  54. #define lbs_deb_ioctl(fmt, args...) LBS_DEB_LL(LBS_DEB_IOCTL, " ioctl", fmt, ##args)
  55. #define lbs_deb_scan(fmt, args...) LBS_DEB_LL(LBS_DEB_SCAN, " scan", fmt, ##args)
  56. #define lbs_deb_assoc(fmt, args...) LBS_DEB_LL(LBS_DEB_ASSOC, " assoc", fmt, ##args)
  57. #define lbs_deb_join(fmt, args...) LBS_DEB_LL(LBS_DEB_JOIN, " join", fmt, ##args)
  58. #define lbs_deb_11d(fmt, args...) LBS_DEB_LL(LBS_DEB_11D, " 11d", fmt, ##args)
  59. #define lbs_deb_debugfs(fmt, args...) LBS_DEB_LL(LBS_DEB_DEBUGFS, " debugfs", fmt, ##args)
  60. #define lbs_deb_ethtool(fmt, args...) LBS_DEB_LL(LBS_DEB_ETHTOOL, " ethtool", fmt, ##args)
  61. #define lbs_deb_host(fmt, args...) LBS_DEB_LL(LBS_DEB_HOST, " host", fmt, ##args)
  62. #define lbs_deb_cmd(fmt, args...) LBS_DEB_LL(LBS_DEB_CMD, " cmd", fmt, ##args)
  63. #define lbs_deb_rx(fmt, args...) LBS_DEB_LL(LBS_DEB_RX, " rx", fmt, ##args)
  64. #define lbs_deb_tx(fmt, args...) LBS_DEB_LL(LBS_DEB_TX, " tx", fmt, ##args)
  65. #define lbs_deb_fw(fmt, args...) LBS_DEB_LL(LBS_DEB_FW, " fw", fmt, ##args)
  66. #define lbs_deb_usb(fmt, args...) LBS_DEB_LL(LBS_DEB_USB, " usb", fmt, ##args)
  67. #define lbs_deb_usbd(dev, fmt, args...) LBS_DEB_LL(LBS_DEB_USB, " usbd", "%s:" fmt, dev_name(dev), ##args)
  68. #define lbs_deb_cs(fmt, args...) LBS_DEB_LL(LBS_DEB_CS, " cs", fmt, ##args)
  69. #define lbs_deb_thread(fmt, args...) LBS_DEB_LL(LBS_DEB_THREAD, " thread", fmt, ##args)
  70. #define lbs_deb_sdio(fmt, args...) LBS_DEB_LL(LBS_DEB_SDIO, " sdio", fmt, ##args)
  71. #define lbs_deb_sysfs(fmt, args...) LBS_DEB_LL(LBS_DEB_SYSFS, " sysfs", fmt, ##args)
  72. #define lbs_deb_spi(fmt, args...) LBS_DEB_LL(LBS_DEB_SPI, " spi", fmt, ##args)
  73. #define lbs_deb_cfg80211(fmt, args...) LBS_DEB_LL(LBS_DEB_CFG80211, " cfg80211", fmt, ##args)
  74. #ifdef DEBUG
  75. static inline void lbs_deb_hex(unsigned int grp, const char *prompt,
  76. const u8 *buf, int len)
  77. {
  78. int i = 0;
  79. if (len &&
  80. (lbs_debug & LBS_DEB_HEX) &&
  81. (lbs_debug & grp))
  82. {
  83. for (i = 1; i <= len; i++) {
  84. if ((i & 0xf) == 1) {
  85. if (i != 1)
  86. printk("\n");
  87. printk(DRV_NAME " %s: ", prompt);
  88. }
  89. printk("%02x ", (u8) * buf);
  90. buf++;
  91. }
  92. printk("\n");
  93. }
  94. }
  95. #else
  96. #define lbs_deb_hex(grp,prompt,buf,len) do {} while (0)
  97. #endif
  98. /* Buffer Constants */
  99. /* The size of SQ memory PPA, DPA are 8 DWORDs, that keep the physical
  100. * addresses of TxPD buffers. Station has only 8 TxPD available, Whereas
  101. * driver has more local TxPDs. Each TxPD on the host memory is associated
  102. * with a Tx control node. The driver maintains 8 RxPD descriptors for
  103. * station firmware to store Rx packet information.
  104. *
  105. * Current version of MAC has a 32x6 multicast address buffer.
  106. *
  107. * 802.11b can have up to 14 channels, the driver keeps the
  108. * BSSID(MAC address) of each APs or Ad hoc stations it has sensed.
  109. */
  110. #define MRVDRV_MAX_MULTICAST_LIST_SIZE 32
  111. #define LBS_NUM_CMD_BUFFERS 10
  112. #define LBS_CMD_BUFFER_SIZE (2 * 1024)
  113. #define MRVDRV_MAX_CHANNEL_SIZE 14
  114. #define MRVDRV_ASSOCIATION_TIME_OUT 255
  115. #define MRVDRV_SNAP_HEADER_LEN 8
  116. #define LBS_UPLD_SIZE 2312
  117. #define DEV_NAME_LEN 32
  118. /* Wake criteria for HOST_SLEEP_CFG command */
  119. #define EHS_WAKE_ON_BROADCAST_DATA 0x0001
  120. #define EHS_WAKE_ON_UNICAST_DATA 0x0002
  121. #define EHS_WAKE_ON_MAC_EVENT 0x0004
  122. #define EHS_WAKE_ON_MULTICAST_DATA 0x0008
  123. #define EHS_REMOVE_WAKEUP 0xFFFFFFFF
  124. /* Wake rules for Host_Sleep_CFG command */
  125. #define WOL_RULE_NET_TYPE_INFRA_OR_IBSS 0x00
  126. #define WOL_RULE_NET_TYPE_MESH 0x10
  127. #define WOL_RULE_ADDR_TYPE_BCAST 0x01
  128. #define WOL_RULE_ADDR_TYPE_MCAST 0x08
  129. #define WOL_RULE_ADDR_TYPE_UCAST 0x02
  130. #define WOL_RULE_OP_AND 0x01
  131. #define WOL_RULE_OP_OR 0x02
  132. #define WOL_RULE_OP_INVALID 0xFF
  133. #define WOL_RESULT_VALID_CMD 0
  134. #define WOL_RESULT_NOSPC_ERR 1
  135. #define WOL_RESULT_EEXIST_ERR 2
  136. /* Misc constants */
  137. /* This section defines 802.11 specific contants */
  138. #define MRVDRV_MAX_BSS_DESCRIPTS 16
  139. #define MRVDRV_MAX_REGION_CODE 6
  140. #define MRVDRV_DEFAULT_LISTEN_INTERVAL 10
  141. #define MRVDRV_CHANNELS_PER_SCAN 4
  142. #define MRVDRV_MAX_CHANNELS_PER_SCAN 14
  143. #define MRVDRV_MIN_BEACON_INTERVAL 20
  144. #define MRVDRV_MAX_BEACON_INTERVAL 1000
  145. #define MRVDRV_BEACON_INTERVAL 100
  146. #define MARVELL_MESH_IE_LENGTH 9
  147. /*
  148. * Values used to populate the struct mrvl_mesh_ie. The only time you need this
  149. * is when enabling the mesh using CMD_MESH_CONFIG.
  150. */
  151. #define MARVELL_MESH_IE_TYPE 4
  152. #define MARVELL_MESH_IE_SUBTYPE 0
  153. #define MARVELL_MESH_IE_VERSION 0
  154. #define MARVELL_MESH_PROTO_ID_HWMP 0
  155. #define MARVELL_MESH_METRIC_ID 0
  156. #define MARVELL_MESH_CAPABILITY 0
  157. /* INT status Bit Definition */
  158. #define MRVDRV_TX_DNLD_RDY 0x0001
  159. #define MRVDRV_RX_UPLD_RDY 0x0002
  160. #define MRVDRV_CMD_DNLD_RDY 0x0004
  161. #define MRVDRV_CMD_UPLD_RDY 0x0008
  162. #define MRVDRV_CARDEVENT 0x0010
  163. /* Automatic TX control default levels */
  164. #define POW_ADAPT_DEFAULT_P0 13
  165. #define POW_ADAPT_DEFAULT_P1 15
  166. #define POW_ADAPT_DEFAULT_P2 18
  167. #define TPC_DEFAULT_P0 5
  168. #define TPC_DEFAULT_P1 10
  169. #define TPC_DEFAULT_P2 13
  170. /* TxPD status */
  171. /*
  172. * Station firmware use TxPD status field to report final Tx transmit
  173. * result, Bit masks are used to present combined situations.
  174. */
  175. #define MRVDRV_TxPD_POWER_MGMT_NULL_PACKET 0x01
  176. #define MRVDRV_TxPD_POWER_MGMT_LAST_PACKET 0x08
  177. /* Tx mesh flag */
  178. /*
  179. * Currently we are using normal WDS flag as mesh flag.
  180. * TODO: change to proper mesh flag when MAC understands it.
  181. */
  182. #define TxPD_CONTROL_WDS_FRAME (1<<17)
  183. #define TxPD_MESH_FRAME TxPD_CONTROL_WDS_FRAME
  184. /* Mesh interface ID */
  185. #define MESH_IFACE_ID 0x0001
  186. /* Mesh id should be in bits 14-13-12 */
  187. #define MESH_IFACE_BIT_OFFSET 0x000c
  188. /* Mesh enable bit in FW capability */
  189. #define MESH_CAPINFO_ENABLE_MASK (1<<16)
  190. /* FW definition from Marvell v4 */
  191. #define MRVL_FW_V4 (0x04)
  192. /* FW definition from Marvell v5 */
  193. #define MRVL_FW_V5 (0x05)
  194. /* FW definition from Marvell v10 */
  195. #define MRVL_FW_V10 (0x0a)
  196. /* FW major revision definition */
  197. #define MRVL_FW_MAJOR_REV(x) ((x)>>24)
  198. /* RxPD status */
  199. #define MRVDRV_RXPD_STATUS_OK 0x0001
  200. /* RxPD status - Received packet types */
  201. /* Rx mesh flag */
  202. /*
  203. * Currently we are using normal WDS flag as mesh flag.
  204. * TODO: change to proper mesh flag when MAC understands it.
  205. */
  206. #define RxPD_CONTROL_WDS_FRAME (0x40)
  207. #define RxPD_MESH_FRAME RxPD_CONTROL_WDS_FRAME
  208. /* RSSI-related defines */
  209. /*
  210. * RSSI constants are used to implement 802.11 RSSI threshold
  211. * indication. if the Rx packet signal got too weak for 5 consecutive
  212. * times, miniport driver (driver) will report this event to wrapper
  213. */
  214. #define MRVDRV_NF_DEFAULT_SCAN_VALUE (-96)
  215. /* RTS/FRAG related defines */
  216. #define MRVDRV_RTS_MIN_VALUE 0
  217. #define MRVDRV_RTS_MAX_VALUE 2347
  218. #define MRVDRV_FRAG_MIN_VALUE 256
  219. #define MRVDRV_FRAG_MAX_VALUE 2346
  220. /* This is for firmware specific length */
  221. #define EXTRA_LEN 36
  222. #define MRVDRV_ETH_TX_PACKET_BUFFER_SIZE \
  223. (ETH_FRAME_LEN + sizeof(struct txpd) + EXTRA_LEN)
  224. #define MRVDRV_ETH_RX_PACKET_BUFFER_SIZE \
  225. (ETH_FRAME_LEN + sizeof(struct rxpd) \
  226. + MRVDRV_SNAP_HEADER_LEN + EXTRA_LEN)
  227. #define CMD_F_HOSTCMD (1 << 0)
  228. #define FW_CAPINFO_WPA (1 << 0)
  229. #define FW_CAPINFO_PS (1 << 1)
  230. #define FW_CAPINFO_FIRMWARE_UPGRADE (1 << 13)
  231. #define FW_CAPINFO_BOOT2_UPGRADE (1<<14)
  232. #define FW_CAPINFO_PERSISTENT_CONFIG (1<<15)
  233. #define KEY_LEN_WPA_AES 16
  234. #define KEY_LEN_WPA_TKIP 32
  235. #define KEY_LEN_WEP_104 13
  236. #define KEY_LEN_WEP_40 5
  237. #define RF_ANTENNA_1 0x1
  238. #define RF_ANTENNA_2 0x2
  239. #define RF_ANTENNA_AUTO 0xFFFF
  240. #define BAND_B (0x01)
  241. #define BAND_G (0x02)
  242. #define ALL_802_11_BANDS (BAND_B | BAND_G)
  243. #define MAX_RATES 14
  244. #define MAX_LEDS 8
  245. /* Global Variable Declaration */
  246. extern const char lbs_driver_version[];
  247. extern u16 lbs_region_code_to_index[MRVDRV_MAX_REGION_CODE];
  248. /* ENUM definition */
  249. /* SNRNF_TYPE */
  250. enum SNRNF_TYPE {
  251. TYPE_BEACON = 0,
  252. TYPE_RXPD,
  253. MAX_TYPE_B
  254. };
  255. /* SNRNF_DATA */
  256. enum SNRNF_DATA {
  257. TYPE_NOAVG = 0,
  258. TYPE_AVG,
  259. MAX_TYPE_AVG
  260. };
  261. /* LBS_802_11_POWER_MODE */
  262. enum LBS_802_11_POWER_MODE {
  263. LBS802_11POWERMODECAM,
  264. LBS802_11POWERMODEMAX_PSP,
  265. LBS802_11POWERMODEFAST_PSP,
  266. /* not a real mode, defined as an upper bound */
  267. LBS802_11POWEMODEMAX
  268. };
  269. /* PS_STATE */
  270. enum PS_STATE {
  271. PS_STATE_FULL_POWER,
  272. PS_STATE_AWAKE,
  273. PS_STATE_PRE_SLEEP,
  274. PS_STATE_SLEEP
  275. };
  276. /* DNLD_STATE */
  277. enum DNLD_STATE {
  278. DNLD_RES_RECEIVED,
  279. DNLD_DATA_SENT,
  280. DNLD_CMD_SENT,
  281. DNLD_BOOTCMD_SENT,
  282. };
  283. /* LBS_MEDIA_STATE */
  284. enum LBS_MEDIA_STATE {
  285. LBS_CONNECTED,
  286. LBS_DISCONNECTED
  287. };
  288. /* LBS_802_11_PRIVACY_FILTER */
  289. enum LBS_802_11_PRIVACY_FILTER {
  290. LBS802_11PRIVFILTERACCEPTALL,
  291. LBS802_11PRIVFILTER8021XWEP
  292. };
  293. /* mv_ms_type */
  294. enum mv_ms_type {
  295. MVMS_DAT = 0,
  296. MVMS_CMD = 1,
  297. MVMS_TXDONE = 2,
  298. MVMS_EVENT
  299. };
  300. /* KEY_TYPE_ID */
  301. enum KEY_TYPE_ID {
  302. KEY_TYPE_ID_WEP = 0,
  303. KEY_TYPE_ID_TKIP,
  304. KEY_TYPE_ID_AES
  305. };
  306. /* KEY_INFO_WPA (applies to both TKIP and AES/CCMP) */
  307. enum KEY_INFO_WPA {
  308. KEY_INFO_WPA_MCAST = 0x01,
  309. KEY_INFO_WPA_UNICAST = 0x02,
  310. KEY_INFO_WPA_ENABLED = 0x04
  311. };
  312. /* Default values for fwt commands. */
  313. #define FWT_DEFAULT_METRIC 0
  314. #define FWT_DEFAULT_DIR 1
  315. /* Default Rate, 11Mbps */
  316. #define FWT_DEFAULT_RATE 3
  317. #define FWT_DEFAULT_SSN 0xffffffff
  318. #define FWT_DEFAULT_DSN 0
  319. #define FWT_DEFAULT_HOPCOUNT 0
  320. #define FWT_DEFAULT_TTL 0
  321. #define FWT_DEFAULT_EXPIRATION 0
  322. #define FWT_DEFAULT_SLEEPMODE 0
  323. #define FWT_DEFAULT_SNR 0
  324. #endif