V2 docs: Add pin set_touch_mode() (#701)

* V2 docs: add set_touch_mode()

* V2 docs: add set_touch_mode() to micropython API doc

Author: microbit-mark

docs/microbit_micropython_api.rst

@@ -112,7 +112,8 @@ Provide digital and analog input and output functionality, for the pins in the
 connector, the **V2** logo and the **V2** speaker. Some pins are connected
 internally to the I/O that drives the LED matrix and the buttons.
 
-Each pin is provided as an object directly in the ``microbit`` module.  This keeps the API relatively flat, making it very easy to use:
+Each pin is provided as an object directly in the ``microbit`` module.  This
+keeps the API relatively flat, making it very easy to use:
 
     * pin0
     * pin1
@@ -144,13 +145,18 @@ Each of these pins are instances of the ``MicroBitPin`` class, which offers the
     # Only available for touch pins 0, 1, and 2. Returns boolean if the pin
     # is touched
     pin.is_touched()
+    # Only available for touch pins 0, 1, 2 and on micro:bit V2 also the logo.
+    # Sets the touch mode. Value can be either RESISTIVE or CAPACITIVE
+    pin.set_touch_mode(value)
 
 Except in the case of the pins marked **V2**, which offers the following API::
     
 pin_logo::
 
     # returns boolean for logo touch pin
     pin_logo.is_touched()
+    # Sets the touch mode. Value can be either RESISTIVE or CAPACITIVE
+    pin.set_touch_mode(value)
 
 pin_speaker:
 

docs/pin.rst

@@ -26,8 +26,9 @@ Pin Functions
 
 `Edge connector and pinout <https://tech.microbit.org/hardware/edgeconnector/#edge-connector-pins>`_
 
-Those pins are available as attributes on the ``microbit``
-module:``microbit.pin0`` - ``microbit.pin20``.
+This table summarises the pins available, their types and what
+they are internally connected to. The pins are available as attributes on the
+``microbit`` module: ``microbit.pin0`` - ``microbit.pin20``.
 
 +-----+---------+----------+-----------------+
 | Pin | Type    | Function | Function **V2** |
@@ -72,9 +73,6 @@ module:``microbit.pin0`` - ``microbit.pin20``.
 |  20 | Digital | I2C SDA  | I2C SDA         |
 +-----+---------+----------+-----------------+
 
-The above table summarizes the pins available, their types (see below) and what
-they are internally connected to.
-
 The latest micro:bit device **V2** has two additional pins that you can access
 in MicroPython, but that are not available via the edge connector:
 
@@ -206,7 +204,7 @@ its own to that.
             The default touch mode for the pins on the edge connector is 
             `resistive`. The default for the logo pin **V2** is `capacitive`.
 
-        **Resitive touch**
+        **Resistive touch**
         This test is done by measuring how much resistance there is between the
         pin and ground.  A low resistance gives a reading of ``True``.  To get
         a reliable reading using a finger you may need to touch the ground pin
@@ -217,6 +215,15 @@ its own to that.
         using a finger as a conductor. `Capacitive touch
         <https://www.allaboutcircuits.com/technical-articles/introduction-to-capacitive-touch-sensing>`_
         does not require you to make a ground connection as part of a circuit.
+
+    .. py:method:: set_touch_mode(value)
+
+        .. note::
+            The default touch mode for the pins on the edge connector is 
+            `resistive`. The default for the logo pin **V2** is `capacitive`.
+
+        Set the touch mode for the given pin. Value can be either ``CAPACITIVE``
+        or ``RESISTIVE``. For example, ``pin0.set_touch_mode(pin0.CAPACITIVE)``.
 
 The pull mode for a pin is automatically configured when the pin changes to an
 input mode. Input modes are when you call ``read_analog`` / ``read_digital`` /