Zephyr API Documentation  3.5.0
A Scalable Open Source RTOS
3.5.0
All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
phy.h
Go to the documentation of this file.
1
7/*
8 * Copyright (c) 2021 IP-Logix Inc.
9 * Copyright 2022 NXP
10 *
11 * SPDX-License-Identifier: Apache-2.0
12 */
13#ifndef ZEPHYR_INCLUDE_DRIVERS_PHY_H_
14#define ZEPHYR_INCLUDE_DRIVERS_PHY_H_
15
22#include <zephyr/types.h>
23#include <zephyr/device.h>
24
25#ifdef __cplusplus
26extern "C" {
27#endif
28
43};
44
45#define PHY_LINK_IS_FULL_DUPLEX(x) (x & (BIT(1) | BIT(3) | BIT(5)))
46#define PHY_LINK_IS_SPEED_1000M(x) (x & (BIT(4) | BIT(5)))
47#define PHY_LINK_IS_SPEED_100M(x) (x & (BIT(2) | BIT(3)))
48
54 bool is_up;
55};
56
66typedef void (*phy_callback_t)(const struct device *dev,
67 struct phy_link_state *state,
68 void *user_data);
69
76__subsystem struct ethphy_driver_api {
78 int (*get_link)(const struct device *dev,
79 struct phy_link_state *state);
80
82 int (*cfg_link)(const struct device *dev,
83 enum phy_link_speed adv_speeds);
84
86 int (*link_cb_set)(const struct device *dev, phy_callback_t cb,
87 void *user_data);
88
90 int (*read)(const struct device *dev, uint16_t reg_addr,
91 uint32_t *data);
92
94 int (*write)(const struct device *dev, uint16_t reg_addr,
95 uint32_t data);
96};
113__syscall int phy_configure_link(const struct device *dev,
114 enum phy_link_speed speeds);
115
116static inline int z_impl_phy_configure_link(const struct device *dev,
117 enum phy_link_speed speeds)
118{
119 const struct ethphy_driver_api *api =
120 (const struct ethphy_driver_api *)dev->api;
121
122 return api->cfg_link(dev, speeds);
123}
124
138__syscall int phy_get_link_state(const struct device *dev,
139 struct phy_link_state *state);
140
141static inline int z_impl_phy_get_link_state(const struct device *dev,
142 struct phy_link_state *state)
143{
144 const struct ethphy_driver_api *api =
145 (const struct ethphy_driver_api *)dev->api;
146
147 return api->get_link(dev, state);
148}
149
164__syscall int phy_link_callback_set(const struct device *dev,
165 phy_callback_t callback,
166 void *user_data);
167
168static inline int z_impl_phy_link_callback_set(const struct device *dev,
169 phy_callback_t callback,
170 void *user_data)
171{
172 const struct ethphy_driver_api *api =
173 (const struct ethphy_driver_api *)dev->api;
174
175 return api->link_cb_set(dev, callback, user_data);
176}
177
190__syscall int phy_read(const struct device *dev, uint16_t reg_addr,
191 uint32_t *value);
192
193static inline int z_impl_phy_read(const struct device *dev, uint16_t reg_addr,
194 uint32_t *value)
195{
196 const struct ethphy_driver_api *api =
197 (const struct ethphy_driver_api *)dev->api;
198
199 return api->read(dev, reg_addr, value);
200}
201
214__syscall int phy_write(const struct device *dev, uint16_t reg_addr,
215 uint32_t value);
216
217static inline int z_impl_phy_write(const struct device *dev, uint16_t reg_addr,
218 uint32_t value)
219{
220 const struct ethphy_driver_api *api =
221 (const struct ethphy_driver_api *)dev->api;
222
223 return api->write(dev, reg_addr, value);
224}
225
226
227#ifdef __cplusplus
228}
229#endif
230
235#include <syscalls/phy.h>
236
237#endif /* ZEPHYR_INCLUDE_DRIVERS_PHY_H_ */
int phy_get_link_state(const struct device *dev, struct phy_link_state *state)
Get PHY link state.
int phy_read(const struct device *dev, uint16_t reg_addr, uint32_t *value)
Read PHY registers.
int phy_write(const struct device *dev, uint16_t reg_addr, uint32_t value)
Write PHY register.
int phy_configure_link(const struct device *dev, enum phy_link_speed speeds)
Configure PHY link.
phy_link_speed
Ethernet link speeds.
Definition: phy.h:30
void(* phy_callback_t)(const struct device *dev, struct phy_link_state *state, void *user_data)
Define the callback function signature for phy_link_callback_set() function.
Definition: phy.h:66
int phy_link_callback_set(const struct device *dev, phy_callback_t callback, void *user_data)
Set link state change callback.
@ LINK_HALF_100BASE_T
100Base-T Half-Duplex
Definition: phy.h:36
@ LINK_HALF_10BASE_T
10Base-T Half-Duplex
Definition: phy.h:32
@ LINK_FULL_1000BASE_T
1000Base-T Full-Duplex
Definition: phy.h:42
@ LINK_FULL_10BASE_T
10Base-T Full-Duplex
Definition: phy.h:34
@ LINK_FULL_100BASE_T
100Base-T Full-Duplex
Definition: phy.h:38
@ LINK_HALF_1000BASE_T
1000Base-T Half-Duplex
Definition: phy.h:40
#define BIT(n)
Unsigned integer with bit position n set (signed in assembly language).
Definition: util_macro.h:44
state
Definition: parser_state.h:29
__UINT32_TYPE__ uint32_t
Definition: stdint.h:90
__UINT16_TYPE__ uint16_t
Definition: stdint.h:89
Runtime device structure (in ROM) per driver instance.
Definition: device.h:381
const void * api
Address of the API structure exposed by the device instance.
Definition: device.h:387