Based on kernel version 6.8
. Page generated on 2024-03-11 21:26 EST
.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 | ============================ ALSA Jack Software Injection ============================ Simple Introduction On Jack Injection ===================================== Here jack injection means users could inject plugin or plugout events to the audio jacks through debugfs interface, it is helpful to validate ALSA userspace changes. For example, we change the audio profile switching code in the pulseaudio, and we want to verify if the change works as expected and if the change introduce the regression, in this case, we could inject plugin or plugout events to an audio jack or to some audio jacks, we don't need to physically access the machine and plug/unplug physical devices to the audio jack. In this design, an audio jack doesn't equal to a physical audio jack. Sometimes a physical audio jack contains multi functions, and the ALSA driver creates multi ``jack_kctl`` for a ``snd_jack``, here the ``snd_jack`` represents a physical audio jack and the ``jack_kctl`` represents a function, for example a physical jack has two functions: headphone and mic_in, the ALSA ASoC driver will build 2 ``jack_kctl`` for this jack. The jack injection is implemented based on the ``jack_kctl`` instead of ``snd_jack``. To inject events to audio jacks, we need to enable the jack injection via ``sw_inject_enable`` first, once it is enabled, this jack will not change the state by hardware events anymore, we could inject plugin or plugout events via ``jackin_inject`` and check the jack state via ``status``, after we finish our test, we need to disable the jack injection via ``sw_inject_enable`` too, once it is disabled, the jack state will be restored according to the last reported hardware events and will change by future hardware events. The Layout of Jack Injection Interface ====================================== If users enable the SND_JACK_INJECTION_DEBUG in the kernel, the audio jack injection interface will be created as below: :: $debugfs_mount_dir/sound |-- card0 |-- |-- HDMI_DP_pcm_10_Jack |-- |-- |-- jackin_inject |-- |-- |-- kctl_id |-- |-- |-- mask_bits |-- |-- |-- status |-- |-- |-- sw_inject_enable |-- |-- |-- type ... |-- |-- HDMI_DP_pcm_9_Jack |-- |-- jackin_inject |-- |-- kctl_id |-- |-- mask_bits |-- |-- status |-- |-- sw_inject_enable |-- |-- type |-- card1 |-- HDMI_DP_pcm_5_Jack |-- |-- jackin_inject |-- |-- kctl_id |-- |-- mask_bits |-- |-- status |-- |-- sw_inject_enable |-- |-- type ... |-- Headphone_Jack |-- |-- jackin_inject |-- |-- kctl_id |-- |-- mask_bits |-- |-- status |-- |-- sw_inject_enable |-- |-- type |-- Headset_Mic_Jack |-- jackin_inject |-- kctl_id |-- mask_bits |-- status |-- sw_inject_enable |-- type The Explanation Of The Nodes ====================================== kctl_id read-only, get jack_kctl->kctl's id :: sound/card1/Headphone_Jack# cat kctl_id Headphone Jack mask_bits read-only, get jack_kctl's supported events mask_bits :: sound/card1/Headphone_Jack# cat mask_bits 0x0001 HEADPHONE(0x0001) status read-only, get jack_kctl's current status - headphone unplugged: :: sound/card1/Headphone_Jack# cat status Unplugged - headphone plugged: :: sound/card1/Headphone_Jack# cat status Plugged type read-only, get snd_jack's supported events from type (all supported events on the physical audio jack) :: sound/card1/Headphone_Jack# cat type 0x7803 HEADPHONE(0x0001) MICROPHONE(0x0002) BTN_3(0x0800) BTN_2(0x1000) BTN_1(0x2000) BTN_0(0x4000) sw_inject_enable read-write, enable or disable injection - injection disabled: :: sound/card1/Headphone_Jack# cat sw_inject_enable Jack: Headphone Jack Inject Enabled: 0 - injection enabled: :: sound/card1/Headphone_Jack# cat sw_inject_enable Jack: Headphone Jack Inject Enabled: 1 - to enable jack injection: :: sound/card1/Headphone_Jack# echo 1 > sw_inject_enable - to disable jack injection: :: sound/card1/Headphone_Jack# echo 0 > sw_inject_enable jackin_inject write-only, inject plugin or plugout - to inject plugin: :: sound/card1/Headphone_Jack# echo 1 > jackin_inject - to inject plugout: :: sound/card1/Headphone_Jack# echo 0 > jackin_inject |