erebion/coreboot
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

src/device + util/sconfig: Introduce new device 'mdio'

Browse source 
This patch extends the available device paths with a new device 'mdio'.
MDIO is the 'Management Data Input/Output' called interface which is
used to access an Ethernet PHY behind a MAC to change settings. The real
payload data path is not handled by this interface.

To address the PHY correctly on the MDIO bus, there is a 5 bit address
needed, which often can be configured via pins on the mainboard.
Therefore, the new introduced device has an 'addr' field to define its
address. If one wants to use a MDIO device in devicetree, the syntax is
straight forward (example):
	device mdio 0x2 on end

As the MDIO interface is driven by the MAC, most likely this MDIO device
will be hooked in as a child device of the (PCI attached) MAC device.

With the new introduced ops_mdio a new interface is added to provide an
API for read and write access over MDIO.

Change-Id: I6691f92c4233bc30afc9029840b06f74bb1eb4b2
Signed-off-by: Mario Scheithauer <mario.scheithauer@siemens.com>
Signed-off-by: Werner Zeh <werner.zeh@siemens.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/69382
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
Reviewed-by: Arthur Heymans <arthur@aheymans.xyz>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
This commit is contained in:
Mario Scheithauer 2022-11-02 15:57:10 +01:00 • committed by Martin L Roth
commit 67f63e768d
13 changed files with 336 additions and 271 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/include/device/path.h
View file

@ -22,6 +22,7 @@ enum device_path_type {
DEVICE_PATH_USB,
DEVICE_PATH_MMIO,
DEVICE_PATH_GPIO,
DEVICE_PATH_MDIO,
/*
* When adding path types to this table, please also update the
@ -46,6 +47,7 @@ enum device_path_type {
"DEVICE_PATH_USB", \
"DEVICE_PATH_MMIO", \
"DEVICE_PATH_GPIO", \
"DEVICE_PATH_MDIO", \
}
struct domain_path {
@ -112,6 +114,10 @@ struct gpio_path {
unsigned int id;
};
struct mdio_path {
unsigned int addr;
};
struct device_path {
enum device_path_type type;
union {
@ -129,6 +135,7 @@ struct device_path {
struct usb_path usb;
struct mmio_path mmio;
struct gpio_path gpio;
struct mdio_path mdio;
};
};