mbox series

[v9,0/1] audio jack software injection

Message ID 20210127085639.74954-1-hui.wang@canonical.com (mailing list archive)
Headers show
Series audio jack software injection | expand

Message

Hui Wang Jan. 27, 2021, 8:56 a.m. UTC
the changes in the v9:
 - move the "Phantom" jack comparison into the snd_jack_debugfs_add_inject_node(),
   then the comparison is only executed when SND_JACK_INJECTION_DEBUG is enabled.

the changes in the v8:
 - change "for (i = 0; i < strlen(tname); i++)" to "for (i = 0; tname[i]; i++)"
 - use CONFIG_SND_DEBUG to wrap some debugfs variable and struct members.

the changes in the v7:
 - change the format of the last part in jack-injection.rst
 - add dependence SND_DEBUG in the Kconfig
 - create debugfs_mount_dir/sound and debugfs_mount_dir/sound/cardN only SND_DEBUG is enabled
 - change simple_write_to_buffer(buf, count, ppos, from, count) to
   simple_write_to_buffer(buf, sizeof(buf) - 1, ppos, from, count)
 - rewrite the function parse_mask_bits() according to v6's comment

the changes in the v6:
 - use the sizeof(buf) to replace the digits in the scnprintf
 - squash the document patch into the 0001-xxx.patch.


the changes in the v5:
 - add a Kconfig to enable/disable the jack injection feature
 - replace all kzalloc with local char[] in the debugfs fops
 - replace the chars of !isalnum() to '_' for the jack folder's name
 - squash all .c files patches into one patch
 - add a document to explain jack injection, for easier review, put
   the document in a standalone patch. If needed, will squash this
   patch to the previous one.
 

the changes in the v4:
 - change the sound-core to sound and change the sound_core_debugfs_root
   to sound_debugfs_root in the 0001-xxx.patch
 - change kzalloc/kfree to kvzalloc/kvfree in the debugfs fops for
   0001-xxx.patch and 0003-xxx.patch
 - And if needed, I could squash 4 patches into 1 patch before merging.

the changes in the v3 (for easy to review, divide change into 4 patches):
 - address the comment about the snd_jack_report() and _snd_jack_report(),
   the v2 design is hard to understand and is hard to review, in the v3,
   separate the jack_report to snd_jack_report() and snd_jack_inject_report(),
   hw jack events call snd_jack_report() as before, if a jack contains multi
   jack_kctl and the jack_kctl's sw_inject is enabled, the status and the
   related input-dev's events will not be reproted. The injection events call
   snd_jack_inject_report(). This change is squashed to 0001-xxx.patch,  the
   rest part of 0001-xxx.patch is same as v2.

 - address the comment about folders'name in the 0002-xxx.patch, so far, drop
   the '/', ',', '=' and ' ' from the folders' name.

 - address the comment about adding more debugfs nodes in the 0003-xxx.patch,
   it adds kctl_id, mask_bits, status and type.

 - address the comment about save-n-restore jack's hw status in the
   0004-xxx.patch, adding a hw_status_cache and save the last reported jack
   hw event, once the sw_inject is disabled, will restore all jack_kctl's
   state under the same snd_jack with hw_status_cache.
[snip]


the changes in the V2:
 - using debugfs instead of sysfs
 - using jack_ctrl to create a folder instead of snd_jack, since ASoC drivers
   could create multi jack_ctrls within a snd_jack
 - create a folder for each jack_ctrl instead for all jack_ctrls
[ snip ]

Hui Wang (1):
  alsa: jack: implement software jack injection via debugfs

 Documentation/sound/designs/index.rst         |   1 +
 .../sound/designs/jack-injection.rst          | 166 ++++++++++
 include/sound/core.h                          |   6 +
 include/sound/jack.h                          |   1 +
 sound/core/Kconfig                            |   9 +
 sound/core/init.c                             |  16 +
 sound/core/jack.c                             | 304 +++++++++++++++++-
 sound/core/sound.c                            |  13 +
 8 files changed, 512 insertions(+), 4 deletions(-)
 create mode 100644 Documentation/sound/designs/jack-injection.rst

Comments

Hui Wang Feb. 2, 2021, 8:27 a.m. UTC | #1
Hi Takashi,

When you have time, please take a look at the v9 patch.

Thanks,

Hui.

On 1/27/21 4:56 PM, Hui Wang wrote:
> the changes in the v9:
>   - move the "Phantom" jack comparison into the snd_jack_debugfs_add_inject_node(),
>     then the comparison is only executed when SND_JACK_INJECTION_DEBUG is enabled.
>
> the changes in the v8:
>   - change "for (i = 0; i < strlen(tname); i++)" to "for (i = 0; tname[i]; i++)"
>   - use CONFIG_SND_DEBUG to wrap some debugfs variable and struct members.
>
> the changes in the v7:
>   - change the format of the last part in jack-injection.rst
>   - add dependence SND_DEBUG in the Kconfig
>   - create debugfs_mount_dir/sound and debugfs_mount_dir/sound/cardN only SND_DEBUG is enabled
>   - change simple_write_to_buffer(buf, count, ppos, from, count) to
>     simple_write_to_buffer(buf, sizeof(buf) - 1, ppos, from, count)
>   - rewrite the function parse_mask_bits() according to v6's comment
>
> the changes in the v6:
>   - use the sizeof(buf) to replace the digits in the scnprintf
>   - squash the document patch into the 0001-xxx.patch.
>
>
> the changes in the v5:
>   - add a Kconfig to enable/disable the jack injection feature
>   - replace all kzalloc with local char[] in the debugfs fops
>   - replace the chars of !isalnum() to '_' for the jack folder's name
>   - squash all .c files patches into one patch
>   - add a document to explain jack injection, for easier review, put
>     the document in a standalone patch. If needed, will squash this
>     patch to the previous one.
>   
>
> the changes in the v4:
>   - change the sound-core to sound and change the sound_core_debugfs_root
>     to sound_debugfs_root in the 0001-xxx.patch
>   - change kzalloc/kfree to kvzalloc/kvfree in the debugfs fops for
>     0001-xxx.patch and 0003-xxx.patch
>   - And if needed, I could squash 4 patches into 1 patch before merging.
>
> the changes in the v3 (for easy to review, divide change into 4 patches):
>   - address the comment about the snd_jack_report() and _snd_jack_report(),
>     the v2 design is hard to understand and is hard to review, in the v3,
>     separate the jack_report to snd_jack_report() and snd_jack_inject_report(),
>     hw jack events call snd_jack_report() as before, if a jack contains multi
>     jack_kctl and the jack_kctl's sw_inject is enabled, the status and the
>     related input-dev's events will not be reproted. The injection events call
>     snd_jack_inject_report(). This change is squashed to 0001-xxx.patch,  the
>     rest part of 0001-xxx.patch is same as v2.
>
>   - address the comment about folders'name in the 0002-xxx.patch, so far, drop
>     the '/', ',', '=' and ' ' from the folders' name.
>
>   - address the comment about adding more debugfs nodes in the 0003-xxx.patch,
>     it adds kctl_id, mask_bits, status and type.
>
>   - address the comment about save-n-restore jack's hw status in the
>     0004-xxx.patch, adding a hw_status_cache and save the last reported jack
>     hw event, once the sw_inject is disabled, will restore all jack_kctl's
>     state under the same snd_jack with hw_status_cache.
> [snip]
>
>
> the changes in the V2:
>   - using debugfs instead of sysfs
>   - using jack_ctrl to create a folder instead of snd_jack, since ASoC drivers
>     could create multi jack_ctrls within a snd_jack
>   - create a folder for each jack_ctrl instead for all jack_ctrls
> [ snip ]
>
> Hui Wang (1):
>    alsa: jack: implement software jack injection via debugfs
>
>   Documentation/sound/designs/index.rst         |   1 +
>   .../sound/designs/jack-injection.rst          | 166 ++++++++++
>   include/sound/core.h                          |   6 +
>   include/sound/jack.h                          |   1 +
>   sound/core/Kconfig                            |   9 +
>   sound/core/init.c                             |  16 +
>   sound/core/jack.c                             | 304 +++++++++++++++++-
>   sound/core/sound.c                            |  13 +
>   8 files changed, 512 insertions(+), 4 deletions(-)
>   create mode 100644 Documentation/sound/designs/jack-injection.rst
>