| 1 |
/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ |
| 2 |
/* |
| 3 |
* Copyright (C) 2025 Intel Corporation |
| 4 |
*/ |
| 5 |
#ifndef __iwl_fw_api_dhc_h__ |
| 6 |
#define __iwl_fw_api_dhc_h__ |
| 7 |
|
| 8 |
#define DHC_TABLE_MASK_POS (28) |
| 9 |
|
| 10 |
/** |
| 11 |
* enum iwl_dhc_table_id - DHC table operations index |
| 12 |
*/ |
| 13 |
enum iwl_dhc_table_id { |
| 14 |
/** |
| 15 |
* @DHC_TABLE_INTEGRATION: select the integration table |
| 16 |
*/ |
| 17 |
DHC_TABLE_INTEGRATION = 2 << DHC_TABLE_MASK_POS, |
| 18 |
/** |
| 19 |
* @DHC_TABLE_TOOLS: select the tools table |
| 20 |
*/ |
| 21 |
DHC_TABLE_TOOLS = 0, |
| 22 |
}; |
| 23 |
|
| 24 |
/** |
| 25 |
* enum iwl_dhc_umac_tools_table - tools operations |
| 26 |
* @DHC_TOOLS_UMAC_GET_TAS_STATUS: Get TAS status. |
| 27 |
* See @struct iwl_dhc_tas_status_resp |
| 28 |
*/ |
| 29 |
enum iwl_dhc_umac_tools_table { |
| 30 |
DHC_TOOLS_UMAC_GET_TAS_STATUS = 0, |
| 31 |
}; |
| 32 |
|
| 33 |
/** |
| 34 |
* enum iwl_dhc_umac_integration_table - integration operations |
| 35 |
*/ |
| 36 |
enum iwl_dhc_umac_integration_table { |
| 37 |
/** |
| 38 |
* @DHC_INT_UMAC_TWT_OPERATION: trigger a TWT operation |
| 39 |
*/ |
| 40 |
DHC_INT_UMAC_TWT_OPERATION = 4, |
| 41 |
/** |
| 42 |
* @DHC_INTEGRATION_TLC_DEBUG_CONFIG: TLC debug |
| 43 |
*/ |
| 44 |
DHC_INTEGRATION_TLC_DEBUG_CONFIG = 1, |
| 45 |
/** |
| 46 |
* @DHC_INTEGRATION_MAX: Maximum UMAC integration table entries |
| 47 |
*/ |
| 48 |
DHC_INTEGRATION_MAX |
| 49 |
}; |
| 50 |
|
| 51 |
#define DHC_TARGET_UMAC BIT(27) |
| 52 |
|
| 53 |
/** |
| 54 |
* struct iwl_dhc_cmd - debug host command |
| 55 |
* @length: length in DWs of the data structure that is concatenated to the end |
| 56 |
* of this struct |
| 57 |
* @index_and_mask: bit 31 is 1 for data set operation else it's 0 |
| 58 |
* bits 28-30 is the index of the table of the operation - |
| 59 |
* &enum iwl_dhc_table_id * |
| 60 |
* bit 27 is 0 if the cmd targeted to LMAC and 1 if targeted to UMAC, |
| 61 |
* (LMAC is 0 for backward compatibility) |
| 62 |
* bit 26 is 0 if the cmd targeted to LMAC0 and 1 if targeted to LMAC1, |
| 63 |
* relevant only if bit 27 set to 0 |
| 64 |
* bits 0-25 is a specific entry index in the table specified in bits 28-30 |
| 65 |
* |
| 66 |
* @data: the concatenated data. |
| 67 |
*/ |
| 68 |
struct iwl_dhc_cmd { |
| 69 |
__le32 length; |
| 70 |
__le32 index_and_mask; |
| 71 |
__le32 data[]; |
| 72 |
} __packed; /* DHC_CMD_API_S */ |
| 73 |
|
| 74 |
/** |
| 75 |
* struct iwl_dhc_payload_hdr - DHC payload header |
| 76 |
* @version: a version of a payload |
| 77 |
* @reserved: reserved for alignment |
| 78 |
*/ |
| 79 |
struct iwl_dhc_payload_hdr { |
| 80 |
u8 version; |
| 81 |
u8 reserved[3]; |
| 82 |
} __packed; /* DHC_PAYLOAD_HDR_API_S_VER_1 */ |
| 83 |
|
| 84 |
/** |
| 85 |
* struct iwl_dhc_tas_status_per_radio - TAS status per radio |
| 86 |
* @band: &PHY_BAND_5 for high band, PHY_BAND_24 for low band and |
| 87 |
* &PHY_BAND_6 for ultra high band. |
| 88 |
* @static_status: TAS statically enabled or disabled |
| 89 |
* @static_disable_reason: TAS static disable reason, uses |
| 90 |
* &enum iwl_tas_statically_disabled_reason |
| 91 |
* @near_disconnection: is TAS currently near disconnection per radio |
| 92 |
* @dynamic_status_ant_a: Antenna A current TAS status. |
| 93 |
* uses &enum iwl_tas_dyna_status |
| 94 |
* @dynamic_status_ant_b: Antenna B current TAS status. |
| 95 |
* uses &enum iwl_tas_dyna_status |
| 96 |
* @max_reg_pwr_limit_ant_a: Antenna A regulatory power limits in dBm |
| 97 |
* @max_reg_pwr_limit_ant_b: Antenna B regulatory power limits in dBm |
| 98 |
* @sar_limit_ant_a: Antenna A SAR limit per radio in dBm |
| 99 |
* @sar_limit_ant_b: Antenna B SAR limit per radio in dBm |
| 100 |
* @reserved: reserved for alignment |
| 101 |
*/ |
| 102 |
struct iwl_dhc_tas_status_per_radio { |
| 103 |
u8 band; |
| 104 |
u8 static_status; |
| 105 |
u8 static_disable_reason; |
| 106 |
u8 near_disconnection; |
| 107 |
u8 dynamic_status_ant_a; |
| 108 |
u8 dynamic_status_ant_b; |
| 109 |
__le16 max_reg_pwr_limit_ant_a; |
| 110 |
__le16 max_reg_pwr_limit_ant_b; |
| 111 |
__le16 sar_limit_ant_a; |
| 112 |
__le16 sar_limit_ant_b; |
| 113 |
u8 reserved[2]; |
| 114 |
} __packed; /* DHC_TAS_STATUS_PER_RADIO_S_VER_1 */ |
| 115 |
|
| 116 |
/** |
| 117 |
* struct iwl_dhc_tas_status_resp - Response to DHC_TOOLS_UMAC_GET_TAS_STATUS |
| 118 |
* @header: DHC payload header, uses &struct iwl_dhc_payload_hdr |
| 119 |
* @tas_config_info: see @struct bios_value_u32 |
| 120 |
* @mcc_block_list: block listed country codes |
| 121 |
* @tas_status_radio: TAS status, uses &struct iwl_dhc_tas_status_per_radio |
| 122 |
* @curr_mcc: current mcc |
| 123 |
* @valid_radio_mask: represent entry in tas_status_per_radio is valid. |
| 124 |
* @reserved: reserved for alignment |
| 125 |
*/ |
| 126 |
struct iwl_dhc_tas_status_resp { |
| 127 |
struct iwl_dhc_payload_hdr header; |
| 128 |
struct bios_value_u32 tas_config_info; |
| 129 |
__le16 mcc_block_list[IWL_WTAS_BLACK_LIST_MAX]; |
| 130 |
struct iwl_dhc_tas_status_per_radio tas_status_radio[2]; |
| 131 |
__le16 curr_mcc; |
| 132 |
u8 valid_radio_mask; |
| 133 |
u8 reserved; |
| 134 |
} __packed; /* DHC_TAS_STATUS_RSP_API_S_VER_1 */ |
| 135 |
|
| 136 |
/** |
| 137 |
* struct iwl_dhc_cmd_resp_v1 - debug host command response |
| 138 |
* @status: status of the command |
| 139 |
* @data: the response data |
| 140 |
*/ |
| 141 |
struct iwl_dhc_cmd_resp_v1 { |
| 142 |
__le32 status; |
| 143 |
__le32 data[]; |
| 144 |
} __packed; /* DHC_RESP_API_S_VER_1 */ |
| 145 |
|
| 146 |
/** |
| 147 |
* struct iwl_dhc_cmd_resp - debug host command response |
| 148 |
* @status: status of the command |
| 149 |
* @descriptor: command descriptor (index_and_mask) returned |
| 150 |
* @data: the response data |
| 151 |
*/ |
| 152 |
struct iwl_dhc_cmd_resp { |
| 153 |
__le32 status; |
| 154 |
__le32 descriptor; |
| 155 |
__le32 data[]; |
| 156 |
} __packed; /* DHC_RESP_API_S_VER_2 and DHC_RESP_API_S_VER_3 */ |
| 157 |
|
| 158 |
/** |
| 159 |
* enum iwl_dhc_twt_operation_type - describes the TWT operation type |
| 160 |
* |
| 161 |
* @DHC_TWT_REQUEST: Send a Request TWT command |
| 162 |
* @DHC_TWT_SUGGEST: Send a Suggest TWT command |
| 163 |
* @DHC_TWT_DEMAND: Send a Demand TWT command |
| 164 |
* @DHC_TWT_GROUPING: Send a Grouping TWT command |
| 165 |
* @DHC_TWT_ACCEPT: Send a Accept TWT command |
| 166 |
* @DHC_TWT_ALTERNATE: Send a Alternate TWT command |
| 167 |
* @DHC_TWT_DICTATE: Send a Dictate TWT command |
| 168 |
* @DHC_TWT_REJECT: Send a Reject TWT command |
| 169 |
* @DHC_TWT_TEARDOWN: Send a TearDown TWT command |
| 170 |
*/ |
| 171 |
enum iwl_dhc_twt_operation_type { |
| 172 |
DHC_TWT_REQUEST, |
| 173 |
DHC_TWT_SUGGEST, |
| 174 |
DHC_TWT_DEMAND, |
| 175 |
DHC_TWT_GROUPING, |
| 176 |
DHC_TWT_ACCEPT, |
| 177 |
DHC_TWT_ALTERNATE, |
| 178 |
DHC_TWT_DICTATE, |
| 179 |
DHC_TWT_REJECT, |
| 180 |
DHC_TWT_TEARDOWN, |
| 181 |
}; /* DHC_TWT_OPERATION_TYPE_E */ |
| 182 |
|
| 183 |
/** |
| 184 |
* struct iwl_dhc_twt_operation - trigger a TWT operation |
| 185 |
* |
| 186 |
* @mac_id: the mac Id on which to trigger TWT operation |
| 187 |
* @twt_operation: see &enum iwl_dhc_twt_operation_type |
| 188 |
* @target_wake_time: when should we be on channel |
| 189 |
* @interval_exp: the exponent for the interval |
| 190 |
* @interval_mantissa: the mantissa for the interval |
| 191 |
* @min_wake_duration: the minimum duration for the wake period |
| 192 |
* @trigger: is the TWT triggered or not |
| 193 |
* @flow_type: is the TWT announced or not |
| 194 |
* @flow_id: the TWT flow identifier from 0 to 7 |
| 195 |
* @protection: is the TWT protected |
| 196 |
* @ndo_paging_indicator: is ndo_paging_indicator set |
| 197 |
* @responder_pm_mode: is responder_pm_mode set |
| 198 |
* @negotiation_type: if the responder wants to doze outside the TWT SP |
| 199 |
* @twt_request: 1 for TWT request, 0 otherwise |
| 200 |
* @implicit: is TWT implicit |
| 201 |
* @twt_group_assignment: the TWT group assignment |
| 202 |
* @twt_channel: the TWT channel |
| 203 |
* @reserved: reserved |
| 204 |
*/ |
| 205 |
struct iwl_dhc_twt_operation { |
| 206 |
__le32 mac_id; |
| 207 |
__le32 twt_operation; |
| 208 |
__le64 target_wake_time; |
| 209 |
__le32 interval_exp; |
| 210 |
__le32 interval_mantissa; |
| 211 |
__le32 min_wake_duration; |
| 212 |
u8 trigger; |
| 213 |
u8 flow_type; |
| 214 |
u8 flow_id; |
| 215 |
u8 protection; |
| 216 |
u8 ndo_paging_indicator; |
| 217 |
u8 responder_pm_mode; |
| 218 |
u8 negotiation_type; |
| 219 |
u8 twt_request; |
| 220 |
u8 implicit; |
| 221 |
u8 twt_group_assignment; |
| 222 |
u8 twt_channel; |
| 223 |
u8 reserved; |
| 224 |
}; /* DHC_TWT_OPERATION_API_S */ |
| 225 |
|
| 226 |
#endif /* __iwl_fw_api_dhc_h__ */ |