Lines Matching +full:phy +full:- +full:device
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * phy.h -- generic phy header file
5 * Copyright (C) 2013 Texas Instruments Incorporated - http://www.ti.com
15 #include <linux/device.h>
19 #include <linux/phy/phy-dp.h>
20 #include <linux/phy/phy-lvds.h>
21 #include <linux/phy/phy-mipi-dphy.h>
23 struct phy;
55 * union phy_configure_opts - Opaque generic phy configuration
58 * the MIPI_DPHY phy mode.
62 * the LVDS phy mode.
71 * struct phy_ops - set of function pointers for performing phy operations
72 * @init: operation to be performed for initializing phy
74 * @power_on: powering on the phy
75 * @power_off: powering off the phy
76 * @set_mode: set the mode of the phy
77 * @set_media: set the media type of the phy (optional)
78 * @set_speed: set the speed of the phy (optional)
79 * @reset: resetting the phy
80 * @calibrate: calibrate the phy
81 * @release: ops to be performed while the consumer relinquishes the PHY
85 int (*init)(struct phy *phy);
86 int (*exit)(struct phy *phy);
87 int (*power_on)(struct phy *phy);
88 int (*power_off)(struct phy *phy);
89 int (*set_mode)(struct phy *phy, enum phy_mode mode, int submode);
90 int (*set_media)(struct phy *phy, enum phy_media media);
91 int (*set_speed)(struct phy *phy, int speed);
98 * Used to change the PHY parameters. phy_init() must have
99 * been called on the phy.
103 int (*configure)(struct phy *phy, union phy_configure_opts *opts);
111 * handled by the phy. Implementations are free to tune the
114 * any actual configuration of the PHY, so calling it as many
121 int (*validate)(struct phy *phy, enum phy_mode mode, int submode,
123 int (*reset)(struct phy *phy);
124 int (*calibrate)(struct phy *phy);
126 /* notify phy connect status change */
127 int (*connect)(struct phy *phy, int port);
128 int (*disconnect)(struct phy *phy, int port);
130 void (*release)(struct phy *phy);
135 * struct phy_attrs - represents phy attributes
136 * @bus_width: Data path width implemented by PHY
137 * @max_link_rate: Maximum link rate supported by PHY (units to be decided by producer and consumer)
138 * @mode: PHY mode
147 * struct phy - represents the phy device
148 * @dev: phy device
149 * @id: id of the phy device
150 * @ops: function pointers for performing phy operations
152 * @init_count: used to protect when the PHY is used by multiple consumers
153 * @power_count: used to protect when the PHY is used by multiple consumers
154 * @attrs: used to specify PHY specific attributes
155 * @pwr: power regulator associated with the phy
158 struct phy { struct
159 struct device dev;
171 * struct phy_provider - represents the phy provider argument
172 * @dev: phy provider device
173 * @children: can be used to override the default (dev->of_node) child node
175 * @list: to maintain a linked list of PHY providers
176 * @of_xlate: function pointer to obtain phy instance from phy pointer
179 struct device *dev;
183 struct phy * (*of_xlate)(struct device *dev,
188 * struct phy_lookup - PHY association in list of phys managed by the phy driver
190 * @dev_id: the device of the association
191 * @con_id: connection ID string on device
192 * @phy: the phy of the association
198 struct phy *phy; member
201 #define to_phy(a) (container_of((a), struct phy, dev))
215 static inline void phy_set_drvdata(struct phy *phy, void *data) in phy_set_drvdata() argument
217 dev_set_drvdata(&phy->dev, data); in phy_set_drvdata()
220 static inline void *phy_get_drvdata(struct phy *phy) in phy_get_drvdata() argument
222 return dev_get_drvdata(&phy->dev); in phy_get_drvdata()
226 int phy_pm_runtime_get(struct phy *phy);
227 int phy_pm_runtime_get_sync(struct phy *phy);
228 int phy_pm_runtime_put(struct phy *phy);
229 int phy_pm_runtime_put_sync(struct phy *phy);
230 void phy_pm_runtime_allow(struct phy *phy);
231 void phy_pm_runtime_forbid(struct phy *phy);
232 int phy_init(struct phy *phy);
233 int phy_exit(struct phy *phy);
234 int phy_power_on(struct phy *phy);
235 int phy_power_off(struct phy *phy);
236 int phy_set_mode_ext(struct phy *phy, enum phy_mode mode, int submode);
237 #define phy_set_mode(phy, mode) \ argument
238 phy_set_mode_ext(phy, mode, 0)
239 int phy_set_media(struct phy *phy, enum phy_media media);
240 int phy_set_speed(struct phy *phy, int speed);
241 int phy_configure(struct phy *phy, union phy_configure_opts *opts);
242 int phy_validate(struct phy *phy, enum phy_mode mode, int submode,
245 static inline enum phy_mode phy_get_mode(struct phy *phy) in phy_get_mode() argument
247 return phy->attrs.mode; in phy_get_mode()
249 int phy_reset(struct phy *phy);
250 int phy_calibrate(struct phy *phy);
251 int phy_notify_connect(struct phy *phy, int port);
252 int phy_notify_disconnect(struct phy *phy, int port);
253 static inline int phy_get_bus_width(struct phy *phy) in phy_get_bus_width() argument
255 return phy->attrs.bus_width; in phy_get_bus_width()
257 static inline void phy_set_bus_width(struct phy *phy, int bus_width) in phy_set_bus_width() argument
259 phy->attrs.bus_width = bus_width; in phy_set_bus_width()
261 struct phy *phy_get(struct device *dev, const char *string);
262 struct phy *devm_phy_get(struct device *dev, const char *string);
263 struct phy *devm_phy_optional_get(struct device *dev, const char *string);
264 struct phy *devm_of_phy_get(struct device *dev, struct device_node *np,
266 struct phy *devm_of_phy_optional_get(struct device *dev, struct device_node *np,
268 struct phy *devm_of_phy_get_by_index(struct device *dev, struct device_node *np,
270 void of_phy_put(struct phy *phy);
271 void phy_put(struct device *dev, struct phy *phy);
272 void devm_phy_put(struct device *dev, struct phy *phy);
273 struct phy *of_phy_get(struct device_node *np, const char *con_id);
274 struct phy *of_phy_simple_xlate(struct device *dev,
276 struct phy *phy_create(struct device *dev, struct device_node *node,
278 struct phy *devm_phy_create(struct device *dev, struct device_node *node,
280 void phy_destroy(struct phy *phy);
281 void devm_phy_destroy(struct device *dev, struct phy *phy);
282 struct phy_provider *__of_phy_provider_register(struct device *dev,
284 struct phy * (*of_xlate)(struct device *dev,
286 struct phy_provider *__devm_of_phy_provider_register(struct device *dev,
288 struct phy * (*of_xlate)(struct device *dev,
291 void devm_of_phy_provider_unregister(struct device *dev,
293 int phy_create_lookup(struct phy *phy, const char *con_id, const char *dev_id);
294 void phy_remove_lookup(struct phy *phy, const char *con_id, const char *dev_id);
296 static inline int phy_pm_runtime_get(struct phy *phy) in phy_pm_runtime_get() argument
298 if (!phy) in phy_pm_runtime_get()
300 return -ENOSYS; in phy_pm_runtime_get()
303 static inline int phy_pm_runtime_get_sync(struct phy *phy) in phy_pm_runtime_get_sync() argument
305 if (!phy) in phy_pm_runtime_get_sync()
307 return -ENOSYS; in phy_pm_runtime_get_sync()
310 static inline int phy_pm_runtime_put(struct phy *phy) in phy_pm_runtime_put() argument
312 if (!phy) in phy_pm_runtime_put()
314 return -ENOSYS; in phy_pm_runtime_put()
317 static inline int phy_pm_runtime_put_sync(struct phy *phy) in phy_pm_runtime_put_sync() argument
319 if (!phy) in phy_pm_runtime_put_sync()
321 return -ENOSYS; in phy_pm_runtime_put_sync()
324 static inline void phy_pm_runtime_allow(struct phy *phy) in phy_pm_runtime_allow() argument
329 static inline void phy_pm_runtime_forbid(struct phy *phy) in phy_pm_runtime_forbid() argument
334 static inline int phy_init(struct phy *phy) in phy_init() argument
336 if (!phy) in phy_init()
338 return -ENOSYS; in phy_init()
341 static inline int phy_exit(struct phy *phy) in phy_exit() argument
343 if (!phy) in phy_exit()
345 return -ENOSYS; in phy_exit()
348 static inline int phy_power_on(struct phy *phy) in phy_power_on() argument
350 if (!phy) in phy_power_on()
352 return -ENOSYS; in phy_power_on()
355 static inline int phy_power_off(struct phy *phy) in phy_power_off() argument
357 if (!phy) in phy_power_off()
359 return -ENOSYS; in phy_power_off()
362 static inline int phy_set_mode_ext(struct phy *phy, enum phy_mode mode, in phy_set_mode_ext() argument
365 if (!phy) in phy_set_mode_ext()
367 return -ENOSYS; in phy_set_mode_ext()
370 #define phy_set_mode(phy, mode) \ argument
371 phy_set_mode_ext(phy, mode, 0)
373 static inline int phy_set_media(struct phy *phy, enum phy_media media) in phy_set_media() argument
375 if (!phy) in phy_set_media()
377 return -ENODEV; in phy_set_media()
380 static inline int phy_set_speed(struct phy *phy, int speed) in phy_set_speed() argument
382 if (!phy) in phy_set_speed()
384 return -ENODEV; in phy_set_speed()
387 static inline enum phy_mode phy_get_mode(struct phy *phy) in phy_get_mode() argument
392 static inline int phy_reset(struct phy *phy) in phy_reset() argument
394 if (!phy) in phy_reset()
396 return -ENOSYS; in phy_reset()
399 static inline int phy_calibrate(struct phy *phy) in phy_calibrate() argument
401 if (!phy) in phy_calibrate()
403 return -ENOSYS; in phy_calibrate()
406 static inline int phy_notify_connect(struct phy *phy, int index) in phy_notify_connect() argument
408 if (!phy) in phy_notify_connect()
410 return -ENOSYS; in phy_notify_connect()
413 static inline int phy_notify_disconnect(struct phy *phy, int index) in phy_notify_disconnect() argument
415 if (!phy) in phy_notify_disconnect()
417 return -ENOSYS; in phy_notify_disconnect()
420 static inline int phy_configure(struct phy *phy, in phy_configure() argument
423 if (!phy) in phy_configure()
426 return -ENOSYS; in phy_configure()
429 static inline int phy_validate(struct phy *phy, enum phy_mode mode, int submode, in phy_validate() argument
432 if (!phy) in phy_validate()
435 return -ENOSYS; in phy_validate()
438 static inline int phy_get_bus_width(struct phy *phy) in phy_get_bus_width() argument
440 return -ENOSYS; in phy_get_bus_width()
443 static inline void phy_set_bus_width(struct phy *phy, int bus_width) in phy_set_bus_width() argument
448 static inline struct phy *phy_get(struct device *dev, const char *string) in phy_get()
450 return ERR_PTR(-ENOSYS); in phy_get()
453 static inline struct phy *devm_phy_get(struct device *dev, const char *string) in devm_phy_get()
455 return ERR_PTR(-ENOSYS); in devm_phy_get()
458 static inline struct phy *devm_phy_optional_get(struct device *dev, in devm_phy_optional_get()
464 static inline struct phy *devm_of_phy_get(struct device *dev, in devm_of_phy_get()
468 return ERR_PTR(-ENOSYS); in devm_of_phy_get()
471 static inline struct phy *devm_of_phy_optional_get(struct device *dev, in devm_of_phy_optional_get()
478 static inline struct phy *devm_of_phy_get_by_index(struct device *dev, in devm_of_phy_get_by_index()
482 return ERR_PTR(-ENOSYS); in devm_of_phy_get_by_index()
485 static inline void of_phy_put(struct phy *phy) in of_phy_put() argument
489 static inline void phy_put(struct device *dev, struct phy *phy) in phy_put() argument
493 static inline void devm_phy_put(struct device *dev, struct phy *phy) in devm_phy_put() argument
497 static inline struct phy *of_phy_get(struct device_node *np, const char *con_id) in of_phy_get()
499 return ERR_PTR(-ENOSYS); in of_phy_get()
502 static inline struct phy *of_phy_simple_xlate(struct device *dev, in of_phy_simple_xlate()
505 return ERR_PTR(-ENOSYS); in of_phy_simple_xlate()
508 static inline struct phy *phy_create(struct device *dev, in phy_create()
512 return ERR_PTR(-ENOSYS); in phy_create()
515 static inline struct phy *devm_phy_create(struct device *dev, in devm_phy_create()
519 return ERR_PTR(-ENOSYS); in devm_phy_create()
522 static inline void phy_destroy(struct phy *phy) in phy_destroy() argument
526 static inline void devm_phy_destroy(struct device *dev, struct phy *phy) in devm_phy_destroy() argument
531 struct device *dev, struct device_node *children, struct module *owner, in __of_phy_provider_register()
532 struct phy * (*of_xlate)(struct device *dev, in __of_phy_provider_register()
535 return ERR_PTR(-ENOSYS); in __of_phy_provider_register()
538 static inline struct phy_provider *__devm_of_phy_provider_register(struct device in __devm_of_phy_provider_register()
540 struct phy * (*of_xlate)(struct device *dev, in __devm_of_phy_provider_register()
543 return ERR_PTR(-ENOSYS); in __devm_of_phy_provider_register()
550 static inline void devm_of_phy_provider_unregister(struct device *dev, in devm_of_phy_provider_unregister()
555 phy_create_lookup(struct phy *phy, const char *con_id, const char *dev_id) in phy_create_lookup() argument
559 static inline void phy_remove_lookup(struct phy *phy, const char *con_id, in phy_remove_lookup() argument