/* SPDX-License-Identifier: GPL-2.0-only */
/*
* WSM host interface (HI) interface for ST-Ericsson CW1200 mac80211 drivers
*
* Copyright (c) 2010, ST-Ericsson
* Author: Dmitry Tarnyagin <dmitry.tarnyagin@lockless.no>
*
* Based on CW1200 UMAC WSM API, which is
* Copyright (C) ST-Ericsson SA 2010
* Author: Stewart Mathers <stewart.mathers@stericsson.com>
*/
#ifndef CW1200_WSM_H_INCLUDED
#define CW1200_WSM_H_INCLUDED
#include <linux/spinlock.h>
struct cw1200_common;
/* Bands */
/* Radio band 2.412 -2.484 GHz. */
#define WSM_PHY_BAND_2_4G (0)
/* Radio band 4.9375-5.8250 GHz. */
#define WSM_PHY_BAND_5G (1)
/* Transmit rates */
/* 1 Mbps ERP-DSSS */
#define WSM_TRANSMIT_RATE_1 (0)
/* 2 Mbps ERP-DSSS */
#define WSM_TRANSMIT_RATE_2 (1)
/* 5.5 Mbps ERP-CCK */
#define WSM_TRANSMIT_RATE_5 (2)
/* 11 Mbps ERP-CCK */
#define WSM_TRANSMIT_RATE_11 (3)
/* 22 Mbps ERP-PBCC (Not supported) */
/* #define WSM_TRANSMIT_RATE_22 (4) */
/* 33 Mbps ERP-PBCC (Not supported) */
/* #define WSM_TRANSMIT_RATE_33 (5) */
/* 6 Mbps (3 Mbps) ERP-OFDM, BPSK coding rate 1/2 */
#define WSM_TRANSMIT_RATE_6 (6)
/* 9 Mbps (4.5 Mbps) ERP-OFDM, BPSK coding rate 3/4 */
#define WSM_TRANSMIT_RATE_9 (7)
/* 12 Mbps (6 Mbps) ERP-OFDM, QPSK coding rate 1/2 */
#define WSM_TRANSMIT_RATE_12 (8)
/* 18 Mbps (9 Mbps) ERP-OFDM, QPSK coding rate 3/4 */
#define WSM_TRANSMIT_RATE_18 (9)
/* 24 Mbps (12 Mbps) ERP-OFDM, 16QAM coding rate 1/2 */
#define WSM_TRANSMIT_RATE_24 (10)
/* 36 Mbps (18 Mbps) ERP-OFDM, 16QAM coding rate 3/4 */
#define WSM_TRANSMIT_RATE_36 (11)
/* 48 Mbps (24 Mbps) ERP-OFDM, 64QAM coding rate 1/2 */
#define WSM_TRANSMIT_RATE_48 (12)
/* 54 Mbps (27 Mbps) ERP-OFDM, 64QAM coding rate 3/4 */
#define WSM_TRANSMIT_RATE_54 (13)
/* 6.5 Mbps HT-OFDM, BPSK coding rate 1/2 */
#define WSM_TRANSMIT_RATE_HT_6 (14)
/* 13 Mbps HT-OFDM, QPSK coding rate 1/2 */
#define WSM_TRANSMIT_RATE_HT_13 (15)
/* 19.5 Mbps HT-OFDM, QPSK coding rate 3/4 */
#define WSM_TRANSMIT_RATE_HT_19 (16)
/* 26 Mbps HT-OFDM, 16QAM coding rate 1/2 */
#define WSM_TRANSMIT_RATE_HT_26 (17)
/* 39 Mbps HT-OFDM, 16QAM coding rate 3/4 */
#define WSM_TRANSMIT_RATE_HT_39 (18)
/* 52 Mbps HT-OFDM, 64QAM coding rate 2/3 */
#define WSM_TRANSMIT_RATE_HT_52 (19)
/* 58.5 Mbps HT-OFDM, 64QAM coding rate 3/4 */
#define WSM_TRANSMIT_RATE_HT_58 (20)
/* 65 Mbps HT-OFDM, 64QAM coding rate 5/6 */
#define WSM_TRANSMIT_RATE_HT_65 (21)
/* Scan types */
/* Foreground scan */
#define WSM_SCAN_TYPE_FOREGROUND (0)
/* Background scan */
#define WSM_SCAN_TYPE_BACKGROUND (1)
/* Auto scan */
#define WSM_SCAN_TYPE_AUTO (2)
/* Scan flags */
/* Forced background scan means if the station cannot */
/* enter the power-save mode, it shall force to perform a */
/* background scan. Only valid when ScanType is */
/* background scan. */
#define WSM_SCAN_FLAG_FORCE_BACKGROUND (BIT(0))
/* The WLAN device scans one channel at a time so */
/* that disturbance to the data traffic is minimized. */
#define WSM_SCAN_FLAG_SPLIT_METHOD (BIT(1))
/* Preamble Type. Long if not set. */
#define WSM_SCAN_FLAG_SHORT_PREAMBLE (BIT(2))
/* 11n Tx Mode. Mixed if not set. */
#define WSM_SCAN_FLAG_11N_GREENFIELD (BIT(3))
/* Scan constraints */
/* Maximum number of channels to be scanned. */
#define WSM_SCAN_MAX_NUM_OF_CHANNELS (48)
/* The maximum number of SSIDs that the device can scan for. */
#define WSM_SCAN_MAX_NUM_OF_SSIDS (2)
/* Power management modes */
/* 802.11 Active mode */
#define WSM_PSM_ACTIVE (0)
/* 802.11 PS mode */
#define WSM_PSM_PS BIT(0)
/* Fast Power Save bit */
#define WSM_PSM_FAST_PS_FLAG BIT(7)
/* Dynamic aka Fast power save */
#define WSM_PSM_FAST_PS (BIT(0) | BIT(7))
/* Undetermined */
/* Note : Undetermined status is reported when the */
/* NULL data frame used to advertise the PM mode to */
/* the AP at Pre or Post Background Scan is not Acknowledged */
#define WSM_PSM_UNKNOWN BIT(1)
/* Queue IDs */
/* best effort/legacy */
#define WSM_QUEUE_BEST_EFFORT (0)
/* background */
#define WSM_QUEUE_BACKGROUND (1)
/* video */
#define WSM_QUEUE_VIDEO (2)
/* voice */
#define WSM_QUEUE_VOICE (3)
/* HT TX parameters */
/* Non-HT */
#define WSM_HT_TX_NON_HT (0)
/* Mixed format */
#define WSM_HT_TX_MIXED (1)
/* Greenfield format */
#define WSM_HT_TX_GREENFIELD (2)
/* STBC allowed */
#define WSM_HT_TX_STBC (BIT(7))
/* EPTA prioirty flags for BT Coex */
/* default epta priority */
#define WSM_EPTA_PRIORITY_DEFAULT 4
/* use for normal data */
#define WSM_EPTA_PRIORITY_DATA 4
/* use for connect/disconnect/roaming*/
#define WSM_EPTA_PRIORITY_MGT 5
/* use for action frames */
#define WSM_EPTA_PRIORITY_ACTION 5
/* use for AC_VI data */
#define WSM_EPTA_PRIORITY_VIDEO 5
/* use for AC_VO data */
#define WSM_EPTA_PRIORITY_VOICE 6
/* use for EAPOL exchange */
#define WSM_EPTA_PRIORITY_EAPOL 7
/* TX status */
/* Frame was sent aggregated */
/* Only valid for WSM_SUCCESS status. */
#define WSM_TX_STATUS_AGGREGATION (BIT(0))
/* Host should requeue this frame later. */
/* Valid only when status is WSM_REQUEUE. */
#define WSM_TX_STATUS_REQUEUE (BIT(1))
/* Normal Ack */
#define WSM_TX_STATUS_NORMAL_ACK (0<<2)
/* No Ack */
#define WSM_TX_STATUS_NO_ACK (1<<2)
/* No explicit acknowledgement */
#define WSM_TX_STATUS_NO_EXPLICIT_ACK (2<<2)
/* Block Ack */
/* Only valid for WSM_SUCCESS status. */
#define WSM_TX_STATUS_BLOCK_ACK (3<<2)
/* RX status */
/* Unencrypted */
#define WSM_RX_STATUS_UNENCRYPTED (0<<0)
/* WEP */
#define WSM_RX_STATUS_WEP (1<<0)
/* TKIP */
#define WSM_RX_STATUS_TKIP (2<<0)
/* AES */
#define WSM_RX_STATUS_AES (3<<0)
/* WAPI */
#define WSM_RX_STATUS_WAPI (4<<0)
/* Macro to fetch encryption subfield. */
#define WSM_RX_STATUS_ENCRYPTION(status) ((status) & 0x07)
/* Frame was part of an aggregation */
#define WSM_RX_STATUS_AGGREGATE (BIT(3))
/* Frame was first in the aggregation */
#define WSM_RX_STATUS_AGGREGATE_FIRST (BIT(4))
/* Frame was last in the aggregation */
#define WSM_RX_STATUS_AGGREGATE_LAST (BIT(5))
/* Indicates a defragmented frame */
#define WSM_RX_STATUS_DEFRAGMENTED (BIT(6))
/* Indicates a Beacon frame */
#define WSM_RX_STATUS_BEACON (BIT(7))
/* Indicates STA bit beacon TIM field */
#define WSM_RX_STATUS_TIM (BIT(8))
/* Indicates Beacon frame's virtual bitmap contains multicast bit */
#define WSM_RX_STATUS_MULTICAST (BIT(9))
/* Indicates frame contains a matching SSID */
#define WSM_RX_STATUS_MATCHING_SSID (BIT(10))
/* Indicates frame contains a matching BSSI */
#define WSM_RX_STATUS_MATCHING_BSSI (BIT(11))
/* Indicates More bit set in Framectl field */
#define WSM_RX_STATUS_MORE_DATA (BIT(12))
/* Indicates frame received during a measurement process */
#define WSM_RX_STATUS_MEASUREMENT (BIT(13))
/* Indicates frame received as an HT packet */
#define WSM_RX_STATUS_HT (BIT(14))
/* Indicates frame received with STBC */
#define WSM_RX_STATUS_STBC (BIT(15))
/* Indicates Address 1 field matches dot11StationId */
#define WSM_RX_STATUS_ADDRESS1 (BIT(16))
/* Indicates Group address present in the Address 1 field */
#define WSM_RX_STATUS_GROUP (BIT(17))
/* Indicates Broadcast address present in the Address 1 field */
#define WSM_RX_STATUS_BROADCAST (BIT(18))
/* Indicates group key used with encrypted frames */
#define WSM_RX_STATUS_GROUP_KEY (BIT(19))
/* Macro to fetch encryption key index. */
#define WSM_RX_STATUS_KEY_IDX(status) (((status >> 20)) & 0x0F)
/* Indicates TSF inclusion after 802.11 frame body */
#define WSM_RX_STATUS_TSF_INCLUDED (BIT(24))
/* Frame Control field starts at Frame offset + 2 */
#define WSM_TX_2BYTES_SHIFT (BIT(7))
/* Join mode */
/* IBSS */
#define WSM_JOIN_MODE_IBSS (0)
/* BSS */
#define WSM_JOIN_MODE_BSS (1)
/* PLCP preamble type */
/* For long preamble */
#define WSM_JOIN_PREAMBLE_LONG (0)
/* For short preamble (Long for 1Mbps) */
#define WSM_JOIN_PREAMBLE_SHORT (1)
/* For short preamble (Long for 1 and 2Mbps) */
#define WSM_JOIN_PREAMBLE_SHORT_2 (2)
/* Join flags */
/* Unsynchronized */
#define WSM_JOIN_FLAGS_UNSYNCRONIZED BIT(0)
/* The BSS owner is a P2P GO */
#define WSM_JOIN_FLAGS_P2P_GO BIT(1)
/* Force to join BSS with the BSSID and the
* SSID specified without waiting for beacons. The
* ProbeForJoin parameter is ignored.
*/
#define WSM_JOIN_FLAGS_FORCE BIT(2)
/* Give probe request/response higher
* priority over the BT traffic
*/
#define WSM_JOIN_FLAGS_PRIO BIT(3)
/* Issue immediate join confirmation and use
* join complete to notify about completion
*/
#define WSM_JOIN_FLAGS_FORCE_WITH_COMPLETE_IND BIT(5)
/* Key types */
#define WSM_KEY_TYPE_WEP_DEFAULT (0)
#define WSM_KEY_TYPE_WEP_PAIRWISE (1)
#define WSM_KEY_TYPE_TKIP_GROUP (2)
#define WSM_KEY_TYPE_TKIP_PAIRWISE (3)
#define WSM_KEY_TYPE_AES_GROUP (4)
#define WSM_KEY_TYPE_AES_PAIRWISE (5)
#define WSM_KEY_TYPE_WAPI_GROUP (6)
#define WSM_KEY_TYPE_WAPI_PAIRWISE (7)
/* Key indexes */
#define WSM_KEY_MAX_INDEX (10)
/* ACK policy */
#define WSM_ACK_POLICY_NORMAL (0)
#define WSM_ACK_POLICY_NO_ACK (1)
/* Start modes */
#define WSM_START_MODE_AP (0) /* Mini AP */
#define WSM_START_MODE_P2P_GO (1) /* P2P GO */
#define WSM_START_MODE_P2P_DEV (2) /* P2P device */
/* SetAssociationMode MIB flags */
#define WSM_ASSOCIATION_MODE_USE_PREAMBLE_TYPE (BIT(0))
#define WSM_ASSOCIATION_MODE_USE_HT_MODE (BIT(1))
#define WSM_ASSOCIATION_MODE_USE_BASIC_RATE_SET (BIT(2))
#define WSM_ASSOCIATION_MODE_USE_MPDU_START_SPACING (BIT(3))
#define WSM_ASSOCIATION_MODE_SNOOP_ASSOC_FRAMES (BIT(4))
/* RcpiRssiThreshold MIB flags */
#define WSM_RCPI_RSSI_THRESHOLD_ENABLE (BIT(0))
#define WSM_RCPI_RSSI_USE_RSSI (BIT(1))
#define WSM_RCPI_RSSI_DONT_USE_UPPER (BIT(2))
#define WSM_RCPI_RSSI_DONT_USE_LOWER (BIT(3))
/* Update-ie constants */
#define WSM_UPDATE_IE_BEACON (BIT(0))
#define WSM_UPDATE_IE_PROBE_RESP (BIT(1))
#define WSM_UPDATE_IE_PROBE_REQ (BIT(2))
/* WSM events */
/* Error */
#define WSM_EVENT_ERROR (0)
/* BSS lost */
#define WSM_EVENT_BSS_LOST (1)
/* BSS regained */
#define WSM_EVENT_BSS_REGAINED (2)
/* Radar detected */
#define WSM_EVENT_RADAR_DETECTED (3)
/* RCPI or RSSI threshold triggered */
#define WSM_EVENT_RCPI_RSSI (4)
/* BT inactive */
#define WSM_EVENT_BT_INACTIVE (5)
/* BT active */
#define WSM_EVENT_BT_ACTIVE (6)
/* MIB IDs */
/* 4.1 dot11StationId */
#define WSM_MIB_ID_DOT11_STATION_ID 0x0000
/* 4.2 dot11MaxtransmitMsduLifeTime */
#define WSM_MIB_ID_DOT11_MAX_TRANSMIT_LIFTIME 0x0001
/* 4.3 dot11MaxReceiveLifeTime */
#define WSM_MIB_ID_DOT11_MAX_RECEIVE_LIFETIME 0x0002
/* 4.4 dot11SlotTime */
#define WSM_MIB_ID_DOT11_SLOT_TIME 0x0003
/* 4.5 dot11GroupAddressesTable */
#define WSM_MIB_ID_DOT11_GROUP_ADDRESSES_TABLE 0x0004
#define WSM_MAX_GRP_ADDRTABLE_ENTRIES 8
/* 4.6 dot11WepDefaultKeyId */
#define WSM_MIB_ID_DOT11_WEP_DEFAULT_KEY_ID 0x0005
/* 4.7 dot11CurrentTxPowerLevel */
#define WSM_MIB_ID_DOT11_CURRENT_TX_POWER_LEVEL 0x0006
/* 4.8 dot11RTSThreshold */
#define WSM_MIB_ID_DOT11_RTS_THRESHOLD 0x0007
/* 4.9 NonErpProtection */
#define WSM_MIB_ID_NON_ERP_PROTECTION 0x1000
/* 4.10 ArpIpAddressesTable */
#define WSM_MIB_ID_ARP_IP_ADDRESSES_TABLE 0x1001
#define WSM_MAX_ARP_IP_ADDRTABLE_ENTRIES 1
/* 4.11 TemplateFrame */
#define WSM_MIB_ID_TEMPLATE_FRAME 0x1002
/* 4.12 RxFilter */
#define WSM_MIB_ID_RX_FILTER 0x1003
/* 4.13 BeaconFilterTable */
#define WSM_MIB_ID_BEACON_FILTER_TABLE 0x1004
/* 4.14 BeaconFilterEnable */
#define WSM_MIB_ID_BEACON_FILTER_ENABLE 0x1005
/* 4.15 OperationalPowerMode */
#define WSM_MIB_ID_OPERATIONAL_POWER_MODE 0x1006
/* 4.16 BeaconWakeUpPeriod */
#define WSM_MIB_ID_BEACON_WAKEUP_PERIOD 0x1007
/* 4.17 RcpiRssiThreshold */
#define WSM_MIB_ID_RCPI_RSSI_THRESHOLD 0x1009
/* 4.18 StatisticsTable */
#define WSM_MIB_ID_STATISTICS_TABLE 0x100A
/* 4.19 IbssPsConfig */
#define WSM_MIB_ID_IBSS_PS_CONFIG 0x100B
/* 4.20 CountersTable */
#define WSM_MIB_ID_COUNTERS_TABLE 0x100C
/* 4.21 BlockAckPolicy */
#define WSM_MIB_ID_BLOCK_ACK_POLICY 0x100E
/* 4.22 OverrideInternalTxRate */
#define WSM_MIB_ID_OVERRIDE_INTERNAL_TX_RATE 0x100F
/* 4.23 SetAssociationMode */
#define WSM_MIB_ID_SET_ASSOCIATION_MODE 0x1010
/* 4.24 UpdateEptaConfigData */
#define WSM_MIB_ID_UPDATE_EPTA_CONFIG_DATA 0x1011
/* 4.25 SelectCcaMethod */
#define WSM_MIB_ID_SELECT_CCA_METHOD 0x1012
/* 4.26 SetUpasdInformation */
#define WSM_MIB_ID_SET_UAPSD_INFORMATION 0x1013
/* 4.27 SetAutoCalibrationMode WBF00004073 */
#define WSM_MIB_ID_SET_AUTO_CALIBRATION_MODE 0x1015
/* 4.28 SetTxRateRetryPolicy */
#define WSM_MIB_ID_SET_TX_RATE_RETRY_POLICY 0x1016
/* 4.29 SetHostMessageTypeFilter */
#define WSM_MIB_ID_SET_HOST_MSG_TYPE_FILTER 0x1017
/* 4.30 P2PFindInfo */
#define WSM_MIB_ID_P2P_FIND_INFO 0x1018
/* 4.31 P2PPsModeInfo */
#define WSM_MIB_ID_P2P_PS_MODE_INFO 0x1019
/* 4.32 SetEtherTypeDataFrameFilter */
#define WSM_MIB_ID_SET_ETHERTYPE_DATAFRAME_FILTER 0x101A
/* 4.33 SetUDPPortDataFrameFilter */
#define WSM_MIB_ID_SET_UDPPORT_DATAFRAME_FILTER 0x101B
/* 4.34 SetMagicDataFrameFilter */
#define WSM_MIB_ID_SET_MAGIC_DATAFRAME_FILTER 0x101C
/* 4.35 P2PDeviceInfo */
#define WSM_MIB_ID_P2P_DEVICE_INFO 0x101D
/* 4.36 SetWCDMABand */
#define WSM_MIB_ID_SET_WCDMA_BAND 0x101E
/* 4.37 GroupTxSequenceCounter */
#define WSM_MIB_ID_GRP_SEQ_COUNTER 0x101F
/* 4.38 ProtectedMgmtPolicy */
#define WSM_MIB_ID_PROTECTED_MGMT_POLICY 0x1020
/* 4.39 SetHtProtection */
#define WSM_MIB_ID_SET_HT_PROTECTION 0x1021
/* 4.40 GPIO Command */
#define WSM_MIB_ID_GPIO_COMMAND 0x1022
/* 4.41 TSF Counter Value */
#define WSM_MIB_ID_TSF_COUNTER 0x1023
/* Test Purposes Only */
#define WSM_MIB_ID_BLOCK_ACK_INFO 0x100D
/* 4.42 UseMultiTxConfMessage */
#define WSM_MIB_USE_MULTI_TX_CONF 0x1024
/* 4.43 Keep-alive period */
#define WSM_MIB_ID_KEEP_ALIVE_PERIOD 0x1025
/* 4.44 Disable BSSID filter */
#define WSM_MIB_ID_DISABLE_BSSID_FILTER 0x1026
/* Frame template types */
#define WSM_FRAME_TYPE_PROBE_REQUEST (0)
#define WSM_FRAME_TYPE_BEACON (1)
#define WSM_FRAME_TYPE_NULL (2)
#define WSM_FRAME_TYPE_QOS_NULL (3)
#define WSM_FRAME_TYPE_PS_POLL (4)
#define WSM_FRAME_TYPE_PROBE_RESPONSE (5)
#define WSM_FRAME_GREENFIELD (0x80) /* See 4.11 */
/* Status */
/* The WSM firmware has completed a request */
/* successfully. */
#define WSM_STATUS_SUCCESS (0)
/* This is a generic failure code if other error codes do */
/* not apply. */
#define WSM_STATUS_FAILURE (1)
/* A request contains one or more invalid parameters. */
#define WSM_INVALID_PARAMETER (2)
/* The request cannot perform because the device is in */
/* an inappropriate mode. */
#define WSM_ACCESS_DENIED (3)
/* The frame received includes a decryption error. */
#define WSM_STATUS_DECRYPTFAILURE (4)
/* A MIC failure is detected in the received packets. */
#define WSM_STATUS_MICFAILURE (5)
/* The transmit request failed due to retry limit being */
/* exceeded. */
#define WSM_STATUS_RETRY_EXCEEDED (6)
/* The transmit request failed due to MSDU life time */
/* being exceeded. */
#define WSM_STATUS_TX_LIFETIME_EXCEEDED (7)
/* The link to the AP is lost. */
#define WSM_STATUS_LINK_LOST (8)
/* No key was found for the encrypted frame */
#define WSM_STATUS_NO_KEY_FOUND (9)
/* Jammer was detected when transmitting this frame */
#define WSM_STATUS_JAMMER_DETECTED (10)
/* The message should be requeued later. */
/* This is applicable only to Transmit */
#define WSM_REQUEUE (11)
/* Advanced filtering options */
#define WSM_MAX_FILTER_ELEMENTS (4)
#define WSM_FILTER_ACTION_IGNORE (0)
#define WSM_FILTER_ACTION_FILTER_IN (1)
#define WSM_FILTER_ACTION_FILTER_OUT (2)
#define WSM_FILTER_PORT_TYPE_DST (0)
#define WSM_FILTER_PORT_TYPE_SRC (1)
/* Actual header of WSM messages */
struct wsm_hdr {
__le16 len;
__le16 id;
};
#define WSM_TX_SEQ_MAX (7)
#define WSM_TX_SEQ(seq) \
((seq & WSM_TX_SEQ_MAX) << 13)
#define WSM_TX_LINK_ID_MAX (0x0F)
#define WSM_TX_LINK_ID(link_id) \
((link_id & WSM_TX_LINK_ID_MAX) << 6)
#define MAX_BEACON_SKIP_TIME_MS 1000
#define WSM_CMD_LAST_CHANCE_TIMEOUT (HZ * 3 / 2)
/* ******************************************************************** */
/* WSM capability */
#define WSM_STARTUP_IND_ID 0x0801
struct wsm_startup_ind {
u16 input_buffers;
u16 input_buffer_size;
u16 status;
u16 hw_id;
u16 hw_subid;
u16 fw_cap;
u16 fw_type;
u16 fw_api;
u16 fw_build;
u16 fw_ver;
char fw_label[128];
u32 config[4];
};
/* ******************************************************************** */
/* WSM commands */
/* 3.1 */
#define WSM_CONFIGURATION_REQ_ID 0x0009
#define WSM_CONFIGURATION_RESP_ID 0x0409
struct wsm_tx_power_range {
int min_power_level;
int max_power_level;
u32 stepping;
};
struct wsm_configuration {
/* [in] */ u32 dot11MaxTransmitMsduLifeTime;
/* [in] */ u32 dot11MaxReceiveLifeTime;
/* [in] */ u32 dot11RtsThreshold;
/* [in, out] */ u8 *dot11StationId;
/* [in] */ const void *dpdData;
/* [in] */ size_t dpdData_size;
/* [out] */ u8 dot11FrequencyBandsSupported;
/* [out] */ u32 supportedRateMask;
/* [out] */ struct wsm_tx_power_range txPowerRange[2];
};
int wsm_configuration(struct cw1200_common *priv,
struct wsm_configuration *arg);
/* 3.3 */
#define WSM_RESET_REQ_ID 0x000A
#define WSM_RESET_RESP_ID 0x040A
struct wsm_reset {
/* [in] */ int link_id;
/* [in] */ bool reset_statistics;
};
int wsm_reset(struct cw1200_common *priv, const struct wsm_reset *arg);
/* 3.5 */
#define WSM_READ_MIB_REQ_ID 0x0005
#define WSM_READ_MIB_RESP_ID 0x0405
int wsm_read_mib(struct cw1200_common *priv, u16 mib_id, void *buf,
size_t buf_size);
/* 3.7 */
#define WSM_WRITE_MIB_REQ_ID 0x0006
#define WSM_WRITE_MIB_RESP_ID 0x0406
int wsm_write_mib(struct cw1200_common *priv, u16 mib_id, void *buf,
size_t buf_size);
/* 3.9 */
#define WSM_START_SCAN_REQ_ID 0x0007
#define WSM_START_SCAN_RESP_ID 0x0407
struct wsm_ssid {
u8 ssid[32];
u32 length;
};
struct wsm_scan_ch {
u16 number;
u32 min_chan_time;
u32 max_chan_time;
u32 tx_power_level;
};
struct wsm_scan {
/* WSM_PHY_BAND_... */
u8 band;
/* WSM_SCAN_TYPE_... */
u8 type;
/* WSM_SCAN_FLAG_... */
u8 flags;
/* WSM_TRANSMIT_RATE_... */
u8 max_tx_rate;
/* Interval period in TUs that the device shall the re- */
/* execute the requested scan. Max value supported by the device */
/* is 256s. */
u32 auto_scan_interval;
/* Number of probe requests (per SSID) sent to one (1) */
/* channel. Zero (0) means that none is send, which */
/* means that a passive scan is to be done. Value */
/* greater than zero (0) means that an active scan is to */
/* be done. */
u32 num_probes;
/* Number of channels to be scanned. */
/* Maximum value is WSM_SCAN_MAX_NUM_OF_CHANNELS. */
u8 num_channels;
/* Number of SSID provided in the scan command (this */
/* is zero (0) in broadcast scan) */
/* The maximum number of SSIDs is WSM_SCAN_MAX_NUM_OF_SSIDS. */
u8 num_ssids;
/* The delay time (in microseconds) period */
/* before sending a probe-request. */
u8 probe_delay;
/* SSIDs to be scanned [numOfSSIDs]; */
struct wsm_ssid *ssids;
/* Channels to be scanned [numOfChannels]; */
struct wsm_scan_ch *ch;
};
int wsm_scan(struct cw1200_common *priv, const struct wsm_scan *arg);
/* 3.11 */
#define WSM_STOP_SCAN_REQ_ID 0x0008
#define WSM_STOP_SCAN_RESP_ID 0x0408
int wsm_stop_scan(struct cw1200_common *priv);
/* 3.13 */
#define WSM_SCAN_COMPLETE_IND_ID 0x0806
struct wsm_scan_complete {
/* WSM_STATUS_... */
u32 status;
/* WSM_PSM_... */
u8 psm;
/* Number of channels that the scan operation completed. */
u8 num_channels;
};
/* 3.14 */
#define WSM_TX_CONFIRM_IND_ID 0x0404
#define WSM_MULTI_TX_CONFIRM_ID 0x041E
struct wsm_tx_confirm {
/* Packet identifier used in wsm_tx. */
u32 packet_id;
/* WSM_STATUS_... */
u32 status;
/* WSM_TRANSMIT_RATE_... */
u8 tx_rate;
/* The number of times the frame was transmitted */
/* without receiving an acknowledgement. */
u8 ack_failures;
/* WSM_TX_STATUS_... */
u16 flags;
/* The total time in microseconds that the frame spent in */
/* the WLAN device before transmission as completed. */
u32 media_delay;
/* The total time in microseconds that the frame spent in */
/* the WLAN device before transmission was started. */
u32 tx_queue_delay;
};
/* 3.15 */
typedef void (*wsm_tx_confirm_cb) (struct cw1200_common *priv,
struct wsm_tx_confirm *arg);
/* Note that ideology of wsm_tx struct is different against the rest of
* WSM API. wsm_hdr is /not/ a caller-adapted struct to be used as an input
* argument for WSM call, but a prepared bytestream to be sent to firmware.
* It is filled partly in cw1200_tx, partly in low-level WSM code.
* Please pay attention once again: ideology is different.
*
* Legend:
* - [in]: cw1200_tx must fill this field.
* - [wsm]: the field is filled by low-level WSM.
*/
struct wsm_tx {
/* common WSM header */
struct wsm_hdr hdr;
/* Packet identifier that meant to be used in completion. */
u32 packet_id; /* Note this is actually a cookie */
/* WSM_TRANSMIT_RATE_... */
u8 max_tx_rate;
/* WSM_QUEUE_... */
u8 queue_id;
/* True: another packet is pending on the host for transmission. */
u8 more;
/* Bit 0 = 0 - Start expiry time from first Tx attempt (default) */
/* Bit 0 = 1 - Start expiry time from receipt of Tx Request */
/* Bits 3:1 - PTA Priority */
/* Bits 6:4 - Tx Rate Retry Policy */
/* Bit 7 - Reserved */
u8 flags;
/* Should be 0. */
u32 reserved;
/* The elapsed time in TUs, after the initial transmission */
/* of an MSDU, after which further attempts to transmit */
/* the MSDU shall be terminated. Overrides the global */
/* dot11MaxTransmitMsduLifeTime setting [optional] */
/* Device will set the default value if this is 0. */
__le32 expire_time;
/* WSM_HT_TX_... */
__le32 ht_tx_parameters;
} __packed;
/* = sizeof(generic hi hdr) + sizeof(wsm hdr) + sizeof(alignment) */
#define WSM_TX_EXTRA_HEADROOM (28)
/* 3.16 */
#define WSM_RECEIVE_IND_ID 0x0804
struct wsm_rx {
/* WSM_STATUS_... */
u32 status;
/* Specifies the channel of the received packet. */
u16 channel_number;
/* WSM_TRANSMIT_RATE_... */
u8 rx_rate;
/* This value is expressed in signed Q8.0 format for */
/* RSSI and unsigned Q7.1 format for RCPI. */
u8 rcpi_rssi;
/* WSM_RX_STATUS_... */
u32 flags;
};
/* = sizeof(generic hi hdr) + sizeof(wsm hdr) */
#define WSM_RX_EXTRA_HEADROOM (16)
typedef void (*wsm_rx_cb) (struct cw1200_common *priv, struct wsm_rx *arg,
struct sk_buff **skb_p);
/* 3.17 */
struct wsm_event {
/* WSM_STATUS_... */
/* [out] */ u32 id;
/* Indication parameters. */
/* For error indication, this shall be a 32-bit WSM status. */
/* For RCPI or RSSI indication, this should be an 8-bit */
/* RCPI or RSSI value. */
/* [out] */ u32 data;
};
struct cw1200_wsm_event {
struct list_head link;
struct wsm_event evt;
};
/* 3.18 - 3.22 */
/* Measurement. Skipped for now. Irrelevent. */
typedef void (*wsm_event_cb) (struct cw1200_common *priv,
struct wsm_event *arg);
/* 3.23 */
#define WSM_JOIN_REQ_ID 0x000B
#define WSM_JOIN_RESP_ID 0x040B
struct wsm_join {
/* WSM_JOIN_MODE_... */
u8 mode;
/* WSM_PHY_BAND_... */
u8 band;
/* Specifies the channel number to join. The channel */
/* number will be mapped to an actual frequency */
/* according to the band */
u16 channel_number;
/* Specifies the BSSID of the BSS or IBSS to be joined */
/* or the IBSS to be started. */
u8 bssid[6];
/* ATIM window of IBSS */
/* When ATIM window is zero the initiated IBSS does */
/* not support power saving. */
u16 atim_window;
/* WSM_JOIN_PREAMBLE_... */
u8 preamble_type;
/* Specifies if a probe request should be send with the */
/* specified SSID when joining to the network. */
u8 probe_for_join;
/* DTIM Period (In multiples of beacon interval) */
u8 dtim_period;
/* WSM_JOIN_FLAGS_... */
u8 flags;
/* Length of the SSID */
u32 ssid_len;
/* Specifies the SSID of the IBSS to join or start */
u8 ssid[32];
/* Specifies the time between TBTTs in TUs */
u32 beacon_interval;
/* A bit mask that defines the BSS basic rate set. */
u32 basic_rate_set;
};
struct wsm_join_cnf {
u32 status;
/* Minimum transmission power level in units of 0.1dBm */
u32 min_power_level;
/* Maximum transmission power level in units of 0.1dBm */
u32 max_power_level;
};
int wsm_join(struct cw1200_common *priv, struct wsm_join *arg);
/* 3.24 */
struct wsm_join_complete {
/* WSM_STATUS_... */
u32 status;
};
/* 3.25 */
#define WSM_SET_PM_REQ_ID 0x0010
#define WSM_SET_PM_RESP_ID 0x0410
struct wsm_set_pm {
/* WSM_PSM_... */
u8 mode;
/* in unit of 500us; 0 to use default */
u8 fast_psm_idle_period;
/* in unit of 500us; 0 to use default */
u8 ap_psm_change_period;
/* in unit of 500us; 0 to disable auto-pspoll */
u8 min_auto_pspoll_period;
};
int wsm_set_pm(struct cw1200_common *priv, const struct wsm_set_pm *arg);
/* 3.27 */
struct wsm_set_pm_complete {
u8 psm; /* WSM_PSM_... */
};
/* 3.28 */
#define WSM_SET_BSS_PARAMS_REQ_ID 0x0011
#define WSM_SET_BSS_PARAMS_RESP_ID 0x0411
struct wsm_set_bss_params {
/* This resets the beacon loss counters only */
u8 reset_beacon_loss;
/* The number of lost consecutive beacons after which */
/* the WLAN device should indicate the BSS-Lost event */
/* to the WLAN host driver. */
u8 beacon_lost_count;
/* The AID received during the association process. */
u16 aid;
/* The operational rate set mask */
u32 operational_rate_set;
};
int wsm_set_bss_params(struct cw1200_common *priv,
const struct wsm_set_bss_params *arg);
/* 3.30 */
#define WSM_ADD_KEY_REQ_ID 0x000C
#define WSM_ADD_KEY_RESP_ID 0x040C
struct wsm_add_key {
u8 type; /* WSM_KEY_TYPE_... */
u8 index; /* Key entry index: 0 -- WSM_KEY_MAX_INDEX */
u16 reserved;
union {
struct {
u8 peer[6]; /* MAC address of the peer station */
u8 reserved;
u8 keylen; /* Key length in bytes */
u8 keydata[16]; /* Key data */
} __packed wep_pairwise;
struct {
u8 keyid; /* Unique per key identifier (0..3) */
u8 keylen; /* Key length in bytes */
u16 reserved;
u8 keydata[16]; /* Key data */
} __packed wep_group;
struct {
u8 peer[6]; /* MAC address of the peer station */
u16 reserved;
u8 keydata[16]; /* TKIP key data */
u8 rx_mic_key[8]; /* Rx MIC key */
u8 tx_mic_key[8]; /* Tx MIC key */
} __packed tkip_pairwise;
struct {
u8 keydata[16]; /* TKIP key data */
u8 rx_mic_key[8]; /* Rx MIC key */
u8 keyid; /* Key ID */
u8 reserved[3];
u8 rx_seqnum[8]; /* Receive Sequence Counter */
} __packed tkip_group;
struct {
u8 peer[6]; /* MAC address of the peer station */
u16 reserved;
u8 keydata[16]; /* AES key data */
} __packed aes_pairwise;
struct {
u8 keydata[16]; /* AES key data */
u8 keyid; /* Key ID */
u8 reserved[3];
u8 rx_seqnum[8]; /* Receive Sequence Counter */
} __packed aes_group;
struct {
u8 peer[6]; /* MAC address of the peer station */
u8 keyid; /* Key ID */
u8 reserved;
u8 keydata[16]; /* WAPI key data */
u8 mic_key[16]; /* MIC key data */
} __packed wapi_pairwise;
struct {
u8 keydata[16]; /* WAPI key data */
u8 mic_key[16]; /* MIC key data */
u8 keyid; /* Key ID */
u8 reserved[3];
} __packed wapi_group;
} __packed;
} __packed;
int wsm_add_key(struct cw1200_common *priv, const struct wsm_add_key *arg);
/* 3.32 */
#define WSM_REMOVE_KEY_REQ_ID 0x000D
#define WSM_REMOVE_KEY_RESP_ID 0x040D
struct wsm_remove_key {
u8 index; /* Key entry index : 0-10 */
};
int wsm_remove_key(struct cw1200_common *priv,
const struct wsm_remove_key *arg);
/* 3.34 */
struct wsm_set_tx_queue_params {
/* WSM_ACK_POLICY_... */
u8 ackPolicy;
/* Medium Time of TSPEC (in 32us units) allowed per */
/* One Second Averaging Period for this queue. */
u16 allowedMediumTime;
/* dot11MaxTransmitMsduLifetime to be used for the */
/* specified queue. */
u32 maxTransmitLifetime;
};
struct wsm_tx_queue_params {
/* NOTE: index is a linux queue id. */
struct wsm_set_tx_queue_params params[4];
};
#define WSM_TX_QUEUE_SET(queue_params, queue, ack_policy, allowed_time,\
max_life_time) \
do { \
struct wsm_set_tx_queue_params *p = &(queue_params)->params[queue]; \
p->ackPolicy = (ack_policy); \
p->allowedMediumTime = (allowed_time); \
p->maxTransmitLifetime = (max_life_time); \
} while (0)
int wsm_set_tx_queue_params(struct cw1200_common *priv,
const struct wsm_set_tx_queue_params *arg, u8 id);
/* 3.36 */
#define WSM_EDCA_PARAMS_REQ_ID 0x0013
#define WSM_EDCA_PARAMS_RESP_ID 0x0413
struct wsm_edca_queue_params {
/* CWmin (in slots) for the access class. */
u16 cwmin;
/* CWmax (in slots) for the access class. */
u16 cwmax;
/* AIFS (in slots) for the access class. */
u16 aifns;
/* TX OP Limit (in microseconds) for the access class. */
u16 txop_limit;
/* dot11MaxReceiveLifetime to be used for the specified */
/* the access class. Overrides the global */
/* dot11MaxReceiveLifetime value */
u32 max_rx_lifetime;
};
struct wsm_edca_params {
/* NOTE: index is a linux queue id. */
struct wsm_edca_queue_params params[4];
bool uapsd_enable[4];
};
#define TXOP_UNIT 32
#define WSM_EDCA_SET(__edca, __queue, __aifs, __cw_min, __cw_max, __txop, __lifetime,\
__uapsd) \
do { \
struct wsm_edca_queue_params *p = &(__edca)->params[__queue]; \
p->cwmin = __cw_min; \
p->cwmax = __cw_max; \
p->aifns = __aifs; \
p->txop_limit = ((__txop) * TXOP_UNIT); \
p->max_rx_lifetime = __lifetime; \
(__edca)->uapsd_enable[__queue] = (__uapsd); \
} while (0)
int wsm_set_edca_params(struct cw1200_common *priv,
const struct wsm_edca_params *arg);
int wsm_set_uapsd_param(struct cw1200_common *priv,
const struct wsm_edca_params *arg);
/* 3.38 */
/* Set-System info. Skipped for now. Irrelevent. */
/* 3.40 */
#define WSM_SWITCH_CHANNEL_REQ_ID 0x0016
#define WSM_SWITCH_CHANNEL_RESP_ID 0x0416
struct wsm_switch_channel {
/* 1 - means the STA shall not transmit any further */
/* frames until the channel switch has completed */
u8 mode;
/* Number of TBTTs until channel switch occurs. */
/* 0 - indicates switch shall occur at any time */
/* 1 - occurs immediately before the next TBTT */
u8 switch_count;
/* The new channel number to switch to. */
/* Note this is defined as per section 2.7. */
u16 channel_number;
};
int wsm_switch_channel(struct cw1200_common *priv,
const struct wsm_switch_channel *arg);
typedef void (*wsm_channel_switch_cb) (struct cw1200_common *priv);
#define WSM_START_REQ_ID 0x0017
#define WSM_START_RESP_ID 0x0417
struct wsm_start {
/* WSM_START_MODE_... */
/* [in] */ u8 mode;
/* WSM_PHY_BAND_... */
/* [in] */ u8 band;
/* Channel number */
/* [in] */ u16 channel_number;
/* Client Traffic window in units of TU */
/* Valid only when mode == ..._P2P */
/* [in] */ u32 ct_window;
/* Interval between two consecutive */
/* beacon transmissions in TU. */
/* [in] */ u32 beacon_interval;
/* DTIM period in terms of beacon intervals */
/* [in] */ u8 dtim_period;
/* WSM_JOIN_PREAMBLE_... */
/* [in] */ u8 preamble;
/* The delay time (in microseconds) period */
/* before sending a probe-request. */
/* [in] */ u8 probe_delay;
/* Length of the SSID */
/* [in] */ u8 ssid_len;
/* SSID of the BSS or P2P_GO to be started now. */
/* [in] */ u8 ssid[32];
/* The basic supported rates for the MiniAP. */
/* [in] */ u32 basic_rate_set;
};
int wsm_start(struct cw1200_common *priv, const struct wsm_start *arg);
#define WSM_BEACON_TRANSMIT_REQ_ID 0x0018
#define WSM_BEACON_TRANSMIT_RESP_ID 0x0418
struct wsm_beacon_transmit {
/* 1: enable; 0: disable */
/* [in] */ u8 enable_beaconing;
};
int wsm_beacon_transmit(struct cw1200_common *priv,
const struct wsm_beacon_transmit *arg);
int wsm_start_find(struct cw1200_common *priv);
int wsm_stop_find(struct cw1200_common *priv);
typedef void (*wsm_find_complete_cb) (struct cw1200_common *priv, u32 status);
struct wsm_suspend_resume {
/* See 3.52 */
/* Link ID */
/* [out] */ int link_id;
/* Stop sending further Tx requests down to device for this link */
/* [out] */ bool stop;
/* Transmit multicast Frames */
/* [out] */ bool multicast;
/* The AC on which Tx to be suspended /resumed. */
/* This is applicable only for U-APSD */
/* WSM_QUEUE_... */
/* [out] */ int queue;
};
typedef void (*wsm_suspend_resume_cb) (struct cw1200_common *priv,
struct wsm_suspend_resume *arg);
/* 3.54 Update-IE request. */
struct wsm_update_ie {
/* WSM_UPDATE_IE_... */
/* [in] */ u16 what;
/* [in] */ u16 count;
/* [in] */ u8 *ies;
/* [in] */ size_t length;
};
int wsm_update_ie(struct cw1200_common *priv,
const struct wsm_update_ie *arg);
/* 3.56 */
struct wsm_map_link {
/* MAC address of the remote device */
/* [in] */ u8 mac_addr[6];
/* [in] */ u8 link_id;
};
int wsm_map_link(struct cw1200_common *priv, const struct wsm_map_link *arg);
/* ******************************************************************** */
/* MIB shortcats */
static inline int wsm_set_output_power(struct cw1200_common *priv,
int power_level)
{
__le32 val = __cpu_to_le32(power_level);
return wsm_write_mib(priv, WSM_MIB_ID_DOT11_CURRENT_TX_POWER_LEVEL,
&val, sizeof(val));
}
static inline int wsm_set_beacon_wakeup_period(struct cw1200_common *priv,
unsigned dtim_interval,
unsigned listen_interval)
{
struct {
u8 numBeaconPeriods;
u8 reserved;
__le16 listenInterval;
} val = {
dtim_interval, 0, __cpu_to_le16(listen_interval)
};
if (dtim_interval > 0xFF || listen_interval > 0xFFFF)
return -EINVAL;
else
return wsm_write_mib(priv, WSM_MIB_ID_BEACON_WAKEUP_PERIOD,
&val, sizeof(val));
}
struct wsm_rcpi_rssi_threshold {
u8 rssiRcpiMode; /* WSM_RCPI_RSSI_... */
u8 lowerThreshold;
u8 upperThreshold;
u8 rollingAverageCount;
};
static inline int wsm_set_rcpi_rssi_threshold(struct cw1200_common *priv,
struct wsm_rcpi_rssi_threshold *arg)
{
return wsm_write_mib(priv, WSM_MIB_ID_RCPI_RSSI_THRESHOLD, arg,
sizeof(*arg));
}
struct wsm_mib_counters_table {
__le32 plcp_errors;
__le32 fcs_errors;
__le32 tx_packets;
__le32 rx_packets;
__le32 rx_packet_errors;
__le32 rx_decryption_failures;
__le32 rx_mic_failures;
__le32 rx_no_key_failures;
__le32 tx_multicast_frames;
__le32 tx_frames_success;
__le32 tx_frame_failures;
__le32 tx_frames_retried;
__le32 tx_frames_multi_retried;
__le32 rx_frame_duplicates;
__le32 rts_success;
__le32 rts_failures;
__le32 ack_failures;
__le32 rx_multicast_frames;
__le32 rx_frames_success;
__le32 rx_cmac_icv_errors;
__le32 rx_cmac_replays;
__le32 rx_mgmt_ccmp_replays;
} __packed;
static inline int wsm_get_counters_table(struct cw1200_common *priv,
struct wsm_mib_counters_table *arg)
{
return wsm_read_mib(priv, WSM_MIB_ID_COUNTERS_TABLE,
arg, sizeof(*arg));
}
static inline int wsm_get_station_id(struct cw1200_common *priv, u8 *mac)
{
return wsm_read_mib(priv, WSM_MIB_ID_DOT11_STATION_ID, mac, ETH_ALEN);
}
struct wsm_rx_filter {
bool promiscuous;
bool bssid;
bool fcs;
bool probeResponder;
};
static inline int wsm_set_rx_filter(struct cw1200_common *priv,
const struct wsm_rx_filter *arg)
{
__le32 val = 0;
if (arg->promiscuous)
val |= __cpu_to_le32(BIT(0));
if (arg->bssid)
val |= __cpu_to_le32(BIT(1));
if (arg->fcs)
val |= __cpu_to_le32(BIT(2));
if (arg->probeResponder)
val |= __cpu_to_le32(BIT(3));
return wsm_write_mib(priv, WSM_MIB_ID_RX_FILTER, &val, sizeof(val));
}
int wsm_set_probe_responder(struct cw1200_common *priv, bool enable);
#define WSM_BEACON_FILTER_IE_HAS_CHANGED BIT(0)
#define WSM_BEACON_FILTER_IE_NO_LONGER_PRESENT BIT(1)
#define WSM_BEACON_FILTER_IE_HAS_APPEARED BIT(2)
struct wsm_beacon_filter_table_entry {
u8 ie_id;
u8 flags;
u8 oui[3];
u8 match_data[3];
} __packed;
struct wsm_mib_beacon_filter_table {
__le32 num;
struct wsm_beacon_filter_table_entry entry[10];
} __packed;
static inline int wsm_set_beacon_filter_table(struct cw1200_common *priv,
struct wsm_mib_beacon_filter_table *ft)
{
size_t size = __le32_to_cpu(ft->num) *
sizeof(struct wsm_beacon_filter_table_entry) +
sizeof(__le32);
return wsm_write_mib(priv, WSM_MIB_ID_BEACON_FILTER_TABLE, ft, size);
}
#define WSM_BEACON_FILTER_ENABLE BIT(0) /* Enable/disable beacon filtering */
#define WSM_BEACON_FILTER_AUTO_ERP BIT(1) /* If 1 FW will handle ERP IE changes internally */
struct wsm_beacon_filter_control {
int enabled;
int bcn_count;
};
static inline int wsm_beacon_filter_control(struct cw1200_common *priv,
struct wsm_beacon_filter_control *arg)
{
struct {
__le32 enabled;
__le32 bcn_count;
} val;
val.enabled = __cpu_to_le32(arg->enabled);
val.bcn_count = __cpu_to_le32(arg->bcn_count);
return wsm_write_mib(priv, WSM_MIB_ID_BEACON_FILTER_ENABLE, &val,
sizeof(val));
}
enum wsm_power_mode {
wsm_power_mode_active = 0,
wsm_power_mode_doze = 1,
wsm_power_mode_quiescent = 2,
};
struct wsm_operational_mode {
enum wsm_power_mode power_mode;
int disable_more_flag_usage;
int perform_ant_diversity;
};
static inline int wsm_set_operational_mode(struct cw1200_common *priv,
const struct wsm_operational_mode *arg)
{
u8 val = arg->power_mode;
if (arg->disable_more_flag_usage)
val |= BIT(4);
if (arg->perform_ant_diversity)
val |= BIT(5);
return wsm_write_mib(priv, WSM_MIB_ID_OPERATIONAL_POWER_MODE, &val,
sizeof(val));
}
struct wsm_template_frame {
u8 frame_type;
u8 rate;
struct sk_buff *skb;
};
static inline int wsm_set_template_frame(struct cw1200_common *priv,
struct wsm_template_frame *arg)
{
int ret;
u8 *p = skb_push(arg->skb, 4);
p[0] = arg->frame_type;
p[1] = arg->rate;
((__le16 *)p)[1] = __cpu_to_le16(arg->skb->len - 4);
ret = wsm_write_mib(priv, WSM_MIB_ID_TEMPLATE_FRAME, p, arg->skb->len);
skb_pull(arg->skb, 4);
return ret;
}
struct wsm_protected_mgmt_policy {
bool protectedMgmtEnable;
bool unprotectedMgmtFramesAllowed;
bool encryptionForAuthFrame;
};
static inline int wsm_set_protected_mgmt_policy(struct cw1200_common *priv,
struct wsm_protected_mgmt_policy *arg)
{
__le32 val = 0;
int ret;
if (arg->protectedMgmtEnable)
val |= __cpu_to_le32(BIT(0));
if (arg->unprotectedMgmtFramesAllowed)
val |= __cpu_to_le32(BIT(1));
if (arg->encryptionForAuthFrame)
val |= __cpu_to_le32(BIT(2));
ret = wsm_write_mib(priv, WSM_MIB_ID_PROTECTED_MGMT_POLICY,
&val, sizeof(val));
return ret;
}
struct wsm_mib_block_ack_policy {
u8 tx_tid;
u8 reserved1;
u8 rx_tid;
u8 reserved2;
} __packed;
static inline int wsm_set_block_ack_policy(struct cw1200_common *priv,
u8 tx_tid_policy,
u8 rx_tid_policy)
{
struct wsm_mib_block_ack_policy val = {
.tx_tid = tx_tid_policy,
.rx_tid = rx_tid_policy,
};
return wsm_write_mib(priv, WSM_MIB_ID_BLOCK_ACK_POLICY, &val,
sizeof(val));
}
struct wsm_mib_association_mode {
u8 flags; /* WSM_ASSOCIATION_MODE_... */
u8 preamble; /* WSM_JOIN_PREAMBLE_... */
u8 greenfield; /* 1 for greenfield */
u8 mpdu_start_spacing;
__le32 basic_rate_set;
} __packed;
static inline int wsm_set_association_mode(struct cw1200_common *priv,
struct wsm_mib_association_mode *arg)
{
return wsm_write_mib(priv, WSM_MIB_ID_SET_ASSOCIATION_MODE, arg,
sizeof(*arg));
}
#define WSM_TX_RATE_POLICY_FLAG_TERMINATE_WHEN_FINISHED BIT(2)
#define WSM_TX_RATE_POLICY_FLAG_COUNT_INITIAL_TRANSMIT BIT(3)
struct wsm_tx_rate_retry_policy {
u8 index;
u8 short_retries;
u8 long_retries;
/* BIT(2) - Terminate retries when Tx rate retry policy
* finishes.
* BIT(3) - Count initial frame transmission as part of
* rate retry counting but not as a retry
* attempt
*/
u8 flags;
u8 rate_recoveries;
u8 reserved[3];
__le32 rate_count_indices[3];
} __packed;
struct wsm_set_tx_rate_retry_policy {
u8 num;
u8 reserved[3];
struct wsm_tx_rate_retry_policy tbl[8];
} __packed;
static inline int wsm_set_tx_rate_retry_policy(struct cw1200_common *priv,
struct wsm_set_tx_rate_retry_policy *arg)
{
size_t size = 4 + arg->num * sizeof(struct wsm_tx_rate_retry_policy);
return wsm_write_mib(priv, WSM_MIB_ID_SET_TX_RATE_RETRY_POLICY, arg,
size);
}
/* 4.32 SetEtherTypeDataFrameFilter */
struct wsm_ether_type_filter_hdr {
u8 num; /* Up to WSM_MAX_FILTER_ELEMENTS */
u8 reserved[3];
} __packed;
struct wsm_ether_type_filter {
u8 action; /* WSM_FILTER_ACTION_XXX */
u8 reserved;
__le16 type; /* Type of ethernet frame */
} __packed;
static inline int wsm_set_ether_type_filter(struct cw1200_common *priv,
struct wsm_ether_type_filter_hdr *arg)
{
size_t size = sizeof(struct wsm_ether_type_filter_hdr) +
arg->num * sizeof(struct wsm_ether_type_filter);
return wsm_write_mib(priv, WSM_MIB_ID_SET_ETHERTYPE_DATAFRAME_FILTER,
arg, size);
}
/* 4.33 SetUDPPortDataFrameFilter */
struct wsm_udp_port_filter_hdr {
u8 num; /* Up to WSM_MAX_FILTER_ELEMENTS */
u8 reserved[3];
} __packed;
struct wsm_udp_port_filter {
u8 action; /* WSM_FILTER_ACTION_XXX */
u8 type; /* WSM_FILTER_PORT_TYPE_XXX */
__le16 port; /* Port number */
} __packed;
static inline int wsm_set_udp_port_filter(struct cw1200_common *priv,
struct wsm_udp_port_filter_hdr *arg)
{
size_t size = sizeof(struct wsm_udp_port_filter_hdr) +
arg->num * sizeof(struct wsm_udp_port_filter);
return wsm_write_mib(priv, WSM_MIB_ID_SET_UDPPORT_DATAFRAME_FILTER,
arg, size);
}
/* Undocumented MIBs: */
/* 4.35 P2PDeviceInfo */
#define D11_MAX_SSID_LEN (32)
struct wsm_p2p_device_type {
__le16 category_id;
u8 oui[4];
__le16 subcategory_id;
} __packed;
struct wsm_p2p_device_info {
struct wsm_p2p_device_type primaryDevice;
u8 reserved1[3];
u8 devname_size;
u8 local_devname[D11_MAX_SSID_LEN];
u8 reserved2[3];
u8 num_secdev_supported;
struct wsm_p2p_device_type secdevs[0];
} __packed;
/* 4.36 SetWCDMABand - WO */
struct wsm_cdma_band {
u8 wcdma_band;
u8 reserved[3];
} __packed;
/* 4.37 GroupTxSequenceCounter - RO */
struct wsm_group_tx_seq {
__le32 bits_47_16;
__le16 bits_15_00;
__le16 reserved;
} __packed;
/* 4.39 SetHtProtection - WO */
#define WSM_DUAL_CTS_PROT_ENB (1 << 0)
#define WSM_NON_GREENFIELD_STA_PRESENT (1 << 1)
#define WSM_HT_PROT_MODE__NO_PROT (0 << 2)
#define WSM_HT_PROT_MODE__NON_MEMBER (1 << 2)
#define WSM_HT_PROT_MODE__20_MHZ (2 << 2)
#define WSM_HT_PROT_MODE__NON_HT_MIXED (3 << 2)
#define WSM_LSIG_TXOP_PROT_FULL (1 << 4)
#define WSM_LARGE_L_LENGTH_PROT (1 << 5)
struct wsm_ht_protection {
__le32 flags;
} __packed;
/* 4.40 GPIO Command - R/W */
#define WSM_GPIO_COMMAND_SETUP 0
#define WSM_GPIO_COMMAND_READ 1
#define WSM_GPIO_COMMAND_WRITE 2
#define WSM_GPIO_COMMAND_RESET 3
#define WSM_GPIO_ALL_PINS 0xFF
struct wsm_gpio_command {
u8 command;
u8 pin;
__le16 config;
} __packed;
/* 4.41 TSFCounter - RO */
struct wsm_tsf_counter {
__le64 tsf_counter;
} __packed;
/* 4.43 Keep alive period */
struct wsm_keep_alive_period {
__le16 period;
u8 reserved[2];
} __packed;
static inline int wsm_keep_alive_period(struct cw1200_common *priv,
int period)
{
struct wsm_keep_alive_period arg = {
.period = __cpu_to_le16(period),
};
return wsm_write_mib(priv, WSM_MIB_ID_KEEP_ALIVE_PERIOD,
&arg, sizeof(arg));
};
/* BSSID filtering */
struct wsm_set_bssid_filtering {
u8 filter;
u8 reserved[3];
} __packed;
static inline int wsm_set_bssid_filtering(struct cw1200_common *priv,
bool enabled)
{
struct wsm_set_bssid_filtering arg = {
.filter = !enabled,
};
return wsm_write_mib(priv, WSM_MIB_ID_DISABLE_BSSID_FILTER,
&arg, sizeof(arg));
}
/* Multicast filtering - 4.5 */
struct wsm_mib_multicast_filter {
__le32 enable;
__le32 num_addrs;
u8 macaddrs[WSM_MAX_GRP_ADDRTABLE_ENTRIES][ETH_ALEN];
} __packed;
static inline int wsm_set_multicast_filter(struct cw1200_common *priv,
struct wsm_mib_multicast_filter *fp)
{
return wsm_write_mib(priv, WSM_MIB_ID_DOT11_GROUP_ADDRESSES_TABLE,
fp, sizeof(*fp));
}
/* ARP IPv4 filtering - 4.10 */
struct wsm_mib_arp_ipv4_filter {
__le32 enable;
__be32 ipv4addrs[WSM_MAX_ARP_IP_ADDRTABLE_ENTRIES];
} __packed;
static inline int wsm_set_arp_ipv4_filter(struct cw1200_common *priv,
struct wsm_mib_arp_ipv4_filter *fp)
{
return wsm_write_mib(priv, WSM_MIB_ID_ARP_IP_ADDRESSES_TABLE,
fp, sizeof(*fp));
}
/* P2P Power Save Mode Info - 4.31 */
struct wsm_p2p_ps_modeinfo {
u8 opp_ps_ct_window;
u8 count;
u8 reserved;
u8 dtim_count;
__le32 duration;
__le32 interval;
__le32 start_time;
} __packed;
static inline int wsm_set_p2p_ps_modeinfo(struct cw1200_common *priv,
struct wsm_p2p_ps_modeinfo *mi)
{
return wsm_write_mib(priv, WSM_MIB_ID_P2P_PS_MODE_INFO,
mi, sizeof(*mi));
}
static inline int wsm_get_p2p_ps_modeinfo(struct cw1200_common *priv,
struct wsm_p2p_ps_modeinfo *mi)
{
return wsm_read_mib(priv, WSM_MIB_ID_P2P_PS_MODE_INFO,
mi, sizeof(*mi));
}
/* UseMultiTxConfMessage */
static inline int wsm_use_multi_tx_conf(struct cw1200_common *priv,
bool enabled)
{
__le32 arg = enabled ? __cpu_to_le32(1) : 0;
return wsm_write_mib(priv, WSM_MIB_USE_MULTI_TX_CONF,
&arg, sizeof(arg));
}
/* 4.26 SetUpasdInformation */
struct wsm_uapsd_info {
__le16 uapsd_flags;
__le16 min_auto_trigger_interval;
__le16 max_auto_trigger_interval;
__le16 auto_trigger_step;
};
static inline int wsm_set_uapsd_info(struct cw1200_common *priv,
struct wsm_uapsd_info *arg)
{
return wsm_write_mib(priv, WSM_MIB_ID_SET_UAPSD_INFORMATION,
arg, sizeof(*arg));
}
/* 4.22 OverrideInternalTxRate */
struct wsm_override_internal_txrate {
u8 internalTxRate;
u8 nonErpInternalTxRate;
u8 reserved[2];
} __packed;
static inline int wsm_set_override_internal_txrate(struct cw1200_common *priv,
struct wsm_override_internal_txrate *arg)
{
return wsm_write_mib(priv, WSM_MIB_ID_OVERRIDE_INTERNAL_TX_RATE,
arg, sizeof(*arg));
}
/* ******************************************************************** */
/* WSM TX port control */
void wsm_lock_tx(struct cw1200_common *priv);
void wsm_lock_tx_async(struct cw1200_common *priv);
bool wsm_flush_tx(struct cw1200_common *priv);
void wsm_unlock_tx(struct cw1200_common *priv);
/* ******************************************************************** */
/* WSM / BH API */
int wsm_handle_exception(struct cw1200_common *priv, u8 *data, size_t len);
int wsm_handle_rx(struct cw1200_common *priv, u16 id, struct wsm_hdr *wsm,
struct sk_buff **skb_p);
/* ******************************************************************** */
/* wsm_buf API */
struct wsm_buf {
u8 *begin;
u8 *data;
u8 *end;
};
void wsm_buf_init(struct wsm_buf *buf);
void wsm_buf_deinit(struct wsm_buf *buf);
/* ******************************************************************** */
/* wsm_cmd API */
struct wsm_cmd {
spinlock_t lock; /* Protect structure from multiple access */
int done;
u8 *ptr;
size_t len;
void *arg;
int ret;
u16 cmd;
};
/* ******************************************************************** */
/* WSM TX buffer access */
int wsm_get_tx(struct cw1200_common *priv, u8 **data,
size_t *tx_len, int *burst);
void wsm_txed(struct cw1200_common *priv, u8 *data);
/* ******************************************************************** */
/* Queue mapping: WSM <---> linux */
/* Linux: VO VI BE BK */
/* WSM: BE BK VI VO */
static inline u8 wsm_queue_id_to_linux(u8 queue_id)
{
static const u8 queue_mapping[] = {
2, 3, 1, 0
};
return queue_mapping[queue_id];
}
static inline u8 wsm_queue_id_to_wsm(u8 queue_id)
{
static const u8 queue_mapping[] = {
3, 2, 0, 1
};
return queue_mapping[queue_id];
}
#endif /* CW1200_HWIO_H_INCLUDED */
