nRF52-QA-nrfjprog常用指令

nrfjprog 命令使用指南

用法


-q –quiet 减少标准输出信息。必须与其他命令组合使用。

-h –help 显示此帮助信息。

-v –version 显示 nrfjprog 和 dll 的版本信息。

 --force                 跳过所有问题继续执行。脚本中建议使用此标志。

 --log [<path>]          启用日志记录。默认输出文件为 "log.log"。设置 <path> 选项以修改日志文件的位置和/或名称。如果 <path> 的父文件夹尚不存在,nrfjprog 将尝试创建它。日志输出总是附加到文件中。必须与其他命令组合使用。

 --jdll <file>           使用指定路径中的 Segger JLinkARM dll,而不是搜索 Segger JLinkARM dll 的最新版本。必须与其他命令组合使用。限制:不支持 Unicode 路径。

 --config <file>         使用指定路径中的 nrfjprog 设置文件,而不是搜索安装文件夹中的默认 config.toml 文件。TOML 配置文件可以包含 QSPI 和 nrfjprog 目标设置。必须与其他命令组合使用。

 --storeconfig <file>    将从 --config / --ini / --qspiini 和命令行加载的 nrfjprog 设置以 toml 格式存储到 <file> 中。此选项可用于将旧的 .ini 文件转换为 .toml 文件,例如。

 --ini <file>            已弃用:请使用 --config 选项中的 TOML 文件。使用指定的 ini 文件路径中的 nrfjprog 设置文件,而不是搜索安装文件夹中的默认 config.toml 文件。必须与其他命令组合使用。

 --qspiini <file>        已弃用:请使用 --config 选项中的 TOML 文件。使用指定路径中的 QSPI 设置文件,而不是搜索安装文件夹中的默认 config.toml 文件。必须与 --erasepage, --memrd, --memwr, --program, --verify, --readqspi 或 --qspieraseall 命令中的一个组合使用。限制:对于 nRF51 设备,此操作不可用。对于 nRF52 设备,没有 QSPI 外设的设备此操作不可用。对于 nRF91 设备,此操作不可用。

 --qspicustominit        已弃用,此操作无效。

-i –ids 显示所有连接到 PC 的调试器的序列号。

 --expand                扩展 --ids 打印的信息。这对于查看网络连接的调试探头的附加信息很有用。

 --com                   显示与所有连接的调试器关联的串行端口列表。如果与 --snr 组合使用,将显示与该调试器关联的所有串行端口。

 --deviceversion         显示连接设备的类型。如果与 --snr 组合使用,将显示与该调试器关联的设备。如果未与 --snr 组合使用,将显示与所有连接的调试器关联的设备。

-f –family 选择设备系列进行操作。有效的参数选项为 NRF51, NRF52, NRF53, NRF91 和 UNKNOWN。如果指定 UNKNOWN 系列,将自动检测设备系列。请注意,提供实际系列比执行自动系列检测要快。如果未指定 --family 选项,则默认为 nrfjprog.ini 中的默认值。必须与其他命令组合使用。

-s –snr 选择具有指定序列号的调试器进行操作。必须与其他命令组合使用。

 --ip [<hostname>|<ip>|<tunnel>]        提供目标调试器的网络连接字符串。该字符串可以是 IPv4 地址或主机名。可以使用 --port 选项指定连接的端口。传递 --ip 而没有任何参数等同于传递 --iface ip。可以连接到处于隧道模式的调试器。不支持缩短的隧道连接字符串格式。隧道模式连接字符串的示例是:"tunnel:123456789:pwd:jlink-europe.segger.com"。有关 JLink 连接类型的更多信息,请访问 "https://wiki.segger.com/J-Link_Remote_Server"。必须与其他命令组合使用。

 --port <port>           选择建立网络连接时使用的端口。必须与 --ip 选项一起使用。默认端口是 19020。

-c –clockspeed 设置调试器 SWD 时钟速度,单位为 kHz。有效的时钟速度参数范围从 4 kHz 到 50000 kHz。如果指定的时钟速度超出了仿真器支持的最大速度,则使用最大速度。如果未指定 --clockspeed 选项,则默认为 nrfjprog.ini 中的默认值。必须与其他命令组合使用。

 --iface <USB|IP> [USB|IP]            设置搜索和连接调试器时使用的接口。USB 和 IP 可以同时列出。默认情况下,只有 USB 连接的调试器会被目标,除非存在 --ip 选项。此选项主要用于与 --snr 和 --ids 组合使用。必须与其他命令组合使用。

 --recover               擦除所有用户可用的非易失性内存,并禁用启用的读取保护机制。

 --rbp <level>           启用读取保护机制。有效的参数选项为 CR0 和 ALL。限制:对于 nRF52 设备,CR0 参数选项无效。副作用:执行 --rbp 操作后,可用的操作会减少。对于 nRF51 设备,如果使用 ALL 参数选项,--pinreset 将无法在某些旧设备上工作。对于 nRF52 设备,只有 --pinreset, --debugreset 或 --recover 操作在执行 --rbp 后可用。

 --pinresetenable        启用通过使用 UICR PSELRESET 寄存器进行引脚复位。限制:对于 nRF51 设备,命令不可用。对于 nRF53 设备,命令不可用。对于 nRF91 设备,命令不可用。

-p –pinreset 执行引脚复位。操作后核心将运行。可以与 –program 操作结合使用。如果与 –program 操作结合使用,复位将在闪存操作后发生,以开始执行。

 --hardreset             执行硬复位。操作后核心将运行。可以与 --program 操作结合使用。如果与 --program 操作结合使用,复位将在闪存操作后发生,以开始执行。限制:对于 nRF51 设备,命令不可用。对于 nRF53 设备,命令不可用。对于 nRF91 设备,命令不可用。

-r –reset 通过设置核心的 AIRCR 寄存器的 SysResetReq 位来执行软复位。操作后核心将运行。可以与 –program 操作结合使用。如果与 –program 操作结合使用,复位将在闪存操作后发生,以开始执行。

-d –debugreset 通过使用 CTRL-AP 执行软复位。操作后核心将运行。可以与 –program 操作结合使用。如果与 –program 操作结合使用,调试复位将在闪存操作后发生,以开始执行。限制:对于 nRF51 设备,–debugreset 操作不可用。对于 nRF52 设备,–debugreset 操作在 nRF52832_xxAA_ENGA 设备上不可用。

-e –eraseall 擦除所有用户可用的程序闪存和 UICR 页。可以与 –qspieraseall 操作结合使用。限制:对于 nRF51 设备,如果设备来自 Nordic 并预编程了 SoftDevice,则仅擦除用户可用的代码闪存和 UICR。

 --qspieraseall          擦除所有外部存储器设备的闪存,借助 QSPI 外设。请注意,根据外部存储器设备的擦除速度,此操作可能需要几分钟。可以与 --eraseall 操作结合使用。限制:对于 nRF51 设备,此操作不可用。对于 nRF52 设备,没有 QSPI 外设的设备此操作不可用。对于 nRF52 设备,此操作仅适用于连接了外部存储器设备的设备。要确定是否连接了外部存储器设备,nrfjprog 会检查 QspiDefault.ini 文件中的 MemSize 参数或与 --qspiini 选项一起提供的 QSPI 配置 ini 文件。对于 nRF91 设备,此操作不可用。

 --eraseuicr             擦除 UICR 页。限制:对于 nRF51 设备,此操作仅在设备来自 Nordic 并预编程了 SoftDevice 时可用。对于 nRF91 设备,此操作不可用,请使用 --eraseall。

 --erasepage <start[-end]>                      擦除从包含起始地址的闪存页开始,到包含结束地址的页(不包括在擦除范围内)结束的所有闪存页。限制:起始地址必须是 4kB 页的开始地址(例如,0x1000、0x2000、0x3000 等)。如果结束地址省略,擦除操作将在起始地址处擦除一页。可以与 --program 操作结合使用。注意:与 --erasepage 一起使用的地址必须是设备的有效地址。对于 nRF51 设备,最大值是 0xFFFFF000。对于 nRF52 设备,最大值是 0xFFFFFFFF。对于 nRF53 设备,最大值是 0x7FFFFFFF。

-m –memrd <address> 从指定地址读取指定长度的内存区域并将其写入文件。对于地址和长度,指定的值应为十六进制。限制:对于 nRF51 设备和 nRF53 设备,地址必须在 0x10000000 到 0x20000000 之间。对于 nRF52 设备,地址和长度必须在设备的闪存范围内。

-n –memwr <address> 从指定文件写入指定长度的内存区域。对于地址和长度,指定的值应为十六进制。限制:对于 nRF51 设备和 nRF53 设备,地址必须在 0x10000000 到 0x20000000 之间。对于 nRF52 设备,地址和长度必须在设备的闪存范围内。

 --program <file>        将指定的二进制文件编程到设备的闪存中。如果指定的文件包含多个二进制文件,nrfjprog 将自动将文件分为多个段并将它们分别编程到设备的闪存中。限制:nRF51 设备仅支持将单个二进制文件编程到设备的闪存中。对于 nRF52 设备,如果指定的二进制文件的大小大于设备的闪存大小,程序将失败。如果指定的文件包含多个二进制文件,nrfjprog 将自动将文件分为多个段并将它们分别编程到设备的闪存中。

 --verify <file>         验证指定的二进制文件是否正确编程到设备的闪存中。验证成功时不会报告任何消息。限制:对于 nRF51 设备和 nRF53 设备,文件必须是二进制格式的文件。对于 nRF52 设备,文件必须是二进制格式的文件。

 --readqspi <file>        将外部 QSPI 存储器中的数据读取到指定的文件中。限制:对于 nRF51 设备,此操作不可用。对于 nRF52 设备,没有 QSPI 外设的设备此操作不可用。对于 nRF91 设备,此操作不可用。

 --qspieepromrd <file>    读取 QSPI EEPROM 的数据并将其写入指定的文件中。限制:对于 nRF51 设备,此操作不可用。对于 nRF52 设备,没有 QSPI 外设的设备此操作不可用。对于 nRF91 设备,此操作不可用。

 --qspieepromwr <file>    将数据从指定的文件写入 QSPI EEPROM。限制:对于 nRF51 设备,此操作不可用。对于 nRF52 设备,没有 QSPI 外设的设备此操作不可用。对于 nRF91 设备,此操作不可用。

-a –aeroprobe 在使用 Aeroprobe 调试探头时,可以使用该选项指定探头名称。限制:必须在 --recover 操作之前使用此选项。

 --discover              自动发现设备。如果无法识别设备或多个设备被识别,可以使用 --family 选项来指定设备系列。限制:对于 nRF51 设备,必须与 --recover 操作结合使用。

 --copy <src> <dst>      将文件从源路径复制到目标路径。限制:源路径必须为现有路径,目标路径必须为新路径。

 --disconnect            断开与目标设备的连接。如果在连接之前没有执行任何操作,将不会报告错误。

 --snapshots             创建设备状态快照。创建快照后,可以使用 --restore 命令将设备状态恢复到快照时的状态。

-u –upload 将设备的状态上传到服务器。如果指定的服务器路径无效,上传操作将失败。

-o –output 将命令输出保存到指定的文件中。必须与其他命令组合使用。

新手必知

海量第三方学习资源.

超全常用工具与文档.

本站常用资源下载.

常见问题搜索.

QQ群: 542294007.

文章引用自:元仓库 OLIB.cn.