Published February 3, 2016

MIT IAP 2016 Lab

A collection of the 6 labs for the MIT IAP Texas Instruments LaunchPad Workshop

Things used in this project

Story

MIT IAP LaunchPad Lab

Welcome to the IAP IoT Fest 2016 with Texas instruments! This page will walk you through all the labs and should point you to all the resources you need to start hacking with TI hardware and the IoT.

Useful links:

Energia installation guide

Energia API reference guide

MSP432 Pinmap

CC3100 Pinmap

Educational BoosterPack MKII Pinmap

SideKick Guide

Lab 0: Blink an LED

The goal of this lab is to verify the hardware and software is setup correctly and to give the student a first taste of rapid prototyping in Energia.

1. Plug in your LaunchPad with the supplied USB cable.

2. Open Energia.

3. From the Tools menu at the top of the window, select Boards -> LaunchPad w/ MSP432 EMT (48MHz).

4. From the Tools menu at the top of the window, select Serial Port, and then pick the serial port associated with your MSP432 Launchpad.

5. From the File menu at the top of the window, select Examples -> 01. Basics -> Blink. This will open the blink example program.

6. Examine the code to see the basic structure of the program.

a. All Energia programs have two required functions: setup() and loop().

i. Setup() is run once at startup

ii. Loop() runs continuously after that

b. pinMode is used to set the direction of a GPIO.

c. digitalWrite is used to set the state of a GPIO.

d. delay pauses execution for a given number of milliseconds.

7. 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.

8. After programming completes verify that the red LED is blinking on your LaunchPad.

9. To take this a step further try:

a. Fading the LEDs by changing the calls from digitalWrite to analogWrite.

b. Try using the other colored LEDs on the board

i. RED_LED

ii. GREEN_LED

iii. BLUE_LED

Lab 1: Side Kick

This lab is hosted on the Energia website here:

http://energia.nu/guide/sidekick/sidekick_pushbutton/

The purpose of this lab is get acquainted with the SideKick BoosterPack and loose components kit from SEEED Studios. Addional labs and resources can be found here: http://energia.nu/guide/sidekick/

Lab 2: Educational BoosterPack MKII Sensors

Educational BoosterPack MkII

The goal of this lab is to familiarize the student with the concept of a BoosterPack and how software libraries can speed development of advanced applications.

1. Plug the Educational BoosterPack MKII into the LaunchPad’s BoosterPack headers.

2. From the File menu at the top of the window, select Examples -> 09.EducationalBP_MKII -> AccelerometerLED

3. Read through the code. There is a line you will need to comment in in order to change the ADC resolution so the example works correctly. Comment in this line before proceeding to the next step.

4. 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.

5. Verify the color of the RGB LED changes when you tilt the board.

6. Select Examples->09.EducationalBP_MKII ->OPT3001_Demo and Examples->09.EducationalBP_MKII ->TMP006 to see some other sensors on the Educational BoosterPack.

7. Use the Magnifying Glass icon in the upper right corner to open a serial COM. The sensor data will be displayed here.

8. Experiment with other examples for the Educational BoosterPack. Trying combining multiple examples to build a full application.

a. This time is meant to be free form so you can experiment and learn on your own.

b. If you wish to try one of the LCD examples you'll need to drop

the Screen_HX8353E.cpp (found at the bottom of this page) file into:

\energia-0101E0016\hardware\msp432\libraries\EduBPMKII_Screen

Lab 3: Grove Starter Kit for LaunchPad

Grover Starter Kit for LaunchPad

Grove Starter Kit for LaunchPad is a co-branded quick starter kit for Texas Instruments LaunchPad Development Kits. This kit carries one Grove Base BoosterPack and 10 carefully selected Groves modules. It enables users of the Texas Instruments Launchpad to rapidly prototype and hack together fun microcontroller-based projects.

1. Plug the Grove Base BoosterPack on top of the MSP432 LaunchPad

2. Connect the Light Sensor to J6(A) and the 4-Digit Display to J14(D), as shown below

a. The left side of the BoosterPack is for analog inputs (0V-3.3V)

b. The right side of the BoosterPack is for digital inputs and outputs

c. The top of the board has SPI, I2C, and UART serial communications connections

caption (optional)

3. Download the Grove Starter Kit code here (click download ZIP) and unzip the folder. To use this library, add the GroveModulesLib folder to \Documents\Energia\Libraries and add the Grove_Modules_Examples folder to \Documents\Energia

4. Close and restart Energia

5. Select Sketchbook->Grove_Modules_Examples->Light_Sensor

6. In the setup() function, add the line analogReadResolution(12); to increase the resolution of the ADC.

7. Click the red "Run" arrow to compile the program and download it to the LaunchPad

6. Try out the other Grove modules in the Sketchbook->Grove_Modules_Examples menu. Try combining 3-4 modules to create a full application!

More info here: http://energia.nu/guide/grove-starter-kit/grove_sensingthelight/

Lab 4: MSP432 + Wi-Fi (CC3100) and Temboo

1. Plug the CC3100 BoosterPack into the bottom of the LaunchPad. The stack should now be:

a. Educational BoosterPack MKII

b. MSP432 LaunchPad

c. CC3100 BoosterPack

2. Create a new program in Energia (File -> New)

3. Go to your Temboo account and navigate to the Yahoo choreos, then click Weather and choose "GetWeatherByAddress"

4. Make sure "IoT Mode" is turned ON

5. In the Input section, type your address in the Address field and click the Run button to test the Choreo

a. You can expand "Optional Inputs" to change the units to Fahrenheit

6. Create a new program in Energia (File->New)

7. At the bottom of the page, copy the generated Code into the new Energia sketch.

8. Create a new tab in Energia by clicking the Arrow on the right side of the toolbar, and selecting "New Tab"

a. Name this tab TembooAccount.h

b. Copy the Header File from tembo into this new tab. Be sure to change the Wi-Fi SSID and Password.

9. Click the run arrow, and open the serial COM. You should see the weather condition print over serial.

10. Try some advanced features of Temboo like the ability to trigger a Choreo based on a hardware event, or to trigger a hardware event based on a Choreo

a. Is this Choreo triggered by a sensor event?

b. Should an output trigger a hardware event?

1 / 2 • Trigger a Choreo based on an input

11. Try some other Choreos. Here are some that I suggest:

a. Nexmo - send and receive SMS, place phone calls

b. Twitter

c. Wolfram Alpha

Lab 5: Pulling it all Together

In this lab, we will use the same setup from the previous lab, but send the sensor data we receive over an IoT protocol called MQTT. MQTT is a publish-subscribe based lightweight messaging protocol for use on top of the TCP/IP protocol. It is designed for connections with remote locations where a "small code footprint" is required or the network bandwidth is limited.

MQTT is perfect for IoT applications because many devices can publish data to a common place and many devices can read that same data from a common place.

We are also going to introduce a new concept called Energia MT, or Multi Tasking. Energia MT lets us write a sketch in parallel on a single device.

The full instructions for Lab 4 can be found here.

//
// Screen_HX8353E.cpp
// Library C++ code
// ----------------------------------
// Developed with embedXcode
// http://embedXcode.weebly.com
//
// Project new_screen_HX8353
//
// Created by Rei VILO, mars 07, 2013 09:21
// embedXcode.weebly.com
//
// Apr 25, 2014
// Support for new LaunchPads with
// . MSP430F5529
// . LM4F120H5QR TM4C123GH6PM
// . TM4C1294NCPDT TM4C1294XNCZAD
//
//
// Copyright  Rei VILO, 2013-2014
// License CC = BY NC SA
//
// See Screen_HX8353E.h and ReadMe.txt for references
//
// Library header
#include "Screen_HX8353E.h"
///
#define HX8353E_WIDTH  128
#define HX8353E_HEIGHT 128
#define HX8353E_MADCTL_MY  0x80
#define HX8353E_MADCTL_MX  0x40
#define HX8353E_MADCTL_MV  0x20
#define HX8353E_MADCTL_ML  0x10
#define HX8353E_MADCTL_RGB 0x08
#define HX8353E_MADCTL_MH  0x04
#define HX8353E_NOP     0x00
#define HX8353E_SWRESET 0x01
#define HX8353E_RDDID   0x04
#define HX8353E_RDDST   0x09
#define HX8353E_SLPIN   0x10
#define HX8353E_SLPOUT  0x11
#define HX8353E_PTLON   0x12
#define HX8353E_NORON   0x13
#define HX8353E_INVOFF  0x20
#define HX8353E_INVON   0x21
#define HX8353E_GAMSET  0x26
#define HX8353E_DISPOFF 0x28
#define HX8353E_DISPON  0x29
#define HX8353E_CASET   0x2A
#define HX8353E_RASET   0x2B
#define HX8353E_RAMWR   0x2C
#define HX8353E_RGBSET  0x2d
#define HX8353E_RAMRD   0x2E
#define HX8353E_PTLAR   0x30
#define HX8353E_MADCTL  0x36
#define HX8353E_COLMOD  0x3A
#define HX8353E_SETPWCTR 0xB1
#define HX8353E_SETDISPL 0xB2
#define HX8353E_FRMCTR3  0xB3
#define HX8353E_SETCYC   0xB4
#define HX8353E_SETBGP   0xb5
#define HX8353E_SETVCOM  0xB6
#define HX8353E_SETSTBA  0xC0
#define HX8353E_SETID    0xC3
#define HX8353E_GETHID   0xd0
#define HX8353E_SETGAMMA 0xE0
Screen_HX8353E::Screen_HX8353E() {
#if defined(__LM4F120H5QR__) || defined(__MSP430F5529__) || defined(__TM4C123GH6PM__) || defined(__TM4C1294NCPDT__) || defined(__TM4C1294XNCZAD__) || defined(__MSP432P401R__)
    _pinReset          = 17;
    _pinDataCommand    = 31;
    _pinChipSelect     = 13;
    _pinBacklight      = NULL;
#else
#error Platform not supported
#endif
}
Screen_HX8353E::Screen_HX8353E(uint8_t resetPin, uint8_t dataCommandPin, uint8_t chipSelectPin, uint8_t backlightPin)
{
    _pinReset = resetPin;
    _pinDataCommand = dataCommandPin;
    _pinChipSelect = chipSelectPin;
    _pinBacklight = backlightPin;
};
void Screen_HX8353E::begin()
{
#if defined(__LM4F120H5QR__)
    SPI.setModule(2);
#endif
    SPI.begin();
    SPI.setClockDivider(SPI_CLOCK_DIV2);
    SPI.setBitOrder(MSBFIRST);
    SPI.setDataMode(SPI_MODE0);
    if (_pinReset!=NULL) pinMode(_pinReset, OUTPUT);
    if (_pinBacklight!=NULL) pinMode(_pinBacklight, OUTPUT);
    pinMode(_pinDataCommand, OUTPUT);
    pinMode(_pinChipSelect, OUTPUT);
    if (_pinBacklight!=NULL) digitalWrite(_pinBacklight, HIGH);
    if (_pinReset!=NULL) digitalWrite(_pinReset, 1);
    delay(100);
    if (_pinReset!=NULL) digitalWrite(_pinReset, 0);
    delay(50);
    if (_pinReset!=NULL) digitalWrite(_pinReset, 1);
    delay(120);
    _writeCommand(HX8353E_SWRESET);
    delay(150);
    _writeCommand(HX8353E_SLPOUT);
    delay(200);
    _writeRegister(HX8353E_GAMSET, 0x04);
    _writeCommand(HX8353E_SETPWCTR);
    _writeData88(0x0A, 0x14);
    _writeCommand(HX8353E_SETSTBA);
    _writeData88(0x0A, 0x00);
    _writeRegister(HX8353E_COLMOD, 0x05);
    delay(10);
    _writeRegister(HX8353E_MADCTL, HX8353E_MADCTL_RGB);
    _writeCommand(HX8353E_CASET);
    _writeData8888(0x00, 0x00, 0x00, 0x79);
    _writeCommand(HX8353E_RASET);
    _writeData8888(0x00, 0x00, 0x00, 0x79);
    _writeCommand(HX8353E_NORON);
    delay(10);
    _writeCommand(HX8353E_DISPON);
    delay(120);
    _writeCommand(HX8353E_RAMWR);
    setBacklight(true);
    setOrientation(0);
    _screenWidth  = HX8353E_WIDTH;
    _screenHeigth = HX8353E_HEIGHT;
    _penSolid  = false;
    _fontSolid = true;
    _flagRead  = false;
    _touchTrim = 0;
    clear();
}
String Screen_HX8353E::WhoAmI()
{
    return "LCD MKII BoosterPack";
}
void Screen_HX8353E::invert(boolean flag)
{
    _writeCommand(flag ? HX8353E_INVON : HX8353E_INVOFF);
}
void Screen_HX8353E::setBacklight(boolean flag)
{
    if (_pinBacklight!=NULL) digitalWrite(_pinBacklight, flag);
}
void Screen_HX8353E::setDisplay(boolean flag)
{
    if (_pinBacklight!=NULL) setBacklight(flag);
}
void Screen_HX8353E::setOrientation(uint8_t orientation)
{
    _orientation = orientation % 4;
    _writeCommand(HX8353E_MADCTL);
    switch (_orientation) {
        case 0:
            _writeData(HX8353E_MADCTL_MX | HX8353E_MADCTL_MY | HX8353E_MADCTL_RGB);
            break;
        case 1:
            _writeData(HX8353E_MADCTL_MY | HX8353E_MADCTL_MV | HX8353E_MADCTL_RGB);
            break;
        case 2:
            _writeData(HX8353E_MADCTL_RGB);
            break;
        case 3:
            _writeData(HX8353E_MADCTL_MX | HX8353E_MADCTL_MV | HX8353E_MADCTL_RGB);
            break;
    }
}
void Screen_HX8353E::_fastFill(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t colour)
{
    if (x1 > x2) _swap(x1, x2);
    if (y1 > y2) _swap(y1, y2);
    _setWindow(x1, y1, x2, y2);
    digitalWrite(_pinDataCommand, HIGH);
    digitalWrite(_pinChipSelect, LOW);
    uint8_t hi = highByte(colour);
    uint8_t lo = lowByte(colour);
    for (uint32_t t=(uint32_t)(y2-y1+1)*(x2-x1+1); t>0; t--) {
        SPI.transfer(hi);
        SPI.transfer(lo);
    }
    digitalWrite(_pinChipSelect, HIGH);
}
void Screen_HX8353E::_setPoint(uint16_t x1, uint16_t y1, uint16_t colour)
{
    if( (x1 < 0) || (x1 >= screenSizeX()) || (y1 < 0) || (y1 >= screenSizeY()) ) return;
    _setWindow(x1, y1, x1+1, y1+1);
    _writeData16(colour);
}
void Screen_HX8353E::_setWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1)
{
    switch (_orientation) {
        case 0:
            x0 += 2;
            y0 += 3;
            x1 += 2;
            y1 += 3;
            break;
        case 1:
            x0 += 3;
            y0 += 2;
            x1 += 3;
            y1 += 2;
            break;
        case 2:
            x0 += 2;
            y0 += 1;
            x1 += 2;
            y1 += 1;
            break;
        case 3:
            x0 += 1;
            y0 += 2;
            x1 += 1;
            y1 += 2;
            break;
        default:
            break;
    }
    _writeCommand(HX8353E_CASET);
    _writeData16(x0);
    _writeData16(x1);
    _writeCommand(HX8353E_RASET);
    _writeData16(y0);
    _writeData16(y1);
    _writeCommand(HX8353E_RAMWR);
}
void Screen_HX8353E::_writeRegister(uint8_t command8, uint8_t data8)
{
    _writeCommand(command8);
    _writeData(data8);
}
void Screen_HX8353E::_writeCommand(uint8_t command8)
{
    digitalWrite(_pinDataCommand, LOW);
    digitalWrite(_pinChipSelect, LOW);
    SPI.transfer(command8);
    digitalWrite(_pinChipSelect, HIGH);
}
void Screen_HX8353E::_writeData(uint8_t data8)
{
    digitalWrite(_pinDataCommand, HIGH);
    digitalWrite(_pinChipSelect, LOW);
    SPI.transfer(data8);
    digitalWrite(_pinChipSelect, HIGH);
}
void Screen_HX8353E::_writeData16(uint16_t data16)
{
    digitalWrite(_pinDataCommand, HIGH);
    digitalWrite(_pinChipSelect, LOW);
    SPI.transfer(highByte(data16));
    SPI.transfer(lowByte(data16));
    digitalWrite(_pinChipSelect, HIGH);
}
void Screen_HX8353E::_writeData88(uint8_t dataHigh8, uint8_t dataLow8)
{
    digitalWrite(_pinDataCommand, HIGH);
    digitalWrite(_pinChipSelect, LOW);
    SPI.transfer(dataHigh8);
    SPI.transfer(dataLow8);
    digitalWrite(_pinChipSelect, HIGH);
}
void Screen_HX8353E::_writeData8888(uint8_t dataHigh8, uint8_t dataLow8, uint8_t data8_3, uint8_t data8_4)
{
    _writeData(dataHigh8);
    _writeData(dataLow8);
    _writeData(data8_3);
    _writeData(data8_4);
}
void Screen_HX8353E::_getRawTouch(uint16_t &x0, uint16_t &y0, uint16_t &z0)
{
    x0 = 0;
    y0 = 0;
    z0 = 0;
}

/*
 Grove Light Sensor

 A simple program that display the value of light from the Grove Light Sensor
 on the Grove 4-Digit Display, this example is very similar to the Grove Rotary Angle Sensor example
 
 The circuit:
 * 4-Digit Display attached to Pin 38 and 39 (J14 plug on Grove Base BoosterPack)
 * Light Sensor attached to Pin 24 (J6 plug on Grove Base BoosterPack)
 
 * Note:   
 
 Created by Oliver Wang
 
 This example code is in the public domain.
 
 http://www.seeedstudio.com/depot/Grove-Light-Sensor-p-746.html
*/

//4-Digit Display library
#include "TM1637.h" 

/* Macro Define */
#define CLK               39                /* 4-Digit Display clock pin */
#define DIO               38                /* 4-Digit Display data pin */
#define LIGHT_SENSOR      24                /* pin connected to the Light Sensor */

/* Global Variables */
TM1637 tm1637(CLK, DIO);                  /* 4-Digit Display object */
int analog_value = 0;                     /* variable to store the value coming from Light Sensor */
int8_t bits[4] = {0};                     /* array to store the single digits of the value */

/* the setup() method runs once, when the sketch starts */
void setup() 
{
  /* Initialize 4-Digit Display */
  tm1637.init();
  tm1637.set(BRIGHT_TYPICAL);
}

/* the loop() method runs over and over again */
void loop() 
{   
  analog_value = analogRead(LIGHT_SENSOR);  /* read the value from the sensor */
  	
  memset(bits, 0, 4);                       /* reset array before we use it */
  for(int i = 3; i >= 0; i--) 
  {
    /* Convert the value to individual decimal digits for display */
    bits[i] = analog_value % 10;
    analog_value = analog_value / 10;  
    tm1637.display(i, bits[i]);           /* display value on 4-Digit Display */
  }
  delay(100);  //small delay so that the number doesn't change too quickly
}

Credits

Daniel Oglvie

6 projects • 35 followers

Launchpad Engineer at Texas Instruments

MIT IAP 2016 Lab

Things used in this project

Hardware components

Software apps and online services

Story

MIT IAP LaunchPad Lab

Lab 0: Blink an LED

Lab 1: Side Kick

Lab 2: Educational BoosterPack MKII Sensors

Lab 3: Grove Starter Kit for LaunchPad

Lab 4: MSP432 + Wi-Fi (CC3100) and Temboo

Lab 5: Pulling it all Together

Code

Screen_HX8353E.cpp

Grove Starter Kit Light Sensor

Credits

Daniel Oglvie

Comments

Embed the widget on your own site

MIT IAP 2016 Lab

MIT IAP 2016 Lab

Things used in this project

Hardware components

Software apps and online services

Story

MIT IAP LaunchPad Lab

Lab 0: Blink an LED

Lab 1: Side Kick

Lab 2: Educational BoosterPack MKII Sensors

Lab 3: Grove Starter Kit for LaunchPad

Lab 4: MSP432 + Wi-Fi (CC3100) and Temboo

Lab 5: Pulling it all Together

Code

Screen_HX8353E.cpp

Grove Starter Kit Light Sensor

Credits

Daniel Oglvie

Comments

Related channels and tags