博客

你目前正在查看 应用笔记 | TSMaster——图形编辑面板功能模块简介

应用笔记 | TSMaster——图形编辑面板功能模块简介

overview前言
TSMaster 图形编辑面板让用户能够开发自己的图形窗口，用于处理报文的收发，信号解析显示等功能。

1．工具栏

1. 模式选择按钮，主要包含如下模式：
1）按下状态时候，当前 Panel 处于编辑模式下，用户可以增加删除控件，编辑控件属性的。
2）弹起状态，当前 Panel 处于测试运行模式，显示的是该面板实际运行时的状态，用户不可进行编辑。
3）灰色状态，当前 Panel 处于运行状态。意味着当前 TSMaster 处于设备连接运行状态。如果用户想重新编辑界面，必须断开 TSMaster 连接，才可以进入编辑状态。

2. 层叠控制
当出现控件层叠情况时，把控件移动到前面和把控件移动到后面。

3. 对齐控件
控件对齐分为两步：
1）首先选择需要对齐的多个控件：按住 Ctrl 键，鼠标点击多个按钮，则选中多个控件。如下所示：

2）选择顶部菜单栏的对齐按钮，如下所示：

对齐选项有：

➢ Align Left：左对齐

➢ Align Right：右对齐

➢ Align Top：上对齐

➢ Align Buttom：下对齐

➢ Center Horizontally：以中间模块为准水平对齐

➢ Center Vertically：以中间模块为准垂直对齐
➢ Distribute Horizontally:：横向均匀排布

以最左边和最右边一个控件的坐标为准，计算控件之间间隔的平均值，然后在横向上均匀排列。

➢ Distribute Vertically:：纵向均匀排布
以最上面和最下面一个控件的坐标为准，计算控件之间间隔的平均值，然后在纵向上均匀排列。

4. 新建 Panel
创建全新的 Panel，此操作将删除 Panel 所有现有的控件。

5. 加载配置
载入现有 Panel 配置文件。

6. 存储配置
存储当前 Panel 的配置文件。

7. Panel 参数配置
主要包含如下参数配置：
➢ Feature Enable：是否使能 Panel
➢ Layout：Panel 内部控件整体布局
➢ Design Time：设计时是否显示链接标签和控件名称
➢ Refresh Rate：配置 Panel 数据的刷新时间。推荐刷新时间为 300ms。如果电脑配置较高，可以配置更高的刷新率

2．控件基本操作

1. 添加控件

2. 删除控件
直接 Delete 键，或者右键，快捷菜单选择删除。

3. 移动控件控件都会有自己所在的容器，在容器范围内，想调整位置，直接选中控件，左键按住，移动即可。如下所示：


4. 移动到容器外面
TSMaster 不支持直接拖拽到容器外面，如果要把控件移出容易，可以采用剪切（Ctrl+X）+ 粘贴（Ctrl+V）的方式可以把控件移动到容器外面。


5. 显示控件类型名
在设计时（Design Time）阶段，默认是显示控件的名称（这个名称是控件的唯一 ID，是系统默认分配的，不能修改，在运行时不可见）的，如下图所示：

如果在设计阶段不想看到控件的唯一名称，可以到 Settings 界面中进行设置，如下所示：

6. 显示控件关联的变量链接
在设计时（Design Time）阶段，用户可以设置显示当前控件所关联的变量(CAN/LIN 信号或者系统变量等)，便于设计者清晰的知道当前该控件所关联的信号值，如下图所示：

在设计时阶段，打开和关闭该关联信号的显示，跟打开和关闭控件名称的显示操作是一样的，如下图所示：

3．UI事件

TSMaster 提供了丰富的 Panel 界面。通过关联变量，可以实现变量值的修改，或者变量值修改过后在 UI 界面上呈现，这些都比较好理解。如果用户要实现按下按键过后，TSMaster 软件发送一串报文，则需要配合 C 脚本实现 UI 事件机制。

UI 事件机制
Panel 的事件机制架构图如下图所示：

Panel 事件机制的实现，简单来说可以概括如下：Panel 中用户输入（按下按键，输入数值等）->改变关联的小程序变量的值->触发 C 脚本中数值变化事件->在事件中执行用户想执行的代码即可。下面以按键发送报文为例讲解 UI 事件的添加过程。

4．释疑

1. 为啥 DBC 解析是对的，Panel 上控件显示不对？

问题描述：
为什么信号值 DBC 解析出来是 12%，但是仪表盘上总是显示 1.0（100%）

查看信号定义，因为信号值定义的范围是 0—100，单位为”%”,解析出来的信号值为12%，代表信号值为 12，然后单位是字符串”%”，并不是信号值是 0.12。因此，仪表盘的范围应该是 0—100，跟信号定义中的范围是一致的。如果仪表盘的范围设置为 0—1,则当信号值显示为 12%的时候，仪表盘当然会显示到最大值 1。

解决办法：
设置仪表控件属性，调整该控件的显示范围跟信号的范围一样。从 0-1 调整为 0-100，调整过后，仪表盘显示正常。

 

2. 添加了 DBC，为啥通过 Panel 关联信号的时候看不到任何信号？

问题描述：
加载了示例数据库：TOSUN_Hardware_Synthesize

 

可以看到，有报文，有信号等。

在面板中，添加 InputOutputBox，选择关联一个 CAN 信号，结果界面如下：

 

此时如果用单存显示控件，如 Progressbar 等关联信号，是可以看到信号的。

原因分析：
InputBox 是输入信号，这种信号从逻辑上来说需要被修改并发送到总线上，因此必须关联到一个发送节点的 CAN 信号上。然后我们继续看这个数据库：

 

可见，节点数量为 0，也就是没有任何发送和接收节点。这种情况下是无法启动 RBS仿真的，因为没有发生节点，也就看不到任何跟发送节点相关的信号了。

解决办法：
添加发送节点，并把报文和信号关联到发送节点上，就可以看到信号了。

 

3. Panel 中看不到滚动条
在设计 Panel 的时候，出现看不到窗体看不到滚动条（垂直+水平）的情况。如果窗体面积很大，超出了屏幕显示范围，就会出现一部分窗体被遮挡的情况。如下所示：

 

原因分析：
电脑屏幕设置了缩放，造成控件内部不能正确计算相对屏幕的尺寸，因此无法正确显示滚动条。查看电脑设置如下：

 

解决方案：
关闭屏幕缩放，设置缩放为 100%，重启软件，即可重新看到窗体的滚动条。

 

可以看到，在窗体上重新出现了滚动条（垂直+水平），如下所示：

标签。 , , ,

发表回复