1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 // Copyright (c) 2022 Pengutronix, Oleksij Rempel <kernel@pengutronix.de> 4 */ 5 #ifndef _LINUX_PSE_CONTROLLER_H 6 #define _LINUX_PSE_CONTROLLER_H 7 8 #include <linux/ethtool.h> 9 #include <linux/list.h> 10 #include <uapi/linux/ethtool.h> 11 12 struct phy_device; 13 struct pse_controller_dev; 14 15 /** 16 * struct pse_control_config - PSE control/channel configuration. 17 * 18 * @admin_cotrol: set PoDL PSE admin control as described in 19 * IEEE 802.3-2018 30.15.1.2.1 acPoDLPSEAdminControl 20 */ 21 struct pse_control_config { 22 enum ethtool_podl_pse_admin_state admin_cotrol; 23 }; 24 25 /** 26 * struct pse_control_status - PSE control/channel status. 27 * 28 * @podl_admin_state: operational state of the PoDL PSE 29 * functions. IEEE 802.3-2018 30.15.1.1.2 aPoDLPSEAdminState 30 * @podl_pw_status: power detection status of the PoDL PSE. 31 * IEEE 802.3-2018 30.15.1.1.3 aPoDLPSEPowerDetectionStatus: 32 */ 33 struct pse_control_status { 34 enum ethtool_podl_pse_admin_state podl_admin_state; 35 enum ethtool_podl_pse_pw_d_status podl_pw_status; 36 }; 37 38 /** 39 * struct pse_controller_ops - PSE controller driver callbacks 40 * 41 * @ethtool_get_status: get PSE control status for ethtool interface 42 * @ethtool_set_config: set PSE control configuration over ethtool interface 43 */ 44 struct pse_controller_ops { 45 int (*ethtool_get_status)(struct pse_controller_dev *pcdev, 46 unsigned long id, struct netlink_ext_ack *extack, 47 struct pse_control_status *status); 48 int (*ethtool_set_config)(struct pse_controller_dev *pcdev, 49 unsigned long id, struct netlink_ext_ack *extack, 50 const struct pse_control_config *config); 51 }; 52 53 struct module; 54 struct device_node; 55 struct of_phandle_args; 56 struct pse_control; 57 58 /** 59 * struct pse_controller_dev - PSE controller entity that might 60 * provide multiple PSE controls 61 * @ops: a pointer to device specific struct pse_controller_ops 62 * @owner: kernel module of the PSE controller driver 63 * @list: internal list of PSE controller devices 64 * @pse_control_head: head of internal list of requested PSE controls 65 * @dev: corresponding driver model device struct 66 * @of_pse_n_cells: number of cells in PSE line specifiers 67 * @of_xlate: translation function to translate from specifier as found in the 68 * device tree to id as given to the PSE control ops 69 * @nr_lines: number of PSE controls in this controller device 70 * @lock: Mutex for serialization access to the PSE controller 71 */ 72 struct pse_controller_dev { 73 const struct pse_controller_ops *ops; 74 struct module *owner; 75 struct list_head list; 76 struct list_head pse_control_head; 77 struct device *dev; 78 int of_pse_n_cells; 79 int (*of_xlate)(struct pse_controller_dev *pcdev, 80 const struct of_phandle_args *pse_spec); 81 unsigned int nr_lines; 82 struct mutex lock; 83 }; 84 85 #if IS_ENABLED(CONFIG_PSE_CONTROLLER) 86 int pse_controller_register(struct pse_controller_dev *pcdev); 87 void pse_controller_unregister(struct pse_controller_dev *pcdev); 88 struct device; 89 int devm_pse_controller_register(struct device *dev, 90 struct pse_controller_dev *pcdev); 91 92 struct pse_control *of_pse_control_get(struct device_node *node); 93 void pse_control_put(struct pse_control *psec); 94 95 int pse_ethtool_get_status(struct pse_control *psec, 96 struct netlink_ext_ack *extack, 97 struct pse_control_status *status); 98 int pse_ethtool_set_config(struct pse_control *psec, 99 struct netlink_ext_ack *extack, 100 const struct pse_control_config *config); 101 102 #else 103 104 static inline struct pse_control *of_pse_control_get(struct device_node *node) 105 { 106 return ERR_PTR(-ENOENT); 107 } 108 109 static inline void pse_control_put(struct pse_control *psec) 110 { 111 } 112 113 static inline int pse_ethtool_get_status(struct pse_control *psec, 114 struct netlink_ext_ack *extack, 115 struct pse_control_status *status) 116 { 117 return -ENOTSUPP; 118 } 119 120 static inline int pse_ethtool_set_config(struct pse_control *psec, 121 struct netlink_ext_ack *extack, 122 const struct pse_control_config *config) 123 { 124 return -ENOTSUPP; 125 } 126 127 #endif 128 129 #endif 130