Adafruit GEMMA

The educational technology and digital learning wiki
Jump to navigation Jump to search

Draft

Introduction

AdaFruit GEMMA, Source learn.adafruit.com/, Copyright Adafruit, reproduced with permission.

Adafruit GEMMA is a small e-textile Arduino-compatible board that also can be programmed with CircuitPython. Quote: "The Gemma M0 is a super small microcontroller board, with just enough to build many simple projects. It may look small and cute: round, about the size of a quarter, with friendly alligator-clip sew pads". (Gemma M0 Overview page, August 2019).

As of August 2019, Gemma M0 version is the most interesting version. It can be programmed with MakeCode / JavaScript, CiruitPython and Arduino. Version V1 and V2 are no longer recommended.

See also:

The board

Unlike the Adafruit Circuit Playground Express‎, this board does not have any sensors. I only has a single RDB LED for output. Therefore, it should be used together with other hardware elements, e.g. Adafruit NeoPixels and any kind of sensor or other input devices described in the Adafruit FLORA page.

AdaFruit GEMMA schema, Source: learn.adafruit.com/, Copyright Adafruit, reproduced with permission.

The following information was extracted from the guided tour and the pinouts pages. (retrieved Augus 23, 2019).

This board has the following features

  • 48 MHz ATSAMD21 32 bit processor
  • 256KB Flash
  • 32 KB RAM
  • RBG DotStar LED.
  • Can be used with Arduino IDE or CircuitPython
  • JST battery connector
  • ON/OFF Switch
  • Reset button

connectivity

  • Micro B USB connector. Native USB supported by every OS.

General Purpose Input Ouput (GPIO) Pads

All the 3 GPIO pads can be used as digital inputs, digital outputs, for LEDs, buttons and switches. In additon, all can be used as analog inputs (12-bit ADC) or hardware capacitive touch. Each of the three has unique pad capabilities.

  • A0 - connected to PA02 on the ATSAMD21. This pin can be used as a digital I/O with selectable pullup or pulldown, capacitive touch, analog input (use 'A0'), and true analog (10-bit DAC) output. It cannot be used as PWM output.
  • A1 - connected to PA05 on the ATSAMD21. This pin can be used as a digital I/O with selectable pullup or pulldown, capacitive touch, analog input (use 'A1'), PWM output, and is also used for I2C clock (SCL), and hardware Serial TX.
  • A2 - connected to PA04 on the ATSAMD21. This pin can be used as a digital I/O with selectable pullup or pulldown, capacitive touch, analog input (use 'A2'), PWM output, and is also used for I2C data (SDA), and hardware Serial RX.

Power in/out pads

  • 3Vo - This is the 3.3V OUTPUT pad from the voltage regulator, provides up to 500mA at a steady 3.3V. Good for sensors or small LEDs or other 3V devices.
  • Vout - Voltage output (connect to either battery or USB power, whichever is highets). Used to power things up to 500mA.
  • 1 GND - common ground pin

Drivers

Programming with MakeCode

So far (Aug 2019), there isn't much documentation.

To program the GEMMA, one has to use the default environment at https://maker.makecode.com/ (unlike the Adafruit Circuit Playground Express‎, which has its own environment.

First time use

Step 1: (Windows users only)

  • Before you start, install the drivers. Download the *.exe file to a local directory and execute it, having admin rights.

Step 2: Ready the board for MakeCode programming (you can do that later also)

  • Double press the reset button (in my case) since it was ready for CircuitPython out of the box. The name of the drive was "CircuitPy (D:)". It should be either MAKECODE, METROBOOT or GEMMABOOT. After double pressing the rest button I got GEMMABOOT (D:). which is OK

Creating a new project

Open https://maker.makecode.com/ in a web browser

Step 1: Create a new project

Creating a new Project

Step 2: Select the gemma board

Selecting the GEMMA board

Step 3: Write the program

Step 4: Save it (actually do that every now and then)

  • This will save a PNG file that will have your program code inside (!)
  • To edit again drag and drop the picture into the web editor

Step 5: Download and flash

  • Connect the Board with a USB B cable
  • Click on the Download button
  • The status LED (top right) will blink while the file transfers.
  • After that, the board will reset automatically and your *.uf2 fill will become the current.uf2 file.

Example

  • The following code will have the LED blink green and red four times when started.
  • The user then can change color
    • Pressing A1 (aka D2) : Magenta
    • Pressing A0 (aka D1): Pink

Programming with CircuitPython

“The most exciting part of the Gemma M0 is that while you can use it with the Arduino IDE, we are shipping it with CircuitPython on board. When you plug it in, it will show up as a very small disk drive with main.py on it. Edit main.py with your favorite text editor to build your project using Python, the most popular programming language. No installs, IDE or compiler needed, so you can use it on any computer, even ChromeBooks or computers you can't install software on. When you're done, unplug the Gemma M0 and your code will go with you.”

Links

Acknowledgement

Pictures as well as some text was reproduced from the Adafruit GEMMA documentation. Some pictures are available under a CC BY-NC-SA license. Others are copyright AdaFruit and "all rights reserved" and reproduced with permission. Before you reuse any picture from this website, make sure to look at the license information.

Retrieved from "https://edutechwiki.unige.ch/mediawiki/index.php?title=Adafruit_GEMMA&oldid=72705"