docs: Add was_touched & touch_calibrate for pins 0, 1, 2 & pin_logo.

[microbit-carlos]

Preview:
https://microbit-micropython--802.org.readthedocs.build/en/802/pin.html#microbit.MicroBitTouchPin

[microbit-carlos]

Also took the opportunity to move the explanation of capacitive/resistive touch modes from is_touched() to set_touch_mode() and remove the duplicated note:

Before	After

[dpgeorge]

Should be pin_logo.get_touches(). Probably also the example below should be changed to pin_logo.set_touch_mode(value).

[microbit-carlos]

These methods are also available for pins 0, 1 and 2, so we are using pin. here as it's been done for pin.is_touched().

[dpgeorge]

But, this section/paragraph of the docs is all about pin_logo (see line 158/164 above). And the code snippets just above are for pin_logo.is_touched() and pin_logo.was_touched().

So, it should be pin_logo.get_touches() and pin_logo.set_touch_mode() for consistency within this paragraph.

[microbit-carlos]

Oh yes, you are right, I didn't notice in my last message that this was replicated in a pin_logo-only section.
Updated in https://github.com/bbcmicrobit/micropython/compare/4043fc290df1ef1cf281c8211995eca66e27a63f..1fbb7581cf90b6976b183cca855c2cc71989744f.

[dpgeorge]

Also took the opportunity to move the explanation of capacitive/resistive touch modes from is_touched() to set_touch_mode() and remove the duplicated note:

Yes, that's a good clean up.

[microbit-carlos]

As well keep this PR unmerged until the next MicroPython v2 beta is released, and this PR already touches the pin page, I've also added here the touch_calibrate() method.