Loading...
1/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2/*
3 * Copyright (C) 2012-2014, 2020, 2022, 2024 Intel Corporation
4 * Copyright (C) 2013-2015 Intel Mobile Communications GmbH
5 * Copyright (C) 2016-2017 Intel Deutschland GmbH
6 */
7#ifndef __iwl_fw_api_binding_h__
8#define __iwl_fw_api_binding_h__
9
10#include <fw/file.h>
11#include <fw/img.h>
12
13#define MAX_MACS_IN_BINDING (3)
14#define MAX_BINDINGS (4)
15
16/**
17 * struct iwl_binding_cmd_v1 - configuring bindings
18 * ( BINDING_CONTEXT_CMD = 0x2b )
19 * @id_and_color: ID and color of the relevant Binding,
20 * &enum iwl_ctxt_id_and_color
21 * @action: action to perform, see &enum iwl_ctxt_action
22 * @macs: array of MAC id and colors which belong to the binding,
23 * &enum iwl_ctxt_id_and_color
24 * @phy: PHY id and color which belongs to the binding,
25 * &enum iwl_ctxt_id_and_color
26 */
27struct iwl_binding_cmd_v1 {
28 /* COMMON_INDEX_HDR_API_S_VER_1 */
29 __le32 id_and_color;
30 __le32 action;
31 /* BINDING_DATA_API_S_VER_1 */
32 __le32 macs[MAX_MACS_IN_BINDING];
33 __le32 phy;
34} __packed; /* BINDING_CMD_API_S_VER_1 */
35
36/**
37 * struct iwl_binding_cmd - configuring bindings
38 * ( BINDING_CONTEXT_CMD = 0x2b )
39 * @id_and_color: ID and color of the relevant Binding,
40 * &enum iwl_ctxt_id_and_color
41 * @action: action to perform, see &enum iwl_ctxt_action
42 * @macs: array of MAC id and colors which belong to the binding
43 * &enum iwl_ctxt_id_and_color
44 * @phy: PHY id and color which belongs to the binding
45 * &enum iwl_ctxt_id_and_color
46 * @lmac_id: the lmac id the binding belongs to
47 */
48struct iwl_binding_cmd {
49 /* COMMON_INDEX_HDR_API_S_VER_1 */
50 __le32 id_and_color;
51 __le32 action;
52 /* BINDING_DATA_API_S_VER_1 */
53 __le32 macs[MAX_MACS_IN_BINDING];
54 __le32 phy;
55 __le32 lmac_id;
56} __packed; /* BINDING_CMD_API_S_VER_2 */
57
58#define IWL_BINDING_CMD_SIZE_V1 sizeof(struct iwl_binding_cmd_v1)
59
60/* The maximal number of fragments in the FW's schedule session */
61#define IWL_MVM_MAX_QUOTA 128
62
63/**
64 * struct iwl_time_quota_data_v1 - configuration of time quota per binding
65 * @id_and_color: ID and color of the relevant Binding,
66 * &enum iwl_ctxt_id_and_color
67 * @quota: absolute time quota in TU. The scheduler will try to divide the
68 * remainig quota (after Time Events) according to this quota.
69 * @max_duration: max uninterrupted context duration in TU
70 */
71struct iwl_time_quota_data_v1 {
72 __le32 id_and_color;
73 __le32 quota;
74 __le32 max_duration;
75} __packed; /* TIME_QUOTA_DATA_API_S_VER_1 */
76
77/**
78 * struct iwl_time_quota_cmd_v1 - configuration of time quota between bindings
79 * ( TIME_QUOTA_CMD = 0x2c )
80 * @quotas: allocations per binding
81 * Note: on non-CDB the fourth one is the auxilary mac and is
82 * essentially zero.
83 * On CDB the fourth one is a regular binding.
84 */
85struct iwl_time_quota_cmd_v1 {
86 struct iwl_time_quota_data_v1 quotas[MAX_BINDINGS];
87} __packed; /* TIME_QUOTA_ALLOCATION_CMD_API_S_VER_1 */
88
89enum iwl_quota_low_latency {
90 IWL_QUOTA_LOW_LATENCY_NONE = 0,
91 IWL_QUOTA_LOW_LATENCY_TX = BIT(0),
92 IWL_QUOTA_LOW_LATENCY_RX = BIT(1),
93 IWL_QUOTA_LOW_LATENCY_TX_RX =
94 IWL_QUOTA_LOW_LATENCY_TX | IWL_QUOTA_LOW_LATENCY_RX,
95};
96
97/**
98 * struct iwl_time_quota_data - configuration of time quota per binding
99 * @id_and_color: ID and color of the relevant Binding.
100 * @quota: absolute time quota in TU. The scheduler will try to divide the
101 * remainig quota (after Time Events) according to this quota.
102 * @max_duration: max uninterrupted context duration in TU
103 * @low_latency: low latency status, &enum iwl_quota_low_latency
104 */
105struct iwl_time_quota_data {
106 __le32 id_and_color;
107 __le32 quota;
108 __le32 max_duration;
109 __le32 low_latency;
110} __packed; /* TIME_QUOTA_DATA_API_S_VER_2 */
111
112/**
113 * struct iwl_time_quota_cmd - configuration of time quota between bindings
114 * ( TIME_QUOTA_CMD = 0x2c )
115 * Note: on non-CDB the fourth one is the auxilary mac and is essentially zero.
116 * On CDB the fourth one is a regular binding.
117 *
118 * @quotas: allocations per binding
119 */
120struct iwl_time_quota_cmd {
121 struct iwl_time_quota_data quotas[MAX_BINDINGS];
122} __packed; /* TIME_QUOTA_ALLOCATION_CMD_API_S_VER_2 */
123
124#endif /* __iwl_fw_api_binding_h__ */
1/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2/*
3 * Copyright (C) 2012-2014, 2020 Intel Corporation
4 * Copyright (C) 2013-2015 Intel Mobile Communications GmbH
5 * Copyright (C) 2016-2017 Intel Deutschland GmbH
6 */
7#ifndef __iwl_fw_api_binding_h__
8#define __iwl_fw_api_binding_h__
9
10#include <fw/file.h>
11#include <fw/img.h>
12
13#define MAX_MACS_IN_BINDING (3)
14#define MAX_BINDINGS (4)
15
16/**
17 * struct iwl_binding_cmd_v1 - configuring bindings
18 * ( BINDING_CONTEXT_CMD = 0x2b )
19 * @id_and_color: ID and color of the relevant Binding,
20 * &enum iwl_ctxt_id_and_color
21 * @action: action to perform, one of FW_CTXT_ACTION_*
22 * @macs: array of MAC id and colors which belong to the binding,
23 * &enum iwl_ctxt_id_and_color
24 * @phy: PHY id and color which belongs to the binding,
25 * &enum iwl_ctxt_id_and_color
26 */
27struct iwl_binding_cmd_v1 {
28 /* COMMON_INDEX_HDR_API_S_VER_1 */
29 __le32 id_and_color;
30 __le32 action;
31 /* BINDING_DATA_API_S_VER_1 */
32 __le32 macs[MAX_MACS_IN_BINDING];
33 __le32 phy;
34} __packed; /* BINDING_CMD_API_S_VER_1 */
35
36/**
37 * struct iwl_binding_cmd - configuring bindings
38 * ( BINDING_CONTEXT_CMD = 0x2b )
39 * @id_and_color: ID and color of the relevant Binding,
40 * &enum iwl_ctxt_id_and_color
41 * @action: action to perform, one of FW_CTXT_ACTION_*
42 * @macs: array of MAC id and colors which belong to the binding
43 * &enum iwl_ctxt_id_and_color
44 * @phy: PHY id and color which belongs to the binding
45 * &enum iwl_ctxt_id_and_color
46 * @lmac_id: the lmac id the binding belongs to
47 */
48struct iwl_binding_cmd {
49 /* COMMON_INDEX_HDR_API_S_VER_1 */
50 __le32 id_and_color;
51 __le32 action;
52 /* BINDING_DATA_API_S_VER_1 */
53 __le32 macs[MAX_MACS_IN_BINDING];
54 __le32 phy;
55 __le32 lmac_id;
56} __packed; /* BINDING_CMD_API_S_VER_2 */
57
58#define IWL_BINDING_CMD_SIZE_V1 sizeof(struct iwl_binding_cmd_v1)
59#define IWL_LMAC_24G_INDEX 0
60#define IWL_LMAC_5G_INDEX 1
61
62static inline u32 iwl_mvm_get_lmac_id(const struct iwl_fw *fw,
63 enum nl80211_band band){
64 if (!fw_has_capa(&fw->ucode_capa, IWL_UCODE_TLV_CAPA_CDB_SUPPORT) ||
65 band == NL80211_BAND_2GHZ)
66 return IWL_LMAC_24G_INDEX;
67 return IWL_LMAC_5G_INDEX;
68}
69
70/* The maximal number of fragments in the FW's schedule session */
71#define IWL_MVM_MAX_QUOTA 128
72
73/**
74 * struct iwl_time_quota_data_v1 - configuration of time quota per binding
75 * @id_and_color: ID and color of the relevant Binding,
76 * &enum iwl_ctxt_id_and_color
77 * @quota: absolute time quota in TU. The scheduler will try to divide the
78 * remainig quota (after Time Events) according to this quota.
79 * @max_duration: max uninterrupted context duration in TU
80 */
81struct iwl_time_quota_data_v1 {
82 __le32 id_and_color;
83 __le32 quota;
84 __le32 max_duration;
85} __packed; /* TIME_QUOTA_DATA_API_S_VER_1 */
86
87/**
88 * struct iwl_time_quota_cmd - configuration of time quota between bindings
89 * ( TIME_QUOTA_CMD = 0x2c )
90 * @quotas: allocations per binding
91 * Note: on non-CDB the fourth one is the auxilary mac and is
92 * essentially zero.
93 * On CDB the fourth one is a regular binding.
94 */
95struct iwl_time_quota_cmd_v1 {
96 struct iwl_time_quota_data_v1 quotas[MAX_BINDINGS];
97} __packed; /* TIME_QUOTA_ALLOCATION_CMD_API_S_VER_1 */
98
99enum iwl_quota_low_latency {
100 IWL_QUOTA_LOW_LATENCY_NONE = 0,
101 IWL_QUOTA_LOW_LATENCY_TX = BIT(0),
102 IWL_QUOTA_LOW_LATENCY_RX = BIT(1),
103 IWL_QUOTA_LOW_LATENCY_TX_RX =
104 IWL_QUOTA_LOW_LATENCY_TX | IWL_QUOTA_LOW_LATENCY_RX,
105};
106
107/**
108 * struct iwl_time_quota_data - configuration of time quota per binding
109 * @id_and_color: ID and color of the relevant Binding.
110 * @quota: absolute time quota in TU. The scheduler will try to divide the
111 * remainig quota (after Time Events) according to this quota.
112 * @max_duration: max uninterrupted context duration in TU
113 * @low_latency: low latency status, &enum iwl_quota_low_latency
114 */
115struct iwl_time_quota_data {
116 __le32 id_and_color;
117 __le32 quota;
118 __le32 max_duration;
119 __le32 low_latency;
120} __packed; /* TIME_QUOTA_DATA_API_S_VER_2 */
121
122/**
123 * struct iwl_time_quota_cmd - configuration of time quota between bindings
124 * ( TIME_QUOTA_CMD = 0x2c )
125 * Note: on non-CDB the fourth one is the auxilary mac and is essentially zero.
126 * On CDB the fourth one is a regular binding.
127 *
128 * @quotas: allocations per binding
129 */
130struct iwl_time_quota_cmd {
131 struct iwl_time_quota_data quotas[MAX_BINDINGS];
132} __packed; /* TIME_QUOTA_ALLOCATION_CMD_API_S_VER_2 */
133
134#endif /* __iwl_fw_api_binding_h__ */