Difference between revisions of "MMBASIC on XIAO RP2040"

From Land Boards Wiki
Jump to navigation Jump to search
 
(54 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[file:QTPy49_MMBASIC_P18412-720px.jpg]]
+
[[File:tindie-mediums.png|link=https://www.tindie.com/products/27066/]]
 +
 
 +
[[file:QTPy49-01-P1080524-720px.jpg]]
  
 
== Overview ==
 
== Overview ==
Line 15: Line 17:
  
 
* [https://www.seeedstudio.com/xiao-rp2040-v1-0-p-5026.html Seeed Studio XIAO RP2040]
 
* [https://www.seeedstudio.com/xiao-rp2040-v1-0-p-5026.html Seeed Studio XIAO RP2040]
* [[QTPy49|QTPy49 breakout card]]
+
* 1-2 card set
* [[SD CARD X49|SD Adaper card]]
+
** [[QTPy49-01|QTPy49-01 breakout card with SD card]]
* [[DTE|RS-232 serial card]] (optional)
+
** [[DTE|RS-232 serial card]] (optional)
 +
* 2-3 card set
 +
** [[QTPy49|QTPy49 breakout card]]
 +
** [[SD CARD X49|SD Adapter card]]
 +
** [[DTE|RS-232 serial card]] (optional)
  
 
=== Seeed Studio XIAO RP2040 ===
 
=== Seeed Studio XIAO RP2040 ===
  
[[QT_Py_(RP2040_based)]]
+
[[file:XIAO-RP2040.PNG]]
 +
 
 +
[[QT_Py_(RP2040_based)]] Wiki page
  
[[file:XIAO-RP2040.PNG]]
+
* Two manufacturers
 +
** [https://www.adafruit.com/product/4900 Adafruit QT Py RP2040 Product page]
 +
** [https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html Seeed XIAO RP2040 Product page]
 +
* USB Type C connector
 +
* RP2040 32-bit Cortex M0+ dual-core
 +
* Runs at ~125 MHz
 +
* 264 KB RAM
 +
* SPI FLASH chip for storing files and CircuitPython/MicroPython code storage
 +
** 8 MB - Adafruit
 +
** 2 MB - Seeedstudio
 +
* No EEPROM
 +
* Can be used with C/C++ (Arduino), 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)
 +
** I2C port
 +
*** 2 I2C: 1 on QT pins, one on the (Adafruit) breakout pads - Adafruit
 +
*** 1 I2C on XAIO
 +
** 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)
 +
 
 +
== QTPy49-01 Card ==
 +
 
 +
[[file:QTPy49-01-P1080524-720px.jpg]]
 +
 
 +
* The [[QTPy49-01]] Card combines the [[QTPy49]] card and [[SD_CARD_X49]] card onto one card
 +
* Headers for other pins
 +
* DC in jack with 5V regulator and Schottky diode
 +
* Power can be supplied from DC in (7-12V) or USB Jack
 +
 
 +
== QTPy49 / SD Card Set ==
 +
 
 +
[[file:QTPY49_MMBASIC_P18420-720pxV.jpg]]
  
 
=== QTPy49 breakout card ===
 
=== QTPy49 breakout card ===
 +
 +
[[File:tindie-mediums.png|link=https://www.tindie.com/products/27066/]]
 +
 +
[[file:QTPy49_P18254-720px.jpg]]
 +
 +
[[QTPy49]] Wiki page
 +
 +
* [[QT Py (RP2040 based)]] CPU choices are
 +
** [https://www.adafruit.com/product/4900 Adafruit QT Py RP2040 Product page]
 +
** [https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html Seeed XIAO RP2040 Product page]
 +
** 133 MHz
 +
* Connectors/Headers
 +
** DC Power
 +
** AD0 GVS
 +
** AD1 GVS
 +
** AD2 GVS
 +
** AD3 GVS
 +
** I2C with ground/VCC
 +
** TX/RX with ground/VCC
 +
** SPI with ground/VCC
 +
* QTPy49 can be powered from with either the USB C or DC jack
 +
** Automatic Schottky diode power switching between
 +
*** 5V from USB C
 +
*** 5V on external DC jack
 +
*** 7-12V on DC jack
 +
* 49x49mm ODAS form factor
 +
* (4) 4-40 mounting holes
  
 
=== SD Card ===
 
=== SD Card ===
 +
 +
[[File:tindie-mediums.png|link=https://www.tindie.com/products/land_boards/sd-card-adapter-sd_card_x49/]]
 +
 +
[[file:SDCARDX49_P935_cropped-512px.jpg]]
 +
 +
[[SD_CARD_X49]] wiki page
 +
 +
* SD or SDHC card adapter
 +
* 5V to 3.3V regulator
 +
* 3.3V to 5V [https://www.ti.com/lit/ds/symlink/txs0104e.pdf TXS0104E] level shifter
 +
* Activity LED
 +
* 49 x 49 mm ODAS foprm factor
 +
* (4) 4-40 mounting holes
  
 
==== SD Card Wiring ====
 
==== SD Card Wiring ====
Line 104: Line 187:
 
</PRE>
 
</PRE>
  
=== RS-232 (option) ===
+
== RS-232 (option) ==
 +
 
 +
[[File:tindie-mediums.png|link=https://www.tindie.com/products/24285/]]
  
 
[[file:DTE_P562-720px.jpg]]
 
[[file:DTE_P562-720px.jpg]]
 +
 +
[[DTE]] wiki page
  
 
* TTL to RS-232 converter
 
* TTL to RS-232 converter
Line 114: Line 201:
 
* 4x 4-40 holes
 
* 4x 4-40 holes
 
* [[DTE]] card
 
* [[DTE]] card
* Command to use serial
+
 
 +
=== Command to use serial as console ===
 +
 
 +
* 115,200 baud = default
 +
 
 +
<PRE>
 +
OPTION SERIAL CONSOLE GP1, GP0
 +
 
 +
</PRE>
 +
 
 +
* Command to use serial as console switch back from the serial port to the USB on the XIAO RP2040
  
 
<PRE>
 
<PRE>
OPTION SERIAL CONSOLE GP0, GP1
+
option serial console disable
 +
 
 +
</PRE>
 +
 
 +
=== User Serial port ===
 +
 
 +
* Command to use serial as COM port
 +
 
 +
<PRE>
 +
setpin gp1,gp0, com1
 +
open "com1:9600" as #5
 +
print #5, "Hello"
  
 
</PRE>
 
</PRE>
  
 
==== RS-232 Wiring ====
 
==== RS-232 Wiring ====
 +
 +
* Wiring to [[DTE]] card
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 160: Line 270:
 
|-
 
|-
 
|}
 
|}
 +
 +
* Wiring to [[FTDI-49MM]] card
 +
** Swap TX/RX pins
 +
 +
==== RS-232 Stackup ====
 +
 +
[[file:QTPy49-01_P18561_720px.jpg]]
 +
 +
[[file:QTPy49_MMBASIC_P1080442-720px.jpg]]
 +
 +
=== RS-232 to USB ===
 +
 +
[[File:tindie-mediums.png|link=https://www.tindie.com/products/land_boards/ftdi-card-with-extra-features/]]
 +
 +
[[file:FTDI-P1746-CROPPED-720PX.jpg]]
 +
 +
* Uses [[FTDI-49MM]] FTDI to TTL card
 +
* RS-232 to USB
 +
* Mates to CPU stackup
 +
 +
[[file:QTPy49_MMBASIC_P1080444-720px.jpg]]
 +
 +
* Brought all the way back to USB
 +
 +
[[file:QTPy49_MMBASIC_P18445-720px.jpg]]
  
 
=== MMBASIC Card Stack-up ===
 
=== MMBASIC Card Stack-up ===
Line 177: Line 312:
 
* Card will re-boot
 
* Card will re-boot
 
* Connect in TeraTerm over serial
 
* Connect in TeraTerm over serial
* Free memory
+
 
 +
==== MMBASIC Free Memory ====
 +
 
 +
* V5.070501
  
 
<pre>
 
<pre>
 
> print mm.ver
 
> print mm.ver
  5.070501
+
  5.0704
 
 
 
> memory
 
> memory
 
 
Program:
 
Program:
 
   0K ( 0%) Program (0 lines)
 
   0K ( 0%) Program (0 lines)
Line 190: Line 326:
  
 
RAM:
 
RAM:
   1K ( 1%) 3 Variables
+
   0K ( 0%) 0 Variables
 
   0K ( 0%) General
 
   0K ( 0%) General
  155K (99%) Free
+
  156K (100%) Free
 +
 
 
</pre>
 
</pre>
  

Latest revision as of 15:30, 19 August 2022

Tindie-mediums.png

QTPy49-01-P1080524-720px.jpg

Overview

  • Card set running BASIC Interpreter for the Raspberry Pi Pico on Seeed Studio XIAO RP2040
  • MMBasic is a Microsoft BASIC compatible implementation of the BASIC language with floating point, integer and string variables, arrays, long variable names, a built in program editor and many other features
  • 8 Flash locations for storage.
  • Support for SD Card

MMBASIC Credits

Peter Mather led the project, ported the MMBasic interpreter to the Raspberry Pi Pico and wrote the hardware device drivers. Geoff Graham wrote the MMBasic interpreter and the manual. Mick Ames wrote the PIO compiler and its corresponding documentation.

Hardware

Seeed Studio XIAO RP2040

XIAO-RP2040.PNG

QT_Py_(RP2040_based) Wiki page

  • Two manufacturers
  • USB Type C connector
  • RP2040 32-bit Cortex M0+ dual-core
  • Runs at ~125 MHz
  • 264 KB RAM
  • SPI FLASH chip for storing files and CircuitPython/MicroPython code storage
    • 8 MB - Adafruit
    • 2 MB - Seeedstudio
  • No EEPROM
  • Can be used with C/C++ (Arduino), 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)
    • I2C port
      • 2 I2C: 1 on QT pins, one on the (Adafruit) breakout pads - Adafruit
      • 1 I2C on XAIO
    • 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)

QTPy49-01 Card

QTPy49-01-P1080524-720px.jpg

  • The QTPy49-01 Card combines the QTPy49 card and SD_CARD_X49 card onto one card
  • Headers for other pins
  • DC in jack with 5V regulator and Schottky diode
  • Power can be supplied from DC in (7-12V) or USB Jack

QTPy49 / SD Card Set

QTPY49 MMBASIC P18420-720pxV.jpg

QTPy49 breakout card

Tindie-mediums.png

QTPy49 P18254-720px.jpg

QTPy49 Wiki page

  • QT Py (RP2040 based) CPU choices are
  • Connectors/Headers
    • DC Power
    • AD0 GVS
    • AD1 GVS
    • AD2 GVS
    • AD3 GVS
    • I2C with ground/VCC
    • TX/RX with ground/VCC
    • SPI with ground/VCC
  • QTPy49 can be powered from with either the USB C or DC jack
    • Automatic Schottky diode power switching between
      • 5V from USB C
      • 5V on external DC jack
      • 7-12V on DC jack
  • 49x49mm ODAS form factor
  • (4) 4-40 mounting holes

SD Card

Tindie-mediums.png

SDCARDX49 P935 cropped-512px.jpg

SD_CARD_X49 wiki page

  • SD or SDHC card adapter
  • 5V to 3.3V regulator
  • 3.3V to 5V TXS0104E level shifter
  • Activity LED
  • 49 x 49 mm ODAS foprm factor
  • (4) 4-40 mounting holes

SD Card Wiring

Signal SD_CARD_X49 QTPy49 conn QTPy GP PiPico Pin
SPI_SCLK J1-3 J3-6 GP2 GPIO2
SPI_MOSI J1-4 J3-4 GP3 GPIO3
SPI_MISO J1-2 J3-5 GP4 GPIO4
SPI_SS J1-5 J9-3 GP26 GPIO26
GND J1-1 J9-1 GND GND
VCC (3.3V) J1-7 J9-2 VCC VCC

SD Configuration

OPTION SYSTEM SPI GP2, GP3, GP4
OPTION SDCARD GP26
OPTION COLOURCODE ON

  • Verify it is working
> FILES
A:/
   <DIR>  basic
   <DIR>  bmps
   <DIR>  demos
   <DIR>  games
   <DIR>  jpegs
   <DIR>  lbcards
   <DIR>  performance
   <DIR>  wave
8 directories, 0 files

RS-232 (option)

Tindie-mediums.png

DTE P562-720px.jpg

DTE wiki page

  • TTL to RS-232 converter
  • Male DB-9 connector
  • FTDI pinout (reversed directions to directly connect to FTDI Interface)
  • 49x49mm card
  • 4x 4-40 holes
  • DTE card

Command to use serial as console

  • 115,200 baud = default
OPTION SERIAL CONSOLE GP1, GP0

  • Command to use serial as console switch back from the serial port to the USB on the XIAO RP2040
option serial console disable

User Serial port

  • Command to use serial as COM port
setpin gp1,gp0, com1
open "com1:9600" as #5
print #5, "Hello"

RS-232 Wiring

  • Wiring to DTE card
DTE signal DTE pin QTPy GP PiPico Pin
GND H1-1 GND J4-1
CTS H1-2 N/C N/C
VCC H1-3 VCC J4-2
TX H1-4 TX_D6 J4-3
RX H1-5 RX_D7 J4-4
RTS H1-6 N/C N/C

RS-232 Stackup

QTPy49-01 P18561 720px.jpg

QTPy49 MMBASIC P1080442-720px.jpg

RS-232 to USB

Tindie-mediums.png

FTDI-P1746-CROPPED-720PX.jpg

  • Uses FTDI-49MM FTDI to TTL card
  • RS-232 to USB
  • Mates to CPU stackup

QTPy49 MMBASIC P1080444-720px.jpg

  • Brought all the way back to USB

QTPy49 MMBASIC P18445-720px.jpg

MMBASIC Card Stack-up

QTPY49 MMBASIC P18420-720pxV.jpg

Software

Install MMBASIC on Seeed XIAO RP2040

  • Hold down the "BOOT" button
    • The "B" is written on the board shown to the right
  • Connect the XIAO RP2040 via USB C cable to your computer while still pressing the button
  • The computer then will appear a disk driver(RP1-RP2)
  • Download the PicoMite_Firmware.zip
  • Drag the .uf2 file to the disk drive ("RP1-RP2")
  • Card will re-boot
  • Connect in TeraTerm over serial

MMBASIC Free Memory

  • V5.070501
> print mm.ver
 5.0704
> memory
Program:
   0K ( 0%) Program (0 lines)
 124K (100%) Free

RAM:
   0K ( 0%) 0 Variables
   0K ( 0%) General
 156K (100%) Free

GPIO from MMBASIC

QTPy49 Marking GPIO
A0 GP26 (SD_SS)
A1 GP27
A2 GP28
A3 GP29
I2C_SDA GP6
I2C_SCL GP7
RX GP1
TX GP0

MMBASIC - Using Pins

  • Digital I/O
SETPIN GP27, DIN:' Digital Input
SETPIN GP28, DOUT:' Digital Output
PIN(GP28) = 1:'Digital output

  • Analog Input
SETPIN GP29, AIN:' Analog Input

  • SETPIN(s) for Serial and I2C
SETPIN GP1, GP0, COM1
SETPIN GP6, GP7 I2C2

On-Board LED

  • No Built-in support in MMBASIC for the on-board NEOPIXEL
  • Red, Green, Blue LED
  • Pull Low to turn on RGB LED bits
  • At-boot - RGB LED blinks Cyan/Green by MMBASIC
  • Red LED = GP17
  • Green LED = GP16
  • Blue LED = GP25 (Used by MMBASIC)
' Make pins outputs
SETPIN GP17, DOUT:' Red LED
SETPIN GP16, DOUT:' Green LED
SETPIN GP25, DOUT:' Blue LED
' Turn off LEDS
PIN(GP17)=1:' Turn off Red LED
PIN(GP25)=1:' Turn off Blue LED
PIN(GP16)=1:' Turn off Green LED
' Turn on LEDs
PIN(GP17)=0:' Turn on Red LED
PIN(GP25)=0:' Turn on Blue LED
PIN(GP16)=0:' Turn on Green LED

Demo Code