Skip to content

Commit a45b5af

Browse files
authored
feat(doc): Add note about default pin changes to migration guide (#9507)
1 parent 9caa363 commit a45b5af

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

Diff for: docs/en/migration_guides/2.x_to_3.0.rst

+6-2
Original file line numberDiff line numberDiff line change
@@ -189,9 +189,13 @@ Changes in APIs
189189
Functional changes
190190
******************
191191

192+
* Default pins for some SoCs have been changed to avoid conflicts with other peripherals:
193+
* ESP32's UART1 RX and TX pins are now GPIO26 and GPIO27, respectively;
194+
* ESP32's UART2 RX and TX pins are now GPIO4 and GPIO25, respectively;
195+
* ESP32-S2's UART1 RX and TX pins are now GPIO4 and GPIO5, respectively.
192196
* It is now possible to detach UART0 pins by calling ``end()`` with no previous call of ``begin()``.
193197
* It is now possible to call ``setPins()`` before ``begin()`` or in any order.
194-
* ``setPins(``) will detach any previous pins that have been changed.
198+
* ``setPins()`` will detach any previous pins that have been changed.
195199
* ``begin(baud, rx, tx)`` will detach any previous attached pins.
196200
* ``setPins()`` or ``begin(baud, rx, tx)`` when called at first, will detach console RX0/TX0, attached in boot.
197201
* Any pin set as -1 in ``begin()`` or ``setPins()`` won't be changed nor detached.
@@ -206,4 +210,4 @@ Functional changes
206210

207211
* In Arduino (and other frameworks) the method named ``flush()`` is intended to send out the transmit buffer content. ``WiFiClient`` and ``WiFiUDP`` method ``flush()`` won't clear the receive buffer anymore. A new method called ``clear()`` is now used for that. Currently ``flush()`` does nothing in ``WiFiClient``, ``WiFiClientSecure`` and ``WiFiUDP``.
208212
* ``WiFiServer`` has functions ``accept()`` and ``available()`` with the same functionality. In Arduino, ``available()`` should work differently so it is now deprecated.
209-
* ``WiFiServer`` had unimplemented write functions inherited from ``Print`` class. These are now removed. Also unimplemented method ``stopAll()`` is removed. The methods were unimplemented because WiFiServer doesn't manage connected WiFiClient objects for print-to-all-clients functionality.
213+
* ``WiFiServer`` had unimplemented write functions inherited from ``Print`` class. These are now removed. Also unimplemented method ``stopAll()`` is removed. The methods were unimplemented because ``WiFiServer`` doesn't manage connected ``WiFiClient`` objects for print-to-all-clients functionality.

0 commit comments

Comments
 (0)