使用脚本编辑器

介绍

本指南解释了WaveForms的用法。脚本编辑器乐器。该工具用于创建、运行和调试脚本，这些脚本可以控制所有WaveForms的其他工具。

先决条件

指南

1.打开脚本编辑器

1.1

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

如果在WaveForms启动时没有设备连接到主机，则设备管理器就会启动。确保设备已插入并已打开，此时它将出现在设备管理器的设备列表(1.)。单击列表中的设备以选中它，然后单击select按钮(2.)关闭设备管理器。

注意:此外还列出了“DEMO”设备，允许用户使用WaveForms并在没有物理设备的情况下创建项目。

注意:设备管理器可以通过点击屏幕右下角(3.)的“连接设备”按钮，或者在屏幕顶部的“设置”菜单中选择“设备管理器”来打开。

1.2

一旦Welcome页面加载，在窗口左侧的仪表面板中，单击脚本打开脚本编辑器乐器。

1.3.

当脚本编辑器打开时，它将显示文本编辑器(1)、编辑器下方的输出面板(2)和顶部的控制工具栏(3)。

2.使用脚本编辑器

本节介绍如何使用脚本编辑器．下面是两个例子。其他示例脚本可在脚本编辑器中使用。

示波器和波形发生器

2.1硬件设置

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

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

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

2.2软件设置

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

返回到脚本选项卡以查看脚本编辑器乐器。

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

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

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

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

//该脚本根据Scope测量调整Wavegen偏移。清晰的（）如果（！（“Wavegen1”在这）||！（“Scope1”在这））扔请打开Scope和Wavegen仪器；Wavegen1。Channel1．模式．文本＝“简单”；Wavegen1。Channel1．简单的．抵消．价值＝0．5；Scope1。触发．触发．文本＝“重复”；Wavegen1。运行（）；Scope1。运行（）；为（varidx＝0；等待（1）& &idx<10；idx++）｛//如果(!Scope1.wait())抛出"Stopped";var中间＝Scope1。Channel1．测量（“中间”）；var平均＝Scope1。Channel1．测量（“平均”）；打印（idx+“中间:“+中间+“V”+“一般:“+平均+“V”）；//调整Wavegen偏移量Wavegen1。Channel1．简单的．抵消．价值- =中间/2；｝

的函数和对象的更多信息脚本编辑器可在“波形”帮助选项卡的脚本页面。脚本页面中没有涉及的每个单独仪器的其他配置选项，可以在专门用于这些仪器的页面中找到。

2.3运行脚本

通过单击屏幕顶部工具条中的Scripts选项卡返回到脚本页面。

点击运行()按钮。脚本编辑器选项卡开始运行示例。

打印语句和未捕获的错误显示在输出面板。

2.4调试

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

调试是在WaveForms本身内部完成的，允许用户逐步执行脚本。通过单击Debug (按钮，这将打开一个带有Qt调试器工具的新窗口。

协议分析器

2.1硬件设置

演示脚本编辑器,协议分析器仪器将用于发送和接收UART信号。

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

2.2软件设置

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

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

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

协议分析仪仪器配置为UART模式，用于发送和接收数据。首先，字符串“Hello”被发送、接收并打印到Output窗格。对于字符串“Hello”，在末尾添加一个制表符，以及指定为整数的数据数组，都会重复此操作。

//使用UART协议的脚本。如果（！（“协议”在这））扔“请打开协议工具”；协议。模式．文本＝“UART”//确保UART选项卡被选中协议。UART．接收机（）/ /重置接收机协议。UART．发送（“你好”）//发送有结尾的文本var处方＝协议。UART．收到（）/ /接收文本打印（处方）协议。UART．发送（“你好”，假）//发送文本自定义结尾var处方＝协议。UART．收到（）/ /接收文本打印（逃避（处方））协议。UART．SendArray（［1，2，3.，4，5，0］，假）//发送数组自定义结束var处方＝协议。UART．ReceiveArray（）/ /接收数组打印（处方）

的函数和对象的更多信息脚本编辑器可在“波形”帮助选项卡的脚本页面。脚本页面中没有涉及的每个单独仪器的其他配置选项，可以在专门用于这些仪器的页面中找到。

2.3运行脚本

点击运行()按钮以开始运行示例。

打印语句和未捕获的错误显示在输出面板。

2.4调试

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

调试是在WaveForms本身内部完成的，允许用户逐步执行脚本。通过单击Debug (按钮，这将打开一个带有Qt调试器工具的新窗口。

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

本节将介绍控件中的不同控件和特性脚本编辑器。

3.1控件工具栏

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

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

3.2菜单栏

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

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

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

视图具有启用输出面板和绘图窗口的选项。

的窗口菜单可用于访问其他仪器、WaveForms主页和WaveForms帮助。

3.3搜索工具栏

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

3.4脚本编辑器

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

3.5输出面板

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

3.6波形帮助选项卡

通过访问帮助在标签栏中，WaveForms帮助标签包含了所有WaveForms仪器的参考资料。

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

下一个步骤

有关如何使用Digilent测试和测量设备的更多指南，请返回设备的资源中心，从测试和测量这个维基的页面。

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

有关技术支持，请访问测试和测量部分Digilent论坛。