Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

net: wifi: Add API docs #59859

Merged
merged 3 commits into from
Jul 14, 2023
Merged

Conversation

krish2718
Copy link
Collaborator

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.

Copy link
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.

doc/connectivity/networking/api/wifi.rst Outdated Show resolved Hide resolved
Support for legacy types has been added primarily to identify in scan
results.

Signed-off-by: Chaitanya Tata <[email protected]>
Fix doxygen formatting and add comments.

Signed-off-by: Chaitanya Tata <[email protected]>
Add Wi-Fi management docs and APIs.

Signed-off-by: Chaitanya Tata <[email protected]>
@carlescufi carlescufi merged commit 3e1681e into zephyrproject-rtos:main Jul 14, 2023
18 checks passed
Copy link
Collaborator

@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
Collaborator

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
Collaborator

Choose a reason for hiding this comment

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

Missing javadoc style comment

enum wifi_twt_setup_cmd {
/* TWT Requests */
/** TWT Requests */
Copy link
Collaborator

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

WIFI_TWT_SETUP_CMD_DEMAND,
/* TWT Responses */
/** TWT Responses */
Copy link
Collaborator

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
Collaborator

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
Collaborator

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
Collaborator 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