Update docstubs stubs for preview

Author: Josverl

stubs/micropython-v1_27_0_preview-docstubs/espnow/__init__.pyi

@@ -16,10 +16,74 @@ from _espnow import ESPNowBase  # type: ignore
 from _mpy_shed import mp_available
 
 MAX_DATA_LEN: Incomplete = 250
+"""\
+The following constants correspond to different transmit data rates on ESP32
+only. Lower data rates are generally more reliable over long distances:
+"""
 KEY_LEN: Incomplete = 16
+"""\
+The following constants correspond to different transmit data rates on ESP32
+only. Lower data rates are generally more reliable over long distances:
+"""
 ADDR_LEN: Incomplete = 6
+"""\
+The following constants correspond to different transmit data rates on ESP32
+only. Lower data rates are generally more reliable over long distances:
+"""
 MAX_TOTAL_PEER_NUM: Incomplete = 20
+"""\
+The following constants correspond to different transmit data rates on ESP32
+only. Lower data rates are generally more reliable over long distances:
+"""
 MAX_ENCRYPT_PEER_NUM: Incomplete = 6
+"""\
+The following constants correspond to different transmit data rates on ESP32
+only. Lower data rates are generally more reliable over long distances:
+"""
+RATE_LORA_250K: Incomplete
+"""See  `espnow-long-range`."""
+RATE_LORA_500K: Incomplete
+"""See  `espnow-long-range`."""
+RATE_1M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_2M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_5M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_6M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_11M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_12M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_24M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
+RATE_54M: Incomplete
+"""\
+Unless using the two proprietary long range data rates, only the sender must
+configure the data rate.
+"""
 _MACAddress: TypeAlias = bytes
 _PeerInfo: TypeAlias = Tuple[_MACAddress, bytes, int, int, bool]
 class ESPNow(ESPNowBase, Iterator):
@@ -124,13 +188,15 @@ class ESPNow(ESPNowBase, Iterator):
                 wait forever. The timeout can also be provided as arg to
                 `recv()`/`irecv()`/`recvinto()`.
         
-                *rate*: (ESP32 only) Set the transmission speed for
-                ESPNow packets. Must be set to a number from the allowed numeric values
-                in `enum wifi_phy_rate_t
-                <https://docs.espressif.com/projects/esp-idf/en/v5.2.3/esp32/
+                *rate*: (ESP32 only) Set the transmission data rate for ESPNow packets.
+                The default setting is `espnow.RATE_1M`. It's recommended to use one of
+                the other ``espnow.RATE_nnn`` constants to set this, but it's also
+                possible to pass an integer corresponding to the `enum wifi_phy_rate_t
+                <https://docs.espressif.com/projects/esp-idf/en/v5.5.1/esp32/
                 api-reference/network/esp_wifi.html#_CPPv415wifi_phy_rate_t>`_. This
                 parameter is actually *write-only* due to ESP-IDF not providing any
                 means for querying the radio interface's rate parameter.
+                See also `espnow-long-range`. This API currently doesn't work on ESP32-C6.
         
             Returns:
         

stubs/micropython-v1_27_0_preview-docstubs/modules.json

@@ -8,7 +8,7 @@
         "firmware": "micropython-v1_27_0_preview",
         "nodename": "micropython",
         "version": "v1.27.0-preview",
-        "release": "v1.27.0-preview-445-g207562dfa",
+        "release": "v1.27.0-preview-449-g938e2c0f2",
         "sysname": "micropython"
     },
     "stubber": {

stubs/micropython-v1_27_0_preview-docstubs/network/WLAN.pyi

@@ -27,6 +27,26 @@ class WLAN:
     savings and reduced WiFi performance
     * ``PM_NONE``: disable wifi power management
     """
+    PROTOCOL_DEFAULTS: Incomplete
+    """\
+    A bitmap representing all of the default 802.11 Wi-Fi modes supported by
+    the chip. Consult `ESP-IDF Wi-Fi Protocols`_ documentation for details.
+    """
+    PROTOCOL_LR: Incomplete
+    """\
+    This value corresponds to the `Espressif proprietary "long-range" mode`_,
+    which is not compatible with standard Wi-Fi devices. By setting this
+    protocol it's possible for an ESP32 STA in long-range mode to connect to
+    an ESP32 AP in long-range mode, or to use `ESP-NOW long range modes
+    <espnow-long-range>`.
+    
+    This mode can be bitwise ORed with some standard 802.11 protocol bits
+    (including `WLAN.PROTOCOL_DEFAULTS`) in order to support a mix of standard
+    Wi-Fi modes as well as LR mode, consult the `Espressif long-range
+    documentation`_ for more details.
+    
+    Long range mode is not supported on ESP32-C2.
+    """
     def __init__(self, interface_id) -> None: ...
     def active(self, is_active: Optional[Any] = None) -> None:
         """
@@ -153,6 +173,7 @@ class WLAN:
         reconnects     Number of reconnect attempts to make (integer, 0=none, -1=unlimited)
         txpower        Maximum transmit power in dBm (integer or float)
         pm             WiFi Power Management setting (see below for allowed values)
+        protocol       (ESP32 Only.) WiFi Low level 802.11 protocol. See `WLAN.PROTOCOL_DEFAULTS`.
         =============  ===========
         """
         ...