From: Björn Bösel Date: Thu, 3 Mar 2022 15:09:42 +0000 (+0100) Subject: code style again X-Git-Tag: 7.1.0~1^2~2 X-Git-Url: https://git.ayoreis.com/Adafruit_Blinka-hackapet.git/commitdiff_plain/0f1ce4a6f5931266bab978fe733034826f572972 code style again --- diff --git a/src/usb_hid.py b/src/usb_hid.py index c55a28d..213a643 100644 --- a/src/usb_hid.py +++ b/src/usb_hid.py @@ -483,51 +483,52 @@ def disable() -> None: pass this.devices = [] + atexit.register(disable) def enable(requested_devices: Sequence[Device], boot_device: int = 0) -> None: -# """Specify which USB HID devices that will be available. -# Can be called in ``boot.py``, before USB is connected. -# -# :param Sequence devices: `Device` objects. -# If `devices` is empty, HID is disabled. The order of the ``Devices`` -# may matter to the host. For instance, for MacOS, put the mouse device -# before any Gamepad or Digitizer HID device or else it will not work. -# :param int boot_device: If non-zero, inform the host that support for a -# a boot HID device is available. -# If ``boot_device=1``, a boot keyboard is available. -# If ``boot_device=2``, a boot mouse is available. No other values are allowed. -# See below. -# -# If you enable too many devices at once, you will run out of USB endpoints. -# The number of available endpoints varies by microcontroller. -# CircuitPython will go into safe mode after running ``boot.py`` to inform you if -# not enough endpoints are available. -# -# **Boot Devices** -# -# Boot devices implement a fixed, predefined report descriptor, defined in -# https://www.usb.org/sites/default/files/hid1_12.pdf, Appendix B. A USB host -# can request to use the boot device if the USB device says it is available. -# Usually only a BIOS or other kind of limited-functionality -# host needs boot keyboard support. -# -# For example, to make a boot keyboard available, you can use this code:: -# -# usb_hid.enable((Device.KEYBOARD), boot_device=1) # 1 for a keyboard -# -# If the host requests the boot keyboard, the report descriptor provided by `Device.KEYBOARD` -# will be ignored, and the predefined report descriptor will be used. -# But if the host does not request the boot keyboard, -# the descriptor provided by `Device.KEYBOARD` will be used. -# -# The HID boot device must usually be the first or only device presented by CircuitPython. -# The HID device will be USB interface number 0. -# To make sure it is the first device, disable other USB devices, including CDC and MSC (CIRCUITPY). -# If you specify a non-zero ``boot_device``, and it is not the first device, CircuitPython -# will enter safe mode to report this error. -# """ + # """Specify which USB HID devices that will be available. + # Can be called in ``boot.py``, before USB is connected. + # + # :param Sequence devices: `Device` objects. + # If `devices` is empty, HID is disabled. The order of the ``Devices`` + # may matter to the host. For instance, for MacOS, put the mouse device + # before any Gamepad or Digitizer HID device or else it will not work. + # :param int boot_device: If non-zero, inform the host that support for a + # a boot HID device is available. + # If ``boot_device=1``, a boot keyboard is available. + # If ``boot_device=2``, a boot mouse is available. No other values are allowed. + # See below. + # + # If you enable too many devices at once, you will run out of USB endpoints. + # The number of available endpoints varies by microcontroller. + # CircuitPython will go into safe mode after running ``boot.py`` to inform you if + # not enough endpoints are available. + # + # **Boot Devices** + # + # Boot devices implement a fixed, predefined report descriptor, defined in + # https://www.usb.org/sites/default/files/hid1_12.pdf, Appendix B. A USB host + # can request to use the boot device if the USB device says it is available. + # Usually only a BIOS or other kind of limited-functionality + # host needs boot keyboard support. + # + # For example, to make a boot keyboard available, you can use this code:: + # + # usb_hid.enable((Device.KEYBOARD), boot_device=1) # 1 for a keyboard + # + # If the host requests the boot keyboard, the report descriptor provided by `Device.KEYBOARD` + # will be ignored, and the predefined report descriptor will be used. + # But if the host does not request the boot keyboard, + # the descriptor provided by `Device.KEYBOARD` will be used. + # + # The HID boot device must usually be the first or only device presented by CircuitPython. + # The HID device will be USB interface number 0. + # To make sure it is the first device, disable other USB devices, including CDC and MSC (CIRCUITPY). + # If you specify a non-zero ``boot_device``, and it is not the first device, CircuitPython + # will enter safe mode to report this error. + # """ this.boot_device = boot_device if len(requested_devices) == 0: