Merge tag 'tty-5.6-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/tty
[linux-2.6-microblaze.git] / drivers / staging / wfx / hif_api_cmd.h
1 /* SPDX-License-Identifier: Apache-2.0 */
2 /*
3  * WFx hardware interface definitions
4  *
5  * Copyright (c) 2018-2019, Silicon Laboratories Inc.
6  */
7
8 #ifndef WFX_HIF_API_CMD_H
9 #define WFX_HIF_API_CMD_H
10
11 #include "hif_api_general.h"
12
13 #define HIF_NUM_AC                             4
14
15 #define HIF_API_SSID_SIZE                      API_SSID_SIZE
16
17 enum hif_requests_ids {
18         HIF_REQ_ID_RESET                             = 0x0a,
19         HIF_REQ_ID_READ_MIB                          = 0x05,
20         HIF_REQ_ID_WRITE_MIB                         = 0x06,
21         HIF_REQ_ID_START_SCAN                        = 0x07,
22         HIF_REQ_ID_STOP_SCAN                         = 0x08,
23         HIF_REQ_ID_TX                                = 0x04,
24         HIF_REQ_ID_JOIN                              = 0x0b,
25         HIF_REQ_ID_SET_PM_MODE                       = 0x10,
26         HIF_REQ_ID_SET_BSS_PARAMS                    = 0x11,
27         HIF_REQ_ID_ADD_KEY                           = 0x0c,
28         HIF_REQ_ID_REMOVE_KEY                        = 0x0d,
29         HIF_REQ_ID_EDCA_QUEUE_PARAMS                 = 0x13,
30         HIF_REQ_ID_START                             = 0x17,
31         HIF_REQ_ID_BEACON_TRANSMIT                   = 0x18,
32         HIF_REQ_ID_UPDATE_IE                         = 0x1b,
33         HIF_REQ_ID_MAP_LINK                          = 0x1c,
34 };
35
36 enum hif_confirmations_ids {
37         HIF_CNF_ID_RESET                             = 0x0a,
38         HIF_CNF_ID_READ_MIB                          = 0x05,
39         HIF_CNF_ID_WRITE_MIB                         = 0x06,
40         HIF_CNF_ID_START_SCAN                        = 0x07,
41         HIF_CNF_ID_STOP_SCAN                         = 0x08,
42         HIF_CNF_ID_TX                                = 0x04,
43         HIF_CNF_ID_MULTI_TRANSMIT                    = 0x1e,
44         HIF_CNF_ID_JOIN                              = 0x0b,
45         HIF_CNF_ID_SET_PM_MODE                       = 0x10,
46         HIF_CNF_ID_SET_BSS_PARAMS                    = 0x11,
47         HIF_CNF_ID_ADD_KEY                           = 0x0c,
48         HIF_CNF_ID_REMOVE_KEY                        = 0x0d,
49         HIF_CNF_ID_EDCA_QUEUE_PARAMS                 = 0x13,
50         HIF_CNF_ID_START                             = 0x17,
51         HIF_CNF_ID_BEACON_TRANSMIT                   = 0x18,
52         HIF_CNF_ID_UPDATE_IE                         = 0x1b,
53         HIF_CNF_ID_MAP_LINK                          = 0x1c,
54 };
55
56 enum hif_indications_ids {
57         HIF_IND_ID_RX                                = 0x84,
58         HIF_IND_ID_SCAN_CMPL                         = 0x86,
59         HIF_IND_ID_JOIN_COMPLETE                     = 0x8f,
60         HIF_IND_ID_SET_PM_MODE_CMPL                  = 0x89,
61         HIF_IND_ID_SUSPEND_RESUME_TX                 = 0x8c,
62         HIF_IND_ID_EVENT                             = 0x85
63 };
64
65 union hif_commands_ids {
66         enum hif_requests_ids request;
67         enum hif_confirmations_ids confirmation;
68         enum hif_indications_ids indication;
69 };
70
71 enum hif_status {
72         HIF_STATUS_SUCCESS                         = 0x0,
73         HIF_STATUS_FAILURE                         = 0x1,
74         HIF_INVALID_PARAMETER                      = 0x2,
75         HIF_STATUS_WARNING                         = 0x3,
76         HIF_ERROR_UNSUPPORTED_MSG_ID               = 0x4,
77         HIF_STATUS_DECRYPTFAILURE                  = 0x10,
78         HIF_STATUS_MICFAILURE                      = 0x11,
79         HIF_STATUS_NO_KEY_FOUND                    = 0x12,
80         HIF_STATUS_RETRY_EXCEEDED                  = 0x13,
81         HIF_STATUS_TX_LIFETIME_EXCEEDED            = 0x14,
82         HIF_REQUEUE                                = 0x15,
83         HIF_STATUS_REFUSED                         = 0x16,
84         HIF_STATUS_BUSY                            = 0x17
85 };
86
87 struct hif_reset_flags {
88         u8    reset_stat:1;
89         u8    reset_all_int:1;
90         u8    reserved1:6;
91         u8    reserved2[3];
92 } __packed;
93
94 struct hif_req_reset {
95         struct hif_reset_flags reset_flags;
96 } __packed;
97
98 struct hif_cnf_reset {
99         u32   status;
100 } __packed;
101
102 struct hif_req_read_mib {
103         u16   mib_id;
104         u16   reserved;
105 } __packed;
106
107 struct hif_cnf_read_mib {
108         u32   status;
109         u16   mib_id;
110         u16   length;
111         u8    mib_data[];
112 } __packed;
113
114 struct hif_req_write_mib {
115         u16   mib_id;
116         u16   length;
117         u8    mib_data[];
118 } __packed;
119
120 struct hif_cnf_write_mib {
121         u32   status;
122 } __packed;
123
124 struct hif_ie_flags {
125         u8    beacon:1;
126         u8    probe_resp:1;
127         u8    probe_req:1;
128         u8    reserved1:5;
129         u8    reserved2;
130 } __packed;
131
132 struct hif_ie_tlv {
133         u8    type;
134         u8    length;
135         u8    data[];
136 } __packed;
137
138 struct hif_req_update_ie {
139         struct hif_ie_flags ie_flags;
140         u16   num_i_es;
141         struct hif_ie_tlv ie[];
142 } __packed;
143
144 struct hif_cnf_update_ie {
145         u32   status;
146 } __packed;
147
148 struct hif_scan_type {
149         u8    type:1;
150         u8    mode:1;
151         u8    reserved:6;
152 } __packed;
153
154 struct hif_scan_flags {
155         u8    fbg:1;
156         u8    reserved1:1;
157         u8    pre:1;
158         u8    reserved2:5;
159 } __packed;
160
161 struct hif_auto_scan_param {
162         u16   interval;
163         u8    reserved;
164         s8     rssi_thr;
165 } __packed;
166
167 struct hif_ssid_def {
168         u32   ssid_length;
169         u8    ssid[HIF_API_SSID_SIZE];
170 } __packed;
171
172 #define HIF_API_MAX_NB_SSIDS                           2
173 #define HIF_API_MAX_NB_CHANNELS                       14
174
175 struct hif_req_start_scan {
176         u8    band;
177         struct hif_scan_type scan_type;
178         struct hif_scan_flags scan_flags;
179         u8    max_transmit_rate;
180         struct hif_auto_scan_param auto_scan_param;
181         u8    num_of_probe_requests;
182         u8    probe_delay;
183         u8    num_of_ssi_ds;
184         u8    num_of_channels;
185         u32   min_channel_time;
186         u32   max_channel_time;
187         s32    tx_power_level;
188         u8    ssid_and_channel_lists[];
189 } __packed;
190
191 struct hif_start_scan_req_cstnbssid_body {
192         u8    band;
193         struct hif_scan_type scan_type;
194         struct hif_scan_flags scan_flags;
195         u8    max_transmit_rate;
196         struct hif_auto_scan_param auto_scan_param;
197         u8    num_of_probe_requests;
198         u8    probe_delay;
199         u8    num_of_ssi_ds;
200         u8    num_of_channels;
201         u32   min_channel_time;
202         u32   max_channel_time;
203         s32    tx_power_level;
204         struct hif_ssid_def ssid_def[HIF_API_MAX_NB_SSIDS];
205         u8    channel_list[];
206 } __packed;
207
208 struct hif_cnf_start_scan {
209         u32   status;
210 } __packed;
211
212 struct hif_cnf_stop_scan {
213         u32   status;
214 } __packed;
215
216 enum hif_pm_mode_status {
217         HIF_PM_MODE_ACTIVE                         = 0x0,
218         HIF_PM_MODE_PS                             = 0x1,
219         HIF_PM_MODE_UNDETERMINED                   = 0x2
220 };
221
222 struct hif_ind_scan_cmpl {
223         u32   status;
224         u8    pm_mode;
225         u8    num_channels_completed;
226         u16   reserved;
227 } __packed;
228
229 enum hif_queue_id {
230         HIF_QUEUE_ID_BACKGROUND                    = 0x0,
231         HIF_QUEUE_ID_BESTEFFORT                    = 0x1,
232         HIF_QUEUE_ID_VIDEO                         = 0x2,
233         HIF_QUEUE_ID_VOICE                         = 0x3
234 };
235
236 enum hif_frame_format {
237         HIF_FRAME_FORMAT_NON_HT                    = 0x0,
238         HIF_FRAME_FORMAT_MIXED_FORMAT_HT           = 0x1,
239         HIF_FRAME_FORMAT_GF_HT_11N                 = 0x2
240 };
241
242 enum hif_stbc {
243         HIF_STBC_NOT_ALLOWED                       = 0x0,
244         HIF_STBC_ALLOWED                           = 0x1
245 };
246
247 struct hif_queue {
248         u8    queue_id:2;
249         u8    peer_sta_id:4;
250         u8    reserved:2;
251 } __packed;
252
253 struct hif_data_flags {
254         u8    more:1;
255         u8    fc_offset:3;
256         u8    reserved:4;
257 } __packed;
258
259 struct hif_tx_flags {
260         u8    start_exp:1;
261         u8    reserved:3;
262         u8    retry_policy_index:4;
263 } __packed;
264
265 struct hif_ht_tx_parameters {
266         u8    frame_format:4;
267         u8    fec_coding:1;
268         u8    short_gi:1;
269         u8    reserved1:1;
270         u8    stbc:1;
271         u8    reserved2;
272         u8    aggregation:1;
273         u8    reserved3:7;
274         u8    reserved4;
275 } __packed;
276
277 struct hif_req_tx {
278         u32   packet_id;
279         u8    max_tx_rate;
280         struct hif_queue queue_id;
281         struct hif_data_flags data_flags;
282         struct hif_tx_flags tx_flags;
283         u32   reserved;
284         u32   expire_time;
285         struct hif_ht_tx_parameters ht_tx_parameters;
286         u8    frame[];
287 } __packed;
288
289 enum hif_qos_ackplcy {
290         HIF_QOS_ACKPLCY_NORMAL                         = 0x0,
291         HIF_QOS_ACKPLCY_TXNOACK                        = 0x1,
292         HIF_QOS_ACKPLCY_NOEXPACK                       = 0x2,
293         HIF_QOS_ACKPLCY_BLCKACK                        = 0x3
294 };
295
296 struct hif_tx_result_flags {
297         u8    aggr:1;
298         u8    requeue:1;
299         u8    ack_policy:2;
300         u8    txop_limit:1;
301         u8    reserved1:3;
302         u8    reserved2;
303 } __packed;
304
305 struct hif_cnf_tx {
306         u32   status;
307         u32   packet_id;
308         u8    txed_rate;
309         u8    ack_failures;
310         struct hif_tx_result_flags tx_result_flags;
311         u32   media_delay;
312         u32   tx_queue_delay;
313 } __packed;
314
315 struct hif_cnf_multi_transmit {
316         u32   num_tx_confs;
317         struct hif_cnf_tx   tx_conf_payload[];
318 } __packed;
319
320 enum hif_ri_flags_encrypt {
321         HIF_RI_FLAGS_UNENCRYPTED                   = 0x0,
322         HIF_RI_FLAGS_WEP_ENCRYPTED                 = 0x1,
323         HIF_RI_FLAGS_TKIP_ENCRYPTED                = 0x2,
324         HIF_RI_FLAGS_AES_ENCRYPTED                 = 0x3,
325         HIF_RI_FLAGS_WAPI_ENCRYPTED                = 0x4
326 };
327
328 struct hif_rx_flags {
329         u8    encryp:3;
330         u8    in_aggr:1;
331         u8    first_aggr:1;
332         u8    last_aggr:1;
333         u8    defrag:1;
334         u8    beacon:1;
335         u8    tim:1;
336         u8    bitmap:1;
337         u8    match_ssid:1;
338         u8    match_bssid:1;
339         u8    more:1;
340         u8    reserved1:1;
341         u8    ht:1;
342         u8    stbc:1;
343         u8    match_uc_addr:1;
344         u8    match_mc_addr:1;
345         u8    match_bc_addr:1;
346         u8    key_type:1;
347         u8    key_index:4;
348         u8    reserved2:1;
349         u8    peer_sta_id:4;
350         u8    reserved3:2;
351         u8    reserved4:1;
352 } __packed;
353
354 struct hif_ind_rx {
355         u32   status;
356         u16   channel_number;
357         u8    rxed_rate;
358         u8    rcpi_rssi;
359         struct hif_rx_flags rx_flags;
360         u8    frame[];
361 } __packed;
362
363
364 struct hif_req_edca_queue_params {
365         u8    queue_id;
366         u8    reserved1;
367         u8    aifsn;
368         u8    reserved2;
369         u16   cw_min;
370         u16   cw_max;
371         u16   tx_op_limit;
372         u16   allowed_medium_time;
373         u32   reserved3;
374 } __packed;
375
376 struct hif_cnf_edca_queue_params {
377         u32   status;
378 } __packed;
379
380 enum hif_ap_mode {
381         HIF_MODE_IBSS                              = 0x0,
382         HIF_MODE_BSS                               = 0x1
383 };
384
385 enum hif_preamble {
386         HIF_PREAMBLE_LONG                          = 0x0,
387         HIF_PREAMBLE_SHORT                         = 0x1,
388         HIF_PREAMBLE_SHORT_LONG12                  = 0x2
389 };
390
391 struct hif_join_flags {
392         u8    reserved1:2;
393         u8    force_no_beacon:1;
394         u8    force_with_ind:1;
395         u8    reserved2:4;
396 } __packed;
397
398 struct hif_req_join {
399         u8    mode;
400         u8    band;
401         u16   channel_number;
402         u8    bssid[ETH_ALEN];
403         u16   atim_window;
404         u8    preamble_type;
405         u8    probe_for_join;
406         u8    reserved;
407         struct hif_join_flags join_flags;
408         u32   ssid_length;
409         u8    ssid[HIF_API_SSID_SIZE];
410         u32   beacon_interval;
411         u32   basic_rate_set;
412 } __packed;
413
414 struct hif_cnf_join {
415         u32   status;
416 } __packed;
417
418 struct hif_ind_join_complete {
419         u32   status;
420 } __packed;
421
422 struct hif_bss_flags {
423         u8    lost_count_only:1;
424         u8    reserved:7;
425 } __packed;
426
427 struct hif_req_set_bss_params {
428         struct hif_bss_flags bss_flags;
429         u8    beacon_lost_count;
430         u16   aid;
431         u32   operational_rate_set;
432 } __packed;
433
434 struct hif_cnf_set_bss_params {
435         u32   status;
436 } __packed;
437
438 struct hif_pm_mode {
439         u8    enter_psm:1;
440         u8    reserved:6;
441         u8    fast_psm:1;
442 } __packed;
443
444 struct hif_req_set_pm_mode {
445         struct hif_pm_mode pm_mode;
446         u8    fast_psm_idle_period;
447         u8    ap_psm_change_period;
448         u8    min_auto_ps_poll_period;
449 } __packed;
450
451 struct hif_cnf_set_pm_mode {
452         u32   status;
453 } __packed;
454
455 struct hif_ind_set_pm_mode_cmpl {
456         u32   status;
457         u8    pm_mode;
458         u8    reserved[3];
459 } __packed;
460
461
462 struct hif_req_start {
463         u8    mode;
464         u8    band;
465         u16   channel_number;
466         u32   reserved1;
467         u32   beacon_interval;
468         u8    dtim_period;
469         u8    preamble_type;
470         u8    reserved2;
471         u8    ssid_length;
472         u8    ssid[HIF_API_SSID_SIZE];
473         u32   basic_rate_set;
474 } __packed;
475
476 struct hif_cnf_start {
477         u32   status;
478 } __packed;
479
480 enum hif_beacon {
481         HIF_BEACON_STOP                       = 0x0,
482         HIF_BEACON_START                      = 0x1
483 };
484
485 struct hif_req_beacon_transmit {
486         u8    enable_beaconing;
487         u8    reserved[3];
488 } __packed;
489
490 struct hif_cnf_beacon_transmit {
491         u32   status;
492 } __packed;
493
494 enum hif_sta_map_direction {
495         HIF_STA_MAP                       = 0x0,
496         HIF_STA_UNMAP                     = 0x1
497 };
498
499 struct hif_map_link_flags {
500         u8    map_direction:1;
501         u8    mfpc:1;
502         u8    reserved:6;
503 } __packed;
504
505 struct hif_req_map_link {
506         u8    mac_addr[ETH_ALEN];
507         struct hif_map_link_flags map_link_flags;
508         u8    peer_sta_id;
509 } __packed;
510
511 struct hif_cnf_map_link {
512         u32   status;
513 } __packed;
514
515 struct hif_suspend_resume_flags {
516         u8    resume:1;
517         u8    reserved1:2;
518         u8    bc_mc_only:1;
519         u8    reserved2:4;
520         u8    reserved3;
521 } __packed;
522
523 struct hif_ind_suspend_resume_tx {
524         struct hif_suspend_resume_flags suspend_resume_flags;
525         u16   peer_sta_set;
526 } __packed;
527
528
529 #define MAX_KEY_ENTRIES         24
530 #define HIF_API_WEP_KEY_DATA_SIZE                       16
531 #define HIF_API_TKIP_KEY_DATA_SIZE                      16
532 #define HIF_API_RX_MIC_KEY_SIZE                         8
533 #define HIF_API_TX_MIC_KEY_SIZE                         8
534 #define HIF_API_AES_KEY_DATA_SIZE                       16
535 #define HIF_API_WAPI_KEY_DATA_SIZE                      16
536 #define HIF_API_MIC_KEY_DATA_SIZE                       16
537 #define HIF_API_IGTK_KEY_DATA_SIZE                      16
538 #define HIF_API_RX_SEQUENCE_COUNTER_SIZE                8
539 #define HIF_API_IPN_SIZE                                8
540
541 enum hif_key_type {
542         HIF_KEY_TYPE_WEP_DEFAULT                   = 0x0,
543         HIF_KEY_TYPE_WEP_PAIRWISE                  = 0x1,
544         HIF_KEY_TYPE_TKIP_GROUP                    = 0x2,
545         HIF_KEY_TYPE_TKIP_PAIRWISE                 = 0x3,
546         HIF_KEY_TYPE_AES_GROUP                     = 0x4,
547         HIF_KEY_TYPE_AES_PAIRWISE                  = 0x5,
548         HIF_KEY_TYPE_WAPI_GROUP                    = 0x6,
549         HIF_KEY_TYPE_WAPI_PAIRWISE                 = 0x7,
550         HIF_KEY_TYPE_IGTK_GROUP                    = 0x8,
551         HIF_KEY_TYPE_NONE                          = 0x9
552 };
553
554 struct hif_wep_pairwise_key {
555         u8    peer_address[ETH_ALEN];
556         u8    reserved;
557         u8    key_length;
558         u8    key_data[HIF_API_WEP_KEY_DATA_SIZE];
559 } __packed;
560
561 struct hif_wep_group_key {
562         u8    key_id;
563         u8    key_length;
564         u8    reserved[2];
565         u8    key_data[HIF_API_WEP_KEY_DATA_SIZE];
566 } __packed;
567
568 struct hif_tkip_pairwise_key {
569         u8    peer_address[ETH_ALEN];
570         u8    reserved[2];
571         u8    tkip_key_data[HIF_API_TKIP_KEY_DATA_SIZE];
572         u8    rx_mic_key[HIF_API_RX_MIC_KEY_SIZE];
573         u8    tx_mic_key[HIF_API_TX_MIC_KEY_SIZE];
574 } __packed;
575
576 struct hif_tkip_group_key {
577         u8    tkip_key_data[HIF_API_TKIP_KEY_DATA_SIZE];
578         u8    rx_mic_key[HIF_API_RX_MIC_KEY_SIZE];
579         u8    key_id;
580         u8    reserved[3];
581         u8    rx_sequence_counter[HIF_API_RX_SEQUENCE_COUNTER_SIZE];
582 } __packed;
583
584 struct hif_aes_pairwise_key {
585         u8    peer_address[ETH_ALEN];
586         u8    reserved[2];
587         u8    aes_key_data[HIF_API_AES_KEY_DATA_SIZE];
588 } __packed;
589
590 struct hif_aes_group_key {
591         u8    aes_key_data[HIF_API_AES_KEY_DATA_SIZE];
592         u8    key_id;
593         u8    reserved[3];
594         u8    rx_sequence_counter[HIF_API_RX_SEQUENCE_COUNTER_SIZE];
595 } __packed;
596
597 struct hif_wapi_pairwise_key {
598         u8    peer_address[ETH_ALEN];
599         u8    key_id;
600         u8    reserved;
601         u8    wapi_key_data[HIF_API_WAPI_KEY_DATA_SIZE];
602         u8    mic_key_data[HIF_API_MIC_KEY_DATA_SIZE];
603 } __packed;
604
605 struct hif_wapi_group_key {
606         u8    wapi_key_data[HIF_API_WAPI_KEY_DATA_SIZE];
607         u8    mic_key_data[HIF_API_MIC_KEY_DATA_SIZE];
608         u8    key_id;
609         u8    reserved[3];
610 } __packed;
611
612 struct hif_igtk_group_key {
613         u8    igtk_key_data[HIF_API_IGTK_KEY_DATA_SIZE];
614         u8    key_id;
615         u8    reserved[3];
616         u8    ipn[HIF_API_IPN_SIZE];
617 } __packed;
618
619 union hif_privacy_key_data {
620         struct hif_wep_pairwise_key                       wep_pairwise_key;
621         struct hif_wep_group_key                          wep_group_key;
622         struct hif_tkip_pairwise_key                      tkip_pairwise_key;
623         struct hif_tkip_group_key                         tkip_group_key;
624         struct hif_aes_pairwise_key                       aes_pairwise_key;
625         struct hif_aes_group_key                          aes_group_key;
626         struct hif_wapi_pairwise_key                      wapi_pairwise_key;
627         struct hif_wapi_group_key                         wapi_group_key;
628         struct hif_igtk_group_key                         igtk_group_key;
629 };
630
631 struct hif_req_add_key {
632         u8    type;
633         u8    entry_index;
634         u8    int_id:2;
635         u8    reserved1:6;
636         u8    reserved2;
637         union hif_privacy_key_data key;
638 } __packed;
639
640 struct hif_cnf_add_key {
641         u32   status;
642 } __packed;
643
644 struct hif_req_remove_key {
645         u8    entry_index;
646         u8    reserved[3];
647 } __packed;
648
649 struct hif_cnf_remove_key {
650         u32   status;
651 } __packed;
652
653 enum hif_event_ind {
654         HIF_EVENT_IND_BSSLOST                      = 0x1,
655         HIF_EVENT_IND_BSSREGAINED                  = 0x2,
656         HIF_EVENT_IND_RCPI_RSSI                    = 0x3,
657         HIF_EVENT_IND_PS_MODE_ERROR                = 0x4,
658         HIF_EVENT_IND_INACTIVITY                   = 0x5
659 };
660
661 enum hif_ps_mode_error {
662         HIF_PS_ERROR_NO_ERROR                      = 0,
663         HIF_PS_ERROR_AP_NOT_RESP_TO_POLL           = 1,
664         HIF_PS_ERROR_AP_NOT_RESP_TO_UAPSD_TRIGGER  = 2,
665         HIF_PS_ERROR_AP_SENT_UNICAST_IN_DOZE       = 3,
666         HIF_PS_ERROR_AP_NO_DATA_AFTER_TIM          = 4
667 };
668
669 union hif_event_data {
670         u8    rcpi_rssi;
671         u32   ps_mode_error;
672         u32   peer_sta_set;
673 };
674
675 struct hif_ind_event {
676         u32   event_id;
677         union hif_event_data event_data;
678 } __packed;
679
680
681 #endif