控制台
使用控制台的命令行工具可以提高较大规模程序设计的编写效率。在计算机上通过一系列命令实现以下功能,提高效率
- 上传已写好的程序文件;
- 修改指定行的指令和运算元;
- 修改各寄存器的值;
- 运行、停止、单步调试程序;
- 在运行中实时修改程序或寄存器;
- 存储和读取存档;
- 信息屏翻页。
下载控制台
- Steamania Console V0.95.a Linux版本
- Steamania Console V0.95.a MacOS版本
- Windows系统下,请参考使用虚拟机并下载使用Linux版本。
使用方式
首先将USB串口模块与蓝牙模块正确连接。
将USB串口模块连接至装有Ubuntu系统的计算机,模块将作为USB串口硬件显示在/dev/
下。
这时可以打开一个命令行窗口并输入
steamania@localPC:~$ ls /dev/ttyUSB*
tip
Ubuntu 系统下可以使用快捷键Ctrl+T打开命令行窗口。
如果返回类似以下结果的设备名称
ttyUSBx
说明硬件已连接成功。
通常在没有其他串口模块的情况下,设备名称是ttyUSB0
,也就是说串口模块是
/dev/ttyUSB0
以用用户桌面文件夹为例,进入程序所在文件夹
steamania@localPC:~$ cd Desktop
steamania@localPC:~/Desktop$
输入./steamania-console /dev/ttyUSB0
就可以启动控制台工具
steamania@localPC:~/Desktop$ ./steamania-console /dev/ttyUSB0
辅助屏
Console: [C] $
tip
在Linux下可以通过rlwrap
命令启动控制台工具,在使用过程中,支持使用计算机键盘的上和下方向键翻查已经键入的程序。
rlwrap ./steamania-console /dev/ttyUSB0
支持命令
控制台工具包括以下命令
类别 | 命令 |
---|---|
设备操作 | select device |
上传程序 | upload |
寄存器修改 | wreg |
程序行修改 | wline wipe |
运行时指令 | run stop step n b jump |
辅助屏查看 | page |
存档操作 | load save |
其他 | help quit |
info
此外还支持Linux系统命令行命令ls
reset
clear
。
设备操作:select
device
danger
工具启动后,需要使用select
指定目标设备进行通信,否则无法正确发送命令。
假设通信的目标设备蓝牙ID为C6
辅助屏
Console: [C] $ select 0xC6
Target device is set to 0xc6
tip
目标设备蓝牙ID可以通过辅助屏第12页蓝牙信息页查看。
可以随时更改目标设备,或者通过device
命令查看当前已指定的设备。
辅助屏
Console: [C] $ device
Target device is set to 0xc6
Linux指令ls
clear
reset
工具包含三个Linux常用指令:
ls
:查看当前目录下的文件,可以在上传程序文件时使用ls
命令来确认文件名;reset
:复位当前窗口;clear
:清除屏幕。
上传程序:upload
程序文件以文本的形式存储,格式如下
000 10 0001 0001
001 13 0001 0000
002 02 0001 0001
003 15 1101 0001
004 0E 0000 0001
可通过以下命令上传至编程器主机:
辅助屏
Console: [C] $ upload bitshift.code
uploading file: bitshift.code to device 0xc6.
000 10 0001 0001
001 13 0001 0000
002 02 0001 0001
003 15 1101 0001
004 0e 0000 0001
寄存器修改:wreg
通过指定寄存器编号来修改寄存器的值。
最多可同时修改三个连续寄存器的值,格式为
wreg [n] [ID] [Val1] [Val2] [Val3]
tip
这里的n代表修改寄存器的个数。
辅助屏
Console: [C] $ wreg 3 0x00 0x1234 0x5678 0x90AB
将修改三个寄存器R00
,R01
和R02
的值,分别改为十六进制的1234
、5678
和90AB
。
辅助屏
Console: [C] $ wreg 2 0x10 0x1111 0x2222
将修改两个寄存器R00和R01的值,分别改为十六进制的1111
和2222
。
caution
注意要写入寄存器的数值应区分十进制和十六进制(带0x前缀)
wreg 3 0x00 0x1000 1000 500
的执行结果,是将寄存器R00,R01和R02的值分别修改为十六进制的1000
、03E8
和01C4
。
程序行修改:wline
wipe
使用wline
命令来修改单行程序,格式为
wline [行号] [指令] [运算元0] [运算元1]
辅助屏
Console: [C] $ wline 001 02 03E8 0000
使用wipe
命令将某一行全部清零。
辅助屏
Console: [C] $ wipe 001
运行时指令:run
stop
step
n
b
jump
使用run
命令运行程序。
辅助屏
Console: [C] $ run
使用stop
命令停止程序。
辅助屏
Console: [C] $ stop
使用step
命令切换至调试模式,同时使用n
命令运行下一行。
辅助屏
Console: [C] $ step
Console: [C] $ n
使用jump
命令修改编程器上当前编辑或运行的行号。
辅助屏
Console: [C] $ jump 0x010
使用b
命令将当前行号设置为000
。
辅助屏
Console: [C] $ b
辅助屏查看:page
使用page
命令修改辅助信息屏当前显示的页码。
辅助屏
Console: [C] $ page 4
来查看第四页,寄存器0x00-0x0F的值。
存档操作:load
save
使用load
命令读取指定存档到编程器当前程序区内,存档编号为1~5。
辅助屏
Console: [C] $ load 1
使用save
命令将编程器当前程序区内的程序存到指定存档,存档编号为1~5。
辅助屏
Console: [C] $ save 4
其他:help
quit
使用quit
命令或快捷键Ctrl+C退出程序。
辅助屏
Console: [C] $ quit