Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
extcon.h
Go to the documentation of this file.
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/notifier.h>
27 
28 #define SUPPORTED_CABLE_MAX 32
29 #define CABLE_NAME_MAX 30
30 
31 /*
32  * The standard cable name is to help support general notifier
33  * and notifiee device drivers to share the common names.
34  * Please use standard cable names unless your notifier device has
35  * a very unique and abnormal cable or
36  * the cable type is supposed to be used with only one unique
37  * pair of notifier/notifiee devices.
38  *
39  * Please add any other "standard" cables used with extcon dev.
40  *
41  * You may add a dot and number to specify version or specification
42  * of the specific cable if it is required. (e.g., "Fast-charger.18"
43  * and "Fast-charger.10" for 1.8A and 1.0A chargers)
44  * However, the notifiee and notifier should be able to handle such
45  * string and if the notifiee can negotiate the protocol or identify,
46  * you don't need such convention. This convention is helpful when
47  * notifier can distinguish but notifiee cannot.
48  */
52  EXTCON_TA, /* Travel Adaptor */
55  EXTCON_CHARGE_DOWNSTREAM, /* Charging an external device */
70 };
71 extern const char extcon_cable_name[][CABLE_NAME_MAX + 1];
72 
73 struct extcon_cable;
74 
111 struct extcon_dev {
112  /* --- Optional user initializing data --- */
113  const char *name;
114  const char **supported_cable;
116 
117  /* --- Optional callbacks to override class functions --- */
118  ssize_t (*print_name)(struct extcon_dev *edev, char *buf);
119  ssize_t (*print_state)(struct extcon_dev *edev, char *buf);
120 
121  /* --- Internal data. Please do not set. --- */
122  struct device *dev;
125  struct list_head entry;
126  spinlock_t lock; /* could be called by irq handler */
128 
129  /* /sys/class/extcon/.../cable.n/... */
132  /* /sys/class/extcon/.../mutually_exclusive/... */
136 };
137 
147 struct extcon_cable {
148  struct extcon_dev *edev;
150 
154 
155  struct attribute *attrs[3]; /* to be fed to attr_g.attrs */
156 };
157 
171  struct extcon_dev *edev;
172  unsigned long previous_value;
173 };
174 
175 #if IS_ENABLED(CONFIG_EXTCON)
176 
177 /*
178  * Following APIs are for notifiers or configurations.
179  * Notifiers are the external port and connection devices.
180  */
181 extern int extcon_dev_register(struct extcon_dev *edev, struct device *dev);
182 extern void extcon_dev_unregister(struct extcon_dev *edev);
183 extern struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name);
184 
185 /*
186  * get/set/update_state access the 32b encoded state value, which represents
187  * states of all possible cables of the multistate port. For example, if one
188  * calls extcon_set_state(edev, 0x7), it may mean that all the three cables
189  * are attached to the port.
190  */
191 static inline u32 extcon_get_state(struct extcon_dev *edev)
192 {
193  return edev->state;
194 }
195 
196 extern int extcon_set_state(struct extcon_dev *edev, u32 state);
197 extern int extcon_update_state(struct extcon_dev *edev, u32 mask, u32 state);
198 
199 /*
200  * get/set_cable_state access each bit of the 32b encoded state value.
201  * They are used to access the status of each cable based on the cable_name
202  * or cable_index, which is retrieved by extcon_find_cable_index
203  */
204 extern int extcon_find_cable_index(struct extcon_dev *sdev,
205  const char *cable_name);
206 extern int extcon_get_cable_state_(struct extcon_dev *edev, int cable_index);
207 extern int extcon_set_cable_state_(struct extcon_dev *edev, int cable_index,
208  bool cable_state);
209 
210 extern int extcon_get_cable_state(struct extcon_dev *edev,
211  const char *cable_name);
212 extern int extcon_set_cable_state(struct extcon_dev *edev,
213  const char *cable_name, bool cable_state);
214 
215 /*
216  * Following APIs are for notifiees (those who want to be notified)
217  * to register a callback for events from a specific cable of the extcon.
218  * Notifiees are the connected device drivers wanting to get notified by
219  * a specific external port of a connection device.
220  */
222  const char *extcon_name,
223  const char *cable_name,
224  struct notifier_block *nb);
226 
227 /*
228  * Following APIs are to monitor every action of a notifier.
229  * Registrar gets notified for every external port of a connection device.
230  * Probably this could be used to debug an action of notifier; however,
231  * we do not recommend to use this for normal 'notifiee' device drivers who
232  * want to be notified by a specific external port of the notifier.
233  */
234 extern int extcon_register_notifier(struct extcon_dev *edev,
235  struct notifier_block *nb);
236 extern int extcon_unregister_notifier(struct extcon_dev *edev,
237  struct notifier_block *nb);
238 #else /* CONFIG_EXTCON */
239 static inline int extcon_dev_register(struct extcon_dev *edev,
240  struct device *dev)
241 {
242  return 0;
243 }
244 
245 static inline void extcon_dev_unregister(struct extcon_dev *edev) { }
246 
247 static inline u32 extcon_get_state(struct extcon_dev *edev)
248 {
249  return 0;
250 }
251 
252 static inline int extcon_set_state(struct extcon_dev *edev, u32 state)
253 {
254  return 0;
255 }
256 
257 static inline int extcon_update_state(struct extcon_dev *edev, u32 mask,
258  u32 state)
259 {
260  return 0;
261 }
262 
263 static inline int extcon_find_cable_index(struct extcon_dev *edev,
264  const char *cable_name)
265 {
266  return 0;
267 }
268 
269 static inline int extcon_get_cable_state_(struct extcon_dev *edev,
270  int cable_index)
271 {
272  return 0;
273 }
274 
275 static inline int extcon_set_cable_state_(struct extcon_dev *edev,
276  int cable_index, bool cable_state)
277 {
278  return 0;
279 }
280 
281 static inline int extcon_get_cable_state(struct extcon_dev *edev,
282  const char *cable_name)
283 {
284  return 0;
285 }
286 
287 static inline int extcon_set_cable_state(struct extcon_dev *edev,
288  const char *cable_name, int state)
289 {
290  return 0;
291 }
292 
293 static inline struct extcon_dev *extcon_get_extcon_dev(const char *extcon_name)
294 {
295  return NULL;
296 }
297 
298 static inline int extcon_register_notifier(struct extcon_dev *edev,
299  struct notifier_block *nb)
300 {
301  return 0;
302 }
303 
304 static inline int extcon_unregister_notifier(struct extcon_dev *edev,
305  struct notifier_block *nb)
306 {
307  return 0;
308 }
309 
310 static inline int extcon_register_interest(struct extcon_specific_cable_nb *obj,
311  const char *extcon_name,
312  const char *cable_name,
313  struct notifier_block *nb)
314 {
315  return 0;
316 }
317 
319  *obj)
320 {
321  return 0;
322 }
323 #endif /* CONFIG_EXTCON */
324 #endif /* __LINUX_EXTCON_H__ */