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 12struct phy_device; 13struct 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 */ 21struct 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 */ 33struct 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 */ 44struct 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 53struct module; 54struct device_node; 55struct of_phandle_args; 56struct 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 */ 72struct 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) 86int pse_controller_register(struct pse_controller_dev *pcdev); 87void pse_controller_unregister(struct pse_controller_dev *pcdev); 88struct device; 89int devm_pse_controller_register(struct device *dev, 90 struct pse_controller_dev *pcdev); 91 92struct pse_control *of_pse_control_get(struct device_node *node); 93void pse_control_put(struct pse_control *psec); 94 95int pse_ethtool_get_status(struct pse_control *psec, 96 struct netlink_ext_ack *extack, 97 struct pse_control_status *status); 98int 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 104static inline struct pse_control *of_pse_control_get(struct device_node *node) 105{ 106 return ERR_PTR(-ENOENT); 107} 108 109static inline void pse_control_put(struct pse_control *psec) 110{ 111} 112 113static 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 120static 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