1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Shared defines for all mac80211 Prism54 code
4 *
5 * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>
6 *
7 * Based on the islsm (softmac prism54) driver, which is:
8 * Copyright 2004-2006 Jean-Baptiste Note <jbnote@gmail.com>, et al.
9 */
10
11#ifndef P54_H
12#define P54_H
13
14#ifdef CONFIG_P54_LEDS
15#include <linux/leds.h>
16#endif /* CONFIG_P54_LEDS */
17
18#define ISL38XX_DEV_FIRMWARE_ADDR 0x20000
19
20#define BR_CODE_MIN 0x80000000
21#define BR_CODE_COMPONENT_ID 0x80000001
22#define BR_CODE_COMPONENT_VERSION 0x80000002
23#define BR_CODE_DEPENDENT_IF 0x80000003
24#define BR_CODE_EXPOSED_IF 0x80000004
25#define BR_CODE_DESCR 0x80000101
26#define BR_CODE_MAX 0x8FFFFFFF
27#define BR_CODE_END_OF_BRA 0xFF0000FF
28#define LEGACY_BR_CODE_END_OF_BRA 0xFFFFFFFF
29
30struct bootrec {
31 __le32 code;
32 __le32 len;
33 u32 data[10];
34} __packed;
35
36/* Interface role definitions */
37#define BR_INTERFACE_ROLE_SERVER 0x0000
38#define BR_INTERFACE_ROLE_CLIENT 0x8000
39
40#define BR_DESC_PRIV_CAP_WEP BIT(0)
41#define BR_DESC_PRIV_CAP_TKIP BIT(1)
42#define BR_DESC_PRIV_CAP_MICHAEL BIT(2)
43#define BR_DESC_PRIV_CAP_CCX_CP BIT(3)
44#define BR_DESC_PRIV_CAP_CCX_MIC BIT(4)
45#define BR_DESC_PRIV_CAP_AESCCMP BIT(5)
46
47struct bootrec_desc {
48 __le16 modes;
49 __le16 flags;
50 __le32 rx_start;
51 __le32 rx_end;
52 u8 headroom;
53 u8 tailroom;
54 u8 tx_queues;
55 u8 tx_depth;
56 u8 privacy_caps;
57 u8 rx_keycache_size;
58 u8 time_size;
59 u8 padding;
60 u8 rates[16];
61 u8 padding2[4];
62 __le16 rx_mtu;
63} __packed;
64
65#define FW_FMAC 0x464d4143
66#define FW_LM86 0x4c4d3836
67#define FW_LM87 0x4c4d3837
68#define FW_LM20 0x4c4d3230
69
70struct bootrec_comp_id {
71 __le32 fw_variant;
72} __packed;
73
74struct bootrec_comp_ver {
75 char fw_version[24];
76} __packed;
77
78struct bootrec_end {
79 __le16 crc;
80 u8 padding[2];
81 u8 md5[16];
82} __packed;
83
84/* provide 16 bytes for the transport back-end */
85#define P54_TX_INFO_DATA_SIZE 16
86
87/* stored in ieee80211_tx_info's rate_driver_data */
88struct p54_tx_info {
89 u32 start_addr;
90 u32 end_addr;
91 union {
92 void *data[P54_TX_INFO_DATA_SIZE / sizeof(void *)];
93 struct {
94 u32 extra_len;
95 };
96 };
97};
98
99#define P54_MAX_CTRL_FRAME_LEN 0x1000
100
101#define P54_SET_QUEUE(queue, ai_fs, cw_min, cw_max, _txop) \
102do { \
103 queue.aifs = cpu_to_le16(ai_fs); \
104 queue.cwmin = cpu_to_le16(cw_min); \
105 queue.cwmax = cpu_to_le16(cw_max); \
106 queue.txop = cpu_to_le16(_txop); \
107} while (0)
108
109struct p54_edcf_queue_param {
110 __le16 aifs;
111 __le16 cwmin;
112 __le16 cwmax;
113 __le16 txop;
114} __packed;
115
116struct p54_rssi_db_entry {
117 u16 freq;
118 s16 mul;
119 s16 add;
120 s16 longbow_unkn;
121 s16 longbow_unk2;
122};
123
124struct p54_cal_database {
125 size_t entries;
126 size_t entry_size;
127 size_t offset;
128 size_t len;
129 u8 data[] __counted_by(len);
130};
131
132#define EEPROM_READBACK_LEN 0x3fc
133
134enum fw_state {
135 FW_STATE_OFF,
136 FW_STATE_BOOTING,
137 FW_STATE_READY,
138 FW_STATE_RESET,
139 FW_STATE_RESETTING,
140};
141
142#ifdef CONFIG_P54_LEDS
143
144#define P54_LED_MAX_NAME_LEN 31
145
146struct p54_led_dev {
147 struct ieee80211_hw *hw_dev;
148 struct led_classdev led_dev;
149 char name[P54_LED_MAX_NAME_LEN + 1];
150
151 unsigned int toggled;
152 unsigned int index;
153 unsigned int registered;
154};
155
156#endif /* CONFIG_P54_LEDS */
157
158struct p54_tx_queue_stats {
159 unsigned int len;
160 unsigned int limit;
161 unsigned int count;
162};
163
164struct p54_common {
165 struct ieee80211_hw *hw;
166 struct ieee80211_vif *vif;
167 void (*tx)(struct ieee80211_hw *dev, struct sk_buff *skb);
168 int (*open)(struct ieee80211_hw *dev);
169 void (*stop)(struct ieee80211_hw *dev);
170 struct sk_buff_head tx_pending;
171 struct sk_buff_head tx_queue;
172 struct mutex conf_mutex;
173 bool registered;
174
175 /* memory management (as seen by the firmware) */
176 u32 rx_start;
177 u32 rx_end;
178 u16 rx_mtu;
179 u8 headroom;
180 u8 tailroom;
181
182 /* firmware/hardware info */
183 unsigned int tx_hdr_len;
184 unsigned int fw_var;
185 unsigned int fw_interface;
186 u8 version;
187
188 /* (e)DCF / QOS state */
189 bool use_short_slot;
190 spinlock_t tx_stats_lock;
191 struct p54_tx_queue_stats tx_stats[8];
192 struct p54_edcf_queue_param qos_params[8];
193
194 /* Radio data */
195 u16 rxhw;
196 u8 rx_diversity_mask;
197 u8 tx_diversity_mask;
198 unsigned int output_power;
199 struct p54_rssi_db_entry *cur_rssi;
200 struct ieee80211_channel *curchan;
201 struct survey_info *survey;
202 unsigned int chan_num;
203 struct completion stat_comp;
204 bool update_stats;
205 struct {
206 unsigned int timestamp;
207 unsigned int cached_cca;
208 unsigned int cached_tx;
209 unsigned int cached_rssi;
210 u64 active;
211 u64 cca;
212 u64 tx;
213 u64 rssi;
214 } survey_raw;
215
216 int noise;
217 /* calibration, output power limit and rssi<->dBm conversation data */
218 struct pda_iq_autocal_entry *iq_autocal;
219 unsigned int iq_autocal_len;
220 struct p54_cal_database *curve_data;
221 struct p54_cal_database *output_limit;
222 struct p54_cal_database *rssi_db;
223 struct ieee80211_supported_band *band_table[NUM_NL80211_BANDS];
224
225 /* BBP/MAC state */
226 u8 mac_addr[ETH_ALEN];
227 u8 bssid[ETH_ALEN];
228 u8 mc_maclist[4][ETH_ALEN];
229 u16 wakeup_timer;
230 unsigned int filter_flags;
231 int mc_maclist_num;
232 int mode;
233 u32 tsf_low32, tsf_high32;
234 u32 basic_rate_mask;
235 u16 aid;
236 u8 coverage_class;
237 bool phy_idle;
238 bool phy_ps;
239 bool powersave_override;
240 __le32 beacon_req_id;
241 struct completion beacon_comp;
242
243 /* cryptographic engine information */
244 u8 privacy_caps;
245 u8 rx_keycache_size;
246 unsigned long *used_rxkeys;
247
248 /* LED management */
249#ifdef CONFIG_P54_LEDS
250 struct p54_led_dev leds[4];
251 struct delayed_work led_work;
252#endif /* CONFIG_P54_LEDS */
253 u16 softled_state; /* bit field of glowing LEDs */
254
255 /* statistics */
256 struct ieee80211_low_level_stats stats;
257 struct delayed_work work;
258
259 /* eeprom handling */
260 void *eeprom;
261 struct completion eeprom_comp;
262 struct mutex eeprom_mutex;
263};
264
265/* interfaces for the drivers */
266int p54_rx(struct ieee80211_hw *dev, struct sk_buff *skb);
267void p54_free_skb(struct ieee80211_hw *dev, struct sk_buff *skb);
268int p54_parse_firmware(struct ieee80211_hw *dev, const struct firmware *fw);
269int p54_parse_eeprom(struct ieee80211_hw *dev, void *eeprom, int len);
270int p54_read_eeprom(struct ieee80211_hw *dev);
271
272struct ieee80211_hw *p54_init_common(size_t priv_data_len);
273int p54_register_common(struct ieee80211_hw *dev, struct device *pdev);
274void p54_free_common(struct ieee80211_hw *dev);
275
276void p54_unregister_common(struct ieee80211_hw *dev);
277
278#endif /* P54_H */
279

source code of linux/drivers/net/wireless/intersil/p54/p54.h