xref: /OK3568_Linux_fs/external/rkwifibt/drivers/rtl8852be/phl/phl_sound.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)

/******************************************************************************
 *
 * Copyright(c) 2019 - 2020 Realtek Corporation.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 *****************************************************************************/
#ifndef __PHL_SOUND_H__
#define __PHL_SOUND_H__

#define MAX_SND_GRP_NUM 4
#define MAX_SND_HE_BFRP_NUM 2
#define MAX_SND_HE_BFRP_USER_NUM 4
#define MAX_SND_VHT_BFRP_NUM 3

#define SND_PROC_DEFAULT_PERIOD 200 /* ms */
#define SND_PROC_DEFAULT_TIMEOUT 10 /* ms */

/* MAX_NUM_STA_SND_GRP :phl sounding design limit = 4, hw/fw support maximum 8 STA in a sounding frame exchange*/
#define MAX_NUM_STA_SND_GRP 4

enum snd_type {
	PHL_SND_TYPE_INVALID,
	PHL_SND_TYPE_VHT_HW,
	PHL_SND_TYPE_VHT_SW,
	PHL_SND_TYPE_HE_HW,
	PHL_SND_TYPE_HE_SW
};

enum snd_fb_type {
	PHL_SND_FB_TYPE_SU,
	PHL_SND_FB_TYPE_MU,
	PHL_SND_FB_TYPE_CQI
};

enum snd_status {
	PHL_SND_STS_PENDING,
	PHL_SND_STS_ON_PROC,
	PHL_SND_STS_SUCCESS,
	PHL_SND_STS_FAILURE
};

enum snd_grp_tier {
	PHL_SND_GRP_TIER_0, /* TIER_0 Group will free sounding resource in state SND_PROC_TERMINATE or group removed*/
	PHL_SND_GRP_TIER_1  /* TIER_1 Group will free sounding resource in next SND_PROC_IDLE*/
};

enum snd_test_flag {
	PHL_SND_TEST_F_NONE = 0, /* default value */
	PHL_SND_TEST_F_ONE_TIME = BIT(0), /* Test mode : only sounding one time */
	PHL_SND_TEST_F_FIX_STA = BIT(1), /* forced SND STAs (skip grouping and check TP) */
	PHL_SND_TEST_F_GRP_SND_PARA = BIT(2), /* Fixed SND STA's Feedback Type or BW from snd->fix_param */
	PHL_SND_TEST_F_GRP_EN_BF_FIX = BIT(3), /* Enable grp->en_fix_mode in grouping function */
	PHL_SND_TEST_F_PASS_STS_CHK = BIT(4) /* by pass sounding status check when post config */
};

struct npda_dialog_token {
	u8 reserved:1;
	u8 he:1;
	u8 token:6;
};

struct vht_ndpa_sta_info {
	u16 aid12:12;
#define VHT_NDPA_FB_TYPE_SU 0
#define VHT_NDPA_FB_TYPE_MU 1
	u16 feedback_type:1;
	u16 nc:3;
};

struct he_ndpa_sta_info {
	u32 aid:11;
	u32 bw:14;
	u32 fb_ng:2;
	u32 disambiguation:1;
	u32 cb:1;
	u32 nc:3;
};

struct phl_snd_sta {
	u8 valid;
	u16 macid;
	enum channel_width bw; /* Sounding BW */
	enum snd_fb_type snd_fb_t; /* Sounding feedback type : SU/MU/CQI */
	u32 npda_sta_info; /* VHT/HE NDPA STA info*/
	enum snd_status snd_sts;
	/* Query resource in SND PROC */
	void *bf_entry;/* HAL BF Entry for sounding */
};


struct phl_snd_grp {
	u8 gidx;
	enum snd_type snd_type;
	enum snd_grp_tier grp_tier;
	u8 wrole_idx;
	u8 band;
	u8 num_sta;
	struct phl_snd_sta sta[MAX_NUM_STA_SND_GRP];
	enum snd_status snd_sts;
	u8 en_fix_mode; /* post confg forced mode setting */
	/**
	 * en_swap_mode : Only TIER_0 MU group support. When swap mode is enable,
	 * each MU Entry will use two CSI MU buffer. Therefore, it cannan skip Disable
	 * MU in Preconfig when next round sounding
	 **/
	u8 en_swap_mode;
	u8 skip_post_cfg;/* 1: SKIP ALL; BIT1:Skip Group, BIT2:Skip GID, BIT3:Skip STA */
};


/* for whole phl snd fsm module fixed mode, only worked if snd_param->test_flag != 0 */
struct phl_snd_fix_param {
	u8 en_fix_gidx;
	u8 en_fix_fb_type;
	u8 en_fix_sta;
	u8 en_fix_snd_bw;
	u8 grp_idx;
	enum snd_fb_type snd_fb_type;
	u16 sta_macid[MAX_NUM_STA_SND_GRP];
	enum channel_width bw[MAX_NUM_STA_SND_GRP];
	u8 f_ru_tbl_20[MAX_SND_HE_BFRP_USER_NUM][MAX_SND_HE_BFRP_USER_NUM];
	u8 f_ru_tbl_80[MAX_SND_HE_BFRP_USER_NUM][MAX_SND_HE_BFRP_USER_NUM];
};

struct phl_sound_param {
	void *m_wrole;
	struct phl_snd_grp snd_grp[MAX_SND_GRP_NUM];
	u32 grp_used_map;
	u8 cur_proc_grp_idx;
	u8 pre_proc_grp_idx;
	u8 snd_func_grp_num;
	u8 snd_dialog_token;
	u8 snd_proc_timeout_ms;
	u32 proc_start_time;
	u8 snd_proc_period;
	bool bypass_snd_sts_chk;
	u32 test_flag;
	struct phl_snd_fix_param fix_param;
	u8 snd_fail_counter;
};
struct phl_snd_ops
{
	enum rtw_phl_status (*snd_send_ndpa)(void *drv_priv,
                                             struct rtw_wifi_role_t *wrole,
                                             u8 *snd_dialog_tkn,
                                             u32 *ndpa_sta,
                                             enum channel_width snd_bw);
};

struct phl_sound_obj {
	#ifdef CONFIG_FSM
	struct fsm_main *fsm;
	struct fsm_obj *fsm_obj;
	#endif
	struct phl_sound_param snd_param;
	struct phl_snd_ops ops;

	struct phl_info_t *phl_info;
	void *iface;

	u8 snd_in_progress;
	u8 is_terminated;

	_os_lock snd_lock;
	/* snd test */
	u8 wrole_idx;

	/* snd cmd disp related */
	u8 msg_busy;
	_os_lock cmd_lock;
};
#ifdef CONFIG_FSM
enum rtw_phl_status phl_snd_new_obj(
	struct fsm_main *fsm,
	struct phl_info_t *phl_info);

#endif
/* phl sounding intern api*/
enum rtw_phl_status phl_snd_func_snd_init(struct phl_info_t *phl_info);

enum rtw_phl_status phl_snd_func_pre_config(struct phl_info_t *phl_info);

/* phl sounding extern api*/
enum rtw_phl_status
rtw_phl_sound_start(void *phl, u8 wrole_idx, u8 st_dlg_tkn, u8 period, u8 test_flag);

enum rtw_phl_status
rtw_phl_sound_abort(void *phl);

enum rtw_phl_status
rtw_phl_sound_down_ev(void *phl);

void rtw_phl_snd_fix_tx_he_mu(struct phl_info_t *phl_info, u8 gid, bool en);

/* snd func grp */
struct phl_snd_grp *
phl_snd_get_grp_byidx(struct phl_info_t *phl_info, u8 gidx);

void
phl_snd_func_remove_grp_all(struct phl_info_t *phl_info);

enum rtw_phl_status
phl_snd_func_grouping(struct phl_info_t *phl_info, u8 wroleidx);

/* snd proc resource */
enum rtw_phl_status
phl_snd_proc_get_res(
	struct phl_info_t *phl_info, struct phl_snd_grp *grp, u8 *nsta);

enum rtw_phl_status
phl_snd_proc_release_res(struct phl_info_t *phl_info, struct phl_snd_grp *grp);

/* snd proc precfg */
enum rtw_phl_status
phl_snd_proc_precfg(struct phl_info_t *phl_info, struct phl_snd_grp *grp);


/* snd proc busy cmd to fw */
enum rtw_phl_status
phl_snd_proc_start_sounding_fw(struct phl_info_t *phl_info,
			       struct phl_snd_grp *grp);

/* snd proc postcfg */
enum rtw_phl_status
phl_snd_proc_postcfg(struct phl_info_t *phl_info, struct phl_snd_grp *grp);

enum rtw_phl_status
phl_snd_proc_chk_condition(struct phl_info_t *phl_info, struct phl_snd_grp *grp);

void
phl_snd_proc_chk_prev_grp(struct phl_info_t *phl_info,
			  struct phl_snd_grp *grp);

enum rtw_phl_status
phl_snd_polling_pri_sta_sts(struct phl_info_t *phl_info,
			    struct phl_snd_grp *grp);
void
phl_snd_mac_ctrl(struct phl_info_t *phl_info,
		 struct rtw_wifi_role_t *wrole, u8 ctrl);
#endif