t脚本归档 - Kvaser

Kvaser TRX和环境变量（3/3）

Magnus Carlsson — Tue, 15 Sep 2015 20:42:21 +0000

这是关于t程序环境变量3篇系列文章的最后一篇：

在环境变量系列文章的最后一篇中，我们将会看到如何使用Kvaser TRX将不同的环境变量进行交互。 Kvaser TRX是一个轻量IDE，用于开发Kvaser设备的t程序，并包含在CANlib SDK ¹中。完整的程序列表可访问http://github.com/Kvaser/developer-blog获取。

首先，我们通过使用Kvaser Eagle将能够运行t程序的设备连接到PC。现在我们启动Kvaser TRX并打开我们在本系列的第一篇文章里创建并保存在envvar.t中的t程序。我们通过选择File-> Open选项，然后浏览文件，选择文件，然后单击“Open”。

图1：启动Kvaser TRX，将Eagle分析仪连接到PC，加载文件envvar.t。

下一步是编译，下载和运行t程序。快速执行此操作的方法是按下Kvaser TRX工具栏上的“Play”’按钮。弹出的窗口将要求您保存新项目。您只需接受默认名称，然后单击“Save”。

一旦报文”Script no 0 started. proc=0″ 出现在下部窗格的“设备输出”部分中，即代表t程序开始启动。在模拟引导延迟之后，将出现一条新报文”Signal that we are ready to accept connections”，见图2。

图2：t程序已启动，我们可以在Kvaser TRX的“设备输出”选项中看到打印输出。

要查看环境变量，我们首先通过从菜单中选择Window-> Toggle Envvar窗口打开Envvar窗口。在Envvar窗口中，我们输入我们想要查看的环境变量的名称，然后单击“Add Envvar”，如图3所示。

图3：将环境变量HostIdConnected添加到Kvaser TRX中的Envvar窗口。

如果我们想看到在Envvar窗口中定期更新的环境变量的值，我们可以勾选“Auto Refresh”复选框，点击“Auto Refresh”之后，我们现在可以重新启动t程序（选择Run-> Stop然后再选择Run-> Start），并观察到t程序启动时HostIdConnected的值为1，并在报文“”Signal that we are ready to accept connections.”弹出时切换为0。这正如我们的预期结果，有关详细信息，请参阅t程序列表。

现在我们按照添加环境变量HostIdConnected的方式再添加两个环境变量，Severity和Message。

当一个环境变量被选择时，将会显示出一个状态行，其中会显示该环境变量的名称、类型和值。显示值的对话框被标记为“New Value”，提示您可以在此处输入新值，然后单击“Set Value”以更新所选环境变量的值，请参见图4。

状态行还显示出一个名为“Remove”的按钮，可用于从Envvar窗口中删除所选的环境变量。

图4：在Kvaser TRX的Envvar窗口中为环境变量 Message设置新值。

将Message的值更改为“My Message”，然后单击“Set Value”。除了在Envvar窗口中更新该值之外，我们还可以在运行的t程序中捕获到这次更改，并在Kvaser TRX窗口的下部窗格控制台中输入“Severity: 0 -My message”。

你还可以尝试并更改Severity。更改将在Envvar窗口中更新，但由于我们的t程序中没有与该环境变量有关的设置，因此控制台区域中不会发生任何更改。

作为练习，你可以尝试并更改环境变量HostIdConnected的值。为什么Envvar窗口不显示新值？我们提示您检查一下变量HostIdConnected的on envvar设置……

关于t程序环境变量的系列文章就此结束，希望您满意。如果您有任何意见，请发送邮件至support@kvaser.com和我们取得联系。

脚注：

¹关于CANlib SDK的更多信息，请访问http://www.kvaser.cn/developer/canlib-sdk/

The post Kvaser TRX和环境变量（3/3） appeared first on Kvaser.

从CANlib访问环境变量（2/3）

Magnus Carlsson — Thu, 10 Sep 2015 20:38:04 +0000

这是关于t程序环境变量3篇系列文章的第2篇：

环境变量简介
从CANlib访问环境变量
Kvaser TRX和环境变量

本系列的第一篇文章介绍了环境变量，以及如何在t程序中应用环境变量。第二篇将介绍如何使用CANlib访问环境变量。全部程序列表见http://github.com/Kvaser/developer-blog。

环境变量用于在不同的t程序之间通信，或者使用CANlib与PC通信。环境变量必须在t程序的envvar部分中定义。

为了从CANlib访问环境变量，你需要为环境变量设置句柄：

kvScriptEnvvarOpen (const int hnd, char *envvarName, int *envvarType, int *envvarSize)打开现有的环境变量，并返回句柄以及环境变量的类型和大小。为了使环境变量存在，环境变量必须在CAN通道句柄hnd指向的设备加载的t程序中定义。
kvScriptEnvvarClose :: (kvEnvHandle eHnd)关闭环境变量 (已使用kvScriptEnvvarOpen()打开)。

你需要记住环境变量的数据类型。如果尝试使用错误类型访问环境变量，则访问将失败。根据不同的数据类型，可以使用不同的函数访问环境变量：

kvScriptEnvvarSetInt :: (kvEnvHandle eHnd, int val)设置由eHnd指向的环境变量的值，其已定义为int。
kvScriptEnvvarGetInt :: (kvEnvHandle eHnd, int *val)检索定义为int的环境变量的值。
kvScriptEnvvarSetFloat :: (kvEnvHandle eHnd, float val)设置定义为float的环境变量的值。
kvScriptEnvvarGetFloat :: (kvEnvHandle eHnd, float *val)检索定义为float的环境变量的值。

环境变量也可以定义为长度高达ENVVAR_MAX_SIZE的char数组。为了减少传输的数据的大小，使用start_index和data_len来交换定义为char数组的环境变量。如果你已划分数据并知道你感兴趣的数据部分，这可能很有帮助。

kvScriptEnvvarSetData :: (kvEnvHandle eHnd, void *buf, int start_index, int data_len)设置定义为char数组的环境变量中的数据字节范围。
kvScriptEnvvarGetData :: (kvEnvHandle eHnd, void *buf, int start_index, int data_len) 从定义为char数组的环境变量中检索数据字节范围。

现在，我们从Python的角度尝试谈论一下t程序。

使用Python和环境变量

现在我们可以来测试在本系列第一篇文章中概述过的与一台运行t程序的设备进行交互。为了运行测试，我们需要运行包含在CANlib SDK v5.12中的环境变量的包装器。预发布版本见https://github.com/Kvaser/canlib-samples。

import time
import kvDevice

# Define some values and messages to send to our device
# In order to hide these secret messages, we write them encoded ;-)
messages = [(1, "-Jung unccraf gb n sebt'f pne jura vg oernxf qbja?"),
            (2, "-Vg trgf gbnq njnl."),
            (3, "-Jul jnf fvk fpnerq bs frira?"),
            (4, "-Orpnhfr frira 'ngr' avar."),
            (5, "-Jung vf gur qvssrerapr orgjrra fabjzra naq fabjjbzra?"),
            (6, "-Fabjonyyf."),
            (7, "-Jurer qvq lbh svaq gurfr?"),
            (8, "-uggc://jjj.ynhtusnpgbel.pbz/wbxrf/jbeq-cynl-wbxrf")]


# We will be using the first Eagle device found connected to the PC
# For an introduction to the kvDevice object, see
# http://www.kvaser.com/developer-blog/object-oriented-approach-accessing-kvaser-device-python-3-3/
eagle_ean = "73-30130-00567-9"
dev = kvDevice.kvDevice(ean=eagle_ean)

# Open a handle to the device
dev.open()

# Load the t program into slot 0
dev.channel.scriptLoadFile(0, "envvar.txe")

# Start the program in slot 0
dev.channel.scriptStart(0)

# Our protocol states that we should wait until HostIdConnected is zero before trying to connect
print "Waiting for device to be free..."
# All calls to the kvScriptEnvarOpen() and kvScriptEnvvarGetXXX() functions are hidden in the
# envvar class inside canlib.py. Here we can access it directly with dev.channel.envvar.YYY
while dev.channel.envvar.HostIdConnected != 0:
    time.sleep(0.2)

# Now we try to connect by writing our unique id into the environment variable HostIdRequest.
# We wait until our connection was accepted, i.e. HostIdConnected contains our id.
print "Requesting connection..."
myHostId = 42
print "Waiting for device to connect..."
while dev.channel.envvar.HostIdConnected != myHostId:
    if dev.channel.envvar.HostIdConnected == 0:
        print "Requesting connection..."
        if dev.channel.envvar.HostIdRequest != myHostId:
            dev.channel.envvar.HostIdRequest = myHostId
        time.sleep(0.2)
print "Connected!"

# Start sending our messages to the device
for (severity, message) in messages:
    print "Sending message %d" % severity
    dev.channel.envvar.Severity = severity
    dev.channel.envvar.Message = message.encode('rot13')
    time.sleep(4)

print "Disconnect..."
dev.channel.envvar.HostIdRequest = 0

# Stop the script in slot 0
dev.channel.scriptStop(0)

执行上面的Python代码会产生如下的标准输出：

Waiting for device to be free...
Requesting connection...
Waiting for device to connect...
Connected!
Sending message 1
Sending message 2
Sending message 3
Sending message 4
Sending message 5
Sending message 6
Sending message 7
Sending message 8
Disconnect...

我同意这并没有非常地激动人心，所以在本系列的最后一篇文章中，我们将一起看看如何使用Kvaser TRX与这些环境变量进行交互，Kvaser TRX是在Kvaser设备上开发t程序的轻量集成开发环境（IDE）。

The post 从CANlib访问环境变量（2/3） appeared first on Kvaser.

环境变量简介（1/3）

Magnus Carlsson — Tue, 01 Sep 2015 20:37:37 +0000

这是关于t程序环境变量3篇系列文章的第1篇：

第一篇文章介绍环境变量，以及如何在t程序中应用环境变量。

环境变量用于在不同的t程序之间通信，或者使用CANlib与PC通信。图表1展示了Kvaser设备上正在运行的三个脚本。当脚本1设置一个环境变量，其它脚本或使用了CANlib的电脑也可以读取新数值。除此以外，脚本可以设定一个钩子（hook），达到特定环境变量值时触发。

图表1：有关环境变量值的信息如何分布的概述。

术语“envvar”通常用作较长环境变量的简写。有关完整的文档，请阅读Kvaser t编程语言文档 ¹。

环境变量只能在t程序的envvar段中定义。就像在variables部分中定义的变量一样，环境变量在全局是可见的。这相当于在C程序中定义全局范围内的事项，即变量在声明和编译结束之间是可见的。

环境变量的类型可以是int，float或char数组。

envvar {
  char Message[128];
  int Severity;
  int HostIdRequest;
  int HostIdConnected;
}

环境变量的大小限制于ENVVAR_MAX_SIZE（t编译程序3.2版本中为4096字节），你最多可以定义32个环境变量。

与普通变量不同，环境变量不能在t程序中初始化或直接访问。相反，它们是使用envvarSetValue() 和 envvarGetValue()来访问的。

void setHostIdConnected (int value)
{
  hostIdConnected = value;
  envvarSetValue(HostIdConnected, value);
}

函数envvarSetValue()可以设置环境变量的值。实际的更新将需要排队，因此会被延迟，直到当前钩子的执行完成。环境变量已更新的通知随后将传播到已声明相同环境变量并具有相应的 on envvar钩子的所有程序。在此上下文中，更新包括与之前相同的值的设置。

由于环境变量的实际更新被延迟，因此可以在该延迟期间启动相同环境变量的新的更新。在这种情况下，较旧的值会丢失。所以每次你读取环境变量，你得到的都是它的最新值，如果你想确保能看到每次变化，你需要使用至少两个环境变量实施握手方案。

// Print incoming messages
on envvar Message {
  char msg[128];
  int severity;
  envvarGetValue(Message, msg);
  envvarGetValue(Severity, &severity);
  printf("Severity: %d - %s\n", severity, msg);
}

函数envvarGetValue()检索环境变量的最后一个已知值。如果环境变量未初始化，结果为未定义。完整的程序列表见http://github.com/Kvaser/developer-blog。

本系列的下一篇文章将阐述如何访问CANlib中的环境变量。

脚注：

¹ Kvaser t编程语言文档见http://www.kvaser.cn/downloads/#?filter=t%20programming.

The post 环境变量简介（1/3） appeared first on Kvaser.

t编程入门

Martin Henriksson — Wed, 29 Apr 2015 08:00:30 +0000

这是该系列文章中的第一部分。

新型Kvaser专业产品的脚本功能被命名位t。 t语言是一种面向事件的“c”语言。 t程序在设备上运行，可以从pc或设备上自动加载和启动。以下是t编程入门的简短介绍。

为了能够测试和运行t程序，你需要一个Kvaser Professional产品（* 1）。所需软件由CANlib开发工具包进行安装，称为Kvaser TRX。

要开始运行并编写你的第一个t程序，首先下载并安装 CANlib开发工具包 (点击下载)，然后启动TRX。

如图：

在标签中输入：

on start {
  printf("Hello World!\n");
}

这是非常基本的程序，对‘on start’事件做出反应，并在‘Device Output’中输出“Hello World！”。事实上设备发送“Hello World！”给计算机，TRX进行读取。

然后从菜单中选择Run-> Compile。为了能够编译，你首先必须保存t程序，TRX会提示你这样做，它也会提示你保存项目文件。我把它保存为blogpost1。

如果编译成功，下一步将需要一个真实的Kvaser professional 产品（*1）。

我连接上了Kvaser Eagle分析仪（查看产品）。你可以看到，TRX可以使用你的设备，因为菜单下的组合框有你的Kvaser设备名称。

要测试t程序，只需打开Run-> Download，这就会把t程序下载到设备。下一步就是真正地运行程序。 Run – > Run将启动应用程序，由此你就会在Device Output窗口中看到printf输出内容。

其它资源：

t语言详细描述见《Kvaser t编程语言规范》（点击查看）。

如果您有任何意见，请发送邮件至support@kvaser.com和我们取得联系。

The post t编程入门 appeared first on Kvaser.

t脚本 归档 - Kvaser