The purpose of this guide is get you up and running with an MSP432P401R LaunchPad, the Seeed Studio Grove BoosterPack, and several Grove modules. This is one of the easy ways to get started with electronics, sensors, and programming with TI technology
LaunchPad is an ecosystem of low-cost, powerful, and easy-to-use microcontroller development kits from Texas Instruments.
Add-on boards called BoosterPacks add functionality to the LaunchPad development kits like Wi-Fi, motor control, sensing, and displays.
Grove modules are low-cost sensors, actuators, and displays from Seeed Studio that let you rapidly prototype. They use a standard cable and plug and connect to the LaunchPad with the Grove BoosterPack.
Arduino is a popular programming language used for rapid prototyping or teaching someone how to program. Texas Instruments has its own variant called Energia. Energia runs Arduino code on TI family of microcontrollers.
Lab 1 - Installing Energia
For this workshop we will use the Energia IDE to write code and program the LaunchPad. Energia is very similar to the Arduino IDE but is written specifically for TI LaunchPad boards.Before we begin, please ensure you:
- Go to this link to download the Energia IDE (DO NOT download it from energia.nu)
- Windows Users:
- Download and install both programs:
energia-1.8.7E21-windows-installer-v2.exe
energia_driverpack_windows-v1.0.0.exe
- Mac Users:
- Download and install both programs:
energia-1.8.7E21-osx-installer-v2.app.zip
To make sure Energia is installed properly and that your LaunchPad is working, we will flash a program to the LaunchPad called "Blink" that will just blink an LED.
Lab 2 - Installing Workshop Library1. Jump to the Code section at the bottom of this page. Hit the download button that is on the right side.
2. This should download a file called Getting_Started_Workshop_Library.zip.
3. Open Energia and go to Sketch -> Include Library -> Add .ZIP Library.
6. In the window that pops up find and select "Getting_Started_Workshop_Library.zip" which you previously downloaded.
Instructions:
- 1. Plug in your LaunchPad with the supplied USB cable.
- 2. From the Tools menu at the top of the window, select Boards -> MSP432 LaunchPad.
From the Tools menu at the top of the window, select Serial Port, and then pick the serial port associated with your MSP432 Launchpad.
- From the File menu at the top of the window, select Examples -> 01. Basics -> Blink. This will open the blink example program.
Examine the code to see the basic structure of the program.
- All Energia programs have two required functions: setup() and loop(). Setup is run one at startup and then loop runs continuously.
- PinMode is used to set the direction of a GPIO.
- DigitalWrite is used to set the state of a GPIO.
- Delay pauses execution for a given number of milliseconds.
Click the red arrow pointing to the right at the top left of the Energia window. This will compile and upload your program to the board.
After programming completes verify that the red LED is blinking on your LaunchPad. To take this a step further try:
- Fading the LEDs by changing the calls from digitalWrite to analogWrite.
- Try using the other colored LEDs on the board (RED_LED and GREEN_LED).
We will be using 4 different Grove modules for this workshop
- Temperature sensor (connected to J6)
- Ultrasonic sensor (connected to J5)
- Buzzer (connected to J13)
- 4 Digit Display (connected to J14)
Now connect the wire between each sensor and the correct port on the booster pack. Boosterpack to wire connection
Sensor to wire connection
Make sure each sensor is connected to the right port on the Boosterpack as indicated by the arrows below. Finally connect the Boosterpack to the Launchpad. Make sure the orientation matches what you see below. Becareful so no pins are damaged during the process.
Next, we need to install a couple of libraries from Seeed Studio to make the modules work.
Lab 5 - Buzzer TonesWith a buzzer present, of course we have to play some tunes. We will make use of the tone API in Energia. In Energia, go to File->Examples->Workshop_Grove->Buzzer->Happy_Birthday. You will need to scroll down in the menu to see Workshop-Grove.
Then click the Upload button in Energia that looks like an arrow pointing to the right.
Below shows the code you will be running.
/*
Grove - Birthday Tune
Play birthday tune through the buzzer, demonstrating
buzzer tune() API and pitch/tone (hence music) generation
Dec 2012 - Created for Educational BoosterPack
buzzer Pin = 19
Dec 2013 - Modified for Educational BoosterPack MK II
buzzer Pin = 40
Jun 2016 - Modified for Grove Buzzer
buzzer Pin = 40
by Dung Dang
*/
/*************************************************
* Public Constants
*************************************************/
#define NOTE_B0 31
#define NOTE_C1 33
#define NOTE_CS1 35
#define NOTE_D1 37
#define NOTE_DS1 39
#define NOTE_E1 41
#define NOTE_F1 44
#define NOTE_FS1 46
#define NOTE_G1 49
#define NOTE_GS1 52
#define NOTE_A1 55
#define NOTE_AS1 58
#define NOTE_B1 62
#define NOTE_C2 65
#define NOTE_CS2 69
#define NOTE_D2 73
#define NOTE_DS2 78
#define NOTE_E2 82
#define NOTE_F2 87
#define NOTE_FS2 93
#define NOTE_G2 98
#define NOTE_GS2 104
#define NOTE_A2 110
#define NOTE_AS2 117
#define NOTE_B2 123
#define NOTE_C3 131
#define NOTE_CS3 139
#define NOTE_D3 147
#define NOTE_DS3 156
#define NOTE_E3 165
#define NOTE_F3 175
#define NOTE_FS3 185
#define NOTE_G3 196
#define NOTE_GS3 208
#define NOTE_A3 220
#define NOTE_AS3 233
#define NOTE_B3 247
#define NOTE_C4_1 260
#define NOTE_C4 262
#define NOTE_CS4 277
#define NOTE_D4 294
#define NOTE_DS4 311
#define NOTE_E4 330
#define NOTE_F4 349
#define NOTE_FS4 370
#define NOTE_G4 392
#define NOTE_GS4 415
#define NOTE_A4 440
#define NOTE_AS4 466
#define NOTE_B4 494
#define NOTE_C5 523
#define NOTE_CS5 554
#define NOTE_D5 587
#define NOTE_DS5 622
#define NOTE_E5 659
#define NOTE_F5 698
#define NOTE_FS5 740
#define NOTE_G5 784
#define NOTE_GS5 831
#define NOTE_A5 880
#define NOTE_AS5 932
#define NOTE_B5 988
#define NOTE_C6 1047
#define NOTE_CS6 1109
#define NOTE_D6 1175
#define NOTE_DS6 1245
#define NOTE_E6 1319
#define NOTE_F6 1397
#define NOTE_FS6 1480
#define NOTE_G6 1568
#define NOTE_GS6 1661
#define NOTE_A6 1760
#define NOTE_AS6 1865
#define NOTE_B6 1976
#define NOTE_C7 2093
#define NOTE_CS7 2217
#define NOTE_D7 2349
#define NOTE_DS7 2489
#define NOTE_E7 2637
#define NOTE_F7 2794
#define NOTE_FS7 2960
#define NOTE_G7 3136
#define NOTE_GS7 3322
#define NOTE_A7 3520
#define NOTE_AS7 3729
#define NOTE_B7 3951
#define NOTE_C8 4186
#define NOTE_CS8 4435
#define NOTE_D8 4699
#define NOTE_DS8 4978
int buzzerPin = 40;
// notes in the melody:
int melody[] = {
NOTE_C4_1,NOTE_C4, NOTE_D4, NOTE_C4,NOTE_F4,NOTE_E4,
NOTE_C4_1,NOTE_C4,NOTE_D4,NOTE_C4,NOTE_G4,NOTE_F4,
NOTE_C4_1,NOTE_C4,NOTE_C5,NOTE_A4,NOTE_F4,NOTE_F4, NOTE_E4,NOTE_D4,
NOTE_AS4,NOTE_AS4,NOTE_A4,NOTE_F4,NOTE_G4,NOTE_F4};
// note durations: 4 = quarter note, 8 = eighth note, etc.:
int noteDurations[] = {
4, 4, 2, 2,2,1,
4, 4, 2, 2,2,1,
4, 4, 2, 2,4,4,2,1,
4, 4, 2, 2,2,1};
void setup()
{
pinMode(buzzerPin,OUTPUT);
}
void loop()
{
for (int thisNote = 0; thisNote < 26; thisNote++) {
// to calculate the note duration, take one second
// divided by the note type.
//e.g. quarter note = 1000 / 4, eighth note = 1000/8, etc.
int noteDuration = 1000/noteDurations[thisNote];
tone(buzzerPin, melody[thisNote],noteDuration);
int pauseBetweenNotes = noteDuration + 50; //delay between pulse
delay(pauseBetweenNotes);
noTone(buzzerPin); // stop the tone playing
}
while(1);
}
Now we are going to combine two other sensors. A ultrasonic distance sensor and a LED display. In Energia, go to File->Examples->Workshop_Grove->Multiple->Distance_Display. You will need to scroll down in the menu to see Workshop-Grove.
Then click the Upload button in Energia that looks like an arrow pointing to the right.
Below shows the code you will be running.
#include "TM1637.h"
#include "Ultrasonic.h"
/* Macro Define */
#define CLK 39 /* 4-digital display clock pin */
#define DIO 38 /* 4-digiral display data pin */
#define BLINK_LED RED_LED /* blink led */
#define ULTRASONIC_PIN 23 /* pin of the Ultrasonic Ranger */
/* Global Varibles */
TM1637 tm1637(CLK, DIO); /* 4-digital display object */
Ultrasonic ultrasonic(ULTRASONIC_PIN); /* Ultrasonic Ranger object */
int distance = 0; /* varible to store the distance to obstacles in front */
int blink_interval = 0; /* led delay time */
int8_t bits[4] = {0}; /* array to store the single bits of the value */
/* the setup() method runs once, when the sketch starts */
void setup() {
/* Initialize 4-digital display */
tm1637.init();
tm1637.set(BRIGHT_TYPICAL);
/* declare the red_led pin as an OUTPUT */
pinMode(RED_LED, OUTPUT);
}
/* the loop() method runs over and over again */
void loop() {
distance = ultrasonic.MeasureInCentimeters(); /* read the value from the sensor */
memset(bits, 0, 4); /* reset array when we use it */
for(int i = 3; i >= 0; i--) {
/* get single bits of the analog value */
bits[i] = distance % 10;
distance = distance / 10;
tm1637.display(i, bits[i]); /* display by 4-digital display */
}
delay(100);
}
That is a good sample of basic prototyping with TI LaunchPad. There is obviously a lot more to do with other Grove modules. There are also many hardware combinations to try. You can learn more about the TI LaunchPad ecosystem at www.ti.com/launchpad and explore the Energia website at www.energia.nu for more ideas and help.
Comments