MCPWM Driver Implementation

esp-hal/CHANGELOG.md

@@ -60,6 +60,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Cache configuration options for ESP32-S2 (#5306)
 - C5: Add PSRAM support (#5317)
 - C61: Add PSRAM support (#5325)
+- MCPWM: Add external sync line and timer sync out support. (#5344)
+- MCPWM: Add capture channel and timer support. (#5344)
+- MCPWM: Added `esp_hal::mcpwm::timer::Timer::apply_config` to apply a config to a timer. (#5344)
 
 ### Changed
 
@@ -101,6 +104,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `esp_hal::efuse::chip_revision` has been marked stable (#5287)
 - `esp_hal::efuse::chip_revision` now returns `ChipRevision` (#5287)
 - DMA buffers can now be created using empty buffer slices (#5266)
+- MCPWM: `esp_hal::mcpwm::timer::Timer::start` is now parameterless. Instead, use `esp_hal::mcpwm::timer::Timer::apply_config` to apply a config to a timer. (#5344)
+- MCPWM: timers default to the config given by `PeripheralClockConfig::timer_clock_default()`. (#5344)
 
 ### Fixed
 

esp-hal/Cargo.toml

@@ -102,15 +102,18 @@ ufmt-write               = { version = "0.1", optional = true }
 # IMPORTANT:
 # Each supported device MUST have its PAC included below along with a
 # corresponding feature.
-esp32   = { version = "0.39", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32c2 = { version = "0.28", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32c3 = { version = "0.31", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32c5 = { version = "0.1",  features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32c6 = { version = "0.22", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32c61 = { version = "0.1", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32h2 = { version = "0.18", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32s2 = { version = "0.30", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
-esp32s3 = { version = "0.34", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "879efa6" }
+
+## Once (#415) pull request is accepted update the commit hash to
+## point to the latest commit on the main branch of esp-pacs
+esp32   = { version = "0.39", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32c2 = { version = "0.28", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32c3 = { version = "0.31", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32c5 = { version = "0.1",  features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32c6 = { version = "0.22", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32c61 = { version = "0.1", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32h2 = { version = "0.18", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32s2 = { version = "0.30", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
+esp32s3 = { version = "0.34", features = ["critical-section", "rt"], optional = true, git = "https://github.com/esp-rs/esp-pacs", rev = "64db7c2018e25b0f5084f62a1c77b77015be237a" }
 
 [target.'cfg(target_arch = "riscv32")'.dependencies]
 riscv            = { version = "0.15.0" }

esp-hal/MIGRATING-1.0.0.md

@@ -179,3 +179,20 @@ expensive.
 -let revision = chip_revision();
 +let revision = chip_revision().combined();
 ```
+
+## MCPWM changes
+- The `Timer::start` method is now parameterless and doesn't take in a `TimerClockConfig`.
+  Instead, use `Timer::apply_config` method to set the config for the `mcpwm::Timer`.
+- `Timer::start` starts with the configured `StopCondition` rather than being restricted to
+  running till `Timer::stop` is called.
+- Timers now have a default configuration when you create a MCPWM instance via `McPwm::new`.
+
+`TimerClockConfig` created by `timer_clock_with_frequency` and `timer_clock_with_prescaler`
+will still default to `StopCondition::RunContinuously`. So, any existing code will only need
+a simple change.
+
+```diff
+-mcpwm.timer0.start(timer_clock_cfg);
++mcpwm.timer0.apply_config(timer_clock_cfg);
++mcpwm.timer0.start();
+```