The Linux Manuals (man pages) document is an important part of Linux documents. Linux Manuals are organized as several sections. Each section has a group of commands for a specific area in Linux usage, administration or development.
phys_to_virt – map physical address to virtual Synopsis void *phys_to_virt(phys_addr_t address); Arguments address address to remap Description The returned virtual address is a current CPU mapping for the memory address given. It is only valid to use this function on addresses that have a kernel mapping This function does not handle bus mappings for DMA…
phy_write_mmd_indirect – writes data to the MMD registers Synopsis void phy_write_mmd_indirect(struct phy_device *phydev, int prtad, int devad, u32 data); Arguments phydev The PHY device prtad MMD Address devad MMD DEVAD data data to write in the MMD register Description Write data from the MMD registers of the specified phy address. To write these register we…
phy_trigger_machine – trigger the state machine to run Synopsis void phy_trigger_machine(struct phy_device *phydev); Arguments phydev the phy_device struct Description There has been a change in state which requires that the state machine runs. Copyright
phy_stop_machine – stop the PHY state machine tracking Synopsis void phy_stop_machine(struct phy_device *phydev); Arguments phydev target phy_device struct Description Stops the state machine timer, sets the state to UP (unless it wasn’t up yet). This function must be called BEFORE phy_detach. Copyright
phy_stop_interrupts – disable interrupts from a PHY device Synopsis int phy_stop_interrupts(struct phy_device *phydev); Arguments phydev target phy_device struct Copyright
phy_stop – Bring down the PHY link, and stop checking the status Synopsis void phy_stop(struct phy_device *phydev); Arguments phydev target phy_device struct Copyright
phy_state_machine – Handle the state machine Synopsis void phy_state_machine(struct work_struct *work); Arguments work work_struct that describes the work to be done Copyright
phy_start_machine – start PHY state machine tracking Synopsis void phy_start_machine(struct phy_device *phydev); Arguments phydev the phy_device struct Description The PHY infrastructure can run a state machine which tracks whether the PHY is starting up, negotiating, etc. This function starts the timer which tracks the state of the PHY. If you want to maintain your own…
phy_start_interrupts – request and enable interrupts for a PHY device Synopsis int phy_start_interrupts(struct phy_device *phydev); Arguments phydev target phy_device struct Description Request the interrupt for the given PHY. If this fails, then we set irq to PHY_POLL. Otherwise, we enable the interrupts in the PHY. This should only be called with a valid IRQ number….
phy_start_aneg – start auto-negotiation for this PHY device Synopsis int phy_start_aneg(struct phy_device *phydev); Arguments phydev the phy_device struct Description Sanitizes the settings (if we’re not autonegotiating them), and then calls the driver’s config_aneg function. If the PHYCONTROL Layer is operating, we change the state to reflect the beginning of Auto-negotiation or forcing. Copyright
phy_start – start or restart a PHY device Synopsis void phy_start(struct phy_device *phydev); Arguments phydev target phy_device struct Description Indicates the attached device’s readiness to handle PHY-related work. Used during startup to start the PHY, and after a call to phy_stop to resume operation. Also used to indicate the MDIO bus has cleared an error…
phy_sanitize_settings – make sure the PHY is set to supported speed and duplex Synopsis void phy_sanitize_settings(struct phy_device *phydev); Arguments phydev the target phy_device struct Description Make sure the PHY is set to supported speeds and duplexes. Drop down by one in this order: 1000/FULL, 1000/HALF, 100/FULL, 100/HALF, 10/FULL, 10/HALF. Copyright
phy_register_fixup – creates a new phy_fixup and adds it to the list Synopsis int phy_register_fixup(const char *bus_id, u32 phy_uid, u32 phy_uid_mask, int (*run)(struct phy_device *)); Arguments bus_id A string which matches phydev->mdio.dev.bus_id (or PHY_ANY_ID) phy_uid Used to match against phydev->phy_id (the UID of the PHY) It can also be PHY_ANY_UID phy_uid_mask Applied to phydev->phy_id and…
phy_read_mmd_indirect – reads data from the MMD registers Synopsis int phy_read_mmd_indirect(struct phy_device *phydev, int prtad, int devad); Arguments phydev The PHY device bus prtad MMD Address devad MMD DEVAD Description it reads data from the MMD registers (clause 22 to access to clause 45) of the specified phy address. To read these register we have:…
phy_probe – probe and init a PHY device Synopsis int phy_probe(struct device *dev); Arguments dev device to probe and init Description Take care of setting up the phy_device structure, set the state to READY (the driver’s init function should set it to STARTING if needed). Copyright
phy_print_status – Convenience function to print out the current phy status Synopsis void phy_print_status(struct phy_device *phydev); Arguments phydev the phy_device struct Copyright
phy_prepare_link – prepares the PHY layer to monitor link status Synopsis void phy_prepare_link(struct phy_device *phydev, void (*handler)(struct net_device *)); Arguments phydev target phy_device struct handler callback function for link status change notifications Description Tells the PHY infrastructure to handle the gory details on monitoring link status (whether through polling or an interrupt), and to call…
phy_poll_reset – Safely wait until a PHY reset has properly completed Synopsis int phy_poll_reset(struct phy_device *phydev); Arguments phydev The PHY device to poll Description According to IEEE 802.3, Section 2, Subsection 22.2.4.1.1, as published in 2008, a PHY reset may take up to 0.5 seconds. The MII BMCR register must be polled until the BMCR_RESET…
phy_mii_ioctl – generic PHY MII ioctl interface Synopsis int phy_mii_ioctl(struct phy_device *phydev, struct ifreq *ifr, int cmd); Arguments phydev the phy_device struct ifr struct ifreq for socket ioctl’s cmd ioctl cmd to execute Description Note that this function is currently incompatible with the PHYCONTROL layer. It changes registers without regard to current state. Use at…
phy_interrupt – PHY interrupt handler Synopsis irqreturn_t phy_interrupt(int irq, void * phy_dat); Arguments irq interrupt line phy_dat phy_device pointer Description When a PHY interrupt occurs, the handler disables interrupts, and schedules a work task to clear the interrupt. Copyright