762 Commits

Author	SHA1	Message	Date
Damien George	97af1001ae	rp2/machine_uart: Make it so TX is done only when no longer busy. ... Prior to this commit, when flushing a UART on the rp2 port, it returns just before the last character is sent out the wire. Fix this by waiting until the BUSY flag is cleared. This also fixes the behaviour of `UART.txdone()` to return `True` only when the last byte has gone out. Updated docs and tests to match. The test now checks that UART TX time is very close to the expected time (prior, it was just testing that the TX time was less than the expected time). Signed-off-by: Damien George <damien@micropython.org>	2024-10-22 10:17:05 +11:00
Phil Howard	e6093c0fbd	rp2/rp2_pio: Add support for RP2350A/B variants in PIO interface. ... Add support for 32 and 48 pin variants of RP2350. Add new `PIO.gpio_base()` method, mirroring the Pico SDK. Signed-off-by: Phil Howard <phil@gadgetoid.com> Signed-off-by: Damien George <damien@micropython.org>	2024-10-15 12:09:48 +11:00
Andrew Leech	7e14680a83	py/objringio: Add micropython.RingIO() interface for general use. ... This commit adds a new `RingIO` type which exposes the internal ring-buffer code for general use in Python programs. It has the stream interface making it similar to `StringIO` and `BytesIO`, except `RingIO` has a fixed buffer size and is automatically safe when reads and writes are in different threads or an IRQ. This new type is enabled at the "extra features" ROM level. Signed-off-by: Andrew Leech <andrew.leech@planetinnovation.com.au>	2024-09-19 18:00:44 +10:00
Angus Gratton	52a593cdb1	py/scheduler: Only run callbacks on the main thread if GIL is disabled. ... Otherwise it's very difficult to reason about thread safety in a scheduler callback, as it can run at any time on any thread - including racing against any bytecode operation on any thread. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-09-19 13:17:01 +10:00
Angus Gratton	fb069f9d06	docs/library: Document machine.Pin.toggle() method. ... Original commit was by @millosolomillo from 2022, but CI no longer accepts their auto-generated GitHub commit email... Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-09-19 12:04:39 +10:00
Damien George	8feb714b4d	docs/library: Document math.log with two arguments. ... The functionality is there but was not documented. Signed-off-by: Damien George <damien@micropython.org>	2024-09-17 11:22:26 +10:00
Damien George	35b6a66b0b	docs/library: Document the network.PPP class. ... Signed-off-by: Damien George <damien@micropython.org>	2024-08-29 23:47:55 +10:00
robert-hh	03b1b6d8e6	docs/library/machine.UART: Extend the documentation for UART.irq. ... For more ports and trigger options, based on the current state of the code. Signed-off-by: robert-hh <robert@hammelrath.com>	2024-08-29 16:48:09 +10:00
Damien George	9bbe61607a	docs/library/machine.UART: Fix UART.irq docs to match current code. ... These docs now match the code in `extmod/machine_uart.c`. IRQ trigger support still need to be updated for each port (to be done in a follow-up commit). Signed-off-by: Damien George <damien@micropython.org>	2024-08-29 16:34:45 +10:00
Tim Weber	d1685a3f5f	docs/library/neopixel: Mention bitstream timing tuple. ... Signed-off-by: Tim Weber <scy@scy.name>	2024-08-01 12:04:58 +10:00
Angus Gratton	81daba31c5	docs: Specify that machine.idle() returns at least every 1ms. ... A lot of existing code (i.e. micropython-lib lps22h, lcd160cr sensor drivers, lora sync_modem driver, usb-device-hid) calls machine.idle() inside a tight loop that is polling some condition. This reduces the power usage compared to constantly looping, but can be faster than calling a sleep function. However on a tickless port there's not always an interrupt before the condition they are polling for, so it's difficult to restructure this code if machine.idle() doesn't have any upper limit on execution time. This commit specifies an upper limit of 1ms before machine.idle() resumes execution. This is already the case for all ports except rp2. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-07-23 16:42:42 +10:00
Felix Dörre	4d16a9cced	docs: Update docs to replace ifconfig with ipconfig. ... Follow up to 1c6012b0b5 Signed-off-by: Felix Dörre <felix@dogcraft.de>	2024-07-05 16:06:04 +10:00
Felix Dörre	57008a1e69	extmod/machine_usb_device: Add USBDevice.remote_wakeup method. ... This simply exposes the TinyUSB function. Signed-off-by: Felix Dörre <felix@dogcraft.de>	2024-07-02 10:23:26 +10:00
Angus Gratton	908ab1ceca	py/objint: Fix int.to_bytes() buffer size checks. ... Fixes and improvements to `int.to_bytes()` are: - No longer overflows if byte size is 0 (closes #13041). - Raises OverflowError in any case where number won't fit into byte length (now matches CPython, previously MicroPython would return a truncated bytes object). - Document that `micropython int.to_bytes()` doesn't implement the optional signed kwarg, but will behave as if `signed=True` when the integer is negative (this is the current behaviour). Add tests for this also. Requires changes for small ints, MPZ large ints, and "long long" large ints. Adds a new set of unit tests for ints between 32 and 64 bits to increase coverage of "long long" large ints, which are otherwise untested. Tested on unix port (64 bit small ints, MPZ long ints) and Zephyr STM32WB board (32 bit small ints, long long large ints). This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-06-24 14:07:00 +10:00
Damien George	abd1f28bc2	docs/library/asyncio: Document that ThreadSafeFlag now works on unix. ... ThreadSafeFlag works on the unix port since commit df08c38c28. Signed-off-by: Damien George <damien@micropython.org>	2024-05-15 14:13:30 +10:00
Angus Gratton	c3301da176	docs/library/machine.USBDevice: Update note about packages in mp-lib. ... Also fix a small typo. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-05-09 15:48:26 +10:00
Angus Gratton	d11ca092f7	shared/tinyusb: Fix dynamic USB control callbacks for wLength==0. ... In the case where an OUT control transfer triggers with wLength==0 (i.e. all data sent in the SETUP phase, and no additional data phase) the callbacks were previously implemented to return b"" (i.e. an empty buffer for the data phase). However this didn't actually work as intended because b"" can't provide a RW buffer (needed for OUT transfers with a data phase to write data into), so actually the endpoint would stall. The symptom was often that the device process the request (if processing it in the SETUP phase when all information was already available), but the host sees the endpoint stall and eventually returns an error. This commit changes the behaviour so returning True from the SETUP phase of a control transfer queues a zero length status response. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-04-17 12:39:47 +10:00
Amirreza Hamzavi	57de9da352	docs/library/machine.RTC: Add docs for RTC.memory() method. ... Co-Authored-By: glenn20 <glenn20@users.noreply.github.com> Signed-off-by: Amirreza Hamzavi <amirrezahamzavi2000@gmail.com>	2024-03-26 17:59:06 +11:00
Matthias Urlichs	e520fa2e0f	py/binary: Support half-float 'e' format in struct pack/unpack. ... This commit implements the 'e' half-float format: 10-bit mantissa, 5-bit exponent. It uses native _Float16 if supported by the compiler, otherwise uses custom bitshifting encoding/decoding routines. Signed-off-by: Matthias Urlichs <matthias@urlichs.de> Signed-off-by: Damien George <damien@micropython.org>	2024-03-20 14:13:49 +11:00
Nicko van Someren	77f08b72ca	docs/library/rp2.DMA: Add documentation for rp2 DMA support. ... Signed-off-by: Nicko van Someren <nicko@nicko.org>	2024-03-19 17:10:54 +11:00
Damien George	d92dff881c	docs/library/collections: Update deque docs to describe new features. ... Signed-off-by: Damien George <damien@micropython.org>	2024-03-19 10:09:11 +11:00
iabdalkader	e5ca06a06f	docs/library/openamp: Document the new openamp module. ... Signed-off-by: iabdalkader <i.abdalkader@gmail.com>	2024-03-15 18:11:28 +11:00
Angus Gratton	9d0d262be0	extmod/machine_usb_device: Add support for Python USB devices. ... This new machine-module driver provides a "USBDevice" singleton object and a shim TinyUSB "runtime" driver that delegates the descriptors and all of the TinyUSB callbacks to Python functions. This allows writing arbitrary USB devices in pure Python. It's also possible to have a base built-in USB device implemented in C (eg CDC, or CDC+MSC) and a Python USB device added on top of that. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2024-03-15 14:22:11 +11:00
Phil Howard	dda9b9c6da	all: Prune trailing whitespace. ... Prune trailing whitespace across the whole project (almost), done automatically with: grep -IUrl --color "[[:blank:]]$" --exclude-dir=.git --exclude=*.exp |\ xargs sed -i 's/[[:space:]]*$//' Exceptions: - Skip third-party code in lib/ and drivers/cc3100/ - Skip generated code in bluetooth_init_cc2564C_1.5.c - Preserve command output whitespace in docs, eg: docs/esp8266/tutorial/repl.rst Signed-off-by: Phil Howard <phil@gadgetoid.com>	2024-03-07 16:25:17 +11:00
Daniël van de Giessen	678707c8b0	docs/library/bluetooth: Add note that ESP32 supports pairing/bonding. ... Pairing and bonding was fixed for the ESP32 in the two previous commits. Signed-off-by: Daniël van de Giessen <daniel@dvdgiessen.nl>	2024-02-29 14:33:22 +11:00
Jos Verlinde	2bdaa1bede	docs/library/sys.rst: Document implementation.version.releaselevel. ... Signed-off-by: Jos Verlinde <jos_verlinde@hotmail.com>	2024-02-07 15:51:25 +11:00
Damien George	4c56b39051	docs: Use vfs module instead of os. ... Signed-off-by: Damien George <damien@micropython.org>	2024-02-07 13:25:10 +11:00
Damien George	45f99cb445	docs/library: Move vfs functions and classes from os to vfs module docs. ... Signed-off-by: Damien George <damien@micropython.org>	2024-02-07 13:25:09 +11:00
Damien George	ac8e7f7b67	docs/library/ssl: Change wrap_socket args keyfile/certfile to key/cert. ... So they match the code in extmod/modssl_*.c. Signed-off-by: Damien George <damien@micropython.org>	2024-02-05 13:05:29 +11:00
Damien George	ee226a8b43	all: Fix "reuse" and "overridden" spelling mistakes. ... Codespell doesn't pick up "re-used" or "re-uses", and ignores the tests/ directory, so fix these manually. Signed-off-by: Damien George <damien@micropython.org>	2024-01-05 15:08:33 +11:00
Carlosgg	05d3b22301	docs/library: Document SSLContext cert methods and asyncio support. ... Add `load_cert_chain`, `load_verify_locations`, `get_ciphers` and `set_ciphers` SSLContext methods in ssl library, and update asyncio `open_connection` and `start_server` methods with ssl support. Signed-off-by: Carlos Gil <carlosgilglez@gmail.com>	2023-12-14 13:06:39 +11:00
Angus Gratton	a800ed5ae3	docs/library/esp: Correct the description of esp.osdebug(). ... The behaviour described in the docs was not correct for either port. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2023-11-22 16:48:35 +11:00
Mark Blakeney	2888c5b230	esp32/esp32_rmt: Add RMT.PULSE_MAX constant. ... If you have a variable frequency and pulse width, and you want to optimize pulse resolution, then you must do a calculation beforehand to ensure you normalize the array to keep all list values within bound. That calculation requires RMT.source_freq(), RMT.clock_div(), and this 32767 constant. Signed-off-by: Mark Blakeney <mark.blakeney@bullet-systems.net>	2023-11-09 13:51:52 +11:00
Mark Blakeney	fbb7c32040	esp32/esp32_rmt: Change RMT.source_freq() to class method. ... To create an esp32.RMT() instance with an optimum (i.e. highest resolution) clock_div is currently awkward because you need to know the source clock frequency to calculate the best clock_div, but unfortunately that is only currently available as an source_freq() method on the instance after you have already created it. So RMT.source_freq() should really be a class method, not an instance method. This change is backwards compatible for existing code because you can still reference that function from an instance, or now also, from the class. Signed-off-by: Mark Blakeney <mark.blakeney@bullet-systems.net>	2023-11-09 13:51:47 +11:00
Damien George	03eae48847	extmod/machine_adc_block: Factor esp32 ADCBlock bindings to common code. ... This is a code factoring to have the Python bindings in one location, and all the ports use those same bindings. At this stage only esp32 implements this class, so the code for the bindings comes from that port. The documentation is also updated to reflect the esp32's behaviour of ADCBlock.connect(). Signed-off-by: Damien George <damien@micropython.org>	2023-11-07 16:44:35 +11:00
Thomas Ackermann	ac4f79592b	docs/library/io: Remove io.FileIO and io.TextIOWrapper. ... FileIO and TextIOWrapper were removed in e65d1e69e8. Remove them also from the documentation. Signed-off-by: Thomas Ackermann <th.acker@arcor.de>	2023-10-16 23:07:13 +11:00
Jim Mussared	b329fdcb73	extmod/modnetwork: Increase max hostname length to 32. ... This changes from the previous limit of 15 characters. Although DHCP and mDNS allow for up to 63, ESP32 and ESP8266 only allow 32, so this seems like a reasonable limit to enforce across all ports (and avoids wasting the additional memory). Also clarifies that `MICROPY_PY_NETWORK_HOSTNAME_MAX_LEN` does not include the null terminator (which was unclear before). This work was funded through GitHub Sponsors. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>	2023-10-04 12:39:23 +11:00
Damien George	cf490a7091	all: Fix various spelling mistakes found by codespell 2.2.6. ... Signed-off-by: Damien George <damien@micropython.org>	2023-10-03 11:24:50 +11:00
Angus Gratton	92f379cce4	docs/library/gc: Clarify mem_alloc and mem_free only for Python heap. ... As raised in discussions of the ESP32 memory management changes. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2023-09-15 12:19:13 +10:00
Angus Gratton	26160e8ed5	docs/library/esp32: Update ESP32 idf_heap_info docs to match behaviour. ... Signed-off-by: Angus Gratton <angus@redyak.com.au>	2023-09-15 12:19:13 +10:00
Glenn Moloney	0bafdaf5f0	esp32: Skip validation of image on boot from deepsleep. ... sdkconfig.base: Add CONFIG_BOOTLOADER_SKIP_VALIDATE_IN_DEEP_SLEEP=y. This reduces time to boot from deepsleep by at least 200ms and can provide significant power savings for deepsleep-based battery applications. docs/library/esp32.rst: Add note cautioning not to enter deepsleep after changing the boot partition, without first performing a hard reset. Signed-off-by: Glenn Moloney <glenn.moloney@gmail.com>	2023-09-05 22:36:06 +10:00
Jim Mussared	304f13a74e	docs/library/network: Clarify network.hostname() behaviour. ... This must be called before the interface connects. This work was funded through GitHub Sponsors. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>	2023-09-04 22:45:37 +10:00
Francis Dela Cruz	d00105494f	docs/library/platform: Add docs for the platform library. ... Signed-off-by: Francis Dela Cruz <rainyworlds1@outlook.com>	2023-09-04 22:40:56 +10:00
Andy Piper	845d0c79ff	docs/library/neopixel: Change link to a micropython-lib reference. ... Signed-off-by: Andy Piper <andypiperuk@gmail.com>	2023-09-01 13:56:34 +10:00
Jim Mussared	32db4c58f7	extmod/moddeflate: Change default window size. ... The primary purpose of this commit is to make decompress default to wbits=15 when the format is gzip (or auto format with gzip detected). The idea is that someone decompressing a gzip stream should be able to use the default `deflate.DeflateIO(f)` and it will "just work" for any input stream, even though it uses a lot of memory. This is done by making uzlib report gzip files as having wbits set to 15 in their header (where it previously only set the wbits out parameter for zlib files), and then fixing up the logic in `deflateio_init_read`. Updates the documentation to match. This work was funded through GitHub Sponsors. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>	2023-09-01 12:23:37 +10:00
Angus Gratton	02620c2236	stm32/subghz: Add STM32WL55 subghz radio interface to stm module. ... This is the minimum C interface to allow a modem driver to be built in Python. Interface is simple, with the intention that the micropython-lib driver is the main (only) consumer of it. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2023-08-23 11:58:11 +10:00
Angus Gratton	05dcb8be99	esp32: Enable automatic Python heap growth. ... Via MICROPY_GC_SPLIT_HEAP_AUTO feature flag added in previous commit. Tested on ESP32 GENERIC_SPIRAM and GENERIC_S3 configurations, with some worst-case allocation patterns and the standard test suite. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>	2023-08-15 10:50:46 +10:00
Jim Mussared	b804443cb3	docs/library/deflate: Add docs for deflate.DeflateIO. ... Also update zlib & gzip docs to describe the micropython-lib modules. This work was funded through GitHub Sponsors. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>	2023-07-21 19:32:42 +10:00
Damien George	713a45124b	docs/library/ssl: Add documentation for SSLContext. ... Signed-off-by: Damien George <damien@micropython.org>	2023-06-26 16:34:41 +10:00
Damien George	68e0e889b4	docs/esp32: Update esp32 docs based on IDF v5 changes. ... Signed-off-by: Damien George <damien@micropython.org>	2023-06-23 15:34:49 +10:00