issue fix plus pinout

Author: Martin O'Hanlon

docs/examples/print_pinout.py

@@ -0,0 +1,3 @@
+from picozero import pinout
+
+pinout()

docs/recipes.rst

@@ -48,6 +48,38 @@ Using the :obj:`pico_led` is equivalent to::
 
 You can use :obj:`pico_led` in the same way as external LEDs created using :class:`LED`.
 
+Pin out
+-------
+
+You can output a *diagram* of the Raspberry Pi Pico which displays its pins and their numbers.
+
+.. literalinclude:: examples/print_pinout.py
+
+::
+
+            ---usb---
+    GP0  1  |o     o| -1  VBUS
+    GP1  2  |o     o| -2  VSYS
+    GND  3  |o     o| -3  GND
+    GP2  4  |o     o| -4  3V3_EN
+    GP3  5  |o     o| -5  3V3(OUT)
+    GP4  6  |o     o| -6           ADC_VREF
+    GP5  7  |o     o| -7  GP28     ADC2
+    GND  8  |o     o| -8  GND      AGND
+    GP6  9  |o     o| -9  GP27     ADC1
+    GP7  10 |o     o| -10 GP26     ADC0
+    GP8  11 |o     o| -11 RUN
+    GP9  12 |o     o| -12 GP22
+    GND  13 |o     o| -13 GND
+    GP10 14 |o     o| -14 GP21
+    GP11 15 |o     o| -15 GP20
+    GP12 16 |o     o| -16 GP19
+    GP13 17 |o     o| -17 GP18
+    GND  18 |o     o| -18 GND
+    GP14 19 |o     o| -19 GP17
+    GP15 20 |o     o| -20 GP16
+            ---------
+
 LEDs
 ------
 

picozero/__init__.py

@@ -7,6 +7,8 @@
     PWMChannelAlreadyInUse,
     EventFailedScheduleQueueFull,
 
+    pinout,
+
     DigitalOutputDevice,
     DigitalLED,
     Buzzer,

picozero/picozero.py

@@ -18,6 +18,30 @@ class EventFailedScheduleQueueFull(Exception):
 
 def clamp(n, low, high): return max(low, min(n, high))
 
+def pinout():
+    print("""        ---usb---
+GP0  1  |o     o| -1  VBUS
+GP1  2  |o     o| -2  VSYS
+GND  3  |o     o| -3  GND
+GP2  4  |o     o| -4  3V3_EN
+GP3  5  |o     o| -5  3V3(OUT)
+GP4  6  |o     o| -6           ADC_VREF
+GP5  7  |o     o| -7  GP28     ADC2
+GND  8  |o     o| -8  GND      AGND
+GP6  9  |o     o| -9  GP27     ADC1
+GP7  10 |o     o| -10 GP26     ADC0
+GP8  11 |o     o| -11 RUN
+GP9  12 |o     o| -12 GP22
+GND  13 |o     o| -13 GND
+GP10 14 |o     o| -14 GP21
+GP11 15 |o     o| -15 GP20
+GP12 16 |o     o| -16 GP19
+GP13 17 |o     o| -17 GP18
+GND  18 |o     o| -18 GND
+GP14 19 |o     o| -19 GP17
+GP15 20 |o     o| -20 GP16
+        ---------""")
+
 class PinMixin:
     """
     Mixin used by devices that have a single pin number.
@@ -1630,7 +1654,7 @@ def when_deactivated(self):
         """
         return self._when_deactivated
 
-    @when_activated.setter
+    @when_deactivated.setter
     def when_deactivated(self, value):
         self._when_deactivated = value