67f63e768d
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>
147 lines
2.5 KiB
C
147 lines
2.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
|
|
#ifndef DEVICE_PATH_H
|
|
#define DEVICE_PATH_H
|
|
|
|
#include <stdint.h>
|
|
|
|
enum device_path_type {
|
|
DEVICE_PATH_NONE = 0,
|
|
DEVICE_PATH_ROOT,
|
|
DEVICE_PATH_PCI,
|
|
DEVICE_PATH_PNP,
|
|
DEVICE_PATH_I2C,
|
|
DEVICE_PATH_APIC,
|
|
DEVICE_PATH_DOMAIN,
|
|
DEVICE_PATH_CPU_CLUSTER,
|
|
DEVICE_PATH_CPU,
|
|
DEVICE_PATH_CPU_BUS,
|
|
DEVICE_PATH_IOAPIC,
|
|
DEVICE_PATH_GENERIC,
|
|
DEVICE_PATH_SPI,
|
|
DEVICE_PATH_USB,
|
|
DEVICE_PATH_MMIO,
|
|
DEVICE_PATH_GPIO,
|
|
DEVICE_PATH_MDIO,
|
|
|
|
/*
|
|
* When adding path types to this table, please also update the
|
|
* DEVICE_PATH_NAMES macro below.
|
|
*/
|
|
};
|
|
|
|
#define DEVICE_PATH_NAMES { \
|
|
"DEVICE_PATH_NONE", \
|
|
"DEVICE_PATH_ROOT", \
|
|
"DEVICE_PATH_PCI", \
|
|
"DEVICE_PATH_PNP", \
|
|
"DEVICE_PATH_I2C", \
|
|
"DEVICE_PATH_APIC", \
|
|
"DEVICE_PATH_DOMAIN", \
|
|
"DEVICE_PATH_CPU_CLUSTER", \
|
|
"DEVICE_PATH_CPU", \
|
|
"DEVICE_PATH_CPU_BUS", \
|
|
"DEVICE_PATH_IOAPIC", \
|
|
"DEVICE_PATH_GENERIC", \
|
|
"DEVICE_PATH_SPI", \
|
|
"DEVICE_PATH_USB", \
|
|
"DEVICE_PATH_MMIO", \
|
|
"DEVICE_PATH_GPIO", \
|
|
"DEVICE_PATH_MDIO", \
|
|
}
|
|
|
|
struct domain_path {
|
|
unsigned int domain;
|
|
};
|
|
|
|
struct pci_path {
|
|
unsigned int devfn;
|
|
};
|
|
|
|
struct pnp_path {
|
|
unsigned int port;
|
|
unsigned int device;
|
|
};
|
|
|
|
struct i2c_path {
|
|
unsigned int device;
|
|
unsigned int mode_10bit;
|
|
};
|
|
|
|
struct spi_path {
|
|
unsigned int cs;
|
|
};
|
|
|
|
struct apic_path {
|
|
unsigned int apic_id;
|
|
unsigned int package_id;
|
|
unsigned int node_id;
|
|
unsigned int core_id;
|
|
unsigned int thread_id;
|
|
};
|
|
|
|
struct ioapic_path {
|
|
unsigned int ioapic_id;
|
|
};
|
|
|
|
struct cpu_cluster_path {
|
|
unsigned int cluster;
|
|
};
|
|
|
|
struct cpu_path {
|
|
unsigned int id;
|
|
};
|
|
|
|
struct cpu_bus_path {
|
|
unsigned int id;
|
|
};
|
|
|
|
struct generic_path {
|
|
unsigned int id;
|
|
unsigned int subid;
|
|
};
|
|
|
|
struct usb_path {
|
|
unsigned int port_type;
|
|
unsigned int port_id;
|
|
};
|
|
|
|
struct mmio_path {
|
|
uintptr_t addr;
|
|
};
|
|
|
|
struct gpio_path {
|
|
unsigned int id;
|
|
};
|
|
|
|
struct mdio_path {
|
|
unsigned int addr;
|
|
};
|
|
|
|
struct device_path {
|
|
enum device_path_type type;
|
|
union {
|
|
struct pci_path pci;
|
|
struct pnp_path pnp;
|
|
struct i2c_path i2c;
|
|
struct apic_path apic;
|
|
struct ioapic_path ioapic;
|
|
struct domain_path domain;
|
|
struct cpu_cluster_path cpu_cluster;
|
|
struct cpu_path cpu;
|
|
struct cpu_bus_path cpu_bus;
|
|
struct generic_path generic;
|
|
struct spi_path spi;
|
|
struct usb_path usb;
|
|
struct mmio_path mmio;
|
|
struct gpio_path gpio;
|
|
struct mdio_path mdio;
|
|
};
|
|
};
|
|
|
|
#define DEVICE_PATH_MAX 40
|
|
#define BUS_PATH_MAX (DEVICE_PATH_MAX+10)
|
|
|
|
extern const char *dev_path_name(enum device_path_type type);
|
|
|
|
#endif /* DEVICE_PATH_H */
|