circuitpython-stubs 10.3.0rc0__tar.gz → 10.3.2__tar.gz

{circuitpython_stubs-10.3.0rc0/circuitpython_stubs.egg-info → circuitpython_stubs-10.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: circuitpython-stubs
-Version: 10.3.0rc0
+Version: 10.3.2
 Summary: PEP 561 type stubs for CircuitPython
 Home-page: https://github.com/adafruit/circuitpython
 Author-email: circuitpython@adafruit.com

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/audiocore/__init__.pyi

@@ -105,7 +105,8 @@ class WaveFile:
         :param Union[str, typing.BinaryIO] file: The name of a wave file (preferred) or an already opened wave file
         :param ~circuitpython_typing.WriteableBuffer buffer: Optional pre-allocated buffer,
           that will be split in half and used for double-buffering of the data.
-          The buffer must be 8 to 1024 bytes long.
+          The buffer must be 8 to 1024 bytes long and a multiple of 8 bytes, so that each half
+          holds a whole number of 32-bit words.
           If not provided, two 256 byte buffers are initially allocated internally.
 
         Playing a wave file from flash::

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/audiodelays/__init__.pyi

@@ -623,6 +623,10 @@ class PitchShift:
 
     mix: synthio.BlockInput
     """The output mix between 0 and 1 where 0 is only sample and 1 is all effect."""
+    freeze: bool
+    """If True, the window buffer won't accept new audio information and will be "frozen" in
+    it's current state, resulting in a sustaining tone. Normal operation is resumed when set to
+    False. If the audio buffer is reset, this value will also be reset to False."""
     playing: bool
     """True when the effect is playing a sample. (read-only)"""
 

circuitpython_stubs-10.3.2/board_definitions/challenger_rp2040_nfc/__init__.pyi

@@ -0,0 +1,100 @@
+# SPDX-FileCopyrightText: 2024 Justin Myers
+#
+# SPDX-License-Identifier: MIT
+"""
+Board stub for Challenger RP2040 NFC
+ - port: raspberrypi
+ - board_id: challenger_rp2040_nfc
+ - NVM size: 4096
+ - Included modules: _asyncio, _bleio, _bleio (HCI co-processor), _eve, _pixelmap, adafruit_bus_device, adafruit_pixelbuf, aesio, alarm, analogbufio, analogio, array, atexit, audiobusio, audiocore, audiodelays, audiofilewriter, audiofilters, audiofreeverb, audioi2sin, audiomixer, audiomp3, audiopwmio, audiospeed, binascii, bitbangio, bitmapfilter, bitmaptools, bitops, board, builtins, builtins.pow3, busdisplay, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, displayio, epaperdisplay, errno, floppyio, fontio, fourwire, framebufferio, getpass, gifio, hashlib, i2cdisplaybus, i2ctarget, imagecapture, io, jpegio, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, keypad_demux, keypad_demux.DemuxKeyMatrix, locale, lvfontio, math, memorymap, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, paralleldisplaybus, pulseio, pwmio, qrio, rainbowio, random, re, rgbmatrix, rotaryio, rp2pio, rtc, sdcardio, select, sharpdisplay, storage, struct, supervisor, supervisor.get_setting, synthio, sys, terminalio, tilepalettemapper, time, touchio, traceback, ulab, usb, usb_audio, usb_cdc, usb_hid, usb_host, usb_midi, usb_video, vectorio, warnings, watchdog, zlib
+ - Frozen libraries: 
+"""
+
+# Imports
+import busio
+import microcontroller
+
+
+# Board Info:
+board_id: str
+
+
+# Pins:
+SDA: microcontroller.Pin  # GPIO0
+GP0: microcontroller.Pin  # GPIO0
+SCL: microcontroller.Pin  # GPIO1
+GP1: microcontroller.Pin  # GPIO1
+D5: microcontroller.Pin  # GPIO2
+GP2: microcontroller.Pin  # GPIO2
+D6: microcontroller.Pin  # GPIO3
+GP3: microcontroller.Pin  # GPIO3
+D9: microcontroller.Pin  # GPIO4
+GP4: microcontroller.Pin  # GPIO4
+D10: microcontroller.Pin  # GPIO5
+GP5: microcontroller.Pin  # GPIO5
+D11: microcontroller.Pin  # GPIO6
+GP6: microcontroller.Pin  # GPIO6
+D12: microcontroller.Pin  # GPIO7
+GP7: microcontroller.Pin  # GPIO7
+D13: microcontroller.Pin  # GPIO8
+GP8: microcontroller.Pin  # GPIO8
+NFC_IRQ: microcontroller.Pin  # GPIO9
+GP9: microcontroller.Pin  # GPIO9
+NFC_SDA: microcontroller.Pin  # GPIO10
+GP10: microcontroller.Pin  # GPIO10
+NFC_SCL: microcontroller.Pin  # GPIO11
+GP11: microcontroller.Pin  # GPIO11
+NFC_RESET: microcontroller.Pin  # GPIO12
+GP12: microcontroller.Pin  # GPIO12
+GP13: microcontroller.Pin  # GPIO13
+NEOPIXEL: microcontroller.Pin  # GPIO14
+GP14: microcontroller.Pin  # GPIO14
+D0: microcontroller.Pin  # GPIO16
+TX: microcontroller.Pin  # GPIO16
+GP16: microcontroller.Pin  # GPIO16
+D1: microcontroller.Pin  # GPIO17
+RX: microcontroller.Pin  # GPIO17
+GP17: microcontroller.Pin  # GPIO17
+MISO: microcontroller.Pin  # GPIO20
+SDI: microcontroller.Pin  # GPIO20
+GP20: microcontroller.Pin  # GPIO20
+SCK: microcontroller.Pin  # GPIO22
+GP22: microcontroller.Pin  # GPIO22
+MOSI: microcontroller.Pin  # GPIO23
+SDO: microcontroller.Pin  # GPIO23
+GP23: microcontroller.Pin  # GPIO23
+LED: microcontroller.Pin  # GPIO24
+GP24: microcontroller.Pin  # GPIO24
+A4: microcontroller.Pin  # GPIO19
+GP19: microcontroller.Pin  # GPIO19
+A5: microcontroller.Pin  # GPIO21
+GP21: microcontroller.Pin  # GPIO21
+A0: microcontroller.Pin  # GPIO26
+GP26: microcontroller.Pin  # GPIO26
+A1: microcontroller.Pin  # GPIO27
+GP27: microcontroller.Pin  # GPIO27
+A2: microcontroller.Pin  # GPIO28
+GP28: microcontroller.Pin  # GPIO28
+A3: microcontroller.Pin  # GPIO29
+GP29: microcontroller.Pin  # GPIO29
+
+
+# Members:
+def I2C() -> busio.I2C:
+    """Returns the `busio.I2C` object for the board's designated I2C bus(es).
+    The object created is a singleton, and uses the default parameter values for `busio.I2C`.
+    """
+
+def SPI() -> busio.SPI:
+    """Returns the `busio.SPI` object for the board's designated SPI bus(es).
+    The object created is a singleton, and uses the default parameter values for `busio.SPI`.
+    """
+
+def UART() -> busio.UART:
+    """Returns the `busio.UART` object for the board's designated UART bus(es).
+    The object created is a singleton, and uses the default parameter values for `busio.UART`.
+    """
+
+
+# Unmapped:
+#   none

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/board_definitions/edgebadge/__init__.pyi

@@ -6,7 +6,7 @@ Board stub for Adafruit Pybadge
  - port: atmel-samd
  - board_id: edgebadge
  - NVM size: 256
- - Included modules: _asyncio, _bleio, _bleio (HCI co-processor), _pixelmap, _stage, adafruit_bus_device, adafruit_pixelbuf, alarm, analogio, array, atexit, audiobusio, audiocore, audioio, audiomixer, audiomp3, binascii, bitbangio, bitmaptools, board, builtins, builtins.pow3, busdisplay, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, displayio, epaperdisplay, errno, fontio, fourwire, frequencyio, getpass, i2ctarget, io, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, locale, math, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, ps2io, pulseio, pwmio, rainbowio, random, re, rotaryio, rtc, samd, sdcardio, select, storage, struct, supervisor, supervisor.get_setting, synthio, sys, terminalio, tilepalettemapper, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, warnings, watchdog, zlib
+ - Included modules: _asyncio, _bleio, _bleio (HCI co-processor), _pixelmap, _stage, adafruit_bus_device, adafruit_pixelbuf, alarm, analogio, array, atexit, audiobusio, audiocore, audioio, audiomixer, audiomp3, binascii, bitbangio, bitmaptools, board, builtins, builtins.pow3, busdisplay, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, displayio, errno, fontio, fourwire, frequencyio, getpass, i2ctarget, io, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, locale, math, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, ps2io, pulseio, pwmio, rainbowio, random, re, rotaryio, rtc, samd, sdcardio, select, storage, struct, supervisor, supervisor.get_setting, synthio, sys, terminalio, tilepalettemapper, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, warnings, watchdog, zlib
  - Frozen libraries: stage, ugame
 """
 

circuitpython_stubs-10.3.2/board_definitions/espressif_esp32c5_devkitc_1_n8r8/__init__.pyi

@@ -0,0 +1,55 @@
+# SPDX-FileCopyrightText: 2024 Justin Myers
+#
+# SPDX-License-Identifier: MIT
+"""
+Board stub for ESP32-C5-DevKitC-1-N8R8
+ - port: espressif
+ - board_id: espressif_esp32c5_devkitc_1_n8r8
+ - NVM size: 8192
+ - Included modules: _asyncio, _bleio, _bleio (native), _eve, _pixelmap, adafruit_bus_device, adafruit_pixelbuf, aesio, alarm, analogbufio, analogio, array, atexit, audiobusio, audiocore, audioi2sin, audiomixer, audiomp3, binascii, bitbangio, bitmapfilter, bitmaptools, board, builtins, builtins.pow3, busdisplay, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, displayio, dualbank, epaperdisplay, errno, espidf, espnow, fontio, fourwire, framebufferio, frequencyio, getpass, gifio, hashlib, i2cdisplaybus, io, ipaddress, jpegio, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, keypad_demux, keypad_demux.DemuxKeyMatrix, locale, lvfontio, math, max3421e, mdns, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, ps2io, pulseio, pwmio, rainbowio, random, re, rotaryio, rtc, sdcardio, select, sharpdisplay, socketpool, socketpool.socketpool.AF_INET6, ssl, storage, struct, supervisor, supervisor.get_setting, synthio, sys, terminalio, tilepalettemapper, time, touchio, traceback, ulab, usb, vectorio, warnings, watchdog, wifi, zlib
+ - Frozen libraries: 
+"""
+
+# Imports
+import busio
+import microcontroller
+
+
+# Board Info:
+board_id: str
+
+
+# Pins:
+IO0: microcontroller.Pin  # GPIO0
+IO1: microcontroller.Pin  # GPIO1
+IO2: microcontroller.Pin  # GPIO2
+IO3: microcontroller.Pin  # GPIO3
+IO4: microcontroller.Pin  # GPIO4
+IO5: microcontroller.Pin  # GPIO5
+IO6: microcontroller.Pin  # GPIO6
+IO7: microcontroller.Pin  # GPIO7
+IO8: microcontroller.Pin  # GPIO8
+IO9: microcontroller.Pin  # GPIO9
+IO10: microcontroller.Pin  # GPIO10
+IO13: microcontroller.Pin  # GPIO13
+IO14: microcontroller.Pin  # GPIO14
+IO23: microcontroller.Pin  # GPIO23
+IO24: microcontroller.Pin  # GPIO24
+IO25: microcontroller.Pin  # GPIO25
+IO26: microcontroller.Pin  # GPIO26
+IO27: microcontroller.Pin  # GPIO27
+IO28: microcontroller.Pin  # GPIO28
+NEOPIXEL: microcontroller.Pin  # GPIO27
+TX: microcontroller.Pin  # GPIO11
+RX: microcontroller.Pin  # GPIO12
+
+
+# Members:
+def UART() -> busio.UART:
+    """Returns the `busio.UART` object for the board's designated UART bus(es).
+    The object created is a singleton, and uses the default parameter values for `busio.UART`.
+    """
+
+
+# Unmapped:
+#   none

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/board_definitions/pybadge/__init__.pyi

@@ -6,7 +6,7 @@ Board stub for Adafruit Pybadge
  - port: atmel-samd
  - board_id: pybadge
  - NVM size: 256
- - Included modules: _asyncio, _bleio, _bleio (HCI co-processor), _pixelmap, _stage, adafruit_bus_device, adafruit_pixelbuf, alarm, analogio, array, atexit, audiobusio, audiocore, audioio, audiomixer, audiomp3, binascii, bitbangio, bitmaptools, board, builtins, builtins.pow3, busdisplay, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, displayio, epaperdisplay, errno, fontio, fourwire, frequencyio, getpass, i2ctarget, io, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, locale, math, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, ps2io, pulseio, pwmio, rainbowio, random, re, rotaryio, rtc, samd, sdcardio, select, storage, struct, supervisor, supervisor.get_setting, synthio, sys, terminalio, tilepalettemapper, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, warnings, watchdog, zlib
+ - Included modules: _asyncio, _bleio, _bleio (HCI co-processor), _pixelmap, _stage, adafruit_bus_device, adafruit_pixelbuf, alarm, analogio, array, atexit, audiobusio, audiocore, audioio, audiomixer, audiomp3, binascii, bitbangio, bitmaptools, board, builtins, builtins.pow3, busdisplay, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, displayio, errno, fontio, fourwire, frequencyio, getpass, i2ctarget, io, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, locale, math, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, ps2io, pulseio, pwmio, rainbowio, random, re, rotaryio, rtc, samd, sdcardio, select, storage, struct, supervisor, supervisor.get_setting, synthio, sys, terminalio, tilepalettemapper, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, vectorio, warnings, watchdog, zlib
  - Frozen libraries: stage, ugame
 """
 

circuitpython_stubs-10.3.2/board_definitions/teenage_engineering_sp1/__init__.pyi

@@ -0,0 +1,70 @@
+# SPDX-FileCopyrightText: 2024 Justin Myers
+#
+# SPDX-License-Identifier: MIT
+"""
+Board stub for Teenage Engineering SP-1
+ - port: nordic
+ - board_id: teenage_engineering_sp1
+ - NVM size: 8192
+ - Included modules: _asyncio, _pixelmap, adafruit_bus_device, adafruit_pixelbuf, aesio, analogio, array, atexit, audiobusio, audiocore, audiodelays, audiofilters, audiofreeverb, audiomixer, audiomp3, binascii, bitbangio, board, builtins, builtins.pow3, busio, busio.SPI, busio.UART, codeop, collections, countio, digitalio, emmcio, errno, getpass, hashlib, io, json, keypad, keypad.KeyMatrix, keypad.Keys, keypad.ShiftRegisterKeys, keypad_demux, keypad_demux.DemuxKeyMatrix, locale, math, memorymap, microcontroller, msgpack, neopixel_write, nvm, onewireio, os, os.getenv, pulseio, pwmio, rainbowio, random, re, rotaryio, rtc, sdcardio, select, storage, struct, supervisor, supervisor.get_setting, synthio, sys, time, touchio, traceback, ulab, usb_cdc, usb_hid, usb_midi, warnings, zlib
+ - Frozen libraries: adafruit_cs42l42, adafruit_register, adafruit_tas2505
+"""
+
+# Imports
+import busio
+import microcontroller
+
+
+# Board Info:
+board_id: str
+
+
+# Pins:
+FADER1: microcontroller.Pin  # P0_05
+FADER2: microcontroller.Pin  # P0_30
+FADER3: microcontroller.Pin  # P0_04
+FADER4: microcontroller.Pin  # P0_31
+LADDER1: microcontroller.Pin  # P0_02
+LADDER2: microcontroller.Pin  # P0_03
+LADDER_POWER: microcontroller.Pin  # P1_10
+BUTTON: microcontroller.Pin  # P0_27
+LED_PLAY1: microcontroller.Pin  # P1_13
+LED_PLAY2: microcontroller.Pin  # P0_00
+LED_PLAY3: microcontroller.Pin  # P1_12
+LED_PLAY4: microcontroller.Pin  # P0_01
+LED_TRACK1: microcontroller.Pin  # P0_29
+LED_TRACK2: microcontroller.Pin  # P0_26
+LED_TRACK3: microcontroller.Pin  # P1_15
+LED_TRACK4: microcontroller.Pin  # P1_14
+SCL: microcontroller.Pin  # P1_11
+SDA: microcontroller.Pin  # P1_07
+TAS_RESET: microcontroller.Pin  # P0_09
+CS42_RESET: microcontroller.Pin  # P0_15
+I2S_DOUT: microcontroller.Pin  # P1_09
+I2S_LRCLK: microcontroller.Pin  # P0_11
+I2S_BCLK: microcontroller.Pin  # P0_12
+OSC_EN: microcontroller.Pin  # P0_13
+EMMC_CLK: microcontroller.Pin  # P0_06
+EMMC_DAT0: microcontroller.Pin  # P0_07
+EMMC_CMD: microcontroller.Pin  # P0_08
+EMMC_RESET: microcontroller.Pin  # P1_08
+EMMC_VCCQ: microcontroller.Pin  # P0_14
+CHARGE_ISET: microcontroller.Pin  # P1_00
+CHARGE_ENABLE: microcontroller.Pin  # P0_21
+CHARGE_STATUS: microcontroller.Pin  # P0_22
+POWER_GOOD: microcontroller.Pin  # P0_24
+VBATT: microcontroller.Pin  # P0_28
+BATTERY: microcontroller.Pin  # P0_28
+VOLTAGE_MONITOR: microcontroller.Pin  # P0_28
+BT_RESET: microcontroller.Pin  # P0_10
+
+
+# Members:
+def I2C() -> busio.I2C:
+    """Returns the `busio.I2C` object for the board's designated I2C bus(es).
+    The object created is a singleton, and uses the default parameter values for `busio.I2C`.
+    """
+
+
+# Unmapped:
+#   none

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2/circuitpython_stubs.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: circuitpython-stubs
-Version: 10.3.0rc0
+Version: 10.3.2
 Summary: PEP 561 type stubs for CircuitPython
 Home-page: https://github.com/adafruit/circuitpython
 Author-email: circuitpython@adafruit.com

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/circuitpython_stubs.egg-info/SOURCES.txt

@@ -153,6 +153,7 @@ setup.py
 ./board_definitions/challenger_nb_rp2040_wifi/__init__.pyi
 ./board_definitions/challenger_rp2040_lora/__init__.pyi
 ./board_definitions/challenger_rp2040_lte/__init__.pyi
+./board_definitions/challenger_rp2040_nfc/__init__.pyi
 ./board_definitions/challenger_rp2040_sdrtc/__init__.pyi
 ./board_definitions/challenger_rp2040_subghz/__init__.pyi
 ./board_definitions/challenger_rp2040_wifi/__init__.pyi
@@ -223,6 +224,7 @@ setup.py
 ./board_definitions/espressif_esp32_lyrat/__init__.pyi
 ./board_definitions/espressif_esp32c3_devkitm_1_n4/__init__.pyi
 ./board_definitions/espressif_esp32c3_lyra_v2/__init__.pyi
+./board_definitions/espressif_esp32c5_devkitc_1_n8r8/__init__.pyi
 ./board_definitions/espressif_esp32c61_devkitc_1_n8r2/__init__.pyi
 ./board_definitions/espressif_esp32c6_devkitc_1_n8/__init__.pyi
 ./board_definitions/espressif_esp32c6_devkitm_1_n4/__init__.pyi
@@ -580,6 +582,7 @@ setup.py
 ./board_definitions/targett_module_clip_wroom/__init__.pyi
 ./board_definitions/targett_module_clip_wrover/__init__.pyi
 ./board_definitions/teenage_engineering_ep2350/__init__.pyi
+./board_definitions/teenage_engineering_sp1/__init__.pyi
 ./board_definitions/teensy40/__init__.pyi
 ./board_definitions/teensy41/__init__.pyi
 ./board_definitions/teknikio_bluebird/__init__.pyi
@@ -688,6 +691,7 @@ setup.py
 ./displayio/__init__.pyi
 ./dotclockframebuffer/__init__.pyi
 ./dualbank/__init__.pyi
+./emmcio/__init__.pyi
 ./epaperdisplay/__init__.pyi
 ./espcamera/__init__.pyi
 ./espidf/__init__.pyi
@@ -938,6 +942,7 @@ board_definitions/challenger_840/__init__.pyi
 board_definitions/challenger_nb_rp2040_wifi/__init__.pyi
 board_definitions/challenger_rp2040_lora/__init__.pyi
 board_definitions/challenger_rp2040_lte/__init__.pyi
+board_definitions/challenger_rp2040_nfc/__init__.pyi
 board_definitions/challenger_rp2040_sdrtc/__init__.pyi
 board_definitions/challenger_rp2040_subghz/__init__.pyi
 board_definitions/challenger_rp2040_wifi/__init__.pyi
@@ -1008,6 +1013,7 @@ board_definitions/espressif_esp32_eye/__init__.pyi
 board_definitions/espressif_esp32_lyrat/__init__.pyi
 board_definitions/espressif_esp32c3_devkitm_1_n4/__init__.pyi
 board_definitions/espressif_esp32c3_lyra_v2/__init__.pyi
+board_definitions/espressif_esp32c5_devkitc_1_n8r8/__init__.pyi
 board_definitions/espressif_esp32c61_devkitc_1_n8r2/__init__.pyi
 board_definitions/espressif_esp32c6_devkitc_1_n8/__init__.pyi
 board_definitions/espressif_esp32c6_devkitm_1_n4/__init__.pyi
@@ -1365,6 +1371,7 @@ board_definitions/takayoshiotake_octave_rp2040/__init__.pyi
 board_definitions/targett_module_clip_wroom/__init__.pyi
 board_definitions/targett_module_clip_wrover/__init__.pyi
 board_definitions/teenage_engineering_ep2350/__init__.pyi
+board_definitions/teenage_engineering_sp1/__init__.pyi
 board_definitions/teensy40/__init__.pyi
 board_definitions/teensy41/__init__.pyi
 board_definitions/teknikio_bluebird/__init__.pyi
@@ -1480,6 +1487,7 @@ digitalio/__init__.pyi
 displayio/__init__.pyi
 dotclockframebuffer/__init__.pyi
 dualbank/__init__.pyi
+emmcio/__init__.pyi
 epaperdisplay/__init__.pyi
 espcamera/__init__.pyi
 espidf/__init__.pyi

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/circuitpython_stubs.egg-info/top_level.txt

@@ -41,6 +41,7 @@ digitalio-stubs
 displayio-stubs
 dotclockframebuffer-stubs
 dualbank-stubs
+emmcio-stubs
 epaperdisplay-stubs
 espcamera-stubs
 espidf-stubs

circuitpython_stubs-10.3.2/emmcio/__init__.pyi

@@ -0,0 +1,147 @@
+"""Block device access to the on-board eMMC
+
+The `emmcio` module exposes an eMMC chip as a block device.
+It provides no filesystem of its own: to read files, hand an `EMMC`
+object to `storage.VfsFat` and mount it.
+
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import microcontroller
+from circuitpython_typing import ReadableBuffer, WriteableBuffer
+
+class EMMC:
+    """eMMC as a block device"""
+
+    def __init__(
+        self,
+        *,
+        clock: microcontroller.Pin,
+        command: microcontroller.Pin,
+        data: microcontroller.Pin,
+        reset: Optional[microcontroller.Pin] = None,
+        vccq: Optional[microcontroller.Pin] = None,
+        high_speed: bool = False,
+        write_enabled: bool = False,
+    ) -> None:
+        """Power up the card and make it ready for block access.
+
+        Only one `EMMC` object may exist at a time. Call `deinit()`, or use
+        the object as a context manager, to release the card and its pins.
+
+        :param ~microcontroller.Pin clock: the card's CLK pin
+        :param ~microcontroller.Pin command: the card's CMD pin
+        :param ~microcontroller.Pin data: the card's DAT0 pin. The bus is
+          1-bit, so this is a single pin.
+        :param ~microcontroller.Pin reset: the card's RST_n pin, if the board
+          wires one
+        :param ~microcontroller.Pin vccq: a pin gating the card's I/O rail,
+          if the board has one
+        :param bool high_speed: Run the bus at its faster clock rate. Raises
+          an `OSError` if the card will not make the switch.
+        :param bool write_enabled: Allow `writeblocks()`. When `False`, the
+          object is read-only and every write path refuses.
+
+        :raises ValueError: if the pins are unusable or already in use, or
+          if the card is owned by the USB drive.
+        :raises OSError: if the card does not come up. ``emmcio failure: n``
+          names the MMC command that did not answer (``8`` being the
+          extended CSD), and ``high_speed failure: n`` how far the switch
+          got: ``0`` the card does not advertise 52 MHz, ``1`` no CMD6
+          response, ``2`` the card never released DAT0, ``3`` it never came
+          back to the transfer state, ``4`` the EXT_CSD readback did not
+          take, ``5`` the 32 MHz smoke test failed, ``7`` the card rejected
+          HS_TIMING.
+
+        Mount the card's filesystem::
+
+          import board
+          import emmcio
+          import storage
+
+          emmc = emmcio.EMMC(
+              clock=board.EMMC_CLK,
+              command=board.EMMC_CMD,
+              data=board.EMMC_DAT0,
+              reset=board.EMMC_RESET,
+              vccq=board.EMMC_VCCQ,
+              high_speed=True,
+              write_enabled=True,
+          )
+          storage.mount(storage.VfsFat(emmc), "/sd")
+        """
+        ...
+
+    def deinit(self) -> None:
+        """Release the card and the pins it uses. Any further use of this
+        object raises a `ValueError`."""
+        ...
+
+    def __enter__(self) -> EMMC:
+        """No-op used by Context Managers."""
+        ...
+
+    def __exit__(self) -> None:
+        """Automatically deinitializes the hardware when exiting a context. See
+        :ref:`lifetime-and-contextmanagers` for more info."""
+        ...
+
+    def readblocks(self, start_block: int, buf: WriteableBuffer) -> None:
+        """Read into ``buf`` starting at ``start_block``.
+
+        :param int start_block: the first block to read
+        :param WriteableBuffer buf: a buffer whose length is a non-zero
+          multiple of `block_size`
+
+        :raises ValueError: if ``buf`` is the wrong length, or the requested
+          blocks run past the end of the card.
+        :raises OSError: if the card fails to deliver the data."""
+        ...
+
+    def writeblocks(self, start_block: int, buf: ReadableBuffer) -> None:
+        """Write ``buf`` to the card starting at ``start_block``.
+
+        :param int start_block: the first block to write
+        :param ReadableBuffer buf: a buffer whose length is a non-zero
+          multiple of `block_size`
+
+        :raises RuntimeError: if this object was not constructed with
+          ``write_enabled=True``.
+        :raises ValueError: if ``buf`` is the wrong length, or the requested
+          blocks run past the end of the card.
+        :raises OSError: if the write fails."""
+        ...
+
+    def ioctl(self, op: int, arg: int) -> Optional[int]:
+        """Perform a block-device control operation, as required by the
+        block-device protocol. Returns `None` for operations this device does
+        not implement."""
+        ...
+
+    def read_ext_csd(self) -> bytes:
+        """Read the card's 512-byte extended CSD register."""
+        ...
+
+    def status(self) -> int:
+        """Read the card's 32-bit status register."""
+        ...
+    count: int
+    """The number of blocks on the card."""
+
+    block_size: int
+    """The size of one block, in bytes."""
+
+    cid: bytes
+    """The card's 16-byte identification register."""
+
+    write_enabled: bool
+    """Whether `writeblocks()` is permitted on this object."""
+
+    high_speed: bool
+    """Whether the card is running at its faster clock rate."""
+
+    frequency: int
+    """The bus clock rate in Hz."""

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/setup.py

@@ -46,6 +46,6 @@ setup(
     package_data=package_data,
     package_dir = package_dir,
     setup_requires=["setuptools>=38.6.0"],
-    version="10.3.0rc0",
+    version="10.3.2",
     zip_safe=False,
 )

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/usb_hid/__init__.pyi

@@ -17,6 +17,10 @@ If a boot device is enabled by `usb_hid.enable()`, *and* the host has requested
 the `devices` tuple is **replaced** when ``code.py`` starts with a single-element tuple
 containing a `Device` that describes the boot device chosen (keyboard or mouse).
 The request for a boot device overrides any other HID devices.
+
+If the host requests a boot device after ``code.py`` has started, `devices` is not replaced.
+The boot device then sends reports in the boot format, with no report ID, and
+`Device.send_report()` on any other device does nothing, because the host ignores it.
 """
 
 def disable() -> None:
@@ -173,6 +177,10 @@ class Device:
         The ``report`` itself will be discarded, to prevent unwanted extraneous characters,
         mouse clicks, etc.
 
+        If the host has put the interface in boot protocol, the boot device sends its report
+        without a report ID, and `send_report()` on any other device discards the report,
+        because the host reads only the boot device.
+
         Note: Host operating systems allow enabling and disabling specific devices
         and kinds of devices to do wakeup.
         The defaults are different for different operating systems.

{circuitpython_stubs-10.3.0rc0 → circuitpython_stubs-10.3.2}/wifi/__init__.pyi

@@ -164,10 +164,13 @@ class Radio:
     """
 
     def start_scanning_networks(
-        self, *, start_channel: int = 1, stop_channel: int = 11
+        self, *, start_channel: int = 1, stop_channel: int = 165
     ) -> Iterable[Network]:
         """Scans for available wifi networks over the given channel range. Make sure the channels are allowed in your country.
 
+        On dual-band radios, 5 GHz channels (36 and above) may also be given.
+        Channel numbers that the radio does not support are skipped.
+
         .. note::
 
             In the raspberrypi port (RP2040 CYW43), ``start_channel`` and ``stop_channel`` are ignored.