跳到主要内容
版本:Next

5.2:AT应用范例

警告
  • PWLINK2(含Lite)、PW400 不支持当前页面所描述的功能,请留意。
  • 使用AT 功能需要先对设备开启AT 模式,参考: 设备首选项.

本章节将详细地介绍 PowerWriter AT GUI 相关的软件系统, 用户可以将其作为软件的使用指南, 或者是参考手册, 当遇到不理解的内容时, 可以随时查阅。

软件下载地址:

PowerWriter -> 资料下载 -> 客户端-> PowerWriter AT 应用

1. PowerWriter AT GUI主界面

PowerWriter AT GUI应用软件的启动界面如下图 1.1.1 所示。

图 1.1.1 Power Writer 应用软件主界面

2. PowerWriter AT GUI 功能

2.1 添加命令

弹出命令选择界面,如图1.1.1.1AT命令选择界面所示

image-20241203192141453

图 1.1.1.1 AT命令选择界面

鼠标单击指定的AT命令,便会将对应的命令添加到命令列表中来,若命令有参数需要设置,命令列表的"AT命令参数"列则会提示“鼠标双击设置或修改参数”,若需要修改AT命令,鼠标双击"AT命令"列即可,如下图1.1.1.2命令列表所示

图 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脚本文件导出所示

图 1.1.1.3 AT脚本文件导出

2.8 加载AT脚本

将选定的AT脚本文件导入到命令列表中来。

2.9 扫描AT端口

扫描开启了“USB端口AT功能”的PowerWriter,并将扫描到的端口显示到软件界面上,若未扫描到设备,则会提示"未扫描到PowerWriter,请检查设备连接情况",如下图1.1.1.4 AT端口所示

图 1.1.1.4 AT端口

2.10 断开端口连接

断开所有的端口连接,如下图1.1.1.5 断开端口所示

图 1.1.1.5 断开端口

2.11 执行AT命令

各个已连接的端口,多线程并发执行命令列表里的所有命令,每执行完一条命令会打印执行结果,命令执行出错,对应的端口将停止执行命令,并报错。如下图1.1.1.6 命令执行所示

图 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 查看文件所示

图 1.1.1.7 查看文件

3. 参数设置界面

鼠标双击"AT命令"列,若该命令需要设置参数,则会弹出参数设置界面,不同的命令会显示不同的参数,注:若AT命令是更新"PW配置",还会将设置好的配置保存为json文件,路径为软件根目录\writer_cfg.json。如下图1.2.1 和1.2.2 所示

图 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所示

图 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":设置地址(1016进制)
"-s":设置数据大小(1016进制)
"-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。

图 2.1

图 2.1-2

7.2 带参数运行命令行软件

可带的参数为一个AT命令码,或.\AT脚本文件,程序会自动执行"-scan"命令,然后再执行输入的参数命令,命令执行完成,程序结束。如下图2.2和图2.3所示:

图 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 特别说明

  1. Tab键可补全命令,输入".\+文件夹"按Tab键可直接补全.patscript文件,若脚本文件在软件目录,输入".\"再按Tab键可直接补全。

  2. 输入了-f参数,Tab键可补全文件

  3. 字符串参数可以不使用引号,如-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:文件不存在