ALSA: pcm: reinvent the stream synchronization ID API
Jaroslav Kysela
maintainerv5 cover ALSA: pcm: reinvent the stream synchronization ID API
Until the commit e11f0f90a626 ("ALSA: pcm: remove SNDRV_PCM_IOCTL1_INFO internal command"), there was a possibility to pass information about the synchronized streams to the user space. The mentioned commit removed blindly the appropriate code with an irrelevant comment.
The revert may be appropriate, but since this API was lost for several years without any complains, it's time to improve it. The hardware parameters may change the used stream clock source (e.g. USB hardware) so move this synchronization ID to hw_params as read-only field.
It seems that pipewire can benefit from this API (disable adaptive resampling for perfectly synchronized PCM streams) now.
Note that the contents of ID is not supposed to be used for direct comparison with a specific byte sequence. The "empty" case is when all bytes are zero (driver does not offer this information) and all other cases must be only used for equal comparison among PCM streams (including different sound cards) if they are using identical hardware clock.
v4->v5:
- extend commit message (clarification for ID use) for first patch
- mark union snd_pcm_sync_id as deprecated
- do not use get_unaligned() - reviewers are confused and the code is removed in the second path (optimization)
v3->v4:
- more code shuffle as suggested by Takashi
- remove unused snd_pcm_empty function in the second patch
- put back snd_pcm_set_sync documentation
v2->v3:
- fix pcm_sync_empty() function (wrong comparison) [thanks Takashi Sakamoto]
- more documentation for snd_pcm_set_sync_per_card (ID composition)
v1->v2:
- remove union usage per Takashi's request
- reduce memory usage
- use standard ID generation scheme
Jaroslav Kysela (2):
ALSA: pcm: reinvent the stream synchronization ID API
ALSA: pcm: optimize and clarify stream sychronization ID API
include/sound/pcm.h | 17 +++++++++++-- include/uapi/sound/asound.h | 9 ++++--- sound/core/pcm_lib.c | 50 +++++++++++++++++++++++++++++-------- sound/core/pcm_native.c | 6 +++++ sound/pci/emu10k1/p16v.c | 17 +++++++++---- 5 files changed, 78 insertions(+), 21 deletions(-)
Signature · 1 line
2.45.2
Jaroslav Kysela
maintainerPATCH v5 1/2 ALSA: pcm: reinvent the stream synchronization ID API
Until the commit e11f0f90a626 ("ALSA: pcm: remove SNDRV_PCM_IOCTL1_INFO internal command"), there was a possibility to pass information about the synchronized streams to the user space. The mentioned commit removed blindly the appropriate code with an irrelevant comment.
The revert may be appropriate, but since this API was lost for several years without any complains, it's time to improve it. The hardware parameters may change the used stream clock source (e.g. USB hardware) so move this synchronization ID to hw_params as read-only field.
It seems that pipewire can benefit from this API (disable adaptive resampling for perfectly synchronized PCM streams) now.
Note that the contents of ID is not supposed to be used for direct comparison with a specific byte sequence. The "empty" case is when all bytes are zero (driver does not offer this information) and all other cases must be only used for equal comparison among PCM streams (including different sound cards) if they are using identical hardware clock.
--- include/sound/pcm.h | 3 ++- include/uapi/sound/asound.h | 9 +++++---- sound/core/pcm_lib.c | 27 +++++++++++++++++++++++---- sound/core/pcm_native.c | 6 ++++++ sound/pci/emu10k1/p16v.c | 7 +++---- 5 files changed, 39 insertions(+), 13 deletions(-)
include/sound/pcm.h +2 -1
@@ -93,6 +93,7 @@ struct snd_pcm_ops {#define SNDRV_PCM_IOCTL1_CHANNEL_INFO 2/* 3 is absent slot. */ #define SNDRV_PCM_IOCTL1_FIFO_SIZE 4 +#define SNDRV_PCM_IOCTL1_SYNC_ID 5#define SNDRV_PCM_TRIGGER_STOP 0#define SNDRV_PCM_TRIGGER_START 1
@@ -401,7 +402,7 @@ struct snd_pcm_runtime {snd_pcm_uframes_t silence_start;/* starting pointer to silence area */ snd_pcm_uframes_t silence_filled;/* already filled part of silence area */ -union snd_pcm_sync_id sync;/* hardware synchronization ID */ +unsigned char sync[16 ];/* hardware synchronization ID */ /* -- mmap -- */ struct snd_pcm_mmap_status *status;
include/uapi/sound/asound.h +5 -4
@@ -142,7 +142,7 @@ struct snd_hwdep_dsp_image {* * *****************************************************************************/ -#define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 17) +#define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 18)typedef unsigned long snd_pcm_uframes_t ;typedef signed long snd_pcm_sframes_t ;
@@ -334,7 +334,7 @@ union snd_pcm_sync_id {unsigned char id[16 ];unsigned short id16[8 ];unsigned int id32[4 ]; -}; +} __attribute__((deprecated));struct snd_pcm_info {unsigned int device;/* RO/WR (control): device number */
@@ -348,7 +348,7 @@ struct snd_pcm_info {int dev_subclass;/* SNDRV_PCM_SUBCLASS_* */ unsigned int subdevices_count;unsigned int subdevices_avail; -union snd_pcm_sync_id sync;/* hardware synchronization ID */ +unsigned char pad1[16 ];/* was: hardware synchronization ID */ unsigned char reserved[64 ];/* reserved for future... */ };
@@ -420,7 +420,8 @@ struct snd_pcm_hw_params {unsigned int rate_num;/* R: rate numerator */ unsigned int rate_den;/* R: rate denominator */ snd_pcm_uframes_t fifo_size;/* R: chip FIFO size in frames */ -unsigned char reserved[64 ];/* reserved for future */ +unsigned char sync[16 ];/* R: synchronization ID (perfect sync - one clock source) */ +unsigned char reserved[48 ];/* reserved for future */ };enum {
sound/core/pcm_lib.c +23 -4
@@ -525,10 +525,8 @@ void snd_pcm_set_sync(struct snd_pcm_substream *substream) {struct snd_pcm_runtime *runtime = substream->runtime; - runtime->sync.id32[0 ] = substream->pcm->card->number; - runtime->sync.id32[1 ] =-1 ; - runtime->sync.id32[2 ] =-1 ; - runtime->sync.id32[3 ] =-1 ; + *(__u32 *)runtime->sync =cpu_to_le32 (substream->pcm->card->number); +memset (runtime->sync +4 ,0xff ,sizeof (runtime->sync) -4 ); }EXPORT_SYMBOL (snd_pcm_set_sync);
@@ -1810,6 +1808,25 @@ static int snd_pcm_lib_ioctl_fifo_size(struct snd_pcm_substream *substream,return 0 ; } +/** +* is sync id (clock id) empty? +*/ +static inline bool pcm_sync_empty (const unsigned char *sync) +{ +return sync[0 ] ==0 && sync[1 ] ==0 && sync[2 ] ==0 && sync[3 ] ==0 && + sync[4 ] ==0 && sync[5 ] ==0 && sync[6 ] ==0 && sync[7 ] ==0 ; +} + +static int snd_pcm_lib_ioctl_sync_id (struct snd_pcm_substream *substream, +void *arg) +{ +struct snd_pcm_hw_params *params = arg; + +if (pcm_sync_empty (params->sync)) +memcpy (params->sync, substream->runtime->sync,sizeof (params->sync)); +return 0 ; +} +/** * snd_pcm_lib_ioctl - a generic PCM ioctl callback * @substream: the pcm substream instance
@@ -1831,6 +1848,8 @@ int snd_pcm_lib_ioctl(struct snd_pcm_substream *substream,return snd_pcm_lib_ioctl_channel_info (substream, arg);case SNDRV_PCM_IOCTL1_FIFO_SIZE :return snd_pcm_lib_ioctl_fifo_size (substream, arg); +case SNDRV_PCM_IOCTL1_SYNC_ID : +return snd_pcm_lib_ioctl_sync_id (substream, arg); }return -ENXIO ; }
sound/core/pcm_native.c +6 -0
@@ -533,6 +533,12 @@ static int fixup_unreferenced_params(struct snd_pcm_substream *substream, SNDRV_PCM_INFO_MMAP_VALID); } + err =snd_pcm_ops_ioctl (substream, +SNDRV_PCM_IOCTL1_SYNC_ID , + params); +if (err <0 ) +return err; +return 0 ; }
sound/pci/emu10k1/p16v.c +3 -4
@@ -174,10 +174,9 @@ static int snd_p16v_pcm_open_playback_channel(struct snd_pcm_substream *substreaif (err <0 )return err; - runtime->sync.id32[0 ] = substream->pcm->card->number; - runtime->sync.id32[1 ] ='P' ; - runtime->sync.id32[2 ] =16 ; - runtime->sync.id32[3 ] ='V' ; + *(__u32 *)runtime->sync =cpu_to_le32 (substream->pcm->card->number); +memset (runtime->sync +4 ,0 ,sizeof (runtime->sync) -4 ); +strncpy (runtime->sync +4 ,"P16V" ,4 );return 0 ; }
Signature · 1 line
2.45.2
Quoted 23 lines · Jaroslav Kysela
Until the commit
e11f0f90a626("ALSA: pcm: removeSNDRV_PCM_IOCTL1_INFOinternal command"), there was a possibility to pass information about the synchronized streams to the user space. The mentioned commit removed blindly the appropriate code with an irrelevant comment.The revert may be appropriate, but since this API was lost for several years without any complains, it's time to improve it. The hardware parameters may change the used stream clock source (e.g. USB hardware) so move this synchronization ID to
hw_paramsas read-only field.It seems that pipewire can benefit from this API (disable adaptive resampling for perfectly synchronized PCM streams) now.
Note that the contents of ID is not supposed to be used for direct comparison with a specific byte sequence. The "empty" case is when all bytes are zero (driver does not offer this information) and all other cases must be only used for equal comparison among PCM streams (including different sound cards) if they are using identical hardware clock.
Cc Takashi Sakamoto <[email protected]>Signed-off-by Jaroslav Kysela <[email protected]>---
(...)
include/uapi/sound/asound.h struct snd_pcm_hw_params { · line 423
Quoted 7 lines
include/uapi/sound/asound.h +1
-1@@ -420,7 +420,8 @@ struct snd_pcm_hw_params {unsigned int rate_num;/* R: rate numerator */ unsigned int rate_den;/* R: rate denominator */ snd_pcm_uframes_t fifo_size;/* R: chip FIFO size in frames */ -unsigned char reserved[64 ];/* reserved for future */ +unsigned char sync[16 ];/* R: synchronization ID (perfect sync - one clock source) */
If it is introduced as new API, can't this be done better? Maybe like:
struct sync {
char cardnum[4];
char id[12];
};
or maybe just:
struct sync {
u32 cardnum;
char id[12];
};or something like that? It is bit hard to follow in next patch all this params->sync + 4 and memset/strncpy. And having named fields would help.
Thanks,
Amadeusz
Jaroslav Kysela
maintainerQuoted 45 lines · Amadeusz Sławiński
Quoted 23 lines · Jaroslav Kysela
Until the commit
e11f0f90a626("ALSA: pcm: removeSNDRV_PCM_IOCTL1_INFOinternal command"), there was a possibility to pass information about the synchronized streams to the user space. The mentioned commit removed blindly the appropriate code with an irrelevant comment.The revert may be appropriate, but since this API was lost for several years without any complains, it's time to improve it. The hardware parameters may change the used stream clock source (e.g. USB hardware) so move this synchronization ID to
hw_paramsas read-only field.It seems that pipewire can benefit from this API (disable adaptive resampling for perfectly synchronized PCM streams) now.
Note that the contents of ID is not supposed to be used for direct comparison with a specific byte sequence. The "empty" case is when all bytes are zero (driver does not offer this information) and all other cases must be only used for equal comparison among PCM streams (including different sound cards) if they are using identical hardware clock.
Cc Takashi Sakamoto <[email protected]>Signed-off-by Jaroslav Kysela <[email protected]>---
(...)
include/uapi/sound/asound.h struct snd_pcm_hw_params { · line 423
Quoted 7 lines
include/uapi/sound/asound.h +1
-1@@ -420,7 +420,8 @@ struct snd_pcm_hw_params {unsigned int rate_num;/* R: rate numerator */ unsigned int rate_den;/* R: rate denominator */ snd_pcm_uframes_t fifo_size;/* R: chip FIFO size in frames */ -unsigned char reserved[64 ];/* reserved for future */ +unsigned char sync[16 ];/* R: synchronization ID (perfect sync - one clock source) */ If it is introduced as new API, can't this be done better? Maybe like:
struct sync { char cardnum[4]; char id[12]; }; or maybe just: struct sync { u32 cardnum; char id[12]; };
Quoted 2 lines
or something like that? It is bit hard to follow in next patch all this
params->sync+ 4 and memset/strncpy. And having named fields would help.0
The ID may be not related to one sound card. Multiple cards can share one clock source. It's internal kernel ID generation scheme which may be changed later when there's another demand in future. The applications should handle this as 16-byte blob which is used only for equal comparison among multiple PCM streams.
Jaroslav
Signature · 2 lines
Jaroslav Kysela <[email protected]> Linux Sound Maintainer; ALSA Project; Red Hat, Inc.
Quoted 49 lines · Jaroslav Kysela
Quoted 39 lines · Amadeusz Sławiński
Quoted 23 lines · Jaroslav Kysela
Until the commit
e11f0f90a626("ALSA: pcm: removeSNDRV_PCM_IOCTL1_INFOinternal command"), there was a possibility to pass information about the synchronized streams to the user space. The mentioned commit removed blindly the appropriate code with an irrelevant comment.The revert may be appropriate, but since this API was lost for several years without any complains, it's time to improve it. The hardware parameters may change the used stream clock source (e.g. USB hardware) so move this synchronization ID to
hw_paramsas read-only field.It seems that pipewire can benefit from this API (disable adaptive resampling for perfectly synchronized PCM streams) now.
Note that the contents of ID is not supposed to be used for direct comparison with a specific byte sequence. The "empty" case is when all bytes are zero (driver does not offer this information) and all other cases must be only used for equal comparison among PCM streams (including different sound cards) if they are using identical hardware clock.
Cc Takashi Sakamoto <[email protected]>Signed-off-by Jaroslav Kysela <[email protected]>---
(...)
Quoted 7 lines
(quoted diff) +0
-0@@ -420,7 +420,8 @@ struct snd_pcm_hw_params {unsigned int rate_num; /* R: rate numerator */ unsigned int rate_den; /* R: rate denominator */
snd_pcm_uframes_tfifo_size; /* R: chip FIFO size in frames */ - unsigned char reserved[64]; /* reserved for future */ + unsigned char sync[16]; /* R: synchronization ID (perfect sync - one clock source) */If it is introduced as new API, can't this be done better? Maybe like:
struct sync {
char cardnum[4];
char id[12];Quoted 8 lines
};
or maybe just:
struct sync {
u32 cardnum;
char id[12];
};
or something like that? It is bit hard to follow in next patch all thisparams->sync+ 4 and memset/strncpy. And having named fields would help.0
Quoted 1 line
The ID may be not related to one sound card. Multiple cards can share one clock source. It's internal kernel ID generation scheme which may be changed later when there's another demand in future. The applications should handle this as 16-byte blob which is used only for equal comparison among multiple PCM streams.
Ah, yes rereading it few more times it makes sense.
Thanks,
Amadeusz
Jaroslav Kysela
maintainerPATCH v5 2/2 ALSA: pcm: optimize and clarify stream sychronization ID API
In reply to Jaroslav KyselaOptimize the memory usage in struct snd_pcm_runtime - use boolean value for the standard sync ID scheme.
Introduce snd_pcm_set_sync_per_card function to build synchronization IDs.
--- include/sound/pcm.h | 16 +++++++++++-- sound/core/pcm_lib.c | 51 ++++++++++++++++++++++++---------------- sound/pci/emu10k1/p16v.c | 16 +++++++++---- 3 files changed, 57 insertions(+), 26 deletions(-)
include/sound/pcm.h +14 -2
@@ -402,7 +402,7 @@ struct snd_pcm_runtime {snd_pcm_uframes_t silence_start;/* starting pointer to silence area */ snd_pcm_uframes_t silence_filled;/* already filled part of silence area */ -unsigned char sync[16 ];/* hardware synchronization ID */ +bool sync_flag;/* hardware synchronization - standard per card ID */ /* -- mmap -- */ struct snd_pcm_mmap_status *status;
@@ -1156,7 +1156,19 @@ int snd_pcm_format_set_silence(snd_pcm_format_t format, void *buf, unsigned intvoid snd_pcm_set_ops (struct snd_pcm * pcm,int direction,const struct snd_pcm_ops *ops); -void snd_pcm_set_sync (struct snd_pcm_substream *substream); +void snd_pcm_set_sync_per_card (struct snd_pcm_substream *substream,struct snd_pcm_hw_params *params, +const unsigned char *id,unsigned int len); +/** +* snd_pcm_set_sync - set the PCM sync id +* snd_pcm_set_sync_per_card - set the PCM sync id with card number +* @substream: the pcm substream +* +* Use the default PCM sync identifier for the specific card. +*/ +static inline void snd_pcm_set_sync (struct snd_pcm_substream *substream) +{ + substream->runtime->sync_flag = true; +}int snd_pcm_lib_ioctl (struct snd_pcm_substream *substream,unsigned int cmd,void *arg);void snd_pcm_period_elapsed_under_stream_lock (struct snd_pcm_substream *substream);
sound/core/pcm_lib.c +31 -20
72 lines not on this page · raw message
sound/pci/emu10k1/p16v.c +12 -4
@@ -174,10 +174,6 @@ static int snd_p16v_pcm_open_playback_channel(struct snd_pcm_substream *substreaif (err <0 )return err; - *(__u32 *)runtime->sync =cpu_to_le32 (substream->pcm->card->number); -memset (runtime->sync +4 ,0 ,sizeof (runtime->sync) -4 ); -strncpy (runtime->sync +4 ,"P16V" ,4 ); -return 0 ; }
@@ -225,6 +221,17 @@ static int snd_p16v_pcm_open_capture(struct snd_pcm_substream *substream)return snd_p16v_pcm_open_capture_channel (substream,0 ); } +static int snd_p16v_pcm_ioctl_playback (struct snd_pcm_substream *substream, +unsigned int cmd,void *arg) +{ +if (cmd ==SNDRV_PCM_IOCTL1_SYNC_ID ) { +static const unsigned char id[4 ] = {'P' ,'1' ,'6' ,'V' }; +snd_pcm_set_sync_per_card (substream, arg, id,4 ); +return 0 ; + } +return snd_pcm_lib_ioctl (substream, cmd, arg); +} +/* prepare playback callback */ static int snd_p16v_pcm_prepare_playback (struct snd_pcm_substream *substream) {
@@ -530,6 +537,7 @@ snd_p16v_pcm_pointer_capture(struct snd_pcm_substream *substream)static const struct snd_pcm_ops snd_p16v_playback_front_ops = { .open = snd_p16v_pcm_open_playback_front, .close = snd_p16v_pcm_close_playback, + .ioctl = snd_p16v_pcm_ioctl_playback, .prepare = snd_p16v_pcm_prepare_playback, .trigger = snd_p16v_pcm_trigger_playback, .pointer = snd_p16v_pcm_pointer_playback,
Signature · 1 line
2.45.2
Re: [PATCH v5 2/2] ALSA: pcm: optimize and clarify stream sychronization ID API
Quoted 8 lines · Jaroslav Kysela
Optimize the memory usage in struct
snd_pcm_runtime- use boolean value for the standard sync ID scheme.Introduce
snd_pcm_set_sync_per_cardfunction to build synchronization IDs.Signed-off-by Jaroslav Kysela <[email protected]>---
(...)
include/sound/pcm.h int snd_pcm_format_set_silence(snd_pcm_format_t format, void *buf, unsigned int · line 1163
Quoted 8 lines
void snd_pcm_set_ops(struct
snd_pcm* pcm, int direction,
const structsnd_pcm_ops*ops);include/sound/pcm.h +5
-1-void snd_pcm_set_sync (struct snd_pcm_substream *substream); +void snd_pcm_set_sync_per_card (struct snd_pcm_substream *substream,struct snd_pcm_hw_params *params, +const unsigned char *id,unsigned int len); +/** +* snd_pcm_set_sync - set the PCM sync id +* snd_pcm_set_sync_per_card - set the PCM sync id with card number
Above doc line seems like mistake in this place? This function is documented below ;)
Quoted 16 lines
+ * @substream: the pcm substream
+ *
+ * Use the default PCM sync identifier for the specific card.
+ */include/sound/pcm.h +4
-0+static inline void snd_pcm_set_sync (struct snd_pcm_substream *substream) +{ + substream->runtime->sync_flag = true; +}int snd_pcm_lib_ioctl (struct snd_pcm_substream *substream,unsigned int cmd,void *arg);void snd_pcm_period_elapsed_under_stream_lock (struct snd_pcm_substream *substream);sound/core/pcm_lib.c +0
-0
sound/core/pcm_lib.c void snd_pcm_set_ops(struct snd_pcm *pcm, int direction, · line 519
Quoted 5 lines
sound/core/pcm_lib.c +1
-1@@ -516,19 +516,37 @@ void snd_pcm_set_ops(struct snd_pcm *pcm, int direction,EXPORT_SYMBOL (snd_pcm_set_ops);/** -* snd_pcm_set_sync - set the PCM sync id +* snd_pcm_set_sync_per_card - set the PCM sync id with card number
Here ^
Quoted 22 lines
sound/core/pcm_lib.c +18
-1* @substream: the pcm substream +* @params: modified hardware parameters +* @id: identifier (max 12 bytes) +* @len: identifier length (max 12 bytes) * -* Sets the PCM sync identifier for the card. +* Sets the PCM sync identifier for the card with zero padding. +* +* User space or any user should use this 16-byte identifier for a comparison only +* to check if two IDs are similar or different. Special case is the identifier +* containing only zeros. Interpretation for this combination is - empty (not set). +* The contents of the identifier should not be interpreted in any other way. +* +* The synchronization ID must be unique per clock source (usually one sound card, +* but multiple soundcard may use one PCM word clock source which means that they +* are fully synchronized). +* +* This routine composes this ID using card number in first four bytes and +* 12-byte additional ID. When other ID composition is used (e.g. for multiple +* sound cards), make sure that the composition does not clash with this +* composition scheme. */
Jaroslav Kysela
maintainerRe: [PATCH v5 2/2] ALSA: pcm: optimize and clarify stream sychronization ID API
Quoted 8 lines · Amadeusz Sławiński
include/sound/pcm.h int snd_pcm_format_set_silence(snd_pcm_format_t format, void *buf, unsigned int · line 1163
Quoted 5 lines
include/sound/pcm.h +5
-0+void snd_pcm_set_sync_per_card (struct snd_pcm_substream *substream,struct snd_pcm_hw_params *params, +const unsigned char *id,unsigned int len); +/** +* snd_pcm_set_sync - set the PCM sync id +* snd_pcm_set_sync_per_card - set the PCM sync id with card number Above doc line seems like mistake in this place? This function is documented below ;)
Yes, the second line in this comment should be removed. I'll wait for other feedback and then I will post v6 with this fix tomorrow.
Thanks for your review,
Jaroslav
Signature · 2 lines
Jaroslav Kysela <[email protected]> Linux Sound Maintainer; ALSA Project; Red Hat, Inc.