drivers/net/ethernet/stmicro/stmmac/dwmac-nuvoton.c
Source file repositories/reference/linux-study-clean/drivers/net/ethernet/stmicro/stmmac/dwmac-nuvoton.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/net/ethernet/stmicro/stmmac/dwmac-nuvoton.c- Extension
.c- Size
- 3571 bytes
- Lines
- 139
- Domain
- Driver Families
- Bucket
- drivers/net
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/mfd/syscon.hlinux/mod_devicetable.hlinux/of.hlinux/of_net.hlinux/platform_device.hlinux/regmap.hlinux/stmmac.hstmmac_platform.h
Detected Declarations
struct nvt_priv_datafunction nvt_gmac_get_delayfunction nvt_set_phy_intf_selfunction nvt_gmac_probe
Annotated Snippet
struct nvt_priv_data {
struct device *dev;
struct regmap *regmap;
u32 macid;
};
static int nvt_gmac_get_delay(struct device *dev, const char *property)
{
u32 arg;
if (of_property_read_u32(dev->of_node, property, &arg))
return 0;
if (arg > 2000)
return -EINVAL;
if (arg == 2000)
return 15;
return arg / NVT_PATH_DELAY_STEP;
}
static int nvt_set_phy_intf_sel(void *bsp_priv, u8 phy_intf_sel)
{
struct nvt_priv_data *priv = bsp_priv;
u32 reg, val;
int ret;
if (phy_intf_sel == PHY_INTF_SEL_RGMII) {
ret = nvt_gmac_get_delay(priv->dev, "rx-internal-delay-ps");
if (ret < 0)
return ret;
val = FIELD_PREP(NVT_RX_DELAY_MASK, ret);
ret = nvt_gmac_get_delay(priv->dev, "tx-internal-delay-ps");
if (ret < 0)
return ret;
val |= FIELD_PREP(NVT_TX_DELAY_MASK, ret);
} else if (phy_intf_sel == PHY_INTF_SEL_RMII) {
val = NVT_MISCR_RMII;
} else {
return -EINVAL;
}
reg = (priv->macid == 0) ? NVT_REG_SYS_GMAC0MISCR : NVT_REG_SYS_GMAC1MISCR;
regmap_update_bits(priv->regmap, reg,
NVT_RX_DELAY_MASK | NVT_TX_DELAY_MASK | NVT_MISCR_RMII, val);
return 0;
}
static int nvt_gmac_probe(struct platform_device *pdev)
{
struct plat_stmmacenet_data *plat_dat;
struct stmmac_resources stmmac_res;
struct device *dev = &pdev->dev;
struct nvt_priv_data *priv;
int ret;
ret = stmmac_get_platform_resources(pdev, &stmmac_res);
if (ret)
return dev_err_probe(dev, ret, "Failed to get platform resources\n");
plat_dat = devm_stmmac_probe_config_dt(pdev, stmmac_res.mac);
if (IS_ERR(plat_dat))
return dev_err_probe(dev, PTR_ERR(plat_dat), "Failed to get platform data\n");
priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
if (!priv)
return dev_err_probe(dev, -ENOMEM, "Failed to allocate private data\n");
priv->dev = dev;
priv->regmap = syscon_regmap_lookup_by_phandle_args(dev->of_node, "nuvoton,sys",
1, &priv->macid);
if (IS_ERR(priv->regmap))
return dev_err_probe(dev, PTR_ERR(priv->regmap), "Failed to get sys register\n");
if (priv->macid > 1)
return dev_err_probe(dev, -EINVAL, "Invalid sys arguments\n");
plat_dat->bsp_priv = priv;
plat_dat->set_phy_intf_sel = nvt_set_phy_intf_sel;
return stmmac_pltfr_probe(pdev, plat_dat, &stmmac_res);
}
static const struct of_device_id nvt_dwmac_match[] = {
{ .compatible = "nuvoton,ma35d1-dwmac"},
{ }
Annotation
- Immediate include surface: `linux/mfd/syscon.h`, `linux/mod_devicetable.h`, `linux/of.h`, `linux/of_net.h`, `linux/platform_device.h`, `linux/regmap.h`, `linux/stmmac.h`, `stmmac_platform.h`.
- Detected declarations: `struct nvt_priv_data`, `function nvt_gmac_get_delay`, `function nvt_set_phy_intf_sel`, `function nvt_gmac_probe`.
- Atlas domain: Driver Families / drivers/net.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.