161 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3.. include:: <isonum.txt>4 5 6The SI476x Driver7=================8 9Copyright |copy| 2013 Andrey Smirnov <andrew.smirnov@gmail.com>10 11TODO for the driver12-------------------13 14- According to the SiLabs' datasheet it is possible to update the15 firmware of the radio chip in the run-time, thus bringing it to the16 most recent version. Unfortunately I couldn't find any mentioning of17 the said firmware update for the old chips that I tested the driver18 against, so for chips like that the driver only exposes the old19 functionality.20 21 22Parameters exposed over debugfs23-------------------------------24SI476x allow user to get multiple characteristics that can be very25useful for EoL testing/RF performance estimation, parameters that have26very little to do with V4L2 subsystem. Such parameters are exposed via27debugfs and can be accessed via regular file I/O operations.28 29The drivers exposes following files:30 31* /sys/kernel/debug/<device-name>/acf32 This file contains ACF(Automatically Controlled Features) status33 information. The contents of the file is binary data of the34 following layout:35 36 .. tabularcolumns:: |p{7ex}|p{12ex}|L|37 38 ============= ============== ====================================39 Offset Name Description40 ============= ============== ====================================41 0x00 blend_int Flag, set when stereo separation has42 crossed below the blend threshold43 0x01 hblend_int Flag, set when HiBlend cutoff44 frequency is lower than threshold45 0x02 hicut_int Flag, set when HiCut cutoff46 frequency is lower than threshold47 0x03 chbw_int Flag, set when channel filter48 bandwidth is less than threshold49 0x04 softmute_int Flag indicating that softmute50 attenuation has increased above51 softmute threshold52 0x05 smute 0 - Audio is not soft muted53 1 - Audio is soft muted54 0x06 smattn Soft mute attenuation level in dB55 0x07 chbw Channel filter bandwidth in kHz56 0x08 hicut HiCut cutoff frequency in units of57 100Hz58 0x09 hiblend HiBlend cutoff frequency in units59 of 100 Hz60 0x10 pilot 0 - Stereo pilot is not present61 1 - Stereo pilot is present62 0x11 stblend Stereo blend in %63 ============= ============== ====================================64 65 66* /sys/kernel/debug/<device-name>/rds_blckcnt67 This file contains statistics about RDS receptions. It's binary data68 has the following layout:69 70 .. tabularcolumns:: |p{7ex}|p{12ex}|L|71 72 ============= ============== ====================================73 Offset Name Description74 ============= ============== ====================================75 0x00 expected Number of expected RDS blocks76 0x02 received Number of received RDS blocks77 0x04 uncorrectable Number of uncorrectable RDS blocks78 ============= ============== ====================================79 80* /sys/kernel/debug/<device-name>/agc81 This file contains information about parameters pertaining to82 AGC(Automatic Gain Control)83 84 The layout is:85 86 .. tabularcolumns:: |p{7ex}|p{12ex}|L|87 88 ============= ============== ====================================89 Offset Name Description90 ============= ============== ====================================91 0x00 mxhi 0 - FM Mixer PD high threshold is92 not tripped93 1 - FM Mixer PD high threshold is94 tripped95 0x01 mxlo ditto for FM Mixer PD low96 0x02 lnahi ditto for FM LNA PD high97 0x03 lnalo ditto for FM LNA PD low98 0x04 fmagc1 FMAGC1 attenuator resistance99 (see datasheet for more detail)100 0x05 fmagc2 ditto for FMAGC2101 0x06 pgagain PGA gain in dB102 0x07 fmwblang FM/WB LNA Gain in dB103 ============= ============== ====================================104 105* /sys/kernel/debug/<device-name>/rsq106 This file contains information about parameters pertaining to107 RSQ(Received Signal Quality)108 109 The layout is:110 111 .. tabularcolumns:: |p{7ex}|p{12ex}|p{60ex}|112 113 ============= ============== ====================================114 Offset Name Description115 ============= ============== ====================================116 0x00 multhint 0 - multipath value has not crossed117 the Multipath high threshold118 1 - multipath value has crossed119 the Multipath high threshold120 0x01 multlint ditto for Multipath low threshold121 0x02 snrhint 0 - received signal's SNR has not122 crossed high threshold123 1 - received signal's SNR has124 crossed high threshold125 0x03 snrlint ditto for low threshold126 0x04 rssihint ditto for RSSI high threshold127 0x05 rssilint ditto for RSSI low threshold128 0x06 bltf Flag indicating if seek command129 reached/wrapped seek band limit130 0x07 snr_ready Indicates that SNR metrics is ready131 0x08 rssiready ditto for RSSI metrics132 0x09 injside 0 - Low-side injection is being used133 1 - High-side injection is used134 0x10 afcrl Flag indicating if AFC rails135 0x11 valid Flag indicating if channel is valid136 0x12 readfreq Current tuned frequency137 0x14 freqoff Signed frequency offset in units of138 2ppm139 0x15 rssi Signed value of RSSI in dBuV140 0x16 snr Signed RF SNR in dB141 0x17 issi Signed Image Strength Signal142 indicator143 0x18 lassi Signed Low side adjacent Channel144 Strength indicator145 0x19 hassi ditto for High side146 0x20 mult Multipath indicator147 0x21 dev Frequency deviation148 0x24 assi Adjacent channel SSI149 0x25 usn Ultrasonic noise indicator150 0x26 pilotdev Pilot deviation in units of 100 Hz151 0x27 rdsdev ditto for RDS152 0x28 assidev ditto for ASSI153 0x29 strongdev Frequency deviation154 0x30 rdspi RDS PI code155 ============= ============== ====================================156 157* /sys/kernel/debug/<device-name>/rsq_primary158 This file contains information about parameters pertaining to159 RSQ(Received Signal Quality) for primary tuner only. Layout is as160 the one above.161