Linux-libre 5.3.12-gnu
[librecmc/linux-libre.git] / drivers / net / wireless / st / cw1200 / txrx.h
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Datapath interface for ST-Ericsson CW1200 mac80211 drivers
4  *
5  * Copyright (c) 2010, ST-Ericsson
6  * Author: Dmitry Tarnyagin <dmitry.tarnyagin@lockless.no>
7  */
8
9 #ifndef CW1200_TXRX_H
10 #define CW1200_TXRX_H
11
12 #include <linux/list.h>
13
14 /* extern */ struct ieee80211_hw;
15 /* extern */ struct sk_buff;
16 /* extern */ struct wsm_tx;
17 /* extern */ struct wsm_rx;
18 /* extern */ struct wsm_tx_confirm;
19 /* extern */ struct cw1200_txpriv;
20
21 struct tx_policy {
22         union {
23                 __le32 tbl[3];
24                 u8 raw[12];
25         };
26         u8  defined;
27         u8  usage_count;
28         u8  retry_count;
29         u8  uploaded;
30 };
31
32 struct tx_policy_cache_entry {
33         struct tx_policy policy;
34         struct list_head link;
35 };
36
37 #define TX_POLICY_CACHE_SIZE    (8)
38 struct tx_policy_cache {
39         struct tx_policy_cache_entry cache[TX_POLICY_CACHE_SIZE];
40         struct list_head used;
41         struct list_head free;
42         spinlock_t lock; /* Protect policy cache */
43 };
44
45 /* ******************************************************************** */
46 /* TX policy cache                                                      */
47 /* Intention of TX policy cache is an overcomplicated WSM API.
48  * Device does not accept per-PDU tx retry sequence.
49  * It uses "tx retry policy id" instead, so driver code has to sync
50  * linux tx retry sequences with a retry policy table in the device.
51  */
52 void tx_policy_init(struct cw1200_common *priv);
53 void tx_policy_upload_work(struct work_struct *work);
54 void tx_policy_clean(struct cw1200_common *priv);
55
56 /* ******************************************************************** */
57 /* TX implementation                                                    */
58
59 u32 cw1200_rate_mask_to_wsm(struct cw1200_common *priv,
60                                u32 rates);
61 void cw1200_tx(struct ieee80211_hw *dev,
62                struct ieee80211_tx_control *control,
63                struct sk_buff *skb);
64 void cw1200_skb_dtor(struct cw1200_common *priv,
65                      struct sk_buff *skb,
66                      const struct cw1200_txpriv *txpriv);
67
68 /* ******************************************************************** */
69 /* WSM callbacks                                                        */
70
71 void cw1200_tx_confirm_cb(struct cw1200_common *priv,
72                           int link_id,
73                           struct wsm_tx_confirm *arg);
74 void cw1200_rx_cb(struct cw1200_common *priv,
75                   struct wsm_rx *arg,
76                   int link_id,
77                   struct sk_buff **skb_p);
78
79 /* ******************************************************************** */
80 /* Timeout                                                              */
81
82 void cw1200_tx_timeout(struct work_struct *work);
83
84 /* ******************************************************************** */
85 /* Security                                                             */
86 int cw1200_alloc_key(struct cw1200_common *priv);
87 void cw1200_free_key(struct cw1200_common *priv, int idx);
88 void cw1200_free_keys(struct cw1200_common *priv);
89 int cw1200_upload_keys(struct cw1200_common *priv);
90
91 /* ******************************************************************** */
92 /* Workaround for WFD test case 6.1.10                                  */
93 void cw1200_link_id_reset(struct work_struct *work);
94
95 #define CW1200_LINK_ID_GC_TIMEOUT ((unsigned long)(10 * HZ))
96
97 int cw1200_find_link_id(struct cw1200_common *priv, const u8 *mac);
98 int cw1200_alloc_link_id(struct cw1200_common *priv, const u8 *mac);
99 void cw1200_link_id_work(struct work_struct *work);
100 void cw1200_link_id_gc_work(struct work_struct *work);
101
102
103 #endif /* CW1200_TXRX_H */