Document meaning of pin names to match silkscreen/schematics, closes #251

Author: probonopd

variants/Generic/variant.h

@@ -42,18 +42,18 @@ extern "C"
 #define NUM_ANALOG_OUTPUTS   (0u)
 
 // LEDs
-#define PIN_LED              (13)
+#define PIN_LED              (13) // P0.13
 #define LED_BUILTIN          PIN_LED
 
 /*
  * Analog pins
  */
-#define PIN_A0               (1)
-#define PIN_A1               (2)
-#define PIN_A2               (3)
-#define PIN_A3               (4)
-#define PIN_A4               (5)
-#define PIN_A5               (6)
+#define PIN_A0               (1) // P0.01
+#define PIN_A1               (2) // P0.02
+#define PIN_A2               (3) // P0.03
+#define PIN_A3               (4) // P0.04
+#define PIN_A4               (5) // P0.05
+#define PIN_A5               (6) // P0.06
 
 static const uint8_t A0  = PIN_A0 ;
 static const uint8_t A1  = PIN_A1 ;
@@ -71,19 +71,19 @@ static const uint8_t A5  = PIN_A5 ;
  * Serial interfaces
  */
 // Serial
-#define PIN_SERIAL_RX       (0)
-#define PIN_SERIAL_TX       (1)
+#define PIN_SERIAL_RX       (0) // P0.00
+#define PIN_SERIAL_TX       (1) // P0.01
 
 /*
  * SPI Interfaces
  */
 #define SPI_INTERFACES_COUNT 1
 
-#define PIN_SPI_MISO         (22)
-#define PIN_SPI_MOSI         (23)
-#define PIN_SPI_SCK          (24)
+#define PIN_SPI_MISO         (22) // P0.22
+#define PIN_SPI_MOSI         (23) // P0.23
+#define PIN_SPI_SCK          (24) // P0.24
 
-static const uint8_t SS   = 25 ;
+static const uint8_t SS   = 25 ;  // P0.25
 static const uint8_t MOSI = PIN_SPI_MOSI ;
 static const uint8_t MISO = PIN_SPI_MISO ;
 static const uint8_t SCK  = PIN_SPI_SCK ;
@@ -93,8 +93,8 @@ static const uint8_t SCK  = PIN_SPI_SCK ;
  */
 #define WIRE_INTERFACES_COUNT 1
 
-#define PIN_WIRE_SDA         (20u)
-#define PIN_WIRE_SCL         (21u)
+#define PIN_WIRE_SDA         (20u) // P0.20
+#define PIN_WIRE_SCL         (21u) // P0.21
 
 static const uint8_t SDA = PIN_WIRE_SDA;
 static const uint8_t SCL = PIN_WIRE_SCL;