1 /* 2 * External connector (extcon) class driver 3 * 4 * Copyright (C) 2012 Samsung Electronics 5 * Author: Donggeun Kim <[email protected]> 6 * Author: MyungJoo Ham <[email protected]> 7 * 8 * based on switch class driver 9 * Copyright (C) 2008 Google, Inc. 10 * Author: Mike Lockwood <[email protected]> 11 * 12 * This software is licensed under the terms of the GNU General Public 13 * License version 2, as published by the Free Software Foundation, and 14 * may be copied, distributed, and modified under those terms. 15 * 16 * This program is distributed in the hope that it will be useful, 17 * but WITHOUT ANY WARRANTY; without even the implied warranty of 18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 19 * GNU General Public License for more details. 20 * 21 */ 22 23 #ifndef __LINUX_EXTCON_H__ 24 #define __LINUX_EXTCON_H__ 25 26 #include <linux/device.h> 27 #include <linux/notifier.h> 28 #include <linux/sysfs.h> 29 30 #define SUPPORTED_CABLE_MAX 32 31 #define CABLE_NAME_MAX 30 32 33 /* 34 * The standard cable name is to help support general notifier 35 * and notifiee device drivers to share the common names. 36 * Please use standard cable names unless your notifier device has 37 * a very unique and abnormal cable or 38 * the cable type is supposed to be used with only one unique 39 * pair of notifier/notifiee devices. 40 * 41 * Please add any other "standard" cables used with extcon dev. 42 * 43 * You may add a dot and number to specify version or specification 44 * of the specific cable if it is required. (e.g., "Fast-charger.18" 45 * and "Fast-charger.10" for 1.8A and 1.0A chargers) 46 * However, the notifiee and notifier should be able to handle such 47 * string and if the notifiee can negotiate the protocol or identify, 48 * you don't need such convention. This convention is helpful when 49 * notifier can distinguish but notifiee cannot. 50 */ 51 enum extcon_cable_name { 52 EXTCON_USB = 0, 53 EXTCON_USB_HOST, 54 EXTCON_TA, /* Travel Adaptor */ 55 EXTCON_FAST_CHARGER, 56 EXTCON_SLOW_CHARGER, 57 EXTCON_CHARGE_DOWNSTREAM, /* Charging an external device */ 58 EXTCON_HDMI, 59 EXTCON_MHL, 60 EXTCON_DVI, 61 EXTCON_VGA, 62 EXTCON_DOCK, 63 EXTCON_LINE_IN, 64 EXTCON_LINE_OUT, 65 EXTCON_MIC_IN, 66 EXTCON_HEADPHONE_OUT, 67 EXTCON_SPDIF_IN, 68 EXTCON_SPDIF_OUT, 69 EXTCON_VIDEO_IN, 70 EXTCON_VIDEO_OUT, 71 EXTCON_MECHANICAL, 72 }; 73 extern const char extcon_cable_name[][CABLE_NAME_MAX + 1]; 74 75 struct extcon_cable; 76 77 /** 78 * struct extcon_dev - An extcon device represents one external connector. 79 * @name: The name of this extcon device. Parent device name is 80 * used if NULL. 81 * @supported_cable: Array of supported cable names ending with NULL. 82 * If supported_cable is NULL, cable name related APIs 83 * are disabled. 84 * @mutually_exclusive: Array of mutually exclusive set of cables that cannot 85 * be attached simultaneously. The array should be 86 * ending with NULL or be NULL (no mutually exclusive 87 * cables). For example, if it is { 0x7, 0x30, 0}, then, 88 * {0, 1}, {0, 1, 2}, {0, 2}, {1, 2}, or {4, 5} cannot 89 * be attached simulataneously. {0x7, 0} is equivalent to 90 * {0x3, 0x6, 0x5, 0}. If it is {0xFFFFFFFF, 0}, there 91 * can be no simultaneous connections. 92 * @print_name: An optional callback to override the method to print the 93 * name of the extcon device. 94 * @print_state: An optional callback to override the method to print the 95 * status of the extcon device. 96 * @dev: Device of this extcon. 97 * @state: Attach/detach state of this extcon. Do not provide at 98 * register-time. 99 * @nh: Notifier for the state change events from this extcon 100 * @entry: To support list of extcon devices so that users can search 101 * for extcon devices based on the extcon name. 102 * @lock: 103 * @max_supported: Internal value to store the number of cables. 104 * @extcon_dev_type: Device_type struct to provide attribute_groups 105 * customized for each extcon device. 106 * @cables: Sysfs subdirectories. Each represents one cable. 107 * 108 * In most cases, users only need to provide "User initializing data" of 109 * this struct when registering an extcon. In some exceptional cases, 110 * optional callbacks may be needed. However, the values in "internal data" 111 * are overwritten by register function. 112 */ 113 struct extcon_dev { 114 /* Optional user initializing data */ 115 const char *name; 116 const char **supported_cable; 117 const u32 *mutually_exclusive; 118 119 /* Optional callbacks to override class functions */ 120 ssize_t (*print_name)(struct extcon_dev *edev, char *buf); 121 ssize_t (*print_state)(struct extcon_dev *edev, char *buf); 122 123 /* Internal data. Please do not set. */ 124 struct device dev; 125 struct raw_notifier_head nh; 126 struct list_head entry; 127 int max_supported; 128 spinlock_t lock; /* could be called by irq handler */ 129 u32 state; 130 131 /* /sys/class/extcon/.../cable.n/... */ 132 struct device_type extcon_dev_type; 133 struct extcon_cable *cables; 134 135 /* /sys/class/extcon/.../mutually_exclusive/... */ 136 struct attribute_group attr_g_muex; 137 struct attribute **attrs_muex; 138 struct device_attribute *d_attrs_muex; 139 }; 140 141 /** 142 * struct extcon_cable - An internal data for each cable of extcon device. 143 * @edev: The extcon device 144 * @cable_index: Index of this cable in the edev 145 * @attr_g: Attribute group for the cable 146 * @attr_name: "name" sysfs entry 147 * @attr_state: "state" sysfs entry 148 * @attrs: Array pointing to attr_name and attr_state for attr_g 149 */ 150 struct extcon_cable { 151 struct extcon_dev *edev; 152 int cable_index; 153 154 struct attribute_group attr_g; 155 struct device_attribute attr_name; 156 struct device_attribute attr_state; 157 158 struct attribute *attrs[3]; /* to be fed to attr_g.attrs */ 159 }; 160 161 /** 162 * struct extcon_specific_cable_nb - An internal data for 163 * extcon_register_interest(). 164 * @internal_nb: A notifier block bridging extcon notifier 165 * and cable notifier. 166 * @user_nb: user provided notifier block for events from 167 * a specific cable. 168 * @cable_index: the target cable. 169 * @edev: the target extcon device. 170 * @previous_value: the saved previous event value. 171 */ 172 struct extcon_specific_cable_nb { 173 struct notifier_block internal_nb; 174 struct notifier_block *user_nb; 175 int cable_index; 176 struct extcon_dev *edev; 177 unsigned long previous_value; 178 }; 179 180 #if IS_ENABLED(CONFIG_EXTCON) 181 182 /* 183 * Following APIs are for notifiers or configurations. 184 * Notifiers are the external port and connection devices. 185 */ 186 extern int extcon_dev_register(struct extcon_dev *edev); 187 extern void extcon_dev_unregister(struct extcon_dev *edev); 188 extern struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name); 189 190 /* 191 * get/set/update_state access the 32b encoded state value, which represents 192 * states of all possible cables of the multistate port. For example, if one 193 * calls extcon_set_state(edev, 0x7), it may mean that all the three cables 194 * are attached to the port. 195 */ 196 static inline u32 extcon_get_state(struct extcon_dev *edev) 197 { 198 return edev->state; 199 } 200 201 extern int extcon_set_state(struct extcon_dev *edev, u32 state); 202 extern int extcon_update_state(struct extcon_dev *edev, u32 mask, u32 state); 203 204 /* 205 * get/set_cable_state access each bit of the 32b encoded state value. 206 * They are used to access the status of each cable based on the cable_name 207 * or cable_index, which is retrieved by extcon_find_cable_index 208 */ 209 extern int extcon_find_cable_index(struct extcon_dev *sdev, 210 const char *cable_name); 211 extern int extcon_get_cable_state_(struct extcon_dev *edev, int cable_index); 212 extern int extcon_set_cable_state_(struct extcon_dev *edev, int cable_index, 213 bool cable_state); 214 215 extern int extcon_get_cable_state(struct extcon_dev *edev, 216 const char *cable_name); 217 extern int extcon_set_cable_state(struct extcon_dev *edev, 218 const char *cable_name, bool cable_state); 219 220 /* 221 * Following APIs are for notifiees (those who want to be notified) 222 * to register a callback for events from a specific cable of the extcon. 223 * Notifiees are the connected device drivers wanting to get notified by 224 * a specific external port of a connection device. 225 */ 226 extern int extcon_register_interest(struct extcon_specific_cable_nb *obj, 227 const char *extcon_name, 228 const char *cable_name, 229 struct notifier_block *nb); 230 extern int extcon_unregister_interest(struct extcon_specific_cable_nb *nb); 231 232 /* 233 * Following APIs are to monitor every action of a notifier. 234 * Registrar gets notified for every external port of a connection device. 235 * Probably this could be used to debug an action of notifier; however, 236 * we do not recommend to use this for normal 'notifiee' device drivers who 237 * want to be notified by a specific external port of the notifier. 238 */ 239 extern int extcon_register_notifier(struct extcon_dev *edev, 240 struct notifier_block *nb); 241 extern int extcon_unregister_notifier(struct extcon_dev *edev, 242 struct notifier_block *nb); 243 244 /* 245 * Following API get the extcon device from devicetree. 246 * This function use phandle of devicetree to get extcon device directly. 247 */ 248 extern struct extcon_dev *extcon_get_edev_by_phandle(struct device *dev, int index); 249 #else /* CONFIG_EXTCON */ 250 static inline int extcon_dev_register(struct extcon_dev *edev) 251 { 252 return 0; 253 } 254 255 static inline void extcon_dev_unregister(struct extcon_dev *edev) { } 256 257 static inline u32 extcon_get_state(struct extcon_dev *edev) 258 { 259 return 0; 260 } 261 262 static inline int extcon_set_state(struct extcon_dev *edev, u32 state) 263 { 264 return 0; 265 } 266 267 static inline int extcon_update_state(struct extcon_dev *edev, u32 mask, 268 u32 state) 269 { 270 return 0; 271 } 272 273 static inline int extcon_find_cable_index(struct extcon_dev *edev, 274 const char *cable_name) 275 { 276 return 0; 277 } 278 279 static inline int extcon_get_cable_state_(struct extcon_dev *edev, 280 int cable_index) 281 { 282 return 0; 283 } 284 285 static inline int extcon_set_cable_state_(struct extcon_dev *edev, 286 int cable_index, bool cable_state) 287 { 288 return 0; 289 } 290 291 static inline int extcon_get_cable_state(struct extcon_dev *edev, 292 const char *cable_name) 293 { 294 return 0; 295 } 296 297 static inline int extcon_set_cable_state(struct extcon_dev *edev, 298 const char *cable_name, int state) 299 { 300 return 0; 301 } 302 303 static inline struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name) 304 { 305 return NULL; 306 } 307 308 static inline int extcon_register_notifier(struct extcon_dev *edev, 309 struct notifier_block *nb) 310 { 311 return 0; 312 } 313 314 static inline int extcon_unregister_notifier(struct extcon_dev *edev, 315 struct notifier_block *nb) 316 { 317 return 0; 318 } 319 320 static inline int extcon_register_interest(struct extcon_specific_cable_nb *obj, 321 const char *extcon_name, 322 const char *cable_name, 323 struct notifier_block *nb) 324 { 325 return 0; 326 } 327 328 static inline int extcon_unregister_interest(struct extcon_specific_cable_nb 329 *obj) 330 { 331 return 0; 332 } 333 334 static inline struct extcon_dev *extcon_get_edev_by_phandle(struct device *dev, 335 int index) 336 { 337 return ERR_PTR(-ENODEV); 338 } 339 #endif /* CONFIG_EXTCON */ 340 #endif /* __LINUX_EXTCON_H__ */ 341