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

refactor(PeriphDrivers)!: Update WUT API naming schemes for MAX32655, MAX32657, MAX32665, MAX32690, MAX78000, and MAX78002. Offer WUT selection on MAX32690 #1291

Merged
merged 10 commits into from
Dec 16, 2024

Conversation

crsz20
Copy link
Contributor

@crsz20 crsz20 commented Dec 11, 2024

Description

The MAX32690's WUT functions perform operations using a single instance of the wake-up timer. However, the max32690.h file shows that there are two instances. This can be confirmed in section 24.1 of the device User Guide.

This is a breaking change as the function prototypes and signatures have been modified to offer a mxc_wut_regs_t *wut selection as an argument instead of defaulting to a single WUT instance.

Deprecation

In favor of the [action][verb]() naming scheme for functions, the following functions are being marked as deprecated and updated with a new name:

  • MXC_WUT_IntClear() is being replaced by MXC_WUT_ClearFlags().
  • MXC_WUT_IntStatus() is being replaced by MXC_WUT_GetFlags().
  • MXC_WUT_Edge() is being replaced by MXC_WUT_WaitForEdge().
  • MXC_WUT_Store() is being replaced by MXC_WUT_StoreCount().

Note: Unlike the other impacted devices, the MAX32690 will not have old functions marked as deprecated. Instead, these will be updated to their new names immediately as part of the breaking change, due to additional function argument.

Checklist Before Requesting Review

  • PR Title follows correct guidelines.
  • Description of changes and all other relevant information.
  • (Optional) Link any related GitHub issues using a keyword
  • (Optional) Provide info on any relevant functional testing/validation. For API changes or significant features, this is not optional.

@crsz20 crsz20 added the WIP work in progress label Dec 11, 2024
@github-actions github-actions bot added MAX32655 Related to the MAX32655 (ME17) MAX32665 Related to the MAX32665 (ME14) MAX32680 Related to the MAX32680 (ME20) MAX32690 Related to the MAX32690 (ME18) MAX78000 Related to the MAX78000 (AI85) MAX78002 Related to the MAX78002 (AI87) MAX32657 Related to the MAX32655 (ME30) labels Dec 11, 2024
@crsz20
Copy link
Contributor Author

crsz20 commented Dec 11, 2024

/clang-format-run

@github-actions github-actions bot added the BLE Related to Bluetooth label Dec 11, 2024
@crsz20 crsz20 requested a review from sihyung-maxim December 12, 2024 16:50
Copy link
Contributor

@sihyung-maxim sihyung-maxim left a comment

Choose a reason for hiding this comment

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

Core changes look good.

Libraries/PeriphDrivers/Include/MAX32690/wut.h Outdated Show resolved Hide resolved
Libraries/PeriphDrivers/Include/MAX32690/wut.h Outdated Show resolved Hide resolved
Libraries/PeriphDrivers/Include/MAX32690/wut.h Outdated Show resolved Hide resolved
@crsz20

This comment was marked as resolved.

@crsz20
Copy link
Contributor Author

crsz20 commented Dec 12, 2024

The PR description has been updated to account for the ME18 not having functions marked as deprecated.

@crsz20 crsz20 requested a review from sihyung-maxim December 13, 2024 16:30
@crsz20 crsz20 added Ready for review Raise "Ready" flag if PR is ready for review after WIP is down. and removed WIP work in progress labels Dec 16, 2024
Copy link
Contributor

@sihyung-maxim sihyung-maxim left a comment

Choose a reason for hiding this comment

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

Looks good!

@sihyung-maxim
Copy link
Contributor

Adding @EricB-ADI @kevin-gillespie so they could be aware of these changes.

As Cristian mentioned, the breaking change is only with the ME18.

@crsz20 crsz20 merged commit 1dd47b7 into main Dec 16, 2024
14 checks passed
sihyung-maxim pushed a commit to analogdevicesinc/hal_adi that referenced this pull request Dec 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
BLE Related to Bluetooth MAX32655 Related to the MAX32655 (ME17) MAX32657 Related to the MAX32655 (ME30) MAX32665 Related to the MAX32665 (ME14) MAX32680 Related to the MAX32680 (ME20) MAX32690 Related to the MAX32690 (ME18) MAX78000 Related to the MAX78000 (AI85) MAX78002 Related to the MAX78002 (AI87) Ready for review Raise "Ready" flag if PR is ready for review after WIP is down.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants