^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. include:: <isonum.txt>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) The SI476x Driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) =================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Copyright |copy| 2013 Andrey Smirnov <andrew.smirnov@gmail.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) TODO for the driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) -------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) - According to the SiLabs' datasheet it is possible to update the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) firmware of the radio chip in the run-time, thus bringing it to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) most recent version. Unfortunately I couldn't find any mentioning of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) the said firmware update for the old chips that I tested the driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) against, so for chips like that the driver only exposes the old
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) functionality.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Parameters exposed over debugfs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) -------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) SI476x allow user to get multiple characteristics that can be very
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) useful for EoL testing/RF performance estimation, parameters that have
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) very little to do with V4L2 subsystem. Such parameters are exposed via
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) debugfs and can be accessed via regular file I/O operations.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) The drivers exposes following files:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * /sys/kernel/debug/<device-name>/acf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) This file contains ACF(Automatically Controlled Features) status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) information. The contents of the file is binary data of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) following layout:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) .. tabularcolumns:: |p{7ex}|p{12ex}|L|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Offset Name Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) 0x00 blend_int Flag, set when stereo separation has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) crossed below the blend threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) 0x01 hblend_int Flag, set when HiBlend cutoff
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) frequency is lower than threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) 0x02 hicut_int Flag, set when HiCut cutoff
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) frequency is lower than threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) 0x03 chbw_int Flag, set when channel filter
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) bandwidth is less than threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) 0x04 softmute_int Flag indicating that softmute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) attenuation has increased above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) softmute threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) 0x05 smute 0 - Audio is not soft muted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 1 - Audio is soft muted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) 0x06 smattn Soft mute attenuation level in dB
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) 0x07 chbw Channel filter bandwidth in kHz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) 0x08 hicut HiCut cutoff frequency in units of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 100Hz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 0x09 hiblend HiBlend cutoff frequency in units
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) of 100 Hz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 0x10 pilot 0 - Stereo pilot is not present
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) 1 - Stereo pilot is present
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) 0x11 stblend Stereo blend in %
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) * /sys/kernel/debug/<device-name>/rds_blckcnt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) This file contains statistics about RDS receptions. It's binary data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) has the following layout:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) .. tabularcolumns:: |p{7ex}|p{12ex}|L|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) Offset Name Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) 0x00 expected Number of expected RDS blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) 0x02 received Number of received RDS blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) 0x04 uncorrectable Number of uncorrectable RDS blocks
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) * /sys/kernel/debug/<device-name>/agc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) This file contains information about parameters pertaining to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) AGC(Automatic Gain Control)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) The layout is:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) .. tabularcolumns:: |p{7ex}|p{12ex}|L|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Offset Name Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) 0x00 mxhi 0 - FM Mixer PD high threshold is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) not tripped
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) 1 - FM Mixer PD high threshold is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) tripped
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) 0x01 mxlo ditto for FM Mixer PD low
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) 0x02 lnahi ditto for FM LNA PD high
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) 0x03 lnalo ditto for FM LNA PD low
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) 0x04 fmagc1 FMAGC1 attenuator resistance
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) (see datasheet for more detail)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) 0x05 fmagc2 ditto for FMAGC2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) 0x06 pgagain PGA gain in dB
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) 0x07 fmwblang FM/WB LNA Gain in dB
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) * /sys/kernel/debug/<device-name>/rsq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) This file contains information about parameters pertaining to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) RSQ(Received Signal Quality)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) The layout is:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) .. tabularcolumns:: |p{7ex}|p{12ex}|p{60ex}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) Offset Name Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) 0x00 multhint 0 - multipath value has not crossed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) the Multipath high threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) 1 - multipath value has crossed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) the Multipath high threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) 0x01 multlint ditto for Multipath low threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) 0x02 snrhint 0 - received signal's SNR has not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) crossed high threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) 1 - received signal's SNR has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) crossed high threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) 0x03 snrlint ditto for low threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) 0x04 rssihint ditto for RSSI high threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) 0x05 rssilint ditto for RSSI low threshold
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) 0x06 bltf Flag indicating if seek command
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) reached/wrapped seek band limit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) 0x07 snr_ready Indicates that SNR metrics is ready
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) 0x08 rssiready ditto for RSSI metrics
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) 0x09 injside 0 - Low-side injection is being used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) 1 - High-side injection is used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) 0x10 afcrl Flag indicating if AFC rails
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) 0x11 valid Flag indicating if channel is valid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) 0x12 readfreq Current tuned frequency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) 0x14 freqoff Signed frequency offset in units of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) 2ppm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) 0x15 rssi Signed value of RSSI in dBuV
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) 0x16 snr Signed RF SNR in dB
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) 0x17 issi Signed Image Strength Signal
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) indicator
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) 0x18 lassi Signed Low side adjacent Channel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) Strength indicator
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) 0x19 hassi ditto fpr High side
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) 0x20 mult Multipath indicator
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) 0x21 dev Frequency deviation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) 0x24 assi Adjacent channel SSI
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) 0x25 usn Ultrasonic noise indicator
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) 0x26 pilotdev Pilot deviation in units of 100 Hz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) 0x27 rdsdev ditto for RDS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) 0x28 assidev ditto for ASSI
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) 0x29 strongdev Frequency deviation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) 0x30 rdspi RDS PI code
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) ============= ============== ====================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) * /sys/kernel/debug/<device-name>/rsq_primary
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) This file contains information about parameters pertaining to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) RSQ(Received Signal Quality) for primary tuner only. Layout is as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) the one above.
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags