README

i2ctmp116

Example Summary

Sample application that reads the temperature from a TMP116 sensor.

Peripherals Exercised

Board_GPIO_LED0 - Indicator LED
Board_I2C_TMP - I2C used to communicate with the TMP116 sensor.

Resources & Jumper Settings

If you’re using an IDE (such as CCS or IAR), please refer to Board.html in your project directory for resources used and board-specific jumper settings. Otherwise, you can find Board.html in the directory <SDK_INSTALL_DIR>/source/ti/boards/<BOARD>.

Example Usage

Example output is generated through use of Display driver APIs. Refer to the Display driver documentation found in the SimpleLink MCU SDK User’s Guide.
Open a serial session (e.g. PuTTY, etc.) to the appropriate COM port.
The COM port can be determined via Device Manager in Windows or via ls /dev/tty* in Linux.

The connection will have the following settings:

    Baud-rate:     115200
    Data bits:          8
    Stop bits:          1
    Parity:          None
    Flow Control:    None

Run the example. Board_GPIO_LED0 turns ON to indicate driver initialization is complete.
The example will request temperature samples from the TMP116 and display them via the UART. A total of 20 temperature samples are read and printed before the example exits. Terminal output should resemble:
```
    I2C Initialized!
    Sample 0: 24 (C)
    Sample 1: 24 (C)
           .
           .
           .
    Sample 18: 24 (C)
    Sample 19: 24 (C)
    I2C closed!
```
If the I2C communication fails, the following error message is displayed: ``` I2C Bus fault.

```

Application Design Details

This application uses one task:

'getTempTask' - performs the following actions:

Opens and initializes an I2C driver object.
Uses the I2C driver to get data from the TMP116 sensor.
Extracts the temperature (in Celsius) and prints the value via the UART.
The task sleeps for 1 second.
After 20 temperature samples are recovered, the I2C peripheral is closed and the example exits.

TI-RTOS:

When building in Code Composer Studio, the kernel configuration project will be imported along with the example. The kernel configuration project is referenced by the example, so it will be built first. The “release” kernel configuration is the default project used. It has many debug features disabled. These feature include assert checking, logging and runtime stack checks. For a detailed difference between the “release” and “debug” kernel configurations and how to switch between them, please refer to the SimpleLink MCU SDK User’s Guide. The “release” and “debug” kernel configuration projects can be found under <SDK_INSTALL_DIR>/kernel/tirtos/builds/<BOARD>/(release|debug)/(ccs|gcc).

FreeRTOS:

Please view the FreeRTOSConfig.h header file for example configuration information.

Code Composer Studio:

When using in CCS for the CC32XX devices, it’s recommended you do a “Free Run” instead of “Run”. This is because when the CC32XX device goes into low power mode, emulation is lost.

SimpleLink Sensor and Actuator Plugin:

This example uses a TMP116 sensor. It interfaces via the I2C Driver. For a richer API set for the TMP sensors, please refer the SimpleLink Sensor and Actuator Plugin. This plugin also offers a Button module to handle debounce also.