|
|
| Line 16: |
Line 16: |
| | | | |
| | [[file:XIAO_SAM_vs_XIAO_RP2040.PNG]] | | [[file:XIAO_SAM_vs_XIAO_RP2040.PNG]] |
| − |
| |
| − | == Pins (SAMD version) ==
| |
| − |
| |
| − | [[file:adafruit_products_Adafruit_QT_Py_SAMD21_pinout.png|link=https://cdn-learn.adafruit.com/assets/assets/000/110/643/original/adafruit_products_Adafruit_QT_Py_SAMD21_pinout.png?1649443234]]
| |
| − | (Click on image for larger file)
| |
| − |
| |
| − | === 3V ===
| |
| − |
| |
| − | * Regulated output from the onboard regulator. You can draw 500mA
| |
| − |
| |
| − | === 5V ===
| |
| − |
| |
| − | * 5v out from the USB port.
| |
| − | * Voltage input
| |
| − | ** Requires external diode
| |
| − | *** Schottky, signal, power
| |
| − | *** Between external power source and this pin
| |
| − | *** Cannot power the USB port by supplying 5V to this pin
| |
| − | **** There is a protection diode that prevents the 5V from reaching the USB connector.
| |
| − | **** This is to protect host computer USB ports, etc.
| |
| − |
| |
| − | === A0 / D0 - Digital/analog GPIO pin 0 ===
| |
| − |
| |
| − | * Digital I/O 0
| |
| − | * Analog In 0
| |
| − | * True analog output with 10 bit precision
| |
| − | * Does not have PWM
| |
| − | * Capacitive touch input.
| |
| − |
| |
| − | === A1 / D1 - Digital/analog GPIO pin 1 ===
| |
| − |
| |
| − | * Digital I/O 1
| |
| − | * Analog In 1
| |
| − | * Capacitive touch input
| |
| − | * AREF pin.
| |
| − |
| |
| − | === A2 / D2 - Digital/analog GPIO pin 2 ===
| |
| − |
| |
| − | * Digital I/O 2
| |
| − | * Analog In 2
| |
| − | * PWM
| |
| − | * Capacitive touch input.
| |
| − |
| |
| − | === A3 / D3 - Digital/analog GPIO pin 3 ===
| |
| − |
| |
| − | * Digital I/O 3
| |
| − | * Analog In 3
| |
| − | * PWM output
| |
| − | * Capacitive touch input.
| |
| − |
| |
| − | === SDA / D4 ===
| |
| − |
| |
| − | * Digital I/O 4
| |
| − | * I2C SDA pin
| |
| − | * PWM output
| |
| − | * No analog on this pin
| |
| − | * No pull up on this pin
| |
| − | * When using with I2C requires an external 2.2K-10K pullup to 3.3V.
| |
| − |
| |
| − | === SCL / D5 ===
| |
| − |
| |
| − | * Digital I/O 5
| |
| − | * I2C SCL
| |
| − | * No analog on this pin
| |
| − | * No pull up on this pin
| |
| − | * When using with I2C requires an external 2.2K-10K pullup to 3.3V.
| |
| − |
| |
| − | === TX / A6 / D6 ===
| |
| − |
| |
| − | * Digital I/O 6
| |
| − | * Transmit (output) for Serial1
| |
| − | * Analog 6
| |
| − | * PWM output
| |
| − | * Capacitive touch input
| |
| − |
| |
| − | === RX / A7 / D7 ===
| |
| − |
| |
| − | * Digital I/O 7
| |
| − | * Receive (input) for Serial1
| |
| − | * Analog 7
| |
| − | * PWM output
| |
| − | * Capacitive touch input
| |
| − |
| |
| − | === SCK / A8 / D8 ===
| |
| − |
| |
| − | * Digital I/O 8
| |
| − | * SPI SCK pin
| |
| − | * Analog 8
| |
| − | * PWM output
| |
| − |
| |
| − | === MISO / A9 / D9 ===
| |
| − |
| |
| − | * Digital I/O 8
| |
| − | * SPI MISO pin
| |
| − | * Analog 8
| |
| − | * PWM output
| |
| − |
| |
| − | === MOSI / A10 / D10 ===
| |
| − |
| |
| − | * Digital I/O 10
| |
| − | * SPI MOSI pin
| |
| − | * Analog 10
| |
| − | * PWM output
| |
| − |
| |
| − | === NeoPixel ===
| |
| − |
| |
| − | * Connected to digital pin 11 for signal
| |
| − | * Set pin 12 low for low power usage
| |
| − | * By default pin 12 is set high by Arduino/CircuitPython
| |
| − | * Code example
| |
| − |
| |
| − | <pre>
| |
| − | import board
| |
| − | import neopixel
| |
| − |
| |
| − | pixels = neopixel.NeoPixel(board.NEOPIXEL, 1)
| |
| − | # fill((rVal, gVal, bVal))
| |
| − | # rVal, gVal, bVal = red/green/blue values (0-255)
| |
| − | pixels.fill((255, 0, 0)) # Note double parens
| |
| − | </pre>
| |
| − |
| |
| − | == Programming ==
| |
| − |
| |
| − | * C/C++ or CircuitPython
| |
| − |
| |
| − | === C/C++ ===
| |
| − |
| |
| − | * [https://learn.adafruit.com/adafruit-qt-py/arduino-ide-setup Arduino IDE Setup for SAMD version]
| |
| − | ** Requires Arduino IDE version 1.8 or higher
| |
| − | ** Add https://adafruit.github.io/arduino-board-index/package_adafruit_index.json to Preferences Additional Boards Manager URLs
| |
| − | ** [https://learn.adafruit.com/adafruit-qt-py/using-with-arduino-ide Add Adafruit SAMD Boards in Boards Manager]
| |
| − | * [https://github.com/raspberrypi/pico-sdk RP2040 C/C++ SDK]
| |
| − |
| |
| − | === CircuitPython/MicroPython ===
| |
| − |
| |
| − | * [https://github.com/micropython/micropython/tree/master/ports/rp2 RP2040 MicroPython Repo]
| |
| − | * [https://learn.adafruit.com/adafruit-qt-py-2040 Adafruit QT Py RP2040 Overview]
| |
| − |
| |
| − | ==== Install CircuitPython on QT Py RP2040 ====
| |
| − |
| |
| − | * Hold down the BOOT (right) button while plugging it into USB
| |
| − | * Download [ UF2 from [https://circuitpython.org/board/adafruit_qtpy_rp2040/ Adafruit QT Py CircuitPython RP2040]
| |
| − | * Drive will open
| |
| − | * Drop UF2 onto drive
| |
| − |
| |
| − | <pre>
| |
| − | >>> import gc
| |
| − | >>> gc.mem_free()
| |
| − | 208128
| |
| − | >>> import time
| |
| − | >>> gc.mem_free()
| |
| − | 207952
| |
| − | </pre>
| |
| − |
| |
| − | === CircuitPython ===
| |
| − |
| |
| − | ==== CircuitPython for SAMD ====
| |
| − |
| |
| − | * Adafruit CircuitPython 7.3.0 on 2021-01-21
| |
| − | ** [https://circuitpython.readthedocs.io/en/latest/README.html CircuitPython] is a derivative of MicroPython
| |
| − | ** CircuitPython looks for a code file on the board to run
| |
| − | *** There are four options: code.txt, code.py, main.txt and main.py
| |
| − | *** CircuitPython looks for those files, in that order, and then runs the first one it finds
| |
| − | ** [https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/master/Welcome_to_CircuitPython/QT_Py_blink.py QT_Py_blink.py]
| |
| − | ** [https://circuitpython.org/board/qtpy_m0_haxpress/ QT Py Haxpress] used with 2MB Flash EEPROM
| |
| − | * [https://codewith.mu/ Mu code editor]
| |
| − | * Free memory
| |
| − | ** Reports 17,776 bytes of free space
| |
| − | <pre>
| |
| − | import gc
| |
| − | gc.mem_free()
| |
| − | </pre>
| |
| − |
| |
| − | ===== Updating CircuitPython =====
| |
| − |
| |
| − | * Save the contents of CIRCUITPY, just in case
| |
| − | * '''Double-click the reset button''' to show the BOOT drive
| |
| − | * Drag the update-bootloader .uf2 file to the BOOT drive
| |
| − | * Wait a few tens of seconds for the bootloader to update; the BOOT drive will reappear
| |
| − | * Check INFO_UF2.TXT to verify that the bootloader version has been updated. Then you will need to reload CircuitPython.
| |
| − | * [http://adafru.it/mpy-update Update mpy files]
| |
| − |
| |
| − | ==== Land Boards CircuitPython Code ====
| |
| − |
| |
| − | * [https://learn.adafruit.com/circuitpython-essentials/circuitpython-i2c I2C scanner]
| |
| − |
| |
| − | ===== I2CIO-8 (MCP23008) Drivers =====
| |
| − |
| |
| − | * [https://github.com/land-boards/lb-boards/tree/master/Projects/QTPy/Land%20Boards/Land%20Boards%20QT%20Py%20Code GitHub Repo]
| |
| − | ** [https://github.com/land-boards/lb-boards/blob/master/Projects/QTPy/Land%20Boards/Land%20Boards%20QT%20Py%20Code/I2CIO8.py I2CIO8.py Demo code] - Bounce an LED across MCP23008 card output pins
| |
| − | ** [https://github.com/land-boards/lb-boards/blob/master/Projects/QTPy/Land%20Boards/Land%20Boards%20QT%20Py%20Code/I2CIO8_RW.py I2CIO8_RW.py] - Read jumpers, write back LEDs
| |
| − |
| |
| − | ===== SWLEDX8-I2C (MCP23017) Drivers =====
| |
| − |
| |
| − | * [https://github.com/land-boards/lb-boards/blob/master/Projects/QTPy/Land%20Boards/Land%20Boards%20QT%20Py%20Code/SWLEDX8.py SWLEDX8.py] = Control the [[SWLEDX8-I2C]] card
| |
| − |
| |
| − | ===== PROTO16-I2C (MCP23017) Drivers =====
| |
| − |
| |
| − | * [https://github.com/land-boards/lb-boards/blob/master/Projects/QTPy/Land%20Boards/Land%20Boards%20QT%20Py%20Code/PROTO16_Blink.py PROTO16_Blink.py] - Control the [[PROTO16-I2C]] card
| |
| − |
| |
| − | ==== Digital I/O Example ====
| |
| − |
| |
| − | <pre>
| |
| − | import board
| |
| − | import digitalio
| |
| − | import time
| |
| − |
| |
| − | led = digitalio.DigitalInOut(board.D13)
| |
| − | led.direction = digitalio.Direction.OUTPUT
| |
| − |
| |
| − | while True:
| |
| − | led.value = True
| |
| − | time.sleep(0.1)
| |
| − | led.value = False
| |
| − | time.sleep(0.5)
| |
| − | </pre>
| |
| − |
| |
| − | == Flash EEPROM 2 MB ==
| |
| − |
| |
| − | [[File:QT_Py_4600-07.jpg]]
| |
| − |
| |
| − | == QT Py Breakout Board ==
| |
| − |
| |
| − | [[File:QT_Py_Breakout_P18212-720px.jpg]]
| |
| − |
| |
| − | * Built onto [[GRID49]] card
| |
| − | * Socket for QT Py
| |
| − | * QT Py pins brought to header strips
| |
| − | * 3.3V power distribution on 2x8 header
| |
| − |
| |
| − | === Pins (CCW direction) ===
| |
| − |
| |
| − | * S12 = A0
| |
| − | * R12 = A1
| |
| − | * Q12 = A2
| |
| − | * P12 = A3
| |
| − | * N12 = SDA
| |
| − | * M12 = SCL
| |
| − | * L12 = TX
| |
| − | * L1 = RX
| |
| − | * M1 = SCK
| |
| − | * N1 = MI
| |
| − | * P1 = MO
| |
| − | * Q1 = 3.3V
| |
| − | * R1 = GND
| |
| − | * S1 = 5V
| |
| − | * A6=B6=C6=D6=E6=F6=G6=H6 = GND
| |
| − | * A7=B7=C7=D7=E7=F7=G7=H7 = 3.3V
| |
| − |
| |
| − | == QTPy49 Board ==
| |
| − |
| |
| − | * [[QTPy49]]
| |
| − |
| |
| − | [[FILE:QTPy49_FRONT_REV1.png]]
| |
| − |
| |
| − | == Videos ==
| |
| − |
| |
| − | <video type="youtube">qwKIxXVd0lc</video>
| |
