Adafruit Circuit Playground

The educational technology and digital learning wiki
Jump to: navigation, search
E-textile
◀▬▬▶
to finalize beginner
2019/11/29 ⚒⚒ 2019/09/23
Objectives
  • be aware of Adafruit Circuit Playground Express components
  • Basics of programming the board
See also

Objectives

  • be aware of Adafruit Circuit Playground Express components
  • Basics of programming the board

See also

  • Quality: to finalize
  • Difficulty: beginner

As of December 2019, there are TWO types of circuit playgrounds : the Classic vs the Express plus the Bluefruit. The classic version can run Arduino and Code.org and the Express and Bluefruit versions can run MakeCode, CircuitPython, Arduino, and Code.org CS discoveries. We present here the Circuit playground Express and the Circuit Playground Bluefruit.

1 Introduction

AdaFruit Circuit Playground Express'. Source: Flickr of AdaFruit

Circuit Playground Express (alias "CPX") and the Circuit Playground Bluefruit (CPB) are boards of the Adafruit Wearables line of of e-textile products. These boards are beginner friendly since they can (also) be programmed with MakeCode and since it includes sensors, 10 LEDs, 2 push buttons, etc. and a loudspeaker in addition to the basic components (microcontroller, connectors, etc.).

The boards are rather large and heavy compared to Adafruit's FLORA and GEMMA. However, this is compensated by their feature rich design and ease of use.

  • 50.6mm / ~2.0"
  • Weight: 8.9g

The CPX board can be bought in three packaging variants:

As of Nov 29 2019: (kits probably will be available soon

Circuit Playground Bluefruit (CPB) $25, includes just the board

For a class, it's probably best to buy Base Kits ($30), either a few Advanced Packs or other FLORA extension elements, and finally some simple boards (for replacements or projects that include more than one board).

Extras

See also:

2 The CPX board

Below is a picture of an Adafruit Circuit Playground Express

AdaFruit Circuit Playground Express'. Photo source: Adafruit Flickr

2.1 Components and layouts

According to the product page (retrieved Aug 26, 2019), this board includes the following elements which are explained in detail in the guided tour.

Processor and basics

  • ATSAMD21 ARM Cortex M0 Processor, running at 3.3V and 48MHz
  • 2 MB of SPI Flash storage (i.e. a tiny disk drive), used primarily with CircuitPython to store code and libraries.
  • A JST battery connector (alternatively, the board also can take power from the USB connector).
  • Green "ON" LED so you know its powered (top left)
  • Red "#13" LED (D13) for basic blinking
  • Reset button (in the middle)
  • A total of 14 input/output pads ("the holes")

Connectivity

  • MicroUSB port for programming and debugging. It can act like a serial port, keyboard, mouse, joystick or MIDI!
  • Infrared receiver (D26) and transmitter (D25) - can receive and transmit any remote control codes, as well as send messages between Circuit Playground Expresses. Can also act as a proximity sensor.
  • 14 "alligator" clip pads: a wide range of power pins, I2C, UART, Analog In, Digital In/Out, PWM, and Analog Out.

Output:

  • 10 x mini NeoPixels (D8). These programmable LEDs can display any color. They are also used for some status information: when the bootloader is running they will turn green, or if it failed to initialize USB when connected to a computer, they will turn red).
  • 1 Mini speaker (A0) with class D amplifier (7.5mm magnetic speaker/buzzer). It is connected to to the A0 analog output pin.

Input and sensors:

  • 1 Temperature sensor (A9)
  • 1 Light sensor (A8). Can also act as a color sensor and pulse sensor.
  • 1 Sound sensor (MEMS microphone)
  • 1 Motion sensor (D27), i.e. a LIS3DH triple-axis accelerometer with tap detection, free-fall detection.
  • 2 x Push buttons, labeled A (D4) and B (D5)
  • 1 x Slide switch (D7)
  • 7 of the 8 GPIO pads have capacitive touch (A1, A2, A3, A4, A5, A6, A7)

Pads

Below you wil find a picture whoch represent the main function of the pads (power pads OR General Purpose Input Ouput -GPIO- pads). The figure mentioned beside the pins are the a.k.a names of the GPIO pins with a "D". Indead, each GPIO pin have a surname (we have to figure out the utility of this surname but maybe it is for Arduino programming).

Adafruit Pads main functions

8 General Purpose Input Ouput (GPIO) pads (A0 to A7)

  • Common for all pads
    • ALL can be used as digital inputs, digital outputs, for LEDs, buttons, switches and also can be used as analog inputs (12-bit ADC).
    • ALL can be used as hardware interrupt inputs.
    • ALL (except A0) can be used for hardware capacitive touch.
    • ALL (except A0 which is shared with the speaker) are completely "free" pins with no connections with other components and you are free by programming them.
  • Each Pin :
  • A0 (a.k.a D12) : special pin can be used as an analog output for reading audio clip for example. It can be digital I/O, or analog I/O, but if you do that it will interfere with the built-in speaker. This is the only put which cannot be used as capacitive touch.
  • A1/D6, A2/D9, A3/D10 : pins can be digital I/O or analog input. These pins have PWM Output (Pulse With Modulation[1] Output) and can be capacitive touch sensor.
  • A4/D3: pin can be digital I/O or analog input. This pin is also the I2C SCL (inter-Integrated Circuit Serial Clock line) pin and can be capacitive touch sensor.
  • A5/D2: pin can be digital I/O or analog input. This pin is also the I2C SDA (inter-Integrated Circuit Serial Data Line) and ca be capacitive touch sensor.
  • A6/D0 : pin can be digital I/O, or analog Input. This pin has PWM output, Serial Receive, and can be capacitive touch sensor
  • A7/D1 - This pin can be digital I/O, or analog Input. This pin has PWM output, Serial Transmit, and can be capacitive touch sensor

Warning: Each pad can provide up to 20mA. Don't connect high power component such as servos, Neopixels ...

6 Power pads

    • GND - 3 GROUND pads - interconnected using for signal / power ground connections.
    • 3,3V - Two 3,3V output pads - used for small energy consumer components such as chips, sensors and lower power electronic components(i.e max electric intensity : 500 mA)
    • VOUT - 1 VOLTAGE OUTPUT pad - it will be connnected either the UBS power or the battery input and it is used for servos, Neopixels, DotStard or other high power electronic components up to 5V (i.e max electric intensity : 500mA continuous or 1 Amp peak). It contains a resettable fuse and if the fuse trips, just wait 1 minute and it will be reset.

2.2 Packaging

As explained above, the Circuit Playground Express is available as single component ($25), as basic kit (including a USB cable, needles, AAA-battery pack, lithium battery, and some thread, $30) and as Circuit Playground Express Advanced Pack ($100).

Adafruit Circuit Playground Express Base Kit, as of Aug 2019

2.3 Add ons

Circuit Playground TFT Gizmo - Bolt-on Display + Audio Amplifier

Besides various Adafruit components that can be added, e.g. Neopixel strips, there are:

  • Circuit Playground TFT Gizmo - Bolt-on Display + Audio Amplifier ($19.95). This "thing" can be bolted to a Playground Express. Quote: Once attached you'll get a 1.54" 240x240 IPS display with backlight control, two 3-pin STEMMA connectors for attaching NeoPixel strips or servos, and a Class D audio amplifier with a Molex PicoBlade connector that can plug one of our lil speakers. As of Stp. 2019, the product is sold, but still in alpha.

3 The CPB board

The layout of the CPB is similar to CPX.

AdaFruit Playground Bluetooth (CPB)

This board also can be programmed with MakeCode, e.g. see the Cyberpunk Santa Eye project.

So far we did not test if the CPB's Bluetooth functionality can be programmed in JavaScript/MakeCode....

4 Programming the boards

To compile and upload a program to the controller

  • Open
  • Connect the board with the USB cable
  • Press the reset button in the middle(for a while). See the schema above if you cannot find it..
  • When it turns green, you can download the code from your browser window.

Example

Clap hands code example: Based on the "clap lights" example at Makecode.adafruit.com

Javascript version

Notice how the RDG colors are defined. E.g. red (CSS #FF0000) becomes 0xff0000

input.onLoudSound(function () {
    light.setBrightness(20)
    for (let i = 0; i < 4; i++) {
        light.setAll(0xff0000)
        pause(200)
        light.setAll(0x000000)
        pause(200)
    }
    light.setPixelColor(0, 0x00ff00)
    light.setPixelColor(9, 0x00ff00)
})

Result after clapping

Clap hands code example (see the Adafruit on the right of the screen)

See also:

  • MakeCode (includes other examples and more information about the language)

5 Links

5.1 Official tutorials

Adafruit Circuit Playground Express documentation

Tutorials

Many hands-on tutorials are available through the online editor, e.g. the clap lights tutorial (a simpler version of our clap hands example)

Hardware

6 Acknowledgement

Pictures as well as some text was reproduced from the Adafruit circuit playground express 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.

For more information about using Adafruit, see https://learn.adafruit.com.

  1. Pulse width modulation allows to vary how much time the signal is high and low. It can be used to blink the led or make gradations of light