projects / thirdparty / kernel / linux.git / blame
| 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 | ||
| 5 | #include <linux/extcon.h> | |
| 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__ */ |