Skip to content

net: wifi: Add API docs#59859

Merged
carlescufi merged 3 commits intozephyrproject-rtos:mainfrom
krish2718:add_wifi_api_doc
Jul 14, 2023
Merged

net: wifi: Add API docs#59859
carlescufi merged 3 commits intozephyrproject-rtos:mainfrom
krish2718:add_wifi_api_doc

Conversation

@krish2718
Copy link
Copy Markdown
Contributor

Add a basic API docs, this can be extended to add detailed sections and details in future PRs.

Based on #59249 as that has few structure changes.

@krish2718 krish2718 marked this pull request as ready for review July 11, 2023 13:01
@zephyrbot zephyrbot requested a review from ssharks July 11, 2023 13:01
Copy link
Copy Markdown
Contributor

@rlubos rlubos left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks good, just one question.

Support for legacy types has been added primarily to identify in scan
results.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
Fix doxygen formatting and add comments.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
Add Wi-Fi management docs and APIs.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
@carlescufi carlescufi merged commit 3e1681e into zephyrproject-rtos:main Jul 14, 2023
Copy link
Copy Markdown
Member

@kartben kartben left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I realize this has been merged already, but somehow I missed the chance to review in time. Any chance you could address in a follow up PR? @krish2718

Comment on lines +346 to 349
/* TWT setup operation */
WIFI_TWT_SETUP = 0,
/* TWT teardown operation */
WIFI_TWT_TEARDOWN,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing javadoc style comment

Comment on lines +359 to 364
/* TWT individual negotiation */
WIFI_TWT_INDIVIDUAL = 0,
/* TWT broadcast negotiation */
WIFI_TWT_BROADCAST,
/* TWT wake TBTT negotiation */
WIFI_TWT_WAKE_TBTT
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing javadoc style comment

/** Wi-Fi Target Wake Time (TWT) setup commands. */
enum wifi_twt_setup_cmd {
/* TWT Requests */
/** TWT Requests */
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use

/**
 * @name TWT requests
 * @{

To actually create a proper group

/* TWT setup demand (parameters can not be changed by AP) */
WIFI_TWT_SETUP_CMD_DEMAND,
/* TWT Responses */
/** TWT Responses */
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Group with name

Comment on lines +376 to +380
/* TWT setup request */
WIFI_TWT_SETUP_CMD_REQUEST = 0,
/* TWT setup suggest (parameters can be changed by AP) */
WIFI_TWT_SETUP_CMD_SUGGEST,
/* TWT setup demand (parameters can not be changed by AP) */
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing javadoc style comments

Comment on lines +383 to 392
/* TWT setup grouping (grouping of TWT flows) */
WIFI_TWT_SETUP_CMD_GROUPING,
/* TWT setup accept (parameters accepted by AP) */
WIFI_TWT_SETUP_CMD_ACCEPT,
/* TWT setup alternate (alternate parameters suggested by AP) */
WIFI_TWT_SETUP_CMD_ALTERNATE,
/* TWT setup dictate (parameters dictated by AP) */
WIFI_TWT_SETUP_CMD_DICTATE,
/* TWT setup reject (parameters rejected by AP) */
WIFI_TWT_SETUP_CMD_REJECT,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing javadoc style comment

@krish2718
Copy link
Copy Markdown
Contributor Author

Raised: #60406

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants