forked from Minki/linux
f2ac8ce823
All Documentation files outside the uAPI are all licensed with, at least, GPL 2.0. So, mark them as such. The ondes at media/uapi are at least GFDL 1.1+. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
161 lines
5.9 KiB
ReStructuredText
161 lines
5.9 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
.. include:: <isonum.txt>
|
|
|
|
|
|
The SI476x Driver
|
|
=================
|
|
|
|
Copyright |copy| 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:
|
|
|
|
.. tabularcolumns:: |p{7ex}|p{12ex}|L|
|
|
|
|
============= ============== ====================================
|
|
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:
|
|
|
|
.. tabularcolumns:: |p{7ex}|p{12ex}|L|
|
|
|
|
============= ============== ====================================
|
|
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:
|
|
|
|
.. tabularcolumns:: |p{7ex}|p{12ex}|L|
|
|
|
|
============= ============== ====================================
|
|
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:
|
|
|
|
.. tabularcolumns:: |p{7ex}|p{12ex}|p{60ex}|
|
|
|
|
============= ============== ====================================
|
|
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 Signed 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 Adjacent 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.
|