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条命令呢？

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

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

Part3数据类型

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

Part4注释

; 分号后面是注释

; 分号开始的行是注释行

var = 0 ; 这里分号右边开始也算注释

Part5 字面量

支持正数负数, 不支持浮点数
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’

Part6 变量

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

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

如何查看系统变量？

TTl脚本中貌似没有printf之类的函数，可以直接输出某个变量的值到底是多少。那如果写代码过程中想要看看其中某个变量的值是多少该怎么办呢？

其实可以转变思路，将想要打印的变量直接写入文件中就可以了。

Part7流程控制

TTL 也支持基本的流程控制操作；

7.1 do, loop

; 循环10次
i = 10
dowhile i > 0
  i = i - 1
loop

7.2 while, endwhile

; 循环10次
i = 10
while i > 0
  i = i - 1
endwhile

7.3 until, enduntil

; 循环10次
i = 1
until i > 10
  i = i + 1
enduntil

7.4 for, next

; 循环10次
for i 110
  sendln 'abc'
next

; 循环5次
for i 51
  sendln 'abc'
next

7.5 if, then, elseif, else, endif

if a = 1 then
  b = 1
  c = 2
  d = 3
endif

if i < 0 then
  i = 0
else
  i = i + 1
endif

if i = 1 then
  c = '1'
elseif i = 2 then
  c = '2'
elseif i = 3 then
  c = '3'
else
  c = '?'
endif

7.6 break, continue

break

while1
  recvln
  strcompare inputstr "OK"
  if result = 0 then
    break
  else
    sendln "abc..."
  endif
endwhile

continue

a = 0
b = 0
while a < 5
  a = a + 1
  if a > 2 then
    continue
  endif
  b = b + 1
endwhile

sprintf2 var "a=%d b=%d" a b
dispstr var; a=5 b=2

Part8子过程

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

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

; 冒号开始的是标签
: I_am_a_label  	; 这就是一个标签

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

messagebox "I'm in main.""test"
; 跳转到":sub"
call sub
  messagebox "Now I'm in main""test"
end

; 子过程具体定义
:sub
  messagebox "Now I'm in sub""test"
  return  ; 返回到主体

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

Part9常见用法

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

9.1 连接服务器

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

9.2 执行给定命令

sendln date ; 向远端服务器上发送 date 命令以及 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