Better way of matching serial ports on MacOS

This adds a better pattern to match serial ports with boards on MacOS, based on their USB location.
Makes it more likely to find all serial ports for a board, in particular unusually named ones, like wch-driver generated ones.

Better way of matching serial ports on MacOS

This adds a better pattern to match serial ports with boards on MacOS, based on their USB location.
Makes it more likely to find all serial ports for a board, in particular unusually named ones, like wch-driver generated ones.

Fix mac backup error

Fix an error when using copytree for backups, caused by copystat being wonky across file systems.

Also add an option for multi criteria: discotool -y thing will select every board that has thing in its name, serial number or drive mount.

Fix for windows errors

This fixes potential crashes caused by bad returns in the windows USB list submodule.

Pass options to circup commands without question

Options to circup commands are passed as is without error.
Until now you had to escape those with --.
Note that there is no auto-complete or help for the circup options in discotool.

Before:

$ discotool install -- --auto

Now:

$ discotool install --auto

Find more bootloader drives on linux

Linux: list more boards in bootloader mode that don't have a serial connection, but have a known VID. (fix)

New USB location property

usb_location is a new entry in the device information dictionary. Platform dependent, it represents the USB path of the device, and should be consistent across resets and modes, like bootloader and Circuitpython, allowing to identify a board that has been rebooted into a new mode without changing the port it's plugged into.

Windows: list boards in bootloader mode that don't have a serial connection, but have a known VID. (fix)

Add filter with vid/pid

Add function to return a list of boards filtered by VID and PID. VID is required.

def devices_by_vidpid(vid: int, pid: Optional[int] = None) -> [DeviceInfoDict]

Fix: Avoid a crash if a volume is "ejected" on windows.

Multiple default serial tools

Find the default serial tool to use from a list.

• On windows: Tera Term Pro first, PuTTY second.
• On linux/mac: tio first, screen second.

This will change the default tool used by people who have not set their own and have the tools prioritized already installed (like if you have tio but are used to screen), but it's worth having more options.

Increase the chances of finding a serial port on macOS, and identify the RP2040 RPI-RP2 as devices on all platforms using the VID/PID.

Adding an example script to open terminal tabs for each device on mac. Thanks to @anecdata

More informative printouts when devices are not found or not valid for a command.

Backup naming options and portnum for Tera Term

Added a --format option to backup with some substitution variables: {timestamp}, {device} (name), {drive}, and {serial} (number).

discotool backup --format "{timestamp}-{device}_{drive}_{serial}" ~/Backups
# eg: 20211216-104150-Trinket_M0_CIRCUITPY_123456789ABCDEF

Added a {portnum} substitution variable for the serialtool parameter (DISCOTOOL_SERIALTOOL).
Using teraterm on Windows (doesn't use COM# but just the number).

setx DISCOTOOL_SERIALTOOL "tterpro.exe /C={portnum}"