如何进行实时频谱分析仪二次开发——三种不同开发环境的部署

软件无线电

    

    软件无线电，即软件定义的无线电，是利用现代化软件来控制传统硬件电路的一种无线通信技术。传统的硬件无线电通信设备只是作为无线通信的基本平台，而许多的通信功能则是由软件来实现，这使得设备的通信功能的实现不再只依赖于硬件的发展。

    虹科实时频谱分析仪通过免费开放的API和经过验证的集成可构建完整的解决方案，能够轻松与第三方应用程序、软件和硬件集成，允许用户根据自己特定需求构建正确的解决方案。

 

产品介绍

    

    虹科HK-R5550和HK-R5750实时频谱分析仪以创新的软件无线电技术（SDR）为基础，在具有传统实验室级频谱分析仪性能的同时，成本、尺寸、重量和功耗只有其小部分。便携式无风扇虹科实时频谱仪专为在实验室、现场或车辆中的分布式部署而设计，具有高性能、软件定义的RF接收器、数字化仪和分析仪的优势。

• 频率范围：9kHz-8GHz/18GHz/27GHz
• 实时带宽：0.1 / 10 / 40 / 100 MHz
• 扫描速率 28 GHz/s
• 10 MHz 输入和输出时钟参考，用于多单元同步
• 动态范围：100 dB

    虹科实时频谱分析仪紧凑便携，可以用于多种户外场景中，它具有宽瞬时带宽和深度动态范围，基于千兆以太网的控制和通信，并且可以进行联网和远程部署，虹科HK-R5750还具有嵌入式GNSS模块，来获取位置和时间戳信息。

 

1、MATLAB开发环境配置

    

虹科实时频谱仪可以进行MATLAB、C/C++和Labview等环境配置，下面先介绍虹科实时频谱分析仪二次开发的MATLAB开发环境的部署步骤：

需要的内容

• 虹科Matlab二次开发包文件
• Matlab软件（2014b以上）
• Windows 7 及以上版本

配置步骤

• 打开虹科Matlab二次开发包文件，如需要文字参考，请打开matlab编程指南参考第四页；
• 解压“Matlab API压缩包”至指定目录，打开指定目录文件夹中的API文件夹；
• 打开Matlab，需要在程序运行前将API文件添加到运行路径中，为了避免发生错误，请按照以下步骤来操作；
• 在命令行输入以下指令：userpath，使matlab工作空间回到初始位置；
• 选择startup.m文件并打开，若没有，请创建一个这样的文件；
• 在里面加上以下指令：addpath(genpath());复制指定文件夹API目录的地址，并替换部分；
• 复制指定目录文件夹地址至matlab工作空间地址；
• 此时若文件夹高亮显示，说明例程文件可用。

 

2、C++开发环境配置

    

虹科实时频谱分析仪二次开发的C++开发环境的部署步骤：

需要的内容

• 虹科C/C++ 二次开发包文件
• Visual Studio 2010 Express 或更高版本
• Windows 7 及以上版本

配置步骤

• 打开虹科C++二次开发包文件，解压“C++ API压缩包”至创建VS工程的文件夹，并打开，将其中所有文件剪切粘贴至工程目录下；
• 回到VS主界面，右侧资源文件中添加：打开VS所在文件夹-x32文件夹，选择lib文件并确认；
• 右侧源文件中添加需要运行的例程，注意，该演示项目中只能包含一个示例；
• 右侧头文件中添加：打开VS所在文件夹，选择wsaInterface.h；
• 点击运行，此时报错是正常的，本次运行了是为了添加debug文件夹；
• 返回工程文件夹，打开“x32”文件夹，将dll库文件剪切至Debug文件夹；
• 返回VS点击调试，如一般情况则到此步便可以正常调试；
• 排查一下通常会遇到的报错问题：

① 如果出现头文件找不到的情况，打开.h所在目录，即VS新建目录选择复制，点击VS中源文件运行程序，右键打开属性，C++-常规-附加包含目录：粘贴地址即可；

② 如果出现形参不兼容的报错，选中项目，点击项目-属性-C/C++-语言-符合模式设置为否即可。

 

3、Labview开发环境配置

    

虹科实时频谱分析仪二次开发的Labview开发环境的部署步骤：

需要的内容

• 虹科Labview二次开发包
• NI LabVIEW Full Development 2014或更高版本的32 位/ 64 位软件
• 32 位/ 64 位RTSAInterface.dll，提供的C ++ DLL 包含在LabVIEW API 版本中，但可能会单独下载和更新

配置步骤

    配置Labview开发环境一共有两种方式：利用免安装调用方式实现和使用VI Package Manager 安装API。

（1）使用免安装方式调用API，直接将API集成到需要调用的项目中，将API作为一个项目打开：

• 打开虹科Labview二次开发包文件，如需要文字参考，请打开Labview编程指南参考，解压“Labview API压缩包”至指定目录；可复制目录地址方便之后使用；
• 打开Labview，选择左上角“文件”，选择“打开项目”，定位到解压缩的目录，选择“ThinkRF RTSA API.lvproj”并打开；
• 选取“Examples”中的例程，打开即可；
• 例程需要的IP地址可以通过S240上位机软件获取；
• 打开例程，填写IP地址，点击运行；
• 若设备连接，此时在右侧框图中会出现活动的频谱图像，若出现错误代码“-10201”，则说明设备未连接。

（2）使用免安装方式调用API，直接将API集成到需要调用的项目中，将API作为一个项目打开：

• 使用这种方法时需要注意:本节中的cip文件是基于LabVIEW 2017版本生成的， 仅适用于LabVIEW 2017及以上版本；
• 打开虹科Labview二次开发包文件，并解压“Labview API压缩包”至指定目录；
• 双击随附的* .vip 文件，或在VI Package Manager 左上角选择<文件>-<打开包文件>打开* .vip 文件；
• 按照说明在计算机上安装软件包；
• 在功能面板中双击ThinkRF RTSA API,选择Show in Palettes中查看API VI函数,选择Show Examples中查看例程并打开即可；
• 如果连接设备，此时运行即可使用，若出现错误代码“-10201”，则说明设备未连接。