phy.h

Go to the documentation of this file.

 
/*
 * Copyright (c) 2021 IP-Logix Inc.
 * Copyright 2022 NXP
 *
 * SPDX-License-Identifier: Apache-2.0
 */
#ifndef ZEPHYR_INCLUDE_DRIVERS_PHY_H_
#define ZEPHYR_INCLUDE_DRIVERS_PHY_H_
 
#include <zephyr/types.h>
#include <zephyr/device.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum phy_link_speed {
        LINK_HALF_10BASE_T              = BIT(0),
        LINK_FULL_10BASE_T              = BIT(1),
        LINK_HALF_100BASE_T             = BIT(2),
        LINK_FULL_100BASE_T             = BIT(3),
        LINK_HALF_1000BASE_T            = BIT(4),
        LINK_FULL_1000BASE_T            = BIT(5),
};
 
#define PHY_LINK_IS_FULL_DUPLEX(x)      (x & (BIT(1) | BIT(3) | BIT(5)))
#define PHY_LINK_IS_SPEED_1000M(x)      (x & (BIT(4) | BIT(5)))
#define PHY_LINK_IS_SPEED_100M(x)       (x & (BIT(2) | BIT(3)))
 
struct phy_link_state {
        enum phy_link_speed speed;
        bool is_up;
};
 
typedef void (*phy_callback_t)(const struct device *dev,
                               struct phy_link_state *state,
                               void *user_data);
 
__subsystem struct ethphy_driver_api {
        int (*get_link)(const struct device *dev,
                        struct phy_link_state *state);
 
        int (*cfg_link)(const struct device *dev,
                        enum phy_link_speed adv_speeds);
 
        int (*link_cb_set)(const struct device *dev, phy_callback_t cb,
                           void *user_data);
 
        int (*read)(const struct device *dev, uint16_t reg_addr,
                    uint32_t *data);
 
        int (*write)(const struct device *dev, uint16_t reg_addr,
                     uint32_t data);
};
static inline int phy_configure_link(const struct device *dev,
                                     enum phy_link_speed speeds)
{
        const struct ethphy_driver_api *api =
                (const struct ethphy_driver_api *)dev->api;
 
        return api->cfg_link(dev, speeds);
}
 
static inline int phy_get_link_state(const struct device *dev,
                                     struct phy_link_state *state)
{
        const struct ethphy_driver_api *api =
                (const struct ethphy_driver_api *)dev->api;
 
        return api->get_link(dev, state);
}
 
static inline int phy_link_callback_set(const struct device *dev,
                                        phy_callback_t callback,
                                        void *user_data)
{
        const struct ethphy_driver_api *api =
                (const struct ethphy_driver_api *)dev->api;
 
        return api->link_cb_set(dev, callback, user_data);
}
 
static inline int phy_read(const struct device *dev, uint16_t reg_addr,
                           uint32_t *value)
{
        const struct ethphy_driver_api *api =
                (const struct ethphy_driver_api *)dev->api;
 
        return api->read(dev, reg_addr, value);
}
 
static inline int phy_write(const struct device *dev, uint16_t reg_addr,
                            uint32_t value)
{
        const struct ethphy_driver_api *api =
                (const struct ethphy_driver_api *)dev->api;
 
        return api->write(dev, reg_addr, value);
}
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_PHY_H_ */