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"