yunsdrpluto工程开发手册

修订记2017324关于威视锐科技专注于软件定义（SDx）系列的研发与生产，面向无线通信、视觉和测试测量领域提供完整的解决方案，可应用于科研教学与产品研发。威视锐与微软联合开发的SoraSDR软件无线电平台、YunSDR软件无线电经唯一的基于x86和Windows系统的宽带软件无线电平台，目前已经有超过20多个国家的300多个用户在Sora平台上开发无线局域网、移动通信、大规模MIMO等相关领域的应用。作为全球最大的可编程器件公司Xilinx的全球认证合作伙伴、培训合作伙伴和大学计划合作伙伴，威视锐科技提供基于XilinxFPGA/SoC全方位解决方案。威视 OGDEVICES公司的第和大学计划合作伙伴，提供基于ADI的高性能射频收发器，转换器和传感器开发套件。特别是无线通信、物联网、视觉图像处理和数字信号处理的创新型建设，威视锐可以提供多年以来，威视锐坚持“InnovationforResearch”的发展理念，与国内众多知名高校客户，威视锐提供严格验证的模块、智能便携的测量仪器以及定制化的设计服务来目修订记 目 产品概 硬件特 硬件结 供电及电源分 FPGA配置方 主时钟与复 板卡扩展 YUNSDR开发功能介 2API应 YUNSDR硬件连接操 y320系列硬件连接操 Y4x0系列硬件连接操 YUNSDR设备检 单音信号自收发测 IEEE802.11a物理层测 IEEE802.11n物理层测 多模块级联应 多模块级联工作流 多模块级联应用连 MIMO4*4收发同步测 C语言API应 环境搭 编译 导入DEMO工 新建工 编译工 工程的运行与参数配 附录1YUNSDRAPI概 附录2调用流程示 图1Y320硬件系统框 图2前面板实物 图3后面板实物 图4前面 图5后面 图6电 图7晶 图8时钟校准原理框 图9软件流 图10下的C++编译器安 图11编译器的选 图12PC网络配置 图13PC网络配置 图14PC网络配置 图15PC网络配置 图16Y320系列配件图17网线及电源适配 图18Y320天线连接图示 图19天线连接图示 图20天线连接图示 图21SMA直连图 图22Y4X0自回环方式连接 图23Y4X0系列天线连接图示 图24Y4X0系列天线连接图示 图25设备检测图示 图26设备检测图示 图27设备检测图示 图28设备检测图示 图29自定义修改IP图 图30配置接口流 图31单音信号自收发发端代码配 图32单音信号发送信 图33单音信号自收发收端代码配 图34单音信号自收发运行效果 图35IEEE802.11A发 图36IEEE802.11A收端运行图示 图37IEEE802.11A收端运行图示 图38IEEE802.11N发端运行图 图39IEEE802.11N收端运行图示 图40IEEE802.11N收端运行图示 图41多终端同步发送流 图42多终端同步接收流 图43Y320S时戳同步系 图454台设备的IP配 图46设备互联操 图47时钟分配板前 图48时钟分配板的设 图491PPS和参考CLOCK的连 图50交换机的连 图51交换机与YUNSDR的连 图52时戳同步单音信号图53MIMO4*4发端运 图54MIMO4*4收端运行结 图55Eclipse地 图56双击安装 图57安装到默认 图58拷贝到Eclipse的解压路 图59选择WORKSPACE路 图60解压工程文件到 图61导入工程 图62导入工程 图63导入工程 图64新建工 图65选择GCC工具 图66导入源文 图67选择文件系 图68选择代码所 图69Project属 图70指定编译 图71编译工 图72编译生成的文 图73CONFIG.JSON初始化配置文 图74发送端修改不同的模 图75接收端不同的模 图76测试接收端和发送 图77程序运行结果提 图78配置流 图79收发数据流 产品概YunSDR比的便携式软件无线电平台。YunSDR采用了ogDevice公司高集成度的捷变射频收发器AD9361和Xilinx公司的SoC架构FPGAZYNQ，实现了频谱范围70MHz~6GHz，200KHz~56MHzFPGAARMLinuxPCPC，实现嵌入式的软件无线电架构。YunSDRYunSDR的特点USBYunSDR级联，结合时钟分配器，可以支持多台YunSDR级联构成更大规模的MIMO系统；支持软件开发流程，提供C/C++接口API，开发者可以采用开发环境进行无线通信算法仿真，也可以用户自行利用C/C++设计基于X86的无线通信系统。后续威视锐还会推出支持LabView、GNURadio等图形化的通信系统开发工具的API接口驱支持FPGA硬件开发流程，提供FPGA与ARM系统源程序，用户可以利用FPGA/SoC的嵌入式设计流程开发脱离PC的嵌入式软件无线电系统。对于不熟悉FPGA开发流程的用户威视锐提供基于高级语言转换（HLS）的通信系统DEMO，可以通过C/C++语言实现快速的FPGA转换。本文档主要介绍YunSDRY320/Y4x0系列的SDR开发流程，包括以下几部分：硬件架构介绍与使用说明、开发流程、C/C++开发流程、ARM机开发流程、附录软硬件工作流程。由于在高校科研和教学领域非常受欢迎，而且网络上也可以很容易找到非常多的代码资源，所以YunSDR硬件特嵌入式SOC主要特点如下FPGAXilinxZYNQARMcortexA910/100/1000MTCP/IPUSB2.0OTGuUSBY320低功耗，MicrousbTFFlashY320预留256MbQSPIFlash8GitEMMCY4x0预留4GbNANDZYNQarm射频前端主要特板载功率放大器，支持最高15dBm(单音balun70~6GHz发送A3GHz-发送B70MHz-接收A3GHz-接收B1.6GHz-接收C70MHz-TDDFDDGPSGPS硬件结板卡由ZYNQ嵌入式处理器、AD9361射频前端和电源电路构成，嵌入式处理器采用XilinxCortexA9双核处理器架构的ZYNQ系列XC7Z020，外设支10/100/1000M以太网、USBOTG、TFcard、UART串口和PIOADI公司的AD936170~6000MHz集成射频前端组成理想的软件无线电开发平台。射频前端包括功率放大器，天线开关，balun等组件，提升了设备的实用性，Y320射频部分的原理框图如下图。Y320与ADI的 ms2/3射频前端主要区别如下：板载功率放大器，支持最高15dBm(单音balun70~6GHz发送A3GHz-发送B70MHz-接收A3GHz-接收B1.6GHz-接收C70MHz-TDDFDD111Y320Y320前面板功能

Figure1Y4x0SPITXRXUSB56MHzGPSmodule10MHzExternal50MHz33MHzUSB3.0PCIEx4USB2.0GigabitAD9361名功第二通道发送端口(可配置TDD模式-LED-第二通道RGBLED-系统RGB第一通道发送端口(可配置TDD模式-LED-第一通道RGB外部秒脉冲输入（或用户自定义REFGPS有源天线接口（标配不含GPS模块Y320后面板功能

22名功USB2.0USB2.0OTG接口可以接驳UWIFIRJ45网10/100/1000TF第一启动，存放系统镜像和用户文用于FPGA调试或者JTAG方式程序使Xilinx电MicroMircoUSBZYNQ调试(COM口)设备启动模式选择，TF卡启动或者JTAG注：TFJTAGXilinx下Y4x0前面板功能

3从左至右分别为：PCIECable(←TFCard；→jtag)、用户自定义SW(←LOW；→HIGH),AD9361射频前端面板（MMCX连接器从左到右分别为：GPS天线、参考测试输出、参考输入、TRX1、RX1、RX2、TRX2），面板下方是对应的LED状态Y4x0后面板功能

图4开USB-AUSB-AUSBOTGRJ4510/100/1000MTFCard、USB3.0-BDEVICE、输出图5Y4x0参考：选择外部参考时钟（REF_SELET=1），使用ADF4001鉴相器校准（VCO_CAL=0）。由时钟分配器产生的10MHz外部参考和外部1pps进行同步。此时外部参考时钟接面板的REF-I(MMCX)上，外部1pps输入接在后面板的硬件资源及使用说供电及电源分YunSDRY3203W，板卡采用MicroUSB接口供电，因此可以选择PC的USB2.0接口（1A）5V1AUSB电源适配器。当使用PC的USB接口供电时，MicroUSB接口同时也可作为串口调试。Y4x0采用了更大规模的FPGA，典型功耗8W，采用12V直流电源供电，串口调试接口为USB-A型。PC端安装USB转串口驱动（WIN7WIN8 FPGA配置方YunSDR默认上电采用TF卡启动，系统运行所需的固件在TF卡中。同时也支持多种启动模式与FPGA调试调试。出厂TF卡中已经了YunSDR的SDR流程开发固件（也就是本文档所介绍的开发方式）JTAG接口用于FPGA调试。上电TF卡启动，右侧是JTAG启动。请注意：当处于TF启动模式时，在FPGA配置成功后可以使用 电缆行调试，比如通过行调试，比如通过观测FPGA固件，只有拨码开关处在JTAG模式时才可 FPGA的固件（bit文件）。同时Y320预留了QSPI和EMMCFlash可以作为备用启动和设备。TF卡QSPI启动模式需要打开机壳通过SWC2跳线进行选择。出厂默认启动模式为TFY4x0预留了NANDFlash启动，需要打开即可通过SWC2跳线进行选择。出厂默认启动模式为TF卡。JTAG调在板卡的前面板接口处的PTOG是FPGA的JTAG接口，采用2.0mm间距14pin连接器，请使用威视锐公司的redcable-xilinx电缆，当使用第电缆

图6电表3电缆接口定123456789TFZYNQ的TF卡启动需要制作boot.bin镜像，必须由CPUQSPIflash配Y320256MbitQSPIFLASH可作为启动设备。通过板卡SWC2TF卡启动模式或QSPI启动模式。12短路为TF卡模式、23短路为QSPI模式Y4x0支持NANDFlash启动。通过板卡SWC2跳线可以选择。12短路为TF卡模式、23短路为NAND模式。YunSDR出厂配置是TF卡启动。主时钟与复50MHz5x7mm3

4242FGND

1

板卡扩展

图7Y320与Y4x08个通用IO用户可以自定义，通用IO在机壳内部白色的连接4通用IO位信号名电123456789外部参考校准Y320Y4x0/Y4x01pps脉冲VC-TCXO(温补压控振荡器)进行校准，使板载时钟的基准频率与参考时钟一phaseVC-8refrerencevctcxovc-clockCP电压输出给VC-TCXO的压控端，当ADF4001锁定后VC-TCXO与外部参考的基准时钟10MHz26MHz，rcount表示参考频频系数，ncount表示本地时钟分频系数，另rcount=10，ncount=26可以完成ADF4001的鉴相功能。此外ADF4001ADF4001muxoutncountncount1，则26MHzncount=1，rcount=1，将第二块板卡的时钟YunSDR开发功能介YunSDR开发方式，威视锐提供了整体的PS(ZYNQ处理器部分)、PL（ZYNQ逻辑部分）、AD9361、Linux、网络、standalone的通信架构，并提供了整体设设计工程。上位机威视锐提供了C/C++的上位机例程、版本IEEE802.11a和IEEE802.11n的OFDM算法模型，和丰富的版本传统无线通信算法模型。用户可以使用此开发AD9361网络接口传输IQ配置AD9361实现射频收发实现AD9361可以通过和真实信道环境验证无线通信算法。基于威视锐提供的C/C++上位机的框架做二次开发在FPGA架构中加入基带算法逻辑二次开发api应通过API可以控制YunSDR的射频工作参数，控制YunSDR发送和接收IQ数据。PC通过千兆网与板卡相连，YunSDR接收到PC发送到的一帧数据后，将数据缓存在DDR中，然后配置YunSDR的DMA工作模式进入loopback模式，DMA将反复读取DDR的这一帧数据并通过RF发送出去，接收端收到数据后，YunSDR将接收的数据DDRsocket由千兆网发送至PC，至此组成了一个无线模拟仿真系由于PC和板卡的接口通过千兆网实现，那么在PC端就可以通过等工具将同样可以用将数据接收回来并用所需的方法解调。开发环境说明：

图 软件流PL负责数字接口，PS负责配置PL和PS之间通过DMA传输IQ支持通过配置射频参发送端支持发 产生的IQ数通 可获取射频前端到的IQ数提供基 版本ieee802.11a/n基带算法源程软件环境配在使用相应设备之前，需要对PC的环境进行配置。为保证顺利使用，请务必按照PC操作系统：Windows7/Windows10：2016aC编译库：SDK7.1详细的编译库支持请参见 环境配置完毕之后，打开的CommandWindow，输入mex-setup命令，显图 表明可以找到C++编译器(VS2013)，配置成功（若提示找不到编译器，请启电脑或检查相关软件的安装路径）mexsetupC++，显示如下。表示选择C++编译器以使交叉编译调用相关的库文件。11在进行开发时，设备的IP地址默认为192.1681.10，由于数据通过以太网口连接上位机（即指计算机）与设备进行数据交互，因此在使用之前需要把PC的IP设

图12PC图13PC找到本地连接（以太网），鼠 ‘属性’，出现下图图14PC点击‘Internet4(TCP/IPv4)图15PCYunSDR硬件连接操我们给出YubSDR（Y320/4x0）系列的硬件连接操作过程，旨在通过该指导，用户能够对设备进行检查有无损坏异常，同时能够顺利跑通相关的SDR例程。为了叙述方便，我们以一台SDRy320系列硬件连接操

图16y320YunSDR包含射频通道（TRX1和RX1为一组，TRX2和RX2为一组）RF1RF2。以下的操作连线过程，针对于TRX1RX1对于单台设备的自收发，我们可以直接将射频发送端口TRX1RX1SMA线直接连接，称之为SMA2.4GHz17

图18y320

图19图20TRX1RX1的射频端口。使用配套的网线及其电源适配器。也可使用配套的SMA线，直接将TRX1RX1的端口相连接。Y4x0系列硬件连接操

21SMAY4x0系列的SDR22Y4x022.4GHZ天线通过MMCX-SMA转接线分别连接到Y4x0前面板的TRX1和RX1端口，如下图所示：23Y4x0PCY4x0的网口，电源12V电源适配器，如下图所示:24Y4x0YunSDR设备检Y320采用MicroUSB接口供电，YunSDRY3203W，因此可以选择PC的USB2.0接口（1A）5V1AUSB电源适配器。当使用PC的USB接口供电时，MicroUSB接口同时也可作为串口调试。Y4x0需要外接12V直流电源供电，如果需要调试可以连接USB-A电缆，Y4x0侧插在UARTY320为例，Y4x0方法相同将USB线插入电脑的USB口，使用USB打开电脑的设备管理器，查看设备端口（本例中为图25启动putty图26在PC端通过指令连接板卡。通过此步骤可以验证以太网工作正常查看PC端网络状态

图27图28出厂默认TF卡中固件配置的板卡IP1192.168.1.10，用户若想修改此IP地址，可手动打开固件中的autostart.sh进行修改，物理地址和IP地址必须同时修改，修改完毕之后保存退出，重新上电启动，按照上述方式（命令）验证修改是否正确。同时也必须修改相应m程序中的ip地址和自定义相同：参考例程演

图29自定义修改IP本文档提供基 环境的单音信号收发测试、IEEE802.11a物理层演示IEEE802.11n物理层例程的源代码与使用说明。主要是针对Y3x0系列的操作，Y4x0的例程和Y3x0大同小异，不再赘述。在进行相关例程测试之前，您必须确认以提 可供调用的SDK环境确认设备TF设备供电使用配套电源适配器，或者使用笔记本的USB口供电，USBY3x0系列，请不要使用任何转接线或延长线所用的版本为2015及以上相关的文件 结构， ieee802_11a\IEEE802.11aieee802_11n\IEEE802.11nsingle\单个模块测试cascade\多模块级联测试yunsdr_api.hyunsdr_api.dll本节例程使用single 。发送端主函数为tx_tcpip_test_dac.m，接收端主函数为带宽等射频参数，可以根据实际所需灵活配置，接口通过socket提供给PC端。程序会生成归一化的数据帧（基带IQ数据），需要根据DAC的采样位宽将归一化ADI公司的AD9361全集成IC，集成的DAC位宽12bit16bit4位补零。16bit的数字量范围-32768~32767(最是符号位)，首先分别寻找归一化I和QMAXI和MAXq，并取他们中较大的那个作为最大值MAXI&Q计算放大系数量化到±200016bit位宽数据。发端程序代码中，有一个yunsdr_init结构体的变量，用于配置板卡参数，各个成员的含义及参数范围305成含说设备IP必须和TF卡中autostart.shfdd，tdd模式择‘FDD’全双工模‘TDD’‘TX’（发送）RX’（接收天线开关，FDD时一直为TX。TDDTX2_CHANNEL（通道二TX_DUALCHANNEL（双通道INTERNAL_REFERANCE（内部参考时钟EXTERNAL_REFERANCE（外部参考时钟AUXDAC1，内部DAC电压校准晶ADF4001，参考时钟鉴相器校准晶当选择内部DAC‘START_TX_NORMALstream流式传输模式，通常用于实时产生数据流连续发送，通常用于Capi‘START_TX_LOOPLOOPback循环发送模式，用作信号源功能，API工作模式‘START_TX_BURST’:Burst突发模式，在规定的时START_TX_NORMAL和START_TX_LOOP为每次发完数据后的等待时间单位‘PPS_ALL_DISABLE’:关闭PPS‘PPS_INTERNAL_EN’:使用内部GPS的PPS信号‘PPS_EXTERNAL_EN’:使用外部PPS信收端程序代码中，也有一个yunsdr_init结构体的变量，用于配置板卡参数（收发端6成含说设备IP必须和TF卡中autostart.sh4e6~61.44e6Hz如果是单个YunSDRRF_GAIN_MGC,手RF_GAIN_SLOWATTACK_AGC自动慢RF_GAIN_FASTATTACK_AGC,RF_GAIN_SLOWATTACK_AGC自动慢0~70dB步进10~70dB步进fdd，tdd模式选‘FDDTDD’‘TX’（发送）,’RX’（接收）与发送端相RX2_CHANNEL（通道二RX_DUALCHANNEL（双通道AUXDAC1，内部DAC电压校准晶当选择内部DAC‘START_RX_BULK’:在直接开始接‘START_RX_BURST’:在指定的时刻接‘PPS_ALL_DISABLE’:关闭PPS‘PPS_INTERNAL_EN’:使用内部GPS的PPS信号‘PPS_EXTERNAL_EN’:使用外部PPS信号单音信号自收发测source变量定义数据类型，即要发送的IQ数据类型，本例程包括：tone(单音号)，ieee802.11a，ieee802.11n3种类型，yunsdr_init.ipaddr配置YunSDR的ip地址，默192.168.1.10。31yunsdr_init结构体配置了AD9361的各种参数，例如采样率、带宽、射频频点、增益等。最后会调用send_to_yunsdr函数，将数据发给设备。注意：第一次打开运行发送端程序，会自动加载C的运行库，会比慢，请等待发送端程序完全执行完成()再运行接收端。运行库加载后以后运行很快。需要说明的是，本案例是采用SMA直连回环收发，因此发送衰减要设置大一些，

32data_type对应接收的数据类型，对应于发送端的source。yunsdr_init.rxsamples指定33测试方式为一台Y320单音信号自收发，两个收发通道使能，SMA30dB10dB34IEEE802.11a物理层测IEEE802.11a的物理层演示代码，发送端source='ieee802_11a';%tonewidebandieee802_11aieee802_11ndata_type='ieee802_11a';%plotieee802_11a802.11a测试方式为SMA直连，各个参数的配置和单音信号测试没有区别。

35IEEE802.11acommand窗口会打印数据的36IEEE802.11a示例是QPSKrx_tcpip_test_adc.mrate参数11a源代码文件中的ieee802_11a_tx_func.m例如rate=24，对应16QAM，其他均不需要改动。重新运行发端和收端代码37IEEE802.11aIEEE802.11n物理层测使用一台y320，两个收发通道均使能，可以测试MIMO2*2选择IEEE802.11n接收数据选择IEEE802.11n测试方式为SMA直连，各个参数的配置和单音信号测试没有区别。

38IEEE802.11n界面会显示各个关键同步过程中的处理信号流程，同时commandcrc39IEEE802.11n修改不同的mcs值，可改变不同的调制速率，具体请参见IEEE802.11n多模块级联

40IEEE802.11n本部分主要介绍应用YunSDRY320戳同步的参考设计测试与开发应用，多个模块可以组成分布式系统或者massivemimo应用。如果用户需要了解Y320的硬件特2.1节部分的内容。时戳同步主要特点Y320SGPSY320GPS时钟模块，选配1to10IQ数据帧中，通过1000MFPGA、ARMYunSDRY320S内置GPS特性1pps10MHz系统时钟，与1pps32颗同秒脉冲10msGPS模块输入端LNA增益范围YunSDRY320配合时钟分配板特性Y320SGPSGPS10MHz内部26MHzSMA接口时钟输入（最高200MHz时钟频率1PPSGPSGPS1PPSLVTTL3.3V宽电源供电范围：5-12V时戳同步机制特AD9361TCXOGPSIQ时戳计数位宽64ad9361MIMO4x4多模块级联工作流YunSDRPCYunSDR，YunSDR1PPSYunSDRPPSYunSDR发送数据流程，PC程序其中一台YunSDR的当前时戳值，然后PC程序以YunSDRYunSDR到达时间点将自动发送数据。接收数据流程，PC程序其中一台YunSDR的当前时戳值，然后PC程序以当述结构，YunSDRPC。线程线程是否41线程线程是否多模块级联应用连

42时戳同步硬件有两种版本Y320Y320S。Y320没有内置GPS，Y320s含有内置GPS模块。Y320S主要应用于外场分布式同步系统（可以安装GPS天线接收同步信号）；Y320可以配合时钟分配模块（YUN-10）进行同步，可以应用于室内等GPS信号受限的场合。时钟分配模块本身内置有GPS模块，所以Y320与Y320S可以混合组成分布式同步系统。测试系统除了YUNSDR模块还需要千兆网交换机一个，如果需要43Y320S44Y320+本例以4台Y320配合时钟分配器组成4*4系统进试。测试之前要配置4台设备的IP地址为不同，如下图在TF卡中修改autostart.sh文件：图454台设备的IP4YunSDR的ip192.168.1.41192.168.1.42、192.168.1.4346我们使用SMA线直接连接YunSDR的射频端口，具体的连接方式是：board1的TRX1连board2的RX1，board1的TRX2连board2RX2，board2的TRX1连board1的RX1，board2的TRX2连board1RX2，board3和board4的连接方式相同。47

48491PPS和参考CLOCK1PPS的输出端，将其中四个端口用较长的SMA4个YunSDR1PPS的输入端口；下面一排为参考时钟CLKOUT的输出端，将其中四个端口用较长的SMA4个YunSDRREFIN的输入端口。另外需要一台千兆网交换机（通用的商业交换机即可）来连接YunSDR与5044个YunSDR图51交换机与YunSDR全部连接完毕并且上电启动之后，4台Y3201HZ的频率闪烁，颜色为黄色时戳同步代码时戳控制系统提供参考设计，可以完成若干个Y320(S)模块的时戳同步检测功能，此外参考设计将时戳控制与数据收发功能封装了若干个子函数(function)，方便用户进行调用。本节对参考设计与子函数的使用进行描述。参考设计包含ad9361配置，时戳控制，IQ数据收发，产生数据源，接收数据处理等几个功能。其中IQ数据的生成包括单音信号和IEEE802.11n2x2数据源文件的读取两种。接收数据分析也包括单音信号的画图，与IEEE802.11n2x2数据的同步检测功7成含说设备IP针对每一块设备，配置不同的IP内置GPS802.11n初始化相关lib输入参数为每一个板卡设备对应的init设备对应的initPPS_INTERNAL_EN：内置GPS模块的级输出参数为每个YunSDR程序以最后一个时戳为基准初始化相关lib输入参数为每一个板卡设备对应的init输出参数为每个YunSDR程序以最后一个时戳为基准从YunSDR数单音信号测试使用时戳测试工程，采用单音信号数据源。通过测试各个Y320(S)是否同间隔循环发送。若干个接收端在规定的时刻开始接收指定长度的IQ数据。将所有模块收到的IQ数据显示，此外还可以计算单音信号的起始点，就可以判断每个Y320(S)是否首先运行发送端tx_tcpip_test_dac，之后运行收端接收端显示如下：左面显示IQ时域信号，右面显示IQ的模值，可以看到每个设备MIMO4*4收发同步测

52使用两台y320，测试MIMO4*4，程序配置如下：100次，取EVM结果进行绘图，纵坐标dB，横坐标次数。53MIMO4*454MIMO4*4结果分析：四个通道的平均回环EVM为- （dB）4X4收发回环大于-28（dB）的要求。同时在command命令行会显示接收数据的crc1，说明能够解调数据，时戳同步工作正常。同样可以得出四个模块的平均频偏分别为：-17.7092-1.993332.957732.3113（Hz），对应本振频率2500MHz，则计算时钟稳定度为：-0.0071-0.00080.01320.0129（ppm），此Capi应威视锐提供C编写的API和demo程序。用户可以在Windows/Linux下调用做二次开发。YunSDR的发送端支持三种模式：Loopback（应用中用到，循环发送指定序列）；streaming，流模式可以从上位机持续发送IQ数据给YunSDR；Burst，突发模式，上位机可以指定YunSDR在规定的时刻发送一定长度的IQ数据。YunSDR的接收端有两种工作模式：Streaming及时数据发送给PC；Burst在规定的时刻开始数据发送给PC。所有收发的IQ数据都由帧头打包，插入帧头的频率由用户可以自定义。本节主要介绍C端API和DEMO的开发环境搭建与运行流程环境实例中采用eclipse+MinGWEclipse：luna以上版本eclipse-cpp-luna-win32-x86_64.zipMinGW：GCC4.6.2以上版本图55Eclipse地完成后解压至eclipse-cpp-luna-win32-x86_64MinGW安装程序：图56双击安装57C:/MinGW，安装完成后,eclipse的调用，省去环境变量的配置，可以将整个MinGWeclipse-cpp-luna-win32-x86_64/eclipse文件编译

58Eclipse打开eclipse，选择一个59workspace下面可以选择导入现有的demo3.2.2导入DEMO工将光盘内提供的yunsdr_ben ark代码解压拷贝到新建的Workspace(yunsdr_ ark是一个完整的eclipseproject),利用eclipse的import功能导入workspace即60解压工程文件到图61图62图63新建工图64图65选择GCC新建的project，选择6667编译工

68在Project属性中配置ws2_32和pthreadGC2两个69Project70工程的运行与参数配

71编译完成后的exe位于 下，以便于正确运行程序，需要将随代码提供pthreadGC2.dll和config.json文件拷贝到与exe相 下config.json为程序运行参数和板卡默认配置参数，参数范围见附录射频参数描述；"ipaddr"为板卡IP"datafile":为默认的数据源文件，IQ7273config.json在代码的test_rx.c和test_tx.c能7475main.c中可以控制rx的测试和tx76在命令提示符中运行yunsdr_ben ark.exe，程序可以自动连接板卡，IP地址是由config.json文件中指定，tx测试可以通过频谱仪等工具观测到测试现象，rx测试可以保771YunSDRAPI概32bit，双通道每个采样点为参数：ticksDLLEXPORTuint64_tyunsdr_ticksToTimeNs(constuint64_tticks,constdouble32bit，双通道每个采样点为参数：timeNs：时间量，纳秒DLLEXPORTuint64_tyunsdr_timeNsToTicks(constuint64_ttimeNs,constdouble描述：打开yunsdr设备参数：ip：设备IP返回值：yunsdrDLLEXPORTYUNSDR_DESCRIPTOR*yunsdr_open_device(constchar描述：关闭yunsdr 返回值：成功返回0，失败返回非零值DLLEXPORTint32_tyunsdr_close_device(YUNSDR_DESCRIPTOR描述：参数：yunsdrchRX1_CHANNEL，RX2_CHANNELgain_dbDBDLLEXPORTint32_tyunsdr_set_rx_rf_gain(YUNSDR_DESCRIPTOR*yunsdr,RF_CHANNELch,int32_tgain_db);描述：参数：yunsdrDLLEXPORTint32_tyunsdr_set_rx_rf_bandwidth(YUNSDR_DESCRIPTOR*yunsdr,uint32_tbandwidth_hz);描述：设置接收采样频率参数：yunsdr：设备描述符DLLEXPORTint32_tyunsdr_set_rx_sampling_freq(YUNSDR_DESCRIPTOR*yunsdr,uint32_tsampling_freq_hz);描述：设置接收中心频率参数：yunsdr：设备描述符DLLEXPORTint32_tyunsdr_set_rx_lo_freq(YUNSDR_DESCRIPTOR*yunsdr,uint64_tlo_freq_hz);描述：设置接收增益控制模式参数：yunsdr：设备描述符chRX1_CHANNEL，RX2_CHANNELgc_modeRF_GAIN_MGC，DLLEXPORTint32_tyunsdr_set_rx_gain_control_mode(YUNSDR_DESCRIPTORRF_CHANNELch,RF_GAIN_CTRL_MODE描述：参数：yunsdrchTX1_CHANNEL，TX2_CHANNELattenuation_mdbmDBDLLEXPORTint32_tyunsdr_set_tx_attenuation(YUNSDR_DESCRIPTOR*yunsdr,RF_CHANNELch,uint32_tattenuation_mdb);描述：参数：yunsdrDLLEXPORTint32_tyunsdr_set_tx_rf_bandwidth(YUNSDR_DESCRIPTOR*yunsdr, 描述：设置发送采频样率参数：yunsdr：设备描述符DLLEXPORTint32_tyunsdr_set_tx_sampling_freq(YUNSDR_DESCRIPTOR*yunsdr,uint32_tsampling_freq_hz);描述：设置发送中心频率参数：yunsdr：设备描述符DLLEXPORTint32_tyunsdr_set_tx_lo_freq(YUNSDR_DESCRIPTOR*yunsdr,uint64_tlo_freq_hz);描述：设置射频参考时钟参数：yunsdr：设备描述符selectINTERNAL_REFERENCE0DLLEXPORTint32_tyunsdr_set