Skip to content

Commit

Permalink
net: wifi_mgmt: doc: hide *_2str arrays
Browse files Browse the repository at this point in the history
 *_2str arrays are internal and should not show up in
 Doxygen documentation.

Signed-off-by: Benjamin Cabé <[email protected]>
  • Loading branch information
kartben committed Aug 9, 2023
1 parent 36682f6 commit 1c17081
Showing 1 changed file with 17 additions and 1 deletion.
18 changes: 17 additions & 1 deletion include/zephyr/net/wifi.h
Original file line number Diff line number Diff line change
Expand Up @@ -322,10 +322,12 @@ enum wifi_ps {
WIFI_PS_ENABLED,
};

/** @cond INTERNAL_HIDDEN */
static const char * const wifi_ps2str[] = {
[WIFI_PS_DISABLED] = "Power save disabled",
[WIFI_PS_ENABLED] = "Power save enabled",
};
/** @endcond */

/** Wi-Fi power save modes. */
enum wifi_ps_mode {
Expand All @@ -338,10 +340,12 @@ enum wifi_ps_mode {
WIFI_PS_MODE_WMM,
};

/** @cond INTERNAL_HIDDEN */
static const char * const wifi_ps_mode2str[] = {
[WIFI_PS_MODE_LEGACY] = "Legacy power save",
[WIFI_PS_MODE_WMM] = "WMM power save",
};
/** @endcond */

/** Wi-Fi Target Wake Time (TWT) operations. */
enum wifi_twt_operation {
Expand All @@ -351,10 +355,12 @@ enum wifi_twt_operation {
WIFI_TWT_TEARDOWN,
};

/** @cond INTERNAL_HIDDEN */
static const char * const wifi_twt_operation2str[] = {
[WIFI_TWT_SETUP] = "TWT setup",
[WIFI_TWT_TEARDOWN] = "TWT teardown",
};
/** @endcond */

/** Wi-Fi Target Wake Time (TWT) negotiation types. */
enum wifi_twt_negotiation_type {
Expand All @@ -366,11 +372,13 @@ enum wifi_twt_negotiation_type {
WIFI_TWT_WAKE_TBTT
};

/** @cond INTERNAL_HIDDEN */
static const char * const wifi_twt_negotiation_type2str[] = {
[WIFI_TWT_INDIVIDUAL] = "TWT individual negotiation",
[WIFI_TWT_BROADCAST] = "TWT broadcast negotiation",
[WIFI_TWT_WAKE_TBTT] = "TWT wake TBTT negotiation",
[WIFI_TWT_WAKE_TBTT] = "TWT wake TBTp negotiation",
};
/** @endcond */

/** Wi-Fi Target Wake Time (TWT) setup commands. */
enum wifi_twt_setup_cmd {
Expand All @@ -392,6 +400,7 @@ enum wifi_twt_setup_cmd {
WIFI_TWT_SETUP_CMD_REJECT,
};

/** @cond INTERNAL_HIDDEN */
static const char * const wifi_twt_setup_cmd2str[] = {
[WIFI_TWT_SETUP_CMD_REQUEST] = "TWT request",
[WIFI_TWT_SETUP_CMD_SUGGEST] = "TWT suggest",
Expand All @@ -402,6 +411,7 @@ static const char * const wifi_twt_setup_cmd2str[] = {
[WIFI_TWT_SETUP_CMD_DICTATE] = "TWT dictate",
[WIFI_TWT_SETUP_CMD_REJECT] = "TWT reject",
};
/** @endcond */

/** Wi-Fi Target Wake Time (TWT) negotiation status. */
enum wifi_twt_setup_resp_status {
Expand Down Expand Up @@ -437,6 +447,7 @@ enum wifi_twt_fail_reason {
WIFI_TWT_FAIL_FLOW_ALREADY_EXISTS,
};

/** @cond INTERNAL_HIDDEN */
static const char * const twt_err_code_tbl[] = {
[WIFI_TWT_FAIL_UNSPECIFIED] = "Unspecified",
[WIFI_TWT_FAIL_CMD_EXEC_FAIL] = "Command Execution failed",
Expand All @@ -457,6 +468,7 @@ static const char * const twt_err_code_tbl[] = {
[WIFI_TWT_FAIL_FLOW_ALREADY_EXISTS] =
"Flow already exists",
};
/** @endcond */

/** Helper function to get user-friendly TWT error code name. */
static inline const char *get_twt_err_code_str(int16_t err_no)
Expand Down Expand Up @@ -490,10 +502,12 @@ enum wifi_ps_wakeup_mode {
WIFI_PS_WAKEUP_MODE_LISTEN_INTERVAL,
};

/** @cond INTERNAL_HIDDEN */
static const char * const wifi_ps_wakeup_mode2str[] = {
[WIFI_PS_WAKEUP_MODE_DTIM] = "PS wakeup mode DTIM",
[WIFI_PS_WAKEUP_MODE_LISTEN_INTERVAL] = "PS wakeup mode listen interval",
};
/** @endcond */

/** Wi-Fi power save error codes. */
enum wifi_config_ps_param_fail_reason {
Expand All @@ -513,6 +527,7 @@ enum wifi_config_ps_param_fail_reason {
WIFI_PS_PARAM_LISTEN_INTERVAL_RANGE_INVALID,
};

/** @cond INTERNAL_HIDDEN */
static const char * const ps_param_config_err_code_tbl[] = {
[WIFI_PS_PARAM_FAIL_UNSPECIFIED] = "Unspecified",
[WIFI_PS_PARAM_FAIL_CMD_EXEC_FAIL] = "Command Execution failed",
Expand All @@ -527,6 +542,7 @@ static const char * const ps_param_config_err_code_tbl[] = {
[WIFI_PS_PARAM_LISTEN_INTERVAL_RANGE_INVALID] =
"Parameter out of range",
};
/** @endcond */

/** Helper function to get user-friendly power save error code name. */
static inline const char *get_ps_config_err_code_str(int16_t err_no)
Expand Down

0 comments on commit 1c17081

Please sign in to comment.