commit	57c5479417236244d170aff4681247faccb53546	[log] [tgz]
author	developer <developer@mediatek.com>	Fri Feb 14 17:38:52 2025 +0800
committer	developer <developer@mediatek.com>	Fri Feb 14 20:39:53 2025 +0800
tree	37d6a17809da5bc9872eb9eed870510caf063f7d
parent	fe2594cc96cf7e9f2d7a242a0d3a589c9d490f18 [diff]

[][HIGH][kernel][common][eth][Update Airoha EN8811H 2.5G PHY driver to v1.2.9]

[Description]
Change Airoha EN8811H 2.5G PHY driver to v1.2.9.

Change Log:
[2025/02/03] v1.2.9
1. If up is still running, it doesn't need to be restarted.
2. Correct 5R settings

=====================================================================
If your board that GMAC2 connects with Airoha EN8811H, please change
the eth node as following.

&eth {
	...

	gmac1: mac@1 {
		compatible = "mediatek,eth-mac";
		reg = <1>;
		phy-mode = "2500base-x";
		phy-handle = <&phy15>;
	};

	mdio: mdio-bus {
      		#address-cells = <1>;
      		#size-cells = <0>;

      		phy15: phy@15 {
       			compatible = "ethernet-phy-id03a2.a411";
			reg = <15>;
			phy-mode = "2500base-x";
			airoha,polarity = <1>;
			airoha,surge = <0>;
			airoha,phy-handle;
		};

       		...
	};
};

Note:
SerDes polarity setting could be configured in dts. Please refer to the
following description.
Tx Reverse, Rx Normal:
		airoha,polarity = <0>;
Tx Normal, Rx Normal:
		airoha,polarity = <1>;
Tx Reverse, Rx Reverse:
		airoha,polarity = <2>;
Tx Normal, Rx Reverse:
		airoha,polarity = <3>;

Surge protection setting could be configured in dts. Please refer to the
following description.
Surge protection - 0R
		airoha,surge = <0>;
Surge protection - 5R
		airoha,surge = <1>;

Co-clock output setting could be configured in dts. Please refer to the
following description.
Co-clock output - Disabled
		airoha,cko-en = <0>;
Co-clock output - Enabled
		airoha,cko-en = <1>;

phy-handle setting (for en8811h initialized) could be configured in dts.
Please refer to the following description.
Work with phy-handle
		Add "airoha,phy-handle" in DTS
Work with fixed-link
		Do not add "airoha,phy-handle" in DTSs

=====================================================================
In addition, if EN8811H connects with a RESET GPIO, please check the
GPIO number, and then add reset-gpio related definition to above phy
node.
=====================================================================
reset-gpios = <&gpio 6 1>;
reset-assert-us = <10000>;
reset-deassert-us = <10000>;
=====================================================================

If without this patch, kernel cannot load up-to-date PHY driver
for the Airoha EN8811H.

[Release-log]
N/A


Change-Id: Ia782b2daa12739ef10c7635ef20475f89141296c
Reviewed-on: https://gerrit.mediatek.inc/c/openwrt/feeds/mtk_openwrt_feeds/+/10263772

3 files changed

tree: 37d6a17809da5bc9872eb9eed870510caf063f7d

Readme.md

Brief introduction for using MediaTek released OpenWrt SDK

1. Build system setup

Please refer to https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem

2. Clone vanilla OpenWrt

Currently two release branches are supported:

21.02 This is the current in-use branch

git clone -b openwrt-21.02 https://git.openwrt.org/openwrt/openwrt.git

master (will be 24.0x branch later) The next version in development
```
git clone https://git.openwrt.org/openwrt/openwrt.git
```

3. Add MediaTek OpenWrt feed

cd openwrt
echo "src-git mtk_openwrt_feed https://git01.mediatek.com/openwrt/feeds/mtk-openwrt-feeds" >> feeds.conf.default
./scripts/feeds update -a
./scripts/feeds install -a

4. Apply MediaTek OpenWrt files and patches

21.02 branch

cp -af ./feeds/mtk_openwrt_feed/21.02/files/* .
cp -af ./feeds/mtk_openwrt_feed/tools .
for file in $(find ./feeds/mtk_openwrt_feed/21.02/patches-base -name "*.patch" | sort); do patch -f -p1 -i ${file}; done
for file in $(find ./feeds/mtk_openwrt_feed/21.02/patches-feeds -name "*.patch" | sort); do patch -f -p1 -i ${file}; done

master branch

cp -af ./feeds/mtk_openwrt_feed/master/files/* .
for file in $(find ./feeds/mtk_openwrt_feed/master/patches-base -name "*.patch" | sort); do patch -f -p1 -i ${file}; done

5. Configuration

make menuconfig

21.02 branch

Target System -> MediaTek Ralink ARM
Subtarget -> MT7981 / MT7986 / MT7988
Target Profile -> select as needed

master branch

Target System -> MediaTek Ralink ARM
Subtarget -> Filogic 8x0 (MT798x)
Target Profile -> select as needed

6. Build

make V=s -j$(nproc)

MT7987 NPU Only (without WiFi) Build

#Get Openwrt 21.02 source code from Git server
git clone --branch openwrt-21.02 https://git.openwrt.org/openwrt/openwrt.git

#Get Openwrt master source code from Git Server
git clone --branch master https://git.openwrt.org/openwrt/openwrt.git mac80211_package

#Get mtk-openwrt-feeds source code
git clone --branch master https://git01.mediatek.com/openwrt/feeds/mtk-openwrt-feeds

#Change to openwrt folder
cp -rf mtk-openwrt-feeds/autobuild/autobuild_5.4_mac80211_release openwrt
cd openwrt; mv autobuild_5.4_mac80211_release autobuild

#Add MTK feed
echo "src-git mtk_openwrt_feed https://git01.mediatek.com/openwrt/feeds/mtk-openwrt-feeds" >> feeds.conf.default

#Build MT7987 (Only for the 1st build)
bash autobuild/mt7987-npu/lede-branch-build-sanity.sh

#Further Build (After 1st full build)
./scripts/feeds update -a
make V=s PKG_HASH=skip PKG_MIRROR_HASH=skip