你目前正在查看 新功能发布 | TSMaster工具箱集成开发环境系列1-工具箱设计开发

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

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工具箱集成开发环境系列后续还会更新新功能,敬请期待…

About More

更多使用教程可查看B站视频~

发表回复