ALSA子系统(二)------PCM (digital audio) plugins

你好!这里是风筝的博客,

欢迎和我一起交流。


PCM插件(plugins)扩展了PCM设备的功能。插件负责各种采样转换,通道之间的采样复制,命名设备、写入文件、为多个输入/输出连接声卡/设备(不同步采样)、使用多通道声卡/设备等工作。

Slave definition

Slave 插件可以使用字符串直接指定从属插件,也可以在复合配置节点内输入定义。还可以指定一些限制(例如静态速率或通道数)。

pcm_slave.NAME {
     
    pcm STR     # PCM name
    # or
    pcm {
      }     # PCM definition
    format STR  # Format or "unchanged"
    channels INT    # Count of channels or "unchanged" string
    rate INT    # Rate in Hz or "unchanged" string
    period_time INT # Period time in us or "unchanged" string
    buffer_time INT # Buffer time in us or "unchanged" string
}

例如:

pcm_slave.slave_rate44100Hz {
     
    pcm "hw:0,0"
    rate 44100
}
pcm.rate44100Hz {
     
    type plug
    slave slave_rate44100Hz
}

等效配置如下:

pcm.rate44100Hz {
     
    type plug
    slave {
     
        pcm "hw:0,0"
        rate 44100
    }
}

Plugin: hw

该插件直接与ALSA内核驱动程序通信。这是未经任何转换的原始通信。模仿mmap访问可以被启用,但是在这种情况下,预计会有更糟的延迟。
nonblock选项指定设备是否以非阻塞方式打开。请注意,此选项不会更改读/写访问的阻止行为。这仅影响打开设备时的阻塞行为。如果您想保持与旧版ALSA的兼容性,请关闭此选项。

pcm.name {
     
    type hw         # Kernel PCM
    card INT/STR        # Card name (string) or number (integer)
    [device INT]        # Device number (default 0)
    [subdevice INT]     # Subdevice number (default -1: first available)
    [sync_ptr_ioctl BOOL]   # Use SYNC_PTR ioctl rather than the direct mmap access for control structures
    [nonblock BOOL]     # Force non-blocking open mode
    [format STR]        # Restrict only to the given format
    [channels INT]      # Restrict only to the given channels
    [rate INT]      # Restrict only to the given rate
    [chmap MAP]     # Override channel maps; MAP is a string array
}

Function reference

  • snd_pcm_hw_open()
  • _snd_pcm_hw_open()

Plugin: mmap_emul

pcm.name {
     
    type mmap_emul
    slave PCM
}

Plugin: shm

该插件通过共享内存与服务器通信。这是未经任何转换的原始通信,但是可以预期会出现较差的性能。

pcm.name {
     
        type shm                # Shared memory PCM
    server STR      # Server name
    pcm STR         # PCM name
}

Function reference

  • snd_pcm_shm_open()
  • _snd_pcm_shm_open()

Plugin: Null

此插件丢弃PCM流的内容或创建零采样填充的流。
注意:此实现使用设备/ dev / null(播放,必须可写)和/ dev / full(录音,必须可读)。

pcm.name {
     
        type null               # Null PCM
    [chmap MAP]     # Provide channel maps; MAP is a string array
}

Function reference

  • snd_pcm_null_open()
  • _snd_pcm_null_open()

Plugin: copy

该插件将样本从主PCM复制到给定的从PCM。两者的通道数,格式和速率必须匹配。

pcm.name {
     
    type copy       # Copy PCM
    slave STR       # Slave name
    # or
    slave {
              # Slave definition
        pcm STR     # Slave PCM name
        # or
        pcm {
      }     # Slave PCM definition
    }
}

Function reference

  • snd_pcm_copy_open()
  • _snd_pcm_copy_open()

Plugin: linear

此插件将线性采样从主线性PCM转换为给定的从PCM。两者的通道数,格式和速率必须匹配。

pcm.name {
     
        type linear             # Linear conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                format STR      # Slave format
        }
}

Function reference

  • snd_pcm_linear_open()
  • _snd_pcm_linear_open()

Plugin: linear<->float

该插件从主PCM将线性采样转换为浮点采样和将浮点采样转换为线性采样,给定的从动PCM。两者的通道数,格式和速率必须匹配。

pcm.name {
     
        type lfloat             # Linear<->Float conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                format STR      # Slave format
        }
}

Function reference

  • snd_pcm_lfloat_open()
  • _snd_pcm_lfloat_open()

Plugin: Mu-Law

此插件可从主PCM将Mu-Law样本转换为线性或将线性转换为Mu-Law样本给定的从PCM。两者的通道数,格式和速率必须匹配。

pcm.name {
     
        type mulaw              # Mu-Law conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                format STR      # Slave format
        }
}

Function reference

  • snd_pcm_mulaw_open()
  • _snd_pcm_mulaw_open()

Plugin: A-Law

此插件可从主PCM将A-Law样本转换为线性或将线性转换为A-Law样本给定的从PCM。两者的通道数,格式和速率必须匹配。

pcm.name {
     
        type alaw               # A-Law conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                format STR      # Slave format
        }
}

Function reference

  • snd_pcm_alaw_open()
  • _snd_pcm_alaw_open()

Plugin: Ima-ADPCM

此插件可从主PCM将Ima-ADPCM样本转换为线性或将线性转换为Ima-ADPCM样本给定的从PCM。两者的通道数,格式和速率必须匹配。

pcm.name {
     
        type adpcm              # Ima-ADPCM conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                format STR      # Slave format
        }
}

Function reference

  • snd_pcm_adpcm_open()
  • _snd_pcm_adpcm_open()

Plugin: Route & Volume

该插件转换通道并在转换过程中设置音量,两者的格式和速率必须匹配。
SCHANNEL可以用通道名称代替编号(例如FL,LFE),如果这样,将从从设备选择匹配的通道映射。

pcm.name {
     
        type route              # Route & Volume conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                [format STR]    # Slave format
                [channels INT]  # Slave channels
        }
        ttable {
                     # Transfer table (bi-dimensional compound of cchannels * schannels numbers)
                CCHANNEL {
     
                        SCHANNEL REAL   # route value (0.0 - 1.0)
                }
        }
        [chmap MAP]             # Override channel maps; MAP is a string array
}

Function reference

  • snd_pcm_route_open()
  • _snd_pcm_route_open()

Plugin: Rate

该插件转换速率。输入和输出格式必须是线性的。

pcm.name {
     
    type rate               # Rate PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                rate INT        # Slave rate
                [format STR]    # Slave format
        }
    converter STR           # optional
    # or
    converter [ STR1 STR2 ... ] # optional
                # Converter type, default is taken from
                # defaults.pcm.rate_converter
    # or
    converter {
          # optional
        name STR    # Convertor type
        xxx yyy     # optional convertor-specific configuration
    }
}

Function reference

  • snd_pcm_rate_open()
  • _snd_pcm_rate_open()

Plugin: conversion plugin

该插件可根据要求转换通道,速率和格式。

pcm.name {
     
        type plug               # Automatic conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
        [format STR]    # Slave format (default nearest) or "unchanged"
        [channels INT]  # Slave channels (default nearest) or "unchanged"
        [rate INT]  # Slave rate (default nearest) or "unchanged"
        }
    route_policy STR    # route policy for automatic ttable generation
                # STR can be 'default', 'average', 'copy', 'duplicate'
                # average: result is average of input channels
                # copy: only first channels are copied to destination
                # duplicate: duplicate first set of channels
                # default: copy policy, except for mono capture - sum
    ttable {
             # Transfer table (bi-dimensional compound of cchannels * schannels numbers)
        CCHANNEL {
     
            SCHANNEL REAL   # route value (0.0 - 1.0)
        }
    }
    rate_converter STR  # type of rate converter
    # or
    rate_converter [ STR1 STR2 ... ]
                # type of rate converter
                # default value is taken from defaults.pcm.rate_converter
}

Function reference

  • snd_pcm_plug_open()
  • _snd_pcm_plug_open()

Plugin: File

此插件将PCM流的内容存储到文件中或将其通过管道传输到命令,并可选地使用现有文件作为输入数据源(即“虚拟麦克风”)

pcm.name {
     
        type file               # File PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
        }
    file STR        # Output filename (or shell command the stream
                # will be piped to if STR starts with the pipe
                # char).
                # STR can contain format keys, replaced by
                # real values corresponding to the stream:
                # %r    rate (replaced with: 48000)
                # %c    channels (replaced with: 2)
                # %b    bits per sample (replaced with: 16)
                # %f    sample format string
                #           (replaced with: S16_LE)
                # %%    replaced with %
    or
    file INT        # Output file descriptor number
    infile STR      # Input filename - only raw format
    or
    infile INT      # Input file descriptor number
    [format STR]        # File format ("raw" or "wav")
    [perm INT]      # Output file permission (octal, def. 0600)
}

Function reference

  • snd_pcm_file_open()
  • _snd_pcm_file_open()

Plugin: Multiple streams to One

该插件将多个流转换为一个。

pcm.name {
     
        type multi              # Multiple streams conversion PCM
        slaves {
             # Slaves definition
        ID STR      # Slave PCM name
        # or
        ID {
     
            pcm STR     # Slave PCM name
            # or
            pcm {
      }     # Slave PCM definition
            channels INT    # Slave channels
        }
        }
    bindings {
           # Bindings table
        N {
     
            slave STR   # Slave key
            channel INT # Slave channel
        }
    }
    [master INT]        # Define the master slave
}

例如,要将具有两声道立体声(hw:0,0和hw:0,1)的两个PCM流绑定为一个4声道立体声PCM流,请定义如下:

pcm.quad {
     
    type multi
    slaves.a.pcm "hw:0,0"
    slaves.a.channels 2
    slaves.b.pcm "hw:0,1"
    slaves.b.channels 2
    bindings.0.slave a
    bindings.0.channel 0
    bindings.1.slave a
    bindings.1.channel 1
    bindings.2.slave b
    bindings.2.channel 0
    bindings.3.slave b
    bindings.3.channel 1
}

请注意,所得的pcm“quad”不是交错格式,而是“ complex”格式。因此,只能处理交错(或非交错)格式的应用程序无法访问它。在这种情况下,请使用route 或 plug插件包装此PCM 。

pcm.quad2 {
     
    type route
    slave.pcm "quad"
    ttable.0.0 1
    ttable.1.1 1
    ttable.2.2 1
    ttable.3.3 1
}

Function reference

  • snd_pcm_multi_open()
  • _snd_pcm_multi_open()

Plugin: Share

此插件允许与更多客户端共享多个渠道。对每个通道的访问是专有的(样本不混合在一起)。这意味着,如果第一个客户端使用通道零,则第二个客户端不能使用此通道。如果您正在寻找混合插件,请使用dmix插件。
与dshare插件的区别在于,Share插件需要服务器程序“ aserver”,而dshare插件不需要显式服务器,但需要访问共享缓冲区。

pcm.name {
     
        type share              # Share PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                [format STR]    # Slave format
                [channels INT]  # Slave channels
                [rate INT]      # Slave rate
                [period_time INT] # Slave period time in us
                [buffer_time INT] # Slave buffer time in us
        }
    bindings {
     
        N INT       # Slave channel INT for client channel N
    }
}

Function reference

  • snd_pcm_share_open()
  • _snd_pcm_share_open()

Plugin: hooks

当打开,修改或关闭此插件时,该插件用于调用某些“hooks”功能。通常,它用于更改特定状态下特定于PCM的控制值(请参见下面的示例)。

# Hook arguments definition
hook_args.NAME {
     
    ...         # Arbitrary arguments
}
# PCM hook type
pcm_hook_type.NAME {
     
    [lib STR]       # Library file (default libasound.so)
    [install STR]       # Install function (default _snd_pcm_hook_NAME_install)
}
# PCM hook definition
pcm_hook.NAME {
     
    type STR        # PCM Hook type (see pcm_hook_type)
    [args STR]      # Arguments for install function (see hook_args)
    # or
    [args {
      }]      # Arguments for install function
}
# PCM hook plugin
pcm.NAME {
     
    type hooks      # PCM with hooks
    slave STR       # Slave name
    # or
    slave {
              # Slave definition
        pcm STR     # Slave PCM name
        # or
        pcm {
      }     # Slave PCM definition
    }
    hooks {
     
        ID STR      # Hook name (see pcm_hook)
        # or
        ID {
      }      # Hook definition (see pcm_hook)
    }
}

例:

hooks.0 {
     
    type ctl_elems
    hook_args [
        {
     
            name "Wave Surround Playback Volume"
            preserve true
            lock true
            optional true
            value [ 0 0 ]
        }
        {
     
            name "EMU10K1 PCM Send Volume"
            index {
      @func private_pcm_subdevice }
            lock true
            value [ 0 0 0 0 0 0 255 0 0 0 0 255 ]
        }
    ]
}

在访问此pcm时,此处的控件“ Wave Surround Playback Volume”和“ EMU10K1 PCM Send Volume”被设置为给定值。由于这些控件采用多维值,因此该value字段被写入数组。如果preserve为true,则在pcm关闭时将保存并恢复旧值。这lock意味着控件在此pcm打开期间被锁定,并且不能被其他人更改。当optional被设置,返回却忽略了任何错误,即使指定的控件不存在。

Function reference

  • The function ctl_elems -_snd_pcm_hook_ctl_elems_install() -安装由给定配置描述的CTL设置。
  • snd_pcm_hooks_open()
  • _snd_pcm_hooks_open()

Plugin: dmix

该插件可直接混合多个流。32位混合为24位。低有效字节用零填充。多余的8位用于饱和。

pcm.name {
     
    type dmix       # Direct mix
    ipc_key INT     # unique IPC key
    ipc_key_add_uid BOOL    # add current uid to unique IPC key
    ipc_perm INT        # IPC permissions (octal, default 0600)
    hw_ptr_alignment STR    # Slave application and hw pointer alignment type
                # STR can be one of the below strings :
                # no
                # roundup
                # rounddown
                # auto (default)
    tstamp_type STR     # timestamp type
                # STR can be one of the below strings :
                # default, gettimeofday, monotonic, monotonic_raw
    slave STR
    # or
    slave {
              # Slave definition
        pcm STR     # slave PCM name
        # or
        pcm {
      }     # slave PCM definition
        format STR  # format definition
        rate INT    # rate definition
        channels INT
        period_time INT # in usec
        # or
        period_size INT # in frames
        buffer_time INT # in usec
        # or
        buffer_size INT # in frames
        periods INT # when buffer_size or buffer_time is not specified
    }
    bindings {
           # note: this is client independent!!!
        N INT       # maps slave channel to client channel N
    }
    slowptr BOOL        # slow but more precise pointer updates
}

ipc_key用整数指定唯一的IPC密钥。该数字对于每个不同的dmix定义必须是唯一的,因为共享内存是使用此键号创建的。当ipc_key_add_uid设置为true时,会将uid值添加到中设置的值中ipc_key。这样可以避免同一IPC密钥同时与不同用户发生冲突。

hw_ptr_alignment指定从属应用程序和硬件指针对齐类型。默认情况下hw_ptr_alignment是自动的。以下是可能的配置:

  • no:启动时丢弃最少帧的最小延迟。但是唤醒应用程序(从snd_pcm_wait()或poll()返回)最多可能需要2 *时间。
  • roundup:确保在启动时播放所有帧。但是延迟将增加到周期1帧。
  • rounddown:保证每个周期都会发生唤醒,并且可以从应用程序写入帧。但是在启动时,周期1之前的帧将被丢弃。
  • auto:根据使用的时间段和缓冲区大小选择最佳方法。如果应用程序缓冲区大小小于2 *应用程序周期,将选择“roundup”以避免运行不足。如果slave_period <10ms,我们可以期望有较低的延迟要求。因此,将选择“rounddown”以避免长时间的唤醒时间。如果依赖于另一个声音设备(例如,将麦克风转发到扬声器),则此类唤醒延迟可能最终以Xruns结束。否则将选择“no”。

请注意,dmix插件本身仅支持单个配置。也就是说,它仅支持固定速率(默认为48000),格式(S16),通道(2)和period_time(125000)。要使用其他配置,必须在从PCM定义中显式设置该值。速率,格式和通道可以通过其他插件来覆盖,但是无论如何只有一种基本配置。

用于将44100 Hz S32_LE格式设置为“ hw:0”的从PCM 的示例配置如下:

pcm.dmix_44 {
     
    type dmix
    ipc_key 321456  # any unique value
    ipc_key_add_uid true
    slave {
     
        pcm "hw:0"
        format S32_LE
        rate 44100
    }
}

你可以通过使用 dmix pcm via plug插件听到48000 Hz样本,如下配置:

% aplay -Dplug:dmix_44 foo_48k.wav

为了将dmix插件用于OSS仿真设备,必须将周期和缓冲区大小设置为2的幂。例如,

pcm.dmixoss {
     
    type dmix
    ipc_key 321456  # any unique value
    ipc_key_add_uid true
    slave {
     
        pcm "hw:0"
        period_time 0
        period_size 1024  # must be power of 2
        buffer_size 8192  # ditto
    }
}

period_time 0必须被设置,为了重置默认值。对于具有多通道IO的声卡,添加绑定会有所帮助

pcm.dmixoss {
     
    ...
    bindings {
     
        0 0   # map from 0 to 0
        1 1   # map from 1 to 1
    }
}

因此dmix仅使用前两个通道。另外,请注意,ICE1712的缓冲区大小有限,为5513帧(相当于640 kB)。在这种情况下,请将buffer_size减小为4096。

Function reference

  • The function ctl_elems -_snd_pcm_hook_ctl_elems_install() -安装由给定配置描述的CTL设置。
  • snd_pcm_dmic_open()
  • _snd_pcm_dmic_open()

Plugin: dshare

该插件提供共享渠道。与share插件不同,此插件不需要显式的服务器程序,但可以从每个客户端同时访问共享缓冲区,而dmix和dsnoop插件也可以。以下参数与这些插件几乎相同。

pcm.name {
     
    type dshare     # Direct sharing
    ipc_key INT     # unique IPC key
    ipc_key_add_uid BOOL    # add current uid to unique IPC key
    ipc_perm INT        # IPC permissions (octal, default 0600)
    hw_ptr_alignment STR    # Slave application and hw pointer alignment type
        # STR can be one of the below strings :
        # no
        # roundup
        # rounddown
        # auto (default)
    tstamp_type STR     # timestamp type
                # STR can be one of the below strings :
                # default, gettimeofday, monotonic, monotonic_raw
    slave STR
    # or
    slave {
              # Slave definition
        pcm STR     # slave PCM name
        # or
        pcm {
      }     # slave PCM definition
        format STR  # format definition
        rate INT    # rate definition
        channels INT
        period_time INT # in usec
        # or
        period_size INT # in frames
        buffer_time INT # in usec
        # or
        buffer_size INT # in frames
        periods INT # when buffer_size or buffer_time is not specified
    }
    bindings {
           # note: this is client independent!!!
        N INT       # maps slave channel to client channel N
    }
    slowptr BOOL        # slow but more precise pointer updates

hw_ptr_alignment指定从属应用程序和硬件指针对齐类型。默认情况下,hw_ptr_alignment是自动的。以下是可能的配置:

  • no:启动时丢弃最少帧的最小延迟。但是唤醒应用程序(从snd_pcm_wait()或poll()返回)最多可能需要2 *时间。
  • roundup:确保在启动时播放所有帧。但是延迟将增加到周期1帧。
  • rounddown:保证每个周期都会发生唤醒,并且可以从应用程序写入帧。但是在启动时,周期1之前的帧将被丢弃。
  • auto:根据使用的时间段和缓冲区大小选择最佳方法。如果应用程序缓冲区大小小于2 *应用程序周期,将选择“roundup”以避免运行不足。如果slave_period <10ms,我们可以期望有较低的延迟要求。因此,将选择“rounddown”以避免长时间的唤醒时间。如果依赖于另一个声音设备(例如,将麦克风转发到扬声器),则此类唤醒延迟可能最终以Xruns结束。否则将选择“no”。

Function reference

  • The function ctl_elems -_snd_pcm_hook_ctl_elems_install() -安装由给定配置描述的CTL设置。
  • snd_pcm_dshare_open()
  • _snd_pcm_dshare_open()

Plugin: dsnoop

此插件将一个捕获流拆分为更多。它的工作方式与dmix插件相反,可以同时从许多客户端读取共享捕获缓冲区。以下参数的含义与dmix插件几乎相同。

pcm.name {
     
    type dsnoop     # Direct snoop
    ipc_key INT     # unique IPC key
    ipc_key_add_uid BOOL    # add current uid to unique IPC key
    ipc_perm INT        # IPC permissions (octal, default 0600)
    hw_ptr_alignment STR    # Slave application and hw pointer alignment type
        # STR can be one of the below strings :
        # no
        # roundup
        # rounddown
        # auto (default)
    tstamp_type STR     # timestamp type
                # STR can be one of the below strings :
                # default, gettimeofday, monotonic, monotonic_raw
    slave STR
    # or
    slave {
              # Slave definition
        pcm STR     # slave PCM name
        # or
        pcm {
      }     # slave PCM definition
        format STR  # format definition
        rate INT    # rate definition
        channels INT
        period_time INT # in usec
        # or
        period_size INT # in frames
        buffer_time INT # in usec
        # or
        buffer_size INT # in frames
        periods INT # when buffer_size or buffer_time is not specified
    }
    bindings {
           # note: this is client independent!!!
        N INT       # maps slave channel to client channel N
    }
    slowptr BOOL        # slow but more precise pointer updates
}

hw_ptr_alignment指定从属应用程序和硬件指针对齐类型。默认情况下,hw_ptr_alignment是自动的。以下是可能的配置:

  • no:启动时丢弃最少帧的最小延迟。但是唤醒应用程序(从snd_pcm_wait()或poll()返回)最多可能需要2 *时间。
  • roundup:确保在启动时播放所有帧。但是延迟将增加到周期1帧。
  • rounddown:保证每个周期都会发生唤醒,并且可以从应用程序写入帧。但是在启动时,周期1之前的帧将被丢弃。
  • auto:根据使用的时间段和缓冲区大小选择最佳方法。如果应用程序缓冲区大小小于2 *应用程序周期,则将选择“roundup”以避免溢出。如果slave_period <10ms,我们可以期望有较低的延迟要求。因此,将选择“rounddown”以避免长时间的唤醒时间。否则将选择“no”。

Function reference

  • The function ctl_elems -_snd_pcm_hook_ctl_elems_install() -安装由给定配置描述的CTL设置。
  • snd_pcm_dsnoop_open()
  • _snd_pcm_dsnoop_open()

Plugin: LADSPA <-> ALSA

此插件允许应用一组LADPSA插件。输入和输出格式始终为SND_PCM_FORMAT_FLOAT(请注意:根据体系结构,此类型可以为小端或大端)。

策略重复意味着通道0只能有一个绑定定义。该定义会自动复制到所有通道。如果LADSPA插件具有多个音频输入或输出,则策略重复项将自动切换为策略无。

插件序列化按预期工作。您最终可以在LADPSA插件链中使用的通道(输入/输出)多于ALSA插件链中处理的通道。如果给定的LADSPA输入音频端口不存在ALSA通道,则对该LADSPA端口提供零样本。在输出端(ALSA下一个插件输入),也检查有效通道。如果特定的ALSA通道不存在,则LADSPA输出端口将连接到虚拟样本区域。

LADSPA插件的实例是动态创建的。

pcm.name {
     
        type ladspa             # ALSA<->LADSPA PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
        }
        [channels INT]      # count input channels (input to LADSPA plugin chain)
    [path STR]      # Path (directory) with LADSPA plugins
    plugins |       # Definition for both directions
        playback_plugins |  # Definition for playback direction
    capture_plugins {
        # Definition for capture direction
        N {
          # Configuration for LADPSA plugin N
            [id INT]    # LADSPA plugin ID (for example 1043)
            [label STR] # LADSPA plugin label (for example 'delay_5s')
            [filename STR]  # Full filename of .so library with LADSPA plugin code
            [policy STR]    # Policy can be 'none' or 'duplicate'
            input | output {
     
                bindings {
     
                    C INT or STR    # C - channel, INT - audio port index, STR - audio port name
                }
                controls {
     
                        # valid only in the input block
                    I INT or REAL   # I - control port index, INT or REAL - control value
                    # or
                    STR INT or REAL # STR - control port name, INT or REAL - control value
                }
            }
        }
    }
}

Function reference

  • The function ctl_elems -_snd_pcm_hook_ctl_elems_install() -安装由给定配置描述的CTL设置。
  • snd_pcm_ladspa_open()
  • _snd_pcm_ladspa_open()

Plugin: asym

此插件是播放和录音PCM流的组合。可以为两个方向非对称地定义从PCM。

pcm.name {
     
        type asym               # Asym PCM
        playback STR            # Playback slave name
        # or
        playback {
                   # Playback slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
        }
        capture STR             # Capture slave name
        # or
        capture {
                    # Capture slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
        }
}

例如,您可以将dmix插件和dsnoop插件组合为单个PCM,分别用于播放和录音。

pcm.duplex {
     
    type asym
    playback.pcm "dmix"
    capture.pcm "dsnoop"
}

通过仅定义一个方向,导致PCM变为半双工。

Function reference

  • _snd_pcm_asym_open()

Plugin: IEC958

此插件将32位IEC958子帧样本转换为线性,或将线性转换为32bit IEC958子帧样本。

pcm.name {
     
        type iec958             # IEC958 subframe conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
        }
    [status status-bytes]   # IEC958 status bits (given in byte array)
    # IEC958 preamble bits definitions
    # B/M/W or Z/X/Y, B = block start, M = even subframe, W = odd subframe
    # As default, Z = 0x08, Y = 0x04, X = 0x02
    [preamble.z or preamble.b val]
    [preamble.x or preamble.m val]
    [preamble.y or preamble.w val]
}

Function reference

  • snd_pcm_iec958_open()
  • _snd_pcm_iec958_open()

Plugin: Soft Volume

此插件应用软件音量衰减。格式,速率和通道必须与来源和目的都匹配。
当控件为立体声(count = 2)时,假定声道为单声道,2.0、2.1、4.0、4.1、5.1或7.1。
如果该控件已经存在并且是系统控件(即没有用户定义的控件),则该插件将简单地传递其从属,而无需进行任何更改。

pcm.name {
     
        type softvol            # Soft Volume conversion PCM
        slave STR               # Slave name
        # or
        slave {
                      # Slave definition
                pcm STR         # Slave PCM name
                # or
                pcm {
      }         # Slave PCM definition
                [format STR]    # Slave format
        }
        control {
     
            name STR        # control element id string
        [card STR]      # control card index
        [iface STR]     # interface of the element
        [index INT]     # index of the element
        [device INT]    # device number of the element
        [subdevice INT] # subdevice number of the element
        [count INT]     # control channels 1 or 2 (default: 2)
    }
    [min_dB REAL]           # minimal dB value (default: -51.0)
    [max_dB REAL]           # maximal dB value (default:   0.0)
    [resolution INT]        # resolution (default: 256)
                # resolution = 2 means a mute switch
}

Function reference

  • snd_pcm_softvol_open()
  • _snd_pcm_softvol_open()

Plugin: Null

此插件丢弃PCM流的内容,或创建具有零样本的流。
注意:此实现使用设备/ dev / null(播放,必须可写)和/ dev / full(录音,必须可读)。

pcm.name {
     
        type null               # Null PCM
}

Function reference

  • _snd_pcm_empty_open()

翻译:https://www.alsa-project.org/alsa-doc/alsa-lib/pcm_plugins.html

https://blog.csdn.net/sssuperqiqi/article/details/97033472
http://www.volkerschatz.com/noise/alsa.html
使用asound.conf http://www.360doc.com/content/15/1104/10/18578054_510631673.shtml

你可能感兴趣的:(ALSA子系统,alsa,pcm_plugins,plugin,pcm)