ENERGIA-TUTORIAL-KIT

All components needed for Energia tutorials

using Texas Instruments LaunchPad Evaluation
Kits and BoosterPack Plug-in Modules in one Box!

ENERGIA-TUTORIAL-KIT
Doc ID: ENERGIAKITUM
Rev. 0.1, 09/18/2013

CONTENTS
1

Introduction ...........................................................................................................................................................3
1.1

What is Energia ............................................................................................................................................3

Kit Contents ...........................................................................................................................................................4

Energia Tutorials ....................................................................................................................................................5

3.1

Core Functions .............................................................................................................................................5

3.1.1

Basics .......................................................................................................................................................5

3.1.2

Digital .......................................................................................................................................................5

3.1.3

Analog ......................................................................................................................................................5

3.1.4

Communication........................................................................................................................................6

3.1.5

Control Structures ....................................................................................................................................6

3.1.6

Strings ......................................................................................................................................................7

LIST OF TABLES
Table 1-1 Component List ..............................................................................................................................................4

2013 Premier Farnell plc. All Rights Reserved

ENERGIA-TUTORIAL-KIT
Doc ID: ENERGIAKITUM
Rev. 0.1, 09/18/2013

1 INTRODUCTION
The ENERGIA-TUTORIAL-KIT provides all components needed for Energia tutorials using Texas
Instruments LaunchPad Evaluation Kits and BoosterPack Plug-in Modules in one Box! This kit can be
ordered at www.newark.com order code 07X0640.

1.1 WHAT IS ENERGIA

Energia is an open-source electronics prototyping platform started by Robert Wessels in January of 2012
with the goal to bring the Wiring and Arduino framework to the Texas Instruments MSP430 based
LaunchPad. Energia uses the mspgcc compiler by Peter Bigot and is based on the Wiring and Arduino
framework. Energia includes an integrated development environment (IDE) that is based on Processing.
Energia started out to bring the Wiring and Arduino framework to the Texas Instruments MSP430
LaunchPad. The LaunchPad is a low-cost microcontroller board. Texas Instruments (TI) offers a MSP430,
Tiva C and C2000 LaunchPad.
Each LaunchPad is created to provide everything you need to get started with microcontroller
development. All LaunchPad boards feature on-board emulation for programming and debugging code,
push buttons and LEDs, as well as a consistent connector that accepts plug-in BoosterPack modules, to
help add new functionality such as wireless connectivity, LEDs, sensors, and more to the LaunchPad.
The latest release of Energia supports the MSP-EXP430G2, MSP-EXP430FR5739 and Tiva C Series EKTM4C123GXL LaunchPads with support for the C2000 base LAUNCHXL-F28027 LaunchPad coming soon.
Together with Energia, LaunchPad can be used to develop interactive objects, taking inputs from a
variety of switches or sensors, and controlling a variety of lights, motors, and other physical outputs.
LaunchPad projects can be stand-alone (only run on the Target Board, i.e. LaunchPad), or they can
communicate with software running on your computer (Host PC).
More information about LaunchPads can be found on www.element14.com/launchpad
or www.ti.com/launchpad

2013 Premier Farnell plc. All Rights Reserved

ENERGIA-TUTORIAL-KIT
Doc ID: ENERGIAKITUM
Rev. 0.1, 09/18/2013

2 KIT CONTENTS
The ENERGIA-TUTORIAL-KIT consists of a number of components including LEDs, resistors and a
breadboard and wires for easy connectivity and testing of the examples as listed in the tutorials.

TABLE 2-1 COMPONENT LIST

MPN
WK-3
GS-400
MCKPT-G3018-3939
MCKP2415SP2-4744
MCDTS6-1N
30-81794
HDSP-303G
MCL034BT
MCL034GT
MCL034MT
MCL034SBLC
MCL034YT
SSL-LX5097SISGSYC
MCDTS6-2N
3352T-1-103LF
VT90N1
MCCFR0W8J0101A20
MCCFR0W8J0103A20
MCCFR0W8J0104A20
MCCFR0W4J0221A50
MCCFR0W8J0331A20
MCCFR0W8J0332A20
MCCFR0W8J0471A20
MCCFR0W8J0102A20
MCCFR0W8J0472A20

2013 Premier Farnell plc. All Rights Reserved

Newark PN Component
10R0135 400 Tie Point Breadboard
74R1718 70pcs jumper assortment kit
25R0846 Piezo Buzzer
25R0924 8 ohm Piezo speaker
26M1122 Tact Switch
07X0631 Force Sensing Resistor
43K6981 7-segment display
14N9373 3mm Amber LED
14N9375 3mm Green LED
14N9379 3mm Red LED
14N9384 3mm Blue LED
14N9395 3mm Yellow LED
77M1652 RGB LED - 5mm
80K0985 Tact Switch
32K8161 10K Potentiometer
99F4265 200K LDR
58K5082 100 ohm, 1/8W, +-5%
58K5083 10K ohm, 1/8W, +-5%
58K5084 100K ohm, 1/8W, +-5%
58K5029 220 ohm, 1/8W, +-5%
58K5112 330 ohm, 1/8W, +-5%
58K5113 3.3K ohm, 1/8W, +-5%
58K5123 470 ohm, 1/8W, +-5%
59K8413 1K ohm, 1/8W, +-5%
59K8483 4.7K ohm, 1/8W, +-5%

Qty
1
1
1
1
1
1
1
2
2
2
2
2
2
2
3
3
10
10
10
10
10
10
10
10
10

ENERGIA-TUTORIAL-KIT
Doc ID: ENERGIAKITUM
Rev. 0.1, 09/18/2013

3 ENERGIA TUTORIALS
The components provided in the kit can be used to test one or more of the Energia Tutorials listed
below. More information about Energia can be found at www.energia.nu

3.1 CORE FUNCTIONS

Simple programs that demonstrate basic Energia commands. These are included with the Energia
environment; to open them, click the Open button on the toolbar and look in the examples folder.
3.1.1

BASICS

BareMinimum : The bare minimum of code needed to start an Energia sketch.

Blink: Turn an LED on and off.

DigitalReadSerial: Read a switch, print the state out to the Energia Serial Monitor.

AnalogReadSerial: Read a potentiometer, print it's state out to the Energia Serial Monitor.

Fade: Demonstrates the use of analog output to fade an LED.

ReadAnalogVoltage : Reads an analog input and prints the voltage to the serial monitor

3.1.2

DIGITAL

Blink Without Delay: blinking an LED without using the delay() function.

Button: use a pushbutton to control an LED.

Debounce: read a pushbutton, filtering noise.

Button State Change: counting the number of button pushes.

Input Pullup Serial: Demonstrates the use of INPUT_PULLUP with pinMode().

Tone: play a melody with a Piezo speaker.

Pitch follower: play a pitch on a piezo speaker depending on an analog input.

Simple Keyboard: a three-key musical keyboard using force sensors and a piezo speaker.

Tone4: play tones on multiple speakers sequentially using the tone() command.

3.1.3

ANALOG

AnalogInOutSerial: read an analog input pin, map the result, and then use that data to dim or
brighten an LED.

Analog Input: use a potentiometer to control the blinking of an LED.

AnalogWrite: fade 7 LEDs on and off, one by one, using an MSP430G2 LaunchPad board.

Calibration: define a maximum and minimum for expected analog sensor values.

Fading: use an analog output (PWM pin) to fade an LED.

Smoothing: smooth multiple readings of an analog input.

2013 Premier Farnell plc. All Rights Reserved

ENERGIA-TUTORIAL-KIT
Doc ID: ENERGIAKITUM
Rev. 0.1, 09/18/2013

3.1.4

COMMUNICATION

These examples include code that allows the LaunchPad to talk to Processing sketches running
on the computer. For more information or to download Processing, see processing.org.

ReadASCIIString: parse a comma-separated string of ints to fade an LED

ASCII Table: demonstrates Energia's advanced serial output functions.

Dimmer: move the mouse to change the brightness of an LED.

Graph: send data to the computer and graph it in Processing.

Physical Pixel: turn a LED on and off by sending data to your LaunchPad from Processing.

Virtual Color Mixer: send multiple variables from LaunchPad to your computer and read them in
Processing.

Serial Call Response: send multiple vairables using a call-and-response (handshaking) method.

Serial Call Response ASCII: send multiple variables using a call-and-response (handshaking) method,
and ASCII-encode the values before sending.

SerialEvent: Demonstrates the use of SerialEvent().

Serial input (Switch (case) Statement): how to take different actions based on characters received by
the serial port.

MIDI: send MIDI note messages serially.

MultiSerial: use two of the serial ports available on the LaunchPad.

3.1.5

CONTROL STRUCTURES

If Statement (Conditional): how to use an if statement to change output conditions based on

changing input conditions.

For Loop: controlling multiple LEDs with a for loop.

Array: a variation on the For Loop example that demonstrates how to use an array.

While Loop: how to use a while loop to calibrate a sensor while a button is being read.

Switch Case: how to choose between a discrete number of values. Equivalent to multiple If
statements. This example shows how to divide a sensor's range into a set of four bands and to take
four different actions depending on which band the result is in.

Switch Case 2: a second switch-case example, showing how to take different actions based in
characters received in the serial port.

2013 Premier Farnell plc. All Rights Reserved

ENERGIA-TUTORIAL-KIT
Doc ID: ENERGIAKITUM
Rev. 0.1, 09/18/2013

3.1.6

STRINGS

StringAdditionOperator: add strings together in a variety of ways.

StringAppendOperator: append data to strings.

StringCaseChanges: change the case of a string.

StringCharacters: get/set the value of a specific character in a string.

StringComparisonOperators: compare strings alphabetically.

StringConstructors: how to initialize string objects.

StringIndexOf: look for the first/last instance of a character in a string.

StringLength & StringLengthTrim: get and trim the length of a string.

StringReplace: replace individual characters in a string.

StringStartsWithEndsWith: check which characters/substrings a given string starts or ends with.

StringSubstring: look for "phrases" within a given string.

2013 Premier Farnell plc. All Rights Reserved