# LED Emerald with Circuit Playground Bluefruit
## Overview
https://youtu.be/2uG8KtozPcE
## Glowing Cosplay Props
3D print a glowing prop inspired by Sonic the Hedgehog.
Use CircuitPython and Circuit Playground Bluefruit to make a remote controlled NeoPixel Prop!
Inspired by the [Chaos Emerald](https://en.wikipedia.org/wiki/Sonic_the_Hedgehog#Chaos_Emeralds), this 3D printed Emerald snap fits together and houses the Adafruit Circuit Playground Bluefruit.
## Bluetooth Controlled NeoPixels
With Circuit Playground Bluefruit you can use the mobile app for iOS or Android to change the color of the LEDs over Bluetooth.
The color picker lets you change the colors and brightness so you can easily adjust the look of the emerald.
## Smol, Medium and JUMBO
We designed 3 different sizes so they can be made on a wide range of 3D printers.
The emeralds are 3D printed without any support material using translucent PLA filament.
Use natural clear or ivory white translucent PLA for the best looking LED diffusion.
# Parts
Featured
### Circuit Playground Bluefruit - Bluetooth® Low Energy
[Circuit Playground Bluefruit - Bluetooth® Low Energy](https://www.adafruit.com/product/4333)
**Circuit Playground Bluefruit** is our third board in the Circuit Playground series, another step towards a perfect introduction to electronics and programming. We've taken the popular Circuit Playground Express and made it even better! Now the main chip is an nRF52840...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4333)
[Related Guides to the Product](https://learn.adafruit.com/products/4333/guides)
# Batteries
There's a few batteries to choose from. The batteries listed below were tested to fit properly inside the 3D printed mount for the Circuit Playground Bluefruit board. Also pick up of of the battery chargers listed below
Featured
### Lithium Ion Polymer Battery - 3.7v 500mAh
[Lithium Ion Polymer Battery - 3.7v 500mAh](https://www.adafruit.com/product/1578)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 500mAh for a total of about 1.9 Wh. If you need a larger (or smaller!) battery,
In Stock
[Buy Now](https://www.adafruit.com/product/1578)
[Related Guides to the Product](https://learn.adafruit.com/products/1578/guides)
Featured
### Lithium Ion Polymer Battery with Short Cable - 3.7V 420mAh
[Lithium Ion Polymer Battery with Short Cable - 3.7V 420mAh](https://www.adafruit.com/product/4236)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 420mAh for a total of about 1.55 Wh. If you need a larger (or smaller!) battery,
In Stock
[Buy Now](https://www.adafruit.com/product/4236)
[Related Guides to the Product](https://learn.adafruit.com/products/4236/guides)
Featured
### Lithium Ion Polymer Battery with Short Cable - 3.7V 350mAh
[Lithium Ion Polymer Battery with Short Cable - 3.7V 350mAh](https://www.adafruit.com/product/4237)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 350mAh for a total of about 1.3 Wh. If you need a larger (or smaller!) battery,
In Stock
[Buy Now](https://www.adafruit.com/product/4237)
[Related Guides to the Product](https://learn.adafruit.com/products/4237/guides)
Featured
### Adafruit Micro-Lipo Charger for LiPo/LiIon Batt w/MicroUSB Jack
[Adafruit Micro-Lipo Charger for LiPo/LiIon Batt w/MicroUSB Jack](https://www.adafruit.com/product/1904)
Oh so handy, this little lipo charger is so small and easy to use you can keep it on your desk or mount it easily into any project! Simply plug it via any MicroUSB cable into a USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end....
In Stock
[Buy Now](https://www.adafruit.com/product/1904)
[Related Guides to the Product](https://learn.adafruit.com/products/1904/guides)
Featured
### Adafruit Micro-Lipo Charger for LiPoly Batt with USB Type C Jack
[Adafruit Micro-Lipo Charger for LiPoly Batt with USB Type C Jack](https://www.adafruit.com/product/4410)
Oh so handy, this little lipo charger is so small and easy to use you can keep it on your desk or mount it easily into any project! Simply plug it via any USB C cable into a USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end. There...
In Stock
[Buy Now](https://www.adafruit.com/product/4410)
[Related Guides to the Product](https://learn.adafruit.com/products/4410/guides)
### Black Nylon Machine Screw and Stand-off Set – M2.5 Thread
[Black Nylon Machine Screw and Stand-off Set – M2.5 Thread](https://www.adafruit.com/product/3299)
Totaling 380 pieces, this **M2.5 Screw Set** is a must-have for your workstation. You'll have enough screws, nuts, and hex standoffs to fuel your maker tendencies for days on end! M2.5 size screws fit almost all of the Adafruit breakout/dev board mounting holes...
In Stock
[Buy Now](https://www.adafruit.com/product/3299)
[Related Guides to the Product](https://learn.adafruit.com/products/3299/guides)
### Part: M3 Screws
quantity: 4
M3 x 6mm long machine screws
[M3 Screws](https://www.mcmaster.com/92095A179/)
### Part: PLA Ivory White
quantity: 1
1.75mm 1KG Translucent PLA from FilaCube
[PLA Ivory White](https://www.amazon.com/gp/product/B076Z26NS5/)
### USB cable - USB A to Micro-B
[USB cable - USB A to Micro-B](https://www.adafruit.com/product/592)
This here is your standard A to micro-B USB cable, for USB 1.1 or 2.0. Perfect for connecting a PC to your Metro, Feather, Raspberry Pi or other dev-board or microcontroller
Approximately 3 feet / 1 meter long
In Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
# LED Emerald with Circuit Playground Bluefruit
## CircuitPython on Circuit Playground Bluefruit
# Install or Update CircuitPython
Follow this quick step-by-step to install or update CircuitPython on your Circuit Playground Bluefruit.
[Download the latest version of CircuitPython for this board via circuitpython.org](https://circuitpython.org/board/circuitplayground_bluefruit/)
**Click the link above and download the latest UF2 file**
Download and save it to your Desktop (or wherever is handy)
Plug your Circuit Playground Bluefruit into your computer using a known-good data-capable USB cable.
**A lot of people end up using charge-only USB cables and it is very frustrating! So make sure you have a USB cable you know is good for data sync.**
Double-click the small **Reset** button in the middle of the CPB (indicated by the red arrow in the image). The ten NeoPixel LEDs will all turn red, and then will all turn green. If they turn all red and stay red, check the USB cable, try another USB port, etc. The little red LED next to the USB connector will pulse red - this is ok!
If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the rhythm right!
(If double-clicking doesn't do it, try a single-click!)
You will see a new disk drive appear called **CPLAYBTBOOT**.
Drag the **adafruit\_circuitpython\_etc.uf2** file to **CPLAYBTBOOT.**
The LEDs will turn red. Then, the **CPLAYBTBOOT** drive will disappear and a new disk drive called **CIRCUITPY** will appear.
That's it, you're done! :)
# LED Emerald with Circuit Playground Bluefruit
## Playground Color Picker
You can use your Circuit Playground Bluefruit with the [**Adafruit Bluefruit LE Connect**](https://learn.adafruit.com/adafruit-circuit-playground-bluefruit/bluefruit-le-connect) mobile app to control the NeoPixel RGB LEDs on the CPB!
## Installing Project Code
To use with CircuitPython, you need to first install a few libraries, into the lib folder on your **CIRCUITPY** drive. Then you need to update **code.py** with the example script.
Thankfully, we can do this in one go. In the example below, click the **Download Project Bundle** button below to download the necessary libraries and the **code.py** file in a zip file. Extract the contents of the zip file, open the directory **examples/** and then click on the directory that matches the version of CircuitPython you're using and copy the contents of that directory to your **CIRCUITPY** drive.
Your **CIRCUITPY** drive should now look similar to the following image:
https://github.com/adafruit/Adafruit_CircuitPython_BLE/blob/main/examples/ble_bluefruit_color_picker.py
Connect to your board through the Adafruit Bluefruit LE Connect mobile app. If you need assistance, [check out this page on installing and using the app](https://learn.adafruit.com/adafruit-circuit-playground-bluefruit/bluefruit-le-connect).
Once connected, from the device menu, tap on Controller, then Color Picker. Choose a color from the dial and tap Select (Android) or Send selected color (iOS). The LEDs will light up in the color you chose!
# LED Emerald with Circuit Playground Bluefruit
## 3D Printing
## CAD Parts List
There's three sizes of the emerald, smol, medium and large. The medium and large emeralds require a separate bracket for attaching to the PCB mount. All three sizes use the PCB mount.
- PCB-mount
[Download CAD source](https://cdn-learn.adafruit.com/assets/assets/000/109/944/original/cad.zip?1647903554)
[Download STLs.zip](https://cdn-learn.adafruit.com/assets/assets/000/109/945/original/STLs.zip?1647903566)
## PLA Filament
Use translucent PLA filament for the emeralds. This material is an off-white, often called "natrual clear" or "ivory white". It's slightly opaque and has great diffusion for LEDs.
[Purchase filament from Amazon](https://www.amazon.com/gp/product/B076Z26NS5/)
## Slice Parts
STL files for 3D printing are oriented to print "as-is" on FDM style machines. Parts are designed to 3D print without any support material.
## Slice with Brim
Use a brim when printing the top half of the emerald. It's rather thin and can get knocked off the bed while printing. A brim with a minimum of 6 lines should be suffice.
## Slice Line Width
Set the extrusion line width to 0.4mm with a line count of 2 shells. The emeralds are 1.2mm thick. This will print only 3 parameters making the walls of the model nice and clean.
## Smol Emerald Set
Dimensions are ~75mm x 75mm
- emerald-sm-top
- emerald-sm-bot
## Medium Emerald Set
Dimensions are ~120mm x 120mm
- emerald-md-top
- emerald-md-bot
- emerald-md-bracket
## Large Emerald Set
Dimensions are ~ 210mm x 210mm x 130mm
- emerald-lg-top
- emerald-lg-bot
- emerald-lg-bracket
## CAD Assembly
The CPB snap fits into the PCB mount. The PCB mount is secured to the emerald bracket using M2.5 screws and hex nuts. The emerald bracket is secured to the bottom half of the emerald using M3 screws. A small lipo battery is fitted in between the Circuit Playground and the PCB mount.
## Design Source Files
The project assembly was designed in Fusion 360. This can be downloaded in different formats like STEP, STL and more. Electronic components like Adafruit's board, displays, connectors and more can be downloaded from the [Adafruit CAD parts GitHub Repo](https://github.com/adafruit/Adafruit_CAD_Parts).
https://youtu.be/S-uFwjj4MeM
# LED Emerald with Circuit Playground Bluefruit
## Assembly
## Install Battery
Place the battery in between the built-in standoffs. The power cable should be positioned near one of the openings.
## Install Circuit Playground
Place the CPB over the mount and line up the standoffs. Orient the power port with the battery cable. Fit the pegs into the pads on the PCB. Press down to snap the tabs over the edge of the PCB.
## Secure Bracket to Mount
Place the bracket under the PCB mount and line up the four mounting holes.
Insert four M2.5 x 6mm screws into the holes. Use M2.5 hex nuts secure the bracket to the PCB mount.
## Secure Bracket to Bottom
Place the bracket over the built-in standoffs in the bottom half of the emerald.
Use M3 x 6mm machine screws to secure the bracket to the bottom half of the emerald.
## Connect Battery
Plug in the cable from the battery into the port on the Circuit Playground Bluefruit.
## Snap Fit
Get the two halves ready to snap fit together. Line up the grabbers on the bottom half with the nubs on the top half. Press together to snap fit closed.
To open, slightly squeeze together bottom half and pull halves apart.
## Congratulations on your build! 💎
## Recharging Battery over USB
Use the Adafruit Micro-Lipo Charger to recharge the battery when it gets low. Be sure to only use this charger with batteries purchased from Adafruit.
Featured
### Adafruit Micro-Lipo Charger for LiPo/LiIon Batt w/MicroUSB Jack
[Adafruit Micro-Lipo Charger for LiPo/LiIon Batt w/MicroUSB Jack](https://www.adafruit.com/product/1904)
Oh so handy, this little lipo charger is so small and easy to use you can keep it on your desk or mount it easily into any project! Simply plug it via any MicroUSB cable into a USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end....
In Stock
[Buy Now](https://www.adafruit.com/product/1904)
[Related Guides to the Product](https://learn.adafruit.com/products/1904/guides)
Featured
### Adafruit Micro-Lipo Charger for LiPoly Batt with USB Type C Jack
[Adafruit Micro-Lipo Charger for LiPoly Batt with USB Type C Jack](https://www.adafruit.com/product/4410)
Oh so handy, this little lipo charger is so small and easy to use you can keep it on your desk or mount it easily into any project! Simply plug it via any USB C cable into a USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end. There...
In Stock
[Buy Now](https://www.adafruit.com/product/4410)
[Related Guides to the Product](https://learn.adafruit.com/products/4410/guides)
## Guide Products
### Circuit Playground Bluefruit - Bluetooth® Low Energy
[Circuit Playground Bluefruit - Bluetooth® Low Energy](https://www.adafruit.com/product/4333)
**Circuit Playground Bluefruit** is our third board in the Circuit Playground series, another step towards a perfect introduction to electronics and programming. We've taken the popular Circuit Playground Express and made it even better! Now the main chip is an nRF52840...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4333)
[Related Guides to the Product](https://learn.adafruit.com/products/4333/guides)
### Lithium Ion Polymer Battery - 3.7v 500mAh
[Lithium Ion Polymer Battery - 3.7v 500mAh](https://www.adafruit.com/product/1578)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 500mAh for a total of about 1.9 Wh. If you need a larger (or smaller!) battery,
In Stock
[Buy Now](https://www.adafruit.com/product/1578)
[Related Guides to the Product](https://learn.adafruit.com/products/1578/guides)
### Lithium Ion Polymer Battery with Short Cable - 3.7V 420mAh
[Lithium Ion Polymer Battery with Short Cable - 3.7V 420mAh](https://www.adafruit.com/product/4236)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 420mAh for a total of about 1.55 Wh. If you need a larger (or smaller!) battery,
In Stock
[Buy Now](https://www.adafruit.com/product/4236)
[Related Guides to the Product](https://learn.adafruit.com/products/4236/guides)
### Lithium Ion Polymer Battery with Short Cable - 3.7V 350mAh
[Lithium Ion Polymer Battery with Short Cable - 3.7V 350mAh](https://www.adafruit.com/product/4237)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 350mAh for a total of about 1.3 Wh. If you need a larger (or smaller!) battery,
In Stock
[Buy Now](https://www.adafruit.com/product/4237)
[Related Guides to the Product](https://learn.adafruit.com/products/4237/guides)
### Adafruit Micro-Lipo Charger for LiPo/LiIon Batt w/MicroUSB Jack
[Adafruit Micro-Lipo Charger for LiPo/LiIon Batt w/MicroUSB Jack](https://www.adafruit.com/product/1904)
Oh so handy, this little lipo charger is so small and easy to use you can keep it on your desk or mount it easily into any project! Simply plug it via any MicroUSB cable into a USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end....
In Stock
[Buy Now](https://www.adafruit.com/product/1904)
[Related Guides to the Product](https://learn.adafruit.com/products/1904/guides)
### Adafruit Micro-Lipo Charger for LiPoly Batt with USB Type C Jack
[Adafruit Micro-Lipo Charger for LiPoly Batt with USB Type C Jack](https://www.adafruit.com/product/4410)
Oh so handy, this little lipo charger is so small and easy to use you can keep it on your desk or mount it easily into any project! Simply plug it via any USB C cable into a USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end. There...
In Stock
[Buy Now](https://www.adafruit.com/product/4410)
[Related Guides to the Product](https://learn.adafruit.com/products/4410/guides)
### Black Nylon Machine Screw and Stand-off Set – M2.5 Thread
[Black Nylon Machine Screw and Stand-off Set – M2.5 Thread](https://www.adafruit.com/product/3299)
Totaling 380 pieces, this **M2.5 Screw Set** is a must-have for your workstation. You'll have enough screws, nuts, and hex standoffs to fuel your maker tendencies for days on end! M2.5 size screws fit almost all of the Adafruit breakout/dev board mounting holes...
In Stock
[Buy Now](https://www.adafruit.com/product/3299)
[Related Guides to the Product](https://learn.adafruit.com/products/3299/guides)
### USB cable - USB A to Micro-B
[USB cable - USB A to Micro-B](https://www.adafruit.com/product/592)
This here is your standard A to micro-B USB cable, for USB 1.1 or 2.0. Perfect for connecting a PC to your Metro, Feather, Raspberry Pi or other dev-board or microcontroller
Approximately 3 feet / 1 meter long
In Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
## Related Guides
- [Adafruit Circuit Playground Bluefruit](https://learn.adafruit.com/adafruit-circuit-playground-bluefruit.md)
- [Busy Box Interruption Sign](https://learn.adafruit.com/busy-box-interruption-sign.md)
- [No-Solder LED Disco Tie with Bluetooth](https://learn.adafruit.com/no-solder-circuit-playground-bluetooth-disco-tie.md)
- [Circuit Playground Express Rocket Lamp](https://learn.adafruit.com/cpx-rocket-lamp.md)
- [OSHWA Project Display With Adafruit MagTag](https://learn.adafruit.com/oshwa-project-display-with-adafruit-magtag.md)
- [PyPortal NeoPixel Color Picker](https://learn.adafruit.com/pyportal-neopixel-color-picker.md)
- [Program CircuitPython USB Devices with iPhone & iPad](https://learn.adafruit.com/use-circuitpython-devices-with-iphone-ipad.md)
- [Bunny Ears with MakeCode](https://learn.adafruit.com/bunny-ears-with-makecode.md)
- [PyPortal Smart Thermometer with Analog Devices ADT7410, Adafruit IO and CircuitPython](https://learn.adafruit.com/pyportal-smart-thermometer-with-analog-devices-adt7410-adafruit-io-and-circuitpython.md)
- [Modal MIDI Keyboard](https://learn.adafruit.com/modal-midi-keyboard.md)
- [CircuitPython BLE Controlled NeoPixel Hat](https://learn.adafruit.com/circuitpython-feather-ble-neopixel-hat.md)
- [CRICKIT Exhibit Demo Board](https://learn.adafruit.com/crickit-exhibit-demo-board.md)
- [MagicLight Bulb Color Mixer with Circuit Playground Bluefruit](https://learn.adafruit.com/magiclight-bulb-mixer.md)
- [Living Ventriloquist Dummy with MONSTER M4SK Eyes](https://learn.adafruit.com/living-ventriloquist-dummy-with-monster-m4sk-eyes.md)
- [PyPortal LIFX Lighting Controller ](https://learn.adafruit.com/pyportal-lifx-lighting-controller.md)
- [IoT Motion and Temperature Logger with the Analog Devices ADXL343 + ADT7410 Sensor FeatherWing and Adafruit IO](https://learn.adafruit.com/iot-motion-and-temperature-sensor-with-adxl343-adt7410-sensor-featherwing-and-adafruit-io.md)