/******************************************************************************
|
*
|
* Copyright(c) 2007 - 2017 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.
|
*
|
* The full GNU General Public License is included in this distribution in the
|
* file called LICENSE.
|
*
|
* Contact Information:
|
* wlanfae <wlanfae@realtek.com>
|
* Realtek Corporation, No. 2, Innovation Road II, Hsinchu Science Park,
|
* Hsinchu 300, Taiwan.
|
*
|
* Larry Finger <Larry.Finger@lwfinger.net>
|
*
|
*****************************************************************************/
|
|
#ifndef __ODM_DBG_H__
|
#define __ODM_DBG_H__
|
|
/*#define DEBUG_VERSION "1.1"*/ /*2015.07.29 YuChen*/
|
/*#define DEBUG_VERSION "1.2"*/ /*2015.08.28 Dino*/
|
/*#define DEBUG_VERSION "1.3"*/ /*2016.04.28 YuChen*/
|
/*#define DEBUG_VERSION "1.4"*/ /*2017.03.13 Dino*/
|
/*#define DEBUG_VERSION "2.0"*/ /*2018.01.10 Dino*/
|
/*2020.07.03 fix cck report bug due to 8723F coding error*/
|
#define DEBUG_VERSION "4.6"
|
|
/*@
|
* ============================================================
|
* Definition
|
* ============================================================
|
*/
|
|
/*@FW DBG MSG*/
|
#define RATE_DECISION 1
|
#define INIT_RA_TABLE 2
|
#define RATE_UP 4
|
#define RATE_DOWN 8
|
#define TRY_DONE 16
|
#define RA_H2C 32
|
#define F_RATE_AP_RPT 64
|
#define DBC_FW_CLM 9
|
|
#define PHYDM_SNPRINT_SIZE 64
|
/* @----------------------------------------------------------------------------
|
* Define the tracing components
|
*
|
* -----------------------------------------------------------------------------
|
* BB FW Functions
|
*/
|
#define PHYDM_FW_COMP_RA BIT(0)
|
#define PHYDM_FW_COMP_MU BIT(1)
|
#define PHYDM_FW_COMP_PATH_DIV BIT(2)
|
#define PHYDM_FW_COMP_PT BIT(3)
|
|
/*@------------------------Export Marco Definition---------------------------*/
|
|
#define config_phydm_read_txagc_check(data) (data != INVALID_TXAGC_DATA)
|
|
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
|
#if (DBG_CMD_SUPPORT == 1)
|
extern VOID DCMD_Printf(const char *pMsg);
|
#else
|
#define DCMD_Printf(_pMsg)
|
#endif
|
|
#if OS_WIN_FROM_WIN10(OS_VERSION)
|
#define pr_debug(fmt, ...) DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_ERROR_LEVEL, fmt, ##__VA_ARGS__)
|
#else
|
#define pr_debug DbgPrint
|
#endif
|
|
#define dcmd_printf DCMD_Printf
|
#define dcmd_scanf DCMD_Scanf
|
#define RT_PRINTK pr_debug
|
#define PRINT_MAX_SIZE 512
|
#define PHYDM_SNPRINTF RT_SPRINTF
|
#define PHYDM_TRACE(_MSG_) EXhalPHYDMoutsrc_Print(_MSG_)
|
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE) && defined(DM_ODM_CE_MAC80211)
|
#define PHYDM_SNPRINTF snprintf
|
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE)
|
#undef pr_debug
|
#define pr_debug printk
|
#define RT_PRINTK(fmt, args...) pr_debug(fmt, ## args)
|
#define RT_DISP(dbgtype, dbgflag, printstr)
|
#define RT_TRACE(adapter, comp, drv_level, fmt, args...) \
|
RTW_INFO(fmt, ## args)
|
#define PHYDM_SNPRINTF snprintf
|
#elif (DM_ODM_SUPPORT_TYPE == ODM_IOT)
|
#define pr_debug(fmt, args...) RTW_PRINT_MSG(fmt, ## args)
|
#define RT_DEBUG(comp, drv_level, fmt, args...) \
|
RTW_PRINT_MSG(fmt, ## args)
|
#define PHYDM_SNPRINTF snprintf
|
#else
|
#define pr_debug panic_printk
|
/*@#define RT_PRINTK(fmt, args...) pr_debug("%s(): " fmt, __FUNCTION__, ## args);*/
|
#define RT_PRINTK(fmt, args...) pr_debug(fmt, ## args)
|
#define PHYDM_SNPRINTF snprintf
|
#endif
|
|
#ifndef ASSERT
|
#define ASSERT(expr)
|
#endif
|
|
#if DBG
|
#if (DM_ODM_SUPPORT_TYPE == ODM_AP)
|
#define PHYDM_DBG(dm, comp, fmt, args...) \
|
do { \
|
if ((comp) & dm->debug_components) { \
|
pr_debug("[PHYDM] "); \
|
RT_PRINTK(fmt, ## args); \
|
} \
|
} while (0)
|
|
#define PHYDM_DBG_F(dm, comp, fmt, args...) \
|
do { \
|
if ((comp) & dm->debug_components) { \
|
RT_PRINTK(fmt, ## args); \
|
} \
|
} while (0)
|
|
#define PHYDM_PRINT_ADDR(dm, comp, title_str, addr) \
|
do { \
|
if ((comp) & dm->debug_components) { \
|
int __i; \
|
u8 *__ptr = (u8 *)addr; \
|
pr_debug("[PHYDM] "); \
|
pr_debug(title_str); \
|
pr_debug(" "); \
|
for (__i = 0; __i < 6; __i++) \
|
pr_debug("%02X%s", __ptr[__i], (__i == 5) ? "" : "-");\
|
pr_debug("\n"); \
|
} \
|
} while (0)
|
#elif (DM_ODM_SUPPORT_TYPE == ODM_WIN)
|
|
static __inline void PHYDM_DBG(PDM_ODM_T dm, int comp, char *fmt, ...)
|
{
|
RT_STATUS rt_status;
|
va_list args;
|
char buf[PRINT_MAX_SIZE] = {0};
|
|
if ((comp & dm->debug_components) == 0)
|
return;
|
|
if (fmt == NULL)
|
return;
|
|
va_start(args, fmt);
|
rt_status = (RT_STATUS)RtlStringCbVPrintfA(buf, PRINT_MAX_SIZE, fmt, args);
|
va_end(args);
|
|
if (rt_status != RT_STATUS_SUCCESS) {
|
DbgPrint("Failed (%d) to print message to buffer\n", rt_status);
|
return;
|
}
|
|
#if OS_WIN_FROM_WIN10(OS_VERSION)
|
DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_ERROR_LEVEL, "%s", buf);
|
#else
|
DbgPrint("%s", buf);
|
#endif
|
}
|
|
static __inline void PHYDM_DBG_F(PDM_ODM_T dm, int comp, char *fmt, ...)
|
{
|
RT_STATUS rt_status;
|
va_list args;
|
char buf[PRINT_MAX_SIZE] = {0};
|
|
if ((comp & dm->debug_components) == 0)
|
return;
|
|
if (fmt == NULL)
|
return;
|
|
va_start(args, fmt);
|
rt_status = (RT_STATUS)RtlStringCbVPrintfA(buf, PRINT_MAX_SIZE, fmt, args);
|
va_end(args);
|
|
if (rt_status != RT_STATUS_SUCCESS) {
|
/*@DbgPrint("DM Print Fail\n");*/
|
return;
|
}
|
|
#if OS_WIN_FROM_WIN10(OS_VERSION)
|
DbgPrintEx(DPFLTR_IHVNETWORK_ID, DPFLTR_ERROR_LEVEL, "%s", buf);
|
#else
|
DbgPrint("%s", buf);
|
#endif
|
}
|
|
#define PHYDM_PRINT_ADDR(p_dm, comp, title_str, ptr) \
|
do { \
|
if ((comp) & p_dm->debug_components) { \
|
\
|
int __i; \
|
u8 *__ptr = (u8 *)ptr; \
|
pr_debug("[PHYDM] "); \
|
pr_debug(title_str); \
|
pr_debug(" "); \
|
for (__i = 0; __i < 6; __i++) \
|
pr_debug("%02X%s", __ptr[__i], (__i == 5) ? "" : "-"); \
|
pr_debug("\n"); \
|
} \
|
} while (0)
|
#elif (DM_ODM_SUPPORT_TYPE == ODM_IOT)
|
|
#define PHYDM_DBG(dm, comp, fmt, args...) \
|
do { \
|
if ((comp) & dm->debug_components) { \
|
RT_DEBUG(COMP_PHYDM, \
|
DBG_DMESG, "[PHYDM] " fmt, ##args); \
|
} \
|
} while (0)
|
|
#define PHYDM_DBG_F(dm, comp, fmt, args...) \
|
do { \
|
if ((comp) & dm->debug_components) { \
|
RT_DEBUG(COMP_PHYDM, \
|
DBG_DMESG, fmt, ##args); \
|
} \
|
} while (0)
|
|
#define PHYDM_PRINT_ADDR(dm, comp, title_str, addr) \
|
do { \
|
if ((comp) & dm->debug_components) { \
|
RT_DEBUG(COMP_PHYDM, \
|
DBG_DMESG, "[PHYDM] " title_str "%pM\n", \
|
addr); \
|
} \
|
} while (0)
|
|
#elif defined(DM_ODM_CE_MAC80211_V2)
|
|
#define PHYDM_DBG(dm, comp, fmt, args...)
|
#define PHYDM_DBG_F(dm, comp, fmt, args...)
|
#define PHYDM_PRINT_ADDR(dm, comp, title_str, addr)
|
|
#else
|
|
#define PHYDM_DBG(dm, comp, fmt, args...) \
|
do { \
|
struct dm_struct *__dm = (dm); \
|
if ((comp) & __dm->debug_components) { \
|
RT_TRACE(((struct rtl_priv *)__dm->adapter),\
|
COMP_PHYDM, DBG_DMESG, \
|
"[PHYDM] " fmt, ##args); \
|
} \
|
} while (0)
|
|
#define PHYDM_DBG_F(dm, comp, fmt, args...) \
|
do { \
|
struct dm_struct *__dm = (dm); \
|
if ((comp) & __dm->debug_components) { \
|
RT_TRACE(((struct rtl_priv *)__dm->adapter),\
|
COMP_PHYDM, DBG_DMESG, fmt, ##args); \
|
} \
|
} while (0)
|
|
#define PHYDM_PRINT_ADDR(dm, comp, title_str, addr) \
|
do { \
|
struct dm_struct *__dm = (dm); \
|
if ((comp) & __dm->debug_components) { \
|
RT_TRACE(((struct rtl_priv *)__dm->adapter),\
|
COMP_PHYDM, DBG_DMESG, \
|
"[PHYDM] " title_str "%pM\n", addr);\
|
} \
|
} while (0)
|
#endif
|
|
#else /*@#if DBG*/
|
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
|
static __inline void PHYDM_DBG(struct dm_struct *dm, int comp, char *fmt, ...)
|
{
|
RT_STATUS rt_status;
|
va_list args;
|
char buf[PRINT_MAX_SIZE] = {0};
|
|
if ((comp & dm->debug_components) == 0)
|
return;
|
|
if (fmt == NULL)
|
return;
|
|
va_start(args, fmt);
|
rt_status = (RT_STATUS)RtlStringCbVPrintfA(buf, PRINT_MAX_SIZE, fmt, args);
|
va_end(args);
|
|
if (rt_status != RT_STATUS_SUCCESS) {
|
DbgPrint("Failed (%d) to print message to buffer\n", rt_status);
|
return;
|
}
|
|
PHYDM_TRACE(buf);
|
}
|
static __inline void PHYDM_DBG_F(struct dm_struct *dm, int comp, char *fmt, ...)
|
{
|
}
|
#else
|
#define PHYDM_DBG(dm, comp, fmt, args...)
|
#define PHYDM_DBG_F(dm, comp, fmt, args...)
|
#endif
|
#define PHYDM_PRINT_ADDR(dm, comp, title_str, ptr)
|
|
#endif
|
|
#define DBGPORT_PRI_3 3 /*@Debug function (the highest priority)*/
|
#define DBGPORT_PRI_2 2 /*@Check hang function & Strong function*/
|
#define DBGPORT_PRI_1 1 /*Watch dog function*/
|
#define DBGPORT_RELEASE 0 /*@Init value (the lowest priority)*/
|
|
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
|
#define PHYDM_DBGPRINT 0
|
#define PHYDM_SSCANF(x, y, z) dcmd_scanf(x, y, z)
|
#define PDM_VAST_SNPF PDM_SNPF
|
#if (PHYDM_DBGPRINT == 1)
|
#define PDM_SNPF(msg) \
|
do {\
|
rsprintf msg;\
|
pr_debug("%s", output);\
|
} while (0)
|
#else
|
|
static __inline void PDM_SNPF(u32 out_len, u32 used, char *buff, int len,
|
char *fmt, ...)
|
{
|
RT_STATUS rt_status;
|
va_list args;
|
char buf[PRINT_MAX_SIZE] = {0};
|
|
if (fmt == NULL)
|
return;
|
|
va_start(args, fmt);
|
rt_status = (RT_STATUS)RtlStringCbVPrintfA(buf, PRINT_MAX_SIZE, fmt, args);
|
va_end(args);
|
|
if (rt_status != RT_STATUS_SUCCESS) {
|
/*@DbgPrint("DM Print Fail\n");*/
|
return;
|
}
|
|
DCMD_Printf(buf);
|
}
|
|
|
|
#endif /*@#if (PHYDM_DBGPRINT == 1)*/
|
#else /*@(DM_ODM_SUPPORT_TYPE & (ODM_CE | ODM_AP))*/
|
#if (DM_ODM_SUPPORT_TYPE == ODM_CE) || defined(__OSK__)
|
#define PHYDM_DBGPRINT 0
|
#else
|
#define PHYDM_DBGPRINT 1
|
#endif
|
#define MAX_ARGC 20
|
#define MAX_ARGV 16
|
#define DCMD_DECIMAL "%d"
|
#define DCMD_CHAR "%c"
|
#define DCMD_HEX "%x"
|
|
#define PHYDM_SSCANF(x, y, z) sscanf(x, y, z)
|
|
#if (DM_ODM_SUPPORT_TYPE & ODM_AP)
|
#define PDM_VAST_SNPF(out_len, used, buff, len, fmt, args...) RT_PRINTK(fmt, ## args)
|
|
#elif (DM_ODM_SUPPORT_TYPE & ODM_IOT)
|
#define PDM_VAST_SNPF(out_len, used, buff, len, fmt, args...) \
|
do { \
|
RT_DEBUG(COMP_PHYDM, DBG_DMESG, fmt, ##args); \
|
} while (0)
|
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE) && defined(DM_ODM_CE_MAC80211_V2)
|
#define PDM_VAST_SNPF(out_len, used, buff, len, fmt, args...)
|
#else
|
#define PDM_VAST_SNPF(out_len, used, buff, len, fmt, args...) \
|
RT_TRACE(((struct rtl_priv *)dm->adapter), COMP_PHYDM, \
|
DBG_DMESG, fmt, ##args)
|
#endif
|
|
#if (PHYDM_DBGPRINT == 1)
|
#define PDM_SNPF(out_len, used, buff, len, fmt, args...) \
|
do { \
|
snprintf(buff, len, fmt, ##args); \
|
pr_debug("%s", output); \
|
} while (0)
|
#else
|
#define PDM_SNPF(out_len, used, buff, len, fmt, args...) \
|
do { \
|
u32 *__pdm_snpf_u = &(used); \
|
if (out_len > *__pdm_snpf_u) \
|
*__pdm_snpf_u += snprintf(buff, len, fmt, ##args);\
|
} while (0)
|
#endif
|
#endif
|
/* @1 ============================================================
|
* 1 enumeration
|
* 1 ============================================================
|
*/
|
|
enum auto_detection_state { /*@Fast antenna training*/
|
AD_LEGACY_MODE = 0,
|
AD_HT_MODE = 1,
|
AD_VHT_MODE = 2
|
};
|
|
/*@
|
* ============================================================
|
* 1 structure
|
* ============================================================
|
*/
|
|
#ifdef CONFIG_PHYDM_DEBUG_FUNCTION
|
u8 phydm_get_l_sig_rate(void *dm_void, u8 rate_idx_l_sig);
|
#endif
|
|
void phydm_init_debug_setting(struct dm_struct *dm);
|
|
void phydm_bb_dbg_port_header_sel(void *dm_void, u32 header_idx);
|
|
u32 phydm_get_bb_dbg_port_idx(void *dm_void);
|
|
u8 phydm_set_bb_dbg_port(void *dm_void, u8 curr_dbg_priority, u32 debug_port);
|
|
void phydm_release_bb_dbg_port(void *dm_void);
|
|
u32 phydm_get_bb_dbg_port_val(void *dm_void);
|
|
void phydm_reset_rx_rate_distribution(struct dm_struct *dm);
|
|
void phydm_rx_rate_distribution(void *dm_void);
|
|
u16 phydm_rx_avg_phy_rate(void *dm_void);
|
|
void phydm_show_phy_hitogram(void *dm_void);
|
|
void phydm_get_avg_phystatus_val(void *dm_void);
|
|
void phydm_get_phy_statistic(void *dm_void);
|
|
void phydm_dm_summary(void *dm_void, u8 macid);
|
|
void phydm_basic_dbg_message(void *dm_void);
|
|
void phydm_basic_profile(void *dm_void, u32 *_used, char *output,
|
u32 *_out_len);
|
#if (DM_ODM_SUPPORT_TYPE & (ODM_CE | ODM_AP))
|
s32 phydm_cmd(struct dm_struct *dm, char *input, u32 in_len, u8 flag,
|
char *output, u32 out_len);
|
#endif
|
void phydm_cmd_parser(struct dm_struct *dm, char input[][16], u32 input_num,
|
u8 flag, char *output, u32 out_len);
|
|
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
|
void phydm_basic_dbg_msg_cli_win(void *dm_void, char *buf);
|
|
void phydm_sbd_check(
|
struct dm_struct *dm);
|
|
void phydm_sbd_callback(
|
struct phydm_timer_list *timer);
|
|
void phydm_sbd_workitem_callback(
|
void *context);
|
#endif
|
|
void phydm_fw_trace_en_h2c(void *dm_void, boolean enable,
|
u32 fw_debug_component, u32 monitor_mode, u32 macid);
|
|
void phydm_fw_trace_handler(void *dm_void, u8 *cmd_buf, u8 cmd_len);
|
|
void phydm_fw_trace_handler_code(void *dm_void, u8 *buffer, u8 cmd_len);
|
|
void phydm_fw_trace_handler_8051(void *dm_void, u8 *cmd_buf, u8 cmd_len);
|
|
#endif /* @__ODM_DBG_H__ */
|
