micropython-stubber 1.20.4__py3-none-any.whl → 1.20.6__py3-none-any.whl

mpflash/mpflash/bootloader/touch1200.py

@@ -0,0 +1,45 @@
+import sys
+import time
+
+import serial
+
+from mpflash.errors import MPFlashError
+from mpflash.logger import log
+from mpflash.mpremoteboard import MPRemoteBoard
+
+from .manual import enter_bootloader_manual
+
+
+def enter_bootloader_cdc_1200bps(mcu: MPRemoteBoard, timeout: int = 10):
+    if sys.platform == "win32":
+        log.warning("Touch 1200bps method is currently not supported on Windows, switching to manual")
+        return enter_bootloader_manual(mcu, timeout=timeout)
+
+    log.info(f"Entering bootloader on {mcu.board} on {mcu.serialport} using CDC 1200bps")
+    # if port argument is present perform soft reset
+    if not mcu.serialport:
+        raise MPFlashError("No serial port specified")
+    # try to initiate serial port connection on PORT with 1200 baudrate
+    try:
+        with serial.Serial(
+            port=mcu.serialport,
+            baudrate=1200,
+            parity=serial.PARITY_NONE,
+            stopbits=serial.STOPBITS_ONE,
+            bytesize=serial.EIGHTBITS,
+            rtscts=True,
+        ) as connection:
+            print("Connection established")
+            connection.rts = True
+            connection.dtr = False
+            time.sleep(0.4)
+
+    except serial.SerialException as e:
+        log.exception(e)
+        raise MPFlashError("pySerial error: " + str(e) + "\n") from e
+    except Exception as e:
+        log.exception(e)
+        raise MPFlashError("Error: " + str(e) + "\n") from e
+
+    # be optimistic
+    return True

mpflash/mpflash/cli_download.py

@@ -1,128 +1,129 @@
-"""CLI to Download MicroPython firmware for specific ports, boards and versions."""
-
-from pathlib import Path
-
-import rich_click as click
-from loguru import logger as log
-
-from mpflash.connected import connected_ports_boards
-from mpflash.errors import MPFlashError
-from mpflash.mpboard_id import find_known_board
-from mpflash.vendor.versions import clean_version
-
-from .ask_input import ask_missing_params
-from .cli_group import cli
-from .common import DownloadParams
-from .config import config
-from .download import download
-
-
-@cli.command(
-    "download",
-    help="Download MicroPython firmware for specific ports, boards and versions.",
-)
-@click.option(
-    "--destination",
-    "-d",
-    "fw_folder",
-    type=click.Path(file_okay=False, dir_okay=True, path_type=Path),
-    default=config.firmware_folder,
-    show_default=True,
-    help="The folder to download the firmware to.",
-)
-@click.option(
-    "--version",
-    "-v",
-    "versions",
-    default=["stable"],
-    multiple=True,
-    show_default=True,
-    help="The version of MicroPython to to download.",
-    metavar="SEMVER, 'stable', 'preview' or '?'",
-)
-@click.option(
-    "--board",
-    "-b",
-    "boards",
-    multiple=True,
-    default=[],
-    show_default=True,
-    help="The board(s) to download the firmware for.",
-    metavar="BOARD_ID or ?",
-)
-@click.option(
-    "--serial",
-    "--serial-port",
-    "-s",
-    "serial",
-    default=["*"],
-    show_default=True,
-    multiple=True,
-    help="Which serial port(s) to flash",
-    metavar="SERIALPORT",
-)
-@click.option(
-    "--ignore",
-    "-i",
-    is_eager=True,
-    help="Serial port(s) to ignore. Defaults to MPFLASH_IGNORE.",
-    multiple=True,
-    default=[],
-    envvar="MPFLASH_IGNORE",
-    show_default=True,
-    metavar="SERIALPORT",
-)
-@click.option(
-    "--clean/--no-clean",
-    default=True,
-    show_default=True,
-    help="""Remove dates and hashes from the downloaded firmware filenames.""",
-)
-@click.option(
-    "--force",
-    default=False,
-    is_flag=True,
-    show_default=True,
-    help="""Force download of firmware even if it already exists.""",
-)
-def cli_download(**kwargs) -> int:
-    params = DownloadParams(**kwargs)
-    params.versions = list(params.versions)
-    params.boards = list(params.boards)
-    params.serial = list(params.serial)
-    params.ignore = list(params.ignore)
-
-    # all_boards: List[MPRemoteBoard] = []
-    if params.boards:
-        if not params.ports:
-            # no ports specified - resolve ports from specified boards by resolving board IDs
-            for board in params.boards:
-                if board != "?":
-                    try:
-                        board_ = find_known_board(board)
-                        params.ports.append(board_.port)
-                    except MPFlashError as e:
-                        log.error(f"{e}")
-    else:
-        # no boards specified - detect connected ports and boards
-        params.ports, params.boards, _ = connected_ports_boards(include=params.serial, ignore=params.ignore)
-
-    params = ask_missing_params(params)
-    if not params:  # Cancelled by user
-        return 2
-    params.versions = [clean_version(v, drop_v=True) for v in params.versions]
-    assert isinstance(params, DownloadParams)
-
-    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
+"""CLI to Download MicroPython firmware for specific ports, boards and versions."""
+
+from pathlib import Path
+
+import rich_click as click
+from loguru import logger as log
+
+from mpflash.connected import connected_ports_boards
+from mpflash.errors import MPFlashError
+from mpflash.mpboard_id import find_known_board
+from mpflash.vendor.versions import clean_version
+
+from .ask_input import ask_missing_params
+from .cli_group import cli
+from .common import DownloadParams
+from .config import config
+from .download import download
+
+
+@cli.command(
+    "download",
+    help="Download MicroPython firmware for specific ports, boards and versions.",
+)
+@click.option(
+    "--destination",
+    "-d",
+    "fw_folder",
+    type=click.Path(file_okay=False, dir_okay=True, path_type=Path),
+    default=config.firmware_folder,
+    show_default=True,
+    help="The folder to download the firmware to.",
+)
+@click.option(
+    "--version",
+    "-v",
+    "versions",
+    default=["stable"],
+    multiple=True,
+    show_default=True,
+    help="The version of MicroPython to to download.",
+    metavar="SEMVER, 'stable', 'preview' or '?'",
+)
+@click.option(
+    "--board",
+    "-b",
+    "boards",
+    multiple=True,
+    default=[],
+    show_default=True,
+    help="The board(s) to download the firmware for.",
+    metavar="BOARD_ID or ?",
+)
+@click.option(
+    "--serial",
+    "--serial-port",
+    "-s",
+    "serial",
+    default=["*"],
+    show_default=True,
+    multiple=True,
+    help="Which serial port(s) to flash",
+    metavar="SERIALPORT",
+)
+@click.option(
+    "--ignore",
+    "-i",
+    is_eager=True,
+    help="Serial port(s) to ignore. Defaults to MPFLASH_IGNORE.",
+    multiple=True,
+    default=[],
+    envvar="MPFLASH_IGNORE",
+    show_default=True,
+    metavar="SERIALPORT",
+)
+@click.option(
+    "--clean/--no-clean",
+    default=True,
+    show_default=True,
+    help="""Remove dates and hashes from the downloaded firmware filenames.""",
+)
+@click.option(
+    "--force",
+    "-f",
+    default=False,
+    is_flag=True,
+    show_default=True,
+    help="""Force download of firmware even if it already exists.""",
+)
+def cli_download(**kwargs) -> int:
+    params = DownloadParams(**kwargs)
+    params.versions = list(params.versions)
+    params.boards = list(params.boards)
+    params.serial = list(params.serial)
+    params.ignore = list(params.ignore)
+
+    # all_boards: List[MPRemoteBoard] = []
+    if params.boards:
+        if not params.ports:
+            # no ports specified - resolve ports from specified boards by resolving board IDs
+            for board in params.boards:
+                if board != "?":
+                    try:
+                        board_ = find_known_board(board)
+                        params.ports.append(board_.port)
+                    except MPFlashError as e:
+                        log.error(f"{e}")
+    else:
+        # no boards specified - detect connected ports and boards
+        params.ports, params.boards, _ = connected_ports_boards(include=params.serial, ignore=params.ignore)
+
+    params = ask_missing_params(params)
+    if not params:  # Cancelled by user
+        return 2
+    params.versions = [clean_version(v, drop_v=True) for v in params.versions]
+    assert isinstance(params, DownloadParams)
+
+    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