7.21. Silicon Labs Si4713 调频广播发射器驱动

版权所有 © 2009 Nokia Corporation

联系人: Eduardo Valentin <eduardo.valentin@nokia.com>

7.21.1. 设备信息

这款芯片是 Silicon Labs 的产品。它是一款 I2C 设备,目前地址为 0x63。基本上,它具有发射和信号噪声水平测量功能。

Si4713 集成了调频广播立体声传输的发射功能。该芯片还支持集成的接收功率扫描,以识别低信号功率的调频频道。

该芯片通过命令和响应进行编程。还有一些属性可以改变芯片的行为。

用户必须遵守当地关于射频 (RF) 传输的规定。

7.21.2. 设备驱动描述

有两个模块用于处理此设备。一个是 I2C 设备驱动,另一个是平台驱动。

I2C 设备驱动向内核暴露了一个 v4l2-subdev 接口。所有属性也可以通过 v4l2 扩展控件接口访问,通过使用 v4l2-subdev 调用 (g_ext_ctrls, s_ext_ctrls)。

平台设备驱动向用户空间暴露了一个 v4l2 无线电设备接口。因此,它使用 I2C 设备驱动作为子设备,以便将用户命令发送到实际设备。它基本上是 I2C 设备驱动的一个包装器。

应用程序可以使用 v4l2 无线电 API 来指定操作频率、静音状态等。但其大部分属性将出现在扩展控件中。

当 v4l2 静音属性设置为 1 (真) 时,驱动将关闭芯片。

7.21.3. 属性描述

属性可以使用 v4l2 扩展控件访问。以下是 v4l2-ctl 工具的输出示例:

/ # v4l2-ctl -d /dev/radio0 --all -L
Driver Info:
        Driver name   : radio-si4713
        Card type     : Silicon Labs Si4713 Modulator
        Bus info      :
        Driver version: 0
        Capabilities  : 0x00080800
                RDS Output
                Modulator
Audio output: 0 (FM Modulator Audio Out)
Frequency: 1408000 (88.000000 MHz)
Video Standard = 0x00000000
Modulator:
        Name                 : FM Modulator
        Capabilities         : 62.5 Hz stereo rds
        Frequency range      : 76.0 MHz - 108.0 MHz
        Subchannel modulation: stereo+rds

User Controls

                        mute (bool) : default=1 value=0

FM Radio Modulator Controls

        rds_signal_deviation (int)  : min=0 max=90000 step=10 default=200 value=200 flags=slider
                rds_program_id (int)  : min=0 max=65535 step=1 default=0 value=0
        rds_program_type (int)  : min=0 max=31 step=1 default=0 value=0
                rds_ps_name (str)  : min=0 max=96 step=8 value='si4713  '
                rds_radio_text (str)  : min=0 max=384 step=32 value=''
audio_limiter_feature_enabled (bool) : default=1 value=1
audio_limiter_release_time (int)  : min=250 max=102390 step=50 default=5010 value=5010 flags=slider
        audio_limiter_deviation (int)  : min=0 max=90000 step=10 default=66250 value=66250 flags=slider
audio_compression_feature_enabl (bool) : default=1 value=1
        audio_compression_gain (int)  : min=0 max=20 step=1 default=15 value=15 flags=slider
audio_compression_threshold (int)  : min=-40 max=0 step=1 default=-40 value=-40 flags=slider
audio_compression_attack_time (int)  : min=0 max=5000 step=500 default=0 value=0 flags=slider
audio_compression_release_time (int)  : min=100000 max=1000000 step=100000 default=1000000 value=1000000 flags=slider
pilot_tone_feature_enabled (bool) : default=1 value=1
        pilot_tone_deviation (int)  : min=0 max=90000 step=10 default=6750 value=6750 flags=slider
        pilot_tone_frequency (int)  : min=0 max=19000 step=1 default=19000 value=19000 flags=slider
        pre_emphasis_settings (menu) : min=0 max=2 default=1 value=1
        tune_power_level (int)  : min=0 max=120 step=1 default=88 value=88 flags=slider
        tune_antenna_capacitor (int)  : min=0 max=191 step=1 default=0 value=110 flags=slider

以下是它们的摘要:

  • 导频是设备发送的可听音调。

  • pilot_frequency - 配置立体声导频音的频率。

  • pilot_deviation - 配置导频音频率偏差级别。

  • pilot_enabled - 启用或禁用导频音功能。

  • si4713 设备能够对传输的信号应用音频压缩。

  • acomp_enabled - 启用或禁用音频动态范围控制功能。

  • acomp_gain - 设置音频动态范围控制的增益。

  • acomp_threshold - 设置音频动态范围控制的阈值级别。

  • acomp_attack_time - 设置音频动态范围控制的启动时间。

  • acomp_release_time - 设置音频动态范围控制的释放时间。

  • 限幅器设置音频偏差限幅器功能。一旦发生过偏差,可以调整音频输入的输入增益,从而始终防止过偏差。

  • limiter_enabled - 启用或禁用限幅器功能。

  • limiter_deviation - 配置音频频率偏差级别。

  • limiter_release_time - 设置限幅器释放时间。

  • 调谐功率

  • power_level - 设置信号传输的输出功率级别。antenna_capacitor - 如果设置为零,此选项手动或自动选择天线调谐电容器的值。

  • RDS 相关

  • rds_ps_name - 设置用于传输的 RDS ps 名称字段。

  • rds_radio_text - 设置用于传输的 RDS 无线电文本。

  • rds_pi - 设置用于传输的 RDS PI 字段。

  • rds_pty - 设置用于传输的 RDS PTY 字段。

  • 区域相关

  • preemphasis - 设置用于传输的预加重。

7.21.4. RNL

此设备还具有一个接口,用于测量接收到的噪声水平。为此,您应该对设备节点执行 ioctl 操作。以下是一个代码示例:

int main (int argc, char *argv[])
{
        struct si4713_rnl rnl;
        int fd = open("/dev/radio0", O_RDWR);
        int rval;

        if (argc < 2)
                return -EINVAL;

        if (fd < 0)
                return fd;

        sscanf(argv[1], "%d", &rnl.frequency);

        rval = ioctl(fd, SI4713_IOC_MEASURE_RNL, &rnl);
        if (rval < 0)
                return rval;

        printf("received noise level: %d\n", rnl.rnl);

        close(fd);
}

结构体 si4713_rnl 和 SI4713_IOC_MEASURE_RNL 定义在 include/linux/platform_data/media/si4713.h 中。

7.21.5. 立体声/单声道和 RDS 子通道

该设备还可以使用可用的传输子通道进行配置。为此,请使用 S/G_MODULATOR ioctl 并正确配置 txsubchans。有关此 ioctl 的正确使用,请参考 V4L2 API 规范。

7.21.6. 测试

测试通常使用 v4l2-ctl 工具进行,该工具用于管理调频调谐器卡。该工具可以在 v4l-dvb 仓库的 v4l2-apps/util 目录下找到。

设置 rds ps 名称的示例

# v4l2-ctl -d /dev/radio0 --set-ctrl=rds_ps_name="Dummy"