TOSUN同星TsMaster使用入门——3、使用系统变量及c小程序结合panel面板发送报文

本篇内容将介绍TsMaster中常用的Panel面板控件以及使用Panel控件通过系统变量以及c小程序来修改信号的值，控制报文的发送等。

目录

一、常用的Panel控件介绍

1.1系统——启动停止按钮

1.2 显示控件——文本框

1.3 显示控件——分组框

1.4 读写控件——按钮

1.5读写控件——输入输出框

1.6读写控件——开关

1.7读写控件——选择器

1.8读写控件——文件选择器

1.9显示控件——图形

1.10显示控件——指示灯

1.11显示控件——仪表

1.12显示控件——饼图

二、系统变量的创建与使用

2.1 系统变量的类型

2.2 用户变量的变量类型

2.3 创建系统变量

三、c小程序简单使用，c小程序发送报文

3.1 粘贴代码法

3.2 系统变量与panel，c小程序简单结合使用

---

一、常用的Panel控件介绍

在仿真菜单栏，点击面板下的箭头，创建一个新的面板

如图所示，是刚刚创建的空面板，在面板的右上角有着（工具箱，属性，对象）。

切换到工具箱视角

可以看到，工具箱内提供了许多的基础控件，我们可以基于这些系统提供的基础控件来实现一些需要的功能。

添加控件的方法：在工具箱选择空间后，按住鼠标左键不松，拖动到编辑区即可。

每个控件都有着各自的属性设置，当添加一个控件到编辑区之后，鼠标单击刚刚添加的控件即可显示这个控件的属性。

这里以静态文本框的属性界面为例，介绍一下控件的大多数通用属性。

从上往下依次是：

Align，控件的排列设置，可以设置控件在编辑区（工作区）内的排列位置。

bkgdColor，控件的背景颜色

bkgdOpacity，控件的背景不透明度，取值范围0~1（0完全透明，1完全不透明）

BorderActive，边界使能，如果为false，则控件不显示边框，为true显示边框。

Controlname，控件的名字

DisplayFormat，典型设置，没发现有什么作用（有大佬可以告诉我）

Enable，使能属性，如果为true，则可以响应鼠标和按键的操作，为false，则不响应

Height，控件的高度

Margins，控件的边距，用于设置此控件到父控件或者父控件内的其他控件的距离，一般不常用

Opacity，不透明度，同上面的

padding，控件的填充，用于设置的子控件到每个边的距离，一般也不用

Position，设置当前控件对于其父控件的位置

ReadOnly，如果设置为true，则只能显示不能编辑，为false可以编辑

RotationAngle，设置控件的旋转角度

Scale，设置控件的比例，也不怎么用

Text，控件显示的文字

TextColor，显示的文字的颜色

TextSetting，可以设置文本的样式

Transparent，设置透明度使能

VarLink，绑定的对象（可以是系统变量，信号等）

VarType，绑定的对象的类型

Width，控件的宽度

1.1系统——启动停止按钮

此控件的功能十分的粗暴，是用于在Panel面板上控制TsMaster工程的启动与停止的，无需其他额外属性。

添加一个启动停止按钮在Panel面板上。随后点击左上角的铅笔，退出编辑模式。

当TS工程处于未启动状态时，Panel控件上的启动停止按钮式一个链接的图标（样式同TS左上角的启动图标）。

当我们点击一下Panel上的这个按钮，TS工程将被启动，并且启动后这个按钮图标将变为断开连接的图标（如图TS左上角的停止按钮）

此时再次点击Panel上的这个图标，TS工程将被断开。

1.2 显示控件——文本框

如图控件名称，文本框就是用来显示一段固定的标签文字的。

在属性栏的Text栏目中即可修改文本显示的内容。

修改后回车即可生效。

1.3 显示控件——分组框

此控件作用就是给出一个分组，可以将所需要分组的控件放在一个分组框中，便于提示用户这些控件用于操作一组xxx数据等

1.4 读写控件——按钮

按钮通常用于跟一个bool量或者一个整形变量进行绑定，当按钮按下时，绑定的对象值即为1或者其他设置值，当按钮松开后，绑定的对象值也不会恢复

可以通过设置varLink和vartype属性来设置按钮绑定的对象。

点击选择VarLink属性，VarLink属性后便会出现选择按钮，点击此按钮可选择绑定的对象，这里我以一个事先创建了的系统变量为例。

选择对应的对象类型，选择完毕后点击确定

绑定完成，看看效果。

按钮未按下时，对应的变量值为0，按下后松开，变量的值变为了1，且不会恢复为0

其具备一个名为ValuePushed的属性，可以设置当按钮按下时对应的变量改变的值。

1.5读写控件——输入输出框

输入输出框可以用于信息的输入输出，通常适用于输入字符串，输入数字等。

同样的，这里我创建一个输入输出框，并将其绑定为我的系统变量。

当输入0时，我绑定的系统变量值变为0，当输入5时，我绑定的系统变量值变为5

1.6读写控件——开关

开关一般用来跟可以表示两种状态的信号或者变量进行绑定，这个控件具备两个可以修改的属性，

ValueLeft和ValueRight

当开关的焦点的左侧时，对应的值为ValueLeft，当开关焦点在右侧时，对应的值为valueRight

如图我的左值和右值分别为0和1。所以当我的开关焦点在左侧时，变量的值为0，在右侧时，变量值为1.

接着，我们可以修改下这个开关的左值和右值看看。

如图，我为这个开关设置了两个新的左值和右值，再次操作开关，对应变量的值也会随之改变。

1.7读写控件——选择器

选择器可以根据绑定的变量（信号，本文中统一使用变量表示）的取值表，生成一个下拉框，并在下拉框中显示对应的取值表。

创建一个选择器，并将选择器绑定一个具有取值表的变量。

这里我选择绑定一个can信号，

绑定完成后点击下拉箭头，即可看到绑定的变量的取值表，并且当修改下拉选项时，被绑定的变量值也将发生改变。

当我的选择器下拉列表选择的时NoReq时，我绑定的CAN信号值也为NoReq（0）

当我将下拉选择器改为doorOpen时，对应的信号值也变为了doorOpen（1）

1.8读写控件——文件选择器

此控件的作用为点击后弹出一个对话框用于选择一个文件，并且会将选择的文件路径返回给绑定的字符串类型变量

创建一个文件选择器，随后为其绑定一个String类型系统变量

当未选择文件时，路径处为0，随后启动TS工程，点击文件选择器，选择一个文件

选择完毕后，字符串变量的值就变成了刚刚选择的文件的地址。

1.9显示控件——图形

图形可以当做一个简单的Graphics窗口来使用

图形控件默认是2条信号曲线，如果需要修改信号的数量，可以通过修改SignalCount来设置

通过这个图形的属性我们可以看到，默认编辑的信号索引为0，即为这个图形控件关联变量时，关联的是索引为0的那条曲线（即第一条曲线）

现在我们添加两个信号来观察一下

选择varLink，关联第一个变量。

关联完成后，将EditSignalIndex修改为1即可编辑第二条曲线，这里修改一下，然后关联第二个信号

关联完成，可以看到图形上的两条曲线都有了名字

鼠标拖动图形右侧边界，将图形放大一些

运行工程，当两个信号值都是0的时候，图形上的曲线也保持为0，当这两个信号发生变化之后，图形上的曲线也同步发生了改变。

1.10显示控件——指示灯

指示灯是一个非常简单的控件，也主要用来绑定只有两种值的信号，与开关不同的是，它是只读的，用户没法改变他的状态。

其的属性中，ColorOff用来设置当指示灯关闭时的颜色，Color用来设置当指示灯打开时的颜色。。

ThresholdHigh和ThresholdLow用来设置高低阈值，当ThresholdMode设置为true时，只要绑定的变量值大于等于High值时，指示灯就打开，小于等于Low值时，指示灯就关闭。

ValueOn用来设置指示灯打开时的值（绑定的变量值等于该值时，指示灯亮起），需要ThresholdMode为false的前提下才有效。

绑定信号后，当信号值为0时，led熄灭，当值为1时，led亮起。

1.11显示控件——仪表

仪表就像一个汽车上的仪表一样，通常用来指示车速，电机的位置，车窗车门的开度等用于表示位置或者大小范围。

其中，属性AngleSpan用于设置仪表显示刻度的范围，即仪表最小值0~最大值之间的角度。

AxisIncrement用于设置刻度的细密度，默认为0，为0时系统自动调节细密度，当设置为非0时，需要手动调节，设置值越小，细密度越大。

MaxValue和MinValue用于设置仪表显示刻度的上下限值。

Showvaluemask用于设置仪表的当前值是否能显示出来

当绑定的变量值发生改变时，仪表控件上的值跟随变化，并且指针移动。

1.12显示控件——饼图

饼图可以用来表示两个或多个变量值之间的占比关系

属性EditSignalIndex表示当前编辑的变量的索引，索引为0表示第一个信号

SignalCount用于设置饼图中的变量数量

和图形控件一样，绑定多个信号需要一次修改索引后进行绑定。

这里我绑定两个信号，当信号值发生变化时，饼图关系也随之改变。由于我的信号值加起来总共6份，其中一个占5，一个占1。显示的饼图就是六等分，一个六分之五，一个六分之一的情景。

二、系统变量的创建与使用

2.1 系统变量的类型

TS的系统变量分为内部变量与用户变量两种，用户只能创建用户变量，内部变量是TS程序自己生成的，无权更改与使用。

在仿真菜单栏下，点击系统变量，打开系统变量视图。

左上角左侧是内部变量，右侧是用户变量。

2.2 用户变量的变量类型

用户变量类型跟常用的编程语言中的数据类型基本相同

int32——有符号32位整数类型

uint32——无符号32位整数类型

int64——有符号64位整数

uint64——无符号64位整数

uint8Array——无符号8位整数数组，即字节数组

int32Array——有符号32位整形数组

int32Array——有符号64位整形数组

double——双精度浮点型变量

doubleArray——双精度浮点型数组

String——字符串类型

2.3 创建系统变量

在空白处右击鼠标，选择创建用户变量，弹出的界面如图所示

名称：变量的名字，可在小程序和panel中访问

类别：类似于命名空间的概念，当设置得有类别名"a"的变量"name"时，变量名则为"a.name"，非必须

注释：变量的注释，用于描述这个变量，非必须

数据类型：变量的数据类型，用于定义变量表示数据的表示范围

单位：变量代表的数据的单位，非必须

小数点位数：如果为浮点数，表示的精度，非必须

格式化数据：变量的显示格式，和精度只能有一个生效，非必须

只读：设置为只读则只能通过小程序代码修改，无法在外部修改

记录：如果勾选，则此变量的值的变化会记录到log中

触发事件变化：如果取消勾选，则Panel绑定此值无法发生变化

取值表：该变量的每个不同的值代表的含义，通过取值表配置

点击配置取值表，可以在弹出的界面中设置取值表

如果配置了取值表，则Panel中关联时，如果变量值处于有取值表的值，则会显示取值表中对应值的描述（名称）。

三、c小程序简单使用，c小程序发送报文

TS的c小程序编程除去自身提供的函数库以外，完全兼容标准c/c++语法，这里暂时不做过多介绍

在设计菜单栏，选择c小程序下的箭头，创建一个新的c小程序

TS的C小程序中提供了一个Step函数，Step函数是一个以5ms为周期循环调度的函数，在这里可以简单的做一些需要重复做的事情，但不宜执行耗时过长的代码。

除了Step函数外，C小程序还提供了一套较为完备的事件驱动系统，类似与CANoe与C++的Qt框架，可以通过事件机制，在事件触发时来比较便捷的执行自己的逻辑。

3.1 粘贴代码法

对TS的C编程不熟悉的朋友，如果想利用c小程序进行某些操作，可以使用代码粘贴法。

何为代码粘贴法？

如图所示，在TS程序中，许多地方都提供了鼠标右键可以生成对应代码的功能，当对TS的c编程不熟悉之时，可以使用这种方法来学习。

比如在报文发送模块，新建一个报文，随后右键选择复制为c代码

就会跳出对应功能的代码，我们可以直接复制这段代码达到想要的功能。

并且TS还提供了三种发送报文的方式。

自由编辑方式：直接操作报文的字节和ID，dlc等属性，随后调用发送函数发送

数据库信号方式：以数据库信号定义的方式，将当前报文的各个信号的状态定义出来并修改信号发送

总线仿真引擎方式：以rbs仿真的形式发送报文，直接设置数据库中的信号。

这里我直接复制自由编辑模式的代码，随后打开c编辑器，将代码复制在Step函数中，并将报文ID修改为0x456

随后点击编译图标，编译这段c代码，并为c小程序节点勾选自启动模式

启动TS工程，可以看到我们定义的报文就已经在自动发送了。

3.2 系统变量与panel，c小程序简单结合使用

现在使用零代码粘贴方法实现以下利用panel控制TS发送报文。

以上文中介绍的方法创建两个系统变量sendMsg234和sendMsg456

在Panel面板中创建两个按钮，并分别绑定这两个变量。

在c小程序中，找到变量变化事件，创建两个事件

鼠标右击添加事件，分别添加两个系统变量对应的事件，使用选项找到刚刚创建的变量，选择完毕后点击应用

ok，创建完成后得到了如图所示的两个变量变化事件

现在打开刚刚复制的发送报文的代码，剪切一下粘贴到这两个变量变化事件内，并分别修改下对应的报文ID

随后编译代码，启动工程。

现在就可以做到，点击一次就发送一次对应的报文了。

本期介绍到此为止，以后将会详细介绍TS的一些库函数使用，或者大家有什么想知道的，也可以在评论区提出，谢谢。