【Tera Term】黑猫带你学TTL脚本——嵌入式开发中串口自动化神技能

1 前言

1.1 声明

TTL脚本视频学习：TTL脚本语法与实战——嵌入式开发中串口自动化神技能

1.2 参考链接

TTL 脚本简易教程：
https://imlane.zhanglintc.co/post/ttljiao-ben-jian-yi-jiao-cheng
官方TTL命令参考：
https://ttssh2.osdn.jp/manual/4/en/macro/command/index.html
官方帮助中心：
https://ttssh2.osdn.jp/manual/4/en/

2 概述

2.1 TTL背景

所谓 TTL, 其实是 Tera Term Language 的缩写, 也就是 Tera Term 的专用脚本语言. 那么 Tera Term(Wiki)是个什么东西呢其实就是个终端(Terminal), 也就是说跟什么 XSehll, SecureCRT, Putty 之类的东西差不多一个意思.

Tera Term 是日本人搞出来的东西. 其实仅仅就这个 Tera Term 来说我觉得一点并不好用, 完全比不上 Xshell. 不过关键就在于它有它自己的脚本语言 Tera Term Language 啊. 有了自己的脚本语言加持以后, 这个终端瞬间化身自动化利器, 可以提前设计好各种操作, 剩下的就让终端自动运行好了.

Tera Term 这个东西本身我就不多介绍了, 只要到 Tera Term Open Source Project 下载安装即可. 写好的脚本双击以后是会自动调用这个工具的. 接下来的内容将会介绍 TTL 的语法和使用.

TTL脚本是为tera term这个软件服务的。tera term加载TTL脚本后，会自动运行脚本，然后执行脚本里的命令。

2.2 为什么要学习TTL脚本

对于嵌入式开发人员来说，串口工具想必大家再熟悉不过。通常使用串口工具给开发板下发命令、接收log，亦或是连接远程终端，而这都需要我们手动控制。试想，下发一条命令可以手动，那下发1000条命令呢/p>

在嵌入式开发中，有这么一款广泛使用的串口工具——Tera Term，其内置TTL脚本语言，该语言语法丰富但又简单易学。通过TTL脚本，即可实现串口工具自动化测试。当然，其功能远不止于此，但凡会用到串口工具的地方，都可以通过TTL脚本来满足自己自动化需求。例如自动连接远程终端、自动执行远程终端脚本、分析串口工具中显示的log、统计测试项是否成功等等。

2小时学会一个串口自动化脚本语言，半天即可熟练掌握，让你更快速更高效地完成嵌入式项目开发。最少的时间掌握一个终生受益的技能，这会让你变得比大多数嵌入式工程师更厉害。

3 数据类型

TTL语言（TeraTerm Language）总共只有四种数据类型，分别为Integer、Character string、Integer Array、String Array。

4 注释

; 分 后面是注释

; 分 开始的行是注释行
var = 0 ; 这里分 右边开始也算注释

5 字面量

; 支持正数负数, 不支持浮点数
123
-11

; $开始的数字是16进制
$3a
$10F

; 字符串’Hello, world’“I can’t do that”“汉字也支持”
; #开头的是ASCII码值字符, 也就是#后的数字查ASCII码表对应的是哪个字符就是哪个字符
#65 ; 文字 “A”
#$41 ; 文字 “A”
#13 ; CR 文字

; 字符串可以直接拼接
‘cat readme.txt’#13#10 ; 相当于 “cat readme.txtrn”
‘abc’#$0d#$0a’def’#$0d#$0a’ghi’

6 变量

变量包括用户自定义变量和系统变量两部分.
下面将分别介绍一下.

6.1 自定义变量

定义变量无需指定类型, 直接使用 变量名 = 值 的语法即可.

注意：赋值时候=右边的“10”或’10’表示字符串，10才表示数字，例如cycle = “10”和cycle = 10是不一样的，一个是字符串，一个是数字。

; 定义普通变量
_var = ‘valid’ ; 下划线开始的变量名合法。
_var = “valid” ; 使用双引 也可以
var_1 = 1 ; 这是一个数字
var_2 = ‘str’ ; 这是一个字符串

; 定义数组及赋值
intdim a 3 ; int数组
a[0] = 1
a[1] = 2
a[2] = 3

strdim s 3 ; str数组
s[0] = ‘1’
s[1] = ‘2’
s[2] = ‘3’

6.2 系统变量

TTL 预置使用了一些系统变量, 写脚本的时候注意不要占用. 阅读脚本的时候要注意这些是系统变量, 是作为系统函数返回值而存在的.

常见：
inputstr ; waitln等函数的接收到的值存放于此
matchstr ; strmatch等函数的值存放于此
param1 ; 调用脚本时候传入的第一个参数
params ; 调用脚本时候传入的所有参数的数组
result ; waitln等函数执行的结果code存放于此
timeout ; 超时时间
…

具体请查看 Tera Term 的帮助文件：
https://ttssh2.osdn.jp/manual/4/en/macro/syntax/variables.html

?break

?continue

8 子过程

TTL 可以定义一些子过程, 方便重复调用. 但是没有返回值, 不能称之为函数.

定义子过程首先要了解 label 标签

可以这样定义和调用子过程:

1、子过程以return返回。
2、标签后面没有return，说明不是子过程，只是标签。标签也建议用end结束。

9 常见用法

下面介绍一些 TTL 脚本中的常见写法.

9.1 连接服务器

使用 connect 命令, 而且有不少其他命令必须在连接服务器后才能使用:
connect ‘hostname:22 /ssh /2 /auth=password /user=username /passwd=password’

9.2 执行给定命令

sendln ; 向远端服务器上发送 命令以及 CR, 即执行该命令

9.3 等待特定字符

wait ‘$’ ‘#’ ; 等待远端服务器屏幕上出现 $ 或者 #. 未出现则一直等待. 该等待超时时间由系统变量 timeout 控制, 若为 0 则无超时时间, 即无限期等待

9.4 拼接字符串

使用 sprintf2 直接定义变量. 其中 %s 是占位符, 被字符串后面跟的变量替换.
hostname = ‘your_hostname’
username = ‘your_username’
password = ‘your_password’
sprintf2 server ‘%s:22 /ssh /2 /auth=password /user=%s /passwd=%s’ hostname username password

直接声明变量并在后面添加字符串.
hostname = ‘your_hostname’
msg = hostname
strconcat msg ‘:22 /ssh /2 /auth=password /user=’
strconcat msg username
strconcat msg ’ /passwd=’
strconcat msg password

9.5 保存服务器操作日志

getdir logdir ; 获取当前脚本所在路径
changedir logdir ; 调整日志文件夹路径到当前路径
logfile = “operation.log” ; 日志文件名
logopen logfile 0 0 1 ; 打开日志文件用于写入
logwrite “first line in log file”#13#10 ; 向日志文件中写入”first line in log filern”, 其中 #13#10 的意思就是 CRLF

10 include包含其他文件

include ‘1.ttl’
即将1.ttl里面的内容包含到本TTL脚本中。

11 常用命令

?参考链接
tera term的ttl脚本使用方法
https://blog.csdn.net/f2157120/article/details/99822653tm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-0&spm=1001.2101.3001.4242

官方TTL命令参考：
https://ttssh2.osdn.jp/manual/4/en/macro/command/index.html

常用命令直接参考官方命令介绍即可，非常清晰明了，此处就不一一列出。只列出部分易错/重要的命令：

?fileopen
如果文件不存在，则创建该文件并打开。

?changedir
注意和setdir的区别，两个命令都是改变路径，那么到底有什么区别呢/p>

chagedir改变的是Tera Term的路径。setdir改变的是MACRO的路径。

那这时候又有问题了，什么是Tera Term的路径，什么是MACRO路径br> File names specified for the communication commands (e.g. kmtsend) are based on the current directory for Tera Term.
File names specified for other commands (e.g. fileopen) are based on the current directory for MACRO.
可能看到这里还是不太清楚Tera Term的路径和MACRO的路径区别，也不要担心，再有的命令中，会用到路径的时候，会讲明是哪个路径，如下：

?TTPMACRO.EXE软件加载ttl脚本
在安装tera term软件时候，安装路径不仅有ttermpro.exe软件，还有ttpmacro.exe软件，打开ttpmacro.exe软件加载ttl脚本即可。

如下设置即可：

文章知识点与官方知识档案匹配，可进一步学习相关知识CS入门技能树Linux入门初识Linux25065 人正在系统学习中