[media] v4l2: Add a V4L2 driver for SI476X MFD
This commit adds a driver that exposes all the radio related functionality of the Si476x series of chips via the V4L2 subsystem. Acked-by: Hans Verkuil <hans.verkuil@cisco.com> Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
This commit is contained in:
parent
33a80fc2eb
commit
30bac91104
187
Documentation/video4linux/si476x.txt
Normal file
187
Documentation/video4linux/si476x.txt
Normal file
|
@ -0,0 +1,187 @@
|
||||||
|
SI476x Driver Readme
|
||||||
|
------------------------------------------------
|
||||||
|
Copyright (C) 2013 Andrey Smirnov <andrew.smirnov@gmail.com>
|
||||||
|
|
||||||
|
TODO for the driver
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
- According to the SiLabs' datasheet it is possible to update the
|
||||||
|
firmware of the radio chip in the run-time, thus bringing it to the
|
||||||
|
most recent version. Unfortunately I couldn't find any mentioning of
|
||||||
|
the said firmware update for the old chips that I tested the driver
|
||||||
|
against, so for chips like that the driver only exposes the old
|
||||||
|
functionality.
|
||||||
|
|
||||||
|
|
||||||
|
Parameters exposed over debugfs
|
||||||
|
-------------------------------
|
||||||
|
SI476x allow user to get multiple characteristics that can be very
|
||||||
|
useful for EoL testing/RF performance estimation, parameters that have
|
||||||
|
very little to do with V4L2 subsystem. Such parameters are exposed via
|
||||||
|
debugfs and can be accessed via regular file I/O operations.
|
||||||
|
|
||||||
|
The drivers exposes following files:
|
||||||
|
|
||||||
|
* /sys/kernel/debug/<device-name>/acf
|
||||||
|
This file contains ACF(Automatically Controlled Features) status
|
||||||
|
information. The contents of the file is binary data of the
|
||||||
|
following layout:
|
||||||
|
|
||||||
|
Offset | Name | Description
|
||||||
|
====================================================================
|
||||||
|
0x00 | blend_int | Flag, set when stereo separation has
|
||||||
|
| | crossed below the blend threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x01 | hblend_int | Flag, set when HiBlend cutoff
|
||||||
|
| | frequency is lower than threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x02 | hicut_int | Flag, set when HiCut cutoff
|
||||||
|
| | frequency is lower than threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x03 | chbw_int | Flag, set when channel filter
|
||||||
|
| | bandwidth is less than threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x04 | softmute_int | Flag indicating that softmute
|
||||||
|
| | attenuation has increased above
|
||||||
|
| | softmute threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x05 | smute | 0 - Audio is not soft muted
|
||||||
|
| | 1 - Audio is soft muted
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x06 | smattn | Soft mute attenuation level in dB
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x07 | chbw | Channel filter bandwidth in kHz
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x08 | hicut | HiCut cutoff frequency in units of
|
||||||
|
| | 100Hz
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x09 | hiblend | HiBlend cutoff frequency in units
|
||||||
|
| | of 100 Hz
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x10 | pilot | 0 - Stereo pilot is not present
|
||||||
|
| | 1 - Stereo pilot is present
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x11 | stblend | Stereo blend in %
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
||||||
|
* /sys/kernel/debug/<device-name>/rds_blckcnt
|
||||||
|
This file contains statistics about RDS receptions. It's binary data
|
||||||
|
has the following layout:
|
||||||
|
|
||||||
|
Offset | Name | Description
|
||||||
|
====================================================================
|
||||||
|
0x00 | expected | Number of expected RDS blocks
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x02 | received | Number of received RDS blocks
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x04 | uncorrectable | Number of uncorrectable RDS blocks
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
|
||||||
|
* /sys/kernel/debug/<device-name>/agc
|
||||||
|
This file contains information about parameters pertaining to
|
||||||
|
AGC(Automatic Gain Control)
|
||||||
|
|
||||||
|
The layout is:
|
||||||
|
Offset | Name | Description
|
||||||
|
====================================================================
|
||||||
|
0x00 | mxhi | 0 - FM Mixer PD high threshold is
|
||||||
|
| | not tripped
|
||||||
|
| | 1 - FM Mixer PD high threshold is
|
||||||
|
| | tripped
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x01 | mxlo | ditto for FM Mixer PD low
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x02 | lnahi | ditto for FM LNA PD high
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x03 | lnalo | ditto for FM LNA PD low
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x04 | fmagc1 | FMAGC1 attenuator resistance
|
||||||
|
| | (see datasheet for more detail)
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x05 | fmagc2 | ditto for FMAGC2
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x06 | pgagain | PGA gain in dB
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x07 | fmwblang | FM/WB LNA Gain in dB
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
|
||||||
|
* /sys/kernel/debug/<device-name>/rsq
|
||||||
|
This file contains information about parameters pertaining to
|
||||||
|
RSQ(Received Signal Quality)
|
||||||
|
|
||||||
|
The layout is:
|
||||||
|
Offset | Name | Description
|
||||||
|
====================================================================
|
||||||
|
0x00 | multhint | 0 - multipath value has not crossed
|
||||||
|
| | the Multipath high threshold
|
||||||
|
| | 1 - multipath value has crossed
|
||||||
|
| | the Multipath high threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x01 | multlint | ditto for Multipath low threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x02 | snrhint | 0 - received signal's SNR has not
|
||||||
|
| | crossed high threshold
|
||||||
|
| | 1 - received signal's SNR has
|
||||||
|
| | crossed high threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x03 | snrlint | ditto for low threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x04 | rssihint | ditto for RSSI high threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x05 | rssilint | ditto for RSSI low threshold
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x06 | bltf | Flag indicating if seek command
|
||||||
|
| | reached/wrapped seek band limit
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x07 | snr_ready | Indicates that SNR metrics is ready
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x08 | rssiready | ditto for RSSI metrics
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x09 | injside | 0 - Low-side injection is being used
|
||||||
|
| | 1 - High-side injection is used
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x10 | afcrl | Flag indicating if AFC rails
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x11 | valid | Flag indicating if channel is valid
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x12 | readfreq | Current tuned frequency
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x14 | freqoff | Singed frequency offset in units of
|
||||||
|
| | 2ppm
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x15 | rssi | Signed value of RSSI in dBuV
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x16 | snr | Signed RF SNR in dB
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x17 | issi | Signed Image Strength Signal
|
||||||
|
| | indicator
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x18 | lassi | Signed Low side adjacent Channel
|
||||||
|
| | Strength indicator
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x19 | hassi | ditto fpr High side
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x20 | mult | Multipath indicator
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x21 | dev | Frequency deviation
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x24 | assi | Adjascent channel SSI
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x25 | usn | Ultrasonic noise indicator
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x26 | pilotdev | Pilot deviation in units of 100 Hz
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x27 | rdsdev | ditto for RDS
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x28 | assidev | ditto for ASSI
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x29 | strongdev | Frequency deviation
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
0x30 | rdspi | RDS PI code
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
|
||||||
|
* /sys/kernel/debug/<device-name>/rsq_primary
|
||||||
|
This file contains information about parameters pertaining to
|
||||||
|
RSQ(Received Signal Quality) for primary tuner only. Layout is as
|
||||||
|
the one above.
|
|
@ -18,6 +18,23 @@ config RADIO_SI470X
|
||||||
|
|
||||||
source "drivers/media/radio/si470x/Kconfig"
|
source "drivers/media/radio/si470x/Kconfig"
|
||||||
|
|
||||||
|
config RADIO_SI476X
|
||||||
|
tristate "Silicon Laboratories Si476x I2C FM Radio"
|
||||||
|
depends on I2C && VIDEO_V4L2
|
||||||
|
select MFD_CORE
|
||||||
|
select MFD_SI476X_CORE
|
||||||
|
select SND_SOC_SI476X
|
||||||
|
---help---
|
||||||
|
Choose Y here if you have this FM radio chip.
|
||||||
|
|
||||||
|
In order to control your radio card, you will need to use programs
|
||||||
|
that are compatible with the Video For Linux 2 API. Information on
|
||||||
|
this API and pointers to "v4l2" programs may be found at
|
||||||
|
<file:Documentation/video4linux/API.html>.
|
||||||
|
|
||||||
|
To compile this driver as a module, choose M here: the
|
||||||
|
module will be called radio-si476x.
|
||||||
|
|
||||||
config USB_MR800
|
config USB_MR800
|
||||||
tristate "AverMedia MR 800 USB FM radio support"
|
tristate "AverMedia MR 800 USB FM radio support"
|
||||||
depends on USB && VIDEO_V4L2
|
depends on USB && VIDEO_V4L2
|
||||||
|
|
|
@ -19,6 +19,7 @@ obj-$(CONFIG_RADIO_GEMTEK) += radio-gemtek.o
|
||||||
obj-$(CONFIG_RADIO_TRUST) += radio-trust.o
|
obj-$(CONFIG_RADIO_TRUST) += radio-trust.o
|
||||||
obj-$(CONFIG_I2C_SI4713) += si4713-i2c.o
|
obj-$(CONFIG_I2C_SI4713) += si4713-i2c.o
|
||||||
obj-$(CONFIG_RADIO_SI4713) += radio-si4713.o
|
obj-$(CONFIG_RADIO_SI4713) += radio-si4713.o
|
||||||
|
obj-$(CONFIG_RADIO_SI476X) += radio-si476x.o
|
||||||
obj-$(CONFIG_RADIO_MIROPCM20) += radio-miropcm20.o
|
obj-$(CONFIG_RADIO_MIROPCM20) += radio-miropcm20.o
|
||||||
obj-$(CONFIG_USB_DSBR) += dsbr100.o
|
obj-$(CONFIG_USB_DSBR) += dsbr100.o
|
||||||
obj-$(CONFIG_RADIO_SI470X) += si470x/
|
obj-$(CONFIG_RADIO_SI470X) += si470x/
|
||||||
|
|
1599
drivers/media/radio/radio-si476x.c
Normal file
1599
drivers/media/radio/radio-si476x.c
Normal file
File diff suppressed because it is too large
Load diff
426
include/media/si476x.h
Normal file
426
include/media/si476x.h
Normal file
|
@ -0,0 +1,426 @@
|
||||||
|
/*
|
||||||
|
* include/media/si476x.h -- Common definitions for si476x driver
|
||||||
|
*
|
||||||
|
* Copyright (C) 2012 Innovative Converged Devices(ICD)
|
||||||
|
* Copyright (C) 2013 Andrey Smirnov
|
||||||
|
*
|
||||||
|
* Author: Andrey Smirnov <andrew.smirnov@gmail.com>
|
||||||
|
*
|
||||||
|
* This program is free software; you can redistribute it and/or modify
|
||||||
|
* it under the terms of the GNU General Public License as published by
|
||||||
|
* the Free Software Foundation; version 2 of the License.
|
||||||
|
*
|
||||||
|
* This program is distributed in the hope that it will be useful, but
|
||||||
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||||
|
* General Public License for more details.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef SI476X_H
|
||||||
|
#define SI476X_H
|
||||||
|
|
||||||
|
#include <linux/types.h>
|
||||||
|
#include <linux/videodev2.h>
|
||||||
|
|
||||||
|
struct si476x_device;
|
||||||
|
|
||||||
|
/* It is possible to select one of the four adresses using pins A0
|
||||||
|
* and A1 on SI476x */
|
||||||
|
#define SI476X_I2C_ADDR_1 0x60
|
||||||
|
#define SI476X_I2C_ADDR_2 0x61
|
||||||
|
#define SI476X_I2C_ADDR_3 0x62
|
||||||
|
#define SI476X_I2C_ADDR_4 0x63
|
||||||
|
|
||||||
|
enum si476x_iqclk_config {
|
||||||
|
SI476X_IQCLK_NOOP = 0,
|
||||||
|
SI476X_IQCLK_TRISTATE = 1,
|
||||||
|
SI476X_IQCLK_IQ = 21,
|
||||||
|
};
|
||||||
|
enum si476x_iqfs_config {
|
||||||
|
SI476X_IQFS_NOOP = 0,
|
||||||
|
SI476X_IQFS_TRISTATE = 1,
|
||||||
|
SI476X_IQFS_IQ = 21,
|
||||||
|
};
|
||||||
|
enum si476x_iout_config {
|
||||||
|
SI476X_IOUT_NOOP = 0,
|
||||||
|
SI476X_IOUT_TRISTATE = 1,
|
||||||
|
SI476X_IOUT_OUTPUT = 22,
|
||||||
|
};
|
||||||
|
enum si476x_qout_config {
|
||||||
|
SI476X_QOUT_NOOP = 0,
|
||||||
|
SI476X_QOUT_TRISTATE = 1,
|
||||||
|
SI476X_QOUT_OUTPUT = 22,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_dclk_config {
|
||||||
|
SI476X_DCLK_NOOP = 0,
|
||||||
|
SI476X_DCLK_TRISTATE = 1,
|
||||||
|
SI476X_DCLK_DAUDIO = 10,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_dfs_config {
|
||||||
|
SI476X_DFS_NOOP = 0,
|
||||||
|
SI476X_DFS_TRISTATE = 1,
|
||||||
|
SI476X_DFS_DAUDIO = 10,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_dout_config {
|
||||||
|
SI476X_DOUT_NOOP = 0,
|
||||||
|
SI476X_DOUT_TRISTATE = 1,
|
||||||
|
SI476X_DOUT_I2S_OUTPUT = 12,
|
||||||
|
SI476X_DOUT_I2S_INPUT = 13,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_xout_config {
|
||||||
|
SI476X_XOUT_NOOP = 0,
|
||||||
|
SI476X_XOUT_TRISTATE = 1,
|
||||||
|
SI476X_XOUT_I2S_INPUT = 13,
|
||||||
|
SI476X_XOUT_MODE_SELECT = 23,
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
enum si476x_icin_config {
|
||||||
|
SI476X_ICIN_NOOP = 0,
|
||||||
|
SI476X_ICIN_TRISTATE = 1,
|
||||||
|
SI476X_ICIN_GPO1_HIGH = 2,
|
||||||
|
SI476X_ICIN_GPO1_LOW = 3,
|
||||||
|
SI476X_ICIN_IC_LINK = 30,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_icip_config {
|
||||||
|
SI476X_ICIP_NOOP = 0,
|
||||||
|
SI476X_ICIP_TRISTATE = 1,
|
||||||
|
SI476X_ICIP_GPO2_HIGH = 2,
|
||||||
|
SI476X_ICIP_GPO2_LOW = 3,
|
||||||
|
SI476X_ICIP_IC_LINK = 30,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_icon_config {
|
||||||
|
SI476X_ICON_NOOP = 0,
|
||||||
|
SI476X_ICON_TRISTATE = 1,
|
||||||
|
SI476X_ICON_I2S = 10,
|
||||||
|
SI476X_ICON_IC_LINK = 30,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_icop_config {
|
||||||
|
SI476X_ICOP_NOOP = 0,
|
||||||
|
SI476X_ICOP_TRISTATE = 1,
|
||||||
|
SI476X_ICOP_I2S = 10,
|
||||||
|
SI476X_ICOP_IC_LINK = 30,
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
enum si476x_lrout_config {
|
||||||
|
SI476X_LROUT_NOOP = 0,
|
||||||
|
SI476X_LROUT_TRISTATE = 1,
|
||||||
|
SI476X_LROUT_AUDIO = 2,
|
||||||
|
SI476X_LROUT_MPX = 3,
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
enum si476x_intb_config {
|
||||||
|
SI476X_INTB_NOOP = 0,
|
||||||
|
SI476X_INTB_TRISTATE = 1,
|
||||||
|
SI476X_INTB_DAUDIO = 10,
|
||||||
|
SI476X_INTB_IRQ = 40,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_a1_config {
|
||||||
|
SI476X_A1_NOOP = 0,
|
||||||
|
SI476X_A1_TRISTATE = 1,
|
||||||
|
SI476X_A1_IRQ = 40,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_part_revisions {
|
||||||
|
SI476X_REVISION_A10 = 0,
|
||||||
|
SI476X_REVISION_A20 = 1,
|
||||||
|
SI476X_REVISION_A30 = 2,
|
||||||
|
};
|
||||||
|
|
||||||
|
struct si476x_pinmux {
|
||||||
|
enum si476x_dclk_config dclk;
|
||||||
|
enum si476x_dfs_config dfs;
|
||||||
|
enum si476x_dout_config dout;
|
||||||
|
enum si476x_xout_config xout;
|
||||||
|
|
||||||
|
enum si476x_iqclk_config iqclk;
|
||||||
|
enum si476x_iqfs_config iqfs;
|
||||||
|
enum si476x_iout_config iout;
|
||||||
|
enum si476x_qout_config qout;
|
||||||
|
|
||||||
|
enum si476x_icin_config icin;
|
||||||
|
enum si476x_icip_config icip;
|
||||||
|
enum si476x_icon_config icon;
|
||||||
|
enum si476x_icop_config icop;
|
||||||
|
|
||||||
|
enum si476x_lrout_config lrout;
|
||||||
|
|
||||||
|
enum si476x_intb_config intb;
|
||||||
|
enum si476x_a1_config a1;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* enum si476x_phase_diversity_mode - possbile phase diversity modes
|
||||||
|
* for SI4764/5/6/7 chips.
|
||||||
|
*
|
||||||
|
* @SI476X_PHDIV_DISABLED: Phase diversity feature is
|
||||||
|
* disabled.
|
||||||
|
* @SI476X_PHDIV_PRIMARY_COMBINING: Tuner works as a primary tuner
|
||||||
|
* in combination with a
|
||||||
|
* secondary one.
|
||||||
|
* @SI476X_PHDIV_PRIMARY_ANTENNA: Tuner works as a primary tuner
|
||||||
|
* using only its own antenna.
|
||||||
|
* @SI476X_PHDIV_SECONDARY_ANTENNA: Tuner works as a primary tuner
|
||||||
|
* usning seconary tuner's antenna.
|
||||||
|
* @SI476X_PHDIV_SECONDARY_COMBINING: Tuner works as a secondary
|
||||||
|
* tuner in combination with the
|
||||||
|
* primary one.
|
||||||
|
*/
|
||||||
|
enum si476x_phase_diversity_mode {
|
||||||
|
SI476X_PHDIV_DISABLED = 0,
|
||||||
|
SI476X_PHDIV_PRIMARY_COMBINING = 1,
|
||||||
|
SI476X_PHDIV_PRIMARY_ANTENNA = 2,
|
||||||
|
SI476X_PHDIV_SECONDARY_ANTENNA = 3,
|
||||||
|
SI476X_PHDIV_SECONDARY_COMBINING = 5,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_ibias6x {
|
||||||
|
SI476X_IBIAS6X_OTHER = 0,
|
||||||
|
SI476X_IBIAS6X_RCVR1_NON_4MHZ_CLK = 1,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_xstart {
|
||||||
|
SI476X_XSTART_MULTIPLE_TUNER = 0x11,
|
||||||
|
SI476X_XSTART_NORMAL = 0x77,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_freq {
|
||||||
|
SI476X_FREQ_4_MHZ = 0,
|
||||||
|
SI476X_FREQ_37P209375_MHZ = 1,
|
||||||
|
SI476X_FREQ_36P4_MHZ = 2,
|
||||||
|
SI476X_FREQ_37P8_MHZ = 3,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_xmode {
|
||||||
|
SI476X_XMODE_CRYSTAL_RCVR1 = 1,
|
||||||
|
SI476X_XMODE_EXT_CLOCK = 2,
|
||||||
|
SI476X_XMODE_CRYSTAL_RCVR2_3 = 3,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_xbiashc {
|
||||||
|
SI476X_XBIASHC_SINGLE_RECEIVER = 0,
|
||||||
|
SI476X_XBIASHC_MULTIPLE_RECEIVER = 1,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_xbias {
|
||||||
|
SI476X_XBIAS_RCVR2_3 = 0,
|
||||||
|
SI476X_XBIAS_4MHZ_RCVR1 = 3,
|
||||||
|
SI476X_XBIAS_RCVR1 = 7,
|
||||||
|
};
|
||||||
|
|
||||||
|
enum si476x_func {
|
||||||
|
SI476X_FUNC_BOOTLOADER = 0,
|
||||||
|
SI476X_FUNC_FM_RECEIVER = 1,
|
||||||
|
SI476X_FUNC_AM_RECEIVER = 2,
|
||||||
|
SI476X_FUNC_WB_RECEIVER = 3,
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @xcload: Selects the amount of additional on-chip capacitance to
|
||||||
|
* be connected between XTAL1 and gnd and between XTAL2 and
|
||||||
|
* GND. One half of the capacitance value shown here is the
|
||||||
|
* additional load capacitance presented to the xtal. The
|
||||||
|
* minimum step size is 0.277 pF. Recommended value is 0x28
|
||||||
|
* but it will be layout dependent. Range is 0–0x3F i.e.
|
||||||
|
* (0–16.33 pF)
|
||||||
|
* @ctsien: enable CTSINT(interrupt request when CTS condition
|
||||||
|
* arises) when set
|
||||||
|
* @intsel: when set A1 pin becomes the interrupt pin; otherwise,
|
||||||
|
* INTB is the interrupt pin
|
||||||
|
* @func: selects the boot function of the device. I.e.
|
||||||
|
* SI476X_BOOTLOADER - Boot loader
|
||||||
|
* SI476X_FM_RECEIVER - FM receiver
|
||||||
|
* SI476X_AM_RECEIVER - AM receiver
|
||||||
|
* SI476X_WB_RECEIVER - Weatherband receiver
|
||||||
|
* @freq: oscillator's crystal frequency:
|
||||||
|
* SI476X_XTAL_37P209375_MHZ - 37.209375 Mhz
|
||||||
|
* SI476X_XTAL_36P4_MHZ - 36.4 Mhz
|
||||||
|
* SI476X_XTAL_37P8_MHZ - 37.8 Mhz
|
||||||
|
*/
|
||||||
|
struct si476x_power_up_args {
|
||||||
|
enum si476x_ibias6x ibias6x;
|
||||||
|
enum si476x_xstart xstart;
|
||||||
|
u8 xcload;
|
||||||
|
bool fastboot;
|
||||||
|
enum si476x_xbiashc xbiashc;
|
||||||
|
enum si476x_xbias xbias;
|
||||||
|
enum si476x_func func;
|
||||||
|
enum si476x_freq freq;
|
||||||
|
enum si476x_xmode xmode;
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
enum si476x_ctrl_id {
|
||||||
|
V4L2_CID_SI476X_RSSI_THRESHOLD = (V4L2_CID_USER_SI476X_BASE + 1),
|
||||||
|
V4L2_CID_SI476X_SNR_THRESHOLD = (V4L2_CID_USER_SI476X_BASE + 2),
|
||||||
|
V4L2_CID_SI476X_MAX_TUNE_ERROR = (V4L2_CID_USER_SI476X_BASE + 3),
|
||||||
|
V4L2_CID_SI476X_HARMONICS_COUNT = (V4L2_CID_USER_SI476X_BASE + 4),
|
||||||
|
V4L2_CID_SI476X_DIVERSITY_MODE = (V4L2_CID_USER_SI476X_BASE + 5),
|
||||||
|
V4L2_CID_SI476X_INTERCHIP_LINK = (V4L2_CID_USER_SI476X_BASE + 6),
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Platform dependent definition
|
||||||
|
*/
|
||||||
|
struct si476x_platform_data {
|
||||||
|
int gpio_reset; /* < 0 if not used */
|
||||||
|
|
||||||
|
struct si476x_power_up_args power_up_parameters;
|
||||||
|
enum si476x_phase_diversity_mode diversity_mode;
|
||||||
|
|
||||||
|
struct si476x_pinmux pinmux;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* struct si476x_rsq_status - structure containing received signal
|
||||||
|
* quality
|
||||||
|
* @multhint: Multipath Detect High.
|
||||||
|
* true - Indicatedes that the value is below
|
||||||
|
* FM_RSQ_MULTIPATH_HIGH_THRESHOLD
|
||||||
|
* false - Indicatedes that the value is above
|
||||||
|
* FM_RSQ_MULTIPATH_HIGH_THRESHOLD
|
||||||
|
* @multlint: Multipath Detect Low.
|
||||||
|
* true - Indicatedes that the value is below
|
||||||
|
* FM_RSQ_MULTIPATH_LOW_THRESHOLD
|
||||||
|
* false - Indicatedes that the value is above
|
||||||
|
* FM_RSQ_MULTIPATH_LOW_THRESHOLD
|
||||||
|
* @snrhint: SNR Detect High.
|
||||||
|
* true - Indicatedes that the value is below
|
||||||
|
* FM_RSQ_SNR_HIGH_THRESHOLD
|
||||||
|
* false - Indicatedes that the value is above
|
||||||
|
* FM_RSQ_SNR_HIGH_THRESHOLD
|
||||||
|
* @snrlint: SNR Detect Low.
|
||||||
|
* true - Indicatedes that the value is below
|
||||||
|
* FM_RSQ_SNR_LOW_THRESHOLD
|
||||||
|
* false - Indicatedes that the value is above
|
||||||
|
* FM_RSQ_SNR_LOW_THRESHOLD
|
||||||
|
* @rssihint: RSSI Detect High.
|
||||||
|
* true - Indicatedes that the value is below
|
||||||
|
* FM_RSQ_RSSI_HIGH_THRESHOLD
|
||||||
|
* false - Indicatedes that the value is above
|
||||||
|
* FM_RSQ_RSSI_HIGH_THRESHOLD
|
||||||
|
* @rssilint: RSSI Detect Low.
|
||||||
|
* true - Indicatedes that the value is below
|
||||||
|
* FM_RSQ_RSSI_LOW_THRESHOLD
|
||||||
|
* false - Indicatedes that the value is above
|
||||||
|
* FM_RSQ_RSSI_LOW_THRESHOLD
|
||||||
|
* @bltf: Band Limit.
|
||||||
|
* Set if seek command hits the band limit or wrapped to
|
||||||
|
* the original frequency.
|
||||||
|
* @snr_ready: SNR measurement in progress.
|
||||||
|
* @rssiready: RSSI measurement in progress.
|
||||||
|
* @afcrl: Set if FREQOFF >= MAX_TUNE_ERROR
|
||||||
|
* @valid: Set if the channel is valid
|
||||||
|
* rssi < FM_VALID_RSSI_THRESHOLD
|
||||||
|
* snr < FM_VALID_SNR_THRESHOLD
|
||||||
|
* tune_error < FM_VALID_MAX_TUNE_ERROR
|
||||||
|
* @readfreq: Current tuned frequency.
|
||||||
|
* @freqoff: Signed frequency offset.
|
||||||
|
* @rssi: Received Signal Strength Indicator(dBuV).
|
||||||
|
* @snr: RF SNR Indicator(dB).
|
||||||
|
* @lassi:
|
||||||
|
* @hassi: Low/High side Adjacent(100 kHz) Channel Strength Indicator
|
||||||
|
* @mult: Multipath indicator
|
||||||
|
* @dev: Who knows? But values may vary.
|
||||||
|
* @readantcap: Antenna tuning capacity value.
|
||||||
|
* @assi: Adjacent Channel(+/- 200kHz) Strength Indicator
|
||||||
|
* @usn: Ultrasonic Noise Inticator in -DBFS
|
||||||
|
*/
|
||||||
|
struct si476x_rsq_status_report {
|
||||||
|
__u8 multhint, multlint;
|
||||||
|
__u8 snrhint, snrlint;
|
||||||
|
__u8 rssihint, rssilint;
|
||||||
|
__u8 bltf;
|
||||||
|
__u8 snr_ready;
|
||||||
|
__u8 rssiready;
|
||||||
|
__u8 injside;
|
||||||
|
__u8 afcrl;
|
||||||
|
__u8 valid;
|
||||||
|
|
||||||
|
__u16 readfreq;
|
||||||
|
__s8 freqoff;
|
||||||
|
__s8 rssi;
|
||||||
|
__s8 snr;
|
||||||
|
__s8 issi;
|
||||||
|
__s8 lassi, hassi;
|
||||||
|
__s8 mult;
|
||||||
|
__u8 dev;
|
||||||
|
__u16 readantcap;
|
||||||
|
__s8 assi;
|
||||||
|
__s8 usn;
|
||||||
|
|
||||||
|
__u8 pilotdev;
|
||||||
|
__u8 rdsdev;
|
||||||
|
__u8 assidev;
|
||||||
|
__u8 strongdev;
|
||||||
|
__u16 rdspi;
|
||||||
|
} __packed;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* si476x_acf_status_report - ACF report results
|
||||||
|
*
|
||||||
|
* @blend_int: If set, indicates that stereo separation has crossed
|
||||||
|
* below the blend threshold as set by FM_ACF_BLEND_THRESHOLD
|
||||||
|
* @hblend_int: If set, indicates that HiBlend cutoff frequency is
|
||||||
|
* lower than threshold as set by FM_ACF_HBLEND_THRESHOLD
|
||||||
|
* @hicut_int: If set, indicates that HiCut cutoff frequency is lower
|
||||||
|
* than the threshold set by ACF_
|
||||||
|
|
||||||
|
*/
|
||||||
|
struct si476x_acf_status_report {
|
||||||
|
__u8 blend_int;
|
||||||
|
__u8 hblend_int;
|
||||||
|
__u8 hicut_int;
|
||||||
|
__u8 chbw_int;
|
||||||
|
__u8 softmute_int;
|
||||||
|
__u8 smute;
|
||||||
|
__u8 smattn;
|
||||||
|
__u8 chbw;
|
||||||
|
__u8 hicut;
|
||||||
|
__u8 hiblend;
|
||||||
|
__u8 pilot;
|
||||||
|
__u8 stblend;
|
||||||
|
} __packed;
|
||||||
|
|
||||||
|
enum si476x_fmagc {
|
||||||
|
SI476X_FMAGC_10K_OHM = 0,
|
||||||
|
SI476X_FMAGC_800_OHM = 1,
|
||||||
|
SI476X_FMAGC_400_OHM = 2,
|
||||||
|
SI476X_FMAGC_200_OHM = 4,
|
||||||
|
SI476X_FMAGC_100_OHM = 8,
|
||||||
|
SI476X_FMAGC_50_OHM = 16,
|
||||||
|
SI476X_FMAGC_25_OHM = 32,
|
||||||
|
SI476X_FMAGC_12P5_OHM = 64,
|
||||||
|
SI476X_FMAGC_6P25_OHM = 128,
|
||||||
|
};
|
||||||
|
|
||||||
|
struct si476x_agc_status_report {
|
||||||
|
__u8 mxhi;
|
||||||
|
__u8 mxlo;
|
||||||
|
__u8 lnahi;
|
||||||
|
__u8 lnalo;
|
||||||
|
__u8 fmagc1;
|
||||||
|
__u8 fmagc2;
|
||||||
|
__u8 pgagain;
|
||||||
|
__u8 fmwblang;
|
||||||
|
} __packed;
|
||||||
|
|
||||||
|
struct si476x_rds_blockcount_report {
|
||||||
|
__u16 expected;
|
||||||
|
__u16 received;
|
||||||
|
__u16 uncorrectable;
|
||||||
|
} __packed;
|
||||||
|
|
||||||
|
#endif /* SI476X_H*/
|
Loading…
Reference in a new issue