From 2c4e75587fb87a4676c9c940fab6314057009e0b Mon Sep 17 00:00:00 2001 From: Declan Snyder Date: Tue, 26 Mar 2024 15:54:50 -0500 Subject: [PATCH] doc: migration-guide-3.7: Add NXP ENET info Add to migration guide info about the nxp,enet binding change. Signed-off-by: Declan Snyder --- doc/releases/migration-guide-3.7.rst | 30 ++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/doc/releases/migration-guide-3.7.rst b/doc/releases/migration-guide-3.7.rst index 0a45c6337cb..26bdcb804b7 100644 --- a/doc/releases/migration-guide-3.7.rst +++ b/doc/releases/migration-guide-3.7.rst @@ -70,6 +70,36 @@ Device Drivers and Devicetree }; }; +* The :dtcompatible:`nxp,kinetis-ethernet` has been deprecated in favor of + :dtcompatible:`nxp,enet`. All in tree SOCs were converted to use this new schema. + Thus, all boards using NXP's ENET peripheral will need to align to this binding + in DT, which also comes with a different version driver. Alternatively, + the Ethernet node can be deleted and redefined as the old binding to use + the deprecated legacy driver. The primary advantage of the new binding + is to be able to abstract an arbitrary phy through the mdio API. Example + of a basic board level ENET DT definition: + + .. code-block:: devicetree + + &enet_mac { + status = "okay"; + pinctrl-0 = <&pinmux_enet>; + pinctrl-names = "default"; + phy-handle = <&phy>; + zephyr,random-mac-address; + phy-connection-type = "rmii"; + }; + + &enet_mdio { + status = "okay"; + pinctrl-0 = <&pinmux_enet_mdio>; + pinctrl-names = "default"; + phy: phy@3 { + compatible = "ethernet-phy"; + reg = <3>; + status = "okay"; + }; + }; Analog-to-Digital Converter (ADC) =================================