Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
e6cf0465 CC |
2 | #ifndef __LINUX_EXTCON_INTERNAL_H__ |
3 | #define __LINUX_EXTCON_INTERNAL_H__ | |
4 | ||
176aa360 | 5 | #include <linux/extcon-provider.h> |
e6cf0465 CC |
6 | |
7 | /** | |
8 | * struct extcon_dev - An extcon device represents one external connector. | |
9 | * @name: The name of this extcon device. Parent device name is | |
10 | * used if NULL. | |
11 | * @supported_cable: Array of supported cable names ending with EXTCON_NONE. | |
12 | * If supported_cable is NULL, cable name related APIs | |
13 | * are disabled. | |
14 | * @mutually_exclusive: Array of mutually exclusive set of cables that cannot | |
15 | * be attached simultaneously. The array should be | |
16 | * ending with NULL or be NULL (no mutually exclusive | |
17 | * cables). For example, if it is { 0x7, 0x30, 0}, then, | |
18 | * {0, 1}, {0, 1, 2}, {0, 2}, {1, 2}, or {4, 5} cannot | |
19 | * be attached simulataneously. {0x7, 0} is equivalent to | |
20 | * {0x3, 0x6, 0x5, 0}. If it is {0xFFFFFFFF, 0}, there | |
21 | * can be no simultaneous connections. | |
22 | * @dev: Device of this extcon. | |
23 | * @state: Attach/detach state of this extcon. Do not provide at | |
24 | * register-time. | |
815429b3 CC |
25 | * @nh_all: Notifier for the state change events for all supported |
26 | * external connectors from this extcon. | |
e6cf0465 CC |
27 | * @nh: Notifier for the state change events from this extcon |
28 | * @entry: To support list of extcon devices so that users can | |
29 | * search for extcon devices based on the extcon name. | |
30 | * @lock: | |
31 | * @max_supported: Internal value to store the number of cables. | |
32 | * @extcon_dev_type: Device_type struct to provide attribute_groups | |
33 | * customized for each extcon device. | |
34 | * @cables: Sysfs subdirectories. Each represents one cable. | |
35 | * | |
36 | * In most cases, users only need to provide "User initializing data" of | |
37 | * this struct when registering an extcon. In some exceptional cases, | |
38 | * optional callbacks may be needed. However, the values in "internal data" | |
39 | * are overwritten by register function. | |
40 | */ | |
41 | struct extcon_dev { | |
42 | /* Optional user initializing data */ | |
43 | const char *name; | |
44 | const unsigned int *supported_cable; | |
45 | const u32 *mutually_exclusive; | |
46 | ||
47 | /* Internal data. Please do not set. */ | |
48 | struct device dev; | |
815429b3 | 49 | struct raw_notifier_head nh_all; |
e6cf0465 CC |
50 | struct raw_notifier_head *nh; |
51 | struct list_head entry; | |
52 | int max_supported; | |
53 | spinlock_t lock; /* could be called by irq handler */ | |
54 | u32 state; | |
55 | ||
56 | /* /sys/class/extcon/.../cable.n/... */ | |
57 | struct device_type extcon_dev_type; | |
58 | struct extcon_cable *cables; | |
59 | ||
60 | /* /sys/class/extcon/.../mutually_exclusive/... */ | |
61 | struct attribute_group attr_g_muex; | |
62 | struct attribute **attrs_muex; | |
63 | struct device_attribute *d_attrs_muex; | |
64 | }; | |
65 | ||
66 | #endif /* __LINUX_EXTCON_INTERNAL_H__ */ |