Something went wrong. Try again.
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332/* SPDX-License-Identifier: GPL-2.0-only *//* * External Connector (extcon) framework * - linux/include/linux/extcon.h for extcon consumer device driver. * * Copyright (C) 2015 Samsung Electronics * Author: Chanwoo Choi <cw00.choi@samsung.com> * * 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> */
#ifndef __LINUX_EXTCON_H__#define __LINUX_EXTCON_H__
#include <linux/device.h>
/* * 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 */
/* * Define the unique id of supported external connectors */#define EXTCON_NONE 0
/* USB external connector */#define EXTCON_USB 1#define EXTCON_USB_HOST 2
/* * 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. * * 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. */#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#define EXTCON_CHG_WPT 11 /* Wireless Power Transfer */#define EXTCON_CHG_USB_PD 12 /* USB Power Delivery */
/* 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
/* 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 */#define EXTCON_DISP_DP 44 /* Display Port */#define EXTCON_DISP_HMD 45 /* Head-Mounted Display */#define EXTCON_DISP_CVBS 46 /* Composite Video Broadcast Signal */#define EXTCON_DISP_EDP 47 /* Embedded Display Port */
/* Miscellaneous external connector */#define EXTCON_DOCK 60#define EXTCON_JIG 61#define EXTCON_MECHANICAL 62
#define EXTCON_NUM 63
/* * Define the properties of supported external connectors. * * 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) * - EXTCON_PROP_USB_TYPEC_POLARITY * @type: integer (intval) * @value: 0 (normal) or 1 (flip) * @default: 0 (normal) * - EXTCON_PROP_USB_SS (SuperSpeed) * @type: integer (intval) * @value: 0 (USB/USB2) or 1 (USB3) * @default: 0 (USB/USB2) * */#define EXTCON_PROP_USB_VBUS 0#define EXTCON_PROP_USB_TYPEC_POLARITY 1#define EXTCON_PROP_USB_SS 2
#define EXTCON_PROP_USB_MIN 0#define EXTCON_PROP_USB_MAX 2#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)
/* * 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
/* Properties of EXTCON_TYPE_DISP. */#define EXTCON_PROP_DISP_MIN 150#define EXTCON_PROP_DISP_MAX 151#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) */};
struct extcon_dev;
#if IS_ENABLED(CONFIG_EXTCON)/* * Following APIs get the connected state of each external connector. * The 'id' argument indicates the defined external connector. */int extcon_get_state(struct extcon_dev *edev, unsigned int id);
/* * Following APIs get the property of each external connector. * The 'id' argument indicates the defined external connector * and the 'prop' indicates the extcon property. * * And extcon_get_property_capability() get the capability of the property * for each external connector. They are used to get the capability of the * property of each external connector based on the id and property. */int extcon_get_property(struct extcon_dev *edev, unsigned int id, unsigned int prop, union extcon_property_value *prop_val);int extcon_get_property_capability(struct extcon_dev *edev, unsigned int id, unsigned int prop);
/* * Following APIs register the notifier block in order to detect * the change of both state and property value for each external connector. * * 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. */int extcon_register_notifier(struct extcon_dev *edev, unsigned int id, struct notifier_block *nb);int extcon_unregister_notifier(struct extcon_dev *edev, unsigned int id, struct notifier_block *nb);int devm_extcon_register_notifier(struct device *dev, struct extcon_dev *edev, unsigned int id, struct notifier_block *nb);void devm_extcon_unregister_notifier(struct device *dev, struct extcon_dev *edev, unsigned int id, struct notifier_block *nb);
int extcon_register_notifier_all(struct extcon_dev *edev, struct notifier_block *nb);int extcon_unregister_notifier_all(struct extcon_dev *edev, struct notifier_block *nb);int devm_extcon_register_notifier_all(struct device *dev, struct extcon_dev *edev, struct notifier_block *nb);void devm_extcon_unregister_notifier_all(struct device *dev, struct extcon_dev *edev, struct notifier_block *nb);
/* * Following APIs get the extcon_dev from devicetree or by through extcon name. */struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name);struct extcon_dev *extcon_find_edev_by_node(struct device_node *node);struct extcon_dev *extcon_get_edev_by_phandle(struct device *dev, int index);
/* Following API get the name of extcon device. */const char *extcon_get_edev_name(struct extcon_dev *edev);
#else /* CONFIG_EXTCON */static inline int extcon_get_state(struct extcon_dev *edev, unsigned int id){ return 0;}
static inline int extcon_get_property(struct extcon_dev *edev, unsigned int id, unsigned int prop, union extcon_property_value *prop_val){ return 0;}
static inline int extcon_get_property_capability(struct extcon_dev *edev, unsigned int id, unsigned int prop){ return 0;}
static inline int extcon_register_notifier(struct extcon_dev *edev, unsigned int id, struct notifier_block *nb){ return 0;}
static inline int extcon_unregister_notifier(struct extcon_dev *edev, unsigned int id, struct notifier_block *nb){ return 0;}
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) { }
static inline int extcon_register_notifier_all(struct extcon_dev *edev, struct notifier_block *nb){ return 0;}
static inline int extcon_unregister_notifier_all(struct extcon_dev *edev, struct notifier_block *nb){ return 0;}
static inline int devm_extcon_register_notifier_all(struct device *dev, struct extcon_dev *edev, struct notifier_block *nb){ return 0;}
static inline void devm_extcon_unregister_notifier_all(struct device *dev, struct extcon_dev *edev, struct notifier_block *nb) { }
static inline struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name){ return NULL;}
static inline struct extcon_dev *extcon_find_edev_by_node(struct device_node *node){ return ERR_PTR(-ENODEV);}
static inline struct extcon_dev *extcon_get_edev_by_phandle(struct device *dev, int index){ return ERR_PTR(-ENODEV);}
static inline const char *extcon_get_edev_name(struct extcon_dev *edev){ return NULL;}#endif /* CONFIG_EXTCON */
/* * 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;};#endif /* __LINUX_EXTCON_H__ */