1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 #ifndef __SOUND_JACK_H 3 #define __SOUND_JACK_H 4 5 /* 6 * Jack abstraction layer 7 * 8 * Copyright 2008 Wolfson Microelectronics plc 9 */ 10 11 #include <sound/core.h> 12 13 struct input_dev; 14 15 /** 16 * enum snd_jack_types - Jack types which can be reported 17 * @SND_JACK_HEADPHONE: Headphone 18 * @SND_JACK_MICROPHONE: Microphone 19 * @SND_JACK_HEADSET: Headset 20 * @SND_JACK_LINEOUT: Line out 21 * @SND_JACK_MECHANICAL: Mechanical switch 22 * @SND_JACK_VIDEOOUT: Video out 23 * @SND_JACK_AVOUT: AV (Audio Video) out 24 * @SND_JACK_LINEIN: Line in 25 * @SND_JACK_BTN_0: Button 0 26 * @SND_JACK_BTN_1: Button 1 27 * @SND_JACK_BTN_2: Button 2 28 * @SND_JACK_BTN_3: Button 3 29 * @SND_JACK_BTN_4: Button 4 30 * @SND_JACK_BTN_5: Button 5 31 * 32 * These values are used as a bitmask. 33 * 34 * Note that this must be kept in sync with the lookup table in 35 * sound/core/jack.c. 36 */ 37 enum snd_jack_types { 38 SND_JACK_HEADPHONE = 0x0001, 39 SND_JACK_MICROPHONE = 0x0002, 40 SND_JACK_HEADSET = SND_JACK_HEADPHONE | SND_JACK_MICROPHONE, 41 SND_JACK_LINEOUT = 0x0004, 42 SND_JACK_MECHANICAL = 0x0008, /* If detected separately */ 43 SND_JACK_VIDEOOUT = 0x0010, 44 SND_JACK_AVOUT = SND_JACK_LINEOUT | SND_JACK_VIDEOOUT, 45 SND_JACK_LINEIN = 0x0020, 46 47 /* Kept separate from switches to facilitate implementation */ 48 SND_JACK_BTN_0 = 0x4000, 49 SND_JACK_BTN_1 = 0x2000, 50 SND_JACK_BTN_2 = 0x1000, 51 SND_JACK_BTN_3 = 0x0800, 52 SND_JACK_BTN_4 = 0x0400, 53 SND_JACK_BTN_5 = 0x0200, 54 }; 55 56 /* Keep in sync with definitions above */ 57 #define SND_JACK_SWITCH_TYPES 6 58 59 struct snd_jack { 60 struct list_head kctl_list; 61 struct snd_card *card; 62 const char *id; 63 #ifdef CONFIG_SND_JACK_INPUT_DEV 64 struct input_dev *input_dev; 65 int registered; 66 int type; 67 char name[100]; 68 unsigned int key[6]; /* Keep in sync with definitions above */ 69 #endif /* CONFIG_SND_JACK_INPUT_DEV */ 70 void *private_data; 71 void (*private_free)(struct snd_jack *); 72 }; 73 74 #ifdef CONFIG_SND_JACK 75 76 int snd_jack_new(struct snd_card *card, const char *id, int type, 77 struct snd_jack **jack, bool initial_kctl, bool phantom_jack); 78 int snd_jack_add_new_kctl(struct snd_jack *jack, const char * name, int mask); 79 #ifdef CONFIG_SND_JACK_INPUT_DEV 80 void snd_jack_set_parent(struct snd_jack *jack, struct device *parent); 81 int snd_jack_set_key(struct snd_jack *jack, enum snd_jack_types type, 82 int keytype); 83 #endif 84 void snd_jack_report(struct snd_jack *jack, int status); 85 86 #else 87 static inline int snd_jack_new(struct snd_card *card, const char *id, int type, 88 struct snd_jack **jack, bool initial_kctl, bool phantom_jack) 89 { 90 return 0; 91 } 92 93 static inline int snd_jack_add_new_kctl(struct snd_jack *jack, const char * name, int mask) 94 { 95 return 0; 96 } 97 98 static inline void snd_jack_report(struct snd_jack *jack, int status) 99 { 100 } 101 102 #endif 103 104 #if !defined(CONFIG_SND_JACK) || !defined(CONFIG_SND_JACK_INPUT_DEV) 105 static inline void snd_jack_set_parent(struct snd_jack *jack, 106 struct device *parent) 107 { 108 } 109 110 static inline int snd_jack_set_key(struct snd_jack *jack, 111 enum snd_jack_types type, 112 int keytype) 113 { 114 return 0; 115 } 116 #endif /* !CONFIG_SND_JACK || !CONFIG_SND_JACK_INPUT_DEV */ 117 118 #endif 119