LIQUID INSTRUMENTS MATLAB API 集成保险丝
MATLAB API 迁移指南
将 Moku: Lab 升级到软件版本 3.0 解锁了许多新功能。 更新时，API 用户必须采取额外步骤将脚本迁移到新的 Moku API 包。 本迁移指南概述了 API 更改、版本 3.0 更新中提供的新功能以及任何向后兼容性限制。
超过view
Moku:Lab 软件版本 3.0 是一次重大更新，为 Moku:Lab 硬件带来了新的固件、用户界面和 API。 此次更新使 Moku:Lab 与 Moku:Pro 和 Moku:Go 保持一致，从而可以轻松地在所有 Moku 平台上共享脚本。 此次更新为许多现有仪器解锁了许多新功能。 它还增加了两个新功能：多仪器模式和Moku云编译。 还有一些细微的行为差异，请参见“向后兼容性”部分。
这是影响 API 架构的重大更新，因此新的 MATLAB API v3.0 包将不会向后兼容现有的 MATLAB 脚本。 如果 API 用户将 Moku:Lab 升级到版本 3.0，则需要将其脚本移植到新的 Moku API 包。 进行大量定制软件开发的 API 用户应仔细考虑移植现有代码所需的工作量。 Moku:Lab 1.9 不建议用于新部署，并鼓励所有客户升级。 如果升级后出现问题，用户可以选择降级到软件版本1.9。
本迁移指南概述了高级功能tagMoku:Lab 3.0 版的更新和潜在复杂性。 它还概述了升级 MATLAB API 的过程以及如何在必要时降级 Moku:Lab。
3.0版本新功能
新功能
软件版本 3.0 首次为 Moku:Lab 带来了多仪器模式和 Moku 云编译，以及整个仪器套件的许多性能和可用性升级。
多仪器并行模式
Moku:Lab 上的多仪器模式允许用户同时部署两台仪器以创建自定义测试站。 每个仪器都可以完全访问模拟输入和输出以及仪器插槽之间的互连。 仪器之间的互连支持高达 2 Gb/s 的高速、低延迟、实时数字通信，因此仪器可以独立运行或连接以构建先进的信号处理管道。 仪器可以动态地换入和换出，而无需中断其他仪器。 高级用户还可以使用 Moku Cloud Compile 在多仪器模式下部署自己的自定义算法。
Moku 云编译
Moku Cloud Compile 允许您在多仪器模式下将自定义 DSP 直接部署到 Moku:Lab FPGA 上。 使用a编写代码 web 浏览器并在云端编译； Moku Cloud Compile 将比特流部署到一台或多台目标 Moku 设备。
示波器
- 深存储模式：最多保存4M秒amp全 s 时每通道的字节数amp传输速率（500 MSa/s）
频谱分析仪
- 改善本底噪声
- 对数 Vrms 和 Vpp 刻度
- 五个新窗口函数（Bartlett、Hamming、Nuttall、Gaussian、Kaiser）
相位表
- 频率偏移、相位和 amp纬度现在可以作为模拟音量输出tag电子信号
- 用户现在可以向输出信号添加直流偏移
- 锁相正弦波输出现在可以倍频至 2 50x 或分频至 125x
- 改进的带宽范围（1 Hz 至 100 kHz）
- 先进的相位环绕和自动复位功能
波形发生器
- 噪音输出
- 脉宽调制 (PWM)
锁定 Amp扩音器
- 改善低频表现 锁相环 锁定
- 最小 PLL 频率已降至 10 Hz
- 内部 PLL 信号现在可倍频至 250 倍或分频至 125 倍以用于解调
- 相位值的 6 位精度
频率响应分析仪
- 最大频率从 120 MHz 增加到 200 MHz
- 将最大扫描点数从 512 增加到 8192
- 新动态 Amp纬度功能自动优化输出信号以获得最佳测量动态范围
- 新的 ln/ln1 测量模式
- 输入饱和警告
- 数学通道现在支持涉及通道信号的任意复数值方程，从而实现新型复传递函数测量
- 除了 dBm 之外，现在还可以用 dBVpp 和 dBVrms 测量输入信号
- 扫描进度现在显示在图表上
- 现在可以锁定频率轴，以防止长时间扫描期间发生意外变化
激光锁频/稳频器
- 改进的框图显示了扫描和调制信号路径
- 新的锁定装置tages 功能允许自定义锁定程序
- 改善低频表现 锁相环 锁定
- 相位值的 6 位精度
- 改善低频表现 锁相环 锁定
- 最小 PLL 频率已降至 10 Hz
- 这 锁相环 现在可以将信号倍频至 250 倍或分频至 0.125 倍以用于解调
其他
方程编辑器添加了对正弦函数的支持，可用于在任意波形发生器中生成自定义波形
转换二进制 LI file从设备下载时转换为 CSV、MATLAB 或 NumPy 格式
升级的API支持
新的 Moku MATLAB API v3.0 包提供了增强的功能和稳定性。 它将定期更新以提高性能并引入新功能。
向后兼容性限制
API
新的 Moku MATLAB API v3.0 包不向后兼容之前的 Moku:Lab MATLAB v1.9 包。 MATLAB 脚本参数和返回值完全不同。 如果您使用 Moku:Lab MATLAB 进行广泛的自定义软件开发，请考虑迁移所有软件以与新 API 兼容的影响。
虽然 Moku:Lab MATLAB 软件包将不再接收更新，但 Liquid Instruments 仍将继续为无法迁移到新 API 软件包的用户提供支持。
查找详细的前任amp新的 Moku MATLAB API v3.0 包中每个仪器的文件，作为将先前的 MATLAB 开发转换为新的 API 包的基准。
回归
用于数据记录的 RAM 磁盘
1.9 版有 512 MB file设备 RAM 中的系统，可用于记录高 s 的数据amp令率。 在 3.0 版本中，不再可以记录到 RAM。 要启用数据记录，需要 SD 卡。 相应地，最大采集速度也会发生变化。 版本 1.9 支持高达 1 MSa/s，而版本 3.0 支持高达 250 个通道 1 kSa/s 和 125 个通道 2 kSa/s。 即使速度较低且使用 SD 卡，也不再支持将多个高速日志保存到 RAM，然后将其复制到 SD 卡或客户端的工作流程。
数据记录到 CSV
1.9 版本能够将数据直接保存到 CSV file 记录时。 此功能在 3.0 版本上不直接可用。 工作流程包括保存 CSV 的用户file直接保存到 SD 卡，否则客户端现在需要首先转换二进制文件 file CSV，使用客户端应用程序或安装独立的液体仪器 File 转换器到他们用于数据处理的计算机上。
不向后兼容的更改
LIA 中的数据缩放
在版本 1.9 中，我们实现了数据缩放，以便将两个 0.1 V DC 信号相乘得到 0.02 V DC 输出。 在3.0版本中，我们对此进行了更改，使得结果为0.01V DC，这更符合客户的直观期望。
必须启用波形发生器输出才能用作调制源/触发
在版本 1.9 中，即使禁用了该通道的输出，也可以将不同通道的波形用作波形发生器中的调制或触发源。 版本中已删除此内容
- 想要进行交叉调制而不需要拔掉设备输出的用户需要调整他们的
木库 MATLAB API
Moku MATLAB API v3.0 包旨在为 MATLAB 开发人员提供控制任何 Moku 设备所需的资源，并最终能够将这些控件合并到更大的最终用户应用程序中。 新的 Moku MATLAB API v3.0 包提供以下功能：
- 功能齐全的前amp每个文件的 MATLAB 脚本
- 所有 MATLAB 脚本均附带注释，易于理解，可作为最终用户进行定制和修改的起点。
- 一组提供对 Moku 完全控制的功能
目前支持的仪器
- 任意波形发生器
- 数据记录器
- 数字滤波器相结合使用
- FIR滤波器生成器
- 频率响应分析仪
- 激光锁频/稳频器
- 锁定 Amp扩音器
- 示波器
- 相位表
- PID 控制器
- 频谱分析仪
- 波形发生器
- 多仪器并行模式
- Moku 云编译
安装
要求
- MATLAB 版本 2015 或更高版本
如果您已经安装了以前版本的 Moku MATLAB API，请在继续之前将其卸载。 您可以从附加组件管理器卸载该软件包。
- 通过“主页”>“环境”选项卡打开附加组件管理器。
- 搜索 Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
- 或者，您可以直接从 Liquid Instruments 下载工具箱 web网站 https://www.liquidinstruments.com/products/apis/matlab-api/。 如果执行此操作，您将必须手动设置搜索路径。
- 通过从“主页”>“环境”选项卡中选择“设置路径”，检查是否已将正确的路径添加到工具箱中。
- 确保有一个条目指向工具箱安装位置。 典型路径可能是 CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB。
- 下载仪器数据 file通过在 MATLAB 命令行窗口中输入 'moku_download####) 即可。 ### 应替换为您当前的固件版本。 Yol 可以通过 Moku：桌面应用程序找到您当前的固件版本，方法是右键单击您的 Moku 并将鼠标悬停在“设备信息”上，或者在 iPad 应用程序中长按您的 Moku。
- 在 MATLAB 命令行窗口中输入“help Moku”，确认您的工具箱设置正确。 如果此命令成功。 那么工具箱就已经安装成功了
Moku API 变更
新的 Moku MATLAB API 架构与其前身有很大不同，因此不向后兼容现有的 API 脚本。 以下简化的示波器示例amp该文件显示了旧版 API 包和新版 API 包之间的差异，并作为移植现有代码的路线图。
示波器前ample
步骤顺序
- 导入Moku MATLAB API 3.0
- 声明 Moku 所有权并将示波器比特流上传到
- 设置时基并设置时间轴的左右跨度。
- 获取数据，从示波器中获取单帧数据
- 通过放弃 Moku 所有权来结束客户端会话
上述序列是一个简化的例子amp文件来说明旧版和新版 API 包之间的差异。 除了开始客户端会话、将仪器比特流上传到 Moku 以及结束客户端会话之外，最终用户还可以按各种顺序执行任意数量的功能，以满足其应用程序的需求。
差异
在这里，我们查看两个 APl 之间序列中每个步骤的差异。
声明 Moku 所有权并将示波器比特流上传到设备。 与Moku MATLAB 1.9相比，新的API具有完全不同的功能：
| 木库MATLAB 1.9 | 木库MATLAB 3.0 | ||
| 功能 | 按名称获取() | 部署或连接() | 示波器() |
| 允许的字段和值 | 名称：字符串超时：浮动 | 仪器：希望部署的仪器的类别 | ip: 字符串 序列号: 字符串 |
| 力：布尔值 | set_default: booI | 强制连接：布尔值 | |
| use_externa I: 布尔 | 忽略忙碌：布尔值 | ||
| 持久状态：布尔值 | |||
| 连接超时：浮动 | |||
| 读取超时：浮动 | |||
- 设置时基。 功能相同，但允许的参数略有不同：
木库MATLAB 1.9 木库MATLAB 3.0 功能 设置时基() 设置时基() 允许的字段和值 t1：浮点 t2：浮点 t1：浮点 t2：浮点 严格：布尔 - 获取数据。 函数和允许的参数相同，但返回的数据类型和长度不同：
木库MATLAB 1.9 木库MATLAB 3.0 功能 get_data（） get_data（） 允许的字段和值 超时：浮动等待：布尔 超时：浮动 wait_reacquire：bool 返回长度 每帧16383点 每帧1024点 - 释放 Moku 所有权：
木库MATLAB 1.9 魔库API v3.0 功能 关闭（） 放弃所有权()
示波器功能列表
| 木库MATLAB 1.9 | 木库MATLAB 3.0 |
| 设置源O | 设置源O |
| 设置_triggerO | 设置_triggerO |
| 获取数据Q | 获取数据Q |
| 设置前端Q | 设置前端Q |
| set_default!tsQ set_timebaseO
设置x模式Q |
set_defau!tsQ set_timebaseQdisable_inputO |
| 设置精度模式Q | 设置采集模式Q |
| 同步相位Q | 同步输出相位Q |
| 获取前端Q | 获取前端Q |
| 得到_samp！rateO
get_rea!time_dataQ |
得到_samp！rateO
save_high_res_bufferO |
| gen_ramp波O
gen_sinewaveO |
生成波形O
get_acquisition_modeQ |
| gen_squarewaveQ | 获取资源Q |
| gen_offQ | 获取时基Q
get_output_!loadQ |
| 套amp学习Q
设置帧率Q |
get_interpolationO set_output_!loadQ |
| set_hysteresisQ
set_interpolationO |
|
| 设置输入衰减O | |
| 设置源O
osc_measurementQ |
|
| 总结Q |
Moku MATLAB API 基于 Moku API。 有关完整的 Moku API 文档，请参阅此处的 Moku API 参考 https://apis.liq uidinstrume nts.com/re fe re恩斯/.
有关 Moku MATLAB API 入门的更多详细信息，请访问 https://a pis.liquid instruments.com/sta 等级-Matlab。家
降级流程
如果事实证明升级到版本 3.0 会限制对您的应用程序至关重要的某些功能或产生其他不利影响，您可以降级到之前的版本 1.9。 这可以通过 web 瀏覽器。
步骤
- 联系 Liquid Instruments 并获取 file 适用于固件版本 9。
- 将您的 Moku:Lab IP 地址输入到 web 浏览器（参见屏幕截图）。
- 在更新固件下，浏览并选择固件 file 由液体仪器提供。
- 选择上传和更新。 更新过程可能需要 10 多分钟才能完成
© 2023 液体仪器。 预订的。
文件/资源
 |
LIQUID INSTRUMENTS MATLAB API 集成保险丝 [pdf] 用户指南 MATLAB API、MATLAB API 集成保险丝、集成保险丝、保险丝 |