2 * Firmware I/O code for mac80211 Prism54 drivers
4 * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>
5 * Copyright (c) 2007-2009, Christian Lamparter <chunkeey@web.de>
6 * Copyright 2008, Johannes Berg <johannes@sipsolutions.net>
9 * - the islsm (softmac prism54) driver, which is:
10 * Copyright 2004-2006 Jean-Baptiste Note <jbnote@gmail.com>, et al.
12 * Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
14 * This program is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License version 2 as
16 * published by the Free Software Foundation.
19 #include <linux/init.h>
20 #include <linux/slab.h>
21 #include <linux/firmware.h>
22 #include <linux/etherdevice.h>
24 #include <net/mac80211.h>
30 int p54_parse_firmware(struct ieee80211_hw *dev, const struct firmware *fw)
32 struct p54_common *priv = dev->priv;
33 struct exp_if *exp_if;
34 struct bootrec *bootrec;
35 u32 *data = (u32 *)fw->data;
36 u32 *end_data = (u32 *)fw->data + (fw->size >> 2);
37 u8 *fw_version = NULL;
45 while (data < end_data && *data)
48 while (data < end_data && !*data)
51 bootrec = (struct bootrec *) data;
53 while (bootrec->data <= end_data && (bootrec->data +
54 (len = le32_to_cpu(bootrec->len))) <= end_data) {
55 u32 code = le32_to_cpu(bootrec->code);
57 case BR_CODE_COMPONENT_ID:
58 priv->fw_interface = be32_to_cpup((__be32 *)
60 switch (priv->fw_interface) {
64 char *iftype = (char *)bootrec->data;
65 wiphy_info(priv->hw->wiphy,
66 "p54 detected a LM%c%c firmware\n",
67 iftype[2], iftype[3]);
72 wiphy_err(priv->hw->wiphy,
73 "unsupported firmware\n");
77 case BR_CODE_COMPONENT_VERSION:
78 /* 24 bytes should be enough for all firmwares */
79 if (strnlen((unsigned char *) bootrec->data, 24) < 24)
80 fw_version = (unsigned char *) bootrec->data;
83 struct bootrec_desc *desc =
84 (struct bootrec_desc *)bootrec->data;
85 priv->rx_start = le32_to_cpu(desc->rx_start);
86 /* FIXME add sanity checking */
87 priv->rx_end = le32_to_cpu(desc->rx_end) - 0x3500;
88 priv->headroom = desc->headroom;
89 priv->tailroom = desc->tailroom;
90 priv->privacy_caps = desc->privacy_caps;
91 priv->rx_keycache_size = desc->rx_keycache_size;
92 if (le32_to_cpu(bootrec->len) == 11)
93 priv->rx_mtu = le16_to_cpu(desc->rx_mtu);
95 priv->rx_mtu = (size_t)
96 0x620 - priv->tx_hdr_len;
97 maxlen = priv->tx_hdr_len + /* USB devices */
98 sizeof(struct p54_rx_data) +
99 4 + /* rx alignment */
100 IEEE80211_MAX_FRAG_THRESHOLD;
101 if (priv->rx_mtu > maxlen && PAGE_SIZE == 4096) {
102 printk(KERN_INFO "p54: rx_mtu reduced from %d "
103 "to %d\n", priv->rx_mtu, maxlen);
104 priv->rx_mtu = maxlen;
108 case BR_CODE_EXPOSED_IF:
109 exp_if = (struct exp_if *) bootrec->data;
110 for (i = 0; i < (len * sizeof(*exp_if) / 4); i++)
111 if (exp_if[i].if_id == cpu_to_le16(IF_ID_LMAC))
112 priv->fw_var = le16_to_cpu(exp_if[i].variant);
114 case BR_CODE_DEPENDENT_IF:
116 case BR_CODE_END_OF_BRA:
117 case LEGACY_BR_CODE_END_OF_BRA:
123 bootrec = (struct bootrec *)&bootrec->data[len];
127 wiphy_info(priv->hw->wiphy,
128 "FW rev %s - Softmac protocol %x.%x\n",
129 fw_version, priv->fw_var >> 8, priv->fw_var & 0xff);
131 if (priv->fw_var < 0x500)
132 wiphy_info(priv->hw->wiphy,
133 "you are using an obsolete firmware. "
134 "visit http://wireless.kernel.org/en/users/Drivers/p54 "
135 "and grab one for \"kernel >= 2.6.28\"!\n");
137 if (priv->fw_var >= 0x300) {
138 /* Firmware supports QoS, use it! */
140 if (priv->fw_var >= 0x500) {
141 priv->tx_stats[P54_QUEUE_AC_VO].limit = 16;
142 priv->tx_stats[P54_QUEUE_AC_VI].limit = 16;
143 priv->tx_stats[P54_QUEUE_AC_BE].limit = 16;
144 priv->tx_stats[P54_QUEUE_AC_BK].limit = 16;
146 priv->tx_stats[P54_QUEUE_AC_VO].limit = 3;
147 priv->tx_stats[P54_QUEUE_AC_VI].limit = 4;
148 priv->tx_stats[P54_QUEUE_AC_BE].limit = 3;
149 priv->tx_stats[P54_QUEUE_AC_BK].limit = 2;
151 priv->hw->queues = P54_QUEUE_AC_NUM;
154 wiphy_info(priv->hw->wiphy,
155 "cryptographic accelerator WEP:%s, TKIP:%s, CCMP:%s\n",
156 (priv->privacy_caps & BR_DESC_PRIV_CAP_WEP) ? "YES" : "no",
157 (priv->privacy_caps &
158 (BR_DESC_PRIV_CAP_TKIP | BR_DESC_PRIV_CAP_MICHAEL))
160 (priv->privacy_caps & BR_DESC_PRIV_CAP_AESCCMP)
163 if (priv->rx_keycache_size) {
167 * The firmware provides at most 255 (0 - 254) slots
168 * for keys which are then used to offload decryption.
169 * As a result the 255 entry (aka 0xff) can be used
170 * safely by the driver to mark keys that didn't fit
171 * into the full cache. This trick saves us from
172 * keeping a extra list for uploaded keys.
175 priv->used_rxkeys = kzalloc(BITS_TO_LONGS(
176 priv->rx_keycache_size), GFP_KERNEL);
178 if (!priv->used_rxkeys)
184 EXPORT_SYMBOL_GPL(p54_parse_firmware);
186 static struct sk_buff *p54_alloc_skb(struct p54_common *priv, u16 hdr_flags,
187 u16 payload_len, u16 type, gfp_t memflags)
191 size_t frame_len = sizeof(*hdr) + payload_len;
193 if (frame_len > P54_MAX_CTRL_FRAME_LEN)
196 if (unlikely(skb_queue_len(&priv->tx_pending) > 64))
199 skb = __dev_alloc_skb(priv->tx_hdr_len + frame_len, memflags);
202 skb_reserve(skb, priv->tx_hdr_len);
204 hdr = (struct p54_hdr *) skb_put(skb, sizeof(*hdr));
205 hdr->flags = cpu_to_le16(hdr_flags);
206 hdr->len = cpu_to_le16(payload_len);
207 hdr->type = cpu_to_le16(type);
208 hdr->tries = hdr->rts_tries = 0;
212 int p54_download_eeprom(struct p54_common *priv, void *buf,
215 struct p54_eeprom_lm86 *eeprom_hdr;
217 size_t eeprom_hdr_size;
220 if (priv->fw_var >= 0x509)
221 eeprom_hdr_size = sizeof(*eeprom_hdr);
223 eeprom_hdr_size = 0x4;
225 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL, eeprom_hdr_size +
226 len, P54_CONTROL_TYPE_EEPROM_READBACK,
231 mutex_lock(&priv->eeprom_mutex);
233 eeprom_hdr = (struct p54_eeprom_lm86 *) skb_put(skb,
234 eeprom_hdr_size + len);
236 if (priv->fw_var < 0x509) {
237 eeprom_hdr->v1.offset = cpu_to_le16(offset);
238 eeprom_hdr->v1.len = cpu_to_le16(len);
240 eeprom_hdr->v2.offset = cpu_to_le32(offset);
241 eeprom_hdr->v2.len = cpu_to_le16(len);
242 eeprom_hdr->v2.magic2 = 0xf;
243 memcpy(eeprom_hdr->v2.magic, (const char *)"LOCK", 4);
248 if (!wait_for_completion_interruptible_timeout(
249 &priv->eeprom_comp, HZ)) {
250 wiphy_err(priv->hw->wiphy, "device does not respond!\n");
254 mutex_unlock(&priv->eeprom_mutex);
258 int p54_update_beacon_tim(struct p54_common *priv, u16 aid, bool set)
263 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*tim),
264 P54_CONTROL_TYPE_TIM, GFP_ATOMIC);
268 tim = (struct p54_tim *) skb_put(skb, sizeof(*tim));
270 tim->entry[0] = cpu_to_le16(set ? (aid | 0x8000) : aid);
275 int p54_sta_unlock(struct p54_common *priv, u8 *addr)
278 struct p54_sta_unlock *sta;
280 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*sta),
281 P54_CONTROL_TYPE_PSM_STA_UNLOCK, GFP_ATOMIC);
285 sta = (struct p54_sta_unlock *)skb_put(skb, sizeof(*sta));
286 memcpy(sta->addr, addr, ETH_ALEN);
291 int p54_tx_cancel(struct p54_common *priv, __le32 req_id)
294 struct p54_txcancel *cancel;
295 u32 _req_id = le32_to_cpu(req_id);
297 if (unlikely(_req_id < priv->rx_start || _req_id > priv->rx_end))
300 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*cancel),
301 P54_CONTROL_TYPE_TXCANCEL, GFP_ATOMIC);
305 cancel = (struct p54_txcancel *)skb_put(skb, sizeof(*cancel));
306 cancel->req_id = req_id;
311 int p54_setup_mac(struct p54_common *priv)
314 struct p54_setup_mac *setup;
317 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*setup),
318 P54_CONTROL_TYPE_SETUP, GFP_ATOMIC);
322 setup = (struct p54_setup_mac *) skb_put(skb, sizeof(*setup));
323 if (!(priv->hw->conf.flags & IEEE80211_CONF_IDLE)) {
324 switch (priv->mode) {
325 case NL80211_IFTYPE_STATION:
326 mode = P54_FILTER_TYPE_STATION;
328 case NL80211_IFTYPE_AP:
329 mode = P54_FILTER_TYPE_AP;
331 case NL80211_IFTYPE_ADHOC:
332 case NL80211_IFTYPE_MESH_POINT:
333 mode = P54_FILTER_TYPE_IBSS;
335 case NL80211_IFTYPE_MONITOR:
336 mode = P54_FILTER_TYPE_PROMISCUOUS;
339 mode = P54_FILTER_TYPE_HIBERNATE;
344 * "TRANSPARENT and PROMISCUOUS are mutually exclusive"
345 * STSW45X0C LMAC API - page 12
347 if (((priv->filter_flags & FIF_PROMISC_IN_BSS) ||
348 (priv->filter_flags & FIF_OTHER_BSS)) &&
349 (mode != P54_FILTER_TYPE_PROMISCUOUS))
350 mode |= P54_FILTER_TYPE_TRANSPARENT;
352 mode = P54_FILTER_TYPE_HIBERNATE;
355 setup->mac_mode = cpu_to_le16(mode);
356 memcpy(setup->mac_addr, priv->mac_addr, ETH_ALEN);
357 memcpy(setup->bssid, priv->bssid, ETH_ALEN);
358 setup->rx_antenna = 2 & priv->rx_diversity_mask; /* automatic */
360 if (priv->fw_var < 0x500) {
361 setup->v1.basic_rate_mask = cpu_to_le32(priv->basic_rate_mask);
362 memset(setup->v1.rts_rates, 0, 8);
363 setup->v1.rx_addr = cpu_to_le32(priv->rx_end);
364 setup->v1.max_rx = cpu_to_le16(priv->rx_mtu);
365 setup->v1.rxhw = cpu_to_le16(priv->rxhw);
366 setup->v1.wakeup_timer = cpu_to_le16(priv->wakeup_timer);
367 setup->v1.unalloc0 = cpu_to_le16(0);
369 setup->v2.rx_addr = cpu_to_le32(priv->rx_end);
370 setup->v2.max_rx = cpu_to_le16(priv->rx_mtu);
371 setup->v2.rxhw = cpu_to_le16(priv->rxhw);
372 setup->v2.timer = cpu_to_le16(priv->wakeup_timer);
373 setup->v2.truncate = cpu_to_le16(48896);
374 setup->v2.basic_rate_mask = cpu_to_le32(priv->basic_rate_mask);
375 setup->v2.sbss_offset = 0;
376 setup->v2.mcast_window = 0;
377 setup->v2.rx_rssi_threshold = 0;
378 setup->v2.rx_ed_threshold = 0;
379 setup->v2.ref_clock = cpu_to_le32(644245094);
380 setup->v2.lpf_bandwidth = cpu_to_le16(65535);
381 setup->v2.osc_start_delay = cpu_to_le16(65535);
387 int p54_scan(struct p54_common *priv, u16 mode, u16 dwell)
391 struct p54_scan_head *head;
392 struct p54_iq_autocal_entry *iq_autocal;
393 union p54_scan_body_union *body;
394 struct p54_scan_tail_rate *rate;
395 struct pda_rssi_cal_entry *rssi;
398 int band = priv->hw->conf.channel->band;
399 __le16 freq = cpu_to_le16(priv->hw->conf.channel->center_freq);
401 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*head) +
402 2 + sizeof(*iq_autocal) + sizeof(*body) +
403 sizeof(*rate) + 2 * sizeof(*rssi),
404 P54_CONTROL_TYPE_SCAN, GFP_ATOMIC);
408 head = (struct p54_scan_head *) skb_put(skb, sizeof(*head));
409 memset(head->scan_params, 0, sizeof(head->scan_params));
410 head->mode = cpu_to_le16(mode);
411 head->dwell = cpu_to_le16(dwell);
414 if (priv->rxhw == PDR_SYNTH_FRONTEND_LONGBOW) {
415 __le16 *pa_power_points = (__le16 *) skb_put(skb, 2);
416 *pa_power_points = cpu_to_le16(0x0c);
419 iq_autocal = (void *) skb_put(skb, sizeof(*iq_autocal));
420 for (i = 0; i < priv->iq_autocal_len; i++) {
421 if (priv->iq_autocal[i].freq != freq)
424 memcpy(iq_autocal, &priv->iq_autocal[i].params,
425 sizeof(struct p54_iq_autocal_entry));
428 if (i == priv->iq_autocal_len)
431 if (priv->rxhw == PDR_SYNTH_FRONTEND_LONGBOW)
432 body = (void *) skb_put(skb, sizeof(body->longbow));
434 body = (void *) skb_put(skb, sizeof(body->normal));
436 for (i = 0; i < priv->output_limit->entries; i++) {
437 __le16 *entry_freq = (void *) (priv->output_limit->data +
438 priv->output_limit->entry_size * i);
440 if (*entry_freq != freq)
443 if (priv->rxhw == PDR_SYNTH_FRONTEND_LONGBOW) {
444 memcpy(&body->longbow.power_limits,
445 (void *) entry_freq + sizeof(__le16),
446 priv->output_limit->entry_size);
448 struct pda_channel_output_limit *limits =
451 body->normal.val_barker = 0x38;
452 body->normal.val_bpsk = body->normal.dup_bpsk =
454 body->normal.val_qpsk = body->normal.dup_qpsk =
456 body->normal.val_16qam = body->normal.dup_16qam =
458 body->normal.val_64qam = body->normal.dup_64qam =
463 if (i == priv->output_limit->entries)
466 entry = (void *)(priv->curve_data->data + priv->curve_data->offset);
467 for (i = 0; i < priv->curve_data->entries; i++) {
468 if (*((__le16 *)entry) != freq) {
469 entry += priv->curve_data->entry_size;
473 if (priv->rxhw == PDR_SYNTH_FRONTEND_LONGBOW) {
474 memcpy(&body->longbow.curve_data,
475 (void *) entry + sizeof(__le16),
476 priv->curve_data->entry_size);
478 struct p54_scan_body *chan = &body->normal;
479 struct pda_pa_curve_data *curve_data =
480 (void *) priv->curve_data->data;
482 entry += sizeof(__le16);
483 chan->pa_points_per_curve = 8;
484 memset(chan->curve_data, 0, sizeof(*chan->curve_data));
485 memcpy(chan->curve_data, entry,
486 sizeof(struct p54_pa_curve_data_sample) *
487 min((u8)8, curve_data->points_per_channel));
491 if (i == priv->curve_data->entries)
494 if ((priv->fw_var >= 0x500) && (priv->fw_var < 0x509)) {
495 rate = (void *) skb_put(skb, sizeof(*rate));
496 rate->basic_rate_mask = cpu_to_le32(priv->basic_rate_mask);
497 for (i = 0; i < sizeof(rate->rts_rates); i++)
498 rate->rts_rates[i] = i;
501 rssi = (struct pda_rssi_cal_entry *) skb_put(skb, sizeof(*rssi));
502 rssi->mul = cpu_to_le16(priv->rssical_db[band].mul);
503 rssi->add = cpu_to_le16(priv->rssical_db[band].add);
504 if (priv->rxhw == PDR_SYNTH_FRONTEND_LONGBOW) {
505 /* Longbow frontend needs ever more */
506 rssi = (void *) skb_put(skb, sizeof(*rssi));
507 rssi->mul = cpu_to_le16(priv->rssical_db[band].longbow_unkn);
508 rssi->add = cpu_to_le16(priv->rssical_db[band].longbow_unk2);
511 if (priv->fw_var >= 0x509) {
512 rate = (void *) skb_put(skb, sizeof(*rate));
513 rate->basic_rate_mask = cpu_to_le32(priv->basic_rate_mask);
514 for (i = 0; i < sizeof(rate->rts_rates); i++)
515 rate->rts_rates[i] = i;
518 hdr = (struct p54_hdr *) skb->data;
519 hdr->len = cpu_to_le16(skb->len - sizeof(*hdr));
525 wiphy_err(priv->hw->wiphy, "frequency change to channel %d failed.\n",
526 ieee80211_frequency_to_channel(
527 priv->hw->conf.channel->center_freq));
529 dev_kfree_skb_any(skb);
533 int p54_set_leds(struct p54_common *priv)
538 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*led),
539 P54_CONTROL_TYPE_LED, GFP_ATOMIC);
543 led = (struct p54_led *) skb_put(skb, sizeof(*led));
544 led->flags = cpu_to_le16(0x0003);
545 led->mask[0] = led->mask[1] = cpu_to_le16(priv->softled_state);
546 led->delay[0] = cpu_to_le16(1);
547 led->delay[1] = cpu_to_le16(0);
552 int p54_set_edcf(struct p54_common *priv)
555 struct p54_edcf *edcf;
557 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*edcf),
558 P54_CONTROL_TYPE_DCFINIT, GFP_ATOMIC);
562 edcf = (struct p54_edcf *)skb_put(skb, sizeof(*edcf));
563 if (priv->use_short_slot) {
572 /* (see prism54/isl_oid.h for further details) */
573 edcf->frameburst = cpu_to_le16(0);
574 edcf->round_trip_delay = cpu_to_le16(0);
576 memset(edcf->mapping, 0, sizeof(edcf->mapping));
577 memcpy(edcf->queue, priv->qos_params, sizeof(edcf->queue));
582 int p54_set_ps(struct p54_common *priv)
589 if (priv->hw->conf.flags & IEEE80211_CONF_PS &&
590 !priv->powersave_override)
591 mode = P54_PSM | P54_PSM_BEACON_TIMEOUT | P54_PSM_DTIM |
592 P54_PSM_CHECKSUM | P54_PSM_MCBC;
596 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*psm),
597 P54_CONTROL_TYPE_PSM, GFP_ATOMIC);
601 psm = (struct p54_psm *)skb_put(skb, sizeof(*psm));
602 psm->mode = cpu_to_le16(mode);
603 psm->aid = cpu_to_le16(priv->aid);
604 for (i = 0; i < ARRAY_SIZE(psm->intervals); i++) {
605 psm->intervals[i].interval =
606 cpu_to_le16(priv->hw->conf.listen_interval);
607 psm->intervals[i].periods = cpu_to_le16(1);
610 psm->beacon_rssi_skip_max = 200;
611 psm->rssi_delta_threshold = 0;
613 psm->exclude[0] = WLAN_EID_TIM;
619 int p54_init_xbow_synth(struct p54_common *priv)
622 struct p54_xbow_synth *xbow;
624 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*xbow),
625 P54_CONTROL_TYPE_XBOW_SYNTH_CFG, GFP_KERNEL);
629 xbow = (struct p54_xbow_synth *)skb_put(skb, sizeof(*xbow));
630 xbow->magic1 = cpu_to_le16(0x1);
631 xbow->magic2 = cpu_to_le16(0x2);
632 xbow->freq = cpu_to_le16(5390);
633 memset(xbow->padding, 0, sizeof(xbow->padding));
638 int p54_upload_key(struct p54_common *priv, u8 algo, int slot, u8 idx, u8 len,
642 struct p54_keycache *rxkey;
644 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL_OPSET, sizeof(*rxkey),
645 P54_CONTROL_TYPE_RX_KEYCACHE, GFP_KERNEL);
649 rxkey = (struct p54_keycache *)skb_put(skb, sizeof(*rxkey));
652 rxkey->key_type = algo;
654 memcpy(rxkey->mac, addr, ETH_ALEN);
656 memset(rxkey->mac, ~0, ETH_ALEN);
660 case P54_CRYPTO_AESCCMP:
661 rxkey->key_len = min_t(u8, 16, len);
662 memcpy(rxkey->key, key, rxkey->key_len);
665 case P54_CRYPTO_TKIPMICHAEL:
667 memcpy(rxkey->key, key, 16);
668 memcpy(&(rxkey->key[16]), &(key
669 [NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY]), 8);
672 case P54_CRYPTO_NONE:
674 memset(rxkey->key, 0, sizeof(rxkey->key));
678 wiphy_err(priv->hw->wiphy,
679 "invalid cryptographic algorithm: %d\n", algo);
688 int p54_fetch_statistics(struct p54_common *priv)
690 struct ieee80211_tx_info *txinfo;
691 struct p54_tx_info *p54info;
694 skb = p54_alloc_skb(priv, P54_HDR_FLAG_CONTROL,
695 sizeof(struct p54_statistics),
696 P54_CONTROL_TYPE_STAT_READBACK, GFP_KERNEL);
701 * The statistic feedback causes some extra headaches here, if it
702 * is not to crash/corrupt the firmware data structures.
704 * Unlike all other Control Get OIDs we can not use helpers like
705 * skb_put to reserve the space for the data we're requesting.
706 * Instead the extra frame length -which will hold the results later-
707 * will only be told to the p54_assign_address, so that following
708 * frames won't be placed into the allegedly empty area.
710 txinfo = IEEE80211_SKB_CB(skb);
711 p54info = (void *) txinfo->rate_driver_data;
712 p54info->extra_len = sizeof(struct p54_statistics);