Difference between revisions of "QT Py"

From Land Boards Wiki
Jump to navigation Jump to search
 
(79 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Two Versions of the QT Py ==
+
[[File:tindie-mediums.png|link=https://www.tindie.com/products/27066/]]
  
* AdaFruit has SAMD21 and RP2040 versions of the QT Py
+
[[FILE:QTPy49_P18254-720px.jpg]]
** Same pinouts/form factors
 
* RP2040 vs SAM version
 
** RP2040 is faster (125 MHz vs 48 MHz)
 
** RP2040 has 2 cores vs 1
 
** RP2040 has more Flash
 
** RP2040 has more SRAM
 
** The RP2040 version is more expensive, but about the same cost if the SAM version is used with an external Flash
 
  
=== SAMD21 QT Py===
+
<video type="youtube">iI9lUsVSuF8</video>
  
[[File:QT_Py_4600-06.jpg]]
+
== Two Versions of the QT Py ==
 
 
<video type="youtube">0Qssr6B6MrU</video>
 
 
 
* [https://www.adafruit.com/product/4600 Adafruit QT Py SAMD21 Product Page]
 
** ATSAMD21E18 32-bit Cortex M0+ version
 
** 48 MHz, 32-bit processor
 
** 256KB Flash
 
** 32 KB RAM
 
* Native USB supported by every OS
 
** Can be used in Arduino or [https://circuitpython.org/ CircuitPython] as USB serial console, MIDI, Keyboard/Mouse HID, even a little disk drive for storing Python scripts.
 
* Built in RGB NeoPixel LED
 
* 11 GPIO pins:
 
** True analog output on one I/O pin
 
*** Can be used to play 10-bit quality audio clips in Arduino
 
**** CircuitPython does not have storage for audio clips
 
** 9 x 12-bit analog inputs (SDA/SCL do not have analog inputs)
 
** 1 x Optional AREF on A1
 
** 9 x PWM outputs (A0 is analog out, A1 is not PWM capable)
 
** Hardware I2C port with STEMMA QT plug-n-play connector
 
** Hardware UART
 
** Hardware SPI
 
** Hardware I2S
 
** 6 x Capacitive Touch with no additional components required
 
* 3.3V regulator with [https://www.diodes.com/assets/Datasheets/AP2112.pdf 600mA peak output] AP2112
 
* Optional SOIC-8 SPI Flash chip on bottom
 
** Can't use castellated pins if Flash on bottom is installed
 
** [https://www.adafruit.com/product/4763 GD25Q16]
 
** Access the SPI flash in Arduino on SPI1 and chip select pin 17
 
** In CircuitPython, a '[https://circuitpython.org/board/qtpy_m0_haxpress/ haxpress]' version of the runtime will need to be installed, so it knows to look for the larger filesystem
 
** There is more hardware support in the haxpress CircuitPython build because we can add more code to the internal flash instead of using it for a filesystem
 
* Reset switch for starting your project code over or entering bootloader mode
 
* USB Type C connector
 
 
 
=== RP2040 QT Py ===
 
 
 
[[file:QT Py RP2040.PNG]]
 
 
 
<video type="youtube">00t5y4nQlH8</video>
 
 
 
* [https://www.adafruit.com/product/4900 Adafruit QT Py RP2040 Product page]
 
* USB Type C connector
 
* RP2040 32-bit Cortex M0+ dual-core
 
* Runs at ~125 MHz
 
* 264 KB RAM
 
* 8 MB SPI FLASH chip for storing files and CircuitPython/MicroPython code storage. No EEPROM
 
* Can be used with MicroPython or CircuitPython
 
* Built-in RGB NeoPixel LED
 
* 13 GPIO pins (11 breakout pads and two QT pads):
 
** Four 12 bit ADCs (one more than Pico)
 
** Two I2C ports (one on the QT connector, one on the breakout pads)
 
** SPI and UART peripherals, in standard QT Py locations,
 
** PWM outputs on every IO pin - for servos, LEDs, etc
 
** There are 6 GPIO in consecutive order for PIO compatibility
 
* 3.3V logic and power 600 mA
 
* Both Reset button and Bootloader select buttons for quick restarts (no unplugging-replugging to relaunch code)
 
 
 
=== Links ===
 
 
 
* [https://circuitpython.org/board/qtpy_m0/ Adafruit QT Py page]
 
* [https://learn.adafruit.com/adafruit-qt-py Adafruit Learning System for QT Py]
 
 
 
== Pins ==
 
 
 
=== 3V ===
 
 
 
* Regulated output from the onboard regulator. You can draw 500mA
 
 
 
=== 5V ===
 
 
 
* 5v out from the USB port.
 
* You can also use this as a voltage input but you must have some sort of diode (schottky, signal, power, really anything) between your external power source and this pin with anode to battery, cathode to 5V pin.
 
* Note that you 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  ===
 
 
 
* Can act as a true analog output with 10 bit precision, but does not have PWM. Can also be a capacitive touch input.
 
 
 
=== A1 / D1 - Digital/analog GPIO pin 1 ===
 
 
 
* Can be a capacitive touch input or an AREF pin.
 
 
 
=== A2 / D2 - Digital/analog GPIO pin 2  ===
 
 
 
* Can act as PWM or capacitive touch input.
 
 
 
=== A3 / D3 - Digital/analog GPIO pin 3 ===
 
 
 
* Can act as PWM or capacitive touch input.
 
 
 
=== SDA / D4 ===
 
 
 
* This is the I2C data pin and digital pin 4, can also be a PWM
 
* There is no analog on this pin!
 
* There's no pull up on this pin by default so when using with I2C, you may need a 2.2K-10K pullup on each to 3.3V.
 
* All our STEMMA QT breakouts have the pullup installed on the breakout PCB.
 
 
 
===  SCL / D5 ===
 
 
 
* This is the I2C clock pin and digital pin 5, can also be a PWM
 
* There is no analog on this pin! There's no pull up on this pin by default so when using with I2C, you may need a 2.2K-10K pullup on each to 3.3V
 
 
 
=== TX / A6 / D6 ===
 
 
 
* Transmit (output) for Serial1
 
* Also analog/digital GPIO 6.
 
* Can act as PWM or capacitive touch input.
 
 
 
=== RX / A7 / D7 ===
 
 
 
* Receive (input) for Serial1
 
* Also analog/digital GPIO 7.
 
* Can act as PWM or capacitive touch input.*
 
 
 
=== SCK / A8 / D8 ===
 
 
 
* Hardware SPI clock pin
 
* Also analog/digital GPIO 8. Can act as PWM output.
 
 
 
=== MISO / A9 / D9 ===
 
 
 
* Also analog/digit* Hardware SPI MISO microcontroller in serial out pin
 
al GPIO 9. Can act as PWM output.
 
 
 
=== MOSI / A10 / D10 ===
 
 
 
* Hardware SPI MOSI microcontroller out serial in pin
 
* Also analog/digital GPIO 10. Can act as PWM output.
 
 
 
=== NeoPixel ===
 
 
 
* Connected to digital pin 11 for signal
 
* If you would like to turn off the pixel for low power usage, set pin 12 low.
 
* By default pin 12 is set high for you by Arduino/CircuitPython
 
 
 
== Programming ==
 
 
 
* C/C++ or CircuitPython
 
 
 
=== C/C++ ===
 
 
 
* [https://github.com/raspberrypi/pico-sdk RP2040 C/C++ SDK]
 
 
 
=== MicroPython ===
 
 
 
* [https://github.com/micropython/micropython/tree/master/ports/rp2 RP2040 MicroPython Repo]
 
 
 
=== CircuitPython ===
 
 
 
* Adafruit CircuitPython 6.1.0 on 2021-01-21; Adafruit QT Py M0 Haxpress with samd21e18
 
* [https://circuitpython.readthedocs.io/en/latest/README.html CircuitPython] is a derivative of MicroPython.
 
** [https://circuitpython.org/board/qtpy_m0_haxpress/ QT Py Haxpress] used with 2MB Flash EEPROM
 
* [https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/master/Welcome_to_CircuitPython/QT_Py_blink.py blink.py for QT Py]
 
* [https://codewith.mu/ Mu editor]
 
* 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
 
* How do I check how much memory I have free?
 
<pre>
 
import gc
 
gc.mem_free()
 
</pre>
 
* Reports about 19KB of free space
 
 
 
Will give you the number of bytes available for use.
 
 
 
==== Land Boards Python Code ====
 
  
* [https://github.com/land-boards/lb-boards/tree/master/Projects/QTPy/Land%20Boards GitHub]
+
* AdaFruit and Seeed Studio have SAMD21 and RP2040 versions of the QT Py (XIAO on Seeed Studio) with the same form factor
 +
** [[QT Py (SAMD based)]]
 +
** [[QT Py (RP2040 based)]]
 +
* [[QTPy49|QTPy49 Breakout card]]
  
==== Digital I/O Example ====
+
== RP2040 vs SAM version ==
  
<pre>
+
* RP2040 is faster (125 MHz vs 48 MHz)
import board
+
* RP2040 has 2 cores vs 1
import digitalio
+
* RP2040 has more Flash
import time
+
* RP2040 has more SRAM
 +
* The RP2040 version is more expensive, but about the same cost if the SAM version is used with an external Flash
 +
* [https://www.seeedstudio.com/blog/2020/01/09/samd21-arduino-boards-which-one-should-you-use/ SAMD21/RP2040 Arduino Boards – Which 32-bit Microcontrollers should you use?]
  
led = digitalio.DigitalInOut(board.D13)
+
[[file:XIAO_SAM_vs_XIAO_RP2040.PNG]]
led.direction = digitalio.Direction.OUTPUT
 
  
while True:
+
== QTPy49 Breakout Card ==
    led.value = True
 
    time.sleep(0.1)
 
    led.value = False
 
    time.sleep(0.5)
 
</pre>
 
  
== Flash EEPROM 2 MB ==
+
* [[QTPy49]]
  
[[File:QT_Py_4600-07.jpg]]
+
[[file:QTPy49-P18253-720pxV.jpg]]

Latest revision as of 19:31, 24 July 2022

Tindie-mediums.png

QTPy49 P18254-720px.jpg

Two Versions of the QT Py

RP2040 vs SAM version

XIAO SAM vs XIAO RP2040.PNG

QTPy49 Breakout Card

QTPy49-P18253-720pxV.jpg