| 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. |