1 /* 2 * phy.h -- generic phy header file 3 * 4 * Copyright (C) 2013 Texas Instruments Incorporated - http://www.ti.com 5 * 6 * Author: Kishon Vijay Abraham I <[email protected]> 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License as published by 10 * the Free Software Foundation; either version 2 of the License, or 11 * (at your option) any later version. 12 */ 13 14 #ifndef __DRIVERS_PHY_H 15 #define __DRIVERS_PHY_H 16 17 #include <linux/err.h> 18 #include <linux/of.h> 19 #include <linux/device.h> 20 #include <linux/pm_runtime.h> 21 22 struct phy; 23 24 /** 25 * struct phy_ops - set of function pointers for performing phy operations 26 * @init: operation to be performed for initializing phy 27 * @exit: operation to be performed while exiting 28 * @power_on: powering on the phy 29 * @power_off: powering off the phy 30 * @owner: the module owner containing the ops 31 */ 32 struct phy_ops { 33 int (*init)(struct phy *phy); 34 int (*exit)(struct phy *phy); 35 int (*power_on)(struct phy *phy); 36 int (*power_off)(struct phy *phy); 37 struct module *owner; 38 }; 39 40 /** 41 * struct phy_attrs - represents phy attributes 42 * @bus_width: Data path width implemented by PHY 43 */ 44 struct phy_attrs { 45 u32 bus_width; 46 }; 47 48 /** 49 * struct phy - represents the phy device 50 * @dev: phy device 51 * @id: id of the phy device 52 * @ops: function pointers for performing phy operations 53 * @init_data: list of PHY consumers (non-dt only) 54 * @mutex: mutex to protect phy_ops 55 * @init_count: used to protect when the PHY is used by multiple consumers 56 * @power_count: used to protect when the PHY is used by multiple consumers 57 * @phy_attrs: used to specify PHY specific attributes 58 */ 59 struct phy { 60 struct device dev; 61 int id; 62 const struct phy_ops *ops; 63 struct phy_init_data *init_data; 64 struct mutex mutex; 65 int init_count; 66 int power_count; 67 struct phy_attrs attrs; 68 }; 69 70 /** 71 * struct phy_provider - represents the phy provider 72 * @dev: phy provider device 73 * @owner: the module owner having of_xlate 74 * @of_xlate: function pointer to obtain phy instance from phy pointer 75 * @list: to maintain a linked list of PHY providers 76 */ 77 struct phy_provider { 78 struct device *dev; 79 struct module *owner; 80 struct list_head list; 81 struct phy * (*of_xlate)(struct device *dev, 82 struct of_phandle_args *args); 83 }; 84 85 /** 86 * struct phy_consumer - represents the phy consumer 87 * @dev_name: the device name of the controller that will use this PHY device 88 * @port: name given to the consumer port 89 */ 90 struct phy_consumer { 91 const char *dev_name; 92 const char *port; 93 }; 94 95 /** 96 * struct phy_init_data - contains the list of PHY consumers 97 * @num_consumers: number of consumers for this PHY device 98 * @consumers: list of PHY consumers 99 */ 100 struct phy_init_data { 101 unsigned int num_consumers; 102 struct phy_consumer *consumers; 103 }; 104 105 #define PHY_CONSUMER(_dev_name, _port) \ 106 { \ 107 .dev_name = _dev_name, \ 108 .port = _port, \ 109 } 110 111 #define to_phy(dev) (container_of((dev), struct phy, dev)) 112 113 #define of_phy_provider_register(dev, xlate) \ 114 __of_phy_provider_register((dev), THIS_MODULE, (xlate)) 115 116 #define devm_of_phy_provider_register(dev, xlate) \ 117 __devm_of_phy_provider_register((dev), THIS_MODULE, (xlate)) 118 119 static inline void phy_set_drvdata(struct phy *phy, void *data) 120 { 121 dev_set_drvdata(&phy->dev, data); 122 } 123 124 static inline void *phy_get_drvdata(struct phy *phy) 125 { 126 return dev_get_drvdata(&phy->dev); 127 } 128 129 #if IS_ENABLED(CONFIG_GENERIC_PHY) 130 int phy_pm_runtime_get(struct phy *phy); 131 int phy_pm_runtime_get_sync(struct phy *phy); 132 int phy_pm_runtime_put(struct phy *phy); 133 int phy_pm_runtime_put_sync(struct phy *phy); 134 void phy_pm_runtime_allow(struct phy *phy); 135 void phy_pm_runtime_forbid(struct phy *phy); 136 int phy_init(struct phy *phy); 137 int phy_exit(struct phy *phy); 138 int phy_power_on(struct phy *phy); 139 int phy_power_off(struct phy *phy); 140 static inline int phy_get_bus_width(struct phy *phy) 141 { 142 return phy->attrs.bus_width; 143 } 144 static inline void phy_set_bus_width(struct phy *phy, int bus_width) 145 { 146 phy->attrs.bus_width = bus_width; 147 } 148 struct phy *phy_get(struct device *dev, const char *string); 149 struct phy *phy_optional_get(struct device *dev, const char *string); 150 struct phy *devm_phy_get(struct device *dev, const char *string); 151 struct phy *devm_phy_optional_get(struct device *dev, const char *string); 152 struct phy *devm_of_phy_get(struct device *dev, struct device_node *np, 153 const char *con_id); 154 void phy_put(struct phy *phy); 155 void devm_phy_put(struct device *dev, struct phy *phy); 156 struct phy *of_phy_get(struct device_node *np, const char *con_id); 157 struct phy *of_phy_simple_xlate(struct device *dev, 158 struct of_phandle_args *args); 159 struct phy *phy_create(struct device *dev, const struct phy_ops *ops, 160 struct phy_init_data *init_data); 161 struct phy *devm_phy_create(struct device *dev, 162 const struct phy_ops *ops, struct phy_init_data *init_data); 163 void phy_destroy(struct phy *phy); 164 void devm_phy_destroy(struct device *dev, struct phy *phy); 165 struct phy_provider *__of_phy_provider_register(struct device *dev, 166 struct module *owner, struct phy * (*of_xlate)(struct device *dev, 167 struct of_phandle_args *args)); 168 struct phy_provider *__devm_of_phy_provider_register(struct device *dev, 169 struct module *owner, struct phy * (*of_xlate)(struct device *dev, 170 struct of_phandle_args *args)); 171 void of_phy_provider_unregister(struct phy_provider *phy_provider); 172 void devm_of_phy_provider_unregister(struct device *dev, 173 struct phy_provider *phy_provider); 174 #else 175 static inline int phy_pm_runtime_get(struct phy *phy) 176 { 177 if (!phy) 178 return 0; 179 return -ENOSYS; 180 } 181 182 static inline int phy_pm_runtime_get_sync(struct phy *phy) 183 { 184 if (!phy) 185 return 0; 186 return -ENOSYS; 187 } 188 189 static inline int phy_pm_runtime_put(struct phy *phy) 190 { 191 if (!phy) 192 return 0; 193 return -ENOSYS; 194 } 195 196 static inline int phy_pm_runtime_put_sync(struct phy *phy) 197 { 198 if (!phy) 199 return 0; 200 return -ENOSYS; 201 } 202 203 static inline void phy_pm_runtime_allow(struct phy *phy) 204 { 205 return; 206 } 207 208 static inline void phy_pm_runtime_forbid(struct phy *phy) 209 { 210 return; 211 } 212 213 static inline int phy_init(struct phy *phy) 214 { 215 if (!phy) 216 return 0; 217 return -ENOSYS; 218 } 219 220 static inline int phy_exit(struct phy *phy) 221 { 222 if (!phy) 223 return 0; 224 return -ENOSYS; 225 } 226 227 static inline int phy_power_on(struct phy *phy) 228 { 229 if (!phy) 230 return 0; 231 return -ENOSYS; 232 } 233 234 static inline int phy_power_off(struct phy *phy) 235 { 236 if (!phy) 237 return 0; 238 return -ENOSYS; 239 } 240 241 static inline int phy_get_bus_width(struct phy *phy) 242 { 243 return -ENOSYS; 244 } 245 246 static inline void phy_set_bus_width(struct phy *phy, int bus_width) 247 { 248 return; 249 } 250 251 static inline struct phy *phy_get(struct device *dev, const char *string) 252 { 253 return ERR_PTR(-ENOSYS); 254 } 255 256 static inline struct phy *phy_optional_get(struct device *dev, 257 const char *string) 258 { 259 return ERR_PTR(-ENOSYS); 260 } 261 262 static inline struct phy *devm_phy_get(struct device *dev, const char *string) 263 { 264 return ERR_PTR(-ENOSYS); 265 } 266 267 static inline struct phy *devm_phy_optional_get(struct device *dev, 268 const char *string) 269 { 270 return ERR_PTR(-ENOSYS); 271 } 272 273 static inline struct phy *devm_of_phy_get(struct device *dev, 274 struct device_node *np, 275 const char *con_id) 276 { 277 return ERR_PTR(-ENOSYS); 278 } 279 280 static inline void phy_put(struct phy *phy) 281 { 282 } 283 284 static inline void devm_phy_put(struct device *dev, struct phy *phy) 285 { 286 } 287 288 static inline struct phy *of_phy_get(struct device_node *np, const char *con_id) 289 { 290 return ERR_PTR(-ENOSYS); 291 } 292 293 static inline struct phy *of_phy_simple_xlate(struct device *dev, 294 struct of_phandle_args *args) 295 { 296 return ERR_PTR(-ENOSYS); 297 } 298 299 static inline struct phy *phy_create(struct device *dev, 300 const struct phy_ops *ops, struct phy_init_data *init_data) 301 { 302 return ERR_PTR(-ENOSYS); 303 } 304 305 static inline struct phy *devm_phy_create(struct device *dev, 306 const struct phy_ops *ops, struct phy_init_data *init_data) 307 { 308 return ERR_PTR(-ENOSYS); 309 } 310 311 static inline void phy_destroy(struct phy *phy) 312 { 313 } 314 315 static inline void devm_phy_destroy(struct device *dev, struct phy *phy) 316 { 317 } 318 319 static inline struct phy_provider *__of_phy_provider_register( 320 struct device *dev, struct module *owner, struct phy * (*of_xlate)( 321 struct device *dev, struct of_phandle_args *args)) 322 { 323 return ERR_PTR(-ENOSYS); 324 } 325 326 static inline struct phy_provider *__devm_of_phy_provider_register(struct device 327 *dev, struct module *owner, struct phy * (*of_xlate)(struct device *dev, 328 struct of_phandle_args *args)) 329 { 330 return ERR_PTR(-ENOSYS); 331 } 332 333 static inline void of_phy_provider_unregister(struct phy_provider *phy_provider) 334 { 335 } 336 337 static inline void devm_of_phy_provider_unregister(struct device *dev, 338 struct phy_provider *phy_provider) 339 { 340 } 341 #endif 342 343 #endif /* __DRIVERS_PHY_H */ 344