From f96e3363eb036d580c1ba429a3f7c506b5d291d3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?D=C3=A1niel=20Buga?= <bugadani@gmail.com>
Date: Mon, 2 Sep 2024 16:41:16 +0200
Subject: [PATCH] Update changelog

---
 esp-hal-embassy/CHANGELOG.md     |  2 ++
 esp-hal-embassy/MIGRATING-0.3.md | 30 +++++++++++++++++++++++
 esp-hal-smartled/CHANGELOG.md    |  2 ++
 esp-hal/CHANGELOG.md             |  5 ++--
 esp-wifi/CHANGELOG.md            |  2 ++
 esp-wifi/MIGRATING-0.8.md        | 41 ++++++++++++++++++++++++++++++++
 6 files changed, 80 insertions(+), 2 deletions(-)
 create mode 100644 esp-hal-embassy/MIGRATING-0.3.md
 create mode 100644 esp-wifi/MIGRATING-0.8.md

diff --git a/esp-hal-embassy/CHANGELOG.md b/esp-hal-embassy/CHANGELOG.md
index 3a8887dbc6c..741ba7a3d30 100644
--- a/esp-hal-embassy/CHANGELOG.md
+++ b/esp-hal-embassy/CHANGELOG.md
@@ -15,6 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+- Removed the `clocks` parameter from `esp_hal_embassy::init`. (#1999)
+
 ## 0.3.0 - 2024-08-29
 
 ### Added
diff --git a/esp-hal-embassy/MIGRATING-0.3.md b/esp-hal-embassy/MIGRATING-0.3.md
new file mode 100644
index 00000000000..be65c5db9b7
--- /dev/null
+++ b/esp-hal-embassy/MIGRATING-0.3.md
@@ -0,0 +1,30 @@
+Migration Guide from 0.3.x to vNext
+====================================
+
+Initialsation
+-------------
+
+You no longer have to set up clocks and pass them to `esp_hal_embassy::init`.
+
+```diff
+ use esp_hal::{
+-    clock::ClockControl,
+-    peripherals::Peripherals,
+     prelude::*,
+-    system::SystemControl,
+ };
+ 
+ #[esp_hal_embassy::main]
+ async fn main(_spawner: Spawner) -> ! {
+-    let peripherals = Peripherals::take();
+-    let system = SystemControl::new(peripherals.SYSTEM);
+-    let clocks = ClockControl::boot_defaults(system.clock_control).freeze();
++    let peripherals = esp_hal::init(esp_hal::Config::default());
+
+     let timg0 = TimerGroup::new(peripherals.TIMG0);
+-    esp_hal_embassy::init(&clocks, timg0);
++    esp_hal_embassy::init(timg0);
+
+     // ...
+ }
+```
diff --git a/esp-hal-smartled/CHANGELOG.md b/esp-hal-smartled/CHANGELOG.md
index 74ff2c3486a..b56517e9cb3 100644
--- a/esp-hal-smartled/CHANGELOG.md
+++ b/esp-hal-smartled/CHANGELOG.md
@@ -15,6 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+- Removed the `clocks` parameter from `SmartLedsAdapter::new` (#1999)
+
 ## 0.13.0 - 2024-08-29
 
 ## 0.12.0 - 2024-07-15
diff --git a/esp-hal/CHANGELOG.md b/esp-hal/CHANGELOG.md
index a8b4423d901..3778a99950e 100644
--- a/esp-hal/CHANGELOG.md
+++ b/esp-hal/CHANGELOG.md
@@ -9,7 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Added `esp_hal::init` to simplify HAL initialisation (#1970)
+- Added `esp_hal::init` to simplify HAL initialisation (#1970, #1999)
 
 ### Changed
 
@@ -17,6 +17,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+- `Peripherals::take` (#1999)
+
 ## [0.20.1] - 2024-08-30
 
 ### Fixed
@@ -73,7 +75,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Removed `FlashSafeDma` (#1856)
 - Remove redundant WithDmaSpi traits (#1975)
 - `IsFullDuplex` and `IsHalfDuplex` traits (#1985)
-- `Peripherals::take` (#1999)
 
 ## [0.19.0] - 2024-07-15
 
diff --git a/esp-wifi/CHANGELOG.md b/esp-wifi/CHANGELOG.md
index e62237419bf..733d02b424b 100644
--- a/esp-wifi/CHANGELOG.md
+++ b/esp-wifi/CHANGELOG.md
@@ -15,6 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+- Removed the `clocks` parameter from `esp_wifi::initialize` (#1999)
+
 ## 0.8.0 - 2024-08-29
 
 ### Added
diff --git a/esp-wifi/MIGRATING-0.8.md b/esp-wifi/MIGRATING-0.8.md
new file mode 100644
index 00000000000..89aa5787d8c
--- /dev/null
+++ b/esp-wifi/MIGRATING-0.8.md
@@ -0,0 +1,41 @@
+Migration Guide from 0.3.x to vNext
+====================================
+
+Initialsation
+-------------
+
+You no longer have to set up clocks and pass them to `esp_wifi::initialize`.
+
+```diff
+ use esp_hal::{
+-    clock::ClockControl,
+-    peripherals::Peripherals,
+     prelude::*,
+-    system::SystemControl,
+ };
+ use esp_wifi::{
+     initialize,
+     // ...
+ };
+ 
+ #[entry]
+ fn main() -> ! {
+-    let peripherals = Peripherals::take();
+-    let system = SystemControl::new(peripherals.SYSTEM);
+-    let clocks = ClockControl::boot_defaults(system.clock_control).freeze();
++    let peripherals = esp_hal::init(esp_hal::Config::default());
+
+     let timg0 = TimerGroup::new(peripherals.TIMG0);
+
+     let init = initialize(
+         EspWifiInitFor::Wifi,
+         timg0.timer0,
+         Rng::new(peripherals.RNG),
+         peripherals.RADIO_CLK,
+-        &clocks,
+     )
+     .unwrap();
+
+     // ...
+ }
+```