upyboard 0.9.0

This is a CLI tool for MicroPython-based embedded systems.

This tool is supports microcontrollers to which MicroPython is ported.

Help

upy

or

upy --help

Finding the serial port on a board with MicroPython

• Explore a serially connected MicroPython device.
• The MicroPython version and device type are printed.
• Currently supported devices are Digi XBee3 and Raspberry Pi Pico 2 W

upy scan

• The --raw (or -r) option returns low-level board information.

upy scan -r

Option Rules

• Options and values can have spaces or omit spaces.
• Options and values can be inserted with the = character.

<option><value>  
<option> <value>
<option>=<value> 

Environment

• Convert a VSCode workspace into a MicroPython workspace
• Assuming the result of the scan argument is COM3

upy -sport com3 env

• You can omit this option by saving the environment variables required to run the tool in the current path in a .vscode/.upyboard file.
• By defining SERIAL_PORT in this file, you can omit the --sport(or -s) options to be included in each command.

SERIAL_PORT=<your_com_port_name>

Example (.upyboard)

SERIAL_PORT=com3

Initialize Microcontroller file system

• If you created a .vscode/.upyboard file in the current path, omit the --sport(or -s) options in all subsequent commands.

upy init

or, You can also use the --sport(or -s) options explicitly.

upy --sport <your_com_port_name> init

Check list of Microcontroller file systems

• If path is omitted, the output will be the files or directories contained in the top-level directory.

upy ls [<path>/][remote_directory]

Put PC file or directroy into Microcontroller

• If path or remote name is omitted, a remote name identical to the local name is created in the top-level directory.

upy put <local_name> [[path][/remote_name]]

Get Microcontroller file to PC

• Getting the current directory is not supported.

upy get <remote_file_name> <local_file_name>

Delete Microcontroller file or directory

upy rm [path/]<remote_name>

Executes the PC's MicroPython script by sequentially passing it to the Microcontroller

• Wait for serial input/output until the script finishes
• To force quit in running state, press Ctrl+c

upy <micropython_script_file>

or

upy run [-i | -n] <micropython_script_file>

Additional Options

• -i: Display the pressed key in the terminal window (Echo on)
• -n: Does not wait for serial output, so it appears as if the program has terminated on the PC side.
  • Script continues to run on Microcontroller
  • Used to check data output serially from Microcontroller with other tools (PuTTY, etc.)