工具箱设计开发 – 上海同星智能科技有限公司

新功能发布 | TSMaster工具箱集成开发环境系列2-工具箱极简开发流程

pan — Wed, 19 Jun 2024 07:49:42 +0000

本章节继续介绍TSMaster工具箱集成开发环境系列第二章，基于Python的界面设计。下面我们一起来看看在TSMaster环境下如何进行工具箱的极简开发。

本文目录

<\/path><\/svg>"},"container":".PostContent","no_headings_message":"No headings were found on this page.","hierarchical_view":"yes","min_height":{"unit":"px","size":"","sizes":[]},"min_height_widescreen":{"unit":"px","size":"","sizes":[]},"min_height_laptop":{"unit":"px","size":"","sizes":[]},"min_height_tablet_extra":{"unit":"px","size":"","sizes":[]},"min_height_tablet":{"unit":"px","size":"","sizes":[]},"min_height_mobile_extra":{"unit":"px","size":"","sizes":[]},"min_height_mobile":{"unit":"px","size":"","sizes":[]}}" data-widget_type="table-of-contents.default">

一、创建空间

1. 检查Python环境是否就绪

打开TSMaster，转到工具-系统信息-Python环境设置页面，在这个环境中，用户可以选择默认的Python x86和x64的运行环境，TSMaster 最新版本支持 x86 版本和 x64 版本，可根据 TSMaster 开发的Python程序是32位还是64位，只需要配置相应的运行环境即可。

我们来到x86的运行环境配置框，默认显示的是TSMaster自带的Python，即3.8.5版本，会显示了完整的程序路径。

2. 配置框按钮操作

配置框右侧有5个按钮。第1个按钮，选择Python环境，点击后将弹出对话框，在此可以选择另一个Python的路径。比如本机安装了Python 3.9版本，那么就完全可以把TSMaster的Python环境改成3.9版本，不需要总是使用TSMaster自带的Python版本。选择3.9版本后点击打开，可以看到提示，重启TSMaster软件后可使用最新的Python解释器，只要按照提示重启，再次重新打开TSMaster。转到工具-系统信息-Python环境设置，可以看到Python命令行输出，会显示当前的Python的版本号以及编译时间等等详细信息。

第2个按钮，打开Python环境的文件夹，点击后会弹出Python3.9的主文件夹。

第3个按钮，它是为了当前的环境重新安装TSMaster的支持库，如果TSMaster更新了新版本，或者是用户意外的删除了package相关的文件，那么需要到这里安装TSMaster的支持库。可以点击试一下，会显示TSMaster支持包已安装。

第4个按钮，就是恢复默认的Python解释器的路径，点击后可以一键切换到最初的默认状态，就是Python3.8.5。

第5个按钮，是测试TSMaster的支持库是否工作正常，点击后会打印支持库中的API函数名称等信息。如果提示测试成功，则表明TSMaster支持库可用。

3. 创建工具箱窗口

打开应用，工具箱设计开发环境，第一个页面是现有的工具箱列表，点击工具栏上的“+”号添加按钮，创建新的工具箱。输入工具箱的名称。例如，toolbox，按回车，一个新的工具箱就被创建出来了。

双击toolbox1这一行，来到控制代码的区域，此代码定义了一个类，名为toolbox1。它继承于TSMaster内部工具箱窗体TSForm。初始化代码只有一行，也就是设置Caption，说明这是一个空的窗体。点击上方的运行，或者F9，就可以启动这段代码，创建一个空的工具箱窗口。

二、修改空间属性

点击工具栏上的窗口按钮，启动界面设计器，我们先实现一个简单的功能。例如点击按钮将窗体的标题栏，修改为Hello World。

来到控件页面，选中列表的第一行Button，点击，来到窗体区域，再点击一下就可以创建一个按钮，按钮默认是处于选中状态，按下F11，或者是点击右侧的属性，就会来到该控件的属性选项卡。这个按钮的默认名称是Button1，在这里有个Name，将其改为btnTitle，并将它的Caption改为Set Title。

如果需要预览效果，可以转到组件窗口的配置选项卡，看到代码生成有两个按钮，第一个仅生成Python代码，第二个是生成代码后同时运行窗口，如果点击第二个按钮，则会关闭当前的编辑器。

三、生成代码

1. 新增属性设置

主要分两块内容，第一块是init函数，第二块是用户定义的各种来到工具箱的代码设计区域，可以看到空窗体的代码新增了窗口的属性设置，以及按钮的创建和属性设置等等。需要注意的是，夹在两行绿色注释之间的代码是窗体设计器自动生成并且控制的，不推荐用户自行修改，因为任何修改都会被随后的代码生成再次覆盖。

在这里，推荐大家使用专业的编辑工具在外部进行编辑，在此推荐使用的是VS Code。

2. 编写事件处理函数

首先，在初始化函数中，将按钮点击事件关联到一个事件处理函数。我们可以先在代码中定义出这个函数。例如，在init函数的函数体下方，继续编写def OnSetTitleClick。注意，注意UI事件的第一个参数都是sender，也就是事件触发的源，因此这一类函数一般至少有一个参数。

接着，需要在处理函数中设置self，也就是本窗体的Caption为Hello World，那么这个函数就编写完成。最后只需要将我们刚才的self.btnTitle的OnClick事件关联至OnSetTitleClick，代码就编写完毕了。

回到TSMaster中，点击编辑框之后我们会看到文件会刷新到最新的状态，随后我们可以按F9或者点击三角形的启动按钮来运行程序，点击三角形的启动按钮来运行程序，就可以看到窗口的标题栏变成了Hello World，这便是工具箱的极简的设计流程。

四、工具箱的独立运行功能

我们转到VS Code，直接点击右上方的箭头，此时我们可以先最小化TSMaster，将工作区改为信任，然后点击右上方的运行按钮，可以看到VS Code直接调用了Python，启动了该工具箱。

此时的工具箱窗体又脱离了TSMaster的主程序而独立运行起来，这就是工具箱窗口的独立形态。这意味着，工具箱窗口代替了TSMaster的主窗口，成为了一个独立的应用程序。TSMaster则在后台运行，为Python窗口提供一切可能的支持，但TSMaster内置的所有功能依然都可以使用。

About More

以上就是本章节为大家介绍的TSMaster工具箱的简单设计流程，更多使用教程可查看B站视频～

The post 新功能发布 | TSMaster工具箱集成开发环境系列2-工具箱极简开发流程 first appeared on 上海同星智能科技有限公司.

新功能发布 | TSMaster工具箱集成开发环境系列3-工具箱调用小程序库

pan — Sat, 01 Apr 2023 09:28:28 +0000

overview前言

今天继续TSMaster工具箱系列第三章，如何用Python脚本调用自己编写的API函数。

一、安装小程序库

Install the applet library

打开TSMaster，拖入一个dbc文件，可以到TSMaster的安装目录去找这个文件，在Demo-Databases里面任意找一个，比如说CAN_FD_Powertrain，拖入之后就可以关闭这个数据库界面。

接下来选择硬件通道，1路CAN，随后打开总线仿真也就是rbs的界面，双击激活Engine节点。当剩余总线启动的时候，Engine节点就会往外发送自己的周期报文。

切换到自定义函数组，点击右键添加一个自定义函数，名称设置为control_rbs。函数的参数可以设置稍微复杂一些，比如第一个参数是激活标志，也就是const bool AEnable；第二个参数是附加信息，比如const pchar AInfo，这样就把函数的接口给定义好了，接下来实现这个函数。

首先可以打印出，用户希望看到的信息，也就是log(AInfo），接下来判断Enable标志，if(AEnable)，如果是Enable那么就写com.can_rbs_start，否则就是stop，这样API就做好了。为了让其他的程序用到这个函数，需要将controller这个小程序安装到TSMaster中，成为小程序库。切换到属性页面，点击小程序库这个开关，首先编译，其次安装就结束了。此时就可以从TSMaster的任何位置，调用这个API。

二、自动化测试

Automated Testing

小程序库，有controller这个mp小程序，它有一个API函数。如何验证呢？可以打开一个自动化模块，选中入口点，回车，再双击NOP，到右侧，修改类型为API调用，再修改函数调用类型为小程序库函数，此时会弹出一个函数选择器，第一个函数就是我们刚才设计的control_rbs。选中该函数双击，在右侧填入参数，第一个是使然标志，填入true或者1都可以，第二个是需要打印的信息，比如start from automation module，随后按F9启动，会弹出提示信息。

在信息里面首先是打印的字符串，也就是start from automation module，其次是一个错误信息，提示在激活仿真引擎之前必须连接应用程序，也就是点击左上角的启动按钮。按照提示连接一下，这样仿真引擎才具备运行条件。

再切到自动化模块，按F9，程序立马执行成功。切到trace窗口，可以看到Engine节点的报文，再回到自动化模块，选中control_rbs这个命令，粘贴一个一模一样的函数调用，将新的函数调用改为禁止rbs，也就是这里填false，信息填入stop from automation module，再按一次F9，由于最后一次执行的步骤是禁止操作，trace窗口的报文，也就不再刷新，Engine节点已被禁止。因为总线仿真已经停止，此时自动化模块的测试工作就结束了。

三、启动窗体设计

Launch form design

打开工具箱的主界面，添加一个新的工具箱，点击工具栏上的“+”号按钮，输入新工具箱的名称：test，按回车，工具箱就创建完毕。注意该工具箱，默认位于当前工程文件夹的路径中，它会跟随当前的工程走，表格中，全局一栏的勾是取消勾选的状态。点击右侧的文件夹按钮，就可以看到我们的工具箱了。它确实是位于当前的工程路径下，这就意味着，当新建工程或是加载别的工程的时候，这个工具箱就找不到了。

倘若用户想创建一个永久的工具箱，让每个工程都可以使用这个工具箱的话，就需要开启全局工具箱模式。点击左上角的齿轮按钮，将鼠标放到上面会提示激活工程模式或者全局模式，那么默认是选中状态，表示工程模式激活，再点一次就激活全局模式。这个时候，再创建工具箱，所创建的工具箱就会被放到，TSMaster的安装目录上，而不会跟随工程。

我们来操作一下，点击新建按钮，输入global1，回车，可以看到新建的工具箱排在表格中靠后的位置，而且全局的勾，是选中的状态。打开文件夹，向上一级，还可以看到该工具箱所在的文件夹，还有系统自带的两个示例的工具箱。一个是控件的使用指南，另一个是原始的CAN报文发送窗口。接下来进入界面设计的环节，选中test工具箱，双击，进入到代码设计页面，点击工具栏上的窗体按钮，来启动窗体设计器。

在界面中添加两个按钮，一个是启动rbs一个是禁止rbs，选中Button1，按F11切换到属性页面，过滤器输入name，将名称改为btnStart，caption改为Start，选中Button2，caption改为Stop，将name改为btnStop，至此窗体设计结束。

四、编写按钮的事件代码

Write event code for the button

添加import，在添加之前，首先要转到小程序模块页面，在空白处点右键添加模块，选择controller小程序库，该步骤使得我们的controller小程序的API对于Python来说是可见的。再回到工具箱代码设计界面，来到代码的第二行，点击右键，选择插入模块import，再选择我们的controller，可以看到，controller已被导入。

为了获得更好的编程体验，可以使用VS Code，点击工具栏上的编辑按钮，打开VS Code，接下来来到UI创建结束的地方，也就是位于init函数中的下半部分，首先添加两个按钮的点击事件，按四个空格输入def on_start_click，在函数中调用controller的API，也就是controller。弹出代码的第一行就是我们的API，按回车。再敲一下左括号，可以看到两个参数提示信息，第一个填入True，第二个随意填写字符串，比如说start from Python，回车。再添加另一个函数def on stop_click，同样controller.control_rbs此时是禁止，所以是false，内容是stop from Python。

接下来关联两个事件，也就是self.btnStart.OnClick=on_start_click、self.btnStop.OnClick=on_stop_click，程序编写完毕，Ctrl+S保存。再切回TSMaster，点击代码的空白处，可以看到代码已经刷新到最新的状态。按F9启动，最后点击Start按钮，当然点击之前首先要连接应用程序，再点击Start，就可以看到Engine节点的报文都出现了，随后点击Stop按钮，Engine节点的报文就停止发送了。打开系统消息，就可以看到我们刚才打印的信息-start from Python和stop from Python。

本章内容我们可以得知，现有的小程序的API是可以轻松被Python程序调用的，这极大的丰富了我们的Python的函数库。

About More

以上就是本章节为大家介绍的TSMaster工具箱的调用小程序库流程，更多使用教程可查看B站视频～

The post 新功能发布 | TSMaster工具箱集成开发环境系列3-工具箱调用小程序库 first appeared on 上海同星智能科技有限公司.

新功能发布 | TSMaster工具箱集成开发环境系列1-工具箱设计开发

pan — Fri, 17 Mar 2023 02:25:25 +0000

overview前言

今天给大家介绍TSMaster新功能—工具箱设计开发。有了这个模块，任何人都能够用Python来设计专业的TSMaster用户界面并集成到自己的工程中。

在此，需要大家更新TSMaster软件至最新版本。最新版本下载链接可以直接在公众号菜单栏回复“TSMaster”，即可获取。

一、工具箱的持久化功能

The persistence function of the toolkit

打开TSMaster，进入后切换到应用，点击工具箱设计开发环境的图标，会出现开发环境的界面。同时会有一个新图标，而TSMaster工具箱出现在该图标的右侧。这个图标用来链接用户设计生成的界面。转发到开发环境界面，可以看到有两个现成的工具箱，一个是CAN报文的发送窗口，另一个是工具箱设计指南。

然后点击对应工具箱最右侧的运行按钮，窗口就会显示在TSMaster工具箱的链接下面，我们对这个窗口进行拖动和缩放。如果点击右上角的关闭，默认操作是隐藏，如果想要恢复这个窗口可以通过下拉找回，如果点击右上角的删除按钮，则可以永久的删除该窗口。这样的窗口每点击一次都会创建一个新的，每个窗口都有独立的配置。

我们可以尝试修改一下这个配置，比如将0x123改成0x321，同时我们将窗口稍微排布一下，新建一个页面，将其中的一个到两个窗口拉出来，保存工程，关闭TSMaster，再打开TSMaster，选择上一次的工程，打开之后就可以看到工具箱的窗口，布局依然是上一次关闭之前的状态。例如左边这个窗口的ID是0x321是我们改过的，右边这个窗口是默认的0x123，这就是工具箱的持久化功能。

二、Python的语法提示功能

Python syntax prompt

在开发环境中，选择一个工具箱，双击对应的行，就可以来到代码编辑的窗口，该工具箱的所有的可视的元素和背后运行的所有逻辑，都在这一份Python代码里面。如果想用系统关联的Python文件编辑器来打开这个Python文件，只需要点击工具栏上的编辑按钮。

例如，本机上是用Visual Studio Code来关联Python文件，那么打开的就是Visual Studio Code，初次打开之后是需要安装Python的支持包。在VS code里面，可以在这里点击搜索Python，会看到微软发布的Python支持包，点击安装。安装以后就可以很轻松的修改和管理代码。

安装完成以后关闭扩展的界面，转到我们现在的Python的环境中，默认的Python环境会选取电脑上已经装过的Python路径。这个路径可能并不包含我们的TSMaster的引擎，所以我们需要切换Python环境。如果没有TSMaster的package，语法提示就会出现很多错误，那么我们就需要切换到默认的Python版本为TSMaster安装目录下的Python，当前的Python环境已经具备语法提示的功能。

按Ctrl+k+0，把代码折叠，我们大致看一下代码，该文件只有三部分内容，第一个是导入-import TSMaster，是TSMaster支持包中的类型信息；第二个是定义窗体类，它继承于TSMaster内部的TSForm；第三个是main函数，用于创建和启动脱离TSMaster的独立的程序。接下来我们重点介绍一下第二部分窗体类代码。

三、窗体类代码

Form class code

主要分两块内容，第一块是init函数，第二块是用户定义的各种各样的函数。我们把init函数展开，会发现内部有大量的界面相关的代码。例如，DLC的Label框，转到TSMaster中，再找到VS code对应的代码创建代码，它设定了这个Label框的位置就是Left Top Width Height属性以及它的caption属性，这些代码用户可以手写，也可以通过TSMaster提供的窗体设计工具来自动生成。

我们将滚动条下拉，来到init函数的下半部分，就是在Auto Generated Python Code下方，是用户初始化代码存放的地方。我们可以在上面空间创建和设置，进一步设定空间的行为。例如这行，247行创建工具栏的按钮用于连接application，这个按钮创建之后，我们再将它的OnClick事件关联到我们本地的一个回调函数叫OnConnectClick，然后跳转到这个函数展开，它的执行逻辑就是，首先代用TSMaster的API，也就是我们小程序熟知的app.connect来连接application，如果连接成功，那就是返回值为0。

我们可以回到TSMaster软件中来验证一下，找一个窗口，单击工具栏上的连接按钮，会看到连接成功的提示。所有的toolbox的窗体的连接按钮都变成了灰色的状态，同时断开连接的按钮呈现激活状态，这就是TSMaster事件回调函数起的作用。

回到代码，找一下OnMeasurementStart函数，这个函数调用了一个子函数来设置按钮的状态，按住Ctrl进入这个函数，展开看一下，那么这个函数的逻辑就是，如果连接成功，则连接按钮变灰，断开按钮激活，同时，在窗体的状态栏打印应用程序已连接。否则说明连接已断开。所以每当我们点击连接的时候，会显示Measurement started，点击断开的时候会显示Measurement stopped。

至于点击回调函数的愿意，因为在窗体上有一个Measurement start回调函数，我们可以对它进行赋值，就是这行叫self.OnMeasurementStarted Event，我们可以将它赋值为我们内部的OnMeasurementStart这个回调函数。这样，每当TSMaster成功启动连接，就可以在任何地方启动连接。

我们点击TSMaster启动连接，可以看到工具栏上的按钮的状态都同步发生了变化，之前看到的Raw_CAN_Transmit这个窗口是一个完整的demo，它实现了一个原始的CAN报文的发送逻辑，就是点击按钮发送，或者是定时器发送，或者是收到特定的报文之后触发发送。TSMaster工具箱集成开发环境系列后续还会更新新功能，敬请期待…