Clear I2C status on short slave reads

Fixes #222 The HW needs to have the TXC_ABRT flag cleared when a slave transmission is cut short by the master, or else it will effectively break the I2C bus and never recover.
Fix file creation on SD and SDFS (#216 )
2021-06-25 18:39:44 -07:00 · 2021-06-19 12:15:11 -07:00 · 2021-06-16 08:25:24 -07:00 · 2021-06-16 08:17:09 -07:00 · 2021-06-14 08:59:52 -07:00 · 2021-06-13 14:11:23 -07:00
43 changed files with 3050 additions and 347 deletions
@@ -28,6 +28,8 @@ jobs:
        BUILD_TYPE: package
        CI_GITHUB_API_KEY: ${{ secrets.GITHUB_TOKEN }}
      run: |
+           (cd pico-sdk && git submodule update --init)
+           (cd pico-extras && git submodule update --init)
           (cd ./package && bash ./build_boards_manager_package.sh)
           pip3 install PyGithub
           # Create a draft release and upload the ZIP and JSON files.
@@ -1,8 +1,10 @@
-# Arduino-Pico [![Join the chat at https://gitter.im/arduino-pico/community](https://badges.gitter.im/arduino-pico/community.svg)](https://gitter.im/arduino-pico/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+# Arduino-Pico
+[![Release](https://img.shields.io/github/v/release/earlephilhower/arduino-pico?style=plastic)](https://github.com/earlephilhower/arduino-pico/releases)
+[![Gitter](https://img.shields.io/gitter/room/earlephilhower/arduino-pico?style=plastic)](https://gitter.im/arduino-pico/community)

 Raspberry Pi Pico Arduino core, for all RP2040 boards

-This is a port of the RP2040 (Raspberry Pi Pico processor) to the Arduino ecosystem. It uses the bare Raspberry Pi Pico SDK and a custom GCC 10.2/Newlib 4.0 toolchain.
+This is a port of the RP2040 (Raspberry Pi Pico processor) to the Arduino ecosystem. It uses the bare Raspberry Pi Pico SDK and a custom GCC 10.3/Newlib 4.0 toolchain.

 # Documentation
 See https://arduino-pico.readthedocs.io/en/latest/ along with the examples for more detailed usage information.
@@ -11,9 +13,12 @@ See https://arduino-pico.readthedocs.io/en/latest/ along with the examples for m
 * Raspberry Pi Pico
 * Adafruit Feather RP2040
 * Adafruit ItsyBitsy RP2040
+* Adafruit Macropad RP2040
 * Adafruit QTPy RP2040
 * Adafruit STEMMA Friend RP2040
 * Adafruit Trinkey RP2040 QT
+* Arduino Nano RP2040 Connect (preliminary)
+* SparkFun ProMicro RP2040
 * Generic (configurable flash, I/O pins)

 # Installing via Arduino Boards Manager
@@ -24,16 +24,11 @@
 #include <stdint.h>
 #include <stdlib.h>
 #include <string.h>
-// Wacky deprecated AVR compatibility functions
-#include "stdlib_noniso.h"
-
+#include "stdlib_noniso.h" // Wacky deprecated AVR compatibility functions
 #include "api/ArduinoAPI.h"
+#include "api/itoa.h" // ARM toolchain doesn't provide itoa etc, provide them
 #include <pins_arduino.h>
-
-
-// Required for the port*Register macros
-#include "hardware/gpio.h"
-
+#include "hardware/gpio.h" // Required for the port*Register macros
 #include "debug_internal.h"

 // Try and make the best of the old Arduino abs() macro.  When in C++, use
@@ -44,8 +39,10 @@
 #endif // abs
 #ifdef __cplusplus
 using std::abs;
+using std::round;
 #else
-#define abs(x) ((x)>0?(x):-(x))
+#define abs(x) ({ __typeof__(x) _x = (x); _x >= 0 ? _x : -_x; })
+#define round(x) ({ __typeof__(x) _x = (x); _x >= 0 ? (long)(_x + 0.5) : (long)(_x - 0.5); })
 #endif

 #ifdef __cplusplus
@@ -61,10 +58,6 @@ extern "C" {
 void interrupts();
 void noInterrupts();

-// GPIO change/value interrupts
-void attachInterrupt(pin_size_t pin, voidFuncPtr callback, PinStatus mode);
-void detachInterrupt(pin_size_t pin);
-
 // AVR compatibility macros...naughty and accesses the HW directly
 #define digitalPinToPort(pin)       (0)
 #define digitalPinToBitMask(pin)    (1UL << (pin))
@@ -75,28 +68,14 @@ void detachInterrupt(pin_size_t pin);
 #define portInputRegister(port)     ((volatile uint32_t*) sio_hw->gpio_in)
 #define portModeRegister(port)      ((volatile uint32_t*) sio_hw->gpio_oe)

-// IO config
-void pinMode(pin_size_t pinNumber, PinMode pinMode);
-
-// SIO (GPIO)
-void digitalWrite(pin_size_t pinNumber, PinStatus status);
-PinStatus digitalRead(pin_size_t pinNumber);
-
-// ADC
-int analogRead(pin_size_t pinNumber);
+// ADC RP2040-specific calls
 float analogReadTemp();  // Returns core temp in Centigrade

-// PWM
-void analogWrite(pin_size_t pinNumber, int value);
+// PWM RP2040-specific calls
 void analogWriteFreq(uint32_t freq);
 void analogWriteRange(uint32_t range);
 void analogWriteResolution(int res);

-// Timing
-void delay(unsigned long);
-void delayMicroseconds(unsigned int us);
-unsigned long millis();
-
 #ifdef __cplusplus
 } // extern "C"
 #endif
@@ -127,8 +106,4 @@ constexpr uint32_t __bitset(const int (&a)[N], size_t i = 0U) {
 }
 #endif

-
-// ARM toolchain doesn't provide itoa etc, provide them
-#include "api/itoa.h"
-
 #endif // Arduino_h
@@ -153,7 +153,8 @@ static uint8_t *GetDescHIDReport(int *len) {
 // Invoked when received GET HID REPORT DESCRIPTOR
 // Application return pointer to descriptor
 // Descriptor contents must exist long enough for transfer to complete
-uint8_t const * tud_hid_descriptor_report_cb(void) {
+uint8_t const * tud_hid_descriptor_report_cb(uint8_t instance) {
+    (void) instance;
    return GetDescHIDReport(nullptr);
 }

@@ -177,7 +178,7 @@ const uint8_t *tud_descriptor_configuration_cb(uint8_t index) {
        uint8_t hid_itf = __USBInstallSerial ? 2 : 0;
        static uint8_t hid_desc[TUD_HID_DESC_LEN] = {
            // Interface number, string index, protocol, report descriptor len, EP In & Out address, size & polling interval
-            TUD_HID_DESCRIPTOR(hid_itf, 0, HID_PROTOCOL_NONE, hid_report_len, EPNUM_HID, CFG_TUD_HID_EP_BUFSIZE, 10)
+            TUD_HID_DESCRIPTOR(hid_itf, 0, HID_ITF_PROTOCOL_NONE, hid_report_len, EPNUM_HID, CFG_TUD_HID_EP_BUFSIZE, 10)
        };

        uint8_t midi_itf = hid_itf + (hasHID ? 1 : 0);
@@ -230,15 +231,7 @@ const uint16_t *tud_descriptor_string_cb(uint8_t index, uint16_t langid) {
    };

    if (!idString[0]) {
-        // Get ID string into human readable serial number on the first pass
-        pico_unique_board_id_t id;
-        pico_get_unique_board_id(&id);
-        idString[0] = 0;
-        for (auto i = 0; i < PICO_UNIQUE_BOARD_ID_SIZE_BYTES; i++) {
-            char hx[3];
-            sprintf(hx, "%02X", id.id[i]);
-            strcat(idString, hx);
-        }
+        pico_get_unique_board_id_string(idString, sizeof(idString));
    }

    uint8_t len;
@@ -296,8 +289,9 @@ void __USBStart() {
 // Invoked when received GET_REPORT control request
 // Application must fill buffer report's content and return its length.
 // Return zero will cause the stack to STALL request
-uint16_t tud_hid_get_report_cb(uint8_t report_id, hid_report_type_t report_type, uint8_t* buffer, uint16_t reqlen) {
-    // TODO not Implemented
+extern "C" uint16_t tud_hid_get_report_cb(uint8_t instance, uint8_t report_id, hid_report_type_t report_type, uint8_t* buffer, uint16_t reqlen) {
+    // TODO not implemented
+    (void) instance;
    (void) report_id;
    (void) report_type;
    (void) buffer;
@@ -308,8 +302,9 @@ uint16_t tud_hid_get_report_cb(uint8_t report_id, hid_report_type_t report_type,

 // Invoked when received SET_REPORT control request or
 // received data on OUT endpoint ( Report ID = 0, Type = 0 )
-void tud_hid_set_report_cb(uint8_t report_id, hid_report_type_t report_type, uint8_t const* buffer, uint16_t bufsize) {
+extern "C" void tud_hid_set_report_cb(uint8_t instance, uint8_t report_id, hid_report_type_t report_type, uint8_t const* buffer, uint16_t bufsize) {
    // TODO set LED based on CAPLOCK, NUMLOCK etc...
+    (void) instance;
    (void) report_id;
    (void) report_type;
    (void) buffer;
@@ -317,4 +312,3 @@ void tud_hid_set_report_cb(uint8_t report_id, hid_report_type_t report_type, uin
 }

 #endif
-
@@ -31,36 +31,38 @@
 extern void serialEvent1() __attribute__((weak));
 extern void serialEvent2() __attribute__((weak));

-bool SerialUART::setRX(pin_size_t rx) {
+bool SerialUART::setRX(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({1, 13, 17, 29}) /* UART0 */,
                                    __bitset({5, 9, 21, 25})  /* UART1 */
                                  };
-    if (_running) {
-        DEBUGCORE("ERROR: SerialUART setRX while running\n");
-        return false;
-    } else if ((1 << rx) & valid[uart_get_index(_uart)]) {
-        _rx = rx;
+    if ((!_running) && ((1 << pin) & valid[uart_get_index(_uart)])) {
+        _rx = pin;
        return true;
-    } else {
-        DEBUGCORE("ERROR: SerialUART setRX illegal pin (%d)\n", rx);
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set Serial%d.RX while running", uart_get_index(_uart) + 1);
+    } else {
+        panic("FATAL: Attempting to set Serial%d.RX to illegal pin %d", uart_get_index(_uart) + 1, pin);
+    }
+    return false;
 }

-bool SerialUART::setTX(pin_size_t tx) {
+bool SerialUART::setTX(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({0, 12, 16, 28}) /* UART0 */,
                                    __bitset({4, 8, 20, 24})  /* UART1 */
                                  };
-    if (_running) {
-        DEBUGCORE("ERROR: SerialUART setTX while running\n");
-        return false;
-    } else if ((1 << tx) & valid[uart_get_index(_uart)]) {
-        _tx = tx;
+    if ((!_running) && ((1 << pin) & valid[uart_get_index(_uart)])) {
+        _tx = pin;
        return true;
-    } else {
-        DEBUGCORE("ERROR: SerialUART setTX illegal pin (%d)\n", tx);
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set Serial%d.TX while running", uart_get_index(_uart) + 1);
+    } else {
+        panic("FATAL: Attempting to set Serial%d.TX to illegal pin %d", uart_get_index(_uart) + 1, pin);
+    }
+    return false;
 }

 SerialUART::SerialUART(uart_inst_t *uart, pin_size_t tx, pin_size_t rx) {
@@ -113,7 +115,11 @@ int SerialUART::peek() {
    if (_peek >= 0) {
        return _peek;
    }
-    _peek = uart_getc(_uart);
+    if (uart_is_readable_within_us(_uart, _timeout * 1000)) {
+        _peek = uart_getc(_uart);
+    } else {
+        _peek = -1; // Timeout
+    }
    return _peek;
 }

@@ -127,7 +133,11 @@ int SerialUART::read() {
        _peek = -1;
        return ret;
    }
-    return uart_getc(_uart);
+    if (uart_is_readable_within_us(_uart, _timeout * 1000)) {
+        return uart_getc(_uart);
+    } else {
+        return -1; // Timeout
+    }
 }

 int SerialUART::available() {
@@ -151,7 +161,7 @@ void SerialUART::flush() {
    if (!_running || !m) {
        return;
    }
-    uart_default_tx_wait_blocking();
+    uart_tx_wait_blocking(_uart);
 }

 size_t SerialUART::write(uint8_t c) {
@@ -70,7 +70,7 @@ int SerialUSB::peek() {
    }

    uint8_t c;
-    return tud_cdc_peek(0, &c) ? (int) c : -1;
+    return tud_cdc_peek(&c) ? (int) c : -1;
 }

 int SerialUSB::read() {
@@ -28,16 +28,24 @@ typedef struct {
    pin_size_t pin;
    PIO pio;
    int sm;
+    alarm_id_t alarm;
 } Tone;

 // Keep std::map safe for multicore use
 auto_init_mutex(_toneMutex);

-
-#include "tone.pio.h"
-static PIOProgram _tonePgm(&tone_program);
+#include "tone2.pio.h"
+static PIOProgram _tone2Pgm(&tone2_program);
 static std::map<pin_size_t, Tone *> _toneMap;

+int64_t _stopTonePIO(alarm_id_t id, void *user_data) {
+    (void) id;
+    Tone *tone = (Tone *)user_data;
+    tone->alarm = 0;
+    pio_sm_set_enabled(tone->pio, tone->sm, false);
+    return 0;
+}
+
 void tone(uint8_t pin, unsigned int frequency, unsigned long duration) {
    if (pin > 29) {
        DEBUGCORE("ERROR: Illegal pin in tone (%d)\n", pin);
@@ -58,32 +66,43 @@ void tone(uint8_t pin, unsigned int frequency, unsigned long duration) {
    if (us < 5) {
        us = 5;
    }
-    // Even phases run forever, odd phases end after count...so ensure its odd
-    int phases = duration ? (duration * 1000 / us) | 1 : 2;
    auto entry = _toneMap.find(pin);
-    if (entry != _toneMap.end()) {
-        noTone(pin);
+    Tone *newTone;
+    if (entry == _toneMap.end()) {
+        newTone = new Tone();
+        newTone->pin = pin;
+        pinMode(pin, OUTPUT);
+        int off;
+        if (!_tone2Pgm.prepare(&newTone->pio, &newTone->sm, &off)) {
+            DEBUGCORE("ERROR: tone unable to start, out of PIO resources\n");
+            // ERROR, no free slots
+            delete newTone;
+            return;
+        }
+        tone2_program_init(newTone->pio, newTone->sm, off, pin);
+        newTone->alarm = 0;
+    } else {
+        newTone = entry->second;
+        if (newTone->alarm) {
+            cancel_alarm(newTone->alarm);
+            newTone->alarm = 0;
+        }
    }
-
-    auto newTone = new Tone();
-    newTone->pin = pin;
-    pinMode(pin, OUTPUT);
-    int off;
-    if (!_tonePgm.prepare(&newTone->pio, &newTone->sm, &off)) {
-        DEBUGCORE("ERROR: tone unable to start, out of PIO resources\n");
-        // ERROR, no free slots
-        delete newTone;
-        return;
-    }
-    tone_program_init(newTone->pio, newTone->sm, off, pin);
-    pio_sm_set_enabled(newTone->pio, newTone->sm, false);
+    pio_sm_clear_fifos(newTone->pio, newTone->sm); // Remove any old updates that haven't yet taken effect
    pio_sm_put_blocking(newTone->pio, newTone->sm, RP2040::usToPIOCycles(us));
-    pio_sm_exec(newTone->pio, newTone->sm, pio_encode_pull(false, false));
-    pio_sm_exec(newTone->pio, newTone->sm, pio_encode_out(pio_isr, 32));
    pio_sm_set_enabled(newTone->pio, newTone->sm, true);
-    pio_sm_put_blocking(newTone->pio, newTone->sm, phases);

    _toneMap.insert({pin, newTone});
+
+    if (duration) {
+        auto ret = add_alarm_in_ms(duration, _stopTonePIO, (void *)newTone, true);
+        if (ret > 0) {
+            newTone->alarm = ret;
+        } else {
+            DEBUGCORE("ERROR: Unable to allocate timer for tone(%d, %d, %d)\n",
+                      pin, frequency, duration);
+        }
+    }
 }

 void noTone(uint8_t pin) {
@@ -95,6 +114,10 @@ void noTone(uint8_t pin) {
    }
    auto entry = _toneMap.find(pin);
    if (entry != _toneMap.end()) {
+        if (entry->second->alarm) {
+            cancel_alarm(entry->second->alarm);
+            entry->second->alarm = 0;
+        }
        pio_sm_set_enabled(entry->second->pio, entry->second->sm, false);
        pio_sm_unclaim(entry->second->pio, entry->second->sm);
        delete entry->second;
@@ -1,52 +0,0 @@
-// -------------------------------------------------- //
-// This file is autogenerated by pioasm; do not edit! //
-// -------------------------------------------------- //
-
-#if !PICO_NO_HARDWARE
-#include "hardware/pio.h"
-#endif
-
-// ---- //
-// tone //
-// ---- //
-
-#define tone_wrap_target 0
-#define tone_wrap 7
-
-static const uint16_t tone_program_instructions[] = {
-    //     .wrap_target
-    0x80a0, //  0: pull   block
-    0xa027, //  1: mov    x, osr
-    0xb846, //  2: mov    y, isr          side 1
-    0x0083, //  3: jmp    y--, 3
-    0x0045, //  4: jmp    x--, 5
-    0xb046, //  5: mov    y, isr          side 0
-    0x0086, //  6: jmp    y--, 6
-    0x0042, //  7: jmp    x--, 2
-    //     .wrap
-};
-
-#if !PICO_NO_HARDWARE
-static const struct pio_program tone_program = {
-    .instructions = tone_program_instructions,
-    .length = 8,
-    .origin = -1,
-};
-
-static inline pio_sm_config tone_program_get_default_config(uint offset) {
-    pio_sm_config c = pio_get_default_sm_config();
-    sm_config_set_wrap(&c, offset + tone_wrap_target, offset + tone_wrap);
-    sm_config_set_sideset(&c, 2, true, false);
-    return c;
-}
-
-static inline void tone_program_init(PIO pio, uint sm, uint offset, uint pin) {
-    pio_gpio_init(pio, pin);
-    pio_sm_set_consecutive_pindirs(pio, sm, pin, 1, true);
-    pio_sm_config c = tone_program_get_default_config(offset);
-    sm_config_set_sideset_pins(&c, pin);
-    pio_sm_init(pio, sm, offset, &c);
-}
-
-#endif
-
@@ -1,4 +1,4 @@
-; Tone for the Raspberry Pi Pico RP2040
+; Tone2 for the Raspberry Pi Pico RP2040
 ;
 ; Copyright (c) 2021 Earle F. Philhower, III <earlephilhower@yahoo.com>
 ;
@@ -18,32 +18,35 @@

 ; Side-set pin 0 is used for Tone output

-.program tone
+; OSR == Halfcycle count
+
+.program tone2
 .side_set 1 opt

-    pull
-    mov x, osr
+    pull                     ; TXFIFO -> OSR, or X -> OSR if no new period
+    mov x, osr               ; OSR -> X

 high:
-    mov y, isr      side 1
+    pull noblock             ; Potentially grab new HALFCYCLECOUNT, OTW copy from backup in X
+    mov x, osr               ; OSR -> X
+    mov y, osr      side 1   ; HALFCYCLECOUNT -> Y
 highloop:
-    jmp y-- highloop
-
-    jmp x-- low
+    jmp y-- highloop         ; while (y--) { /* noop delay */ }

 low:
-    mov y, isr      side 0
+    mov y, osr      side 0   ; HALFCYCLECOUNT -> Y
 lowloop:
-    jmp y-- lowloop
+    jmp y-- lowloop          ; while (y--) { /* noop delay */ }

-    jmp x-- high
+    jmp high                 ; GOTO high

 % c-sdk {
-static inline void tone_program_init(PIO pio, uint sm, uint offset, uint pin) {
+static inline void tone2_program_init(PIO pio, uint sm, uint offset, uint pin) {
   pio_gpio_init(pio, pin);
   pio_sm_set_consecutive_pindirs(pio, sm, pin, 1, true);
-   pio_sm_config c = tone_program_get_default_config(offset);
+   pio_sm_config c = tone2_program_get_default_config(offset);
   sm_config_set_sideset_pins(&c, pin);
   pio_sm_init(pio, sm, offset, &c);
 }
 %}
+
@@ -0,0 +1,53 @@
+// -------------------------------------------------- //
+// This file is autogenerated by pioasm; do not edit! //
+// -------------------------------------------------- //
+
+#if !PICO_NO_HARDWARE
+#include "hardware/pio.h"
+#endif
+
+// ----- //
+// tone2 //
+// ----- //
+
+#define tone2_wrap_target 0
+#define tone2_wrap 8
+
+static const uint16_t tone2_program_instructions[] = {
+    //     .wrap_target
+    0x80a0, //  0: pull   block
+    0xa027, //  1: mov    x, osr
+    0x8080, //  2: pull   noblock
+    0xa027, //  3: mov    x, osr
+    0xb847, //  4: mov    y, osr          side 1
+    0x0085, //  5: jmp    y--, 5
+    0xb047, //  6: mov    y, osr          side 0
+    0x0087, //  7: jmp    y--, 7
+    0x0002, //  8: jmp    2
+    //     .wrap
+};
+
+#if !PICO_NO_HARDWARE
+static const struct pio_program tone2_program = {
+    .instructions = tone2_program_instructions,
+    .length = 9,
+    .origin = -1,
+};
+
+static inline pio_sm_config tone2_program_get_default_config(uint offset) {
+    pio_sm_config c = pio_get_default_sm_config();
+    sm_config_set_wrap(&c, offset + tone2_wrap_target, offset + tone2_wrap);
+    sm_config_set_sideset(&c, 2, true, false);
+    return c;
+}
+
+static inline void tone2_program_init(PIO pio, uint sm, uint offset, uint pin) {
+    pio_gpio_init(pio, pin);
+    pio_sm_set_consecutive_pindirs(pio, sm, pin, 1, true);
+    pio_sm_config c = tone2_program_get_default_config(offset);
+    sm_config_set_sideset_pins(&c, pin);
+    pio_sm_init(pio, sm, offset, &c);
+}
+
+#endif
+
@@ -63,6 +63,7 @@ extern "C" void digitalWrite(pin_size_t ulPin, PinStatus ulVal) {
        DEBUGCORE("ERROR: Illegal pin in pinMode (%d)\n", ulPin);
        return;
    }
+    gpio_set_function(ulPin, GPIO_FUNC_SIO);
    if (_pm[ulPin] == INPUT_PULLDOWN) {
        if (ulVal == LOW) {
            gpio_set_dir(ulPin, false);
@@ -38,3 +38,15 @@ using the SDK, the Arduino core may have issues running properly with
 them.  In particular, anything involving flash writes (i.e. EEPROM,
 filesystems) will probably crash due to CORE1 attempting to read from
 flash while CORE0 is writing to it.
+
+PIOASM (Compiling for the PIO processors)
+-----------------------------------------
+A precompiled version of the PIOASM tool is included in the download
+package and can be run from the CLI.
+
+There is also a fully online version of PIOASM that runs in a web
+browser without any CLI required, thanks to @jake653: https://wokwi.com/tools/pioasm
+(GitHub source: https://github.com/wokwi/pioasm-wasm)
+
+There is also Docker code available for the tool at:
+https://github.com/kahara/pioasm-docker
@@ -12,8 +12,8 @@
 #define _PICO_VERSION_H

 #define PICO_SDK_VERSION_MAJOR    1
-#define PICO_SDK_VERSION_MINOR    1
-#define PICO_SDK_VERSION_REVISION 2
-#define PICO_SDK_VERSION_STRING   "1.1.2"
+#define PICO_SDK_VERSION_MINOR    2
+#define PICO_SDK_VERSION_REVISION 0
+#define PICO_SDK_VERSION_STRING   "1.2.0"

 #endif
@@ -0,0 +1,83 @@
+/*
+  This example reads audio data from the on-board PDM microphones, and prints
+  out the samples to the Serial console. The Serial Plotter built into the
+  Arduino IDE can be used to plot the audio data (Tools -> Serial Plotter)
+
+  Circuit:
+  - Arduino Nano 33 BLE board, or
+  - Arduino Nano RP2040 Connect, or
+  - Arduino Portenta H7 board plus Portenta Vision Shield
+
+  This example code is in the public domain.
+*/
+
+#include <PDM.h>
+
+// default number of output channels
+static const char channels = 1;
+
+// default PCM output frequency
+static const int frequency = 16000;
+
+// Buffer to read samples into, each sample is 16-bits
+short sampleBuffer[512];
+
+// Number of audio samples read
+volatile int samplesRead;
+
+void setup() {
+  Serial.begin(9600);
+  while (!Serial);
+
+  // Configure the data receive callback
+  PDM.onReceive(onPDMdata);
+
+  // Optionally set the gain
+  // Defaults to 20 on the BLE Sense and -10 on the Portenta Vision Shield
+  // PDM.setGain(30);
+
+  // Initialize PDM with:
+  // - one channel (mono mode)
+  // - a 16 kHz sample rate for the Arduino Nano 33 BLE Sense
+  // - a 32 kHz or 64 kHz sample rate for the Arduino Portenta Vision Shield
+  if (!PDM.begin(channels, frequency)) {
+    Serial.println("Failed to start PDM!");
+    while (1);
+  }
+}
+
+void loop() {
+  // Wait for samples to be read
+  if (samplesRead) {
+
+    // Print samples to the serial monitor or plotter
+    for (int i = 0; i < samplesRead; i++) {
+      if(channels == 2) {
+        Serial.print("L:");
+        Serial.print(sampleBuffer[i]);
+        Serial.print(" R:");
+        i++;
+      }
+      Serial.println(sampleBuffer[i]);
+    }
+
+    // Clear the read count
+    samplesRead = 0;
+  }
+}
+
+/**
+ * Callback function to process the data from the PDM microphone.
+ * NOTE: This callback is executed as part of an ISR.
+ * Therefore using `Serial` to print messages inside this function isn't supported.
+ * */
+void onPDMdata() {
+  // Query the number of available bytes
+  int bytesAvailable = PDM.available();
+
+  // Read into the sample buffer
+  PDM.read(sampleBuffer, bytesAvailable);
+
+  // 16-bit, 2 bytes per sample
+  samplesRead = bytesAvailable / 2;
+}
@@ -0,0 +1,27 @@
+#######################################
+# Syntax Coloring Map PDM
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+PDM	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+begin	KEYWORD2
+end	KEYWORD2
+
+available	KEYWORD2
+read	KEYWORD2
+
+onReceive	KEYWORD2
+
+setGain	KEYWORD2
+setBufferSize	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################
@@ -0,0 +1,9 @@
+name=PDM
+version=1.0
+author=Arduino
+maintainer=Arduino <info@arduino.cc>
+sentence=Enables the communication with devices that use the PDM Bus. Specific implementation for nRF52.
+paragraph=
+category=Communication
+url=
+architectures=rp2040
@@ -0,0 +1,68 @@
+/*
+  Copyright (c) 2019 Arduino LLC.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#ifndef _PDM_H_INCLUDED
+#define _PDM_H_INCLUDED
+
+#include <Arduino.h>
+//#include <pinDefinitions.h>
+
+#include "utility/PDMDoubleBuffer.h"
+
+class PDMClass
+{
+public:
+  PDMClass(int dinPin, int clkPin, int pwrPin);
+  virtual ~PDMClass();
+
+  int begin(int channels, int sampleRate);
+  void end();
+
+  virtual int available();
+  virtual int read(void* buffer, size_t size);
+
+  void onReceive(void(*)(void));
+
+  //PORTENTA_H7 min -12 max 51
+  //NANO 33 BLE SENSe min 0 max 80
+  void setGain(int gain);
+  void setBufferSize(int bufferSize);
+  size_t getBufferSize();
+
+// private:
+  void IrqHandler(bool halftranfer);
+
+private:
+  int _dinPin;
+  int _clkPin;
+  int _pwrPin;
+
+  int _channels;
+  int _samplerate;
+
+  int _gain;
+  int _init;
+
+  PDMDoubleBuffer _doubleBuffer;
+
+  void (*_onReceive)(void);
+};
+#ifdef PIN_PDM_DIN
+extern PDMClass PDM;
+#endif
+#endif
@@ -0,0 +1,313 @@
+/**
+ *******************************************************************************
+ * @file    OpenPDMFilter.c
+ * @author  CL
+ * @version V1.0.0
+ * @date    9-September-2015
+ * @brief   Open PDM audio software decoding Library.   
+ *          This Library is used to decode and reconstruct the audio signal
+ *          produced by ST MEMS microphone (MP45Dxxx, MP34Dxxx). 
+ *******************************************************************************
+ * @attention
+ *
+ * <h2><center>&copy; COPYRIGHT 2018 STMicroelectronics</center></h2>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *******************************************************************************
+ */
+
+
+/* Includes ------------------------------------------------------------------*/
+
+#include "OpenPDMFilter.h"
+
+
+/* Variables -----------------------------------------------------------------*/
+
+uint32_t div_const = 0;
+int64_t sub_const = 0;
+uint32_t sinc[DECIMATION_MAX * SINCN];
+uint32_t sinc1[DECIMATION_MAX];
+uint32_t sinc2[DECIMATION_MAX * 2];
+uint32_t coef[SINCN][DECIMATION_MAX];
+#ifdef USE_LUT
+int32_t lut[256][DECIMATION_MAX / 8][SINCN];
+#endif
+
+
+/* Functions -----------------------------------------------------------------*/
+
+#ifdef USE_LUT
+int32_t filter_table_mono_64(uint8_t *data, uint8_t sincn)
+{
+  return (int32_t)
+    lut[data[0]][0][sincn] +
+    lut[data[1]][1][sincn] +
+    lut[data[2]][2][sincn] +
+    lut[data[3]][3][sincn] +
+    lut[data[4]][4][sincn] +
+    lut[data[5]][5][sincn] +
+    lut[data[6]][6][sincn] +
+    lut[data[7]][7][sincn];
+}
+int32_t filter_table_stereo_64(uint8_t *data, uint8_t sincn)
+{
+  return (int32_t)
+    lut[data[0]][0][sincn] +
+    lut[data[2]][1][sincn] +
+    lut[data[4]][2][sincn] +
+    lut[data[6]][3][sincn] +
+    lut[data[8]][4][sincn] +
+    lut[data[10]][5][sincn] +
+    lut[data[12]][6][sincn] +
+    lut[data[14]][7][sincn];
+}
+int32_t filter_table_mono_128(uint8_t *data, uint8_t sincn)
+{
+  return (int32_t)
+    lut[data[0]][0][sincn] +
+    lut[data[1]][1][sincn] +
+    lut[data[2]][2][sincn] +
+    lut[data[3]][3][sincn] +
+    lut[data[4]][4][sincn] +
+    lut[data[5]][5][sincn] +
+    lut[data[6]][6][sincn] +
+    lut[data[7]][7][sincn] +
+    lut[data[8]][8][sincn] +
+    lut[data[9]][9][sincn] +
+    lut[data[10]][10][sincn] +
+    lut[data[11]][11][sincn] +
+    lut[data[12]][12][sincn] +
+    lut[data[13]][13][sincn] +
+    lut[data[14]][14][sincn] +
+    lut[data[15]][15][sincn];
+}
+int32_t filter_table_stereo_128(uint8_t *data, uint8_t sincn)
+{
+  return (int32_t)
+    lut[data[0]][0][sincn] +
+    lut[data[2]][1][sincn] +
+    lut[data[4]][2][sincn] +
+    lut[data[6]][3][sincn] +
+    lut[data[8]][4][sincn] +
+    lut[data[10]][5][sincn] +
+    lut[data[12]][6][sincn] +
+    lut[data[14]][7][sincn] +
+    lut[data[16]][8][sincn] +
+    lut[data[18]][9][sincn] +
+    lut[data[20]][10][sincn] +
+    lut[data[22]][11][sincn] +
+    lut[data[24]][12][sincn] +
+    lut[data[26]][13][sincn] +
+    lut[data[28]][14][sincn] +
+    lut[data[30]][15][sincn];
+}
+int32_t (* filter_tables_64[2]) (uint8_t *data, uint8_t sincn) = {filter_table_mono_64, filter_table_stereo_64};
+int32_t (* filter_tables_128[2]) (uint8_t *data, uint8_t sincn) = {filter_table_mono_128, filter_table_stereo_128};
+#else
+int32_t filter_table(uint8_t *data, uint8_t sincn, TPDMFilter_InitStruct *param)
+{
+  uint8_t c, i;
+  uint16_t data_index = 0;
+  uint32_t *coef_p = &coef[sincn][0];
+  int32_t F = 0;
+  uint8_t decimation = param->Decimation;
+  uint8_t channels = param->In_MicChannels;
+
+  for (i = 0; i < decimation; i += 8) {
+    c = data[data_index];
+    F += ((c >> 7)       ) * coef_p[i    ] +
+         ((c >> 6) & 0x01) * coef_p[i + 1] +
+         ((c >> 5) & 0x01) * coef_p[i + 2] +
+         ((c >> 4) & 0x01) * coef_p[i + 3] +
+         ((c >> 3) & 0x01) * coef_p[i + 4] +
+         ((c >> 2) & 0x01) * coef_p[i + 5] +
+         ((c >> 1) & 0x01) * coef_p[i + 6] +
+         ((c     ) & 0x01) * coef_p[i + 7];
+    data_index += channels;
+  }
+  return F;
+}
+#endif
+
+void convolve(uint32_t Signal[/* SignalLen */], unsigned short SignalLen,
+              uint32_t Kernel[/* KernelLen */], unsigned short KernelLen,
+              uint32_t Result[/* SignalLen + KernelLen - 1 */])
+{
+  uint16_t n;
+
+  for (n = 0; n < SignalLen + KernelLen - 1; n++)
+  {
+    unsigned short kmin, kmax, k;
+    
+    Result[n] = 0;
+    
+    kmin = (n >= KernelLen - 1) ? n - (KernelLen - 1) : 0;
+    kmax = (n < SignalLen - 1) ? n : SignalLen - 1;
+    
+    for (k = kmin; k <= kmax; k++) {
+      Result[n] += Signal[k] * Kernel[n - k];
+    }
+  }
+}
+
+void Open_PDM_Filter_Init(TPDMFilter_InitStruct *Param)
+{
+  uint16_t i, j;
+  int64_t sum = 0;
+
+  uint8_t decimation = Param->Decimation;
+
+  for (i = 0; i < SINCN; i++) {
+    Param->Coef[i] = 0;
+    Param->bit[i] = 0;
+  }
+  for (i = 0; i < decimation; i++) {
+    sinc1[i] = 1;
+  }
+
+  Param->OldOut = Param->OldIn = Param->OldZ = 0;
+  Param->LP_ALFA = (Param->LP_HZ != 0 ? (uint16_t) (Param->LP_HZ * 256 / (Param->LP_HZ + Param->Fs / (2 * 3.14159))) : 0);
+  Param->HP_ALFA = (Param->HP_HZ != 0 ? (uint16_t) (Param->Fs * 256 / (2 * 3.14159 * Param->HP_HZ + Param->Fs)) : 0);
+
+  Param->FilterLen = decimation * SINCN;       
+  sinc[0] = 0;
+  sinc[decimation * SINCN - 1] = 0;      
+  convolve(sinc1, decimation, sinc1, decimation, sinc2);
+  convolve(sinc2, decimation * 2 - 1, sinc1, decimation, &sinc[1]);     
+  for(j = 0; j < SINCN; j++) {
+    for (i = 0; i < decimation; i++) {
+      coef[j][i] = sinc[j * decimation + i];
+      sum += sinc[j * decimation + i];
+    }
+  }
+
+  sub_const = sum >> 1;
+  div_const = sub_const * Param->MaxVolume / 32768 / Param->filterGain;
+  div_const = (div_const == 0 ? 1 : div_const);
+
+#ifdef USE_LUT
+  /* Look-Up Table. */
+  uint16_t c, d, s;
+  for (s = 0; s < SINCN; s++)
+  {
+    uint32_t *coef_p = &coef[s][0];
+    for (c = 0; c < 256; c++)
+      for (d = 0; d < decimation / 8; d++)
+        lut[c][d][s] = ((c >> 7)       ) * coef_p[d * 8    ] +
+                       ((c >> 6) & 0x01) * coef_p[d * 8 + 1] +
+                       ((c >> 5) & 0x01) * coef_p[d * 8 + 2] +
+                       ((c >> 4) & 0x01) * coef_p[d * 8 + 3] +
+                       ((c >> 3) & 0x01) * coef_p[d * 8 + 4] +
+                       ((c >> 2) & 0x01) * coef_p[d * 8 + 5] +
+                       ((c >> 1) & 0x01) * coef_p[d * 8 + 6] +
+                       ((c     ) & 0x01) * coef_p[d * 8 + 7];
+  }
+#endif
+}
+
+void Open_PDM_Filter_64(uint8_t* data, int16_t* dataOut, uint16_t volume, TPDMFilter_InitStruct *Param)
+{
+  uint8_t i, data_out_index;
+  uint8_t channels = Param->In_MicChannels;
+  uint8_t data_inc = ((DECIMATION_MAX >> 4) * channels);
+  int64_t Z, Z0, Z1, Z2;
+  int64_t OldOut, OldIn, OldZ;
+
+  OldOut = Param->OldOut;
+  OldIn = Param->OldIn;
+  OldZ = Param->OldZ;
+
+#ifdef USE_LUT
+  uint8_t j = channels - 1;
+#endif
+
+  for (i = 0, data_out_index = 0; i < Param->nSamples; i++, data_out_index += channels) {
+#ifdef USE_LUT
+    Z0 = filter_tables_64[j](data, 0);
+    Z1 = filter_tables_64[j](data, 1);
+    Z2 = filter_tables_64[j](data, 2);
+#else
+    Z0 = filter_table(data, 0, Param);
+    Z1 = filter_table(data, 1, Param);
+    Z2 = filter_table(data, 2, Param);
+#endif
+
+    Z = Param->Coef[1] + Z2 - sub_const;
+    Param->Coef[1] = Param->Coef[0] + Z1;
+    Param->Coef[0] = Z0;
+
+    OldOut = (Param->HP_ALFA * (OldOut + Z - OldIn)) >> 8;
+    OldIn = Z;
+    OldZ = ((256 - Param->LP_ALFA) * OldZ + Param->LP_ALFA * OldOut) >> 8;
+
+    Z = OldZ * volume;
+    Z = RoundDiv(Z, div_const);
+    Z = SaturaLH(Z, -32700, 32700);
+
+    dataOut[data_out_index] = Z;
+    data += data_inc;
+  }
+
+  Param->OldOut = OldOut;
+  Param->OldIn = OldIn;
+  Param->OldZ = OldZ;
+}
+
+void Open_PDM_Filter_128(uint8_t* data, int16_t* dataOut, uint16_t volume, TPDMFilter_InitStruct *Param)
+{
+  uint8_t i, data_out_index;
+  uint8_t channels = Param->In_MicChannels;
+  uint8_t data_inc = ((DECIMATION_MAX >> 3) * channels);
+  int64_t Z, Z0, Z1, Z2;
+  int64_t OldOut, OldIn, OldZ;
+
+  OldOut = Param->OldOut;
+  OldIn = Param->OldIn;
+  OldZ = Param->OldZ;
+
+#ifdef USE_LUT
+  uint8_t j = channels - 1;
+#endif
+
+  for (i = 0, data_out_index = 0; i < Param->nSamples; i++, data_out_index += channels) {
+#ifdef USE_LUT
+    Z0 = filter_tables_128[j](data, 0);
+    Z1 = filter_tables_128[j](data, 1);
+    Z2 = filter_tables_128[j](data, 2);
+#else
+    Z0 = filter_table(data, 0, Param);
+    Z1 = filter_table(data, 1, Param);
+    Z2 = filter_table(data, 2, Param);
+#endif
+
+    Z = Param->Coef[1] + Z2 - sub_const;
+    Param->Coef[1] = Param->Coef[0] + Z1;
+    Param->Coef[0] = Z0;
+
+    OldOut = (Param->HP_ALFA * (OldOut + Z - OldIn)) >> 8;
+    OldIn = Z;
+    OldZ = ((256 - Param->LP_ALFA) * OldZ + Param->LP_ALFA * OldOut) >> 8;
+
+    Z = OldZ * volume;
+    Z = RoundDiv(Z, div_const);
+    Z = SaturaLH(Z, -32700, 32700);
+
+    dataOut[data_out_index] = Z;
+    data += data_inc;
+  }
+
+  Param->OldOut = OldOut;
+  Param->OldIn = OldIn;
+  Param->OldZ = OldZ;
+}
@@ -0,0 +1,99 @@
+/**
+ *******************************************************************************
+ * @file    OpenPDMFilter.h
+ * @author  CL
+ * @version V1.0.0
+ * @date    9-September-2015
+ * @brief   Header file for Open PDM audio software decoding Library.   
+ *          This Library is used to decode and reconstruct the audio signal
+ *          produced by ST MEMS microphone (MP45Dxxx, MP34Dxxx). 
+ *******************************************************************************
+ * @attention
+ *
+ * <h2><center>&copy; COPYRIGHT 2018 STMicroelectronics</center></h2>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *******************************************************************************
+ */
+
+
+/* Define to prevent recursive inclusion -------------------------------------*/
+
+#ifndef __OPENPDMFILTER_H
+#define __OPENPDMFILTER_H
+
+#ifdef __cplusplus
+  extern "C" {
+#endif
+
+
+/* Includes ------------------------------------------------------------------*/
+
+#include <stdint.h>
+
+
+/* Definitions ---------------------------------------------------------------*/
+
+/*
+ * Enable to use a Look-Up Table to improve performances while using more FLASH
+ * and RAM memory.
+ * Note: Without Look-Up Table up to stereo@16KHz configuration is supported.
+ */
+#define USE_LUT
+
+#define SINCN            3
+#define DECIMATION_MAX 128
+
+#define HTONS(A) ((((uint16_t)(A) & 0xff00) >> 8) | \
+                 (((uint16_t)(A) & 0x00ff) << 8))
+#define RoundDiv(a, b)    (((a)>0)?(((a)+(b)/2)/(b)):(((a)-(b)/2)/(b)))
+#define SaturaLH(N, L, H) (((N)<(L))?(L):(((N)>(H))?(H):(N)))
+
+
+/* Types ---------------------------------------------------------------------*/
+
+typedef struct {
+  /* Public */
+  float LP_HZ;
+  float HP_HZ;
+  uint16_t Fs;
+  unsigned int nSamples;
+  uint8_t In_MicChannels;
+  uint8_t Out_MicChannels;
+  uint8_t Decimation;
+  uint8_t MaxVolume;
+  /* Private */
+  uint32_t Coef[SINCN];
+  uint16_t FilterLen;
+  int64_t OldOut, OldIn, OldZ;
+  uint16_t LP_ALFA;
+  uint16_t HP_ALFA;
+  uint16_t bit[5];
+  uint16_t byte;
+  uint16_t filterGain;
+} TPDMFilter_InitStruct;
+
+
+/* Exported functions ------------------------------------------------------- */
+
+void Open_PDM_Filter_Init(TPDMFilter_InitStruct *init_struct);
+void Open_PDM_Filter_64(uint8_t* data, int16_t* data_out, uint16_t mic_gain, TPDMFilter_InitStruct *init_struct);
+void Open_PDM_Filter_128(uint8_t* data, int16_t* data_out, uint16_t mic_gain, TPDMFilter_InitStruct *init_struct);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // __OPENPDMFILTER_H
+
+/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
@@ -0,0 +1,205 @@
+
+
+#include "Arduino.h"
+#include "PDM.h"
+#include "OpenPDMFilter.h"
+
+extern "C" {
+#include "hardware/pio.h"
+#include "hardware/dma.h"
+#include "hardware/clocks.h"
+}
+#include "hardware/sync.h" 
+#include "pdm.pio.h"
+
+// Hardware peripherals used
+uint dmaChannel = 0;
+PIO pio = pio0;
+uint sm = 0;
+
+// raw buffers contain PDM data
+#define RAW_BUFFER_SIZE 512 // should be a multiple of (decimation / 8)
+uint8_t rawBuffer0[RAW_BUFFER_SIZE];
+uint8_t rawBuffer1[RAW_BUFFER_SIZE];
+uint8_t* rawBuffer[2] = {rawBuffer0, rawBuffer1};
+volatile int rawBufferIndex = 0; 
+
+int decimation = 64;
+
+// final buffer is the one to be filled with PCM data
+int16_t* volatile finalBuffer;
+
+// OpenPDM filter used to convert PDM into PCM
+#define FILTER_GAIN     16
+TPDMFilter_InitStruct filter;
+
+extern "C" {
+  __attribute__((__used__)) void dmaHandler(void)
+  {
+    PDM.IrqHandler(true);
+  }
+}
+
+
+PDMClass::PDMClass(int dinPin, int clkPin, int pwrPin) :
+  _dinPin(dinPin),
+  _clkPin(clkPin),
+  _pwrPin(pwrPin),
+  _onReceive(NULL),
+  _gain(-1),
+  _channels(-1),
+  _samplerate(-1),
+  _init(-1)
+{
+}
+
+PDMClass::~PDMClass()
+{
+}
+
+int PDMClass::begin(int channels, int sampleRate)
+{
+  //_channels = channels; // only one channel available
+
+  // clear the final buffers
+  _doubleBuffer.reset();
+  finalBuffer = (int16_t*)_doubleBuffer.data();
+  int finalBufferLength = _doubleBuffer.availableForWrite() / sizeof(int16_t);
+  _doubleBuffer.swap(0);
+
+  int rawBufferLength = RAW_BUFFER_SIZE / (decimation / 8);
+  // Saturate number of samples. Remaining bytes are dropped.
+  if (rawBufferLength > finalBufferLength) {
+    rawBufferLength = finalBufferLength;
+  }
+
+  /* Initialize Open PDM library */
+  filter.Fs = sampleRate;
+  filter.nSamples = rawBufferLength;
+  filter.LP_HZ = sampleRate/2;
+  filter.HP_HZ = 10;
+  filter.In_MicChannels = 1;
+  filter.Out_MicChannels = 1;
+  filter.Decimation = decimation;
+  if(_gain == -1) {
+    _gain = FILTER_GAIN;
+  }
+  filter.filterGain = _gain;
+  Open_PDM_Filter_Init(&filter);
+
+  // Configure PIO state machine
+  float clkDiv = (float)clock_get_hz(clk_sys) / sampleRate / decimation / 2; 
+  uint offset = pio_add_program(pio, &pdm_pio_program);
+  pdm_pio_program_init(pio, sm, offset, _clkPin, _dinPin, clkDiv);
+
+  // Wait for microphone 
+  delay(100);
+
+  // Configure DMA for transferring PIO rx buffer to raw buffers
+  dma_channel_config c = dma_channel_get_default_config(dmaChannel);
+  channel_config_set_read_increment(&c, false);
+  channel_config_set_write_increment(&c, true);
+  channel_config_set_dreq(&c, pio_get_dreq(pio, sm, false));
+  channel_config_set_transfer_data_size(&c, DMA_SIZE_8);
+
+  // Clear DMA interrupts
+  dma_hw->ints0 = 1u << dmaChannel; 
+  // Enable DMA interrupts
+  dma_channel_set_irq0_enabled(dmaChannel, true);
+  irq_set_exclusive_handler(DMA_IRQ_0, dmaHandler);
+  irq_set_enabled(DMA_IRQ_0, true);
+
+  dma_channel_configure(dmaChannel, &c,
+    rawBuffer[rawBufferIndex],        // Destinatinon pointer
+    &pio->rxf[sm],      // Source pointer
+    RAW_BUFFER_SIZE, // Number of transfers
+    true                // Start immediately
+  );
+
+  _init = 1;
+
+  return 1;
+}
+
+void PDMClass::end()
+{
+  dma_channel_abort(dmaChannel);
+  pinMode(_clkPin, INPUT);
+}
+
+int PDMClass::available()
+{
+  //NVIC_DisableIRQ(DMA_IRQ_0n);
+  //uint32_t interrupts = save_and_disable_interrupts();
+	irq_set_enabled(DMA_IRQ_0, false);
+  size_t avail = _doubleBuffer.available();
+  irq_set_enabled(DMA_IRQ_0, true);
+  //restore_interrupts(interrupts);
+  //NVIC_EnableIRQ(DMA_IRQ_0n);
+  return avail;
+}
+
+int PDMClass::read(void* buffer, size_t size)
+{
+	irq_set_enabled(DMA_IRQ_0, false);
+  int read = _doubleBuffer.read(buffer, size);
+  irq_set_enabled(DMA_IRQ_0, true);
+  return read;
+}
+
+void PDMClass::onReceive(void(*function)(void))
+{
+  _onReceive = function;
+}
+
+void PDMClass::setGain(int gain)
+{
+  _gain = gain;
+  if(_init == 1) {
+    filter.filterGain = _gain;
+    Open_PDM_Filter_Init(&filter);
+  }
+}
+
+void PDMClass::setBufferSize(int bufferSize)
+{
+  _doubleBuffer.setSize(bufferSize);
+}
+
+void PDMClass::IrqHandler(bool halftranfer)
+{
+  static int cutSamples = 100;
+
+  // Clear the interrupt request.
+  dma_hw->ints0 = 1u << dmaChannel; 
+  // Restart dma pointing to the other buffer 
+  int shadowIndex = rawBufferIndex ^ 1;
+  dma_channel_set_write_addr(dmaChannel, rawBuffer[shadowIndex], true);
+
+  if (_doubleBuffer.available()) {
+    // buffer overflow, stop
+    return end();
+  }
+
+  // fill final buffer with PCM samples
+  Open_PDM_Filter_64(rawBuffer[rawBufferIndex], finalBuffer, 1, &filter);
+
+  if (cutSamples) {
+    memset(finalBuffer, 0, cutSamples);
+    cutSamples = 0;
+  }
+
+  // swap final buffer and raw buffers' indexes
+  finalBuffer = (int16_t*)_doubleBuffer.data();
+  _doubleBuffer.swap(filter.nSamples * sizeof(int16_t));
+  rawBufferIndex = shadowIndex;
+
+  if (_onReceive) {
+    _onReceive();
+  }
+}
+#ifdef PIN_PDM_DIN
+PDMClass PDM(PIN_PDM_DIN, PIN_PDM_CLK, -1);
+#endif // PIN_PDM_DIN
+
+
@@ -0,0 +1,41 @@
+
+.program pdm_pio
+.side_set 1
+.wrap_target
+
+  ; prova a cambiare edge
+
+  ;sample on falling edge
+  push iffull noblock  side 1 
+  ;nop  side 1 
+  ;nop  side 0 
+  in pins, 1  side 0 
+  ;nop side 0
+  
+.wrap
+
+% c-sdk {
+#include "hardware/gpio.h"
+
+static inline void pdm_pio_program_init(PIO pio, uint sm, uint offset, uint clkPin, uint dataPin, float clkDiv) {
+  pio_sm_config c = pdm_pio_program_get_default_config(offset);
+  sm_config_set_sideset(&c, 1, false, false);
+  //sm_config_set_in_shift(&c, false, true, 8);
+  sm_config_set_in_shift(&c, false, false, 8);
+
+  sm_config_set_in_pins(&c, dataPin);
+  sm_config_set_sideset_pins(&c, clkPin);
+  sm_config_set_clkdiv(&c, clkDiv);
+
+  pio_sm_set_consecutive_pindirs(pio, sm, dataPin, 1, false);
+  pio_sm_set_consecutive_pindirs(pio, sm, clkPin, 1, true);
+  pio_sm_set_pins_with_mask(pio, sm, 0, (1u << clkPin) );
+  //pio_gpio_init(pio, dataPin);
+  pio_gpio_init(pio, clkPin);
+
+  pio_sm_init(pio, sm, offset, &c);
+  pio_sm_set_enabled(pio, sm, true);
+}
+
+
+%}
@@ -0,0 +1,56 @@
+// -------------------------------------------------- //
+// This file is autogenerated by pioasm; do not edit! //
+// -------------------------------------------------- //
+
+#if !PICO_NO_HARDWARE
+#include "hardware/pio.h"
+#endif
+
+// ------- //
+// pdm_pio //
+// ------- //
+
+#define pdm_pio_wrap_target 0
+#define pdm_pio_wrap 1
+
+static const uint16_t pdm_pio_program_instructions[] = {
+            //     .wrap_target
+    0x9040, //  0: push   iffull noblock  side 1     
+    0x4001, //  1: in     pins, 1         side 0     
+            //     .wrap
+};
+
+#if !PICO_NO_HARDWARE
+static const struct pio_program pdm_pio_program = {
+    .instructions = pdm_pio_program_instructions,
+    .length = 2,
+    .origin = -1,
+};
+
+static inline pio_sm_config pdm_pio_program_get_default_config(uint offset) {
+    pio_sm_config c = pio_get_default_sm_config();
+    sm_config_set_wrap(&c, offset + pdm_pio_wrap_target, offset + pdm_pio_wrap);
+    sm_config_set_sideset(&c, 1, false, false);
+    return c;
+}
+
+#include "hardware/gpio.h"
+static inline void pdm_pio_program_init(PIO pio, uint sm, uint offset, uint clkPin, uint dataPin, float clkDiv) {
+  pio_sm_config c = pdm_pio_program_get_default_config(offset);
+  sm_config_set_sideset(&c, 1, false, false);
+  //sm_config_set_in_shift(&c, false, true, 8);
+  sm_config_set_in_shift(&c, false, false, 8);
+  sm_config_set_in_pins(&c, dataPin);
+  sm_config_set_sideset_pins(&c, clkPin);
+  sm_config_set_clkdiv(&c, clkDiv);
+  pio_sm_set_consecutive_pindirs(pio, sm, dataPin, 1, false);
+  pio_sm_set_consecutive_pindirs(pio, sm, clkPin, 1, true);
+  pio_sm_set_pins_with_mask(pio, sm, 0, (1u << clkPin) );
+  //pio_gpio_init(pio, dataPin);
+  pio_gpio_init(pio, clkPin);
+  pio_sm_init(pio, sm, offset, &c);
+  pio_sm_set_enabled(pio, sm, true);
+}
+
+#endif
+
@@ -0,0 +1,139 @@
+/*
+  Copyright (c) 2016 Arduino LLC.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#include <stdlib.h>
+#include <string.h>
+
+#include "PDMDoubleBuffer.h"
+
+PDMDoubleBuffer::PDMDoubleBuffer() :
+  _size(DEFAULT_PDM_BUFFER_SIZE)
+{
+  reset();
+}
+
+PDMDoubleBuffer::~PDMDoubleBuffer()
+{
+}
+
+void PDMDoubleBuffer::setSize(int size)
+{
+  _size = size;
+  reset();
+}
+
+size_t PDMDoubleBuffer::getSize()
+{
+  return _size;
+}
+
+void PDMDoubleBuffer::reset()
+{
+  _buffer[0] = (uint8_t*)realloc(_buffer[0], _size);
+  _buffer[1] = (uint8_t*)realloc(_buffer[1], _size);
+
+  memset(_buffer[0], 0x00, _size);
+  memset(_buffer[1], 0x00, _size);
+
+  _index = 0;
+  _length[0] = 0;
+  _length[1] = 0;
+  _readOffset[0] = 0;
+  _readOffset[1] = 0;
+}
+
+size_t PDMDoubleBuffer::availableForWrite()
+{
+  return (_size - (_length[_index] - _readOffset[_index]));
+}
+
+size_t PDMDoubleBuffer::write(const void *buffer, size_t size)
+{
+  size_t space = availableForWrite();
+
+  if (size > space) {
+    size = space;
+  }
+
+  if (size == 0) {
+    return 0;
+  }
+
+  memcpy(&_buffer[_index][_length[_index]], buffer, size);
+
+  _length[_index] += size;
+
+  return size;
+}
+
+size_t PDMDoubleBuffer::read(void *buffer, size_t size)
+{
+  size_t avail = available();
+
+  if (size > avail) {
+    size = avail;
+  }
+
+  if (size == 0) {
+    return 0;
+  }
+
+  memcpy(buffer, &_buffer[_index][_readOffset[_index]], size);
+  _readOffset[_index] += size;
+
+  return size;
+}
+
+size_t PDMDoubleBuffer::peek(void *buffer, size_t size)
+{
+  size_t avail = available();
+
+  if (size > avail) {
+    size = avail;
+  }
+
+  if (size == 0) {
+    return 0;
+  }
+
+  memcpy(buffer, &_buffer[_index][_readOffset[_index]], size);
+
+  return size;
+}
+
+void* PDMDoubleBuffer::data()
+{
+  return (void*)_buffer[_index];
+}
+
+size_t PDMDoubleBuffer::available()
+{
+  return _length[_index] - _readOffset[_index];
+}
+
+void PDMDoubleBuffer::swap(int length)
+{
+  if (_index == 0) {
+    _index = 1;
+  } else {
+    _index = 0;
+  }
+
+  _length[_index] = length;
+  _readOffset[_index] = 0;
+}
@@ -0,0 +1,54 @@
+/*
+  Copyright (c) 2016 Arduino LLC.  All right reserved.
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the GNU Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+*/
+
+#ifndef _PDM_DOUBLE_BUFFER_H_INCLUDED
+#define _PDM_DOUBLE_BUFFER_H_INCLUDED
+
+#include <stddef.h>
+#include <stdint.h>
+
+#define DEFAULT_PDM_BUFFER_SIZE 512
+
+class PDMDoubleBuffer
+{
+public:
+  PDMDoubleBuffer();
+  virtual ~PDMDoubleBuffer();
+
+  void setSize(int size);
+  size_t getSize();
+
+  void reset();
+
+  size_t availableForWrite();
+  size_t write(const void *buffer, size_t size);
+  size_t read(void *buffer, size_t size);
+  size_t peek(void *buffer, size_t size);
+  void* data();
+  size_t available();
+  void swap(int length = 0);
+
+private:
+  uint8_t* _buffer[2] __attribute__((aligned (16)));
+  int _size;
+  volatile int _length[2];
+  volatile int _readOffset[2];
+  volatile int _index; 
+};
+
+#endif
@@ -1,4 +1,4 @@
-name=SD(rp2040)
+name=SD
 version=2.0.0
 author=Earle F. Philhower, III <earlephilhower@yahoo.com>
 maintainer=Earle F. Philhower, III <earlephilhower@yahoo.com>
@@ -234,8 +234,8 @@ protected:
    }


-    static uint8_t _getFlags(OpenMode openMode, AccessMode accessMode) {
-        uint8_t mode = 0;
+    static int _getFlags(OpenMode openMode, AccessMode accessMode) {
+        int mode = 0;
        if (openMode & OM_CREATE) {
            mode |= O_CREAT;
        }
@@ -202,56 +202,68 @@ bool SPIClassRP2040::setRX(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({0, 4, 16, 20}) /* SPI0 */,
                                    __bitset({8, 12, 24, 28})  /* SPI1 */
                                  };
-    if (_running) {
-        return false;
-    } else if ((1 << pin) & valid[spi_get_index(_spi)]) {
+    if ((!_running) && ((1 << pin) & valid[spi_get_index(_spi)])) {
        _RX = pin;
        return true;
-    } else {
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set SPI%s.RX while running", spi_get_index(_spi) ? "1" : "");
+    } else {
+        panic("FATAL: Attempting to set SPI%s.RX to illegal pin %d", spi_get_index(_spi) ? "1" : "", pin);
+    }
+    return false;
 }

 bool SPIClassRP2040::setCS(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({1, 5, 17, 21}) /* SPI0 */,
                                    __bitset({9, 13, 25, 29})  /* SPI1 */
                                  };
-    if (_running) {
-        return false;
-    } else if ((1 << pin) & valid[spi_get_index(_spi)]) {
+    if ((!_running) && ((1 << pin) & valid[spi_get_index(_spi)])) {
        _CS = pin;
        return true;
-    } else {
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set SPI%s.CS while running", spi_get_index(_spi) ? "1" : "");
+    } else {
+        panic("FATAL: Attempting to set SPI%s.CS to illegal pin %d", spi_get_index(_spi) ? "1" : "", pin);
+    }
+    return false;
 }

 bool SPIClassRP2040::setSCK(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({2, 6, 18, 22}) /* SPI0 */,
                                    __bitset({10, 14, 26})  /* SPI1 */
                                  };
-    if (_running) {
-        return false;
-    } else if ((1 << pin) & valid[spi_get_index(_spi)]) {
+    if ((!_running) && ((1 << pin) & valid[spi_get_index(_spi)])) {
        _SCK = pin;
        return true;
-    } else {
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set SPI%s.SCK while running", spi_get_index(_spi) ? "1" : "");
+    } else {
+        panic("FATAL: Attempting to set SPI%s.SCK to illegal pin %d", spi_get_index(_spi) ? "1" : "", pin);
+    }
+    return false;
 }

 bool SPIClassRP2040::setTX(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({3, 7, 19, 23}) /* SPI0 */,
                                    __bitset({11, 15, 27})  /* SPI1 */
                                  };
-    if (_running) {
-        return false;
-    } else if ((1 << pin) & valid[spi_get_index(_spi)]) {
+    if ((!_running) && ((1 << pin) & valid[spi_get_index(_spi)])) {
        _TX = pin;
        return true;
-    } else {
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set SPI%s.TX while running", spi_get_index(_spi) ? "1" : "");
+    } else {
+        panic("FATAL: Attempting to set SPI%s.TX to illegal pin %d", spi_get_index(_spi) ? "1" : "", pin);
+    }
+    return false;
 }

 void SPIClassRP2040::begin(bool hwCS) {
@@ -135,6 +135,7 @@ void Servo::writeMicroseconds(int value) {
    value = constrain(value, _minUs, _maxUs);
    _valueUs = value;
    if (_attached) {
+        pio_sm_clear_fifos(_pio, _smIdx); // Remove any old updates that haven't yet taken effect
        pio_sm_put_blocking(_pio, _smIdx, RP2040::usToPIOCycles(value) / 3);
    }
 }
@@ -51,28 +51,34 @@ bool TwoWire::setSDA(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({0, 4, 8, 12, 16, 20, 24, 28}) /* I2C0 */,
                                    __bitset({2, 6, 10, 14, 18, 22, 26})  /* I2C1 */
                                  };
-    if (_running) {
-        return false;
-    } else if ((1 << pin) & valid[i2c_hw_index(_i2c)]) {
+    if ((!_running) && ((1 << pin) & valid[i2c_hw_index(_i2c)])) {
        _sda = pin;
        return true;
-    } else {
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set Wire%s.SDA while running", i2c_hw_index(_i2c) ? "1" : "");
+    } else {
+        panic("FATAL: Attempting to set Wire%s.SDA to illegal pin %d", i2c_hw_index(_i2c) ? "1" : "", pin);
+    }
+    return false;
 }

 bool TwoWire::setSCL(pin_size_t pin) {
    constexpr uint32_t valid[2] = { __bitset({1, 5, 9, 13, 17, 21, 25, 29}) /* I2C0 */,
                                    __bitset({3, 7, 11, 15, 19, 23, 27})  /* I2C1 */
                                  };
-    if (_running) {
-        return false;
-    } else if ((1 << pin) & valid[i2c_hw_index(_i2c)]) {
+    if ((!_running) && ((1 << pin) & valid[i2c_hw_index(_i2c)])) {
        _scl = pin;
        return true;
-    } else {
-        return false;
    }
+
+    if (_running) {
+        panic("FATAL: Attempting to set Wire%s.SCL while running", i2c_hw_index(_i2c) ? "1" : "");
+    } else {
+        panic("FATAL: Attempting to set Wire%s.SCL to illegal pin %d", i2c_hw_index(_i2c) ? "1" : "", pin);
+    }
+    return false;
 }

 void TwoWire::setClock(uint32_t hz) {
@@ -117,7 +123,7 @@ void TwoWire::begin(uint8_t addr) {
    i2c_set_slave_mode(_i2c, true, addr);

    // Our callback IRQ
-    _i2c->hw->intr_mask = (1 << 10) | (1 << 9) | (1 << 5) | (1 << 2);
+    _i2c->hw->intr_mask = (1 << 10) | (1 << 9) | (1 << 6) | (1 << 5) | (1 << 2);

    int irqNo = I2C0_IRQ + i2c_hw_index(_i2c);
    irq_set_exclusive_handler(irqNo, i2c_hw_index(_i2c) == 0 ? _handler0 : _handler1);
@@ -133,6 +139,7 @@ void TwoWire::begin(uint8_t addr) {
 }

 void TwoWire::onIRQ() {
+    Serial.printf("Wire.IRQ=%08x\n", _i2c->hw->intr_stat);
    if (_i2c->hw->intr_stat & (1 << 10)) {
        _buffLen = 0;
        _buffOff = 0;
@@ -148,6 +155,10 @@ void TwoWire::onIRQ() {
        _slaveStartDet = false;
        _i2c->hw->clr_stop_det;
    }
+    if (_i2c->hw->intr_stat & (1 << 6)) {
+        // TX_ABRT
+        _i2c->hw->clr_tx_abrt;
+    }
    if (_i2c->hw->intr_stat & (1 << 5)) {
        // RD_REQ
        if (_onRequestCallback) {
@@ -0,0 +1,14 @@
+/* Simple annoying siren example using tone() */
+/* Released to the public domain by Earle F. Philhower, III */
+
+#define TONEPIN 7
+
+void setup() {
+}
+
+void loop() {
+  for (int i = 100; i < 10000; i += 1) {
+    tone(TONEPIN, i);
+    delayMicroseconds(20);
+  }
+}
@@ -0,0 +1,143 @@
+// The speaker will play the tune to Happy Birthday continuously
+// Author: Tony DiCola
+// License: MIT (https://opensource.org/licenses/MIT)
+
+#include <Arduino.h>
+
+#ifdef USE_TINYUSB
+// For Serial when selecting TinyUSB.  Can't include in the core because Arduino IDE
+// will not link in libraries called from the core.  Instead, add the header to all
+// the standard libraries in the hope it will still catch some user cases where they
+// use these libraries.
+// See https://github.com/earlephilhower/arduino-pico/issues/167#issuecomment-848622174
+#include <Adafruit_TinyUSB.h>
+#endif
+
+// pin_buzzer should be defined by the supported variant e.g CPlay Bluefruit or CLUE.
+// Otherwise please define the pin you would like to use for tone output
+#ifndef PIN_BUZZER
+#define PIN_BUZZER    A0
+#endif
+
+uint8_t const pin_buzzer = PIN_BUZZER;
+
+// A few music note frequencies as defined in this tone example:
+//   https://www.arduino.cc/en/Tutorial/toneMelody
+#define NOTE_C4  262
+#define NOTE_CS4 277
+#define NOTE_D4  294
+#define NOTE_DS4 311
+#define NOTE_E4  330
+#define NOTE_F4  349
+#define NOTE_FS4 370
+#define NOTE_G4  392
+#define NOTE_GS4 415
+#define NOTE_A4  440
+#define NOTE_AS4 466
+#define NOTE_B4  494
+#define NOTE_C5  523
+#define NOTE_CS5 554
+#define NOTE_D5  587
+#define NOTE_DS5 622
+#define NOTE_E5  659
+#define NOTE_F5  698
+#define NOTE_FS5 740
+#define NOTE_G5  784
+#define NOTE_GS5 831
+#define NOTE_A5  880
+#define NOTE_AS5 932
+#define NOTE_B5  988
+
+// Define note durations.  You only need to adjust the whole note
+// time and other notes will be subdivided from it directly.
+#define WHOLE         2200       // Length of time in milliseconds of a whole note (i.e. a full bar).
+#define HALF          WHOLE/2
+#define QUARTER       HALF/2
+#define EIGHTH        QUARTER/2
+#define EIGHTH_TRIPLE QUARTER/3
+#define SIXTEENTH     EIGHTH/2
+
+// Play a note of the specified frequency and for the specified duration.
+// Hold is an optional bool that specifies if this note should be held a
+// little longer, i.e. for eighth notes that are tied together.
+// While waiting for a note to play the waitBreath delay function is used
+// so breath detection and pixel animation continues to run.  No tones
+// will play if the slide switch is in the -/off position or all the
+// candles have been blown out.
+void playNote(int frequency, int duration, bool hold = false, bool measure = true) {
+  (void) measure;
+
+  if (hold) {
+    // For a note that's held play it a little longer than the specified duration
+    // so it blends into the next tone (but there's still a small delay to
+    // hear the next note).
+    tone(pin_buzzer, frequency, duration + duration / 32);
+  } else {
+    // For a note that isn't held just play it for the specified duration.
+    tone(pin_buzzer, frequency, duration);
+  }
+
+  delay(duration + duration / 16);
+}
+
+// Song to play when the candles are blown out.
+void celebrateSong() {
+  // Play a little charge melody, from:
+  //  https://en.wikipedia.org/wiki/Charge_(fanfare)
+  // Note the explicit boolean parameters in particular the measure=false
+  // at the end.  This means the notes will play without any breath measurement
+  // logic.  Without this false value playNote will try to keep waiting for candles
+  // to blow out during the celebration song!
+  playNote(NOTE_G4, EIGHTH_TRIPLE, true, false);
+  playNote(NOTE_C5, EIGHTH_TRIPLE, true, false);
+  playNote(NOTE_E5, EIGHTH_TRIPLE, false, false);
+  playNote(NOTE_G5, EIGHTH, true, false);
+  playNote(NOTE_E5, SIXTEENTH, false);
+  playNote(NOTE_G5, HALF, false);
+}
+
+void setup() {
+  // Initialize serial output and Circuit Playground library.
+  Serial.begin(115200);
+
+  pinMode(pin_buzzer, OUTPUT);
+  digitalWrite(pin_buzzer, LOW);
+}
+
+void loop() {
+  // Play happy birthday tune, from:
+  //  http://www.irish-folk-songs.com/happy-birthday-tin-whistle-sheet-music.html#.WXFJMtPytBw
+  // Inside each playNote call it will play a note and drive the NeoPixel animation
+  // and check for a breath against the sound sensor.  Once all the candles are blown out
+  // the playNote calls will stop playing music.
+  playNote(NOTE_D4, EIGHTH, true);
+  playNote(NOTE_D4, EIGHTH);
+  playNote(NOTE_E4, QUARTER);       // Bar 1
+  playNote(NOTE_D4, QUARTER);
+  playNote(NOTE_G4, QUARTER);
+  playNote(NOTE_FS4, HALF);         // Bar 2
+  playNote(NOTE_D4, EIGHTH, true);
+  playNote(NOTE_D4, EIGHTH);
+  playNote(NOTE_E4, QUARTER);       // Bar 3
+  playNote(NOTE_D4, QUARTER);
+  playNote(NOTE_A4, QUARTER);
+  playNote(NOTE_G4, HALF);          // Bar 4
+  playNote(NOTE_D4, EIGHTH, true);
+  playNote(NOTE_D4, EIGHTH);
+  playNote(NOTE_D5, QUARTER);       // Bar 5
+  playNote(NOTE_B4, QUARTER);
+  playNote(NOTE_G4, QUARTER);
+  playNote(NOTE_FS4, QUARTER);      // Bar 6
+  playNote(NOTE_E4, QUARTER);
+  playNote(NOTE_C5, EIGHTH, true);
+  playNote(NOTE_C5, EIGHTH);
+  playNote(NOTE_B4, QUARTER);       // Bar 7
+  playNote(NOTE_G4, QUARTER);
+  playNote(NOTE_A4, QUARTER);
+  playNote(NOTE_G4, HALF);          // Bar 8
+
+  celebrateSong();
+
+  // One second pause before repeating the loop and playing
+  delay(1000);
+}
@@ -23,6 +23,27 @@
                  {
                     "name": "Adafruit Feather RP2040"
                  },
+                  {
+                     "name": "Adafruit ItsyBitsy RP2040"
+                  },
+                  {
+                     "name": "Adafruit Macropad RP2040"
+                  },
+                  {
+                     "name": "Adafruit QTPy RP2040"
+                  },
+                  {
+                     "name": "Adafruit STEMMA Friend RP2040"
+                  },
+                  {
+                     "name": "Adafruit Trinkey RP2040 QT"
+                  },
+                  {
+                     "name": "Arduino Nano RP2040 Connect"
+                  },
+                  {
+                     "name": "SparkFun ProMicro RP2040"
+                  },
                  {
                     "name": "Generic RP2040 Module"
                  }
@@ -30,22 +51,22 @@
               "toolsDependencies": [
                  {
                     "packager": "rp2040",
-                     "version": "1.1.0-a-81a1771",
+                     "version": "1.2.0-a-407f016",
                     "name": "pqt-gcc"
                  },
                  {
                     "packager": "rp2040",
-                     "version": "1.1.0-a-81a1771",
+                     "version": "1.2.0-a-407f016",
                     "name": "pqt-mklittlefs"
                  },
                  {
                     "packager": "rp2040",
-                     "version": "1.1.0-a-81a1771",
+                     "version": "1.2.0-a-407f016",
                     "name": "pqt-elf2uf2"
                  },
                  {
                     "packager": "rp2040",
-                     "version": "1.1.0-a-81a1771",
+                     "version": "1.2.0-a-407f016",
                     "name": "pqt-pioasm"
                  },
                  {
@@ -55,7 +76,7 @@
                  },
                  {
                     "packager": "rp2040",
-                     "version": "1.1.0-a-81a1771",
+                     "version": "1.2.0-a-407f016",
                     "name": "pqt-openocd"
                  }
               ],
@@ -66,57 +87,57 @@
         ],
         "tools": [
            {
-               "version": "1.1.0-a-81a1771",
+               "version": "1.2.0-a-407f016",
               "name": "pqt-openocd",
               "systems": [
                  {
                     "host": "aarch64-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/aarch64-linux-gnu.openocd-d58c2ef5e.210328.tar.gz",
-                     "archiveFileName": "aarch64-linux-gnu.openocd-d58c2ef5e.210328.tar.gz",
-                     "checksum": "SHA-256:5064727a074c8bc8dff988e82bc2460c5f5610a04ec0a61ba233bdabe0499a24",
-                     "size": "6075189"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/aarch64-linux-gnu.openocd-d58c2ef5e.210607.tar.gz",
+                     "archiveFileName": "aarch64-linux-gnu.openocd-d58c2ef5e.210607.tar.gz",
+                     "checksum": "SHA-256:a85f1df05614ac0bba3742df0aa36b0a87b9bbef0fbadd4d0ccfa1938801ae98",
+                     "size": "6144933"
                  },
                  {
                     "host": "arm-linux-gnueabihf",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/arm-linux-gnueabihf.openocd-d58c2ef5e.210328.tar.gz",
-                     "archiveFileName": "arm-linux-gnueabihf.openocd-d58c2ef5e.210328.tar.gz",
-                     "checksum": "SHA-256:12e61ebe727cb188fab25af174f0696ef86d629701f03f189965a725bd51275b",
-                     "size": "6076094"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/arm-linux-gnueabihf.openocd-d58c2ef5e.210607.tar.gz",
+                     "archiveFileName": "arm-linux-gnueabihf.openocd-d58c2ef5e.210607.tar.gz",
+                     "checksum": "SHA-256:f79ffe70110512ce41c61477910e33fa5ef986fbc142aedfd89f7009f132b237",
+                     "size": "5849262"
                  },
                  {
                     "host": "i686-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-linux-gnu.openocd-d58c2ef5e.210328.tar.gz",
-                     "archiveFileName": "i686-linux-gnu.openocd-d58c2ef5e.210328.tar.gz",
-                     "checksum": "SHA-256:eaa89ac30556aaed5cd09fff4f46435f5a79c58d2060069db7606f9ecc9529ef",
-                     "size": "6076262"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-linux-gnu.openocd-d58c2ef5e.210607.tar.gz",
+                     "archiveFileName": "i686-linux-gnu.openocd-d58c2ef5e.210607.tar.gz",
+                     "checksum": "SHA-256:b4a8af73539ae2e2a653f8fbe029a5b52db80580c942f0399cafb7d3829498c0",
+                     "size": "5651754"
                  },
                  {
                     "host": "i686-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-w64-mingw32.openocd-d58c2ef5e.210328.zip",
-                     "archiveFileName": "i686-w64-mingw32.openocd-d58c2ef5e.210328.zip",
-                     "checksum": "SHA-256:65b8c96b94f1cc3ff13eb853138efb3a465150fb02d07c792f8b235d43b05061",
-                     "size": "6378934"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-w64-mingw32.openocd-d58c2ef5e.210607.zip",
+                     "archiveFileName": "i686-w64-mingw32.openocd-d58c2ef5e.210607.zip",
+                     "checksum": "SHA-256:7156af6e650df6fc4bfc8541f2f1fd05bfe136b3547b4a0aef91668af88f8b6d",
+                     "size": "8330281"
                  },
                  {
                     "host": "x86_64-apple-darwin",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-apple-darwin14.openocd-d58c2ef5e.210328.tar.gz",
-                     "archiveFileName": "x86_64-apple-darwin14.openocd-d58c2ef5e.210328.tar.gz",
-                     "checksum": "SHA-256:b8a759d7ac20643641285b0b05473b853e50739dd254b2294f5d1802ff0e15ca",
-                     "size": "6076324"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-apple-darwin14.openocd-d58c2ef5e.210607.tar.gz",
+                     "archiveFileName": "x86_64-apple-darwin14.openocd-d58c2ef5e.210607.tar.gz",
+                     "checksum": "SHA-256:965e35faf4a93396c4f4a22a504fd6b4f639752922996447d5c1e0e65d7329de",
+                     "size": "1981786"
                  },
                  {
                     "host": "x86_64-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-linux-gnu.openocd-d58c2ef5e.210328.tar.gz",
-                     "archiveFileName": "x86_64-linux-gnu.openocd-d58c2ef5e.210328.tar.gz",
-                     "checksum": "SHA-256:9ff31fc92d6f86503d1750d009fec7e7c8c185c7956b140c4b78ee029d31c19c",
-                     "size": "6076342"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-linux-gnu.openocd-d58c2ef5e.210607.tar.gz",
+                     "archiveFileName": "x86_64-linux-gnu.openocd-d58c2ef5e.210607.tar.gz",
+                     "checksum": "SHA-256:c54390c9464bcf2a32265ecbafaec6d68cdd41471fa14ba4afabe43fe0a11645",
+                     "size": "6076479"
                  },
                  {
                     "host": "x86_64-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-w64-mingw32.openocd-d58c2ef5e.210328.zip",
-                     "archiveFileName": "x86_64-w64-mingw32.openocd-d58c2ef5e.210328.zip",
-                     "checksum": "SHA-256:8f1ddd64b0a6f83f94437d509bb28cdd45ad481bb161c170d57a6736f75087ec",
-                     "size": "6378956"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-w64-mingw32.openocd-d58c2ef5e.210607.zip",
+                     "archiveFileName": "x86_64-w64-mingw32.openocd-d58c2ef5e.210607.zip",
+                     "checksum": "SHA-256:4b481449371b39b4e0e87bd5e5a247f99c025b97ccd186c3b1ca58ff2cb44875",
+                     "size": "8719676"
                  }
               ]
            },
@@ -183,221 +204,221 @@
               ]
            },
            {
-               "version": "1.1.0-a-81a1771",
+               "version": "1.2.0-a-407f016",
               "name": "pqt-gcc",
               "systems": [
                  {
                     "host": "aarch64-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/aarch64-linux-gnu.arm-none-eabi-81a1771.210328.tar.gz",
-                     "archiveFileName": "aarch64-linux-gnu.arm-none-eabi-81a1771.210328.tar.gz",
-                     "checksum": "SHA-256:04eaa4a1c0596b1a47252150323af0a4def791cb9da20634872becbdbdfef979",
-                     "size": "101469960"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/aarch64-linux-gnu.arm-none-eabi-407f016.210607.tar.gz",
+                     "archiveFileName": "aarch64-linux-gnu.arm-none-eabi-407f016.210607.tar.gz",
+                     "checksum": "SHA-256:fc30b07b98fe965db814178b71f368895790f6789d503d71c8af70ff92451d5c",
+                     "size": "103186508"
                  },
                  {
                     "host": "arm-linux-gnueabihf",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/arm-linux-gnueabihf.arm-none-eabi-81a1771.210328.tar.gz",
-                     "archiveFileName": "arm-linux-gnueabihf.arm-none-eabi-81a1771.210328.tar.gz",
-                     "checksum": "SHA-256:43e739a2219ef9e9d16d1c81d4252c22a7392315325046d450542a3df6b35b96",
-                     "size": "94164344"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/arm-linux-gnueabihf.arm-none-eabi-407f016.210607.tar.gz",
+                     "archiveFileName": "arm-linux-gnueabihf.arm-none-eabi-407f016.210607.tar.gz",
+                     "checksum": "SHA-256:4a6ecfaf485ab428e233cc06e853b91dc272146ca0200fbbcdcb87f1930239b8",
+                     "size": "95858053"
                  },
                  {
                     "host": "i686-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-linux-gnu.arm-none-eabi-81a1771.210328.tar.gz",
-                     "archiveFileName": "i686-linux-gnu.arm-none-eabi-81a1771.210328.tar.gz",
-                     "checksum": "SHA-256:b5961edde0d58b7dbc5c7b1c8fbf9d461fe2a7204f5282f6b5336a5d435efd3b",
-                     "size": "104228428"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-linux-gnu.arm-none-eabi-407f016.210607.tar.gz",
+                     "archiveFileName": "i686-linux-gnu.arm-none-eabi-407f016.210607.tar.gz",
+                     "checksum": "SHA-256:8f97c67d20077c551b13344c1a96a9f51dd3a91b178a4731cd9dcc27a19217e6",
+                     "size": "105954517"
                  },
                  {
                     "host": "i686-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-w64-mingw32.arm-none-eabi-81a1771.210328.zip",
-                     "archiveFileName": "i686-w64-mingw32.arm-none-eabi-81a1771.210328.zip",
-                     "checksum": "SHA-256:347fdc73b9f99e529c70598f9bf2ebc85adad098a24206cf89f8297a40e44d60",
-                     "size": "103803990"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-w64-mingw32.arm-none-eabi-407f016.210607.zip",
+                     "archiveFileName": "i686-w64-mingw32.arm-none-eabi-407f016.210607.zip",
+                     "checksum": "SHA-256:c30e8b67d16ae6f29bcca84c166ecc3fced209d73b1b8925d5dd0e79b850f923",
+                     "size": "105487629"
                  },
                  {
                     "host": "x86_64-apple-darwin",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-apple-darwin14.arm-none-eabi-81a1771.210328.tar.gz",
-                     "archiveFileName": "x86_64-apple-darwin14.arm-none-eabi-81a1771.210328.tar.gz",
-                     "checksum": "SHA-256:c035b48e0a42b90c9a356b43813671597a6c0f1cab4fb97a0dfcb2bbc7eb5390",
-                     "size": "105653466"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-apple-darwin14.arm-none-eabi-407f016.210607.tar.gz",
+                     "archiveFileName": "x86_64-apple-darwin14.arm-none-eabi-407f016.210607.tar.gz",
+                     "checksum": "SHA-256:5c617ffcf86518a6451701bd5756e28f9b7587acc0cb2cd503b6c600b8cf417d",
+                     "size": "107365915"
                  },
                  {
                     "host": "x86_64-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-linux-gnu.arm-none-eabi-81a1771.210328.tar.gz",
-                     "archiveFileName": "x86_64-linux-gnu.arm-none-eabi-81a1771.210328.tar.gz",
-                     "checksum": "SHA-256:b13ea47f3c62b65eda3acd40f43a392e8799696d821bc5c114e60950ab125bc0",
-                     "size": "106132177"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-linux-gnu.arm-none-eabi-407f016.210607.tar.gz",
+                     "archiveFileName": "x86_64-linux-gnu.arm-none-eabi-407f016.210607.tar.gz",
+                     "checksum": "SHA-256:0a2b7d03f79f723d62255595f9af862807feee601456bb0e2477ce188a4a975f",
+                     "size": "107847587"
                  },
                  {
                     "host": "x86_64-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-w64-mingw32.arm-none-eabi-81a1771.210328.zip",
-                     "archiveFileName": "x86_64-w64-mingw32.arm-none-eabi-81a1771.210328.zip",
-                     "checksum": "SHA-256:06b19d7f9e9e2c1c3fc87d85af144b02591e3c5643c67521ff9807cdb5f6ecc7",
-                     "size": "108657552"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-w64-mingw32.arm-none-eabi-407f016.210607.zip",
+                     "archiveFileName": "x86_64-w64-mingw32.arm-none-eabi-407f016.210607.zip",
+                     "checksum": "SHA-256:675ee78477afc5f2daf1e25f3c0560a3adbaa7f2d73d99059e549835b4022bf8",
+                     "size": "110334002"
                  }
               ]
            },
            {
-               "version": "1.1.0-a-81a1771",
+               "version": "1.2.0-a-407f016",
               "name": "pqt-elf2uf2",
               "systems": [
                  {
                     "host": "aarch64-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/aarch64-linux-gnu.elf2uf2-0f3b795.210328.tar.gz",
-                     "archiveFileName": "aarch64-linux-gnu.elf2uf2-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:5df8c7c132bc0f469c6610162d3c9836530acf4ace9bf4c3a849c80218f1855d",
-                     "size": "104572"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/aarch64-linux-gnu.elf2uf2-fc10a97.210607.tar.gz",
+                     "archiveFileName": "aarch64-linux-gnu.elf2uf2-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:59f6c2f08f1809987bf40df51808f848146a00c626dff06d3cabafb726db8830",
+                     "size": "79850"
                  },
                  {
                     "host": "arm-linux-gnueabihf",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/arm-linux-gnueabihf.elf2uf2-0f3b795.210328.tar.gz",
-                     "archiveFileName": "arm-linux-gnueabihf.elf2uf2-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:dc311e18fac1e474804c044d194224267a729a16b34940c2e1ff23ab03207d98",
-                     "size": "80513"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/arm-linux-gnueabihf.elf2uf2-fc10a97.210607.tar.gz",
+                     "archiveFileName": "arm-linux-gnueabihf.elf2uf2-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:fb6d4270aaa017b5fa60937f82674e5e55cf12da392fd23cc5d1f6de279bcd04",
+                     "size": "54220"
                  },
                  {
                     "host": "i686-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-linux-gnu.elf2uf2-0f3b795.210328.tar.gz",
-                     "archiveFileName": "i686-linux-gnu.elf2uf2-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:c39f24206e69230166fa15154b76d9553e732815cea59ee00b822b5acf2257db",
-                     "size": "110686"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-linux-gnu.elf2uf2-fc10a97.210607.tar.gz",
+                     "archiveFileName": "i686-linux-gnu.elf2uf2-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:b55b823e59b7fa4d1ea130621c6144d84a96f3cb9571109f878472fecbcda7f8",
+                     "size": "87882"
                  },
                  {
                     "host": "i686-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-w64-mingw32.elf2uf2-0f3b795.210328.zip",
-                     "archiveFileName": "i686-w64-mingw32.elf2uf2-0f3b795.210328.zip",
-                     "checksum": "SHA-256:d239f7b5d7d71e646bb7cd3c59ddef593b3e564968e262b9290353a0d8102d7d",
-                     "size": "247162"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-w64-mingw32.elf2uf2-fc10a97.210607.zip",
+                     "archiveFileName": "i686-w64-mingw32.elf2uf2-fc10a97.210607.zip",
+                     "checksum": "SHA-256:e66f3959fcdc2874dd4074d6e5205715235551062d5283da22906e369dc24bf0",
+                     "size": "70429"
                  },
                  {
                     "host": "x86_64-apple-darwin",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-apple-darwin14.elf2uf2-0f3b795.210328.tar.gz",
-                     "archiveFileName": "x86_64-apple-darwin14.elf2uf2-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:3c776891300a3626ab4704808c61a15b653d58ff4f02398b492c12aed268f6aa",
-                     "size": "106610"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-apple-darwin14.elf2uf2-fc10a97.210607.tar.gz",
+                     "archiveFileName": "x86_64-apple-darwin14.elf2uf2-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:f85403c39741498547448f40fa6ae323519452af7ab0118c4cf7408340c20e07",
+                     "size": "81920"
                  },
                  {
                     "host": "x86_64-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-linux-gnu.elf2uf2-0f3b795.210328.tar.gz",
-                     "archiveFileName": "x86_64-linux-gnu.elf2uf2-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:90c57b7cc68323e84e4cdc7d6da44c0aeb11a1c102c51d03fb42179d6162d3f3",
-                     "size": "101265"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-linux-gnu.elf2uf2-fc10a97.210607.tar.gz",
+                     "archiveFileName": "x86_64-linux-gnu.elf2uf2-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:5e9155cea5639b3716f5149e5a98fa864fe3abd9281f53f1dec65fdbe24d8f28",
+                     "size": "79515"
                  },
                  {
                     "host": "x86_64-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-w64-mingw32.elf2uf2-0f3b795.210328.zip",
-                     "archiveFileName": "x86_64-w64-mingw32.elf2uf2-0f3b795.210328.zip",
-                     "checksum": "SHA-256:a9afa2f04eb5510c8f39ea91d90b63a0dfe0b8037c6bca4d65de8905ca87175f",
-                     "size": "275914"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-w64-mingw32.elf2uf2-fc10a97.210607.zip",
+                     "archiveFileName": "x86_64-w64-mingw32.elf2uf2-fc10a97.210607.zip",
+                     "checksum": "SHA-256:e48b9e8d1c238f29e078056f6fedce715b773b042e52bf63df3759822fa66e64",
+                     "size": "78298"
                  }
               ]
            },
            {
-               "version": "1.1.0-a-81a1771",
+               "version": "1.2.0-a-407f016",
               "name": "pqt-pioasm",
               "systems": [
                  {
                     "host": "aarch64-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/aarch64-linux-gnu.pioasm-0f3b795.210328.tar.gz",
-                     "archiveFileName": "aarch64-linux-gnu.pioasm-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:28cd0813a46d81becb6b743ca6c7a53da0ed15f4da61ccee422f66eeb427912b",
-                     "size": "619033"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/aarch64-linux-gnu.pioasm-fc10a97.210607.tar.gz",
+                     "archiveFileName": "aarch64-linux-gnu.pioasm-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:6076ec3624c40cb59c456b501450621c57097bd83af4ebcbd03e3b46333fa745",
+                     "size": "453301"
                  },
                  {
                     "host": "arm-linux-gnueabihf",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/arm-linux-gnueabihf.pioasm-0f3b795.210328.tar.gz",
-                     "archiveFileName": "arm-linux-gnueabihf.pioasm-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:d1c8f3b208aa00e801dad594c9d0425c9615b1531fb3f86adb95a6188868462c",
-                     "size": "536769"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/arm-linux-gnueabihf.pioasm-fc10a97.210607.tar.gz",
+                     "archiveFileName": "arm-linux-gnueabihf.pioasm-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:a6fe07241fb913e846c74855165e038b327705d75d2ca576dd714b42e17749c4",
+                     "size": "360370"
                  },
                  {
                     "host": "i686-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-linux-gnu.pioasm-0f3b795.210328.tar.gz",
-                     "archiveFileName": "i686-linux-gnu.pioasm-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:d09a70558acabf343ae04c783eac622e9bd1a6cfb74f42ebee03c0cfde5093c7",
-                     "size": "658587"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-linux-gnu.pioasm-fc10a97.210607.tar.gz",
+                     "archiveFileName": "i686-linux-gnu.pioasm-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:47808419d4a6019e527a0aec8c13b5a8bad7d838547fbb97abcddca866f3fc6b",
+                     "size": "511410"
                  },
                  {
                     "host": "i686-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-w64-mingw32.pioasm-0f3b795.210328.zip",
-                     "archiveFileName": "i686-w64-mingw32.pioasm-0f3b795.210328.zip",
-                     "checksum": "SHA-256:c2ab0c8f3d54886838abb0c40910113e2e1e891068b205ec23944eecd0ce8037",
-                     "size": "756780"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-w64-mingw32.pioasm-fc10a97.210607.zip",
+                     "archiveFileName": "i686-w64-mingw32.pioasm-fc10a97.210607.zip",
+                     "checksum": "SHA-256:c815d6845d374133c346e3ae3e40746217be3a6313190a9b4cdc43a4cd2e2bea",
+                     "size": "385662"
                  },
                  {
                     "host": "x86_64-apple-darwin",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-apple-darwin14.pioasm-0f3b795.210328.tar.gz",
-                     "archiveFileName": "x86_64-apple-darwin14.pioasm-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:f48d729582eda8d95c16d2f5fd76ba452a6dd2ae3a47ea9dace01a130e4fb897",
-                     "size": "609240"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-apple-darwin14.pioasm-fc10a97.210607.tar.gz",
+                     "archiveFileName": "x86_64-apple-darwin14.pioasm-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:cd19c8ff52ebed430e039b18fd5bf5bfa33f60727a51ca1c81ad3bbcbb6ec763",
+                     "size": "480403"
                  },
                  {
                     "host": "x86_64-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-linux-gnu.pioasm-0f3b795.210328.tar.gz",
-                     "archiveFileName": "x86_64-linux-gnu.pioasm-0f3b795.210328.tar.gz",
-                     "checksum": "SHA-256:ca089e67effb47dec2a9acdf1490052d096335a8b8ffa46eaa33c205eec87b7b",
-                     "size": "605194"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-linux-gnu.pioasm-fc10a97.210607.tar.gz",
+                     "archiveFileName": "x86_64-linux-gnu.pioasm-fc10a97.210607.tar.gz",
+                     "checksum": "SHA-256:9b8d778a2b3dd5b6bc110dac86e4f9a8321e0bd43f8149bd2722b992b3684515",
+                     "size": "458642"
                  },
                  {
                     "host": "x86_64-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-w64-mingw32.pioasm-0f3b795.210328.zip",
-                     "archiveFileName": "x86_64-w64-mingw32.pioasm-0f3b795.210328.zip",
-                     "checksum": "SHA-256:f02509d1a75b68f14a3c3089029a0f16d185b07af598a4786b3bb6b357b88fa1",
-                     "size": "886179"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-w64-mingw32.pioasm-fc10a97.210607.zip",
+                     "archiveFileName": "x86_64-w64-mingw32.pioasm-fc10a97.210607.zip",
+                     "checksum": "SHA-256:87b5f6cd9c760e5091d1d6e6383028a4255c07d054e6eab0583590dbdc05de69",
+                     "size": "408341"
                  }
               ]
            },
            {
-               "version": "1.1.0-a-81a1771",
+               "version": "1.2.0-a-407f016",
               "name": "pqt-mklittlefs",
               "systems": [
                  {
                     "host": "aarch64-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/aarch64-linux-gnu.mklittlefs-6b5c62d.210328.tar.gz",
-                     "archiveFileName": "aarch64-linux-gnu.mklittlefs-6b5c62d.210328.tar.gz",
-                     "checksum": "SHA-256:e8a77602a78ff51ed1588e0aef23c75f54dc3b8415a489ae700c90306da81701",
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/aarch64-linux-gnu.mklittlefs-6b5c62d.210607.tar.gz",
+                     "archiveFileName": "aarch64-linux-gnu.mklittlefs-6b5c62d.210607.tar.gz",
+                     "checksum": "SHA-256:6475b7cb24ba165fa97e5ae9e66e56901e3609b57b0edb359b75c810b8267d73",
                     "size": "44791"
                  },
                  {
                     "host": "arm-linux-gnueabihf",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/arm-linux-gnueabihf.mklittlefs-6b5c62d.210328.tar.gz",
-                     "archiveFileName": "arm-linux-gnueabihf.mklittlefs-6b5c62d.210328.tar.gz",
-                     "checksum": "SHA-256:6faa9ec2dfc9c6ef58df2e0fd0a990be923ce87a1f36f3e0766af2168b095d50",
-                     "size": "38250"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/arm-linux-gnueabihf.mklittlefs-6b5c62d.210607.tar.gz",
+                     "archiveFileName": "arm-linux-gnueabihf.mklittlefs-6b5c62d.210607.tar.gz",
+                     "checksum": "SHA-256:39bfd76f25b5da89244f708de856a5e9548db37eec7c5a88e4832dc5c3d0ee1f",
+                     "size": "38247"
                  },
                  {
                     "host": "i686-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-linux-gnu.mklittlefs-6b5c62d.210328.tar.gz",
-                     "archiveFileName": "i686-linux-gnu.mklittlefs-6b5c62d.210328.tar.gz",
-                     "checksum": "SHA-256:6aa70b5953e76cc9561b77a8092b14a33c9850c42dd9b306a052fc2d056a89a8",
-                     "size": "48237"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-linux-gnu.mklittlefs-6b5c62d.210607.tar.gz",
+                     "archiveFileName": "i686-linux-gnu.mklittlefs-6b5c62d.210607.tar.gz",
+                     "checksum": "SHA-256:9b6841d1c5070fb1f2b4a5b6c6850395740ac997aa3fbf888f8cd6e7628200e8",
+                     "size": "48240"
                  },
                  {
                     "host": "i686-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/i686-w64-mingw32.mklittlefs-6b5c62d.210328.zip",
-                     "archiveFileName": "i686-w64-mingw32.mklittlefs-6b5c62d.210328.zip",
-                     "checksum": "SHA-256:34e0a84d0f562e6f9bfd91090f9064164062f7c68b4dbd65d7f154987f7940e3",
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/i686-w64-mingw32.mklittlefs-6b5c62d.210607.zip",
+                     "archiveFileName": "i686-w64-mingw32.mklittlefs-6b5c62d.210607.zip",
+                     "checksum": "SHA-256:9b6d7ab130c1f07d63a045e987f69496bfc5e3bb4bf6edc9bf4cd04d363c2ac4",
                     "size": "332804"
                  },
                  {
                     "host": "x86_64-apple-darwin",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-apple-darwin14.mklittlefs-6b5c62d.210328.tar.gz",
-                     "archiveFileName": "x86_64-apple-darwin14.mklittlefs-6b5c62d.210328.tar.gz",
-                     "checksum": "SHA-256:5289f7cde14a5b65a572ddb3b2b0e24f2ea692365787438586f60929750dc395",
-                     "size": "362804"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-apple-darwin14.mklittlefs-6b5c62d.210607.tar.gz",
+                     "archiveFileName": "x86_64-apple-darwin14.mklittlefs-6b5c62d.210607.tar.gz",
+                     "checksum": "SHA-256:538c30d2a072845873d2e3552ac725dcef022f9ac9a873925c218d5564615321",
+                     "size": "362807"
                  },
                  {
                     "host": "x86_64-pc-linux-gnu",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-linux-gnu.mklittlefs-6b5c62d.210328.tar.gz",
-                     "archiveFileName": "x86_64-linux-gnu.mklittlefs-6b5c62d.210328.tar.gz",
-                     "checksum": "SHA-256:07331f6a171010790986bbd6e98cef028dd9f95733226ebab68096e28b3ef8ef",
-                     "size": "46917"
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-linux-gnu.mklittlefs-6b5c62d.210607.tar.gz",
+                     "archiveFileName": "x86_64-linux-gnu.mklittlefs-6b5c62d.210607.tar.gz",
+                     "checksum": "SHA-256:f2b4d849a2146e54fec52abdfc4391894addfbf1e904094424fb5a2a22873e58",
+                     "size": "46918"
                  },
                  {
                     "host": "x86_64-mingw32",
-                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.1.0-a/x86_64-w64-mingw32.mklittlefs-6b5c62d.210328.zip",
-                     "archiveFileName": "x86_64-w64-mingw32.mklittlefs-6b5c62d.210328.zip",
-                     "checksum": "SHA-256:17889e9ab6d199baed2c1532926c8508310524f9ba6b1db0816be5ee5d39a2f6",
+                     "url": "https://github.com/earlephilhower/pico-quick-toolchain/releases/download/1.2.0-a/x86_64-w64-mingw32.mklittlefs-6b5c62d.210607.zip",
+                     "archiveFileName": "x86_64-w64-mingw32.mklittlefs-6b5c62d.210607.zip",
+                     "checksum": "SHA-256:c1105383c2c694978aee521dc1d921fb2e2c3452015c5456f323ffad09595725",
                     "size": "345250"
                  }
               ]
@@ -22,7 +22,6 @@ function skip_ino()
 /msc_sdfat/
 /msc_sd/
 /midi_pizza_box_dj/
-/hid_composite_joy_featherwing/
 EOL
        echo $ino | grep -q -F "$skiplist"
        echo $(( 1 - $? ))
@@ -26,6 +26,7 @@ function skip_ino()
 /p08_DigitalHourglass/
 /p13_TouchSensorLamp/
 /StringComparisonOperators/
+/PDMSerialPlotter/
 EOL
    echo $ino | grep -q -F "$skiplist"
    echo $(( 1 - $? ))
@@ -152,7 +153,7 @@ function install_libraries()
    # install ArduinoJson library
    { test -r ArduinoJson-v6.11.0.zip || curl -sS --output ArduinoJson-v6.11.0.zip -L https://github.com/bblanchon/ArduinoJson/releases/download/v6.11.0/ArduinoJson-v6.11.0.zip; } && unzip -qo ArduinoJson-v6.11.0.zip
    { test -r Adafruit_SPIFlash-3.4.1.zip || curl -sS --output Adafruit_SPIFlash-3.4.1.zip -L https://github.com/adafruit/Adafruit_SPIFlash/archive/refs/tags/3.4.1.zip; } && unzip -qo Adafruit_SPIFlash-3.4.1.zip
-    { test -r Adafruit_Seesaw-1.4.3.zip || curl -sS --output Adafruit_Seesaw-1.4.3.zip -L https://github.com/adafruit/Adafruit_Seesaw/archive/refs/tags/1.4.3.zip; } && unzip -qo Adafruit_Seesaw-1.4.3.zip
+    { test -r Adafruit_Seesaw-1.4.4.zip || curl -sS --output Adafruit_Seesaw-1.4.4.zip -L https://github.com/adafruit/Adafruit_Seesaw/archive/refs/tags/1.4.4.zip; } && unzip -qo Adafruit_Seesaw-1.4.4.zip
    { test -r Adafruit_BusIO-1.7.3.zip || curl -sS --output Adafruit_BusIO-1.7.3.zip -L https://github.com/adafruit/Adafruit_BusIO/archive/refs/tags/1.7.3.zip; } && unzip -qo Adafruit_BusIO-1.7.3.zip
    { test -r Adafruit_CircuitPlayground-1.11.3.zip || curl -sS --output Adafruit_CircuitPlayground-1.11.3.zip -L https://github.com/adafruit/Adafruit_CircuitPlayground/archive/refs/tags/1.11.3.zip; } && unzip -qo Adafruit_CircuitPlayground-1.11.3.zip
    { test -r Adafruit_NeoPixel-1.8.1.zip || curl -sS --output Adafruit_NeoPixel-1.8.1.zip -L https://github.com/adafruit/Adafruit_NeoPixel/archive/refs/tags/1.8.1.zip; } && unzip -qo Adafruit_NeoPixel-1.8.1.zip
@@ -125,5 +125,8 @@ MakeBoard("adafruit_itsybitsy", "Adafruit", "ItsyBitsy RP2040", "0x239a", "0x80f
 MakeBoard("adafruit_qtpy", "Adafruit", "QT Py RP2040", "0x239a", "0x80f7", "ADAFRUIT_QTPY_RP2040", 8, "boot2_generic_03h_4_padded_checksum")
 MakeBoard("adafruit_stemmafriend", "Adafruit", "STEMMA Friend RP2040", "0x239a", "0x80e3", "ADAFRUIT_STEMMAFRIEND_RP2040", 8, "boot2_w25q080_2_padded_checksum")
 MakeBoard("adafruit_trinkeyrp2040qt", "Adafruit", "Trinkey RP2040 QT", "0x239a", "0x8109", "ADAFRUIT_TRINKEYQT_RP2040", 8, "boot2_w25q080_2_padded_checksum")
+MakeBoard("adafruit_macropad2040", "Adafruit", "MacroPad RP2040", "0x239a", "0x8107", "ADAFRUIT_MACROPAD_RP2040", 8, "boot2_w25q080_2_padded_checksum")
+MakeBoard("arduino_nano_connect", "Arduino", "Nano RP2040 Connect", "0x2341", "0x0058", "ARDUINO_NANO_RP2040_CONNECT", 16, "boot2_w25q080_2_padded_checksum")
+MakeBoard("sparkfun_promicrorp2040", "SparkFun", "ProMicro RP2040", "0x1b4f", "0x0026", "SPARKFUN_PROMICRO_RP2040", 16, "boot2_generic_03h_4_padded_checksum")
 MakeBoard("generic", "Generic", "RP2040", "0x2e8a", "0xf00a", "GENERIC_RP2040", 16, "boot2_generic_03h_4_padded_checksum")

@@ -0,0 +1,52 @@
+#pragma once
+
+
+// LEDs
+#define PIN_LED        (13u)
+
+// Extra hardware!
+#define PIN_SWITCH            0
+#define PIN_SPEAKER_ENABLE   14
+#define PIN_SPEAKER          16
+#define PIN_ROTB             17
+#define PIN_ROTA             18
+#define OLED_CS              22
+#define OLED_RST             23
+#define OLED_DC              24
+
+#define PIN_NEOPIXEL         19
+#define NUM_NEOPIXEL         12
+
+// Not pinned out
+#define PIN_SERIAL1_TX (31u)
+#define PIN_SERIAL1_RX (31u)
+
+// Not pinned out
+#define PIN_SERIAL2_TX (31u)
+#define PIN_SERIAL2_RX (31u)
+
+// SPI
+#define PIN_SPI1_MISO  (28u)
+#define PIN_SPI1_MOSI  (27u)
+#define PIN_SPI1_SCK   (26u)
+#define PIN_SPI1_SS    (31u) // not pinned out
+
+// Not pinned out
+#define PIN_SPI0_MISO  (31u)
+#define PIN_SPI0_MOSI  (31u)
+#define PIN_SPI0_SCK   (31u)
+#define PIN_SPI0_SS    (31u)
+
+// Wire
+#define PIN_WIRE0_SDA  (20u)
+#define PIN_WIRE0_SCL  (21u)
+
+// Not pinned out
+#define PIN_WIRE1_SDA  (31u)
+#define PIN_WIRE1_SCL  (31u)
+
+#define SERIAL_HOWMANY (1u)
+#define SPI_HOWMANY    (1u)
+#define WIRE_HOWMANY   (1u)
+
+#include "../generic/common.h"
@@ -0,0 +1,53 @@
+/* Taken from https://github.com/arduino/ArduinoCore-mbed/tree/master/variants/NANO_RP2040_CONNECT */
+
+AnalogPinDescription g_AAnalogPinDescription[] = {
+  { p26,        NULL },    // A0
+  { p27,        NULL },    // A1
+  { p28,        NULL },    // A2
+  { p29,        NULL },    // A3
+};
+
+PinDescription g_APinDescription[] = {
+  // D0 - D7
+  { p1,         NULL, NULL, NULL },    // D0
+  { p0,         NULL, NULL, NULL },    // D1
+  { p25,        NULL, NULL, NULL },    // D2
+  { p15,        NULL, NULL, NULL },    // D3
+  { p16,        NULL, NULL, NULL },    // D4
+  { p17,        NULL, NULL, NULL },    // D5
+  { p18,        NULL, NULL, NULL },    // D6
+  { p19,        NULL, NULL, NULL },    // D7
+
+  // D8 - D13
+  { p20,        NULL, NULL, NULL },    // D8
+  { p21,        NULL, NULL, NULL },    // D9
+  { p5,         NULL, NULL, NULL },    // D10
+  { p7,         NULL, NULL, NULL },    // D11 / SPITX
+  { p4,         NULL, NULL, NULL },    // D12 / SPIRX
+  { p6,         NULL, NULL, NULL },    // D13 / SPICLK / LEDB 
+
+  // Analog as digital
+  // A4 to A7 are controlled by Nina module and exposed via different APIs
+  { p26,        NULL, NULL, NULL },    // A0 -> D14
+  { p27,        NULL, NULL, NULL },    // A1 -> D15
+  { p28,        NULL, NULL, NULL },    // A2 -> D16
+  { p29,        NULL, NULL, NULL },    // A3 -> D17
+
+  // I2C
+  { p12,        NULL, NULL, NULL },    // A4 / SDA  -> D18
+  { p13,        NULL, NULL, NULL },    // A5 / SCL  -> D19
+
+  // Internal pins - D20 - D23
+  { p2,         NULL, NULL, NULL },    // GPIO0
+  { p24,        NULL, NULL, NULL },    // IMU IRQ
+  { p22,        NULL, NULL, NULL },    // PDM DATA IN
+  { p23,        NULL, NULL, NULL },    // PDM CLOCK
+
+  // Internal pins Nina - D24 - D29
+  { p3,         NULL, NULL, NULL },    // RESET_NINA
+  { p8,         NULL, NULL, NULL },    // SPI1_CIPO / UART1_TX
+  { p9,         NULL, NULL, NULL },    // SPI1_CS / UART1_RX
+  { p10,        NULL, NULL, NULL },    // SPI1_ACK / UART1_CTS
+  { p11,        NULL, NULL, NULL },    // SPI1_COPI / UART1_RTS
+  { p14,        NULL, NULL, NULL },    // SPI1_SCK
+};
@@ -0,0 +1,48 @@
+/* Taken from https://github.com/arduino/ArduinoCore-mbed/tree/master/variants/NANO_RP2040_CONNECT */
+
+#ifndef _NINA_PINS_
+#define _NINA_PINS_
+
+/******************************************************************************
+ * INCLUDE
+ ******************************************************************************/
+
+#include "Arduino.h"
+//#include "WiFiNINA.h"
+/******************************************************************************
+ * PREPROCESSOR-MAGIC
+ ******************************************************************************/
+
+#if __has_include("WiFiNINA.h")
+#  define NINA_ATTRIBUTE
+#else
+#  define NINA_ATTRIBUTE __attribute__ ((error("Please include WiFiNINA.h to use this pin")))
+#endif
+
+/******************************************************************************
+ * TYPEDEF
+ ******************************************************************************/
+
+enum NinaPin {
+  LEDR = 27,
+  LEDG = 25,
+  LEDB = 26//,
+  //A4   = 34,
+  //A5   = 39,
+  //A6   = 36,
+  //A7   = 35
+};
+
+/******************************************************************************
+ * FUNCTION DECLARATION
+ ******************************************************************************/
+
+void      NINA_ATTRIBUTE pinMode     (NinaPin pin, PinMode mode);
+PinStatus NINA_ATTRIBUTE digitalRead (NinaPin pin);
+void      NINA_ATTRIBUTE digitalWrite(NinaPin pin, PinStatus value);
+int       NINA_ATTRIBUTE analogRead  (NinaPin pin);
+void      NINA_ATTRIBUTE analogWrite (NinaPin pin, int value);
+
+#undef NINA_ATTRIBUTE
+
+#endif /* _NINA_PINS_ */
@@ -0,0 +1,120 @@
+/* Taken from https://github.com/arduino/ArduinoCore-mbed/tree/master/variants/NANO_RP2040_CONNECT */
+
+#pragma once
+
+// Pin definitions taken from:
+//    https://datasheets.raspberrypi.org/pico/pico-datasheet.pdf
+static const uint8_t D0 = (1u);
+static const uint8_t D1 = (0u);
+static const uint8_t D2 = (25u);
+static const uint8_t D3 = (15u);
+static const uint8_t D4 = (16u);
+static const uint8_t D5 = (17u);
+static const uint8_t D6 = (18u);
+static const uint8_t D7 = (19u);
+static const uint8_t D8 = (20u);
+static const uint8_t D9 = (21u);
+static const uint8_t D10 = (5u);
+static const uint8_t D11 = (7u);
+static const uint8_t D12 = (4u);
+static const uint8_t D13 = (6u);
+static const uint8_t D14 = (26u);
+static const uint8_t D15 = (27u);
+static const uint8_t D16 = (28u);
+static const uint8_t D17 = (29u); 
+static const uint8_t D18 = (12u); 
+static const uint8_t D19 = (13u); 
+static const uint8_t D20 = (2u);
+static const uint8_t D21 = (24u);
+static const uint8_t D22 = (22u);
+static const uint8_t D23 = (23u);
+static const uint8_t D24 = (3u);
+static const uint8_t D25 = (8u);
+static const uint8_t D26 = (9u);
+static const uint8_t D27 = (10u);
+static const uint8_t D28 = (11u);
+static const uint8_t D29 = (14u);
+
+static const uint8_t A0 = (26u);
+static const uint8_t A1 = (27u);
+static const uint8_t A2 = (28u);
+static const uint8_t A3 = (29u);
+static const uint8_t A4 = (12u);
+static const uint8_t A5 = (13u);
+
+// LEDs
+#define PIN_LED        (D13)
+
+// Serial
+#define PIN_SERIAL1_TX (D1)
+#define PIN_SERIAL1_RX (D0)
+
+#define PIN_SERIAL2_TX (D25)
+#define PIN_SERIAL2_RX (D26)
+
+// SPI
+#define PIN_SPI0_MISO  (D12)
+#define PIN_SPI0_MOSI  (D11)
+#define PIN_SPI0_SCK   (D13)
+#define PIN_SPI0_SS    (13u)//(D10)
+
+#define PIN_SPI1_MISO  (D25)
+#define PIN_SPI1_MOSI  (D28)
+#define PIN_SPI1_SCK   (D29)
+#define PIN_SPI1_SS    (13u)
+
+// Wire
+#define PIN_WIRE0_SDA  (D18)
+#define PIN_WIRE0_SCL  (D19)
+
+#define PIN_WIRE1_SDA  (26u) //Non c'è
+#define PIN_WIRE1_SCL  (27u) //Non c'è
+
+#define SERIAL_HOWMANY (3u)
+#define SPI_HOWMANY    (2u)
+#define WIRE_HOWMANY   (1u)
+
+#define PINS_COUNT          (30u)
+#define NUM_DIGITAL_PINS    (30u)
+#define NUM_ANALOG_INPUTS   (4u)
+#define NUM_ANALOG_OUTPUTS  (0u)
+#define ADC_RESOLUTION      (12u)
+
+#define LED_BUILTIN PIN_LED
+#define DigitalPinToPinName(p) (p)
+
+static const uint8_t SS = PIN_SPI0_SS;
+static const uint8_t MOSI = PIN_SPI0_MOSI;
+static const uint8_t MISO = PIN_SPI0_MISO;
+static const uint8_t SCK = PIN_SPI0_SCK;
+
+//Nina support
+
+#define NINA_RESETN		(D24)
+#define SerialNina		Serial3
+#define SerialHCI		Serial2
+
+//#define NINA_GPIOIRQ	(21u) // LEDG pin (GPIO26 on NINA)
+#define NINA_GPIO0		(20u) // real GPIO0 on NINA
+
+#define SPIWIFI_SS		(D26)
+#define SPIWIFI_ACK		(D27)
+#define SPIWIFI_RESET	(NINA_RESETN)
+#define SPIWIFI 		(SPI1)
+
+// PDM Interfaces
+// ---------------
+#define PIN_PDM_CLK	 (D23)
+#define PIN_PDM_DIN	 (D22)
+
+//Cose copiate a caso
+
+#define SERIAL_PORT_USBVIRTUAL      SerialUSB
+#define SERIAL_PORT_MONITOR         SerialUSB
+#define SERIAL_PORT_HARDWARE        Serial1
+#define SERIAL_PORT_HARDWARE_OPEN   Serial2
+
+#define CRYPTO_WIRE		Wire
+
+#define USB_MAX_POWER	(500)
+#include "nina_pins.h"
@@ -0,0 +1,37 @@
+#pragma once
+
+// Taken from schematic at https://cdn.sparkfun.com/assets/e/2/7/6/b/ProMicroRP2040_Graphical_Datasheet.pdf
+
+// LEDs
+#define PIN_LED        (25u)
+
+#define PIN_NEOPIXEL   (25)
+#define NUM_NEOPIXEL   (1)
+
+// UARTs
+#define PIN_SERIAL1_TX (0u)
+#define PIN_SERIAL1_RX (1u)
+#define PIN_SERIAL2_TX (8u)
+#define PIN_SERIAL2_RX (9u)
+
+// SPI
+#define PIN_SPI0_MISO  (20u)
+#define PIN_SPI0_MOSI  (23u)
+#define PIN_SPI0_SCK   (22u)
+#define PIN_SPI0_SS    (21u)
+#define PIN_SPI1_MISO  (31u)
+#define PIN_SPI1_MOSI  (31u)
+#define PIN_SPI1_SCK   (31u)
+#define PIN_SPI1_SS    (31u) // not pinned out
+
+// Wire
+#define PIN_WIRE0_SDA  (16u)
+#define PIN_WIRE0_SCL  (17u)
+#define PIN_WIRE1_SDA  (31u)
+#define PIN_WIRE1_SCL  (31u)
+
+#define SERIAL_HOWMANY (3u)
+#define SPI_HOWMANY    (1u)
+#define WIRE_HOWMANY   (1u)
+
+#include "../generic/common.h"
Author	SHA1	Message	Date
Earle F. Philhower, III	aac8146f00	Clear I2C status on short slave reads Fixes #222 The HW needs to have the TXC_ABRT flag cleared when a slave transmission is cut short by the master, or else it will effectively break the I2C bus and never recover.	2021-06-25 18:39:44 -07:00
Earle F. Philhower, III	35c974d4c0	Fix file creation on SD and SDFS (#216 ) The O_CREAT/etc. flags on the Pico are a full 32-bits in size, but the core was generating a flag for SdFat using an 8-bit type, so all the O_CREAT, O_TRUNC, O_APPEND, etc. flags got cut off. Fix the flag size. Fixes #214	2021-06-19 12:15:11 -07:00
Earle F. Philhower, III	27476815ab	Fix SerialUART flush (#215 ) Serial1.flush/Serial2.flush was not waiting for the proper FIFO to clear. Use the proper call from the Pico SDK. Thanks to Peter Remias for noting it.	2021-06-16 08:25:24 -07:00
Earle F. Philhower, III	b02b9c4be8	Add PDM library for Arduino Nano RP2040 Connect (#213 ) * Add PDM library for Arduino Nano RP2040 Connect * No PDM test in CI, only works on Arduino Nano RP2040	2021-06-16 08:17:09 -07:00
Earle F. Philhower, III	6afcf5881d	Initial Arduino Nano RP2040 Connect support (#212 ) Thanks to @Claupio for the bringup! Reference #208	2021-06-14 08:59:52 -07:00
Earle F. Philhower, III	30704a7c5e	Obey timeout value on SerialUART.read/.peek (#211 ) Fixes a hang when reading from the Serial UART ports because before the core would pause indefinitely for the next character. Now, wait up to Serial.setTimeout() milliseconds and if it times out return -1 to the app. Fixes #210	2021-06-13 14:11:23 -07:00
Earle F. Philhower, III	08b6748d79	Update to PICO-SDK version 1.2.0 (#207 ) Minor rev to the tinyUSB version used, new ID function.	2021-06-11 12:48:09 -07:00
Earle F. Philhower, III	bedfbda372	Clear PIO FIFOs when updating Tone and Servos (#206 ) The PIO programs that generate tone() and Servo() use the TX FIFO to receive updates to the period/duty cycle. The original code would push into the FIFO (potentially blocking the app if the FIFO was full) and generate at least one cycle of every value written into the control. Basically, the output would lag the changes by 1 cycle or more (which could be 20ms+ on Servo). Fix this by clearing any old, ungrabbed values from the FIFO before sending a new one to the program. Instead of a FIFO, there is effectively now just a control register and updates will be immediate. Update the Siren.ino example with delays because now the tone() calls will not block and run 10x+ faster.	2021-06-11 12:27:48 -07:00
Earle F. Philhower, III	9fbf6ab35d	Clean up Arduino.h header, remove duplicates (#205 ) Many functions are defined inside the api/Common.h, so remove them from the Arduino.h header to have them appear only once. Fix up the abs() macro to avoid macro problems, add round()	2021-06-11 12:23:23 -07:00
Earle F. Philhower, III	793496da98	Set GPIO digital output on digitalWrite (#203 ) Fixes #202	2021-06-10 07:58:09 -07:00
Earle F. Philhower, III	81cbf8357d	Update README.md	2021-06-08 08:39:58 -07:00
Earle F. Philhower, III	55a260e4e8	Update README.md	2021-06-08 08:35:32 -07:00
Earle F. Philhower, III	5c71564844	Add PIOASM online tool link, thanks @jake653! (#197 )	2021-06-08 08:34:53 -07:00
Earle F. Philhower, III	bf4f0454e1	Update README.md	2021-06-08 08:02:07 -07:00
Earle F. Philhower, III	33b9e915d9	Add new boards to package.json	2021-06-08 07:02:25 -07:00
Earle F. Philhower, III	77712f5904	Add SparkFun ProMicro RP2040 (#196 ) It's still OOS, so hookup taken from their schematics.	2021-06-08 06:55:13 -07:00
Earle F. Philhower, III	c02388dfbe	Update README.md	2021-06-07 15:12:03 -07:00
Earle F. Philhower, III	56dae62b8e	Add back Featherwing CI test (#195 )	2021-06-07 13:54:25 -07:00
Earle F. Philhower, III	53b52a975a	Update README.md	2021-06-07 07:10:41 -07:00
Earle F. Philhower, III	f87ccacdb1	Upgrade to GCC 10.3. Fix OpenOCD packaging (#194 ) GCC 10.2 has a bug which causes Windows to rebuild every library on every compile, instead of caching the first results. Upgrade to GCC 10.3 which has this fixed. Add proper OpenOCD executables for non-Linux x86_64 archs.	2021-06-06 22:43:26 -07:00
Limor "Ladyada" Friedandhathach	d2a2fcb89d	Add a new board - the Adafruit Macropad w/RP2040 (#191 ) * add two variant files * add trinkey and stemma friend * add fast SPI transfer using pico-sdk blocks * update makeboards.py for new variants - STEMMA Friend RP2040 - Trinkey RP2040 QT * run astyle on SPI library * fix auto -> ssize type * astyled * woops ssizet != sizet! * a nice day for a new board definition! this is a macropad with 12 keys, oled and rotary encoder Co-authored-by: hathach <thach@tinyusb.org>	2021-06-06 12:53:06 -07:00
Earle F. Philhower, III	c65c4bfb4e	Allow continuous tone frequency changes (#186 ) Fixes #121 Supersedes #185 Redo the PIO program to allow the tone generator on a pin to be updated without interruption, at waveform boundaries. This allows for things like sirens or slurs to be implemented simply. Use an alarm, not the PIO hardware, to manage time-limited tones(). Add a simple siren example.	2021-06-04 02:45:13 -07:00
Ha Thach	6431b8157b	Add tone music example (#185 )	2021-06-04 02:39:04 -07:00
per1234	7d1e83b416	Use optimal bundled library names (#183 ) When multiple libraries contain files matching an #include directive in the program, the Arduino build system must pick one to use for compilation. Multiple factors are used in order to make an intelligent determination of which library is best. In order to enhance this determination, the closeness of match between the library.properties name value and the filename in the #include directive is being added as one of those factors. This new factor is referred to as "Library Name Priority". Unfortunately, this change can result in platform bundled libraries which had previously been correctly correctly chosen no longer being given priority over their equivalent standalone libraries, which may be incompatible or not optimized for the platform's boards. This priority inversion only occurs when all the following conditions are true: - There is a standalone library installed which provides a header filename collision. - The platform bundled library is architecture optimized (e.g., architectures=esp32). - The standalone library is architecture compatible (architectures=*). - The standalone library has equal "Folder Name Priority". - The standalone library has better "Library Name Priority" (e.g., name=SD vs name=SD(ESP32) for a library with primary header file SD.h. The fix is to simply give the platform bundled library a perfect "Library Name Priority". Some platform bundled libraries were given a modified name as a workaround to a bug in the Arduino IDE's Library Manager which caused Library Manager to always show the library as updatable under specific circumstances. That bug was fixed in Arduino IDE 1.8.6, ~3 years ago.	2021-05-31 07:32:20 -07:00
Earle F. Philhower, III	fd685aac82	PANIC on attempting an invalid setXXX pin (#182 ) Fixes #169 Trying to change pinout while running, or to an illegal configuration, will now immediately panic() with an error message. Such an attempt is a pretty big problem since pinouts are hardware related/static. Prior code would fail silently and return false, but nobody checked the setXXX return values, anyway.	2021-05-29 10:50:13 -07:00
Earle F. Philhower, III	79539d7d8d	Re-add pico-sdk/extra submodules to release ZIP (#181 )	2021-05-28 19:55:09 -07:00