From ec36e3b97ccaa99bc207ade6fe6fd0bf48290801 Mon Sep 17 00:00:00 2001
From: Tom Burdick <thomas.burdick@intel.com>
Date: Wed, 26 Jun 2024 15:58:44 -0500
Subject: [PATCH] docs: Add icm42688 changes to migration guide

Adds the icm42688 devicetree binding changes to the migration guide
noting that the previous bindings were not at all in use.

Signed-off-by: Tom Burdick <thomas.burdick@intel.com>
---
 doc/releases/migration-guide-3.7.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/releases/migration-guide-3.7.rst b/doc/releases/migration-guide-3.7.rst
index 1fcf5f50a85..6321d5fed3a 100644
--- a/doc/releases/migration-guide-3.7.rst
+++ b/doc/releases/migration-guide-3.7.rst
@@ -238,6 +238,27 @@ Device Drivers and Devicetree
         };
     };
 
+* The driver for :dtcompatible:`invensense,icm42688` now correctly supports device
+  tree configuration(:github:`74267`). Prior devicetrees may have tried to use
+  the bindings to set sample rate and scale for the accel/gyro without any
+  effect. The devicetree usage should now use the provided defines and include
+  file along with new bindings which take these values.
+
+  For example:
+
+  .. code-block:: devicetree
+
+    #include <zephyr/dt-bindings/sensor/icm42688.h>
+
+    icm42688: icm42688@0 {
+        accel-pwr-mode = <ICM42688_ACCEL_LN>;
+        accel-fs = <ICM42688_ACCEL_FS_16G>;
+        accel-odr = <ICM42688_ACCEL_ODR_2000>;
+        gyro-pwr-mode= <ICM42688_GYRO_LN>;
+        gyro-fs = <ICM42688_GYRO_FS_2000>;
+        gyro-odr = <ICM42688_GYRO_ODR_2000>;
+    };
+
 * `st,lis2mdl` property `spi-full-duplex` changed to `duplex =
   SPI_FULL_DUPLEX`. Full duplex is now the default.