net: phy: Add the Airoha EN8811H PHY driver
Subsystems (2)
PATCH v5 1/1 net: phy: Add the Airoha EN8811H PHY driver
Add the driver for the Airoha EN8811H 2.5 Gigabit PHY. The PHY supports 100/1000/2500 Mbps with auto negotiation only.
The driver uses two firmware files, for which updated versions are added to linux-firmware already.
Locating the AIROHA FW within the filesystem at the designated partition and path will trigger its automatic loading and writing to the PHY via MDIO.
Based on the Linux upstream AIROHA EN8811 driver code(air_en8811.c), I have modified the relevant process to align with the U-Boot boot sequence. and have validated this on Banana Pi BPI-R3 Mini.
---
Change in PATCH v5:air_en8811.c:
* Add read_page & write_page functions for page access.
* Change fs_loader to fw_loader.
* Remove unnecessary debug prints.
Change in PATCH v4:air_en8811.c:
* Create the airoha folder to store all future airoha phy drivers.
* Use request_firmware_into_buf_via_script for firmware loading.
Change in PATCH v3:air_en8811.c:
* Add U-Boot environment variable(en8811h_fw_part, en8811h_fw_dm_dir, en8811h_fw_dsp_dir) support for firmware loading.
Regarding the firmware loading mechanism,
Please refer to the following script example for guidance:
1. `env set en8811h_load_firmware 'env set en8811h_load_firmware_addr 0x46000000 && env set en8811h_load_firmware_size 0x24000 && mw.b ${en8811h_load_firmware_addr} 0 ${en8811h_load_firmware_size} && load mmc 0:3 0x46000000 /boot/EthMD32.dm.bin && if test ${filesize} -eq 4000; then load mmc 0:3 0x46004000 /boot/EthMD32.DSP.bin; else echo "loading MD32 FW failed"; env set en8811h_load_firmware_size 0; exit 1;fi'`
````Test Log```` Net: 16384 bytes read in 1 ms (15.6 MiB/s) 131072 bytes read in 9 ms (13.9 MiB/s) addr: 0x46000000, size: 0x24000 Found Airoha Firmware. MD32 firmware version: 24112802 ````End of Test Log````
2. `env set en8811h_load_firmware 'env set en8811h_load_firmware_addr 0x46000000 && env set en8811h_load_firmware_size 0x24000 && mmc partconf 0 1 2 2 && mmc read $en8811h_load_firmware_addr 0x0 0x120 && mmc partconf 0 1 1 0'`
````Test Log```` Net: MMC read: dev # 0, block # 0, count 288 ... 288 blocks read: OK addr: 0x46000000, size: 0x24000 Found Airoha Firmware. MD32 firmware version: 24112802 ````End of Test Log````
drivers/net/phy/Kconfig | 2 + drivers/net/phy/Makefile | 1 + drivers/net/phy/airoha/Kconfig | 11 + drivers/net/phy/airoha/Makefile | 3 + drivers/net/phy/airoha/air_en8811.c | 805 ++++++++++++++++++++++++++++ 5 files changed, 822 insertions(+) create mode 100644 drivers/net/phy/airoha/Kconfig create mode 100644 drivers/net/phy/airoha/Makefile create mode 100644 drivers/net/phy/airoha/air_en8811.c
drivers/net/phy/Kconfig +2 -0
@@ -188,6 +188,8 @@ config PHY_MARVELL_10G source "drivers/net/phy/mediatek/Kconfig" +source "drivers/net/phy/airoha/Kconfig" + config PHY_MESON_GXL bool "Amlogic Meson GXL Internal PHY support"
drivers/net/phy/Makefile +1 -0
@@ -22,6 +22,7 @@ obj-$(CONFIG_PHY_LXT) += lxt.o obj-$(CONFIG_PHY_MARVELL) += marvell.o obj-$(CONFIG_PHY_MARVELL_10G) += marvell10g.o obj-y += mediatek/ +obj-y += airoha/ obj-$(CONFIG_PHY_MICREL_KSZ8XXX) += micrel_ksz8xxx.o obj-$(CONFIG_PHY_MICREL_KSZ90X1) += micrel_ksz90x1.o obj-$(CONFIG_PHY_MESON_GXL) += meson-gxl.o
drivers/net/phy/airoha/Kconfig new file +11 -0
@@ -0,0 +1,11 @@ +# SPDX-License-Identifier: GPL-2.0-only +menuconfig PHY_AIROHA + bool "Airoha Ethernet PHYs support" + +config PHY_AIROHA_EN8811 + bool "Airoha Ethernet EN8811H support" + depends on PHY_AIROHA + select FW_LOADER + help + AIROHA EN8811H supported. +
drivers/net/phy/airoha/Makefile new file +3 -0
@@ -0,0 +1,3 @@ +# SPDX-License-Identifier: GPL-2.0 + +obj-$(CONFIG_PHY_AIROHA_EN8811) += air_en8811.o
drivers/net/phy/airoha/air_en8811.c new file +805 -0
805 lines not on this page · raw message
--
2.34.1
On 11/9/25 5:37 PM, Lucien.Jheng wrote:
[...]
drivers/net/phy/airoha/air_en8811.c line 52
Quoted 5 lines
drivers/net/phy/airoha/air_en8811.c new file +5
-0+#define AIR_EXT_PAGE_ACCESS 0x1f +#define AIR_PHY_PAGE_STANDARD 0x0000 +#define AIR_PHY_PAGE_EXTENDED_4 0x0004 + +/* MII Registers Page 4*/
4[SPACE]*/ ... missing space before *
Quoted 11 lines
drivers/net/phy/airoha/air_en8811.c new file +11
-0+#define AIR_BPBUS_MODE 0x10 +#define AIR_BPBUS_MODE_ADDR_FIXED 0x0000 +#define AIR_BPBUS_MODE_ADDR_INCR BIT(15) +#define AIR_BPBUS_WR_ADDR_HIGH 0x11 +#define AIR_BPBUS_WR_ADDR_LOW 0x12 +#define AIR_BPBUS_WR_DATA_HIGH 0x13 +#define AIR_BPBUS_WR_DATA_LOW 0x14 +#define AIR_BPBUS_RD_ADDR_HIGH 0x15 +#define AIR_BPBUS_RD_ADDR_LOW 0x16 +#define AIR_BPBUS_RD_DATA_HIGH 0x17 +#define AIR_BPBUS_RD_DATA_LOW 0x18
[...]
Quoted 28 lines
drivers/net/phy/airoha/air_en8811.c new file +28
-0+static int air_buckpbus_reg_write (struct phy_device *phydev, +u32 pbus_address,u32 pbus_data) +{ +int ret, saved_page; + + saved_page =phy_select_page (phydev,AIR_PHY_PAGE_EXTENDED_4 ); +if (saved_page <0 ) +return saved_page; + + ret =phy_write (phydev,MDIO_DEVAD_NONE ,AIR_BPBUS_MODE , +AIR_BPBUS_MODE_ADDR_FIXED ); +if (ret <0 ) + goto restore_page; + + ret =phy_write (phydev,MDIO_DEVAD_NONE ,AIR_BPBUS_WR_ADDR_HIGH , +upper_16_bits (pbus_address)); +if (ret <0 ) + goto restore_page; + + ret =phy_write (phydev,MDIO_DEVAD_NONE ,AIR_BPBUS_WR_ADDR_LOW , +lower_16_bits (pbus_address)); +if (ret <0 ) + goto restore_page; + + ret =phy_write (phydev,MDIO_DEVAD_NONE ,AIR_BPBUS_WR_DATA_HIGH , +upper_16_bits (pbus_data)); +if (ret <0 ) + goto restore_page;
drivers/net/phy/airoha/air_en8811.c line 236
Quoted 10 lines
drivers/net/phy/airoha/air_en8811.c new file +10
-0+ + ret =phy_write (phydev,MDIO_DEVAD_NONE ,AIR_BPBUS_WR_DATA_LOW , +lower_16_bits (pbus_data)); +if (ret <0 ) + goto restore_page; + +restore_page: +if (ret <0 ) +printf ("%s 0x%08x failed: %d\n" , __func__, + pbus_address, ret);
Can you use dev_err(phydev->dev, "%s..... here ? The struct phy_device has access to udevice and with dev_err(), you will get automatic device instance identifier in the print (useful if you have multiple PHYs).
Quoted 2 lines
(quoted diff) +2
-0+ return phy_restore_page(phydev, saved_page, ret); +}
[...]
drivers/net/phy/airoha/air_en8811.c line 416
Quoted 12 lines
drivers/net/phy/airoha/air_en8811.c new file +12
-0+static int en8811h_wait_mcu_ready (struct phy_device *phydev) +{ +int ret, reg_value; + +/* Because of mdio-lock, may have to wait for multiple loads */ + ret =phy_read_mmd_poll_timeout (phydev,MDIO_MMD_VEND1 , +EN8811H_PHY_FW_STATUS , reg_value, + reg_value ==EN8811H_PHY_READY , +20000 ,7500000 , true); +if (ret) { +printf ("MCU not ready: 0x%x\n" , reg_value); +return -ENODEV ;
return ret; should be fine here ?
drivers/net/phy/airoha/air_en8811.c line 420
Quoted 4 lines
drivers/net/phy/airoha/air_en8811.c new file +4
-0+ } + +return 0 ; +}
With those fixed:
Thank you for your hard work !