mpflash 0.6.0__py3-none-any.whl → 0.7.1__py3-none-any.whl

mpflash/ask_input.py

@@ -12,7 +12,7 @@ from typing import Dict, List, Sequence, Tuple, Union
 from loguru import logger as log
 
 from mpflash.config import config
-from mpflash.mpboard_id import known_stored_boards, local_mp_ports
+from mpflash.mpboard_id import get_stored_boards_for_port, known_stored_boards, local_mp_ports
 from mpflash.mpremoteboard import MPRemoteBoard
 from mpflash.vendor.versions import micropython_versions
 
@@ -131,7 +131,7 @@ def filter_matching_boards(answers: dict) -> Sequence[Tuple[str, str]]:
         # Get the values of the dictionary, which are the unique items from the original list
         some_boards = list(unique_dict.values())
     else:
-        some_boards = [("No boards found", "")]
+        some_boards = [(f"No {answers['port']} boards found for version(s) {_versions}", "")]
     return some_boards
 
 
@@ -186,12 +186,27 @@ def ask_versions(questions: list, *, action: str):
     """
     # import only when needed to reduce load time
     import inquirer
+    import inquirer.errors
 
     input_ux = inquirer.Checkbox if action == "download" else inquirer.List
     mp_versions: List[str] = micropython_versions()
     mp_versions = [v for v in mp_versions if "preview" not in v]
+
+    # remove the versions for which there are no known boards in the board_info.json
+    # todo: this may be a little slow
+    mp_versions = [v for v in mp_versions if get_stored_boards_for_port("stm32", [v])]
+
     mp_versions.append("preview")
     mp_versions.reverse()  # newest first
+
+    def at_least_one_validation(answers, current) -> bool:
+        if not current:
+            raise inquirer.errors.ValidationError("", reason="Please select at least one version")
+        if isinstance(current, list):
+            if not any(current):
+                raise inquirer.errors.ValidationError("", reason="Please select at least one version")
+        return True
+
     questions.append(
         input_ux(
             # inquirer.List(
@@ -201,7 +216,7 @@ def ask_versions(questions: list, *, action: str):
             # hints=["Use space to select multiple options"],
             choices=mp_versions,
             autocomplete=True,
-            validate=lambda _, x: True if x else "Please select at least one version",  # type: ignore
+            validate=at_least_one_validation,
         )
     )
 

mpflash/cli_download.py

@@ -6,6 +6,7 @@ from typing import List, Tuple
 import rich_click as click
 from loguru import logger as log
 
+from mpflash.errors import MPFlashError
 from mpflash.mpboard_id import find_stored_board
 from mpflash.vendor.versions import clean_version
 
@@ -62,9 +63,7 @@ from .download import download
     show_default=True,
     help="""Force download of firmware even if it already exists.""",
 )
-def cli_download(
-    **kwargs,
-):
+def cli_download(**kwargs) -> int:
     params = DownloadParams(**kwargs)
     params.versions = list(params.versions)
     params.boards = list(params.boards)
@@ -77,18 +76,23 @@ def cli_download(
 
     params = ask_missing_params(params, action="download")
     if not params:  # Cancelled by user
-        exit(1)
+        return 2
     params.versions = [clean_version(v, drop_v=True) for v in params.versions]
     assert isinstance(params, DownloadParams)
 
-    download(
-        params.fw_folder,
-        params.ports,
-        params.boards,
-        params.versions,
-        params.force,
-        params.clean,
-    )
+    try:
+        download(
+            params.fw_folder,
+            params.ports,
+            params.boards,
+            params.versions,
+            params.force,
+            params.clean,
+        )
+        return 0
+    except MPFlashError as e:
+        log.error(f"{e}")
+        return 1
 
 
 def connected_ports_boards() -> Tuple[List[str], List[str]]:

mpflash/cli_flash.py

@@ -13,7 +13,7 @@ from .cli_group import cli
 from .cli_list import show_mcus
 from .config import config
 from .flash import flash_list
-from .worklist import WorkList, full_auto_worklist, manual_worklist, single_auto_worklist
+from .worklist import MPRemoteBoard, WorkList, full_auto_worklist, manual_worklist, single_auto_worklist
 
 # #########################################################################################################
 # CLI
@@ -28,7 +28,7 @@ from .worklist import WorkList, full_auto_worklist, manual_worklist, single_auto
     "--firmware",
     "-f",
     "fw_folder",
-    type=click.Path(exists=True, file_okay=False, dir_okay=True, path_type=Path),
+    type=click.Path(file_okay=False, dir_okay=True, path_type=Path),
     default=config.firmware_folder,
     show_default=True,
     help="The folder to retrieve the firmware from.",
@@ -91,7 +91,7 @@ from .worklist import WorkList, full_auto_worklist, manual_worklist, single_auto
     show_default=True,
     help="""Enter micropython bootloader mode before flashing.""",
 )
-def cli_flash_board(**kwargs):
+def cli_flash_board(**kwargs) -> int:
     # version to versions, board to boards
     kwargs["versions"] = [kwargs.pop("version")] if kwargs["version"] != None else []
     if kwargs["board"] is None:
@@ -104,6 +104,11 @@ def cli_flash_board(**kwargs):
     if not params.boards or params.boards == []:
         # nothing specified - detect connected boards
         params.ports, params.boards = connected_ports_boards()
+        if params.boards == []:
+            # No MicroPython boards detected, but it could be unflashed or not in bootloader mode
+            # Ask for serial port and board_id to flash
+            params.serial = "?"
+            params.boards = ["?"]
     else:
         for board_id in params.boards:
             if board_id == "":
@@ -122,7 +127,7 @@ def cli_flash_board(**kwargs):
     # Ask for missing input if needed
     params = ask_missing_params(params, action="flash")
     if not params:  # Cancelled by user
-        exit(1)
+        return 2
     # TODO: Just in time Download of firmware
 
     assert isinstance(params, FlashParams)
@@ -130,9 +135,9 @@ def cli_flash_board(**kwargs):
     if len(params.versions) > 1:
         log.error(f"Only one version can be flashed at a time, not {params.versions}")
         raise MPFlashError("Only one version can be flashed at a time")
-    if len(params.boards) > 1:
-        log.error(f"Only one board can be flashed at a time, not {params.boards}")
-        raise MPFlashError("Only one board can be flashed at a time")
+    # if len(params.boards) > 1:
+    #     log.error(f"Only one board can be flashed at a time, not {params.boards}")
+    #     raise MPFlashError("Only one board can be flashed at a time")
 
     params.versions = [clean_version(v) for v in params.versions]
     worklist: WorkList = []
@@ -163,3 +168,7 @@ def cli_flash_board(**kwargs):
     ):
         log.info(f"Flashed {len(flashed)} boards")
         show_mcus(flashed, title="Updated boards after flashing")
+        return 0
+    else:
+        log.error("No boards were flashed")
+        return 1

mpflash/cli_group.py

@@ -11,7 +11,7 @@ from .logger import make_quiet, set_loglevel
 
 def cb_verbose(ctx, param, value):
     """Callback to set the log level to DEBUG if verbose is set"""
-    if value:
+    if value and not config.quiet:
         set_loglevel("DEBUG")
         config.verbose = True
     else:

mpflash/cli_list.py

@@ -26,7 +26,7 @@ from .logger import make_quiet
     show_default=True,
     help="""Show progress""",
 )
-def cli_list_mcus(as_json: bool, progress: bool = True):
+def cli_list_mcus(as_json: bool, progress: bool = True) -> int:
     """List the connected MCU boards, and output in a nice table or json."""
     if as_json:
         # avoid noise in json output
@@ -38,4 +38,4 @@ def cli_list_mcus(as_json: bool, progress: bool = True):
         progress = False
     if progress:
         show_mcus(conn_mcus, refresh=False)
-    return conn_mcus
+    return 0 if conn_mcus else 1

mpflash/cli_main.py

@@ -2,13 +2,13 @@
 
 # import rich_click as click
 
+import click
+
 from .cli_download import cli_download
 from .cli_flash import cli_flash_board
 from .cli_group import cli
 from .cli_list import cli_list_mcus
 
-# from loguru import logger as log
-
 
 def mpflash():
     cli.add_command(cli_flash_board)
@@ -16,7 +16,8 @@ def mpflash():
     cli.add_command(cli_download)
     # cli(auto_envvar_prefix="MPFLASH")
     try:
-        exit(cli())
+        result = cli(standalone_mode=False)
+        exit(result)
     except AttributeError as e:
         print(f"Error: {e}")
         exit(-1)

mpflash/download.py

@@ -19,6 +19,7 @@ from loguru import logger as log
 from rich.progress import track
 
 from mpflash.common import PORT_FWTYPES
+from mpflash.errors import MPFlashError
 
 jsonlines.ujson = None  # type: ignore
 # #########################################################################################################
@@ -165,7 +166,7 @@ def download_firmwares(
     *,
     force: bool = False,
     clean: bool = True,
-):
+) -> int:
     skipped = downloaded = 0
     if versions is None:
         versions = []
@@ -200,6 +201,7 @@ def download_firmwares(
             writer.write(board)
             downloaded += 1
     log.info(f"Downloaded {downloaded} firmwares, skipped {skipped} existing files.")
+    return downloaded + skipped
 
 
 def get_firmware_list(ports: List[str], boards: List[str], versions: List[str], clean: bool):
@@ -246,7 +248,7 @@ def download(
     versions: List[str],
     force: bool,
     clean: bool,
-):
+) -> int:
     """
     Downloads firmware files based on the specified destination, ports, boards, versions, force flag, and clean flag.
 
@@ -259,19 +261,20 @@ def download(
         clean : A flag indicating whether to perform a clean download.
 
     Returns:
-        None
+        int: The number of downloaded firmware files.
 
     Raises:
-        SystemExit: If no boards are found or specified.
+        MPFlashError : If no boards are found or specified.
 
     """
     if not boards:
         log.critical("No boards found, please connect a board or specify boards to download firmware for.")
-        exit(1)
+        raise MPFlashError("No boards found")
     # versions = [clean_version(v, drop_v=True) for v in versions]  # remove leading v from version
     try:
         destination.mkdir(exist_ok=True, parents=True)
     except (PermissionError, FileNotFoundError) as e:
-        log.critical(f"Could not create folder {destination}\n{e}")
-        exit(1)
-    download_firmwares(destination, ports, boards, versions, force=force, clean=clean)
+        log.critical(f"Could not create folder {destination}")
+        raise MPFlashError(f"Could not create folder {destination}") from e
+
+    return download_firmwares(destination, ports, boards, versions, force=force, clean=clean)

mpflash/flash_uf2.py

@@ -56,6 +56,6 @@ def flash_uf2(mcu: MPRemoteBoard, fw_file: Path, erase: bool) -> Optional[MPRemo
     log.success("Done copying, resetting the board and wait for it to restart")
     if sys.platform in ["linux", "darwin"]:
         dismount_uf2()
-    for _ in track(range(5 + 2)):
+    for _ in track(range(5 + 2), description="Waiting for the board to restart", transient=True):
         time.sleep(1)  # 5 secs to short on linux
     return mcu

mpflash/list.py

@@ -1,14 +1,19 @@
 from typing import List
 
 from rich import print
-from rich.progress import track
-from rich.table import Table
+from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn, track
+from rich.table import Column, Table
 
 from mpflash.mpremoteboard import MPRemoteBoard
+from mpflash.vendor.versions import clean_version
 
 from .config import config
 from .logger import console
 
+rp_spinner = SpinnerColumn(finished_text="✅")
+rp_text = TextColumn("{task.description} {task.fields[device]}", table_column=Column())
+rp_bar = BarColumn(bar_width=None, table_column=Column())
+
 
 def list_mcus(bluetooth: bool = False):
     """
@@ -21,12 +26,24 @@ def list_mcus(bluetooth: bool = False):
     """
     conn_mcus = [MPRemoteBoard(sp) for sp in MPRemoteBoard.connected_boards(bluetooth) if sp not in config.ignore_ports]
 
-    for mcu in track(conn_mcus, description="Getting board info", transient=True, update_period=0.1):
+    # a lot of boilerplate to show a progress bar with the comport currenlty scanned
+    with Progress(rp_spinner, rp_text, rp_bar, TimeElapsedColumn()) as progress:
+        tsk_scan = progress.add_task("[green]Scanning", visible=False, total=None)
+        progress.tasks[tsk_scan].fields["device"] = "..."
+        progress.tasks[tsk_scan].visible = True
+        progress.start_task(tsk_scan)
         try:
-            mcu.get_mcu_info()
-        except ConnectionError as e:
-            print(f"Error: {e}")
-            continue
+            for mcu in conn_mcus:
+                progress.update(tsk_scan, device=mcu.serialport.replace("/dev/", ""))
+                try:
+                    mcu.get_mcu_info()
+                except ConnectionError as e:
+                    print(f"Error: {e}")
+                    continue
+        finally:
+            # transient
+            progress.stop_task(tsk_scan)
+            progress.tasks[tsk_scan].visible = False
     return conn_mcus
 
 
@@ -38,11 +55,10 @@ def show_mcus(
     """Show the list of connected boards in a nice table"""
     table = Table(
         title=title,
-        title_style="bold",
-        header_style="bold blue",
+        title_style="magenta",
+        header_style="bold magenta",
         collapse_padding=True,
         width=110,
-        row_styles=["blue", "yellow"],
     )
     table.add_column("Serial", overflow="fold")
     table.add_column("Family")
@@ -59,14 +75,15 @@ def show_mcus(
                 mcu.get_mcu_info()
             except ConnectionError:
                 continue
+        description = f"[italic bright_cyan]{mcu.description}" if mcu.description else ""
         table.add_row(
             mcu.serialport.replace("/dev/", ""),
             mcu.family,
             mcu.port,
-            f"{mcu.board}\n{mcu.description}".strip(),
+            f"{mcu.board}\n{description}".strip(),
             # mcu.variant,
             mcu.cpu,
-            mcu.version,
+            clean_version(mcu.version),
             mcu.build,
         )
     console.print(table)

mpflash/mpremoteboard/__init__.py

@@ -65,8 +65,9 @@ class MPRemoteBoard:
 
     @staticmethod
     def connected_boards(bluetooth: bool = False) -> List[str]:
+        # TODO: rename to connected_comports
         """
-        Get a list of connected boards.
+        Get a list of connected comports.
 
         Parameters:
         - bluetooth (bool): Whether to include Bluetooth ports. Default is False.
@@ -74,14 +75,14 @@ class MPRemoteBoard:
         Returns:
         - List[str]: A list of connected board ports.
         """
-        ports = serial.tools.list_ports.comports()
+        comports = serial.tools.list_ports.comports()
 
         if not bluetooth:
             # filter out bluetooth ports
-            ports = [p for p in ports if "bluetooth" not in p.description.lower()]
-            ports = [p for p in ports if "BTHENUM" not in p.hwid]
+            comports = [p for p in comports if "bluetooth" not in p.description.lower()]
+            comports = [p for p in comports if "BTHENUM" not in p.hwid]
 
-        return sorted([p.device for p in ports])
+        return sorted([p.device for p in comports])
 
     @retry(stop=stop_after_attempt(RETRIES), wait=wait_fixed(1), reraise=True)  # type: ignore ## retry_error_cls=ConnectionError,
     def get_mcu_info(self, timeout: int = 2):

mpflash/mpremoteboard/runner.py

@@ -21,6 +21,17 @@ class LogTags:
     ignore_tags: LogTagList
 
 
+DEFAULT_RESET_TAGS = [
+    # ESP32 reset causes
+    "rst cause:1, boot mode:",  # 1 -> hardware watch dog reset
+    "rst cause:2, boot mode:",  # 2 -> software watch dog reset (From an exception)
+    "rst cause:3, boot mode:",  # 3 -> software watch dog reset system_restart (Possibly unfed watchdog got angry)
+    "rst cause:4, boot mode:",  # 4 -> soft restart (Possibly with a restart command)
+    "boot.esp32: PRO CPU has been reset by WDT.",
+    "rst:0x10 (RTCWDT_RTC_RESET)",
+]
+
+
 def run(
     cmd: List[str],
     timeout: int = 60,
@@ -57,18 +68,7 @@ def run(
         The return code and the output as a list of strings
     """
     if not reset_tags:
-        reset_tags = [
-            "rst cause:1, boot mode:",
-            "rst cause:2, boot mode:",
-            "rst cause:3, boot mode:",
-            "rst cause:4, boot mode:",
-        ]
-        # 0 -> normal startup by power on
-        # 1 -> hardware watch dog reset
-        # 2 -> software watch dog reset (From an exception)
-        # 3 -> software watch dog reset system_restart (Possibly unfed watchdog got angry)
-        # 4 -> soft restart (Possibly with a restart command)
-        # 5 -> wake up from deep-sleep
+        reset_tags = DEFAULT_RESET_TAGS
     if not error_tags:
         error_tags = ["Traceback ", "Error: ", "Exception: ", "ERROR :", "CRIT  :"]
     if not warning_tags:

mpflash/worklist.py

@@ -24,7 +24,7 @@ def auto_update(
     *,
     selector: Optional[Dict[str, str]] = None,
 ) -> WorkList:
-    """Builds a list of boards to update based on the connected boards and the firmware available
+    """Builds a list of boards to update based on the connected boards and the firmwares available locally in the firmware folder.
 
     Args:
         conn_boards (List[MPRemoteBoard]): List of connected boards

{mpflash-0.6.0.dist-info → mpflash-0.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mpflash
-Version: 0.6.0
+Version: 0.7.1
 Summary: Flash and download tool for MicroPython firmwares
 Home-page: https://github.com/Josverl/micropython-stubber/blob/main/src/mpflash/README.md
 License: MIT
@@ -32,23 +32,23 @@ Requires-Dist: pygithub (>=2.1.1,<3.0.0)
 Requires-Dist: pyusb (>=1.2.1,<2.0.0)
 Requires-Dist: requests (>=2.31.0,<3.0.0)
 Requires-Dist: rich-click (>=1.7.3,<2.0.0)
-Requires-Dist: strip-ansi (>=0.1.1,<0.2.0)
 Requires-Dist: tenacity (==8.2.3)
 Project-URL: Repository, https://github.com/Josverl/micropython-stubber
 Description-Content-Type: text/markdown
 
-# mpflash
-mpflash is a command-line tool for working with MicroPython firmware. It provides various features to help you develop, build, and manage your MicroPython projects.
+# MPFLASH
 
-This tool was created to be used in a CI/CD pipeline to automate the process of downloading and flashing MicroPython firmware to multiple boards, but it can also be used for manual flashing and development.
+`mpflash` is a command-line tool for working with MicroPython firmware. It provides features to help you flash and update Micropython on one or more .
 
-mpflash has been tested on Windows x64, Linux X64 and ARM64, but not (yet) macOS.
+This tool was initially created to be used in a CI/CD pipeline to automate the process of downloading and flashing MicroPython firmware to multiple boards, but it has been extend with a TUI to me be used for manual downloadig, flashing and development.
+
+`mpflash` has been tested on Windows x64, Linux X64, but not (yet) macOS.
+Tested ports: `rp2`, `samd`, `esp32`, `esp32s3`, `esp32c3`, `esp8266` and `stm32`
 
 ## Features
  1. List the connected boards including their firmware details, in a tabular or json format
- 2. Download MicroPython firmware for specific boards and versions.
- 3. Flash one or all connected MicroPython boards with a specific firmware or version.
-    Tested ports: rp2, samd, esp32, esp32s3, esp8266 and stm32
+ 2. Download MicroPython firmware for versions, and matching a specified board or matches your current attached board.
+ 3. Flash one or all connected MicroPython boards with a specific firmware or version.  
  
 ## Installation
 To install mpflash, you can use pip: `pip install mpflash`
@@ -69,40 +69,40 @@ On Windows this will not be an issue, but on Linux you can use  udev rules to gi
 [See the stm32_permissions documentation](./stm32_udev_rules.md) for more information.
 
 
-## Advanced use
+## Detailed usage
 You can list the connected boards using the following command:
 ```bash
 $ mpflash list
 D:\MyPython\micropython-stubber> mpflash list
-Getting board info ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:02
-                                       Connected boards
-┏━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━┓
-┃ Serial ┃ Family      ┃ Port    ┃ Board              ┃ CPU         ┃ Version        ┃ build ┃
-┡━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━┩
-│ COM11  │ micropython │ rp2     │ RPI_PICO_W         │ RP2040      │ 1.20.0         │       │
-│ COM12  │ micropython │ esp8266 │ ESP8266_GENERIC    │ ESP8266     │ 1.22.2         │       │
-│ COM18  │ micropython │ rp2     │ RPI_PICO_W         │ RP2040      │ 1.23.0-preview │ 155   │
-│ COM3   │ micropython │ samd    │ SEEED_WIO_TERMINAL │ SAMD51P19A  │ 1.23.0-preview │ 155   │
-│ COM5   │ micropython │ stm32   │ PYBV11             │ STM32F405RG │ 1.23.0-preview │ 166   │
-│ COM8   │ micropython │ esp32   │ ESP32_GENERIC_S3   │ ESP32S3     │ 1.23.0-preview │ 155   │
-└────────┴─────────────┴─────────┴────────────────────┴─────────────┴────────────────┴───────┘
+                                               Connected boards
+┏━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━┓
+┃ Serial  ┃Family       ┃Port  ┃Board                                      ┃CPU     ┃Version          ┃build ┃
+┡━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━┩
+│ COM21   │micropython  │rp2   │RPI_PICO                                   │RP2040  │v1.23.0-preview  │  236 │
+│         │             │      │Raspberry Pi Pico with RP2040              │        │                 │      │
+│ COM23   │micropython  │rp2   │RPI_PICO_W                                 │RP2040  │v1.23.0-preview  │  176 │
+│         │             │      │Raspberry Pi Pico W with RP2040            │        │                 │      │
+│ COM9    │micropython  │rp2   │ARDUINO_NANO_RP2040_CONNECT                │RP2040  │v1.23.0-preview  │  341 │
+│         │             │      │Arduino Nano RP2040 Connect with RP2040    │        │                 │      │
+└─────────┴─────────────┴──────┴───────────────────────────────────────────┴────────┴─────────────────┴──────┘
 ```
+## Download the firmware
 
-Suppose you want to download the MicroPython firmware for some boards, you can use the following command: 
+To download the MicroPython firmware for some boards, use the following command: 
+ - `mpflash download` download the latest stable firmware for all connected boards
+ - `mpflash download --version preview` download the current preview for all connected boards
+ - `mpflash download --board ESP8266_GENERIC --board SEEED_WIO_TERMINAL` download these specific boards
+ - `mpflash download --version ? --board ?` prompt to select a specific version and board to download
 
-```bash
-# download the firmware
-$ mpflash download --board ESP8266_GENERIC --board SEEED_WIO_TERMINAL
-```	
-This will download the latest stable version of the MicroPython firmware for the boards and save it in the `firmware` directory.
+These will try to download the prebuilt MicroPython firmware for the boards from https://micropython.org/download/ and save it in your downloads folder in the  `firmware` directory.
 The stable version (default) is determined based on the most recent published release,
-other optionse are `--version preview` and `--version x.y.z` to download the latest preview or version x.y.z respectively.
+other versions are `--version preview` and `--version x.y.z` to download the latest preview or version x.y.z respectively.
 
-by default the firmware will be downloaded to  Downloads  in a `firmware` folder in your, but you can specify a different directory using the `--dir` option.
+By default the firmware will be downloaded to your OS's preferred `Downloads/firmware` folder, but you can speciy a different directory using the `--dir` option.
 
-```bash
 The directory structure will be something like this:
-```
+
+``` text
 Downloads/firmware
 |   firmware.jsonl
 +---esp8266
@@ -113,9 +113,16 @@ Downloads/firmware
 \---samd
         SEEED_WIO_TERMINAL-v1.22.2.uf2
 ```
-You can then flash the firmware to the board using the following command: `mpflash flash`
+
+## Flashing the firmware
+After you have downloaded a firmware you can  flash the firmware to a board using the following command: `mpflash flash`
 This will (try to) autodetect the connected boards, and determine the correct firmware to flash to each board.
 
+- `mpflash flash` will flash the latest stable firmware to all connected boards.
+- `mpflash flash --serial ? --board ?` will prompt to select a specific serial port and board to flash. (the firmware must be dowloaded earlier)
+
+
+### Flashing all connected boards with the latest stable firmware
 ```bash
 > mpflash flash
 22:15:55 | ℹ️  - Using latest stable version: v1.22.2

{mpflash-0.6.0.dist-info → mpflash-0.7.1.dist-info}/RECORD

@@ -1,13 +1,13 @@
 mpflash/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mpflash/ask_input.py,sha256=NGjCcOx49gW8xuDZK1BQXNOMPy7fUQ5pQamasez1wHI,7793
-mpflash/cli_download.py,sha256=9Rxwo-j7h9_rwMeAgITmfkdiNVi-Wunr1vpx2VjjUNM,3090
-mpflash/cli_flash.py,sha256=bp2AXHYqusVQbIOt12gqkbC4OoVMVV2gsY1fI-Js63M,5482
-mpflash/cli_group.py,sha256=hdyFrxkA_ye5r5bAsOnPr99KV2pfzgDoNXGPjTvEpW0,1946
-mpflash/cli_list.py,sha256=uxTRPdjFWv5ev4E_pz1JYv8DSFLOtZvTKmVmCiRpEC4,1005
-mpflash/cli_main.py,sha256=VxIpmvk3-2Sr1uB1AMT5bRa0TlrbY28ZaYd6NGZnEe0,632
+mpflash/ask_input.py,sha256=_LlatVyrWbY1Q4TDn8TWXJO5s22q_bGl3NXmdt13jxU,8442
+mpflash/cli_download.py,sha256=RNEsk1eMqzKCf9_sUPZQkDnzw6w-8L0Jnl6gDQup2Tc,3266
+mpflash/cli_flash.py,sha256=DTZ1mQSL31aEr3ROGIGWzzkiir4MRSqXdwq2p4ArDWE,5847
+mpflash/cli_group.py,sha256=nL3H06PHm_XUDlMuRyjgmTYeLnkrLa9mKDdahYw-KRo,1967
+mpflash/cli_list.py,sha256=KIlEeqcIIBf0g-emS43fzKspUy6fn9TUuFl0u00XaK8,1024
+mpflash/cli_main.py,sha256=BgqkDeEV0LBdT_Xn_Ay3zQOVJ-73pWSA4ngRf9KxGpw,656
 mpflash/common.py,sha256=lucFGMLl03qz-5Ic2XVv4g5XVt6hloUU6N5v0tSaUYE,1049
 mpflash/config.py,sha256=G6TxliEGxoYXy1SHQYBKgywnKccz9QzD3mGq_Vv1frg,419
-mpflash/download.py,sha256=HhL97PFTts_QhI1121QcWS7Z2nbfqvJ7mof_KFARx6k,10765
+mpflash/download.py,sha256=_yYENI7oew4tD51xEer1Ohv2B3LHrGg1lIF98LWDMCY,10991
 mpflash/downloaded.py,sha256=ADMJqZn7WVcU-Rm2X6RqA8ejtBNBYXcpwxVyT3v7r6s,3803
 mpflash/errors.py,sha256=Q5LR12Wo8iUCg5n_qq4GjdBdBflbvCOdKsRJ5InYRfI,96
 mpflash/flash.py,sha256=YGYXuNNbjro4QvZmpwpLCo86nFsh4UxWrOJHOowUYDY,2490
@@ -15,26 +15,26 @@ mpflash/flash_esp.py,sha256=TjBOk2y1eLrcE8T3iYGypsiskPX7BFNfxYmCuUo_3v4,2316
 mpflash/flash_stm32.py,sha256=d4BoQl3a9Tchnvn2ZTuq2MpYBB4MTaRukwtEncI95k0,823
 mpflash/flash_stm32_cube.py,sha256=w7aGWjReeWUKl0Q3ZjXH8BRqNO1Tk9AO7gtRNUg1c9Y,3970
 mpflash/flash_stm32_dfu.py,sha256=G70EZodWb-aRi507Jxbys-VEwbBGU1oZacow3_nq-d4,2972
-mpflash/flash_uf2.py,sha256=nTbp8MbSZeNVPWPPsQxN1ppTtBGESXMfwZ_qL4Bwkv0,2029
+mpflash/flash_uf2.py,sha256=KvNPk1zDwQexJfPI5MlIoR7zTD0u-pQQwSHuFQjuMXg,2093
 mpflash/flash_uf2_boardid.py,sha256=WZKucGu_hJ8ymb236uuZbiR6pD6AA_l4LA-7LwtQhq8,414
 mpflash/flash_uf2_linux.py,sha256=LAGkzTImVq-wKo7LGUNlwkUHv1L4rGO7igR5dwxY07o,4298
 mpflash/flash_uf2_windows.py,sha256=dcmA-koavH7duOuNwI0n2aDDbhF1_5ZZ-mXFAXgj8z4,1072
-mpflash/list.py,sha256=7-yW_J-TDGMvRrRfz7clJseiMy4uEgcwyhOaiw5fj1w,2248
+mpflash/list.py,sha256=R3upYux3mEltpqfrt467Ufs4hVatW1NE40jjhN7Ei1g,3252
 mpflash/logger.py,sha256=dI_H_a7EOdQJyvoeRHQuYeZuTKYVUS3DUPTLhE9rkdM,1098
 mpflash/mpboard_id/__init__.py,sha256=JYGe7VwpBV4ig2M9a6vJUQrMtgdNjZKHt_Z5N13Ycrs,3509
 mpflash/mpboard_id/board_id.py,sha256=NjKkIUv3sw6X60qy--mieQWrle3WNKw5NwAepMenTHI,2230
 mpflash/mpboard_id/board_info.csv,sha256=KPWDo-zHWfrPGQn9oInsDH-5IdCzhBCs6K_YAmqqSpQ,96983
 mpflash/mpboard_id/board_info.json,sha256=JtVyOMIO1O7vLKzJ0hyXQ4JSxXiQBJyay2hjdNLnZM0,674442
-mpflash/mpremoteboard/__init__.py,sha256=NSp71Qynz3hYqLLy0foVqdkURbNxfjUjiQBmaxKFF64,6951
+mpflash/mpremoteboard/__init__.py,sha256=DxlO_7LiyWDz5hNRI77fzp3sI3fZQ9Sd23dnGLx4Zl0,7017
 mpflash/mpremoteboard/mpy_fw_info.py,sha256=6AQbN3jtQgllqWQYl4e-63KeEtV08EXk8_JnM6XBkvo,4554
-mpflash/mpremoteboard/runner.py,sha256=H3W_xGJvjz7TLtlkDQrCLibgegRWGfsaBOABNbAfP_U,4783
+mpflash/mpremoteboard/runner.py,sha256=-PgzAeBGbyXaAUlwyiw4mcINsP2U1XRRjP1_QdBrxpg,4786
 mpflash/vendor/dfu.py,sha256=oK_MRSOyDJrUuS6D24IMIsfL7oLcrvUq0yp_h4WIY2U,5739
 mpflash/vendor/pydfu.py,sha256=_MdBRo1EeNeKDqFPSTB5tNL1jGSBJgsVeVjE5e7Pb8s,20542
 mpflash/vendor/readme.md,sha256=iIIZxuLUIGHQ0KODzYVtMezsztvyxCXcNJp_AzwTIPk,86
 mpflash/vendor/versions.py,sha256=ooRZjeeYepQHwp12hMu2m0p8nZXQ5s942w5mGkKmgeI,3629
-mpflash/worklist.py,sha256=TGVFugEyWn83WKr0wahBBimcfsHMWGo8_QTu4g3ao-0,5266
-mpflash-0.6.0.dist-info/entry_points.txt,sha256=Jk_visOhYOsZIcSP2Ms9hKqfKy1iorR-6dYltSoWCpY,52
-mpflash-0.6.0.dist-info/LICENSE,sha256=mWpNhsIxWzetYNnTpr4eb3HtgsxGIC8KcYWxXEcxQvE,1077
-mpflash-0.6.0.dist-info/METADATA,sha256=wlr-kNnhL5NmvIbM9LIquNRymrf_sPsLcv7MQYx0-Ic,13778
-mpflash-0.6.0.dist-info/WHEEL,sha256=d2fvjOD7sXsVzChCqf0Ty0JbHKBaLYwDbGQDwQTnJ50,88
-mpflash-0.6.0.dist-info/RECORD,,
+mpflash/worklist.py,sha256=qZsqF3Lf5Bl7QQ31ZLVHewP6WC8fmwQPMbyNgbG7LB4,5299
+mpflash-0.7.1.dist-info/entry_points.txt,sha256=Jk_visOhYOsZIcSP2Ms9hKqfKy1iorR-6dYltSoWCpY,52
+mpflash-0.7.1.dist-info/LICENSE,sha256=mWpNhsIxWzetYNnTpr4eb3HtgsxGIC8KcYWxXEcxQvE,1077
+mpflash-0.7.1.dist-info/METADATA,sha256=aAxXPamGn_mE__rBwjcZwSQlj-lQo8KA8HzyhmUIc9U,14627
+mpflash-0.7.1.dist-info/WHEEL,sha256=d2fvjOD7sXsVzChCqf0Ty0JbHKBaLYwDbGQDwQTnJ50,88
+mpflash-0.7.1.dist-info/RECORD,,