Add IQ file recording and IQ file viewer to ImScope
This commit introduces the following changes to ImScope:
- Added the ability to record IQ data using the same mechanism as ImScope.
- Added a new executable target
imscope_iq_file_viewerfor viewing IQ files. - Introduced a command line argument
--imscope-recordthat enables data recording mode. - Refactored a lot of the scope code
Usage:
-
To record IQ data, run a modem with
--imscope-recordflag. The recording happens whenever a modem calls dumpScopeData, which currently is done only in gNB on PUSCH DTX and PUSCH CRC NOK. There is a limit of ~1GB of files written by the thread in a signle run to avoid accidentally exhausting disk space. If a directoryimscope-dumpis available the data will be recorded there in .imscope files. Otherwise files are written to the directory the modem was run. This is done so that the directory can be mapped in a docker container. -
To view recorded IQ files, use the new executable
imscope_iq_file_viewer. This can be done by running:./imscope_iq_file_viewer <path_to_iq_file>Replace
<path_to_iq_file>with the path to the IQ file you want to view.