drivers/net/usb/r8153_ecm.c
Source file repositories/reference/linux-study-clean/drivers/net/usb/r8153_ecm.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/net/usb/r8153_ecm.c- Extension
.c- Size
- 3995 bytes
- Lines
- 177
- 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.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/module.hlinux/netdevice.hlinux/mii.hlinux/usb.hlinux/usb/cdc.hlinux/usb/usbnet.hlinux/usb/r8152.h
Detected Declarations
function pla_read_wordfunction pla_write_wordfunction r8153_ecm_mdio_readfunction r8153_ecm_mdio_writefunction r8153_bindfunction rtl8153_ecm_probe
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-or-later
#include <linux/module.h>
#include <linux/netdevice.h>
#include <linux/mii.h>
#include <linux/usb.h>
#include <linux/usb/cdc.h>
#include <linux/usb/usbnet.h>
#include <linux/usb/r8152.h>
#define OCP_BASE 0xe86c
static int pla_read_word(struct usbnet *dev, u16 index)
{
u16 byen = BYTE_EN_WORD;
u8 shift = index & 2;
__le32 tmp;
int ret;
if (shift)
byen <<= shift;
index &= ~3;
ret = usbnet_read_cmd(dev, RTL8152_REQ_GET_REGS, RTL8152_REQT_READ, index,
MCU_TYPE_PLA | byen, &tmp, sizeof(tmp));
if (ret < 0)
goto out;
ret = __le32_to_cpu(tmp);
ret >>= (shift * 8);
ret &= 0xffff;
out:
return ret;
}
static int pla_write_word(struct usbnet *dev, u16 index, u32 data)
{
u32 mask = 0xffff;
u16 byen = BYTE_EN_WORD;
u8 shift = index & 2;
__le32 tmp;
int ret;
data &= mask;
if (shift) {
byen <<= shift;
mask <<= (shift * 8);
data <<= (shift * 8);
}
index &= ~3;
ret = usbnet_read_cmd(dev, RTL8152_REQ_GET_REGS, RTL8152_REQT_READ, index,
MCU_TYPE_PLA | byen, &tmp, sizeof(tmp));
if (ret < 0)
goto out;
data |= __le32_to_cpu(tmp) & ~mask;
tmp = __cpu_to_le32(data);
ret = usbnet_write_cmd(dev, RTL8152_REQ_SET_REGS, RTL8152_REQT_WRITE, index,
MCU_TYPE_PLA | byen, &tmp, sizeof(tmp));
out:
return ret;
}
static int r8153_ecm_mdio_read(struct net_device *netdev, int phy_id, int reg)
{
struct usbnet *dev = netdev_priv(netdev);
int ret;
ret = pla_write_word(dev, OCP_BASE, 0xa000);
if (ret < 0)
goto out;
ret = pla_read_word(dev, 0xb400 + reg * 2);
out:
return ret;
}
static void r8153_ecm_mdio_write(struct net_device *netdev, int phy_id, int reg, int val)
{
struct usbnet *dev = netdev_priv(netdev);
int ret;
Annotation
- Immediate include surface: `linux/module.h`, `linux/netdevice.h`, `linux/mii.h`, `linux/usb.h`, `linux/usb/cdc.h`, `linux/usb/usbnet.h`, `linux/usb/r8152.h`.
- Detected declarations: `function pla_read_word`, `function pla_write_word`, `function r8153_ecm_mdio_read`, `function r8153_ecm_mdio_write`, `function r8153_bind`, `function rtl8153_ecm_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.