使用脚本编辑器

介绍

本指南介绍了波形的使用脚本编辑器乐器。该仪器用于创建，运行和调试脚本，可以控制所有波形的其他乐器。

先决条件

指导

1.打开脚本编辑器

1.1

插入测试和测量设备，然后启动波形并确保设备连接。

如果在波形启动时没有设备连接到主机，则设备管理器将推出。确保插入设备并打开设备，此时它将出现在设备管理器的设备列表（1.）中。单击列表中的设备以选择它，然后单击“选择”按钮（2）以关闭设备管理器。

笔记：还列出了“演示”设备，其允许用户使用波形并在没有物理设备的情况下创建项目。

笔记：设备管理器可以通过点击屏幕右下角的“Connected Device”按钮(3)打开，也可以通过在屏幕上方的“Settings”菜单中选择“Device Manager”打开。

1.2

当Welcome页面加载后，在窗口左侧的仪表面板中，单击脚本按钮以打开脚本编辑器乐器。

1.3.

当脚本编辑器已打开，它将显示文本编辑器（1），在编辑器下方的输出面板（2），以及顶部的控制工具栏（3）。

2.使用脚本编辑器

本节介绍如何使用脚本编辑器．下面给出两个例子。脚本编辑器中还提供其他示例脚本。

示波器和波形发生器

2.1硬件设置

演示脚本编辑器， 这示波器和波形发生器将使用仪器。

对于使用MTE电缆的设备，首先，连接测试和测量范围通道1引脚(橙色线)到设备的波形发生器通道1输出引脚(黄色线)。对于使用差分输入通道的设备，确保将示波器通道1的负引脚(橙色线带白色条纹)连接到与波形发生器通道1相关的接地引脚(黑色线)。

如果您想使用BNC电缆，或您的设备不支持MTE电缆，请参阅使用示波器和/或使用波形发生器额外的信息。

2.2软件设置

为了脚本编辑器要使用仪器，它们必须在波形中打开。在Waveforms的“欢迎”选项卡中，打开示波器仪器，然后打开波形发生器乐器。它们的设置不需要更改。

返回到脚本标签查看脚本编辑器乐器。

打开范围和Wavegen实例脚本，通过从例子下拉。

在运行脚本之前，我们将简要讨论它的功能和工作方式:

  1. “clear”调用清空输出窗格中以前已打印的任何语句。
  2. 第二行检查是否示波器和波形发生器仪器已打开，如果缺少，则会抛出错误。
  3. 然后设置两个工具的几个选项。使用大多数默认选项，波形发生器通道1输出1KHz的正弦波，振幅1V，初始直流偏置0.5V。示波器触发器被设置为捕获输入信号上升到超过0V电平的重复触发事件。
  4. 接下来，两个工具都以“run”调用启动，其效果与跑每个仪器的按钮被按下。
  5. 剩下的步骤循环10次，每次迭代之间等待一秒 - 一旦传递给它的秒数，等待返回true。
  6. “scope1.wait”声明检查是否是示波器或脚本编辑器自脚本开始运行以来已手动停止仪器，如果不再运行，则抛出错误。
  7. 然后使用几个变量来存储示波器Channel 1上捕获的数据的一些测量值。在本例中，将打印“Middle”和“Average”度量值。
    • “中间”是仅捕获的最高和最低样本的平均值。
    • “平均值”是数据集中所有样本的平均值。
  8. 最后,波形发生器通过减去中间电压的一半来改变其直流偏置电压。

总结,波形发生器和示波器仪器配置，运行，并用于慢慢调整波形发生器的直流偏移，以便捕获数据的中间接近0V。

//此脚本根据示波器测量调整WaveGen偏移量。清晰的（的）如果（！（'wavogen1'在这的）||！（'范围1'在这的）的）扔请打开一个Scope和一个Wavegen仪器;Wavegen1。Channel1.．模式．文本=“简单”;Wavegen1。Channel1.．简单的．抵消．价值=0．5;范围1。触发．触发．文本=“重复”;Wavegen1。跑（的）;范围1。跑（的）;为了（varidx.=0.;等待（1的）&&idx.<10.;idx.++的）{//如果（！scope1.wait（））扔“停止”;var中间=范围1。Channel1.．措施（“中间”的）;var平均=范围1。Channel1.．措施（“平均”的）;打印（idx.+“中间:“+中间+“V”+“一般:“+平均+“V”的）;//调整Wavegen偏移量Wavegen1。Channel1.．简单的．抵消．价值- =中间/2;}

有关可用功能和对象的更多信息脚本编辑器可以在波形中找到帮助选项卡的脚本页面。脚本页没有涵盖的每个单独仪器的附加配置选项可以在这些仪器专用的页面中找到。

2.3运行脚本

通过单击屏幕顶部栏中的选项卡返回到Scripts页面。

单击运行（）按钮脚本编辑器TAB键开始运行示例。

中显示打印语句和未捕获的错误输出控制板。

2.4调试

如果在编写脚本的过程中，脚本需要逐步逐步查找错误，可以使用脚本编辑器的调试器。

调试是在波形内部完成的，允许用户逐步执行脚本。可以通过点击Debug ()按钮，它将使用Qt调试器工具打开一个新窗口。

协议分析器

2.1硬件设置

演示脚本编辑器， 这协议分析器仪器将用于传输和接收UART信号。

连接测试和测量设备的数字I/O通道0引脚(DIO0)到其数字I/O通道1引脚(DIO1)。

2.2软件设置

为了脚本编辑器利用协议分析器仪器，它必须在波形中打开。在Waveforms的“欢迎”选项卡中，打开协议仪器并打开UART发送和接收页面。它的设置不需要更改。

打开协议UART.实例脚本，通过从例子下拉。

在运行脚本之前，我们将简要讨论它的功能和工作方式:

协议分析器仪器配置为UART模式，用于发送和接收数据。首先，将字符串“Hello”发送，接收，并打印到输出窗格。使用字符串“hello”重复，将标签字符添加到末尾，以及指定为整数的数据数组。

//使用UART协议的脚本。如果（！（'协议'在这的）的）扔“请打开”协议“工具”;协议。模式．文本=“UART”//确保选择了UART选项卡协议。UART．接收机（的）//重置接收器协议。UART．发送（“你好”的）//通过结尾发送文本varRX.=协议。UART．收到（的）/ /接收文本打印（RX.的）协议。UART．发送（“你好 ”那错误的的）//发送文本自定义结尾varRX.=协议。UART．收到（的）/ /接收文本打印（逃脱（RX.的）的）协议。UART．Sendarray.（[1那2那3.那4.那5.那0.]那错误的的）//发送数组自定义结束varRX.=协议。UART．ReceiveArray（的）//接收数组打印（RX.的）

有关可用功能和对象的更多信息脚本编辑器可以在波形中找到帮助选项卡的脚本页面。脚本页没有涵盖的每个单独仪器的附加配置选项可以在这些仪器专用的页面中找到。

2.3运行脚本

单击运行（)按钮开始运行示例。

中显示打印语句和未捕获的错误输出控制板。

2.4调试

如果在编写脚本的过程中，脚本需要逐步逐步查找错误，可以使用脚本编辑器的调试器。

调试是在波形内部完成的，允许用户逐步执行脚本。可以通过点击Debug ()按钮，它将使用Qt调试器工具打开一个新窗口。

3.脚本编辑器用户界面概述

中的不同控件和特性脚本编辑器。

3.1控制工具栏

控制工具栏包含用于配置的菜单和控制接口脚本编辑器下面列出:

  • 调试：打开一个Qt脚本调试器窗口。
  • 跑:执行脚本。
  • 停止:停止调试或脚本的执行。为停止要工作，代码需要使用乐器.wait（）函数。
  • 中止：迫使执行立即停止。
  • 放大＆缩小：用于分别增加或减少代码编辑器的字体大小。
  • 清晰的：清除输出面板
  • 例子:包含一组使用各种不同工具的示例脚本。

3.2菜单栏

文件用于打开现有波形脚本编辑器项目，保存当前脚本编辑器项目，或关闭脚本编辑器．

编辑包含撤消和重做的按钮，以及为代码完成和查找和替换提供快捷方式的选项。

控制访问调试，运行，停止和中止操作。

看法有选项可启用输出面板和绘图窗口。

这窗户菜单可以用来访问其他仪器，波形主页和波形帮助。

3.3搜索工具栏

这个工具栏可以用来搜索脚本中的某些部分，并替换这些部分。属性打开输入字符串中的通配符支持设置图标。

3.4脚本编辑器

脚本编辑器是一个可以查看和编辑JavaScript代码的编辑器。

3.5输出面板

输出面板包含print（）语句和错误消息的结果。

3.6波形帮助页签

通过帮助在标签栏，波形帮助标签包含所有波形仪器的参考材料。

第四节,“代码”的帮助标签“脚本”页面记录了可以在波形脚本中使用的函数和对象API对于波形。

下一个步骤

有关如何使用DigInent测试和测量设备的更多指南，返回到设备的资源中心，从中链接测试和测量这个wiki的页面。

有关波形的更多信息，请访问波形参考手册．

如需技术支持，请访问测试和测量Digilent论坛的一部分。