专栏首页数字积木ADRV9009_API功能描述

ADRV9009_API功能描述

ADRV9009是一款高集成度射频(RF)、捷变收发器,提供双通道发射器和接收器、集成式频率合成器以及数字信号处理功能。这款IC具备多样化的高性能和低功耗组合,以满足3G、4G和5G宏蜂窝时分双工(TDD)基站应用要求。

应用

  • 3G、4G和5G TDD宏蜂窝基站
  • TDD有源天线系统
  • 大规模多路输入、多路输出(MIMO)
  • 相控阵雷达
  • 电子战
  • 军事通信
  • 便携测试设备

下面介绍ADI提供的adrv9009_API功能描述。

源代码链接如下:https://github.com/analogdevicesinc/no-OS/blob/master/drivers/rf-transceiver/talise/api/talise_radioctrl.h

talise_radioctrl.h

1, uint32_t TALISE_loadStreamFromBinary(taliseDevice_t *device, uint8_t *binary);

描述:将二进制数组加载到流处理器数据内存中。

限制:此函数在设备初始化并验证PLL锁定状态后调用。

2, uint32_t TALISE_setArmGpioPins(taliseDevice_t *device, taliseArmGpioConfig_t *armGpio);

描述:指示用于TDD引脚控制的GPIO引脚,此功能应在radio关闭状态下使用。

限制:此函数可以在加载Talise ARM二进制文件后调用,但在初始化期间进入radioOn之前。

3, uint32_t TALISE_setRadioCtlPinMode(taliseDevice_t *device, uint8_t pinOptionsMask, taliseRadioCtlCfg2_t orxEnGpioPinSel);

描述:设置引脚模式控制的Tx、Rx和ORx 控制位掩码。此功能应在radio关闭状态下使用。

限制:此函数可在设备在运行时操作期间的任何时候完全初始化后调用,但要在配置了ARM和GPIO之后。

4, uint32_t TALISE_getRadioCtlPinMode(taliseDevice_t *device, uint8_t *pinOptionsMask, taliseRadioCtlCfg2_t *orxEnGpioPinSel);

描述:读取引脚模式控制的Tx、Rx和ORx 控制位掩码。此功能应在radio关闭状态下使用。

限制:此函数可在设备在运行时操作期间的任何时候完全初始化后调用,但要在配置了ARM和GPIO之后。

5,uint32_t TALISE_setOrxLoCfg(taliseDevice_t *device, const taliseOrxLoCfg_t *orxLoCfg);

描述:ORx LO(本机振荡器)源(RFPLL或AuxPLL)设置。

限制:这个函数应该在加载ARM之后,但在运行初始化校准之前调用。AuxLO频率也必须在设置RFPLL频率后,但在初始CAL之前设置。此函数可以在ARM READY(init cals之前)或Radio off状态下调用。

6,uint32_t TALISE_getOrxLoCfg(taliseDevice_t *device, taliseOrxLoCfg_t *orxLoCfg);

描述: 读取ORx LO(本机振荡器)源(RFPLL或AuxPLL)设置。此函数可用于读回 TALISE_setOrxLoCfg()函数设置的 ORx LO 配置。

限制:在调用TALISE_setOrxLoCfg()之后,可以随时调用此函数。此函数可以在ARM READY(init cals(初始化校准)之前)或Radio off状态下调用。

7,uint32_t TALISE_radioOn(taliseDevice_t *device);

描述:指示ARM处理器将无线电状态移到打开状态。当ARM处于无线电打开状态时,启用的Rx和Tx信号链将通电,ARM跟踪校准将开始。要将此状态退出到低功耗脱机状态,请调用TALISE_radioOff()函数。

限制:此函数在设备初始化完成、所有PLL配置并锁定、多芯片同步(MCS)完成、JESD204B链路配置并可运行之后调用。

8,uint32_t TALISE_radioOff(taliseDevice_t *device);

描述:指示ARM处理器将无线电状态移到关闭状态。当ARM从Radio On状态移动到Radio Off(Idle)时,ARM跟踪校准停止,TxEnable/RxEnable等GPIO控制引脚将被忽略。这还将保持接收和发送链的电源关闭,直到再次调用TALISE_radioOn()函数。

限制:这个函数可以在TALISE_radioOn被调用前的任何时间调用。

9,uint32_t TALISE_getRadioState(taliseDevice_t *device, uint32_t *radioStatus);

描述:读取当前ARM的无线电状态。目前,radioStatus只返回低8位的数据,但定义为32位状态字,以允许将来扩展位字段。

限制:此函数可在设备完全初始化后随时调用。

10,uint32_t TALISE_setRxTxEnable(taliseDevice_t *device, taliseRxORxChannels_t rxOrxChannel, taliseTxChannels_t txChannel);

描述:此API将收发器中Rx/ORx/Tx信道设置启用或禁用。

限制:此函数可在进入radioOn后调用。在radioOff期间,所有发射和接收链都被强制关闭。

11,uint32_t TALISE_getRxTxEnable(taliseDevice_t *device, taliseRxORxChannels_t *rxOrxChannel, taliseTxChannels_t *txChannel);

描述:这个API读回收发器中通电的Rx/ORx/Tx信道。

限制:此函数可在进入radioOn后调用。在radioOff期间,所有发射和接收链都被强制关闭。

12,uint32_t TALISE_setTxToOrxMapping(taliseDevice_t *device, uint8_t txCalEnable, taliseTxToOrxMapping_t oRx1Map, taliseTxToOrxMapping_t oRx2Map);

描述:设置外部LOL初始化校准和跟踪校准的Tx到ORx外部信号路由。

限制:此函数可在ARM初始化和加载后调用。但是,在初始化校准运行之前,因为这同时用于外部LOL初始化和跟踪校准。

13,uint32_t TALISE_setRfPllFrequency(taliseDevice_t *device, taliseRfPllName_t pllName, uint64_t rfPllLoFrequency_Hz);

描述:设置RF PLL本机振荡器(LO)频率(RF载波频率)。

限制:此函数可以在ARM初始化后调用,并且设备必须处于radioOff状态。

14,uint32_t TALISE_getRfPllFrequency(taliseDevice_t *device, taliseRfPllName_t pllName, uint64_t *rfPllLoFrequency_Hz);

描述:获取PLL本机振荡器(LO)频率(RF载波频率)。此函数用于获取锁相环的当前频率。为期望的PLL频率传递一个taliserfllname_t枚举类型,以读取:RF_PLL、AUX_PLL或CLK_PLL。

限制:此功能可在设备初始化和配置PLL后使用。对于AUX U PLL或RF U PLL,ARM固件也必须加载并运行以读取PLL频率。

15,uint32_t TALISE_getPllsLockStatus(taliseDevice_t *device, uint8_t *pllLockStatus);

描述:检查PLL是否锁定。此函数通过pllLockStatus指针返回Talise PLLs的状态。pllLockStatus下uint8 UT值的3个LSB代表CLK PLL、RF PLL和AUX PLL的锁定状态。

限制:此函数可以在PLL配置和运行后的任何时候调用。

16,uint32_t TALISE_setRfPllLoopFilter(taliseDevice_t *device, uint16_t loopBandwidth_kHz, uint8_t stability);

描述:设置射频锁相环滤波器的配置。此函数已弃用,应改用TALISE_setPllLoopFilter,因为它允许设置RF或Aux PLL环路滤波器设置。

限制:他的函数可以在ARM初始化后调用,并且设备必须处于radioOff状态。此功能后必须有TALISE_setRfPllFrequency函数,以便使用新配置设置RF PLL。

17,uint32_t TALISE_getRfPllLoopFilter(taliseDevice_t *device, uint16_t *loopBandwidth_kHz, uint8_t *stability);

描述:获取RF PLL环路滤波器的配置。此函数已弃用。应改用 TALISE_getPllLoopFilter,因为它允许读取RF或Aux PLL环路滤波器设置。

限制:此功能可在设备初始化和配置RF_PLL后使用。ARM固件也必须加载并运行。

18,uint32_t TALISE_setPllLoopFilter(taliseDevice_t *device, taliseRfPllName_t pllName, uint16_t loopBandwidth_kHz, uint8_t stability);

描述:设置RFPLL或AuxPLL的环路滤波器带宽

限制:此函数可以在ARM初始化后调用,并且设备必须处于radioOff状态。此功能之后必须为所选PLL设置TALISE_setRfPllFrequency函数,以使用新的环路滤波器设置设置PLL。

19, uint32_t TALISE_getPllLoopFilter(taliseDevice_t *device, taliseRfPllName_t pllName, uint16_t *loopBandwidth_kHz, uint8_t *stability);

描述:获取RFPLL或Aux PLL循环筛选器的循环筛选器设置。

限制:该功能可在设备初始化并配置所需的锁相环后使用。ARM固件也必须加载并运行。

20,uint32_t TALISE_setOrxLoSource(taliseDevice_t *device, taliseObsRxLoSource_t orxLoSource);

描述:设置ORx LO(本机振荡器)源(RF PLL或Aux PLL)。注:此功能将ORx的本振源设置为RF PLL或Aux PLL,但在ORx上升沿接通ORx信道之前,该设置才生效。如果在ORx通电时改变LO源,则LO源在ORx被禁用并重新启用之前不会生效。这是有效的,当使用引脚设置本振源和控制时,也启用了ORx。

限制:此函数可在设备完全初始化且初始化校准已运行后使用。这只能在radio Off状态下调用。

21,uint32_t TALISE_getOrxLoSource(taliseDevice_t *device, taliseObsRxLoSource_t *orx1LoSource, taliseObsRxLoSource_t *orx2LoSource);

描述:获取ORx LO(本机振荡器)源(RF PLL或Aux PLL)

限制:此函数可在设备完全初始化且初始化CAL已运行后使用。这可以在radio Off 或 On 状态下调用。

22,uint32_t TALISE_setFhmConfig(taliseDevice_t *device, taliseFhmConfig_t *fhmConfig);

描述:此功能配置跳频触发GPIO输入到ARM和跳频范围。FHM触发器GPIO引脚、跳频最小频率和跳频最大频率由该功能配置。FHM(frequency hopping mode ,调频模式)。

限制:此功能可在设备完全初始化和ARM处理器初始化后使用。此函数只能在radio Off状态下调用。

23,uint32_t TALISE_getFhmConfig(taliseDevice_t *device, taliseFhmConfig_t *fhmConfig);

描述:此函数用于检索当前FHM设置。FHM(frequency hopping mode ,调频模式)。此功能读回跳频触发GPIO引脚、跳频最小频率和跳频最大频率。

限制:无。

24,uint32_t TALISE_setFhmMode(taliseDevice_t *device, taliseFhmMode_t *fhmMode);

描述:此功能设置跳频模式。

限制:此函数可在设备完全初始化、ARM处理器初始化并调用TALISE_setFhmConfig()之后使用。此函数只能在radio Off状态下调用。

25,uint32_t TALISE_getFhmMode(taliseDevice_t *device, taliseFhmMode_t *fhmMode);

描述:此函数用于检索跳频的当前FHM模式设置。此功能可用于读取当前FHM配置(FHM启用/禁用、MCS同步和退出模式设置的当前状态)。

限制:无。

26,uint32_t TALISE_setFhmHop(taliseDevice_t *device, uint64_t nextRfPllFrequency_Hz);

描述:此函数设置下一个RF PLL低跳频率,并在非gpio模式下向ARM发送跳到下一个频率的命令。

限制:此函数可在设备完全初始化、ARM处理器初始化、FHM配置通过TALISE_setFhmConfig()API设置、FHM模式通过TALISE_setFhmMode()API设置后调用。此API只能在Radio ON状态下调用。

27,uint32_t TALISE_getFhmRfPllFrequency(taliseDevice_t *device, uint64_t *fhmRfPllFrequency_Hz);

描述:此功能允许用户在跳频模式下读回当前射频锁相环频率。

限制:无。

28,uint32_t TALISE_getFhmStatus(taliseDevice_t *device, taliseFhmStatus_t *fhmStatus);

描述:此函数返回当前FHM状态。此功能可用于读取当前FHM状态。状态字段的详细说明请参见taliseFhmStatus结构定义。

限制:无。

29,uint32_t TALISE_setExtLoOutCfg(taliseDevice_t *device, uint8_t enableExtLoOutput, taliseExtLoDiv_t extLoOutDivide);

描述:此功能启用/禁用外部LO输出并设置外部LO输出分配器。

限制:无。

30,uint32_t TALISE_getExtLoOutCfg(taliseDevice_t *device, uint8_t *enableExtLoOutput, taliseExtLoDiv_t *extLoOutDivide);

描述:此功能读回外部LO输出和外部LO输出分配器设置的启用状态。

限制:无。

本文分享自微信公众号 - 数字积木(ggreat-top),作者:巩文红

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-12-17

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 浅谈Slick(1)- 基本功能描述

       Slick (Scala language-integrated connection kit)是scala的一个FRM(Functional Relat...

    用户1150956
  • Linux电源管理(11)_Runtime PM之功能描述

    终于可以写Runtime PM(后面简称RPM)了,说实话,蜗蜗有点小激动。因为从个人的角度讲,我很推崇使用RPM进行日常的动态电源管理,而不是suspend机...

    233333
  • Treevalue(0x01)——功能概述

    Treevalue v1.0.0版本已经于2021年10月24日正式发布,欢迎下载体验:opendilab / treevalue。

    HansBug
  • ansible之playbook功能简述

    playbooks剧本简介 playbooks是ansible更为强大的配置管理组件,实现基于文本文件编排执行的多个任务,且多次重复执行。其是使用YAML(Ye...

    小小科
  • photoshop 填充以及描边功能

    上一篇photoshop 选区操作介绍基本介绍了选区的使用方式,也简单介绍了一下填充的做法,那么本篇章再具体讲下选区之后的填充以及描边这两个功能。

    Devops海洋的渔夫
  • ionic2实现扫描二维码功能

    用户1437675
  • Android实现扫描二维码功能

    本文实例为大家分享了Android实现扫描二维码的具体代码,供大家参考,具体内容如下

    砸漏
  • 扫描识别行驶证的功能

    随着“互联网+”的在个各行业的应用,汽车后市场也取得了长足的发展,目前优信拍,神州租车、易车、滴滴、瓜子、人人车等以服务为主的互联网企业也如雨后春笋般不断出现在...

    ocr识别算法专家
  • 【译】Chrome的新功能:CSS概述

    这是Chrome中一个实验性的新奇功能,我们可以通过这个能力来获取一个网站上CSS的使用情况——从使用了哪些色值到未使用的声明数量,甚至是已定义的媒体查询总数等...

    腾讯IVWEB团队
  • EasyNVR3.0功能概述--直播录像

    对于摄像机直播已经是我们司空见惯的需求,但是,许多用户在现有的直播的基础上更有录像的需求,并且有关于录像的删除定时等录像计划的需求,更有客户不仅需要这些功能,还...

    EasyNVR
  • SAP Marketing Cloud功能简述(二) : Target Group

    这个系列的第一篇文章 SAP Marketing Cloud功能简述(一) : Contacts和Profiles,我向大家介绍了SAP Marketing C...

    Jerry Wang
  • EMC Unity架构和增强功能概述

    EMC Unity是EMC最新发布的中端存储系列产品。Unity在简化管理、现代化架构设计、总拥有成本和灵活部署等方面建立了新的标准,满足大型或小型公司资源越趋...

    企鹅号小编
  • SAP Marketing Cloud功能简述(一)Contacts和Profiles

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。 ...

    Jerry Wang
  • SAP Marketing Cloud功能简述(一) : Contacts和Profiles

    Dong Grace是Jerry的同事,目前是SAP成都研究院数字创新空间团队的一名实习生,明年7月才毕业。这篇文章是Grace对SAP Marketing C...

    Jerry Wang
  • Android实现银行卡号扫描识别功能

    现在有好多扫描识别银行卡号的SDK都是收费的,但是也有不收费的,但是有一定的问题,就是那种印刷的银行卡号扫描不出来,希望哪位大神指导原因给解释下,这个不收费的S...

    砸漏
  • BlueScan:一款功能强大的蓝牙扫描器

    BlueScan是一款功能强大的蓝牙扫描器,广大研究人员可以使用BlueScan来扫描BR/LE设备、LMP、SDP、GATT以及相关的蓝牙漏洞。

    FB客服
  • Android studio 实现手机扫描二维码功能

    implementation 'cn.yipianfengye.android:zxing-library:2.2'

    砸漏
  • Hadoop YARN学习之组件功能简述(3)

    Hadoop YARN学习之组件功能简述(3) 1. YARN的三大组件功能简述: ResourceManager(RM)是集群的资源的仲裁者, 它有两部分:...

    王小雷
  • .NET开发框架(二)-框架功能简述

    本框架为响应式SPA框架,支持PC与手机端的屏幕自适应。手机展示效果视频在文章末尾查看。

    .Net框架学苑

扫码关注云+社区

领取腾讯云代金券