https://learn.adafruit.com/halo-energy-sword/code
The project’s basic flow is: write or open the sketch in Arduino IDE → compile and upload it to the Feather board → use the phone app over Bluetooth to control the NeoPixel LEDs. The sword’s Feather board runs the program and drives the LED strips inside the blades.
| Term | Plain meaning | How it’s used in this project |
|---|---|---|
| Sketch | Arduino’s name for a program. It’s code, despite the word sounding like a drawing. | The guide’s sketch tells the Feather how to receive Bluetooth controls and run LED effects. You open it in Arduino IDE and upload it to the board. |
| Arduino IDE | The computer program used to work with Arduino-compatible boards. IDE means “integrated development environment.” | Use it to open the sketch, select the Feather board and connection port, and upload the program. |
| Library | Reusable code that adds support for a device or feature. | The guide calls for the Adafruit BluefruitLE nRF51 library for Bluetooth and the Adafruit NeoPixel library for controlling the LEDs. |
| Library Manager | A tool in Arduino IDE for finding and installing libraries. | Install the sketch’s required libraries here, or use the guide’s manual installation instructions. |
| Board package | The files Arduino IDE needs to recognize and program a family of boards. | The guide says to install Adafruit AVR Boards so Arduino IDE can work with the Feather 32u4. |
| Compile | Translate the sketch into a form the board can run; Arduino IDE does this as part of uploading. | If the code or required libraries are missing or incompatible, compilation can fail before the program reaches the Feather. |
| Upload | Transfer the compiled program from the computer to the board. | Connect the Feather over USB, choose its board and port in Arduino IDE, then upload the sketch. |
| Port / serial port | The computer’s connection to the board over USB. | Choose the port associated with the Feather so Arduino IDE knows where to send the program. |
| Prototype | Build a temporary or test version before final assembly. | The guide recommends testing the circuit and LED strips before enclosing the electronics in the sword. |
| Term | Plain meaning | How it’s used in this project |
|---|---|---|
| Microcontroller | A small computer built to control electronic devices. | The Feather’s microcontroller runs the sketch and controls the LEDs. |
| Feather 32u4 Bluefruit LE | The Adafruit controller board used in the build. | It runs the code, communicates with the phone, and sends control data to the NeoPixel strips. |
| AVR | A family of microcontroller chips. | “Adafruit AVR Boards” is the Arduino IDE package the guide specifies for programming this Feather. |
| Bluetooth LE / BLE | Bluetooth Low Energy, a wireless connection designed for low power. | The phone app sends color and animation choices to the sword’s Feather over BLE. |
| Peripheral | In a Bluetooth connection, a device that advertises itself so another device can connect to it. | The app’s peripheral list is where you select the Adafruit Bluefruit LE board. |
| Controller | In the app, a screen for sending commands to the board. | The guide uses the app’s Control Pad for animation buttons and Color Picker for color and brightness. |
| NeoPixel | Adafruit’s name for individually controllable RGB LED products. | The strips inside the blades can display colors and animations controlled by the Feather. |
| RGB | Red, green, and blue—the three color channels used to mix LED colors. | The app’s Color Picker lets you change the RGB values sent to the LEDs. |
| Brightness | How intense or dim the LEDs appear. | The Color Picker can adjust the sword’s LED brightness. |
| Effect | What it looks like |
|---|---|
| Larson scanner | A bright section sweeps back and forth, like a scanning light. |
| Color wipe | A color fills the LEDs one by one along the strip. |
| Rainbow gradient | A range of rainbow colors appears across the LEDs. |
| Rainbow cycle | Rainbow colors move or cycle through the LEDs over time. |
The code page appears to contain wording carried over from another project: it calls the program a “Daftpunk BLE sketch” and mentions LEDs on a “visor,” while the Energy Sword overview describes LED strips inside the sword blades. The sword-specific overview and circuit page are the better references for what the hardware does.
One practical caveat: Adafruit marks the guide as potentially outdated and says it may need code or hardware changes. Its IDE and board-package versions are historical references, so don’t assume those old version numbers are the right ones to install today.