usb_midi –通过 USB 的 MIDI

该 usb_midi 模块包含通过 USB 传输和接收 MIDI 消息的类。

在这些板上可用

• 8086 Commander
• @sarfata shIRtty
• ARAMCON Badge 2019
• ARAMCON2 Badge
• ATMegaZero ESP32-S2
• Adafruit CLUE nRF52840 Express
• Adafruit Circuit Playground Bluefruit
• Adafruit Circuit Playground Express 4-H
• Adafruit CircuitPlayground Express
• Adafruit CircuitPlayground Express with Crickit libraries
• Adafruit EdgeBadge
• Adafruit Feather Bluefruit Sense
• Adafruit Feather M0 Adalogger
• Adafruit Feather M0 Basic
• Adafruit Feather M0 Express
• Adafruit Feather M0 Express with Crickit libraries
• Adafruit Feather M4 CAN
• Adafruit Feather M4 Express
• Adafruit Feather MIMXRT1011
• Adafruit Feather RP2040
• Adafruit Feather STM32F405 Express
• Adafruit Feather nRF52840 Express
• Adafruit FunHouse
• Adafruit Gemma M0
• Adafruit Gemma M0 PyCon 2018
• Adafruit Grand Central M4 Express
• Adafruit Hallowing M4 Express
• Adafruit ItsyBitsy M0 Express
• Adafruit ItsyBitsy M4 Express
• Adafruit ItsyBitsy RP2040
• Adafruit ItsyBitsy nRF52840 Express
• Adafruit LED Glasses Driver nRF52840
• Adafruit Macropad RP2040
• Adafruit MagTag
• Adafruit Matrix Portal M4
• Adafruit Metro ESP32S2
• Adafruit Metro M0 Express
• Adafruit Metro M4 Airlift Lite
• Adafruit Metro M4 Express
• Adafruit Metro nRF52840 Express
• Adafruit Monster M4SK
• Adafruit NeoKey Trinkey M0
• Adafruit NeoPixel Trinkey M0
• Adafruit ProxLight Trinkey M0
• Adafruit PyGamer
• Adafruit PyPortal
• Adafruit PyPortal Pynt
• Adafruit PyPortal Titano
• Adafruit PyRuler
• Adafruit Pybadge
• Adafruit QT Py M0
• Adafruit QT Py M0 Haxpress
• Adafruit QT Py RP2040
• Adafruit QT2040 Trinkey
• Adafruit Rotary Trinkey M0
• Adafruit Slide Trinkey M0
• Adafruit Trellis M4 Express
• Adafruit Trinket M0
• AloriumTech Evo M51
• Arduino MKR Zero
• Arduino MKR1300
• Arduino Nano 33 BLE
• Arduino Nano 33 IoT
• Arduino Nano RP2040 Connect
• Arduino Zero
• Artisense Reference Design RD00
• AtelierDuMaker nRF52840 Breakout
• BDMICRO VINA-D21
• BDMICRO VINA-D51
• BLE-SS dev board Multi Sensor
• BastBLE
• BastWiFi
• BlueMicro840
• CP Sapling M0
• CP Sapling M0 w/ SPI Flash
• CP32-M4
• Capable Robot Programmable USB Hub
• Cedar Grove StringCar M0 Express
• Challenger RP2040 WiFi
• Circuit Playground Express Digi-Key PyCon 2019
• CircuitBrains Basic
• CircuitBrains Deluxe
• CrumpS2
• Cytron Maker Pi RP2040
• DynOSSAT-EDU-EPS
• DynOSSAT-EDU-OBC
• DynaLoRa_USB
• ESP 12k NodeMCU
• Electronic Cats Bast Pro Mini M0
• Electronic Cats CatWAN USBStick
• Electronic Cats Hunter Cat NFC
• Electronic Cats NFC Copy Cat
• Electronut Labs Blip
• Electronut Labs Papyr
• EncoderPad RP2040
• Espruino Pico
• Espruino Wifi
• Feather ESP32S2 without PSRAM
• Feather MIMXRT1011
• Feather MIMXRT1062
• FeatherS2
• FeatherS2 Neo
• FeatherS2 PreRelease
• Fluff M0
• Fomu
• Franzininho WIFI w/Wroom
• Franzininho WIFI w/Wrover
• Gravitech Cucumber M
• Gravitech Cucumber MS
• Gravitech Cucumber R
• Gravitech Cucumber RS
• HMI-DevKit-1.1
• Hacked Feather M0 Express with 8Mbyte SPI flash
• HalloWing M0 Express
• HiiBot BlueFi
• IMXRT1010-EVK
• IkigaiSense Vita nRF52840
• J&J Studios datum-Distance
• J&J Studios datum-IMU
• J&J Studios datum-Light
• J&J Studios datum-Weather
• Kaluga 1
• LILYGO TTGO T8 ESP32-S2 w/Display
• LoC BeR M4 base board
• MDBT50Q-DB-40
• MDBT50Q-RX Dongle
• MEOWBIT
• MORPHEANS MorphESP-240
• MakerDiary nRF52840 MDK
• MakerDiary nRF52840 MDK USB Dongle
• Makerdiary M60 Keyboard
• Makerdiary Pitaya Go
• Makerdiary nRF52840 M.2 Developer Kit
• Melopero Shake RP2040
• Meow Meow
• Metro MIMXRT1011
• Mini SAM M4
• NUCLEO STM32F746
• NUCLEO STM32F767
• NUCLEO STM32H743
• OPENMV-H7 R1
• Oak Dev Tech BREAD2040
• Oak Dev Tech PixelWing ESP32S2
• Open Hardware Summit 2020 Badge
• PCA10056 nRF52840-DK
• PCA10059 nRF52840 Dongle
• PYB LR Nano V2
• Particle Argon
• Particle Boron
• Particle Xenon
• PicoPlanet
• Pimoroni Interstate 75
• Pimoroni Keybow 2040
• Pimoroni PGA2040
• Pimoroni Pico LiPo (16MB)
• Pimoroni Pico LiPo (4MB)
• Pimoroni PicoSystem
• Pimoroni Plasma 2040
• Pimoroni Tiny 2040
• PyCubedv04
• PyCubedv04-MRAM
• PyCubedv05
• PyCubedv05-MRAM
• PyKey60
• PyboardV1_1
• Raspberry Pi Pico
• Robo HAT MM1 M4
• S2Mini
• SAM E54 Xplained Pro
• SAM32v26
• ST STM32F746G Discovery
• STM32F411E_DISCO
• STM32F412G_DISCO
• STM32F4_DISCO
• Saola 1 w/Wroom
• Saola 1 w/Wrover
• Seeeduino Wio Terminal
• Seeeduino XIAO
• Serpente
• Silicognition LLC M4-Shim
• SparkFun LUMIDrive
• SparkFun MicroMod RP2040 Processor
• SparkFun MicroMod SAMD51 Processor
• SparkFun MicroMod nRF52840 Processor
• SparkFun Pro Micro RP2040
• SparkFun Pro nRF52840 Mini
• SparkFun Qwiic Micro
• SparkFun RedBoard Turbo
• SparkFun SAMD21 Dev Breakout
• SparkFun SAMD21 Mini Breakout
• SparkFun STM32 MicroMod Processor
• SparkFun Thing Plus - RP2040
• SparkFun Thing Plus - SAMD51
• Sprite_v2b
• StackRduino M0 PRO
• TG-Boards' Datalore IP M4
• TG-Watch
• THUNDERPACK_v11
• THUNDERPACK_v12
• Targett Module Clip w/Wroom
• Targett Module Clip w/Wrover
• Teensy 4.0
• Teensy 4.1
• Teknikio Bluebird
• The Open Book Feather
• TinkeringTech ScoutMakes Azul
• TinyS2
• Trinket M0 Haxpress
• UARTLogger II
• WarmBit BluePixel nRF52840
• Winterbloom Sol
• XinaBox CC03
• iMX RT 1020 EVK
• iMX RT 1060 EVK
• keithp.com snekboard
• microS2
• nanoESP32-S2 w/Wrover
• nanoESP32-S2 w/Wroom
• ndGarage[n°] Bit6: FeatherSnow-v2
• ndGarage[n°]Bit6:FeatherSnow
• nice!nano
• senseBox MCU
• stm32f411ce-blackpill
• stm32f411ce-blackpill-with-flash
• uChip

usb_midi.ports :Tuple[Union[PortIn, PortOut], Ellipsis]

所有 MIDI 端口的元组。每个项目都是 etherPortIn或 PortOut.

usb_midi.disable() → None

禁止向主机展示 USB MIDI 设备。该设备通常默认启用，但在某些端点有限的板上，包括 ESP32-S2 和某些 STM 板，默认情况下是禁用的。可以在 boot.py连接USB之前调用。

usb_midi.enable() → None

启用向主机呈现 USB MIDI 设备。该设备默认启用，因此您通常不需要调用此函数。可以在boot.py连接USB之前调用。

如果您一次启用太多设备，您将耗尽 USB 端点。可用端点的数量因微控制器而异。CircuitPython 将在运行 boot.py 后进入安全模式，以通知您是否没有足够的端点可用。

class usb_midi.PortIn

通过 USB 接收 MIDI 命令

您不能创建 的实例usb_midi.PortIn。

PortIn 对象是为 USB 描述符中的每个相应条目构造的，并添加到usb_midi.ports 元组中。

read(self, nbytes: Optional[int] = None) → Optional[bytes]

读取字符。如果nbytes指定，则最多读取那么多字节。否则，读取到达的所有内容，直到连接超时。强烈建议提供预期的字节数，因为它会更快。

返回

数据读取

返回类型

字节 或 None

readinto(self, buf: _typing.WriteableBuffer, nbytes: Optional[int] = None) → Optional[bytes]

将字节读入 buf. 如果 nbytes指定，则最多读取那么多字节。否则，最多读取 len(buf) 字节。

返回

读取和存储的字节数 buf

返回类型

字节 或 None

class usb_midi.PortOut

通过 USB 向计算机发送 MIDI 信息

您不能创建 的实例 usb_midi.PortOut.

PortOut 对象是为 USB 描述符中的每个相应条目构造的，并添加到usb_midi.ports 元组中。

write(self, buf: _typing.ReadableBuffer) → Optional[int]

将字节缓冲区写入总线。

返回

写入的字节数

返回类型

整数 或 None