main.c 43 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865
  1. /*
  2. * Atheros CARL9170 driver
  3. *
  4. * mac80211 interaction code
  5. *
  6. * Copyright 2008, Johannes Berg <johannes@sipsolutions.net>
  7. * Copyright 2009, 2010, Christian Lamparter <chunkeey@googlemail.com>
  8. *
  9. * This program is free software; you can redistribute it and/or modify
  10. * it under the terms of the GNU General Public License as published by
  11. * the Free Software Foundation; either version 2 of the License, or
  12. * (at your option) any later version.
  13. *
  14. * This program is distributed in the hope that it will be useful,
  15. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17. * GNU General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU General Public License
  20. * along with this program; see the file COPYING. If not, see
  21. * http://www.gnu.org/licenses/.
  22. *
  23. * This file incorporates work covered by the following copyright and
  24. * permission notice:
  25. * Copyright (c) 2007-2008 Atheros Communications, Inc.
  26. *
  27. * Permission to use, copy, modify, and/or distribute this software for any
  28. * purpose with or without fee is hereby granted, provided that the above
  29. * copyright notice and this permission notice appear in all copies.
  30. *
  31. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  32. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  33. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  34. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  35. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  36. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  37. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  38. */
  39. #include <linux/init.h>
  40. #include <linux/slab.h>
  41. #include <linux/module.h>
  42. #include <linux/etherdevice.h>
  43. #include <linux/random.h>
  44. #include <net/mac80211.h>
  45. #include <net/cfg80211.h>
  46. #include "hw.h"
  47. #include "carl9170.h"
  48. #include "cmd.h"
  49. static int modparam_nohwcrypt;
  50. module_param_named(nohwcrypt, modparam_nohwcrypt, bool, S_IRUGO);
  51. MODULE_PARM_DESC(nohwcrypt, "Disable hardware crypto offload.");
  52. int modparam_noht;
  53. module_param_named(noht, modparam_noht, int, S_IRUGO);
  54. MODULE_PARM_DESC(noht, "Disable MPDU aggregation.");
  55. #define RATE(_bitrate, _hw_rate, _txpidx, _flags) { \
  56. .bitrate = (_bitrate), \
  57. .flags = (_flags), \
  58. .hw_value = (_hw_rate) | (_txpidx) << 4, \
  59. }
  60. struct ieee80211_rate __carl9170_ratetable[] = {
  61. RATE(10, 0, 0, 0),
  62. RATE(20, 1, 1, IEEE80211_RATE_SHORT_PREAMBLE),
  63. RATE(55, 2, 2, IEEE80211_RATE_SHORT_PREAMBLE),
  64. RATE(110, 3, 3, IEEE80211_RATE_SHORT_PREAMBLE),
  65. RATE(60, 0xb, 0, 0),
  66. RATE(90, 0xf, 0, 0),
  67. RATE(120, 0xa, 0, 0),
  68. RATE(180, 0xe, 0, 0),
  69. RATE(240, 0x9, 0, 0),
  70. RATE(360, 0xd, 1, 0),
  71. RATE(480, 0x8, 2, 0),
  72. RATE(540, 0xc, 3, 0),
  73. };
  74. #undef RATE
  75. #define carl9170_g_ratetable (__carl9170_ratetable + 0)
  76. #define carl9170_g_ratetable_size 12
  77. #define carl9170_a_ratetable (__carl9170_ratetable + 4)
  78. #define carl9170_a_ratetable_size 8
  79. /*
  80. * NB: The hw_value is used as an index into the carl9170_phy_freq_params
  81. * array in phy.c so that we don't have to do frequency lookups!
  82. */
  83. #define CHAN(_freq, _idx) { \
  84. .center_freq = (_freq), \
  85. .hw_value = (_idx), \
  86. .max_power = 18, /* XXX */ \
  87. }
  88. static struct ieee80211_channel carl9170_2ghz_chantable[] = {
  89. CHAN(2412, 0),
  90. CHAN(2417, 1),
  91. CHAN(2422, 2),
  92. CHAN(2427, 3),
  93. CHAN(2432, 4),
  94. CHAN(2437, 5),
  95. CHAN(2442, 6),
  96. CHAN(2447, 7),
  97. CHAN(2452, 8),
  98. CHAN(2457, 9),
  99. CHAN(2462, 10),
  100. CHAN(2467, 11),
  101. CHAN(2472, 12),
  102. CHAN(2484, 13),
  103. };
  104. static struct ieee80211_channel carl9170_5ghz_chantable[] = {
  105. CHAN(4920, 14),
  106. CHAN(4940, 15),
  107. CHAN(4960, 16),
  108. CHAN(4980, 17),
  109. CHAN(5040, 18),
  110. CHAN(5060, 19),
  111. CHAN(5080, 20),
  112. CHAN(5180, 21),
  113. CHAN(5200, 22),
  114. CHAN(5220, 23),
  115. CHAN(5240, 24),
  116. CHAN(5260, 25),
  117. CHAN(5280, 26),
  118. CHAN(5300, 27),
  119. CHAN(5320, 28),
  120. CHAN(5500, 29),
  121. CHAN(5520, 30),
  122. CHAN(5540, 31),
  123. CHAN(5560, 32),
  124. CHAN(5580, 33),
  125. CHAN(5600, 34),
  126. CHAN(5620, 35),
  127. CHAN(5640, 36),
  128. CHAN(5660, 37),
  129. CHAN(5680, 38),
  130. CHAN(5700, 39),
  131. CHAN(5745, 40),
  132. CHAN(5765, 41),
  133. CHAN(5785, 42),
  134. CHAN(5805, 43),
  135. CHAN(5825, 44),
  136. CHAN(5170, 45),
  137. CHAN(5190, 46),
  138. CHAN(5210, 47),
  139. CHAN(5230, 48),
  140. };
  141. #undef CHAN
  142. #define CARL9170_HT_CAP \
  143. { \
  144. .ht_supported = true, \
  145. .cap = IEEE80211_HT_CAP_MAX_AMSDU | \
  146. IEEE80211_HT_CAP_SUP_WIDTH_20_40 | \
  147. IEEE80211_HT_CAP_SGI_40 | \
  148. IEEE80211_HT_CAP_DSSSCCK40 | \
  149. IEEE80211_HT_CAP_SM_PS, \
  150. .ampdu_factor = IEEE80211_HT_MAX_AMPDU_64K, \
  151. .ampdu_density = IEEE80211_HT_MPDU_DENSITY_8, \
  152. .mcs = { \
  153. .rx_mask = { 0xff, 0xff, 0, 0, 0x1, 0, 0, 0, 0, 0, }, \
  154. .rx_highest = cpu_to_le16(300), \
  155. .tx_params = IEEE80211_HT_MCS_TX_DEFINED, \
  156. }, \
  157. }
  158. static struct ieee80211_supported_band carl9170_band_2GHz = {
  159. .channels = carl9170_2ghz_chantable,
  160. .n_channels = ARRAY_SIZE(carl9170_2ghz_chantable),
  161. .bitrates = carl9170_g_ratetable,
  162. .n_bitrates = carl9170_g_ratetable_size,
  163. .ht_cap = CARL9170_HT_CAP,
  164. };
  165. static struct ieee80211_supported_band carl9170_band_5GHz = {
  166. .channels = carl9170_5ghz_chantable,
  167. .n_channels = ARRAY_SIZE(carl9170_5ghz_chantable),
  168. .bitrates = carl9170_a_ratetable,
  169. .n_bitrates = carl9170_a_ratetable_size,
  170. .ht_cap = CARL9170_HT_CAP,
  171. };
  172. static void carl9170_ampdu_gc(struct ar9170 *ar)
  173. {
  174. struct carl9170_sta_tid *tid_info;
  175. LIST_HEAD(tid_gc);
  176. rcu_read_lock();
  177. list_for_each_entry_rcu(tid_info, &ar->tx_ampdu_list, list) {
  178. spin_lock_bh(&ar->tx_ampdu_list_lock);
  179. if (tid_info->state == CARL9170_TID_STATE_SHUTDOWN) {
  180. tid_info->state = CARL9170_TID_STATE_KILLED;
  181. list_del_rcu(&tid_info->list);
  182. ar->tx_ampdu_list_len--;
  183. list_add_tail(&tid_info->tmp_list, &tid_gc);
  184. }
  185. spin_unlock_bh(&ar->tx_ampdu_list_lock);
  186. }
  187. rcu_assign_pointer(ar->tx_ampdu_iter, tid_info);
  188. rcu_read_unlock();
  189. synchronize_rcu();
  190. while (!list_empty(&tid_gc)) {
  191. struct sk_buff *skb;
  192. tid_info = list_first_entry(&tid_gc, struct carl9170_sta_tid,
  193. tmp_list);
  194. while ((skb = __skb_dequeue(&tid_info->queue)))
  195. carl9170_tx_status(ar, skb, false);
  196. list_del_init(&tid_info->tmp_list);
  197. kfree(tid_info);
  198. }
  199. }
  200. static void carl9170_flush(struct ar9170 *ar, bool drop_queued)
  201. {
  202. if (drop_queued) {
  203. int i;
  204. /*
  205. * We can only drop frames which have not been uploaded
  206. * to the device yet.
  207. */
  208. for (i = 0; i < ar->hw->queues; i++) {
  209. struct sk_buff *skb;
  210. while ((skb = skb_dequeue(&ar->tx_pending[i]))) {
  211. struct ieee80211_tx_info *info;
  212. info = IEEE80211_SKB_CB(skb);
  213. if (info->flags & IEEE80211_TX_CTL_AMPDU)
  214. atomic_dec(&ar->tx_ampdu_upload);
  215. carl9170_tx_status(ar, skb, false);
  216. }
  217. }
  218. }
  219. /* Wait for all other outstanding frames to timeout. */
  220. if (atomic_read(&ar->tx_total_queued))
  221. WARN_ON(wait_for_completion_timeout(&ar->tx_flush, HZ) == 0);
  222. }
  223. static void carl9170_flush_ba(struct ar9170 *ar)
  224. {
  225. struct sk_buff_head free;
  226. struct carl9170_sta_tid *tid_info;
  227. struct sk_buff *skb;
  228. __skb_queue_head_init(&free);
  229. rcu_read_lock();
  230. spin_lock_bh(&ar->tx_ampdu_list_lock);
  231. list_for_each_entry_rcu(tid_info, &ar->tx_ampdu_list, list) {
  232. if (tid_info->state > CARL9170_TID_STATE_SUSPEND) {
  233. tid_info->state = CARL9170_TID_STATE_SUSPEND;
  234. spin_lock(&tid_info->lock);
  235. while ((skb = __skb_dequeue(&tid_info->queue)))
  236. __skb_queue_tail(&free, skb);
  237. spin_unlock(&tid_info->lock);
  238. }
  239. }
  240. spin_unlock_bh(&ar->tx_ampdu_list_lock);
  241. rcu_read_unlock();
  242. while ((skb = __skb_dequeue(&free)))
  243. carl9170_tx_status(ar, skb, false);
  244. }
  245. static void carl9170_zap_queues(struct ar9170 *ar)
  246. {
  247. struct carl9170_vif_info *cvif;
  248. unsigned int i;
  249. carl9170_ampdu_gc(ar);
  250. carl9170_flush_ba(ar);
  251. carl9170_flush(ar, true);
  252. for (i = 0; i < ar->hw->queues; i++) {
  253. spin_lock_bh(&ar->tx_status[i].lock);
  254. while (!skb_queue_empty(&ar->tx_status[i])) {
  255. struct sk_buff *skb;
  256. skb = skb_peek(&ar->tx_status[i]);
  257. carl9170_tx_get_skb(skb);
  258. spin_unlock_bh(&ar->tx_status[i].lock);
  259. carl9170_tx_drop(ar, skb);
  260. spin_lock_bh(&ar->tx_status[i].lock);
  261. carl9170_tx_put_skb(skb);
  262. }
  263. spin_unlock_bh(&ar->tx_status[i].lock);
  264. }
  265. BUILD_BUG_ON(CARL9170_NUM_TX_LIMIT_SOFT < 1);
  266. BUILD_BUG_ON(CARL9170_NUM_TX_LIMIT_HARD < CARL9170_NUM_TX_LIMIT_SOFT);
  267. BUILD_BUG_ON(CARL9170_NUM_TX_LIMIT_HARD >= CARL9170_BAW_BITS);
  268. /* reinitialize queues statistics */
  269. memset(&ar->tx_stats, 0, sizeof(ar->tx_stats));
  270. for (i = 0; i < ar->hw->queues; i++)
  271. ar->tx_stats[i].limit = CARL9170_NUM_TX_LIMIT_HARD;
  272. for (i = 0; i < DIV_ROUND_UP(ar->fw.mem_blocks, BITS_PER_LONG); i++)
  273. ar->mem_bitmap[i] = 0;
  274. rcu_read_lock();
  275. list_for_each_entry_rcu(cvif, &ar->vif_list, list) {
  276. spin_lock_bh(&ar->beacon_lock);
  277. dev_kfree_skb_any(cvif->beacon);
  278. cvif->beacon = NULL;
  279. spin_unlock_bh(&ar->beacon_lock);
  280. }
  281. rcu_read_unlock();
  282. atomic_set(&ar->tx_ampdu_upload, 0);
  283. atomic_set(&ar->tx_ampdu_scheduler, 0);
  284. atomic_set(&ar->tx_total_pending, 0);
  285. atomic_set(&ar->tx_total_queued, 0);
  286. atomic_set(&ar->mem_free_blocks, ar->fw.mem_blocks);
  287. }
  288. #define CARL9170_FILL_QUEUE(queue, ai_fs, cwmin, cwmax, _txop) \
  289. do { \
  290. queue.aifs = ai_fs; \
  291. queue.cw_min = cwmin; \
  292. queue.cw_max = cwmax; \
  293. queue.txop = _txop; \
  294. } while (0)
  295. static int carl9170_op_start(struct ieee80211_hw *hw)
  296. {
  297. struct ar9170 *ar = hw->priv;
  298. int err, i;
  299. mutex_lock(&ar->mutex);
  300. carl9170_zap_queues(ar);
  301. /* reset QoS defaults */
  302. CARL9170_FILL_QUEUE(ar->edcf[0], 3, 15, 1023, 0); /* BEST EFFORT */
  303. CARL9170_FILL_QUEUE(ar->edcf[1], 2, 7, 15, 94); /* VIDEO */
  304. CARL9170_FILL_QUEUE(ar->edcf[2], 2, 3, 7, 47); /* VOICE */
  305. CARL9170_FILL_QUEUE(ar->edcf[3], 7, 15, 1023, 0); /* BACKGROUND */
  306. CARL9170_FILL_QUEUE(ar->edcf[4], 2, 3, 7, 0); /* SPECIAL */
  307. ar->current_factor = ar->current_density = -1;
  308. /* "The first key is unique." */
  309. ar->usedkeys = 1;
  310. ar->filter_state = 0;
  311. ar->ps.last_action = jiffies;
  312. ar->ps.last_slept = jiffies;
  313. ar->erp_mode = CARL9170_ERP_AUTO;
  314. ar->rx_software_decryption = false;
  315. ar->disable_offload = false;
  316. for (i = 0; i < ar->hw->queues; i++) {
  317. ar->queue_stop_timeout[i] = jiffies;
  318. ar->max_queue_stop_timeout[i] = 0;
  319. }
  320. atomic_set(&ar->mem_allocs, 0);
  321. err = carl9170_usb_open(ar);
  322. if (err)
  323. goto out;
  324. err = carl9170_init_mac(ar);
  325. if (err)
  326. goto out;
  327. err = carl9170_set_qos(ar);
  328. if (err)
  329. goto out;
  330. err = carl9170_write_reg(ar, AR9170_MAC_REG_DMA_TRIGGER,
  331. AR9170_DMA_TRIGGER_RXQ);
  332. if (err)
  333. goto out;
  334. /* Clear key-cache */
  335. for (i = 0; i < AR9170_CAM_MAX_USER + 4; i++) {
  336. err = carl9170_upload_key(ar, i, NULL, AR9170_ENC_ALG_NONE,
  337. 0, NULL, 0);
  338. if (err)
  339. goto out;
  340. err = carl9170_upload_key(ar, i, NULL, AR9170_ENC_ALG_NONE,
  341. 1, NULL, 0);
  342. if (err)
  343. goto out;
  344. if (i < AR9170_CAM_MAX_USER) {
  345. err = carl9170_disable_key(ar, i);
  346. if (err)
  347. goto out;
  348. }
  349. }
  350. carl9170_set_state_when(ar, CARL9170_IDLE, CARL9170_STARTED);
  351. ieee80211_wake_queues(ar->hw);
  352. err = 0;
  353. out:
  354. mutex_unlock(&ar->mutex);
  355. return err;
  356. }
  357. static void carl9170_cancel_worker(struct ar9170 *ar)
  358. {
  359. cancel_delayed_work_sync(&ar->tx_janitor);
  360. #ifdef CONFIG_CARL9170_LEDS
  361. cancel_delayed_work_sync(&ar->led_work);
  362. #endif /* CONFIG_CARL9170_LEDS */
  363. cancel_work_sync(&ar->ps_work);
  364. cancel_work_sync(&ar->ampdu_work);
  365. }
  366. static void carl9170_op_stop(struct ieee80211_hw *hw)
  367. {
  368. struct ar9170 *ar = hw->priv;
  369. carl9170_set_state_when(ar, CARL9170_STARTED, CARL9170_IDLE);
  370. ieee80211_stop_queues(ar->hw);
  371. mutex_lock(&ar->mutex);
  372. if (IS_ACCEPTING_CMD(ar)) {
  373. rcu_assign_pointer(ar->beacon_iter, NULL);
  374. carl9170_led_set_state(ar, 0);
  375. /* stop DMA */
  376. carl9170_write_reg(ar, AR9170_MAC_REG_DMA_TRIGGER, 0);
  377. carl9170_usb_stop(ar);
  378. }
  379. carl9170_zap_queues(ar);
  380. mutex_unlock(&ar->mutex);
  381. carl9170_cancel_worker(ar);
  382. }
  383. static void carl9170_restart_work(struct work_struct *work)
  384. {
  385. struct ar9170 *ar = container_of(work, struct ar9170,
  386. restart_work);
  387. int err;
  388. ar->usedkeys = 0;
  389. ar->filter_state = 0;
  390. carl9170_cancel_worker(ar);
  391. mutex_lock(&ar->mutex);
  392. err = carl9170_usb_restart(ar);
  393. if (net_ratelimit()) {
  394. if (err) {
  395. dev_err(&ar->udev->dev, "Failed to restart device "
  396. " (%d).\n", err);
  397. } else {
  398. dev_info(&ar->udev->dev, "device restarted "
  399. "successfully.\n");
  400. }
  401. }
  402. carl9170_zap_queues(ar);
  403. mutex_unlock(&ar->mutex);
  404. if (!err) {
  405. ar->restart_counter++;
  406. atomic_set(&ar->pending_restarts, 0);
  407. ieee80211_restart_hw(ar->hw);
  408. } else {
  409. /*
  410. * The reset was unsuccessful and the device seems to
  411. * be dead. But there's still one option: a low-level
  412. * usb subsystem reset...
  413. */
  414. carl9170_usb_reset(ar);
  415. }
  416. }
  417. void carl9170_restart(struct ar9170 *ar, const enum carl9170_restart_reasons r)
  418. {
  419. carl9170_set_state_when(ar, CARL9170_STARTED, CARL9170_IDLE);
  420. /*
  421. * Sometimes, an error can trigger several different reset events.
  422. * By ignoring these *surplus* reset events, the device won't be
  423. * killed again, right after it has recovered.
  424. */
  425. if (atomic_inc_return(&ar->pending_restarts) > 1) {
  426. dev_dbg(&ar->udev->dev, "ignoring restart (%d)\n", r);
  427. return;
  428. }
  429. ieee80211_stop_queues(ar->hw);
  430. dev_err(&ar->udev->dev, "restart device (%d)\n", r);
  431. if (!WARN_ON(r == CARL9170_RR_NO_REASON) ||
  432. !WARN_ON(r >= __CARL9170_RR_LAST))
  433. ar->last_reason = r;
  434. if (!ar->registered)
  435. return;
  436. if (IS_ACCEPTING_CMD(ar) && !ar->needs_full_reset)
  437. ieee80211_queue_work(ar->hw, &ar->restart_work);
  438. else
  439. carl9170_usb_reset(ar);
  440. /*
  441. * At this point, the device instance might have vanished/disabled.
  442. * So, don't put any code which access the ar9170 struct
  443. * without proper protection.
  444. */
  445. }
  446. static int carl9170_init_interface(struct ar9170 *ar,
  447. struct ieee80211_vif *vif)
  448. {
  449. struct ath_common *common = &ar->common;
  450. int err;
  451. if (!vif) {
  452. WARN_ON_ONCE(IS_STARTED(ar));
  453. return 0;
  454. }
  455. memcpy(common->macaddr, vif->addr, ETH_ALEN);
  456. if (modparam_nohwcrypt ||
  457. ((vif->type != NL80211_IFTYPE_STATION) &&
  458. (vif->type != NL80211_IFTYPE_AP))) {
  459. ar->rx_software_decryption = true;
  460. ar->disable_offload = true;
  461. }
  462. err = carl9170_set_operating_mode(ar);
  463. return err;
  464. }
  465. static int carl9170_op_add_interface(struct ieee80211_hw *hw,
  466. struct ieee80211_vif *vif)
  467. {
  468. struct carl9170_vif_info *vif_priv = (void *) vif->drv_priv;
  469. struct ieee80211_vif *main_vif;
  470. struct ar9170 *ar = hw->priv;
  471. int vif_id = -1, err = 0;
  472. mutex_lock(&ar->mutex);
  473. rcu_read_lock();
  474. if (vif_priv->active) {
  475. /*
  476. * Skip the interface structure initialization,
  477. * if the vif survived the _restart call.
  478. */
  479. vif_id = vif_priv->id;
  480. vif_priv->enable_beacon = false;
  481. spin_lock_bh(&ar->beacon_lock);
  482. dev_kfree_skb_any(vif_priv->beacon);
  483. vif_priv->beacon = NULL;
  484. spin_unlock_bh(&ar->beacon_lock);
  485. goto init;
  486. }
  487. main_vif = carl9170_get_main_vif(ar);
  488. if (main_vif) {
  489. switch (main_vif->type) {
  490. case NL80211_IFTYPE_STATION:
  491. if (vif->type == NL80211_IFTYPE_STATION)
  492. break;
  493. err = -EBUSY;
  494. rcu_read_unlock();
  495. goto unlock;
  496. case NL80211_IFTYPE_AP:
  497. if ((vif->type == NL80211_IFTYPE_STATION) ||
  498. (vif->type == NL80211_IFTYPE_WDS) ||
  499. (vif->type == NL80211_IFTYPE_AP))
  500. break;
  501. err = -EBUSY;
  502. rcu_read_unlock();
  503. goto unlock;
  504. default:
  505. rcu_read_unlock();
  506. goto unlock;
  507. }
  508. }
  509. vif_id = bitmap_find_free_region(&ar->vif_bitmap, ar->fw.vif_num, 0);
  510. if (vif_id < 0) {
  511. rcu_read_unlock();
  512. err = -ENOSPC;
  513. goto unlock;
  514. }
  515. BUG_ON(ar->vif_priv[vif_id].id != vif_id);
  516. vif_priv->active = true;
  517. vif_priv->id = vif_id;
  518. vif_priv->enable_beacon = false;
  519. ar->vifs++;
  520. list_add_tail_rcu(&vif_priv->list, &ar->vif_list);
  521. rcu_assign_pointer(ar->vif_priv[vif_id].vif, vif);
  522. init:
  523. if (carl9170_get_main_vif(ar) == vif) {
  524. rcu_assign_pointer(ar->beacon_iter, vif_priv);
  525. rcu_read_unlock();
  526. err = carl9170_init_interface(ar, vif);
  527. if (err)
  528. goto unlock;
  529. } else {
  530. err = carl9170_mod_virtual_mac(ar, vif_id, vif->addr);
  531. rcu_read_unlock();
  532. if (err)
  533. goto unlock;
  534. }
  535. unlock:
  536. if (err && (vif_id != -1)) {
  537. vif_priv->active = false;
  538. bitmap_release_region(&ar->vif_bitmap, vif_id, 0);
  539. ar->vifs--;
  540. rcu_assign_pointer(ar->vif_priv[vif_id].vif, NULL);
  541. list_del_rcu(&vif_priv->list);
  542. mutex_unlock(&ar->mutex);
  543. synchronize_rcu();
  544. } else {
  545. if (ar->vifs > 1)
  546. ar->ps.off_override |= PS_OFF_VIF;
  547. mutex_unlock(&ar->mutex);
  548. }
  549. return err;
  550. }
  551. static void carl9170_op_remove_interface(struct ieee80211_hw *hw,
  552. struct ieee80211_vif *vif)
  553. {
  554. struct carl9170_vif_info *vif_priv = (void *) vif->drv_priv;
  555. struct ieee80211_vif *main_vif;
  556. struct ar9170 *ar = hw->priv;
  557. unsigned int id;
  558. mutex_lock(&ar->mutex);
  559. if (WARN_ON_ONCE(!vif_priv->active))
  560. goto unlock;
  561. ar->vifs--;
  562. rcu_read_lock();
  563. main_vif = carl9170_get_main_vif(ar);
  564. id = vif_priv->id;
  565. vif_priv->active = false;
  566. WARN_ON(vif_priv->enable_beacon);
  567. vif_priv->enable_beacon = false;
  568. list_del_rcu(&vif_priv->list);
  569. rcu_assign_pointer(ar->vif_priv[id].vif, NULL);
  570. if (vif == main_vif) {
  571. rcu_read_unlock();
  572. if (ar->vifs) {
  573. WARN_ON(carl9170_init_interface(ar,
  574. carl9170_get_main_vif(ar)));
  575. } else {
  576. carl9170_set_operating_mode(ar);
  577. }
  578. } else {
  579. rcu_read_unlock();
  580. WARN_ON(carl9170_mod_virtual_mac(ar, id, NULL));
  581. }
  582. carl9170_update_beacon(ar, false);
  583. carl9170_flush_cab(ar, id);
  584. spin_lock_bh(&ar->beacon_lock);
  585. dev_kfree_skb_any(vif_priv->beacon);
  586. vif_priv->beacon = NULL;
  587. spin_unlock_bh(&ar->beacon_lock);
  588. bitmap_release_region(&ar->vif_bitmap, id, 0);
  589. carl9170_set_beacon_timers(ar);
  590. if (ar->vifs == 1)
  591. ar->ps.off_override &= ~PS_OFF_VIF;
  592. unlock:
  593. mutex_unlock(&ar->mutex);
  594. synchronize_rcu();
  595. }
  596. void carl9170_ps_check(struct ar9170 *ar)
  597. {
  598. ieee80211_queue_work(ar->hw, &ar->ps_work);
  599. }
  600. /* caller must hold ar->mutex */
  601. static int carl9170_ps_update(struct ar9170 *ar)
  602. {
  603. bool ps = false;
  604. int err = 0;
  605. if (!ar->ps.off_override)
  606. ps = (ar->hw->conf.flags & IEEE80211_CONF_PS);
  607. if (ps != ar->ps.state) {
  608. err = carl9170_powersave(ar, ps);
  609. if (err)
  610. return err;
  611. if (ar->ps.state && !ps) {
  612. ar->ps.sleep_ms = jiffies_to_msecs(jiffies -
  613. ar->ps.last_action);
  614. }
  615. if (ps)
  616. ar->ps.last_slept = jiffies;
  617. ar->ps.last_action = jiffies;
  618. ar->ps.state = ps;
  619. }
  620. return 0;
  621. }
  622. static void carl9170_ps_work(struct work_struct *work)
  623. {
  624. struct ar9170 *ar = container_of(work, struct ar9170,
  625. ps_work);
  626. mutex_lock(&ar->mutex);
  627. if (IS_STARTED(ar))
  628. WARN_ON_ONCE(carl9170_ps_update(ar) != 0);
  629. mutex_unlock(&ar->mutex);
  630. }
  631. static int carl9170_op_config(struct ieee80211_hw *hw, u32 changed)
  632. {
  633. struct ar9170 *ar = hw->priv;
  634. int err = 0;
  635. mutex_lock(&ar->mutex);
  636. if (changed & IEEE80211_CONF_CHANGE_LISTEN_INTERVAL) {
  637. /* TODO */
  638. err = 0;
  639. }
  640. if (changed & IEEE80211_CONF_CHANGE_PS) {
  641. err = carl9170_ps_update(ar);
  642. if (err)
  643. goto out;
  644. }
  645. if (changed & IEEE80211_CONF_CHANGE_POWER) {
  646. /* TODO */
  647. err = 0;
  648. }
  649. if (changed & IEEE80211_CONF_CHANGE_SMPS) {
  650. /* TODO */
  651. err = 0;
  652. }
  653. if (changed & IEEE80211_CONF_CHANGE_CHANNEL) {
  654. /* adjust slot time for 5 GHz */
  655. err = carl9170_set_slot_time(ar);
  656. if (err)
  657. goto out;
  658. err = carl9170_set_channel(ar, hw->conf.channel,
  659. hw->conf.channel_type, CARL9170_RFI_NONE);
  660. if (err)
  661. goto out;
  662. err = carl9170_set_dyn_sifs_ack(ar);
  663. if (err)
  664. goto out;
  665. err = carl9170_set_rts_cts_rate(ar);
  666. if (err)
  667. goto out;
  668. }
  669. out:
  670. mutex_unlock(&ar->mutex);
  671. return err;
  672. }
  673. static u64 carl9170_op_prepare_multicast(struct ieee80211_hw *hw,
  674. struct netdev_hw_addr_list *mc_list)
  675. {
  676. struct netdev_hw_addr *ha;
  677. u64 mchash;
  678. /* always get broadcast frames */
  679. mchash = 1ULL << (0xff >> 2);
  680. netdev_hw_addr_list_for_each(ha, mc_list)
  681. mchash |= 1ULL << (ha->addr[5] >> 2);
  682. return mchash;
  683. }
  684. static void carl9170_op_configure_filter(struct ieee80211_hw *hw,
  685. unsigned int changed_flags,
  686. unsigned int *new_flags,
  687. u64 multicast)
  688. {
  689. struct ar9170 *ar = hw->priv;
  690. /* mask supported flags */
  691. *new_flags &= FIF_ALLMULTI | FIF_FCSFAIL | FIF_PLCPFAIL |
  692. FIF_OTHER_BSS | FIF_PROMISC_IN_BSS;
  693. if (!IS_ACCEPTING_CMD(ar))
  694. return;
  695. mutex_lock(&ar->mutex);
  696. ar->filter_state = *new_flags;
  697. /*
  698. * We can support more by setting the sniffer bit and
  699. * then checking the error flags, later.
  700. */
  701. if (changed_flags & FIF_ALLMULTI && *new_flags & FIF_ALLMULTI)
  702. multicast = ~0ULL;
  703. if (multicast != ar->cur_mc_hash)
  704. WARN_ON(carl9170_update_multicast(ar, multicast));
  705. if (changed_flags & (FIF_OTHER_BSS | FIF_PROMISC_IN_BSS)) {
  706. ar->sniffer_enabled = !!(*new_flags &
  707. (FIF_OTHER_BSS | FIF_PROMISC_IN_BSS));
  708. WARN_ON(carl9170_set_operating_mode(ar));
  709. }
  710. mutex_unlock(&ar->mutex);
  711. }
  712. static void carl9170_op_bss_info_changed(struct ieee80211_hw *hw,
  713. struct ieee80211_vif *vif,
  714. struct ieee80211_bss_conf *bss_conf,
  715. u32 changed)
  716. {
  717. struct ar9170 *ar = hw->priv;
  718. struct ath_common *common = &ar->common;
  719. int err = 0;
  720. struct carl9170_vif_info *vif_priv;
  721. struct ieee80211_vif *main_vif;
  722. mutex_lock(&ar->mutex);
  723. vif_priv = (void *) vif->drv_priv;
  724. main_vif = carl9170_get_main_vif(ar);
  725. if (WARN_ON(!main_vif))
  726. goto out;
  727. if (changed & BSS_CHANGED_BEACON_ENABLED) {
  728. struct carl9170_vif_info *iter;
  729. int i = 0;
  730. vif_priv->enable_beacon = bss_conf->enable_beacon;
  731. rcu_read_lock();
  732. list_for_each_entry_rcu(iter, &ar->vif_list, list) {
  733. if (iter->active && iter->enable_beacon)
  734. i++;
  735. }
  736. rcu_read_unlock();
  737. ar->beacon_enabled = i;
  738. }
  739. if (changed & BSS_CHANGED_BEACON) {
  740. err = carl9170_update_beacon(ar, false);
  741. if (err)
  742. goto out;
  743. }
  744. if (changed & (BSS_CHANGED_BEACON_ENABLED | BSS_CHANGED_BEACON |
  745. BSS_CHANGED_BEACON_INT)) {
  746. if (main_vif != vif) {
  747. bss_conf->beacon_int = main_vif->bss_conf.beacon_int;
  748. bss_conf->dtim_period = main_vif->bss_conf.dtim_period;
  749. }
  750. /*
  751. * Therefore a hard limit for the broadcast traffic should
  752. * prevent false alarms.
  753. */
  754. if (vif->type != NL80211_IFTYPE_STATION &&
  755. (bss_conf->beacon_int * bss_conf->dtim_period >=
  756. (CARL9170_QUEUE_STUCK_TIMEOUT / 2))) {
  757. err = -EINVAL;
  758. goto out;
  759. }
  760. err = carl9170_set_beacon_timers(ar);
  761. if (err)
  762. goto out;
  763. }
  764. if (changed & BSS_CHANGED_HT) {
  765. /* TODO */
  766. err = 0;
  767. if (err)
  768. goto out;
  769. }
  770. if (main_vif != vif)
  771. goto out;
  772. /*
  773. * The following settings can only be changed by the
  774. * master interface.
  775. */
  776. if (changed & BSS_CHANGED_BSSID) {
  777. memcpy(common->curbssid, bss_conf->bssid, ETH_ALEN);
  778. err = carl9170_set_operating_mode(ar);
  779. if (err)
  780. goto out;
  781. }
  782. if (changed & BSS_CHANGED_ASSOC) {
  783. ar->common.curaid = bss_conf->aid;
  784. err = carl9170_set_beacon_timers(ar);
  785. if (err)
  786. goto out;
  787. }
  788. if (changed & BSS_CHANGED_ERP_SLOT) {
  789. err = carl9170_set_slot_time(ar);
  790. if (err)
  791. goto out;
  792. }
  793. if (changed & BSS_CHANGED_BASIC_RATES) {
  794. err = carl9170_set_mac_rates(ar);
  795. if (err)
  796. goto out;
  797. }
  798. out:
  799. WARN_ON_ONCE(err && IS_STARTED(ar));
  800. mutex_unlock(&ar->mutex);
  801. }
  802. static u64 carl9170_op_get_tsf(struct ieee80211_hw *hw)
  803. {
  804. struct ar9170 *ar = hw->priv;
  805. struct carl9170_tsf_rsp tsf;
  806. int err;
  807. mutex_lock(&ar->mutex);
  808. err = carl9170_exec_cmd(ar, CARL9170_CMD_READ_TSF,
  809. 0, NULL, sizeof(tsf), &tsf);
  810. mutex_unlock(&ar->mutex);
  811. if (WARN_ON(err))
  812. return 0;
  813. return le64_to_cpu(tsf.tsf_64);
  814. }
  815. static int carl9170_op_set_key(struct ieee80211_hw *hw, enum set_key_cmd cmd,
  816. struct ieee80211_vif *vif,
  817. struct ieee80211_sta *sta,
  818. struct ieee80211_key_conf *key)
  819. {
  820. struct ar9170 *ar = hw->priv;
  821. int err = 0, i;
  822. u8 ktype;
  823. if (ar->disable_offload || !vif)
  824. return -EOPNOTSUPP;
  825. /*
  826. * We have to fall back to software encryption, whenever
  827. * the user choose to participates in an IBSS or is connected
  828. * to more than one network.
  829. *
  830. * This is very unfortunate, because some machines cannot handle
  831. * the high througput speed in 802.11n networks.
  832. */
  833. if (!is_main_vif(ar, vif))
  834. goto err_softw;
  835. /*
  836. * While the hardware supports *catch-all* key, for offloading
  837. * group-key en-/de-cryption. The way of how the hardware
  838. * decides which keyId maps to which key, remains a mystery...
  839. */
  840. if ((vif->type != NL80211_IFTYPE_STATION &&
  841. vif->type != NL80211_IFTYPE_ADHOC) &&
  842. !(key->flags & IEEE80211_KEY_FLAG_PAIRWISE))
  843. return -EOPNOTSUPP;
  844. switch (key->cipher) {
  845. case WLAN_CIPHER_SUITE_WEP40:
  846. ktype = AR9170_ENC_ALG_WEP64;
  847. break;
  848. case WLAN_CIPHER_SUITE_WEP104:
  849. ktype = AR9170_ENC_ALG_WEP128;
  850. break;
  851. case WLAN_CIPHER_SUITE_TKIP:
  852. ktype = AR9170_ENC_ALG_TKIP;
  853. break;
  854. case WLAN_CIPHER_SUITE_CCMP:
  855. ktype = AR9170_ENC_ALG_AESCCMP;
  856. break;
  857. default:
  858. return -EOPNOTSUPP;
  859. }
  860. mutex_lock(&ar->mutex);
  861. if (cmd == SET_KEY) {
  862. if (!IS_STARTED(ar)) {
  863. err = -EOPNOTSUPP;
  864. goto out;
  865. }
  866. if (!(key->flags & IEEE80211_KEY_FLAG_PAIRWISE)) {
  867. sta = NULL;
  868. i = 64 + key->keyidx;
  869. } else {
  870. for (i = 0; i < 64; i++)
  871. if (!(ar->usedkeys & BIT(i)))
  872. break;
  873. if (i == 64)
  874. goto err_softw;
  875. }
  876. key->hw_key_idx = i;
  877. err = carl9170_upload_key(ar, i, sta ? sta->addr : NULL,
  878. ktype, 0, key->key,
  879. min_t(u8, 16, key->keylen));
  880. if (err)
  881. goto out;
  882. if (key->cipher == WLAN_CIPHER_SUITE_TKIP) {
  883. err = carl9170_upload_key(ar, i, sta ? sta->addr :
  884. NULL, ktype, 1,
  885. key->key + 16, 16);
  886. if (err)
  887. goto out;
  888. /*
  889. * hardware is not capable generating MMIC
  890. * of fragmented frames!
  891. */
  892. key->flags |= IEEE80211_KEY_FLAG_GENERATE_MMIC;
  893. }
  894. if (i < 64)
  895. ar->usedkeys |= BIT(i);
  896. key->flags |= IEEE80211_KEY_FLAG_GENERATE_IV;
  897. } else {
  898. if (!IS_STARTED(ar)) {
  899. /* The device is gone... together with the key ;-) */
  900. err = 0;
  901. goto out;
  902. }
  903. if (key->hw_key_idx < 64) {
  904. ar->usedkeys &= ~BIT(key->hw_key_idx);
  905. } else {
  906. err = carl9170_upload_key(ar, key->hw_key_idx, NULL,
  907. AR9170_ENC_ALG_NONE, 0,
  908. NULL, 0);
  909. if (err)
  910. goto out;
  911. if (key->cipher == WLAN_CIPHER_SUITE_TKIP) {
  912. err = carl9170_upload_key(ar, key->hw_key_idx,
  913. NULL,
  914. AR9170_ENC_ALG_NONE,
  915. 1, NULL, 0);
  916. if (err)
  917. goto out;
  918. }
  919. }
  920. err = carl9170_disable_key(ar, key->hw_key_idx);
  921. if (err)
  922. goto out;
  923. }
  924. out:
  925. mutex_unlock(&ar->mutex);
  926. return err;
  927. err_softw:
  928. if (!ar->rx_software_decryption) {
  929. ar->rx_software_decryption = true;
  930. carl9170_set_operating_mode(ar);
  931. }
  932. mutex_unlock(&ar->mutex);
  933. return -ENOSPC;
  934. }
  935. static int carl9170_op_sta_add(struct ieee80211_hw *hw,
  936. struct ieee80211_vif *vif,
  937. struct ieee80211_sta *sta)
  938. {
  939. struct carl9170_sta_info *sta_info = (void *) sta->drv_priv;
  940. unsigned int i;
  941. if (sta->ht_cap.ht_supported) {
  942. if (sta->ht_cap.ampdu_density > 6) {
  943. /*
  944. * HW does support 16us AMPDU density.
  945. * No HT-Xmit for station.
  946. */
  947. return 0;
  948. }
  949. for (i = 0; i < CARL9170_NUM_TID; i++)
  950. rcu_assign_pointer(sta_info->agg[i], NULL);
  951. sta_info->ampdu_max_len = 1 << (3 + sta->ht_cap.ampdu_factor);
  952. sta_info->ht_sta = true;
  953. }
  954. return 0;
  955. }
  956. static int carl9170_op_sta_remove(struct ieee80211_hw *hw,
  957. struct ieee80211_vif *vif,
  958. struct ieee80211_sta *sta)
  959. {
  960. struct ar9170 *ar = hw->priv;
  961. struct carl9170_sta_info *sta_info = (void *) sta->drv_priv;
  962. unsigned int i;
  963. bool cleanup = false;
  964. if (sta->ht_cap.ht_supported) {
  965. sta_info->ht_sta = false;
  966. rcu_read_lock();
  967. for (i = 0; i < CARL9170_NUM_TID; i++) {
  968. struct carl9170_sta_tid *tid_info;
  969. tid_info = rcu_dereference(sta_info->agg[i]);
  970. rcu_assign_pointer(sta_info->agg[i], NULL);
  971. if (!tid_info)
  972. continue;
  973. spin_lock_bh(&ar->tx_ampdu_list_lock);
  974. if (tid_info->state > CARL9170_TID_STATE_SHUTDOWN)
  975. tid_info->state = CARL9170_TID_STATE_SHUTDOWN;
  976. spin_unlock_bh(&ar->tx_ampdu_list_lock);
  977. cleanup = true;
  978. }
  979. rcu_read_unlock();
  980. if (cleanup)
  981. carl9170_ampdu_gc(ar);
  982. }
  983. return 0;
  984. }
  985. static int carl9170_op_conf_tx(struct ieee80211_hw *hw, u16 queue,
  986. const struct ieee80211_tx_queue_params *param)
  987. {
  988. struct ar9170 *ar = hw->priv;
  989. int ret;
  990. mutex_lock(&ar->mutex);
  991. if (queue < ar->hw->queues) {
  992. memcpy(&ar->edcf[ar9170_qmap[queue]], param, sizeof(*param));
  993. ret = carl9170_set_qos(ar);
  994. } else {
  995. ret = -EINVAL;
  996. }
  997. mutex_unlock(&ar->mutex);
  998. return ret;
  999. }
  1000. static void carl9170_ampdu_work(struct work_struct *work)
  1001. {
  1002. struct ar9170 *ar = container_of(work, struct ar9170,
  1003. ampdu_work);
  1004. if (!IS_STARTED(ar))
  1005. return;
  1006. mutex_lock(&ar->mutex);
  1007. carl9170_ampdu_gc(ar);
  1008. mutex_unlock(&ar->mutex);
  1009. }
  1010. static int carl9170_op_ampdu_action(struct ieee80211_hw *hw,
  1011. struct ieee80211_vif *vif,
  1012. enum ieee80211_ampdu_mlme_action action,
  1013. struct ieee80211_sta *sta,
  1014. u16 tid, u16 *ssn)
  1015. {
  1016. struct ar9170 *ar = hw->priv;
  1017. struct carl9170_sta_info *sta_info = (void *) sta->drv_priv;
  1018. struct carl9170_sta_tid *tid_info;
  1019. if (modparam_noht)
  1020. return -EOPNOTSUPP;
  1021. switch (action) {
  1022. case IEEE80211_AMPDU_TX_START:
  1023. if (!sta_info->ht_sta)
  1024. return -EOPNOTSUPP;
  1025. rcu_read_lock();
  1026. if (rcu_dereference(sta_info->agg[tid])) {
  1027. rcu_read_unlock();
  1028. return -EBUSY;
  1029. }
  1030. tid_info = kzalloc(sizeof(struct carl9170_sta_tid),
  1031. GFP_ATOMIC);
  1032. if (!tid_info) {
  1033. rcu_read_unlock();
  1034. return -ENOMEM;
  1035. }
  1036. tid_info->hsn = tid_info->bsn = tid_info->snx = (*ssn);
  1037. tid_info->state = CARL9170_TID_STATE_PROGRESS;
  1038. tid_info->tid = tid;
  1039. tid_info->max = sta_info->ampdu_max_len;
  1040. INIT_LIST_HEAD(&tid_info->list);
  1041. INIT_LIST_HEAD(&tid_info->tmp_list);
  1042. skb_queue_head_init(&tid_info->queue);
  1043. spin_lock_init(&tid_info->lock);
  1044. spin_lock_bh(&ar->tx_ampdu_list_lock);
  1045. ar->tx_ampdu_list_len++;
  1046. list_add_tail_rcu(&tid_info->list, &ar->tx_ampdu_list);
  1047. rcu_assign_pointer(sta_info->agg[tid], tid_info);
  1048. spin_unlock_bh(&ar->tx_ampdu_list_lock);
  1049. rcu_read_unlock();
  1050. ieee80211_start_tx_ba_cb_irqsafe(vif, sta->addr, tid);
  1051. break;
  1052. case IEEE80211_AMPDU_TX_STOP:
  1053. rcu_read_lock();
  1054. tid_info = rcu_dereference(sta_info->agg[tid]);
  1055. if (tid_info) {
  1056. spin_lock_bh(&ar->tx_ampdu_list_lock);
  1057. if (tid_info->state > CARL9170_TID_STATE_SHUTDOWN)
  1058. tid_info->state = CARL9170_TID_STATE_SHUTDOWN;
  1059. spin_unlock_bh(&ar->tx_ampdu_list_lock);
  1060. }
  1061. rcu_assign_pointer(sta_info->agg[tid], NULL);
  1062. rcu_read_unlock();
  1063. ieee80211_stop_tx_ba_cb_irqsafe(vif, sta->addr, tid);
  1064. ieee80211_queue_work(ar->hw, &ar->ampdu_work);
  1065. break;
  1066. case IEEE80211_AMPDU_TX_OPERATIONAL:
  1067. rcu_read_lock();
  1068. tid_info = rcu_dereference(sta_info->agg[tid]);
  1069. sta_info->stats[tid].clear = true;
  1070. if (tid_info) {
  1071. bitmap_zero(tid_info->bitmap, CARL9170_BAW_SIZE);
  1072. tid_info->state = CARL9170_TID_STATE_IDLE;
  1073. }
  1074. rcu_read_unlock();
  1075. if (WARN_ON_ONCE(!tid_info))
  1076. return -EFAULT;
  1077. break;
  1078. case IEEE80211_AMPDU_RX_START:
  1079. case IEEE80211_AMPDU_RX_STOP:
  1080. /* Handled by hardware */
  1081. break;
  1082. default:
  1083. return -EOPNOTSUPP;
  1084. }
  1085. return 0;
  1086. }
  1087. #ifdef CONFIG_CARL9170_WPC
  1088. static int carl9170_register_wps_button(struct ar9170 *ar)
  1089. {
  1090. struct input_dev *input;
  1091. int err;
  1092. if (!(ar->features & CARL9170_WPS_BUTTON))
  1093. return 0;
  1094. input = input_allocate_device();
  1095. if (!input)
  1096. return -ENOMEM;
  1097. snprintf(ar->wps.name, sizeof(ar->wps.name), "%s WPS Button",
  1098. wiphy_name(ar->hw->wiphy));
  1099. snprintf(ar->wps.phys, sizeof(ar->wps.phys),
  1100. "ieee80211/%s/input0", wiphy_name(ar->hw->wiphy));
  1101. input->name = ar->wps.name;
  1102. input->phys = ar->wps.phys;
  1103. input->id.bustype = BUS_USB;
  1104. input->dev.parent = &ar->hw->wiphy->dev;
  1105. input_set_capability(input, EV_KEY, KEY_WPS_BUTTON);
  1106. err = input_register_device(input);
  1107. if (err) {
  1108. input_free_device(input);
  1109. return err;
  1110. }
  1111. ar->wps.pbc = input;
  1112. return 0;
  1113. }
  1114. #endif /* CONFIG_CARL9170_WPC */
  1115. static int carl9170_op_get_survey(struct ieee80211_hw *hw, int idx,
  1116. struct survey_info *survey)
  1117. {
  1118. struct ar9170 *ar = hw->priv;
  1119. int err;
  1120. if (idx != 0)
  1121. return -ENOENT;
  1122. mutex_lock(&ar->mutex);
  1123. err = carl9170_get_noisefloor(ar);
  1124. mutex_unlock(&ar->mutex);
  1125. if (err)
  1126. return err;
  1127. survey->channel = ar->channel;
  1128. survey->filled = SURVEY_INFO_NOISE_DBM;
  1129. survey->noise = ar->noise[0];
  1130. return 0;
  1131. }
  1132. static void carl9170_op_flush(struct ieee80211_hw *hw, bool drop)
  1133. {
  1134. struct ar9170 *ar = hw->priv;
  1135. unsigned int vid;
  1136. mutex_lock(&ar->mutex);
  1137. for_each_set_bit(vid, &ar->vif_bitmap, ar->fw.vif_num)
  1138. carl9170_flush_cab(ar, vid);
  1139. carl9170_flush(ar, drop);
  1140. mutex_unlock(&ar->mutex);
  1141. }
  1142. static int carl9170_op_get_stats(struct ieee80211_hw *hw,
  1143. struct ieee80211_low_level_stats *stats)
  1144. {
  1145. struct ar9170 *ar = hw->priv;
  1146. memset(stats, 0, sizeof(*stats));
  1147. stats->dot11ACKFailureCount = ar->tx_ack_failures;
  1148. stats->dot11FCSErrorCount = ar->tx_fcs_errors;
  1149. return 0;
  1150. }
  1151. static void carl9170_op_sta_notify(struct ieee80211_hw *hw,
  1152. struct ieee80211_vif *vif,
  1153. enum sta_notify_cmd cmd,
  1154. struct ieee80211_sta *sta)
  1155. {
  1156. struct ar9170 *ar = hw->priv;
  1157. struct carl9170_sta_info *sta_info = (void *) sta->drv_priv;
  1158. struct sk_buff *skb, *tmp;
  1159. struct sk_buff_head free;
  1160. int i;
  1161. switch (cmd) {
  1162. case STA_NOTIFY_SLEEP:
  1163. /*
  1164. * Since the peer is no longer listening, we have to return
  1165. * as many SKBs as possible back to the mac80211 stack.
  1166. * It will deal with the retry procedure, once the peer
  1167. * has become available again.
  1168. *
  1169. * NB: Ideally, the driver should return the all frames in
  1170. * the correct, ascending order. However, I think that this
  1171. * functionality should be implemented in the stack and not
  1172. * here...
  1173. */
  1174. __skb_queue_head_init(&free);
  1175. if (sta->ht_cap.ht_supported) {
  1176. rcu_read_lock();
  1177. for (i = 0; i < CARL9170_NUM_TID; i++) {
  1178. struct carl9170_sta_tid *tid_info;
  1179. tid_info = rcu_dereference(sta_info->agg[i]);
  1180. if (!tid_info)
  1181. continue;
  1182. spin_lock_bh(&ar->tx_ampdu_list_lock);
  1183. if (tid_info->state >
  1184. CARL9170_TID_STATE_SUSPEND)
  1185. tid_info->state =
  1186. CARL9170_TID_STATE_SUSPEND;
  1187. spin_unlock_bh(&ar->tx_ampdu_list_lock);
  1188. spin_lock_bh(&tid_info->lock);
  1189. while ((skb = __skb_dequeue(&tid_info->queue)))
  1190. __skb_queue_tail(&free, skb);
  1191. spin_unlock_bh(&tid_info->lock);
  1192. }
  1193. rcu_read_unlock();
  1194. }
  1195. for (i = 0; i < ar->hw->queues; i++) {
  1196. spin_lock_bh(&ar->tx_pending[i].lock);
  1197. skb_queue_walk_safe(&ar->tx_pending[i], skb, tmp) {
  1198. struct _carl9170_tx_superframe *super;
  1199. struct ieee80211_hdr *hdr;
  1200. struct ieee80211_tx_info *info;
  1201. super = (void *) skb->data;
  1202. hdr = (void *) super->frame_data;
  1203. if (compare_ether_addr(hdr->addr1, sta->addr))
  1204. continue;
  1205. __skb_unlink(skb, &ar->tx_pending[i]);
  1206. info = IEEE80211_SKB_CB(skb);
  1207. if (info->flags & IEEE80211_TX_CTL_AMPDU)
  1208. atomic_dec(&ar->tx_ampdu_upload);
  1209. carl9170_tx_status(ar, skb, false);
  1210. }
  1211. spin_unlock_bh(&ar->tx_pending[i].lock);
  1212. }
  1213. while ((skb = __skb_dequeue(&free)))
  1214. carl9170_tx_status(ar, skb, false);
  1215. break;
  1216. case STA_NOTIFY_AWAKE:
  1217. if (!sta->ht_cap.ht_supported)
  1218. return;
  1219. rcu_read_lock();
  1220. for (i = 0; i < CARL9170_NUM_TID; i++) {
  1221. struct carl9170_sta_tid *tid_info;
  1222. tid_info = rcu_dereference(sta_info->agg[i]);
  1223. if (!tid_info)
  1224. continue;
  1225. if ((tid_info->state == CARL9170_TID_STATE_SUSPEND))
  1226. tid_info->state = CARL9170_TID_STATE_IDLE;
  1227. }
  1228. rcu_read_unlock();
  1229. break;
  1230. }
  1231. }
  1232. static const struct ieee80211_ops carl9170_ops = {
  1233. .start = carl9170_op_start,
  1234. .stop = carl9170_op_stop,
  1235. .tx = carl9170_op_tx,
  1236. .flush = carl9170_op_flush,
  1237. .add_interface = carl9170_op_add_interface,
  1238. .remove_interface = carl9170_op_remove_interface,
  1239. .config = carl9170_op_config,
  1240. .prepare_multicast = carl9170_op_prepare_multicast,
  1241. .configure_filter = carl9170_op_configure_filter,
  1242. .conf_tx = carl9170_op_conf_tx,
  1243. .bss_info_changed = carl9170_op_bss_info_changed,
  1244. .get_tsf = carl9170_op_get_tsf,
  1245. .set_key = carl9170_op_set_key,
  1246. .sta_add = carl9170_op_sta_add,
  1247. .sta_remove = carl9170_op_sta_remove,
  1248. .sta_notify = carl9170_op_sta_notify,
  1249. .get_survey = carl9170_op_get_survey,
  1250. .get_stats = carl9170_op_get_stats,
  1251. .ampdu_action = carl9170_op_ampdu_action,
  1252. };
  1253. void *carl9170_alloc(size_t priv_size)
  1254. {
  1255. struct ieee80211_hw *hw;
  1256. struct ar9170 *ar;
  1257. struct sk_buff *skb;
  1258. int i;
  1259. /*
  1260. * this buffer is used for rx stream reconstruction.
  1261. * Under heavy load this device (or the transport layer?)
  1262. * tends to split the streams into separate rx descriptors.
  1263. */
  1264. skb = __dev_alloc_skb(AR9170_RX_STREAM_MAX_SIZE, GFP_KERNEL);
  1265. if (!skb)
  1266. goto err_nomem;
  1267. hw = ieee80211_alloc_hw(priv_size, &carl9170_ops);
  1268. if (!hw)
  1269. goto err_nomem;
  1270. ar = hw->priv;
  1271. ar->hw = hw;
  1272. ar->rx_failover = skb;
  1273. memset(&ar->rx_plcp, 0, sizeof(struct ar9170_rx_head));
  1274. ar->rx_has_plcp = false;
  1275. /*
  1276. * Here's a hidden pitfall!
  1277. *
  1278. * All 4 AC queues work perfectly well under _legacy_ operation.
  1279. * However as soon as aggregation is enabled, the traffic flow
  1280. * gets very bumpy. Therefore we have to _switch_ to a
  1281. * software AC with a single HW queue.
  1282. */
  1283. hw->queues = __AR9170_NUM_TXQ;
  1284. mutex_init(&ar->mutex);
  1285. spin_lock_init(&ar->beacon_lock);
  1286. spin_lock_init(&ar->cmd_lock);
  1287. spin_lock_init(&ar->tx_stats_lock);
  1288. spin_lock_init(&ar->tx_ampdu_list_lock);
  1289. spin_lock_init(&ar->mem_lock);
  1290. spin_lock_init(&ar->state_lock);
  1291. atomic_set(&ar->pending_restarts, 0);
  1292. ar->vifs = 0;
  1293. for (i = 0; i < ar->hw->queues; i++) {
  1294. skb_queue_head_init(&ar->tx_status[i]);
  1295. skb_queue_head_init(&ar->tx_pending[i]);
  1296. }
  1297. INIT_WORK(&ar->ps_work, carl9170_ps_work);
  1298. INIT_WORK(&ar->restart_work, carl9170_restart_work);
  1299. INIT_WORK(&ar->ampdu_work, carl9170_ampdu_work);
  1300. INIT_DELAYED_WORK(&ar->tx_janitor, carl9170_tx_janitor);
  1301. INIT_LIST_HEAD(&ar->tx_ampdu_list);
  1302. rcu_assign_pointer(ar->tx_ampdu_iter,
  1303. (struct carl9170_sta_tid *) &ar->tx_ampdu_list);
  1304. bitmap_zero(&ar->vif_bitmap, ar->fw.vif_num);
  1305. INIT_LIST_HEAD(&ar->vif_list);
  1306. init_completion(&ar->tx_flush);
  1307. /*
  1308. * Note:
  1309. * IBSS/ADHOC and AP mode are only enabled, if the firmware
  1310. * supports these modes. The code which will add the
  1311. * additional interface_modes is in fw.c.
  1312. */
  1313. hw->wiphy->interface_modes = BIT(NL80211_IFTYPE_STATION);
  1314. hw->flags |= IEEE80211_HW_RX_INCLUDES_FCS |
  1315. IEEE80211_HW_REPORTS_TX_ACK_STATUS |
  1316. IEEE80211_HW_SUPPORTS_PS |
  1317. IEEE80211_HW_PS_NULLFUNC_STACK |
  1318. IEEE80211_HW_SIGNAL_DBM;
  1319. if (!modparam_noht) {
  1320. /*
  1321. * see the comment above, why we allow the user
  1322. * to disable HT by a module parameter.
  1323. */
  1324. hw->flags |= IEEE80211_HW_AMPDU_AGGREGATION;
  1325. }
  1326. hw->extra_tx_headroom = sizeof(struct _carl9170_tx_superframe);
  1327. hw->sta_data_size = sizeof(struct carl9170_sta_info);
  1328. hw->vif_data_size = sizeof(struct carl9170_vif_info);
  1329. hw->max_rates = CARL9170_TX_MAX_RATES;
  1330. hw->max_rate_tries = CARL9170_TX_USER_RATE_TRIES;
  1331. for (i = 0; i < ARRAY_SIZE(ar->noise); i++)
  1332. ar->noise[i] = -95; /* ATH_DEFAULT_NOISE_FLOOR */
  1333. hw->wiphy->flags &= ~WIPHY_FLAG_PS_ON_BY_DEFAULT;
  1334. return ar;
  1335. err_nomem:
  1336. kfree_skb(skb);
  1337. return ERR_PTR(-ENOMEM);
  1338. }
  1339. static int carl9170_read_eeprom(struct ar9170 *ar)
  1340. {
  1341. #define RW 8 /* number of words to read at once */
  1342. #define RB (sizeof(u32) * RW)
  1343. u8 *eeprom = (void *)&ar->eeprom;
  1344. __le32 offsets[RW];
  1345. int i, j, err;
  1346. BUILD_BUG_ON(sizeof(ar->eeprom) & 3);
  1347. BUILD_BUG_ON(RB > CARL9170_MAX_CMD_LEN - 4);
  1348. #ifndef __CHECKER__
  1349. /* don't want to handle trailing remains */
  1350. BUILD_BUG_ON(sizeof(ar->eeprom) % RB);
  1351. #endif
  1352. for (i = 0; i < sizeof(ar->eeprom)/RB; i++) {
  1353. for (j = 0; j < RW; j++)
  1354. offsets[j] = cpu_to_le32(AR9170_EEPROM_START +
  1355. RB * i + 4 * j);
  1356. err = carl9170_exec_cmd(ar, CARL9170_CMD_RREG,
  1357. RB, (u8 *) &offsets,
  1358. RB, eeprom + RB * i);
  1359. if (err)
  1360. return err;
  1361. }
  1362. #undef RW
  1363. #undef RB
  1364. return 0;
  1365. }
  1366. static int carl9170_parse_eeprom(struct ar9170 *ar)
  1367. {
  1368. struct ath_regulatory *regulatory = &ar->common.regulatory;
  1369. unsigned int rx_streams, tx_streams, tx_params = 0;
  1370. int bands = 0;
  1371. if (ar->eeprom.length == cpu_to_le16(0xffff))
  1372. return -ENODATA;
  1373. rx_streams = hweight8(ar->eeprom.rx_mask);
  1374. tx_streams = hweight8(ar->eeprom.tx_mask);
  1375. if (rx_streams != tx_streams) {
  1376. tx_params = IEEE80211_HT_MCS_TX_RX_DIFF;
  1377. WARN_ON(!(tx_streams >= 1 && tx_streams <=
  1378. IEEE80211_HT_MCS_TX_MAX_STREAMS));
  1379. tx_params = (tx_streams - 1) <<
  1380. IEEE80211_HT_MCS_TX_MAX_STREAMS_SHIFT;
  1381. carl9170_band_2GHz.ht_cap.mcs.tx_params |= tx_params;
  1382. carl9170_band_5GHz.ht_cap.mcs.tx_params |= tx_params;
  1383. }
  1384. if (ar->eeprom.operating_flags & AR9170_OPFLAG_2GHZ) {
  1385. ar->hw->wiphy->bands[IEEE80211_BAND_2GHZ] =
  1386. &carl9170_band_2GHz;
  1387. bands++;
  1388. }
  1389. if (ar->eeprom.operating_flags & AR9170_OPFLAG_5GHZ) {
  1390. ar->hw->wiphy->bands[IEEE80211_BAND_5GHZ] =
  1391. &carl9170_band_5GHz;
  1392. bands++;
  1393. }
  1394. /*
  1395. * I measured this, a bandswitch takes roughly
  1396. * 135 ms and a frequency switch about 80.
  1397. *
  1398. * FIXME: measure these values again once EEPROM settings
  1399. * are used, that will influence them!
  1400. */
  1401. if (bands == 2)
  1402. ar->hw->channel_change_time = 135 * 1000;
  1403. else
  1404. ar->hw->channel_change_time = 80 * 1000;
  1405. regulatory->current_rd = le16_to_cpu(ar->eeprom.reg_domain[0]);
  1406. regulatory->current_rd_ext = le16_to_cpu(ar->eeprom.reg_domain[1]);
  1407. /* second part of wiphy init */
  1408. SET_IEEE80211_PERM_ADDR(ar->hw, ar->eeprom.mac_address);
  1409. return bands ? 0 : -EINVAL;
  1410. }
  1411. static int carl9170_reg_notifier(struct wiphy *wiphy,
  1412. struct regulatory_request *request)
  1413. {
  1414. struct ieee80211_hw *hw = wiphy_to_ieee80211_hw(wiphy);
  1415. struct ar9170 *ar = hw->priv;
  1416. return ath_reg_notifier_apply(wiphy, request, &ar->common.regulatory);
  1417. }
  1418. int carl9170_register(struct ar9170 *ar)
  1419. {
  1420. struct ath_regulatory *regulatory = &ar->common.regulatory;
  1421. int err = 0, i;
  1422. if (WARN_ON(ar->mem_bitmap))
  1423. return -EINVAL;
  1424. ar->mem_bitmap = kzalloc(roundup(ar->fw.mem_blocks, BITS_PER_LONG) *
  1425. sizeof(unsigned long), GFP_KERNEL);
  1426. if (!ar->mem_bitmap)
  1427. return -ENOMEM;
  1428. /* try to read EEPROM, init MAC addr */
  1429. err = carl9170_read_eeprom(ar);
  1430. if (err)
  1431. return err;
  1432. err = carl9170_fw_fix_eeprom(ar);
  1433. if (err)
  1434. return err;
  1435. err = carl9170_parse_eeprom(ar);
  1436. if (err)
  1437. return err;
  1438. err = ath_regd_init(regulatory, ar->hw->wiphy,
  1439. carl9170_reg_notifier);
  1440. if (err)
  1441. return err;
  1442. if (modparam_noht) {
  1443. carl9170_band_2GHz.ht_cap.ht_supported = false;
  1444. carl9170_band_5GHz.ht_cap.ht_supported = false;
  1445. }
  1446. for (i = 0; i < ar->fw.vif_num; i++) {
  1447. ar->vif_priv[i].id = i;
  1448. ar->vif_priv[i].vif = NULL;
  1449. }
  1450. err = ieee80211_register_hw(ar->hw);
  1451. if (err)
  1452. return err;
  1453. /* mac80211 interface is now registered */
  1454. ar->registered = true;
  1455. if (!ath_is_world_regd(regulatory))
  1456. regulatory_hint(ar->hw->wiphy, regulatory->alpha2);
  1457. #ifdef CONFIG_CARL9170_DEBUGFS
  1458. carl9170_debugfs_register(ar);
  1459. #endif /* CONFIG_CARL9170_DEBUGFS */
  1460. err = carl9170_led_init(ar);
  1461. if (err)
  1462. goto err_unreg;
  1463. #ifdef CONFIG_CARL9170_LEDS
  1464. err = carl9170_led_register(ar);
  1465. if (err)
  1466. goto err_unreg;
  1467. #endif /* CONFIG_CAR9L170_LEDS */
  1468. #ifdef CONFIG_CARL9170_WPC
  1469. err = carl9170_register_wps_button(ar);
  1470. if (err)
  1471. goto err_unreg;
  1472. #endif /* CONFIG_CARL9170_WPC */
  1473. dev_info(&ar->udev->dev, "Atheros AR9170 is registered as '%s'\n",
  1474. wiphy_name(ar->hw->wiphy));
  1475. return 0;
  1476. err_unreg:
  1477. carl9170_unregister(ar);
  1478. return err;
  1479. }
  1480. void carl9170_unregister(struct ar9170 *ar)
  1481. {
  1482. if (!ar->registered)
  1483. return;
  1484. ar->registered = false;
  1485. #ifdef CONFIG_CARL9170_LEDS
  1486. carl9170_led_unregister(ar);
  1487. #endif /* CONFIG_CARL9170_LEDS */
  1488. #ifdef CONFIG_CARL9170_DEBUGFS
  1489. carl9170_debugfs_unregister(ar);
  1490. #endif /* CONFIG_CARL9170_DEBUGFS */
  1491. #ifdef CONFIG_CARL9170_WPC
  1492. if (ar->wps.pbc) {
  1493. input_unregister_device(ar->wps.pbc);
  1494. ar->wps.pbc = NULL;
  1495. }
  1496. #endif /* CONFIG_CARL9170_WPC */
  1497. carl9170_cancel_worker(ar);
  1498. cancel_work_sync(&ar->restart_work);
  1499. ieee80211_unregister_hw(ar->hw);
  1500. }
  1501. void carl9170_free(struct ar9170 *ar)
  1502. {
  1503. WARN_ON(ar->registered);
  1504. WARN_ON(IS_INITIALIZED(ar));
  1505. kfree_skb(ar->rx_failover);
  1506. ar->rx_failover = NULL;
  1507. kfree(ar->mem_bitmap);
  1508. ar->mem_bitmap = NULL;
  1509. mutex_destroy(&ar->mutex);
  1510. ieee80211_free_hw(ar->hw);
  1511. }