5.2:AT应用范例
- PWLINK2(含Lite)、PW400 不支持当前页面所描述的功能,请留意。
- 使用AT 功能需要先对设备开启AT 模式,参考: 设备首选项.
本章节将详细地介绍 PowerWriter AT GUI 相关的软件系统, 用户可以将其作为软件的使用指南, 或者是参考手册, 当遇到不理解的内容时, 可以随时查阅。
软件下载地址:
PowerWriter -> 资料下载 -> 客户端-> PowerWriter AT 应用
1. PowerWriter AT GUI主界面
PowerWriter AT GUI应用软件的启动界面如下图 1.1.1 所示。
2. PowerWriter AT GUI 功能
2.1 添加命令
弹出命令选择界面,如图1.1.1.1AT命令选择界面所示
鼠标单击指定的AT命令,便会将对应的命令添加到命令列表中来,若命令有参数需要设置,命令列表的"AT命令参数"列则会提示“鼠标双击设置或修改参数”,若需要修改AT命令,鼠标双击"AT命令"列即可,如下图1.1.1.2命令列表所示
2.2 插入AT命令
在选中行上方插入一条AT命令。
2.3 命令上移
将选中行AT命令移动至上一行。
2.4 命令下移
将选中行AT命令移动至下一行。
2.5 删除AT命令
将选中行AT命令删除。
2.6 清空AT命令
将命令列表中的AT命令清空。
2.7 导出AT脚本
将命令列表里的AT命令,导出为AT脚本,文件内容格式详见 [1.4 AT脚本文件内容格式](#1.4 AT脚本文件内容格式) 默认文件名为“patscript年-月-日时-分-秒”,文件后缀名为:".patscript",与命令行版本通用,如下图1.1.1.3 AT脚本文件导出所示
2.8 加载AT脚本
将选定的AT脚本文件导入到命令列表中来。
2.9 扫描AT端口
扫描开启了“USB端口AT功能”的PowerWriter,并将扫描到的端口显示到软件界面上,若未扫描到设备,则会提示"未扫描到PowerWriter,请检查设备连接情况",如下图1.1.1.4 AT端口所示
2.10 断开端口连接
断开所有的端口连接,如下图1.1.1.5 断开端口所示
2.11 执行AT命令
各个已连接的端口,多线程并发执行命令列表里的所有命令,每执行完一条命令会打印执行结果,命令执行出错,对应的端口将停止执行命令,并报错。如下图1.1.1.6 命令执行所示
2.12 打印获取信息
勾选“打印获取信息”将把“获取命令”获取到的信息输出到界面,否则不输出。
2.13 覆盖文件
勾选“覆盖文件”将在文件夹“A-COM(x)”中生成文件,否则将在文件夹“COM(x)-日期”中生成文件,如下图 1.1.1.7 查看文件所示。
2.14 查看文件
“获取命令”会将获取到的数据保存至文件,文件路径为Info\A-COM(x)或Info\COM(x)-年-月-日_时-分-秒,点击“查看文件”按钮查看获取命令生成的文件,具体的文件请查看 [1.3 “获取命令”生成的文件](#1.3 “获取命令”生成的文件),如下图 1.1.1.7 查看文件所示
3. 参数设置界面
鼠标双击"AT命令"列,若该命令需要设置参数,则会弹出参数设置界面,不同的命令会显示不同的参数,注:若AT命令是更新"PW配置",还会将设置好的配置保存为json文件,路径为软件根目录\writer_cfg.json。如下图1.2.1 和1.2.2 所示
4. “获取命令”生成的文件
- "查询PW信息"生成文件为:writer_info.json
- "查询PW配置"生成文件为:writer_cfg.json
- "获取目标芯片ID"生成文件为:chip_id.txt
- "读取目标芯片数据"生成文件为:memory.bin
- "读取目标芯片选项字"生成文件为:option_byte.bin
- "查询离线项目信息"生成文件为:project_info.json"
- "广播响应数据"生成文件为:broadcast_rsp.bin"
如下图1.3.1所示
5. AT脚本文件内容格式
AT命令码 命令参数1 参数值1 命令参数2 参数值2
5.1 AT命令码说明
"-info": 查询PW信息
"-cfg":查询PW配置
"-setcfg {-f *.json}":更新PW信息
"-setbaud {-b}":设置AT接口波特率
"-connect":连接目标芯片
"-status":获取目标芯片连接状态
"-cid":获取目标芯片ID
"-read {-addr -s}":读取目标芯片数据
"-erase {-t}":擦除目标芯片
"-erase {-t -addr -s}":擦除目标芯片扇区
"-write" {-addr -f *.bin}:写入目标芯片数据
"-read-ob":读取目标芯片选项字
"-write-vob {-t}":写入目标芯片默认选项字
"-write-uob {-t}":写入目标芯片用户选项字
"-reset -type" :复位目标芯片,默认为3
"-prj-info":查询离线项目信息
"-prj-ld {-f *.pkg} [-pwd]":加载离线项目
"-prj-dis":禁用离线项目
"-start":启动离线烧录
"-factory-sram-fw":运行FactoryTest SRAM 固件
"-factory-flash-fw":运行FactoryTest Flash 固件
"-bcst {-data} | {-f *.txt|*.bin} [-dir] [-kf] [-wtrsp -t]":扩展指令-广播
"-sleep {-t}":睡眠
5.2 AT命令参数说明
"-f":指定读取文件路径和文件名
"-pwd":输入工程密码
"-b":设置波特率
"-type": 设置复位方式,参考 https://docs.powerwriter.com/docs/next/powerwriter_for_arm/reference/ATCommand/#ATCmdTargetReset
"-addr":设置地址(10、16进制)
"-s":设置数据大小(10、16进制)
"-t":超时时间
"-data":设置立即数数据
"-dir":设置广播方向:"usbtouart/uarttousb"
"-kf":是否转发完整的AT 帧结构:"true/false"
"-wtrsp":是否等待广播应答:"true/false"
"-fw-num":hex文件固件的序号,0为起始序号,全部烧录参数为”all“
6. 错误码
- 0.Unknown error ...
- 1.The package crc validation failure...
- 2.The writer product oem does not match...
- 3.The writer is busy now...
- 4.The writer is in use...
- 5.The writer communication handle error...
- 6.The writer configuration error...
- 7.The target flash algorithm config error...
- 8.The target option byte config error...
- 9.The target chip is not connected...
- 10.The target erase failed...
- 11.The target write data failed...
- 12.The target read data failed...
- 13.The package timeout error...
- 14.The extends flash initial failed...
- 15.The extends flash erase failed...
- 16.The extends flash write failed...
- 17.The extends flash verify failed...
- 18.The extends flash read failed...
- 19.The package size error...
- 20.The target chip type error...
- 21.The target read unique id failed...
- 22.The writer update firmware failed...
- 23.The target chip protection is enabled...
- 24.The target write flash failed...
- 25.The target write option byte failed...
- 26.The writer SN error or don't match...
- 27.The target write matrix license failed...
- 28.The target write ICWKEY license failed...
- 29.The project matrix license version error...
- 30.The ICWKEY failed to request a signature...
- 31.The project of offline times has used up...
- 32.The project of version error...
- 33.The project of oem error...
- 34.The project of magic tag error...
- 35.The project of data corruption...
- 36 .The project disabled...
- 37.The package size error...
- 38.The communication port error...
- 39.The communication package error...
- 40.The writer needs to be disconnected from the online connection....
- 41.The communication port send package error...
- 42.The communication port waiting response time out...
- 43.The command is unsupported ...
- 44.The config is(has) null value ...
- 45.The target flash algorithm config error...
- 46.The Incorrect authentication password...
- 47.Disconnect the device and power it on again to complete the upgrade...
- 48.The extends ICWKEY device is not connect...
- 49.The voltage error (abnormal power supply)...
- 50.The debugger is connected...
- 51.The wireless is connecting...
- 52.The serial port check failed...
- 53.The I/O check failed...
- 54.The button check failed...
- 55.The wireless check failed...
- 56.The writer memory error...
- 57.The writer sn is limited ...
- 58.The target unique ID is limited...
- 59.The project file version is too low, please repackage...
- 60.Please connect PowerWriter device first...
- 61.The target FT(CP) validation fails ...
- 62.The target password error(such as KPROM)...
- 63.The target SPI flash not connected(such as NUVOTON) ...
- 64.The target abnormal access detected...
- 65.The target write KPROM failed...
- 66.The target write XOM failed...
- 67.The target write secure setting failed...
- 68.The target write MTP failed...
- 69.The FUS not running ...
- 70.The stack not running ...
- 71.The FUS upgrade error ...
- 72.The stack upgrade error ...
- 73.The FUS state image not found...
- 74.The FUS state image corrupt...
- 75.The FUS state image not authentic...
- 76.The FUS state image not enough space...
- 77.The FUS state user abort...
- 78.The FUS state erase error...
- 79.The FUS state write error...
- 80.The FUS ST authorization tag was not found...
- 81.The FUS custom authorization tag was not found...
- 82.The FUS authorization key locked...
- 83.The FUS UFB corrupt...
- 84.The FUS state other error ...
- 85.The stack type error ...
- 86.The vendor signature is too long
- 87.The vendor signature data is corrupted
- 88.The current target chip has no signature
- 89.Factory test disabled...
- 90.Factory test have no sram firmware...
- 91.Factory test have no flash firmware...
- 92.Write data to target SRAM failed...
- 93.Current baudrate not supported...
- 94.AT Command broadcast direction error ...
- 95.Need keep AT full frame to current receive port...
- 96.The super serial number configuration data is abnormal...
- 97.The super serial number has no remaining data...
- 98.Failed to write the super serial number...
- 99.The firmware loader digest no match...
- 100.Load DFU failed...
- 101.Update firmware(modem) failed...
- 102.Verify failed...
- 103.Reset target chip failed ...
- 104.This target chip has failed to handle BootLoader...
未列出的错误码均为保留。
7:CLI 命令行文档
7.1 不带参数运行命令行软件
直接运行命令行软件,会打印软件的说明和帮助文档,如图2.1和图2.1-2所示,"PowerWriter AT command"是命令软件的名字,">"后面可以输入命令。可输入命令详见[2.3 命令行软件命令](#2.3 命令行软件命令) 。注意:执行所有AT命令前,需先执行"-scan"命令,扫描开启了AT功能的PowerWriter。
7.2 带参数运行命令行软件
可带的参数为一个AT命令码,或.\AT脚本文件,程序会自动执行"-scan"命令,然后再执行输入的参数命令,命令执行完成,程序结束。如下图2.2和图2.3所示:
7.3 命令行软件命令
7.3.1 所有AT脚本命令
详见[1.4 AT脚本文件内容格式](#1.4 AT脚本文件内容格式)。
7.3.2 特有命令
"-scan":扫描开启了AT功能的PowerWriter
"-close":断开所有PowerWriter连接
"-cls":清除屏幕内容
"-q":退出程序
"-print-info {true|false}":是否打印获取命令获取到的信息
"-cover-file {true|false}":是否覆盖获取命令获取到的信息文件
"-info-file":打开"获取命令获取到的信息文件"文件夹
"-log":打开日志文件夹
".\*.patscript":执行AT脚本文件
"-h":帮助
7.3.3 特别说明
Tab键可补全命令,输入".\+文件夹"按Tab键可直接补全.patscript文件,若脚本文件在软件目录,输入".\"再按Tab键可直接补全。
输入了-f参数,Tab键可补全文件
字符串参数可以不使用引号,如-f"sample_files\test.bin"可写成-f sample_files\test.bin。不使用引号时,解析命令以空格为结束标志。
7.4 返回值
0:执行成功,没有错误
1~24:PowerWriter执行命令出错个数
1000:没有扫描到PowerWriter
1001:参数文件(-f的目标文件)不是josn文件格式
1002:参数文件(-f的目标文件)不是bin文件格式
1003:参数文件(-f的目标文件)不是pkg文件格式
1004:参数文件(-f的目标文件)不是txt文件格式
1005:波特率小于等于0
1006:time out小于等于0
1007:参数文件(-f的目标文件)不存在
1008:参数文件(-f的目标文件)为空
1009:json文件数据错误(缺少key)
1010:起始地址小于等于0
1011:数据大小小于等于0
1012:无效字符串命令参数(有效字符串参数为true, false, uarttousb, usbtouart)
2001:命令重复
2002:命令无效
2003:命令参数重复
2004:命令参数二义,2选1参数,两个参数都出现了
2005:命令参数过多
2006:文件格式错误
2007:文件不存在