Add --cell-kv machine-readable LTE/5G-NR cell measurement output

[shark-fi]

Summary

Adds a --cell-kv flag (Qualcomm) that emits LTE and 5G-NR serving and neighbor cell measurements as single-line key=value records to stdout, for machine parsing / ingestion into external tooling. Without the flag, output is unchanged.

Record format:

pci=..,earfcn=..,earfcn_ul=..,frequency=..,protocol=lte|nr,cell=scell|ncell,plmn=..,mcc=..,mnc=..,tac=..,cid=..,band=..,bwmhzdl=..,bwmhzul=.. rssi=..,rsrp=..,rsrq=..

Example (LTE serving cell, with RRC identity joined in):

pci=214,earfcn=6300,earfcn_ul=24300,frequency=806000000,protocol=lte,cell=scell,plmn=310260,mcc=310,mnc=260,tac=7,cid=123456,band=20,bwmhzdl=10,bwmhzul=10 rssi=-66.625,rsrp=-101.25,rsrq=-14.0625

What's included

• util: dl_earfcn_to_frequency_hz() (3GPP TS 36.101 DL band table) and nrarfcn_to_frequency_hz() (TS 38.104 global raster) return center frequency in Hz; format_cell_kv() / format_plmn() build the record; LTE UL-EARFCN via the existing calculate_ul_earfcn().
• LTE (diagltelogparser) and NR (diagnrlogparser): serving and neighbor cell measurements emit the record. NR beam parsing is preserved (byte offsets still advance) but beams are not emitted as records.
• Stateful RRC↔ML1 join: RRC SCell Info packets populate a per-radio serving-cell identity cache (plmn/mcc/mnc/tac/cid/band/bandwidth), merged onto the matching ML1 serving-cell measurement. The join is guarded on (earfcn, pci) so stale identity is never attached to a different cell; neighbor cells remain identity-zeroed.

Compatibility / tests

• Default (no --cell-kv) output is byte-identical; the full existing test suite passes (81 tests).
• Scope is the Qualcomm parser; Samsung/HiSilicon are unaffected.

Notes

• Identity enrichment requires an RRC SCell Info packet to have been seen before the measurement (as in a live diag stream on cell change); measurements before it stay identity-zeroed.
• frequency is in Hz; bwmhzdl/ul in MHz.

🤖 Generated with Claude Code