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
-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
--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>
-n –memwr <address>
--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
--discover 自动发现设备。如果无法识别设备或多个设备被识别,可以使用 --family 选项来指定设备系列。限制:对于 nRF51 设备,必须与 --recover 操作结合使用。
--copy <src> <dst> 将文件从源路径复制到目标路径。限制:源路径必须为现有路径,目标路径必须为新路径。
--disconnect 断开与目标设备的连接。如果在连接之前没有执行任何操作,将不会报告错误。
--snapshots 创建设备状态快照。创建快照后,可以使用 --restore 命令将设备状态恢复到快照时的状态。
-u –upload 将设备的状态上传到服务器。如果指定的服务器路径无效,上传操作将失败。
-o –output
新手必知
海量第三方学习资源.
超全常用工具与文档.
本站常用资源下载.
常见问题搜索.
QQ群: 542294007.
文章引用自:元仓库 OLIB.cn.