projects / deliverable / linux.git / blob
? search:


037993544764e2415f561227199d8219c9287170
[deliverable/linux.git] / drivers / net / wireless / ath / wil6210 / wmi.c
1 /*
2 * Copyright (c) 2012 Qualcomm Atheros, Inc.
3 *
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
7 *
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 */
16
17 #include <linux/etherdevice.h>
18 #include <linux/if_arp.h>
19
20 #include "wil6210.h"
21 #include "txrx.h"
22 #include "wmi.h"
23 #include "trace.h"
24
25 /**
26 * WMI event receiving - theory of operations
27 *
28 * When firmware about to report WMI event, it fills memory area
29 * in the mailbox and raises misc. IRQ. Thread interrupt handler invoked for
30 * the misc IRQ, function @wmi_recv_cmd called by thread IRQ handler.
31 *
32 * @wmi_recv_cmd reads event, allocates memory chunk and attaches it to the
33 * event list @wil->pending_wmi_ev. Then, work queue @wil->wmi_wq wakes up
34 * and handles events within the @wmi_event_worker. Every event get detached
35 * from list, processed and deleted.
36 *
37 * Purpose for this mechanism is to release IRQ thread; otherwise,
38 * if WMI event handling involves another WMI command flow, this 2-nd flow
39 * won't be completed because of blocked IRQ thread.
40 */
41
42 /**
43 * Addressing - theory of operations
44 *
45 * There are several buses present on the WIL6210 card.
46 * Same memory areas are visible at different address on
47 * the different busses. There are 3 main bus masters:
48 * - MAC CPU (ucode)
49 * - User CPU (firmware)
50 * - AHB (host)
51 *
52 * On the PCI bus, there is one BAR (BAR0) of 2Mb size, exposing
53 * AHB addresses starting from 0x880000
54 *
55 * Internally, firmware uses addresses that allows faster access but
56 * are invisible from the host. To read from these addresses, alternative
57 * AHB address must be used.
58 *
59 * Memory mapping
60 * Linker address PCI/Host address
61 * 0x880000 .. 0xa80000 2Mb BAR0
62 * 0x800000 .. 0x807000 0x900000 .. 0x907000 28k DCCM
63 * 0x840000 .. 0x857000 0x908000 .. 0x91f000 92k PERIPH
64 */
65
66 /**
67 * @fw_mapping provides memory remapping table
68 */
69 static const struct {
70 u32 from; /* linker address - from, inclusive */
71 u32 to; /* linker address - to, exclusive */
72 u32 host; /* PCI/Host address - BAR0 + 0x880000 */
73 } fw_mapping[] = {
74 {0x000000, 0x040000, 0x8c0000}, /* FW code RAM 256k */
75 {0x800000, 0x808000, 0x900000}, /* FW data RAM 32k */
76 {0x840000, 0x860000, 0x908000}, /* peripheral data RAM 128k/96k used */
77 {0x880000, 0x88a000, 0x880000}, /* various RGF */
78 {0x8c0000, 0x949000, 0x8c0000}, /* trivial mapping for upper area */
79 /*
80 * 920000..930000 ucode code RAM
81 * 930000..932000 ucode data RAM
82 * 932000..949000 back-door debug data
83 */
84 };
85
86 /**
87 * return AHB address for given firmware/ucode internal (linker) address
88 * @x - internal address
89 * If address have no valid AHB mapping, return 0
90 */
91 static u32 wmi_addr_remap(u32 x)
92 {
93 uint i;
94
95 for (i = 0; i < ARRAY_SIZE(fw_mapping); i++) {
96 if ((x >= fw_mapping[i].from) && (x < fw_mapping[i].to))
97 return x + fw_mapping[i].host - fw_mapping[i].from;
98 }
99
100 return 0;
101 }
102
103 /**
104 * Check address validity for WMI buffer; remap if needed
105 * @ptr - internal (linker) fw/ucode address
106 *
107 * Valid buffer should be DWORD aligned
108 *
109 * return address for accessing buffer from the host;
110 * if buffer is not valid, return NULL.
111 */
112 void __iomem *wmi_buffer(struct wil6210_priv *wil, __le32 ptr_)
113 {
114 u32 off;
115 u32 ptr = le32_to_cpu(ptr_);
116
117 if (ptr % 4)
118 return NULL;
119
120 ptr = wmi_addr_remap(ptr);
121 if (ptr < WIL6210_FW_HOST_OFF)
122 return NULL;
123
124 off = HOSTADDR(ptr);
125 if (off > WIL6210_MEM_SIZE - 4)
126 return NULL;
127
128 return wil->csr + off;
129 }
130
131 /**
132 * Check address validity
133 */
134 void __iomem *wmi_addr(struct wil6210_priv *wil, u32 ptr)
135 {
136 u32 off;
137
138 if (ptr % 4)
139 return NULL;
140
141 if (ptr < WIL6210_FW_HOST_OFF)
142 return NULL;
143
144 off = HOSTADDR(ptr);
145 if (off > WIL6210_MEM_SIZE - 4)
146 return NULL;
147
148 return wil->csr + off;
149 }
150
151 int wmi_read_hdr(struct wil6210_priv *wil, __le32 ptr,
152 struct wil6210_mbox_hdr *hdr)
153 {
154 void __iomem *src = wmi_buffer(wil, ptr);
155 if (!src)
156 return -EINVAL;
157
158 wil_memcpy_fromio_32(hdr, src, sizeof(*hdr));
159
160 return 0;
161 }
162
163 static int __wmi_send(struct wil6210_priv *wil, u16 cmdid, void *buf, u16 len)
164 {
165 struct {
166 struct wil6210_mbox_hdr hdr;
167 struct wil6210_mbox_hdr_wmi wmi;
168 } __packed cmd = {
169 .hdr = {
170 .type = WIL_MBOX_HDR_TYPE_WMI,
171 .flags = 0,
172 .len = cpu_to_le16(sizeof(cmd.wmi) + len),
173 },
174 .wmi = {
175 .mid = 0,
176 .id = cpu_to_le16(cmdid),
177 },
178 };
179 struct wil6210_mbox_ring *r = &wil->mbox_ctl.tx;
180 struct wil6210_mbox_ring_desc d_head;
181 u32 next_head;
182 void __iomem *dst;
183 void __iomem *head = wmi_addr(wil, r->head);
184 uint retry;
185
186 if (sizeof(cmd) + len > r->entry_size) {
187 wil_err(wil, "WMI size too large: %d bytes, max is %d\n",
188 (int)(sizeof(cmd) + len), r->entry_size);
189 return -ERANGE;
190 }
191
192 might_sleep();
193
194 if (!test_bit(wil_status_fwready, &wil->status)) {
195 wil_err(wil, "WMI: cannot send command while FW not ready\n");
196 return -EAGAIN;
197 }
198
199 if (!head) {
200 wil_err(wil, "WMI head is garbage: 0x%08x\n", r->head);
201 return -EINVAL;
202 }
203 /* read Tx head till it is not busy */
204 for (retry = 5; retry > 0; retry--) {
205 wil_memcpy_fromio_32(&d_head, head, sizeof(d_head));
206 if (d_head.sync == 0)
207 break;
208 msleep(20);
209 }
210 if (d_head.sync != 0) {
211 wil_err(wil, "WMI head busy\n");
212 return -EBUSY;
213 }
214 /* next head */
215 next_head = r->base + ((r->head - r->base + sizeof(d_head)) % r->size);
216 wil_dbg_wmi(wil, "Head 0x%08x -> 0x%08x\n", r->head, next_head);
217 /* wait till FW finish with previous command */
218 for (retry = 5; retry > 0; retry--) {
219 r->tail = ioread32(wil->csr + HOST_MBOX +
220 offsetof(struct wil6210_mbox_ctl, tx.tail));
221 if (next_head != r->tail)
222 break;
223 msleep(20);
224 }
225 if (next_head == r->tail) {
226 wil_err(wil, "WMI ring full\n");
227 return -EBUSY;
228 }
229 dst = wmi_buffer(wil, d_head.addr);
230 if (!dst) {
231 wil_err(wil, "invalid WMI buffer: 0x%08x\n",
232 le32_to_cpu(d_head.addr));
233 return -EINVAL;
234 }
235 cmd.hdr.seq = cpu_to_le16(++wil->wmi_seq);
236 /* set command */
237 wil_dbg_wmi(wil, "WMI command 0x%04x [%d]\n", cmdid, len);
238 wil_hex_dump_wmi("Cmd ", DUMP_PREFIX_OFFSET, 16, 1, &cmd,
239 sizeof(cmd), true);
240 wil_hex_dump_wmi("cmd ", DUMP_PREFIX_OFFSET, 16, 1, buf,
241 len, true);
242 wil_memcpy_toio_32(dst, &cmd, sizeof(cmd));
243 wil_memcpy_toio_32(dst + sizeof(cmd), buf, len);
244 /* mark entry as full */
245 iowrite32(1, wil->csr + HOSTADDR(r->head) +
246 offsetof(struct wil6210_mbox_ring_desc, sync));
247 /* advance next ptr */
248 iowrite32(r->head = next_head, wil->csr + HOST_MBOX +
249 offsetof(struct wil6210_mbox_ctl, tx.head));
250
251 trace_wil6210_wmi_cmd(&cmd.wmi, buf, len);
252
253 /* interrupt to FW */
254 iowrite32(SW_INT_MBOX, wil->csr + HOST_SW_INT);
255
256 return 0;
257 }
258
259 int wmi_send(struct wil6210_priv *wil, u16 cmdid, void *buf, u16 len)
260 {
261 int rc;
262
263 mutex_lock(&wil->wmi_mutex);
264 rc = __wmi_send(wil, cmdid, buf, len);
265 mutex_unlock(&wil->wmi_mutex);
266
267 return rc;
268 }
269
270 /*=== Event handlers ===*/
271 static void wmi_evt_ready(struct wil6210_priv *wil, int id, void *d, int len)
272 {
273 struct net_device *ndev = wil_to_ndev(wil);
274 struct wireless_dev *wdev = wil->wdev;
275 struct wmi_ready_event *evt = d;
276 wil->fw_version = le32_to_cpu(evt->sw_version);
277 wil->n_mids = evt->numof_additional_mids;
278
279 wil_info(wil, "FW ver. %d; MAC %pM; %d MID's\n", wil->fw_version,
280 evt->mac, wil->n_mids);
281
282 if (!is_valid_ether_addr(ndev->dev_addr)) {
283 memcpy(ndev->dev_addr, evt->mac, ETH_ALEN);
284 memcpy(ndev->perm_addr, evt->mac, ETH_ALEN);
285 }
286 snprintf(wdev->wiphy->fw_version, sizeof(wdev->wiphy->fw_version),
287 "%d", wil->fw_version);
288 }
289
290 static void wmi_evt_fw_ready(struct wil6210_priv *wil, int id, void *d,
291 int len)
292 {
293 wil_dbg_wmi(wil, "WMI: got FW ready event\n");
294
295 set_bit(wil_status_fwready, &wil->status);
296 /* reuse wmi_ready for the firmware ready indication */
297 complete(&wil->wmi_ready);
298 }
299
300 static void wmi_evt_rx_mgmt(struct wil6210_priv *wil, int id, void *d, int len)
301 {
302 struct wmi_rx_mgmt_packet_event *data = d;
303 struct wiphy *wiphy = wil_to_wiphy(wil);
304 struct ieee80211_mgmt *rx_mgmt_frame =
305 (struct ieee80211_mgmt *)data->payload;
306 int ch_no = data->info.channel+1;
307 u32 freq = ieee80211_channel_to_frequency(ch_no,
308 IEEE80211_BAND_60GHZ);
309 struct ieee80211_channel *channel = ieee80211_get_channel(wiphy, freq);
310 s32 signal = data->info.sqi;
311 __le16 fc = rx_mgmt_frame->frame_control;
312 u32 d_len = le32_to_cpu(data->info.len);
313 u16 d_status = le16_to_cpu(data->info.status);
314
315 wil_dbg_wmi(wil, "MGMT: channel %d MCS %d SNR %d SQI %d%%\n",
316 data->info.channel, data->info.mcs, data->info.snr,
317 data->info.sqi);
318 wil_dbg_wmi(wil, "status 0x%04x len %d fc 0x%04x\n", d_status, d_len,
319 le16_to_cpu(fc));
320 wil_dbg_wmi(wil, "qid %d mid %d cid %d\n",
321 data->info.qid, data->info.mid, data->info.cid);
322
323 if (!channel) {
324 wil_err(wil, "Frame on unsupported channel\n");
325 return;
326 }
327
328 if (ieee80211_is_beacon(fc) || ieee80211_is_probe_resp(fc)) {
329 struct cfg80211_bss *bss;
330
331 bss = cfg80211_inform_bss_frame(wiphy, channel, rx_mgmt_frame,
332 d_len, signal, GFP_KERNEL);
333 if (bss) {
334 wil_dbg_wmi(wil, "Added BSS %pM\n",
335 rx_mgmt_frame->bssid);
336 cfg80211_put_bss(wiphy, bss);
337 } else {
338 wil_err(wil, "cfg80211_inform_bss() failed\n");
339 }
340 } else {
341 cfg80211_rx_mgmt(wil->wdev, freq, signal,
342 (void *)rx_mgmt_frame, d_len, 0, GFP_KERNEL);
343 }
344 }
345
346 static void wmi_evt_scan_complete(struct wil6210_priv *wil, int id,
347 void *d, int len)
348 {
349 if (wil->scan_request) {
350 struct wmi_scan_complete_event *data = d;
351 bool aborted = (data->status != WMI_SCAN_SUCCESS);
352
353 wil_dbg_wmi(wil, "SCAN_COMPLETE(0x%08x)\n", data->status);
354 del_timer_sync(&wil->scan_timer);
355 cfg80211_scan_done(wil->scan_request, aborted);
356 wil->scan_request = NULL;
357 } else {
358 wil_err(wil, "SCAN_COMPLETE while not scanning\n");
359 }
360 }
361
362 static void wmi_evt_connect(struct wil6210_priv *wil, int id, void *d, int len)
363 {
364 struct net_device *ndev = wil_to_ndev(wil);
365 struct wireless_dev *wdev = wil->wdev;
366 struct wmi_connect_event *evt = d;
367 int ch; /* channel number */
368 struct station_info sinfo;
369 u8 *assoc_req_ie, *assoc_resp_ie;
370 size_t assoc_req_ielen, assoc_resp_ielen;
371 /* capinfo(u16) + listen_interval(u16) + IEs */
372 const size_t assoc_req_ie_offset = sizeof(u16) * 2;
373 /* capinfo(u16) + status_code(u16) + associd(u16) + IEs */
374 const size_t assoc_resp_ie_offset = sizeof(u16) * 3;
375
376 if (len < sizeof(*evt)) {
377 wil_err(wil, "Connect event too short : %d bytes\n", len);
378 return;
379 }
380 if (len != sizeof(*evt) + evt->beacon_ie_len + evt->assoc_req_len +
381 evt->assoc_resp_len) {
382 wil_err(wil,
383 "Connect event corrupted : %d != %d + %d + %d + %d\n",
384 len, (int)sizeof(*evt), evt->beacon_ie_len,
385 evt->assoc_req_len, evt->assoc_resp_len);
386 return;
387 }
388 if (evt->cid >= WIL6210_MAX_CID) {
389 wil_err(wil, "Connect CID invalid : %d\n", evt->cid);
390 return;
391 }
392
393 ch = evt->channel + 1;
394 wil_dbg_wmi(wil, "Connect %pM channel [%d] cid %d\n",
395 evt->bssid, ch, evt->cid);
396 wil_hex_dump_wmi("connect AI : ", DUMP_PREFIX_OFFSET, 16, 1,
397 evt->assoc_info, len - sizeof(*evt), true);
398
399 /* figure out IE's */
400 assoc_req_ie = &evt->assoc_info[evt->beacon_ie_len +
401 assoc_req_ie_offset];
402 assoc_req_ielen = evt->assoc_req_len - assoc_req_ie_offset;
403 if (evt->assoc_req_len <= assoc_req_ie_offset) {
404 assoc_req_ie = NULL;
405 assoc_req_ielen = 0;
406 }
407
408 assoc_resp_ie = &evt->assoc_info[evt->beacon_ie_len +
409 evt->assoc_req_len +
410 assoc_resp_ie_offset];
411 assoc_resp_ielen = evt->assoc_resp_len - assoc_resp_ie_offset;
412 if (evt->assoc_resp_len <= assoc_resp_ie_offset) {
413 assoc_resp_ie = NULL;
414 assoc_resp_ielen = 0;
415 }
416
417 if ((wdev->iftype == NL80211_IFTYPE_STATION) ||
418 (wdev->iftype == NL80211_IFTYPE_P2P_CLIENT)) {
419 if (!test_bit(wil_status_fwconnecting, &wil->status)) {
420 wil_err(wil, "Not in connecting state\n");
421 return;
422 }
423 del_timer_sync(&wil->connect_timer);
424 cfg80211_connect_result(ndev, evt->bssid,
425 assoc_req_ie, assoc_req_ielen,
426 assoc_resp_ie, assoc_resp_ielen,
427 WLAN_STATUS_SUCCESS, GFP_KERNEL);
428
429 } else if ((wdev->iftype == NL80211_IFTYPE_AP) ||
430 (wdev->iftype == NL80211_IFTYPE_P2P_GO)) {
431 memset(&sinfo, 0, sizeof(sinfo));
432
433 sinfo.generation = wil->sinfo_gen++;
434
435 if (assoc_req_ie) {
436 sinfo.assoc_req_ies = assoc_req_ie;
437 sinfo.assoc_req_ies_len = assoc_req_ielen;
438 sinfo.filled |= STATION_INFO_ASSOC_REQ_IES;
439 }
440
441 cfg80211_new_sta(ndev, evt->bssid, &sinfo, GFP_KERNEL);
442 }
443 clear_bit(wil_status_fwconnecting, &wil->status);
444 set_bit(wil_status_fwconnected, &wil->status);
445
446 /* FIXME FW can transmit only ucast frames to peer */
447 /* FIXME real ring_id instead of hard coded 0 */
448 memcpy(wil->sta[evt->cid].addr, evt->bssid, ETH_ALEN);
449 wil->sta[evt->cid].status = wil_sta_conn_pending;
450
451 wil->pending_connect_cid = evt->cid;
452 queue_work(wil->wmi_wq_conn, &wil->connect_worker);
453 }
454
455 static void wmi_evt_disconnect(struct wil6210_priv *wil, int id,
456 void *d, int len)
457 {
458 struct wmi_disconnect_event *evt = d;
459
460 wil_dbg_wmi(wil, "Disconnect %pM reason %d proto %d wmi\n",
461 evt->bssid,
462 evt->protocol_reason_status, evt->disconnect_reason);
463
464 wil->sinfo_gen++;
465
466 mutex_lock(&wil->mutex);
467 wil6210_disconnect(wil, evt->bssid);
468 mutex_unlock(&wil->mutex);
469 }
470
471 static void wmi_evt_notify(struct wil6210_priv *wil, int id, void *d, int len)
472 {
473 struct wmi_notify_req_done_event *evt = d;
474
475 if (len < sizeof(*evt)) {
476 wil_err(wil, "Short NOTIFY event\n");
477 return;
478 }
479
480 wil->stats.tsf = le64_to_cpu(evt->tsf);
481 wil->stats.snr = le32_to_cpu(evt->snr_val);
482 wil->stats.bf_mcs = le16_to_cpu(evt->bf_mcs);
483 wil->stats.my_rx_sector = le16_to_cpu(evt->my_rx_sector);
484 wil->stats.my_tx_sector = le16_to_cpu(evt->my_tx_sector);
485 wil->stats.peer_rx_sector = le16_to_cpu(evt->other_rx_sector);
486 wil->stats.peer_tx_sector = le16_to_cpu(evt->other_tx_sector);
487 wil_dbg_wmi(wil, "Link status, MCS %d TSF 0x%016llx\n"
488 "BF status 0x%08x SNR 0x%08x SQI %d%%\n"
489 "Tx Tpt %d goodput %d Rx goodput %d\n"
490 "Sectors(rx:tx) my %d:%d peer %d:%d\n",
491 wil->stats.bf_mcs, wil->stats.tsf, evt->status,
492 wil->stats.snr, evt->sqi, le32_to_cpu(evt->tx_tpt),
493 le32_to_cpu(evt->tx_goodput), le32_to_cpu(evt->rx_goodput),
494 wil->stats.my_rx_sector, wil->stats.my_tx_sector,
495 wil->stats.peer_rx_sector, wil->stats.peer_tx_sector);
496 }
497
498 /*
499 * Firmware reports EAPOL frame using WME event.
500 * Reconstruct Ethernet frame and deliver it via normal Rx
501 */
502 static void wmi_evt_eapol_rx(struct wil6210_priv *wil, int id,
503 void *d, int len)
504 {
505 struct net_device *ndev = wil_to_ndev(wil);
506 struct wmi_eapol_rx_event *evt = d;
507 u16 eapol_len = le16_to_cpu(evt->eapol_len);
508 int sz = eapol_len + ETH_HLEN;
509 struct sk_buff *skb;
510 struct ethhdr *eth;
511 int cid;
512 struct wil_net_stats *stats = NULL;
513
514 wil_dbg_wmi(wil, "EAPOL len %d from %pM\n", eapol_len,
515 evt->src_mac);
516
517 cid = wil_find_cid(wil, evt->src_mac);
518 if (cid >= 0)
519 stats = &wil->sta[cid].stats;
520
521 if (eapol_len > 196) { /* TODO: revisit size limit */
522 wil_err(wil, "EAPOL too large\n");
523 return;
524 }
525
526 skb = alloc_skb(sz, GFP_KERNEL);
527 if (!skb) {
528 wil_err(wil, "Failed to allocate skb\n");
529 return;
530 }
531
532 eth = (struct ethhdr *)skb_put(skb, ETH_HLEN);
533 memcpy(eth->h_dest, ndev->dev_addr, ETH_ALEN);
534 memcpy(eth->h_source, evt->src_mac, ETH_ALEN);
535 eth->h_proto = cpu_to_be16(ETH_P_PAE);
536 memcpy(skb_put(skb, eapol_len), evt->eapol, eapol_len);
537 skb->protocol = eth_type_trans(skb, ndev);
538 if (likely(netif_rx_ni(skb) == NET_RX_SUCCESS)) {
539 ndev->stats.rx_packets++;
540 ndev->stats.rx_bytes += sz;
541 if (stats) {
542 stats->rx_packets++;
543 stats->rx_bytes += sz;
544 }
545 } else {
546 ndev->stats.rx_dropped++;
547 if (stats)
548 stats->rx_dropped++;
549 }
550 }
551
552 static void wmi_evt_linkup(struct wil6210_priv *wil, int id, void *d, int len)
553 {
554 struct net_device *ndev = wil_to_ndev(wil);
555 struct wmi_data_port_open_event *evt = d;
556 u8 cid = evt->cid;
557
558 wil_dbg_wmi(wil, "Link UP for CID %d\n", cid);
559
560 if (cid >= ARRAY_SIZE(wil->sta)) {
561 wil_err(wil, "Link UP for invalid CID %d\n", cid);
562 return;
563 }
564
565 wil->sta[cid].data_port_open = true;
566 netif_carrier_on(ndev);
567 }
568
569 static void wmi_evt_linkdown(struct wil6210_priv *wil, int id, void *d, int len)
570 {
571 struct net_device *ndev = wil_to_ndev(wil);
572 struct wmi_wbe_link_down_event *evt = d;
573 u8 cid = evt->cid;
574
575 wil_dbg_wmi(wil, "Link DOWN for CID %d, reason %d\n",
576 cid, le32_to_cpu(evt->reason));
577
578 if (cid >= ARRAY_SIZE(wil->sta)) {
579 wil_err(wil, "Link DOWN for invalid CID %d\n", cid);
580 return;
581 }
582
583 wil->sta[cid].data_port_open = false;
584 netif_carrier_off(ndev);
585 }
586
587 static void wmi_evt_ba_status(struct wil6210_priv *wil, int id, void *d,
588 int len)
589 {
590 struct wmi_vring_ba_status_event *evt = d;
591 struct wil_sta_info *sta;
592 uint i, cid;
593
594 /* TODO: use Rx BA status, not Tx one */
595
596 wil_dbg_wmi(wil, "BACK[%d] %s {%d} timeout %d\n",
597 evt->ringid,
598 evt->status == WMI_BA_AGREED ? "OK" : "N/A",
599 evt->agg_wsize, __le16_to_cpu(evt->ba_timeout));
600
601 if (evt->ringid >= WIL6210_MAX_TX_RINGS) {
602 wil_err(wil, "invalid ring id %d\n", evt->ringid);
603 return;
604 }
605
606 cid = wil->vring2cid_tid[evt->ringid][0];
607 if (cid >= WIL6210_MAX_CID) {
608 wil_err(wil, "invalid CID %d for vring %d\n", cid, evt->ringid);
609 return;
610 }
611
612 sta = &wil->sta[cid];
613 if (sta->status == wil_sta_unused) {
614 wil_err(wil, "CID %d unused\n", cid);
615 return;
616 }
617
618 wil_dbg_wmi(wil, "BACK for CID %d %pM\n", cid, sta->addr);
619 for (i = 0; i < WIL_STA_TID_NUM; i++) {
620 struct wil_tid_ampdu_rx *r = sta->tid_rx[i];
621 sta->tid_rx[i] = NULL;
622 wil_tid_ampdu_rx_free(wil, r);
623 if ((evt->status == WMI_BA_AGREED) && evt->agg_wsize)
624 sta->tid_rx[i] = wil_tid_ampdu_rx_alloc(wil,
625 evt->agg_wsize, 0);
626 }
627 }
628
629 static const struct {
630 int eventid;
631 void (*handler)(struct wil6210_priv *wil, int eventid,
632 void *data, int data_len);
633 } wmi_evt_handlers[] = {
634 {WMI_READY_EVENTID, wmi_evt_ready},
635 {WMI_FW_READY_EVENTID, wmi_evt_fw_ready},
636 {WMI_RX_MGMT_PACKET_EVENTID, wmi_evt_rx_mgmt},
637 {WMI_SCAN_COMPLETE_EVENTID, wmi_evt_scan_complete},
638 {WMI_CONNECT_EVENTID, wmi_evt_connect},
639 {WMI_DISCONNECT_EVENTID, wmi_evt_disconnect},
640 {WMI_NOTIFY_REQ_DONE_EVENTID, wmi_evt_notify},
641 {WMI_EAPOL_RX_EVENTID, wmi_evt_eapol_rx},
642 {WMI_DATA_PORT_OPEN_EVENTID, wmi_evt_linkup},
643 {WMI_WBE_LINKDOWN_EVENTID, wmi_evt_linkdown},
644 {WMI_BA_STATUS_EVENTID, wmi_evt_ba_status},
645 };
646
647 /*
648 * Run in IRQ context
649 * Extract WMI command from mailbox. Queue it to the @wil->pending_wmi_ev
650 * that will be eventually handled by the @wmi_event_worker in the thread
651 * context of thread "wil6210_wmi"
652 */
653 void wmi_recv_cmd(struct wil6210_priv *wil)
654 {
655 struct wil6210_mbox_ring_desc d_tail;
656 struct wil6210_mbox_hdr hdr;
657 struct wil6210_mbox_ring *r = &wil->mbox_ctl.rx;
658 struct pending_wmi_event *evt;
659 u8 *cmd;
660 void __iomem *src;
661 ulong flags;
662
663 if (!test_bit(wil_status_reset_done, &wil->status)) {
664 wil_err(wil, "Reset not completed\n");
665 return;
666 }
667
668 for (;;) {
669 u16 len;
670
671 r->head = ioread32(wil->csr + HOST_MBOX +
672 offsetof(struct wil6210_mbox_ctl, rx.head));
673 if (r->tail == r->head)
674 return;
675
676 /* read cmd from tail */
677 wil_memcpy_fromio_32(&d_tail, wil->csr + HOSTADDR(r->tail),
678 sizeof(struct wil6210_mbox_ring_desc));
679 if (d_tail.sync == 0) {
680 wil_err(wil, "Mbox evt not owned by FW?\n");
681 return;
682 }
683
684 if (0 != wmi_read_hdr(wil, d_tail.addr, &hdr)) {
685 wil_err(wil, "Mbox evt at 0x%08x?\n",
686 le32_to_cpu(d_tail.addr));
687 return;
688 }
689
690 len = le16_to_cpu(hdr.len);
691 src = wmi_buffer(wil, d_tail.addr) +
692 sizeof(struct wil6210_mbox_hdr);
693 evt = kmalloc(ALIGN(offsetof(struct pending_wmi_event,
694 event.wmi) + len, 4),
695 GFP_KERNEL);
696 if (!evt)
697 return;
698
699 evt->event.hdr = hdr;
700 cmd = (void *)&evt->event.wmi;
701 wil_memcpy_fromio_32(cmd, src, len);
702 /* mark entry as empty */
703 iowrite32(0, wil->csr + HOSTADDR(r->tail) +
704 offsetof(struct wil6210_mbox_ring_desc, sync));
705 /* indicate */
706 wil_dbg_wmi(wil, "Mbox evt %04x %04x %04x %02x\n",
707 le16_to_cpu(hdr.seq), len, le16_to_cpu(hdr.type),
708 hdr.flags);
709 if ((hdr.type == WIL_MBOX_HDR_TYPE_WMI) &&
710 (len >= sizeof(struct wil6210_mbox_hdr_wmi))) {
711 struct wil6210_mbox_hdr_wmi *wmi = &evt->event.wmi;
712 u16 id = le16_to_cpu(wmi->id);
713 u32 tstamp = le32_to_cpu(wmi->timestamp);
714 wil_dbg_wmi(wil, "WMI event 0x%04x MID %d @%d msec\n",
715 id, wmi->mid, tstamp);
716 trace_wil6210_wmi_event(wmi, &wmi[1],
717 len - sizeof(*wmi));
718 }
719 wil_hex_dump_wmi("evt ", DUMP_PREFIX_OFFSET, 16, 1,
720 &evt->event.hdr, sizeof(hdr) + len, true);
721
722 /* advance tail */
723 r->tail = r->base + ((r->tail - r->base +
724 sizeof(struct wil6210_mbox_ring_desc)) % r->size);
725 iowrite32(r->tail, wil->csr + HOST_MBOX +
726 offsetof(struct wil6210_mbox_ctl, rx.tail));
727
728 /* add to the pending list */
729 spin_lock_irqsave(&wil->wmi_ev_lock, flags);
730 list_add_tail(&evt->list, &wil->pending_wmi_ev);
731 spin_unlock_irqrestore(&wil->wmi_ev_lock, flags);
732 {
733 int q = queue_work(wil->wmi_wq,
734 &wil->wmi_event_worker);
735 wil_dbg_wmi(wil, "queue_work -> %d\n", q);
736 }
737 }
738 }
739
740 int wmi_call(struct wil6210_priv *wil, u16 cmdid, void *buf, u16 len,
741 u16 reply_id, void *reply, u8 reply_size, int to_msec)
742 {
743 int rc;
744 int remain;
745
746 mutex_lock(&wil->wmi_mutex);
747
748 rc = __wmi_send(wil, cmdid, buf, len);
749 if (rc)
750 goto out;
751
752 wil->reply_id = reply_id;
753 wil->reply_buf = reply;
754 wil->reply_size = reply_size;
755 remain = wait_for_completion_timeout(&wil->wmi_ready,
756 msecs_to_jiffies(to_msec));
757 if (0 == remain) {
758 wil_err(wil, "wmi_call(0x%04x->0x%04x) timeout %d msec\n",
759 cmdid, reply_id, to_msec);
760 rc = -ETIME;
761 } else {
762 wil_dbg_wmi(wil,
763 "wmi_call(0x%04x->0x%04x) completed in %d msec\n",
764 cmdid, reply_id,
765 to_msec - jiffies_to_msecs(remain));
766 }
767 wil->reply_id = 0;
768 wil->reply_buf = NULL;
769 wil->reply_size = 0;
770 out:
771 mutex_unlock(&wil->wmi_mutex);
772
773 return rc;
774 }
775
776 int wmi_echo(struct wil6210_priv *wil)
777 {
778 struct wmi_echo_cmd cmd = {
779 .value = cpu_to_le32(0x12345678),
780 };
781
782 return wmi_call(wil, WMI_ECHO_CMDID, &cmd, sizeof(cmd),
783 WMI_ECHO_RSP_EVENTID, NULL, 0, 20);
784 }
785
786 int wmi_set_mac_address(struct wil6210_priv *wil, void *addr)
787 {
788 struct wmi_set_mac_address_cmd cmd;
789
790 memcpy(cmd.mac, addr, ETH_ALEN);
791
792 wil_dbg_wmi(wil, "Set MAC %pM\n", addr);
793
794 return wmi_send(wil, WMI_SET_MAC_ADDRESS_CMDID, &cmd, sizeof(cmd));
795 }
796
797 int wmi_pcp_start(struct wil6210_priv *wil, int bi, u8 wmi_nettype, u8 chan)
798 {
799 int rc;
800
801 struct wmi_pcp_start_cmd cmd = {
802 .bcon_interval = cpu_to_le16(bi),
803 .network_type = wmi_nettype,
804 .disable_sec_offload = 1,
805 .channel = chan - 1,
806 .pcp_max_assoc_sta = WIL6210_MAX_CID,
807 };
808 struct {
809 struct wil6210_mbox_hdr_wmi wmi;
810 struct wmi_pcp_started_event evt;
811 } __packed reply;
812
813 if (!wil->secure_pcp)
814 cmd.disable_sec = 1;
815
816 /*
817 * Processing time may be huge, in case of secure AP it takes about
818 * 3500ms for FW to start AP
819 */
820 rc = wmi_call(wil, WMI_PCP_START_CMDID, &cmd, sizeof(cmd),
821 WMI_PCP_STARTED_EVENTID, &reply, sizeof(reply), 5000);
822 if (rc)
823 return rc;
824
825 if (reply.evt.status != WMI_FW_STATUS_SUCCESS)
826 rc = -EINVAL;
827
828 return rc;
829 }
830
831 int wmi_pcp_stop(struct wil6210_priv *wil)
832 {
833 return wmi_call(wil, WMI_PCP_STOP_CMDID, NULL, 0,
834 WMI_PCP_STOPPED_EVENTID, NULL, 0, 20);
835 }
836
837 int wmi_set_ssid(struct wil6210_priv *wil, u8 ssid_len, const void *ssid)
838 {
839 struct wmi_set_ssid_cmd cmd = {
840 .ssid_len = cpu_to_le32(ssid_len),
841 };
842
843 if (ssid_len > sizeof(cmd.ssid))
844 return -EINVAL;
845
846 memcpy(cmd.ssid, ssid, ssid_len);
847
848 return wmi_send(wil, WMI_SET_SSID_CMDID, &cmd, sizeof(cmd));
849 }
850
851 int wmi_get_ssid(struct wil6210_priv *wil, u8 *ssid_len, void *ssid)
852 {
853 int rc;
854 struct {
855 struct wil6210_mbox_hdr_wmi wmi;
856 struct wmi_set_ssid_cmd cmd;
857 } __packed reply;
858 int len; /* reply.cmd.ssid_len in CPU order */
859
860 rc = wmi_call(wil, WMI_GET_SSID_CMDID, NULL, 0, WMI_GET_SSID_EVENTID,
861 &reply, sizeof(reply), 20);
862 if (rc)
863 return rc;
864
865 len = le32_to_cpu(reply.cmd.ssid_len);
866 if (len > sizeof(reply.cmd.ssid))
867 return -EINVAL;
868
869 *ssid_len = len;
870 memcpy(ssid, reply.cmd.ssid, len);
871
872 return 0;
873 }
874
875 int wmi_set_channel(struct wil6210_priv *wil, int channel)
876 {
877 struct wmi_set_pcp_channel_cmd cmd = {
878 .channel = channel - 1,
879 };
880
881 return wmi_send(wil, WMI_SET_PCP_CHANNEL_CMDID, &cmd, sizeof(cmd));
882 }
883
884 int wmi_get_channel(struct wil6210_priv *wil, int *channel)
885 {
886 int rc;
887 struct {
888 struct wil6210_mbox_hdr_wmi wmi;
889 struct wmi_set_pcp_channel_cmd cmd;
890 } __packed reply;
891
892 rc = wmi_call(wil, WMI_GET_PCP_CHANNEL_CMDID, NULL, 0,
893 WMI_GET_PCP_CHANNEL_EVENTID, &reply, sizeof(reply), 20);
894 if (rc)
895 return rc;
896
897 if (reply.cmd.channel > 3)
898 return -EINVAL;
899
900 *channel = reply.cmd.channel + 1;
901
902 return 0;
903 }
904
905 int wmi_p2p_cfg(struct wil6210_priv *wil, int channel)
906 {
907 struct wmi_p2p_cfg_cmd cmd = {
908 .discovery_mode = WMI_DISCOVERY_MODE_NON_OFFLOAD,
909 .channel = channel - 1,
910 };
911
912 return wmi_send(wil, WMI_P2P_CFG_CMDID, &cmd, sizeof(cmd));
913 }
914
915 int wmi_del_cipher_key(struct wil6210_priv *wil, u8 key_index,
916 const void *mac_addr)
917 {
918 struct wmi_delete_cipher_key_cmd cmd = {
919 .key_index = key_index,
920 };
921
922 if (mac_addr)
923 memcpy(cmd.mac, mac_addr, WMI_MAC_LEN);
924
925 return wmi_send(wil, WMI_DELETE_CIPHER_KEY_CMDID, &cmd, sizeof(cmd));
926 }
927
928 int wmi_add_cipher_key(struct wil6210_priv *wil, u8 key_index,
929 const void *mac_addr, int key_len, const void *key)
930 {
931 struct wmi_add_cipher_key_cmd cmd = {
932 .key_index = key_index,
933 .key_usage = WMI_KEY_USE_PAIRWISE,
934 .key_len = key_len,
935 };
936
937 if (!key || (key_len > sizeof(cmd.key)))
938 return -EINVAL;
939
940 memcpy(cmd.key, key, key_len);
941 if (mac_addr)
942 memcpy(cmd.mac, mac_addr, WMI_MAC_LEN);
943
944 return wmi_send(wil, WMI_ADD_CIPHER_KEY_CMDID, &cmd, sizeof(cmd));
945 }
946
947 int wmi_set_ie(struct wil6210_priv *wil, u8 type, u16 ie_len, const void *ie)
948 {
949 int rc;
950 u16 len = sizeof(struct wmi_set_appie_cmd) + ie_len;
951 struct wmi_set_appie_cmd *cmd = kzalloc(len, GFP_KERNEL);
952 if (!cmd)
953 return -ENOMEM;
954
955 cmd->mgmt_frm_type = type;
956 /* BUG: FW API define ieLen as u8. Will fix FW */
957 cmd->ie_len = cpu_to_le16(ie_len);
958 memcpy(cmd->ie_info, ie, ie_len);
959 rc = wmi_send(wil, WMI_SET_APPIE_CMDID, cmd, len);
960 kfree(cmd);
961
962 return rc;
963 }
964
965 /**
966 * wmi_rxon - turn radio on/off
967 * @on: turn on if true, off otherwise
968 *
969 * Only switch radio. Channel should be set separately.
970 * No timeout for rxon - radio turned on forever unless some other call
971 * turns it off
972 */
973 int wmi_rxon(struct wil6210_priv *wil, bool on)
974 {
975 int rc;
976 struct {
977 struct wil6210_mbox_hdr_wmi wmi;
978 struct wmi_listen_started_event evt;
979 } __packed reply;
980
981 wil_info(wil, "%s(%s)\n", __func__, on ? "on" : "off");
982
983 if (on) {
984 rc = wmi_call(wil, WMI_START_LISTEN_CMDID, NULL, 0,
985 WMI_LISTEN_STARTED_EVENTID,
986 &reply, sizeof(reply), 100);
987 if ((rc == 0) && (reply.evt.status != WMI_FW_STATUS_SUCCESS))
988 rc = -EINVAL;
989 } else {
990 rc = wmi_call(wil, WMI_DISCOVERY_STOP_CMDID, NULL, 0,
991 WMI_DISCOVERY_STOPPED_EVENTID, NULL, 0, 20);
992 }
993
994 return rc;
995 }
996
997 int wmi_rx_chain_add(struct wil6210_priv *wil, struct vring *vring)
998 {
999 struct wireless_dev *wdev = wil->wdev;
1000 struct net_device *ndev = wil_to_ndev(wil);
1001 struct wmi_cfg_rx_chain_cmd cmd = {
1002 .action = WMI_RX_CHAIN_ADD,
1003 .rx_sw_ring = {
1004 .max_mpdu_size = cpu_to_le16(RX_BUF_LEN),
1005 .ring_mem_base = cpu_to_le64(vring->pa),
1006 .ring_size = cpu_to_le16(vring->size),
1007 },
1008 .mid = 0, /* TODO - what is it? */
1009 .decap_trans_type = WMI_DECAP_TYPE_802_3,
1010 .reorder_type = WMI_RX_SW_REORDER,
1011 };
1012 struct {
1013 struct wil6210_mbox_hdr_wmi wmi;
1014 struct wmi_cfg_rx_chain_done_event evt;
1015 } __packed evt;
1016 int rc;
1017
1018 if (wdev->iftype == NL80211_IFTYPE_MONITOR) {
1019 struct ieee80211_channel *ch = wdev->preset_chandef.chan;
1020
1021 cmd.sniffer_cfg.mode = cpu_to_le32(WMI_SNIFFER_ON);
1022 if (ch)
1023 cmd.sniffer_cfg.channel = ch->hw_value - 1;
1024 cmd.sniffer_cfg.phy_info_mode =
1025 cpu_to_le32(ndev->type == ARPHRD_IEEE80211_RADIOTAP);
1026 cmd.sniffer_cfg.phy_support =
1027 cpu_to_le32((wil->monitor_flags & MONITOR_FLAG_CONTROL)
1028 ? WMI_SNIFFER_CP : WMI_SNIFFER_DP);
1029 } else {
1030 /* Initialize offload (in non-sniffer mode).
1031 * Linux IP stack always calculates IP checksum
1032 * HW always calculate TCP/UDP checksum
1033 */
1034 cmd.l3_l4_ctrl |= (1 << L3_L4_CTRL_TCPIP_CHECKSUM_EN_POS);
1035 }
1036 /* typical time for secure PCP is 840ms */
1037 rc = wmi_call(wil, WMI_CFG_RX_CHAIN_CMDID, &cmd, sizeof(cmd),
1038 WMI_CFG_RX_CHAIN_DONE_EVENTID, &evt, sizeof(evt), 2000);
1039 if (rc)
1040 return rc;
1041
1042 vring->hwtail = le32_to_cpu(evt.evt.rx_ring_tail_ptr);
1043
1044 wil_dbg_misc(wil, "Rx init: status %d tail 0x%08x\n",
1045 le32_to_cpu(evt.evt.status), vring->hwtail);
1046
1047 if (le32_to_cpu(evt.evt.status) != WMI_CFG_RX_CHAIN_SUCCESS)
1048 rc = -EINVAL;
1049
1050 return rc;
1051 }
1052
1053 int wmi_get_temperature(struct wil6210_priv *wil, u32 *t_m, u32 *t_r)
1054 {
1055 int rc;
1056 struct wmi_temp_sense_cmd cmd = {
1057 .measure_marlon_m_en = cpu_to_le32(!!t_m),
1058 .measure_marlon_r_en = cpu_to_le32(!!t_r),
1059 };
1060 struct {
1061 struct wil6210_mbox_hdr_wmi wmi;
1062 struct wmi_temp_sense_done_event evt;
1063 } __packed reply;
1064
1065 rc = wmi_call(wil, WMI_TEMP_SENSE_CMDID, &cmd, sizeof(cmd),
1066 WMI_TEMP_SENSE_DONE_EVENTID, &reply, sizeof(reply), 100);
1067 if (rc)
1068 return rc;
1069
1070 if (t_m)
1071 *t_m = le32_to_cpu(reply.evt.marlon_m_t1000);
1072 if (t_r)
1073 *t_r = le32_to_cpu(reply.evt.marlon_r_t1000);
1074
1075 return 0;
1076 }
1077
1078 int wmi_disconnect_sta(struct wil6210_priv *wil, const u8 *mac, u16 reason)
1079 {
1080 struct wmi_disconnect_sta_cmd cmd = {
1081 .disconnect_reason = cpu_to_le16(reason),
1082 };
1083 memcpy(cmd.dst_mac, mac, ETH_ALEN);
1084
1085 wil_dbg_wmi(wil, "%s(%pM, reason %d)\n", __func__, mac, reason);
1086
1087 return wmi_send(wil, WMI_DISCONNECT_STA_CMDID, &cmd, sizeof(cmd));
1088 }
1089
1090 void wmi_event_flush(struct wil6210_priv *wil)
1091 {
1092 struct pending_wmi_event *evt, *t;
1093
1094 wil_dbg_wmi(wil, "%s()\n", __func__);
1095
1096 list_for_each_entry_safe(evt, t, &wil->pending_wmi_ev, list) {
1097 list_del(&evt->list);
1098 kfree(evt);
1099 }
1100 }
1101
1102 static bool wmi_evt_call_handler(struct wil6210_priv *wil, int id,
1103 void *d, int len)
1104 {
1105 uint i;
1106
1107 for (i = 0; i < ARRAY_SIZE(wmi_evt_handlers); i++) {
1108 if (wmi_evt_handlers[i].eventid == id) {
1109 wmi_evt_handlers[i].handler(wil, id, d, len);
1110 return true;
1111 }
1112 }
1113
1114 return false;
1115 }
1116
1117 static void wmi_event_handle(struct wil6210_priv *wil,
1118 struct wil6210_mbox_hdr *hdr)
1119 {
1120 u16 len = le16_to_cpu(hdr->len);
1121
1122 if ((hdr->type == WIL_MBOX_HDR_TYPE_WMI) &&
1123 (len >= sizeof(struct wil6210_mbox_hdr_wmi))) {
1124 struct wil6210_mbox_hdr_wmi *wmi = (void *)(&hdr[1]);
1125 void *evt_data = (void *)(&wmi[1]);
1126 u16 id = le16_to_cpu(wmi->id);
1127 /* check if someone waits for this event */
1128 if (wil->reply_id && wil->reply_id == id) {
1129 if (wil->reply_buf) {
1130 memcpy(wil->reply_buf, wmi,
1131 min(len, wil->reply_size));
1132 } else {
1133 wmi_evt_call_handler(wil, id, evt_data,
1134 len - sizeof(*wmi));
1135 }
1136 wil_dbg_wmi(wil, "Complete WMI 0x%04x\n", id);
1137 complete(&wil->wmi_ready);
1138 return;
1139 }
1140 /* unsolicited event */
1141 /* search for handler */
1142 if (!wmi_evt_call_handler(wil, id, evt_data,
1143 len - sizeof(*wmi))) {
1144 wil_err(wil, "Unhandled event 0x%04x\n", id);
1145 }
1146 } else {
1147 wil_err(wil, "Unknown event type\n");
1148 print_hex_dump(KERN_ERR, "evt?? ", DUMP_PREFIX_OFFSET, 16, 1,
1149 hdr, sizeof(*hdr) + len, true);
1150 }
1151 }
1152
1153 /*
1154 * Retrieve next WMI event from the pending list
1155 */
1156 static struct list_head *next_wmi_ev(struct wil6210_priv *wil)
1157 {
1158 ulong flags;
1159 struct list_head *ret = NULL;
1160
1161 spin_lock_irqsave(&wil->wmi_ev_lock, flags);
1162
1163 if (!list_empty(&wil->pending_wmi_ev)) {
1164 ret = wil->pending_wmi_ev.next;
1165 list_del(ret);
1166 }
1167
1168 spin_unlock_irqrestore(&wil->wmi_ev_lock, flags);
1169
1170 return ret;
1171 }
1172
1173 /*
1174 * Handler for the WMI events
1175 */
1176 void wmi_event_worker(struct work_struct *work)
1177 {
1178 struct wil6210_priv *wil = container_of(work, struct wil6210_priv,
1179 wmi_event_worker);
1180 struct pending_wmi_event *evt;
1181 struct list_head *lh;
1182
1183 while ((lh = next_wmi_ev(wil)) != NULL) {
1184 evt = list_entry(lh, struct pending_wmi_event, list);
1185 wmi_event_handle(wil, &evt->event.hdr);
1186 kfree(evt);
1187 }
1188 }
Linux kernel - Deliverables
This page took 0.087668 seconds and 5 git commands to generate.