Blame view
include/linux/extcon.h
12.7 KB
de55d8716 Extcon (external ... |
1 |
/* |
6ab6094f3 extcon: Correct d... |
2 |
* External Connector (extcon) framework |
de55d8716 Extcon (external ... |
3 |
* |
2a9de9c0f extcon: Use the u... |
4 5 6 |
* Copyright (C) 2015 Samsung Electronics * Author: Chanwoo Choi <cw00.choi@samsung.com> * |
de55d8716 Extcon (external ... |
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
* Copyright (C) 2012 Samsung Electronics * Author: Donggeun Kim <dg77.kim@samsung.com> * Author: MyungJoo Ham <myungjoo.ham@samsung.com> * * based on switch class driver * Copyright (C) 2008 Google, Inc. * Author: Mike Lockwood <lockwood@android.com> * * This software is licensed under the terms of the GNU General Public * License version 2, as published by the Free Software Foundation, and * may be copied, distributed, and modified under those terms. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. |
6ab6094f3 extcon: Correct d... |
23 |
*/ |
de55d8716 Extcon (external ... |
24 25 26 |
#ifndef __LINUX_EXTCON_H__ #define __LINUX_EXTCON_H__ |
d851718f6 extcon: Add missi... |
27 |
#include <linux/device.h> |
806d9dd71 Extcon: support m... |
28 |
|
73b6ecdb9 extcon: Redefine ... |
29 |
/* |
55e4e2f12 extcon: Add the e... |
30 31 32 33 34 35 36 37 38 |
* Define the type of supported external connectors */ #define EXTCON_TYPE_USB BIT(0) /* USB connector */ #define EXTCON_TYPE_CHG BIT(1) /* Charger connector */ #define EXTCON_TYPE_JACK BIT(2) /* Jack connector */ #define EXTCON_TYPE_DISP BIT(3) /* Display connector */ #define EXTCON_TYPE_MISC BIT(4) /* Miscellaneous connector */ /* |
73b6ecdb9 extcon: Redefine ... |
39 40 |
* Define the unique id of supported external connectors */ |
11eecf910 extcon: Modify th... |
41 |
#define EXTCON_NONE 0 |
73b6ecdb9 extcon: Redefine ... |
42 |
|
11eecf910 extcon: Modify th... |
43 44 45 |
/* USB external connector */ #define EXTCON_USB 1 #define EXTCON_USB_HOST 2 |
73b6ecdb9 extcon: Redefine ... |
46 |
|
db6228612 extcon: Add docum... |
47 48 49 50 51 52 53 |
/* * Charging external connector * * When one SDP charger connector was reported, we should also report * the USB connector, which means EXTCON_CHG_USB_SDP should always * appear together with EXTCON_USB. The same as ACA charger connector, * EXTCON_CHG_USB_ACA would normally appear with EXTCON_USB_HOST. |
62a37443e extcon: Add docum... |
54 55 56 57 |
* * The EXTCON_CHG_USB_SLOW connector can provide at least 500mA of * current at 5V. The EXTCON_CHG_USB_FAST connector can provide at * least 1A of current at 5V. |
db6228612 extcon: Add docum... |
58 |
*/ |
11eecf910 extcon: Modify th... |
59 60 61 62 63 64 |
#define EXTCON_CHG_USB_SDP 5 /* Standard Downstream Port */ #define EXTCON_CHG_USB_DCP 6 /* Dedicated Charging Port */ #define EXTCON_CHG_USB_CDP 7 /* Charging Downstream Port */ #define EXTCON_CHG_USB_ACA 8 /* Accessory Charger Adapter */ #define EXTCON_CHG_USB_FAST 9 #define EXTCON_CHG_USB_SLOW 10 |
7fe95fb88 extcon: Add new E... |
65 |
#define EXTCON_CHG_WPT 11 /* Wireless Power Transfer */ |
3c5f0e076 extcon: Add new E... |
66 |
#define EXTCON_CHG_USB_PD 12 /* USB Power Delivery */ |
73b6ecdb9 extcon: Redefine ... |
67 |
|
11eecf910 extcon: Modify th... |
68 69 70 71 72 73 74 75 76 |
/* Jack external connector */ #define EXTCON_JACK_MICROPHONE 20 #define EXTCON_JACK_HEADPHONE 21 #define EXTCON_JACK_LINE_IN 22 #define EXTCON_JACK_LINE_OUT 23 #define EXTCON_JACK_VIDEO_IN 24 #define EXTCON_JACK_VIDEO_OUT 25 #define EXTCON_JACK_SPDIF_IN 26 /* Sony Philips Digital InterFace */ #define EXTCON_JACK_SPDIF_OUT 27 |
73b6ecdb9 extcon: Redefine ... |
77 |
|
11eecf910 extcon: Modify th... |
78 79 80 81 82 |
/* Display external connector */ #define EXTCON_DISP_HDMI 40 /* High-Definition Multimedia Interface */ #define EXTCON_DISP_MHL 41 /* Mobile High-Definition Link */ #define EXTCON_DISP_DVI 42 /* Digital Visual Interface */ #define EXTCON_DISP_VGA 43 /* Video Graphics Array */ |
2164188d5 extcon: Add EXTCO... |
83 |
#define EXTCON_DISP_DP 44 /* Display Port */ |
9c0595d68 extcon: Add new E... |
84 |
#define EXTCON_DISP_HMD 45 /* Head-Mounted Display */ |
11eecf910 extcon: Modify th... |
85 86 87 88 89 90 91 |
/* Miscellaneous external connector */ #define EXTCON_DOCK 60 #define EXTCON_JIG 61 #define EXTCON_MECHANICAL 62 #define EXTCON_NUM 63 |
806d9dd71 Extcon: support m... |
92 |
|
792e7e9e5 extcon: Add the s... |
93 |
/* |
6ab6094f3 extcon: Correct d... |
94 |
* Define the properties of supported external connectors. |
792e7e9e5 extcon: Add the s... |
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 |
* * When adding the new extcon property, they *must* have * the type/value/default information. Also, you *have to* * modify the EXTCON_PROP_[type]_START/END definitions * which mean the range of the supported properties * for each extcon type. * * The naming style of property * : EXTCON_PROP_[type]_[property name] * * EXTCON_PROP_USB_[property name] : USB property * EXTCON_PROP_CHG_[property name] : Charger property * EXTCON_PROP_JACK_[property name] : Jack property * EXTCON_PROP_DISP_[property name] : Display property */ /* * Properties of EXTCON_TYPE_USB. * * - EXTCON_PROP_USB_VBUS * @type: integer (intval) * @value: 0 (low) or 1 (high) * @default: 0 (low) |
2164188d5 extcon: Add EXTCO... |
118 119 120 121 |
* - EXTCON_PROP_USB_TYPEC_POLARITY * @type: integer (intval) * @value: 0 (normal) or 1 (flip) * @default: 0 (normal) |
8457a1b49 extcon: Introduce... |
122 123 124 125 126 |
* - EXTCON_PROP_USB_SS (SuperSpeed) * @type: integer (intval) * @value: 0 (USB/USB2) or 1 (USB3) * @default: 0 (USB/USB2) * |
792e7e9e5 extcon: Add the s... |
127 128 |
*/ #define EXTCON_PROP_USB_VBUS 0 |
2164188d5 extcon: Add EXTCO... |
129 |
#define EXTCON_PROP_USB_TYPEC_POLARITY 1 |
8457a1b49 extcon: Introduce... |
130 |
#define EXTCON_PROP_USB_SS 2 |
792e7e9e5 extcon: Add the s... |
131 132 |
#define EXTCON_PROP_USB_MIN 0 |
8457a1b49 extcon: Introduce... |
133 |
#define EXTCON_PROP_USB_MAX 2 |
792e7e9e5 extcon: Add the s... |
134 135 136 137 138 139 140 141 142 143 144 |
#define EXTCON_PROP_USB_CNT (EXTCON_PROP_USB_MAX - EXTCON_PROP_USB_MIN + 1) /* Properties of EXTCON_TYPE_CHG. */ #define EXTCON_PROP_CHG_MIN 50 #define EXTCON_PROP_CHG_MAX 50 #define EXTCON_PROP_CHG_CNT (EXTCON_PROP_CHG_MAX - EXTCON_PROP_CHG_MIN + 1) /* Properties of EXTCON_TYPE_JACK. */ #define EXTCON_PROP_JACK_MIN 100 #define EXTCON_PROP_JACK_MAX 100 #define EXTCON_PROP_JACK_CNT (EXTCON_PROP_JACK_MAX - EXTCON_PROP_JACK_MIN + 1) |
c7914e8df extcon: Introduce... |
145 146 147 148 149 150 151 152 153 154 |
/* * Properties of EXTCON_TYPE_DISP. * * - EXTCON_PROP_DISP_HPD (Hot Plug Detect) * @type: integer (intval) * @value: 0 (no hpd) or 1 (hpd) * @default: 0 (no hpd) * */ #define EXTCON_PROP_DISP_HPD 150 |
792e7e9e5 extcon: Add the s... |
155 156 |
/* Properties of EXTCON_TYPE_DISP. */ #define EXTCON_PROP_DISP_MIN 150 |
c7914e8df extcon: Introduce... |
157 |
#define EXTCON_PROP_DISP_MAX 151 |
792e7e9e5 extcon: Add the s... |
158 159 160 161 162 163 164 165 166 167 168 |
#define EXTCON_PROP_DISP_CNT (EXTCON_PROP_DISP_MAX - EXTCON_PROP_DISP_MIN + 1) /* * Define the type of property's value. * * Define the property's value as union type. Because each property * would need the different data type to store it. */ union extcon_property_value { int intval; /* type : integer (intval) */ }; |
806d9dd71 Extcon: support m... |
169 |
struct extcon_cable; |
e6cf04654 extcon: Move defi... |
170 |
struct extcon_dev; |
806d9dd71 Extcon: support m... |
171 |
|
de55d8716 Extcon (external ... |
172 |
#if IS_ENABLED(CONFIG_EXTCON) |
74c5d09bd Extcon: support n... |
173 |
|
6ab6094f3 extcon: Correct d... |
174 |
/* Following APIs register/unregister the extcon device. */ |
42d7d7539 extcon: Simplify ... |
175 |
extern int extcon_dev_register(struct extcon_dev *edev); |
de55d8716 Extcon (external ... |
176 |
extern void extcon_dev_unregister(struct extcon_dev *edev); |
1111244ff extcon: Add resou... |
177 |
extern int devm_extcon_dev_register(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
178 |
struct extcon_dev *edev); |
1111244ff extcon: Add resou... |
179 |
extern void devm_extcon_dev_unregister(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
180 |
struct extcon_dev *edev); |
de55d8716 Extcon (external ... |
181 |
|
6ab6094f3 extcon: Correct d... |
182 |
/* Following APIs allocate/free the memory of the extcon device. */ |
73b6ecdb9 extcon: Redefine ... |
183 |
extern struct extcon_dev *extcon_dev_allocate(const unsigned int *cable); |
a9af65223 extcon: Add extco... |
184 |
extern void extcon_dev_free(struct extcon_dev *edev); |
739ba1bfd extcon: Add devm_... |
185 |
extern struct extcon_dev *devm_extcon_dev_allocate(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
186 |
const unsigned int *cable); |
739ba1bfd extcon: Add devm_... |
187 |
extern void devm_extcon_dev_free(struct device *dev, struct extcon_dev *edev); |
a9af65223 extcon: Add extco... |
188 |
|
6ab6094f3 extcon: Correct d... |
189 190 |
/* Synchronize the state and property value for each external connector. */ extern int extcon_sync(struct extcon_dev *edev, unsigned int id); |
a9af65223 extcon: Add extco... |
191 |
/* |
6ab6094f3 extcon: Correct d... |
192 193 |
* Following APIs get/set the connected state of each external connector. * The 'id' argument indicates the defined external connector. |
806d9dd71 Extcon: support m... |
194 |
*/ |
575c2b867 extcon: Rename th... |
195 196 |
extern int extcon_get_state(struct extcon_dev *edev, unsigned int id); extern int extcon_set_state(struct extcon_dev *edev, unsigned int id, |
ab8a8fbe9 extcon: Use tab i... |
197 |
bool state); |
ab11af049 extcon: Add the s... |
198 |
extern int extcon_set_state_sync(struct extcon_dev *edev, unsigned int id, |
6ab6094f3 extcon: Correct d... |
199 |
bool state); |
806d9dd71 Extcon: support m... |
200 |
|
74c5d09bd Extcon: support n... |
201 |
/* |
6ab6094f3 extcon: Correct d... |
202 203 204 205 206 207 208 |
* Following APIs get/set the property of each external connector. * The 'id' argument indicates the defined external connector * and the 'prop' indicates the extcon property. * * And extcon_get/set_property_capability() set the capability of the property * for each external connector. They are used to set the capability of the * property of each external connector based on the id and property. |
792e7e9e5 extcon: Add the s... |
209 210 211 212 213 214 215 |
*/ extern int extcon_get_property(struct extcon_dev *edev, unsigned int id, unsigned int prop, union extcon_property_value *prop_val); extern int extcon_set_property(struct extcon_dev *edev, unsigned int id, unsigned int prop, union extcon_property_value prop_val); |
ab11af049 extcon: Add the s... |
216 217 218 |
extern int extcon_set_property_sync(struct extcon_dev *edev, unsigned int id, unsigned int prop, union extcon_property_value prop_val); |
7f2a0a169 extcon: Add the s... |
219 220 221 222 223 224 |
extern int extcon_get_property_capability(struct extcon_dev *edev, unsigned int id, unsigned int prop); extern int extcon_set_property_capability(struct extcon_dev *edev, unsigned int id, unsigned int prop); /* |
6ab6094f3 extcon: Correct d... |
225 226 227 |
* Following APIs register the notifier block in order to detect * the change of both state and property value for each external connector. * |
815429b39 extcon: Add new e... |
228 229 230 231 |
* extcon_register_notifier(*edev, id, *nb) : Register a notifier block * for specific external connector of the extcon. * extcon_register_notifier_all(*edev, *nb) : Register a notifier block * for all supported external connectors of the extcon. |
74c5d09bd Extcon: support n... |
232 |
*/ |
73b6ecdb9 extcon: Redefine ... |
233 |
extern int extcon_register_notifier(struct extcon_dev *edev, unsigned int id, |
ab8a8fbe9 extcon: Use tab i... |
234 |
struct notifier_block *nb); |
73b6ecdb9 extcon: Redefine ... |
235 |
extern int extcon_unregister_notifier(struct extcon_dev *edev, unsigned int id, |
ab8a8fbe9 extcon: Use tab i... |
236 |
struct notifier_block *nb); |
58f386560 extcon: Add resou... |
237 238 239 240 241 242 |
extern int devm_extcon_register_notifier(struct device *dev, struct extcon_dev *edev, unsigned int id, struct notifier_block *nb); extern void devm_extcon_unregister_notifier(struct device *dev, struct extcon_dev *edev, unsigned int id, struct notifier_block *nb); |
1ad94ffef extcon: Move OF h... |
243 |
|
815429b39 extcon: Add new e... |
244 245 246 247 248 249 250 251 252 253 |
extern int extcon_register_notifier_all(struct extcon_dev *edev, struct notifier_block *nb); extern int extcon_unregister_notifier_all(struct extcon_dev *edev, struct notifier_block *nb); extern int devm_extcon_register_notifier_all(struct device *dev, struct extcon_dev *edev, struct notifier_block *nb); extern void devm_extcon_unregister_notifier_all(struct device *dev, struct extcon_dev *edev, struct notifier_block *nb); |
1ad94ffef extcon: Move OF h... |
254 |
/* |
6ab6094f3 extcon: Correct d... |
255 |
* Following APIs get the extcon_dev from devicetree or by through extcon name. |
1ad94ffef extcon: Move OF h... |
256 |
*/ |
6ab6094f3 extcon: Correct d... |
257 |
extern struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name); |
b9ec23c08 extcon: Fix the c... |
258 259 |
extern struct extcon_dev *extcon_get_edev_by_phandle(struct device *dev, int index); |
707d75508 extcon: Add extco... |
260 |
|
6ab6094f3 extcon: Correct d... |
261 |
/* Following API get the name of extcon device. */ |
707d75508 extcon: Add extco... |
262 |
extern const char *extcon_get_edev_name(struct extcon_dev *edev); |
de55d8716 Extcon (external ... |
263 |
#else /* CONFIG_EXTCON */ |
42d7d7539 extcon: Simplify ... |
264 |
static inline int extcon_dev_register(struct extcon_dev *edev) |
de55d8716 Extcon (external ... |
265 266 267 268 269 |
{ return 0; } static inline void extcon_dev_unregister(struct extcon_dev *edev) { } |
1111244ff extcon: Add resou... |
270 |
static inline int devm_extcon_dev_register(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
271 |
struct extcon_dev *edev) |
1111244ff extcon: Add resou... |
272 273 274 275 276 |
{ return -EINVAL; } static inline void devm_extcon_dev_unregister(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
277 |
struct extcon_dev *edev) { } |
1111244ff extcon: Add resou... |
278 |
|
73b6ecdb9 extcon: Redefine ... |
279 |
static inline struct extcon_dev *extcon_dev_allocate(const unsigned int *cable) |
a9af65223 extcon: Add extco... |
280 281 282 283 284 |
{ return ERR_PTR(-ENOSYS); } static inline void extcon_dev_free(struct extcon_dev *edev) { } |
739ba1bfd extcon: Add devm_... |
285 |
static inline struct extcon_dev *devm_extcon_dev_allocate(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
286 |
const unsigned int *cable) |
739ba1bfd extcon: Add devm_... |
287 288 289 290 291 |
{ return ERR_PTR(-ENOSYS); } static inline void devm_extcon_dev_free(struct extcon_dev *edev) { } |
575c2b867 extcon: Rename th... |
292 293 |
static inline int extcon_get_state(struct extcon_dev *edev, unsigned int id) |
806d9dd71 Extcon: support m... |
294 295 296 |
{ return 0; } |
575c2b867 extcon: Rename th... |
297 |
static inline int extcon_set_state(struct extcon_dev *edev, unsigned int id, |
6ab6094f3 extcon: Correct d... |
298 |
bool state) |
806d9dd71 Extcon: support m... |
299 300 301 |
{ return 0; } |
ab11af049 extcon: Add the s... |
302 |
static inline int extcon_set_state_sync(struct extcon_dev *edev, unsigned int id, |
6ab6094f3 extcon: Correct d... |
303 |
bool state) |
ab11af049 extcon: Add the s... |
304 305 306 307 308 |
{ return 0; } static inline int extcon_sync(struct extcon_dev *edev, unsigned int id) |
cb9850d09 Merge branch 'nex... |
309 310 311 312 313 |
{ return 0; } static inline int extcon_get_property(struct extcon_dev *edev, unsigned int id, |
ab8a8fbe9 extcon: Use tab i... |
314 315 |
unsigned int prop, union extcon_property_value *prop_val) |
cb9850d09 Merge branch 'nex... |
316 317 318 319 |
{ return 0; } static inline int extcon_set_property(struct extcon_dev *edev, unsigned int id, |
ab8a8fbe9 extcon: Use tab i... |
320 321 |
unsigned int prop, union extcon_property_value prop_val) |
ab11af049 extcon: Add the s... |
322 323 324 |
{ return 0; } |
cb9850d09 Merge branch 'nex... |
325 |
static inline int extcon_set_property_sync(struct extcon_dev *edev, |
ab8a8fbe9 extcon: Use tab i... |
326 327 |
unsigned int id, unsigned int prop, union extcon_property_value prop_val) |
792e7e9e5 extcon: Add the s... |
328 329 330 |
{ return 0; } |
7f2a0a169 extcon: Add the s... |
331 |
static inline int extcon_get_property_capability(struct extcon_dev *edev, |
ab8a8fbe9 extcon: Use tab i... |
332 |
unsigned int id, unsigned int prop) |
7f2a0a169 extcon: Add the s... |
333 334 335 336 337 |
{ return 0; } static inline int extcon_set_property_capability(struct extcon_dev *edev, |
ab8a8fbe9 extcon: Use tab i... |
338 |
unsigned int id, unsigned int prop) |
7f2a0a169 extcon: Add the s... |
339 340 341 |
{ return 0; } |
74c5d09bd Extcon: support n... |
342 |
static inline int extcon_register_notifier(struct extcon_dev *edev, |
ab8a8fbe9 extcon: Use tab i... |
343 |
unsigned int id, struct notifier_block *nb) |
74c5d09bd Extcon: support n... |
344 345 346 347 348 |
{ return 0; } static inline int extcon_unregister_notifier(struct extcon_dev *edev, |
ab8a8fbe9 extcon: Use tab i... |
349 |
unsigned int id, struct notifier_block *nb) |
74c5d09bd Extcon: support n... |
350 351 352 |
{ return 0; } |
58f386560 extcon: Add resou... |
353 354 355 356 357 358 359 360 361 362 |
static inline int devm_extcon_register_notifier(struct device *dev, struct extcon_dev *edev, unsigned int id, struct notifier_block *nb) { return -ENOSYS; } static inline void devm_extcon_unregister_notifier(struct device *dev, struct extcon_dev *edev, unsigned int id, struct notifier_block *nb) { } |
6ab6094f3 extcon: Correct d... |
363 364 |
static inline struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name) { |
ab8a8fbe9 extcon: Use tab i... |
365 |
return ERR_PTR(-ENODEV); |
6ab6094f3 extcon: Correct d... |
366 |
} |
830ae4422 extcon: Remove th... |
367 |
static inline struct extcon_dev *extcon_get_edev_by_phandle(struct device *dev, |
ab8a8fbe9 extcon: Use tab i... |
368 |
int index) |
806d9dd71 Extcon: support m... |
369 |
{ |
830ae4422 extcon: Remove th... |
370 |
return ERR_PTR(-ENODEV); |
806d9dd71 Extcon: support m... |
371 |
} |
830ae4422 extcon: Remove th... |
372 |
#endif /* CONFIG_EXTCON */ |
806d9dd71 Extcon: support m... |
373 |
|
830ae4422 extcon: Remove th... |
374 375 376 377 378 379 380 381 382 383 384 385 |
/* * Following structure and API are deprecated. EXTCON remains the function * definition to prevent the build break. */ struct extcon_specific_cable_nb { struct notifier_block *user_nb; int cable_index; struct extcon_dev *edev; unsigned long previous_value; }; static inline int extcon_register_interest(struct extcon_specific_cable_nb *obj, |
ab8a8fbe9 extcon: Use tab i... |
386 387 |
const char *extcon_name, const char *cable_name, struct notifier_block *nb) |
806d9dd71 Extcon: support m... |
388 |
{ |
830ae4422 extcon: Remove th... |
389 |
return -EINVAL; |
806d9dd71 Extcon: support m... |
390 |
} |
1ad94ffef extcon: Move OF h... |
391 |
|
ab8a8fbe9 extcon: Use tab i... |
392 |
static inline int extcon_unregister_interest(struct extcon_specific_cable_nb *obj) |
1ad94ffef extcon: Move OF h... |
393 |
{ |
830ae4422 extcon: Remove th... |
394 |
return -EINVAL; |
1ad94ffef extcon: Move OF h... |
395 |
} |
de55d8716 Extcon (external ... |
396 |
#endif /* __LINUX_EXTCON_H__ */ |