mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-11-01 08:58:07 +00:00
767ff48373
While PHY time stamping drivers can simply attach their interface directly to the PHY instance, stand alone drivers require support in order to manage their services. Non-PHY MII time stamping drivers have a control interface over another bus like I2C, SPI, UART, or via a memory mapped peripheral. The controller device will be associated with one or more time stamping channels, each of which sits snoops in on a MII bus. This patch provides a glue layer that will enable time stamping channels to find their controlling device. Signed-off-by: Richard Cochran <richardcochran@gmail.com> Reviewed-by: Andrew Lunn <andrew@lunn.ch> Signed-off-by: David S. Miller <davem@davemloft.net>
121 lines
3.6 KiB
C
121 lines
3.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Support for generic time stamping devices on MII buses.
|
|
* Copyright (C) 2018 Richard Cochran <richardcochran@gmail.com>
|
|
*/
|
|
#ifndef _LINUX_MII_TIMESTAMPER_H
|
|
#define _LINUX_MII_TIMESTAMPER_H
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/ethtool.h>
|
|
#include <linux/skbuff.h>
|
|
|
|
struct phy_device;
|
|
|
|
/**
|
|
* struct mii_timestamper - Callback interface to MII time stamping devices.
|
|
*
|
|
* @rxtstamp: Requests a Rx timestamp for 'skb'. If the skb is accepted,
|
|
* the MII time stamping device promises to deliver it using
|
|
* netif_rx() as soon as a timestamp becomes available. One of
|
|
* the PTP_CLASS_ values is passed in 'type'. The function
|
|
* must return true if the skb is accepted for delivery.
|
|
*
|
|
* @txtstamp: Requests a Tx timestamp for 'skb'. The MII time stamping
|
|
* device promises to deliver it using skb_complete_tx_timestamp()
|
|
* as soon as a timestamp becomes available. One of the PTP_CLASS_
|
|
* values is passed in 'type'.
|
|
*
|
|
* @hwtstamp: Handles SIOCSHWTSTAMP ioctl for hardware time stamping.
|
|
*
|
|
* @link_state: Allows the device to respond to changes in the link
|
|
* state. The caller invokes this function while holding
|
|
* the phy_device mutex.
|
|
*
|
|
* @ts_info: Handles ethtool queries for hardware time stamping.
|
|
* @device: Remembers the device to which the instance belongs.
|
|
*
|
|
* Drivers for PHY time stamping devices should embed their
|
|
* mii_timestamper within a private structure, obtaining a reference
|
|
* to it using container_of().
|
|
*
|
|
* Drivers for non-PHY time stamping devices should return a pointer
|
|
* to a mii_timestamper from the probe_channel() callback of their
|
|
* mii_timestamping_ctrl interface.
|
|
*/
|
|
struct mii_timestamper {
|
|
bool (*rxtstamp)(struct mii_timestamper *mii_ts,
|
|
struct sk_buff *skb, int type);
|
|
|
|
void (*txtstamp)(struct mii_timestamper *mii_ts,
|
|
struct sk_buff *skb, int type);
|
|
|
|
int (*hwtstamp)(struct mii_timestamper *mii_ts,
|
|
struct ifreq *ifreq);
|
|
|
|
void (*link_state)(struct mii_timestamper *mii_ts,
|
|
struct phy_device *phydev);
|
|
|
|
int (*ts_info)(struct mii_timestamper *mii_ts,
|
|
struct ethtool_ts_info *ts_info);
|
|
|
|
struct device *device;
|
|
};
|
|
|
|
/**
|
|
* struct mii_timestamping_ctrl - MII time stamping controller interface.
|
|
*
|
|
* @probe_channel: Callback into the controller driver announcing the
|
|
* presence of the 'port' channel. The 'device' field
|
|
* had been passed to register_mii_tstamp_controller().
|
|
* The driver must return either a pointer to a valid
|
|
* MII timestamper instance or PTR_ERR.
|
|
*
|
|
* @release_channel: Releases an instance obtained via .probe_channel.
|
|
*/
|
|
struct mii_timestamping_ctrl {
|
|
struct mii_timestamper *(*probe_channel)(struct device *device,
|
|
unsigned int port);
|
|
void (*release_channel)(struct device *device,
|
|
struct mii_timestamper *mii_ts);
|
|
};
|
|
|
|
#ifdef CONFIG_NETWORK_PHY_TIMESTAMPING
|
|
|
|
int register_mii_tstamp_controller(struct device *device,
|
|
struct mii_timestamping_ctrl *ctrl);
|
|
|
|
void unregister_mii_tstamp_controller(struct device *device);
|
|
|
|
struct mii_timestamper *register_mii_timestamper(struct device_node *node,
|
|
unsigned int port);
|
|
|
|
void unregister_mii_timestamper(struct mii_timestamper *mii_ts);
|
|
|
|
#else
|
|
|
|
static inline
|
|
int register_mii_tstamp_controller(struct device *device,
|
|
struct mii_timestamping_ctrl *ctrl)
|
|
{
|
|
return -EOPNOTSUPP;
|
|
}
|
|
|
|
static inline void unregister_mii_tstamp_controller(struct device *device)
|
|
{
|
|
}
|
|
|
|
static inline
|
|
struct mii_timestamper *register_mii_timestamper(struct device_node *node,
|
|
unsigned int port)
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
static inline void unregister_mii_timestamper(struct mii_timestamper *mii_ts)
|
|
{
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif
|