micropython-lib/micropython/usb/examples/device/cdc_repl_example.py

42 wiersze
1.4 KiB
Python
Czysty Zwykły widok Historia

# MicroPython USB CDC REPL example
#
# Example demonstrating how to use os.dupterm() to provide the
# MicroPython REPL on a dynamic CDCInterface() serial port.
#
# Note that if you run this example on the built-in USB CDC port via 'mpremote
# run' then you'll have to reconnect after it re-enumerates, and it may be
# necessary afterward to type Ctrl-B to exit the Raw REPL mode and resume the
# interactive REPL back.
#
# This example uses the usb-device-cdc package for the CDCInterface class.
# This can be installed with:
#
# mpremote mip install usb-device-cdc
#
# MIT license; Copyright (c) 2023-2024 Angus Gratton
import os
import time
import usb.device
from usb.device.cdc import CDCInterface
cdc = CDCInterface()
cdc.init(timeout=0) # zero timeout makes this non-blocking, suitable for os.dupterm()
# pass builtin_driver=True so that we get the built-in USB-CDC alongside,
# if it's available.
usb.device.get().init(cdc, builtin_driver=True)
print("Waiting for USB host to configure the interface...")
# wait for host enumerate as a CDC device...
while not cdc.is_open():
time.sleep_ms(100)
# Note: This example doesn't wait for the host to access the new CDC port,
# which could be done by polling cdc.dtr, as this will block the REPL
# from resuming while this code is still executing.
print("CDC port enumerated, duplicating REPL...")
old_term = os.dupterm(cdc)