overlays: wm8960-soundcard: Add media parameter

Add optional media board support to the wm8960-soundcard overlay:
- mclk: Overrides the MCLK clock frequency (default 12.288 MHz)
- media: Switches to the media board configuration: 24 MHz MCLK,
  enables headphone jack detection (wlf,hp-cfg) and an on-board
  microphone / dual speaker sound card.

The parameters are implemented as dormant fragments and have no
effect unless explicitly activated, preserving full backward
compatibility with existing configurations.

Tested on Raspberry Pi 5 (EDATEC media board) with:
  dtoverlay=wm8960-soundcard,media=on

Signed-off-by: zjzhao <zjzhao@edatec.cn>

Author: zjzhao-eda

arch/arm/boot/dts/overlays/README

@@ -6379,6 +6379,12 @@ Info:   Overlay for the Waveshare wm8960 soundcard
 Load:   dtoverlay=wm8960-soundcard,<param>=<val>
 Params: alsaname                Changes the card name in ALSA
         compatible              Changes the codec compatibility
+        mclk                    Sets the MCLK clock frequency in Hz (default
+                                12.288 MHz)
+        media                   Uses the media board configuration: 24 MHz
+                                MCLK, enables headphone jack detection
+                                (wlf,hp-cfg) and an on-board microphone /
+                                dual speaker sound card
 
 
 Name:   ws2812-pio

arch/arm/boot/dts/overlays/wm8960-soundcard-overlay.dts

@@ -1,4 +1,5 @@
 // Definitions for Waveshare WM8960 https://github.com/waveshare/WM8960-Audio-HAT
+// Extended with EDATEC media board support via the "media" parameter.
 /dts-v1/;
 /plugin/;
 
@@ -75,8 +76,48 @@
 		};
 	};
 
+	/* EDATEC media board: 24MHz MCLK oscillator */
+	fragment@4 {
+		target = <&wm8960_mclk>;
+		__dormant__ {
+			clock-frequency = <24000000>;
+		};
+	};
+
+	/* EDATEC media board: enable headphone jack detection */
+	fragment@5 {
+		target = <&wm8960>;
+		__dormant__ {
+			wlf,hp-cfg = <2 2 3>;
+		};
+	};
+
+	/* EDATEC media board: on-board mic + dual speakers sound card */
+	fragment@6 {
+		target = <&sound>;
+		__dormant__ {
+			simple-audio-card,widgets =
+				"Microphone", "On Board Mic",
+				"Line", "Line In",
+				"Line", "Line Out",
+				"Speaker", "Speaker",
+				"Headphone", "Headphone Jack";
+
+			simple-audio-card,routing =
+				"Headphone Jack", "HP_L",
+				"Headphone Jack", "HP_R",
+				"Speaker", "SPK_LP",
+				"Speaker", "SPK_LN",
+				"Speaker", "SPK_RP",
+				"Speaker", "SPK_RN",
+				"LINPUT2", "Headphone Jack";
+		};
+	};
+
 	__overrides__ {
 		alsaname = <&slave_overlay>,"simple-audio-card,name";
 		compatible = <&wm8960>,"compatible";
+		mclk = <&wm8960_mclk>,"clock-frequency:0";
+		media = <0>, "=4=5=6";
 	};
 };