Adafruit GEMMA: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 57: Line 57:
So far (Aug 2019), there isn't much documentation.
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]]
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.
 
'''Windows users:''' Before you start, install the [https://github.com/adafruit/Adafruit_Windows_Drivers/releases/tag/latest drivers]. Download the *.exe file to a local directory and execute it, having admin rights.


=== Creating a new project ===
=== Creating a new project ===
Line 74: Line 76:


Step 6: Download: Click on the Download button
Step 6: Download: Click on the Download button


== Programming with CircuitPython ==
== Programming with CircuitPython ==

Revision as of 16:09, 27 August 2019

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. 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.

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

Creating a new project

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

Step 1: Create a new project

Step 2: Select the gemma board

Step 3: Write the program

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

Step 5: Connect the GAMMA with a USB B cable to your computer

Step 6: Download: Click on the Download button

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.