You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
187 lines
8.8 KiB
187 lines
8.8 KiB
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 | 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.
|
|
|