docs/esp32/quickref: Document GPIO drive strength.

Add brief documentation of the new `drive` keyword argument.
This commit is contained in:
Jonathan Hogg 2022-03-07 09:03:49 +00:00 committed by Damien George
parent 33083bf527
commit 4c7c80d626
1 changed files with 10 additions and 0 deletions

View File

@ -160,6 +160,7 @@ Use the :ref:`machine.Pin <machine.Pin>` class::
p4 = Pin(4, Pin.IN, Pin.PULL_UP) # enable internal pull-up resistor p4 = Pin(4, Pin.IN, Pin.PULL_UP) # enable internal pull-up resistor
p5 = Pin(5, Pin.OUT, value=1) # set pin high on creation p5 = Pin(5, Pin.OUT, value=1) # set pin high on creation
p6 = Pin(6, Pin.OUT, drive=Pin.DRIVE_3) # set maximum drive strength
Available Pins are from the following ranges (inclusive): 0-19, 21-23, 25-27, 32-39. Available Pins are from the following ranges (inclusive): 0-19, 21-23, 25-27, 32-39.
These correspond to the actual GPIO pin numbers of ESP32 chip. Note that many These correspond to the actual GPIO pin numbers of ESP32 chip. Note that many
@ -167,6 +168,15 @@ end-user boards use their own adhoc pin numbering (marked e.g. D0, D1, ...).
For mapping between board logical pins and physical chip pins consult your board For mapping between board logical pins and physical chip pins consult your board
documentation. documentation.
Four drive strengths are supported, using the ``drive`` keyword argument to the
``Pin()`` constructor or ``Pin.init()`` method, with different corresponding
safe maximum source/sink currents and approximate internal driver resistances:
- ``Pin.DRIVE_0``: 5mA / 130 ohm
- ``Pin.DRIVE_1``: 10mA / 60 ohm
- ``Pin.DRIVE_2``: 20mA / 30 ohm (default strength if not configured)
- ``Pin.DRIVE_3``: 40mA / 15 ohm
Notes: Notes:
* Pins 1 and 3 are REPL UART TX and RX respectively * Pins 1 and 3 are REPL UART TX and RX respectively