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}"

Moving pypi to discotool, simplify circup call in windows

This update changes the pypi name from discotool-for-microcontrollers to discotool.

This also updates the default windows call to circup to assume the PATH was correctly set. The previous value was no longer valid because of the move to a package. To set your pip path, look at the circup guide. It's actually also required to call discotool directly once installed.

Small changes to cleanup

• cleanup takes --all as an option for --yes (like circup update)
• Enable ctrl-C abort in cleanup
• Add an example of using the discotool library to send data to a board by drive name

Fix for board information on Windows

Descriptor strings could be mangled due to a wrong length argument, making it fail to retrieve the full name on Windows.
Also the version command doesn't run the boards discovery, it just prints the version.