MicroPython远程控制工具：mpremote

mpremote是microPython的一个命令行工具，可以通过串口与microPython设备进行交互并且能对设备上的文件进行管理。

mpremote的安装

mpremote的安装有下面几种方式：

• 用pip进行安装
  $ pip install --user mpremote
• 通过pipx安装
  $ pipx install mpremote

mpremote的使用

最简单的用法，不带任何参数直接运行：
$ mpremote
mpremote会自动检测并连接到第一个可用的USB串口设备，并提供一个交互式终端（命令行窗口）来访问REPL和程序的输出。
注意：
串口会以独占模式打开，运行多个mpremote实例的时候，将依次连接到后续可用的串行设备。
另外，没有安装的情况下，使用pipx也可以直接mpremote：
$ pipx run mpremote ...args

举例：

命令	含义
mpremote	连接到第一个可用设备并隐式运行该repl命令。
mpremote a1	连接到 (Linux) 上的设备/dev/ttyACM1并运行repl命令
mpremote c1	连接到 (Windows) 上的设备COM1并运行repl命令
mpremote connect /dev/ttyUSB0	连接到/dev/ttyUSB0，并运行repl命令。
mpremote a1 ls	连接到设备/dev/ttyACM0，然后运行ls命令。相当于mpremote connect /dev/ttyACM1 fs ls

常用命令参考

命令形式

mpremote支持在命令行中给出一系列命令，这些命令会在MicroPython设备上按顺序执行。
命令的的形式：
<command name> [--options] [args...]
对于支持多个参数的命令（例如文件列表），参数列表可以+结尾。
如果不指定命令，则默认命令为repl。如果之前没有connect，则会添加隐式命令connect auto。
为了连接后保证设备在确定的状态，连接后mpremote将停止之前运行的程序并软重启设备（repl除外）。可以使用resume和soft-reset命令控制此行为。

connect 连接到指定的设备

$ mpremote connect <device>
<device>可以是：

• list：列出可用设备
• auto：连接到第一个可用的USB串口
• id:<serial>：连接带有USB序列号的设备 <serial>（connect list命令输出的第二列 ）
• port:<path>：使用给定路径连接到设备（connect list命令输出的第一列）
• rfc2217://<host>:<port>：使用 TCP 串行连接到设备（例如基于 RFC2217 的网络串行端口）
• 使用其他有效的设备名称/路径连接设备

注意：

• 除了使用connect命令之外，还有一些 针对常见设备路径的预定义快捷方式。例如，a0快捷命令相当于 (Linux)，或( Windows)。connect /dev/ttyACM0c0COM0
• auto选项仅检测USB VID/PID 的串行端口（即CDC/ACM 或FTDI 类型设备）。其他类型的串口将不会被自动检测。

disconnect 断开当前设备

$ mpremote disconnect
断开连接后，自动软重置。

resume 维护后续命令的现有解释器状态

$ mpremote resume
将禁用自动软重置。如果想运行后续命令而不进行软重置可以使用resume命令。
举例：
mpremote resume exec "print_state_info()" soft-reset
连接到设备而不触发软重置并执行 print_state_info()功能（例如，查找有关当前程序状态的信息），然后触发软重置。

soft-reset 执行设备的软重置