1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Definitions for RTL8187 hardware
4 *
5 * Copyright 2007 Michael Wu <flamingice@sourmilk.net>
6 * Copyright 2007 Andrea Merello <andrea.merello@gmail.com>
7 *
8 * Based on the r8187 driver, which is:
9 * Copyright 2005 Andrea Merello <andrea.merello@gmail.com>, et al.
10 */
11
12 #ifndef RTL8187_H
13 #define RTL8187_H
14
15 #include <linux/cache.h>
16
17 #include "rtl818x.h"
18 #include "leds.h"
19
20 #define RTL8187_EEPROM_TXPWR_BASE 0x05
21 #define RTL8187_EEPROM_MAC_ADDR 0x07
22 #define RTL8187_EEPROM_TXPWR_CHAN_1 0x16 /* 3 channels */
23 #define RTL8187_EEPROM_TXPWR_CHAN_6 0x1B /* 2 channels */
24 #define RTL8187_EEPROM_TXPWR_CHAN_4 0x3D /* 2 channels */
25 #define RTL8187_EEPROM_SELECT_GPIO 0x3B
26
27 #define RTL8187_REQT_READ 0xC0
28 #define RTL8187_REQT_WRITE 0x40
29 #define RTL8187_REQ_GET_REG 0x05
30 #define RTL8187_REQ_SET_REG 0x05
31
32 #define RTL8187_MAX_RX 0x9C4
33
34 #define RFKILL_MASK_8187_89_97 0x2
35 #define RFKILL_MASK_8198 0x4
36
37 #define RETRY_COUNT 7
38
39 struct rtl8187_rx_info {
40 struct urb *urb;
41 struct ieee80211_hw *dev;
42 };
43
44 struct rtl8187_rx_hdr {
45 __le32 flags;
46 u8 noise;
47 u8 signal;
48 u8 agc;
49 u8 reserved;
50 __le64 mac_time;
51 } __packed;
52
53 struct rtl8187b_rx_hdr {
54 __le32 flags;
55 __le64 mac_time;
56 u8 sq;
57 u8 rssi;
58 u8 agc;
59 u8 flags2;
60 __le16 snr_long2end;
61 s8 pwdb_g12;
62 u8 fot;
63 } __packed;
64
65 /* {rtl8187,rtl8187b}_tx_info is in skb */
66
67 struct rtl8187_tx_hdr {
68 __le32 flags;
69 __le16 rts_duration;
70 __le16 len;
71 __le32 retry;
72 } __packed;
73
74 struct rtl8187b_tx_hdr {
75 __le32 flags;
76 __le16 rts_duration;
77 __le16 len;
78 __le32 unused_1;
79 __le16 unused_2;
80 __le16 tx_duration;
81 __le32 unused_3;
82 __le32 retry;
83 __le32 unused_4[2];
84 } __packed;
85
86 enum {
87 DEVICE_RTL8187,
88 DEVICE_RTL8187B
89 };
90
91 struct rtl8187_vif {
92 struct ieee80211_hw *dev;
93
94 /* beaconing */
95 struct delayed_work beacon_work;
96 bool enable_beacon;
97 };
98
99 struct rtl8187_priv {
100 /* common between rtl818x drivers */
101 struct rtl818x_csr *map;
102 const struct rtl818x_rf_ops *rf;
103 struct ieee80211_vif *vif;
104
105 /* The mutex protects the TX loopback state.
106 * Any attempt to set channels concurrently locks the device.
107 */
108 struct mutex conf_mutex;
109
110 /* rtl8187 specific */
111 struct ieee80211_channel channels[14];
112 struct ieee80211_rate rates[12];
113 struct ieee80211_supported_band band;
114 struct usb_device *udev;
115 u32 rx_conf;
116 struct usb_anchor anchored;
117 struct delayed_work work;
118 struct ieee80211_hw *dev;
119 #ifdef CONFIG_RTL8187_LEDS
120 struct rtl8187_led led_radio;
121 struct rtl8187_led led_tx;
122 struct rtl8187_led led_rx;
123 struct delayed_work led_on;
124 struct delayed_work led_off;
125 #endif
126 u16 txpwr_base;
127 u8 asic_rev;
128 u8 is_rtl8187b;
129 enum {
130 RTL8187BvB,
131 RTL8187BvD,
132 RTL8187BvE
133 } hw_rev;
134 struct sk_buff_head rx_queue;
135 u8 signal;
136 u8 noise;
137 u8 slot_time;
138 u8 aifsn[4];
139 u8 rfkill_mask;
140 struct {
141 union {
142 __le64 buf;
143 u8 dummy1[L1_CACHE_BYTES];
144 } ____cacheline_aligned;
145 struct sk_buff_head queue;
146 } b_tx_status; /* This queue is used by both -b and non-b devices */
147 struct mutex io_mutex;
148 union {
149 u8 bits8;
150 __le16 bits16;
151 __le32 bits32;
152 u8 dummy2[L1_CACHE_BYTES];
153 } *io_dmabuf ____cacheline_aligned;
154 bool rfkill_off;
155 u16 seqno;
156 };
157
158 void rtl8187_write_phy(struct ieee80211_hw *dev, u8 addr, u32 data);
159
160 u8 rtl818x_ioread8_idx(struct rtl8187_priv *priv,
161 u8 *addr, u8 idx);
162
rtl818x_ioread8(struct rtl8187_priv * priv,u8 * addr)163 static inline u8 rtl818x_ioread8(struct rtl8187_priv *priv, u8 *addr)
164 {
165 return rtl818x_ioread8_idx(priv, addr, 0);
166 }
167
168 u16 rtl818x_ioread16_idx(struct rtl8187_priv *priv,
169 __le16 *addr, u8 idx);
170
rtl818x_ioread16(struct rtl8187_priv * priv,__le16 * addr)171 static inline u16 rtl818x_ioread16(struct rtl8187_priv *priv, __le16 *addr)
172 {
173 return rtl818x_ioread16_idx(priv, addr, 0);
174 }
175
176 u32 rtl818x_ioread32_idx(struct rtl8187_priv *priv,
177 __le32 *addr, u8 idx);
178
rtl818x_ioread32(struct rtl8187_priv * priv,__le32 * addr)179 static inline u32 rtl818x_ioread32(struct rtl8187_priv *priv, __le32 *addr)
180 {
181 return rtl818x_ioread32_idx(priv, addr, 0);
182 }
183
184 void rtl818x_iowrite8_idx(struct rtl8187_priv *priv,
185 u8 *addr, u8 val, u8 idx);
186
rtl818x_iowrite8(struct rtl8187_priv * priv,u8 * addr,u8 val)187 static inline void rtl818x_iowrite8(struct rtl8187_priv *priv, u8 *addr, u8 val)
188 {
189 rtl818x_iowrite8_idx(priv, addr, val, 0);
190 }
191
192 void rtl818x_iowrite16_idx(struct rtl8187_priv *priv,
193 __le16 *addr, u16 val, u8 idx);
194
rtl818x_iowrite16(struct rtl8187_priv * priv,__le16 * addr,u16 val)195 static inline void rtl818x_iowrite16(struct rtl8187_priv *priv, __le16 *addr,
196 u16 val)
197 {
198 rtl818x_iowrite16_idx(priv, addr, val, 0);
199 }
200
201 void rtl818x_iowrite32_idx(struct rtl8187_priv *priv,
202 __le32 *addr, u32 val, u8 idx);
203
rtl818x_iowrite32(struct rtl8187_priv * priv,__le32 * addr,u32 val)204 static inline void rtl818x_iowrite32(struct rtl8187_priv *priv, __le32 *addr,
205 u32 val)
206 {
207 rtl818x_iowrite32_idx(priv, addr, val, 0);
208 }
209
210 #endif /* RTL8187_H */
211