Texas Instruments EK-TM4C123GXL User Manual

EK-TM4C123GXL Firmware Development

Package

USER’S GUIDE

SW-EK-TM4C123GXL-UG-2.1.3.156

Copyright © 2012-2016

Texas Instruments Incorporated

Copyright

Copyright © 2012-2016 Texas Instruments Incorporated. All rights reserved. Tiva and TivaWare are trademarks of Texas Instruments Instruments. ARM
and Thumb are registered trademarks and Cortex is a trademark of ARM Limited. Other names and brands may be claimed as the property of others.

Please be aware that an important notice concerning availability, standard warranty, and use in critical applications of Texas Instruments semicon-

ductor products and disclaimers thereto appears at the end of this document.

Texas Instruments
108 Wild Basin, Suite 350
Austin, TX 78746

www.ti.com/tiva- c

Revision Information

This is version 2.1.3.156 of this document, last updated on July 25, 2016.

2 July 25, 2016

Table of Contents

Table of Contents

Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Revision Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Example Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.1 Bit-Banding (bitband) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.2 Blinky (blinky) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.3 FreeRTOS Example (freertos_demo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.4 GPIO JTAG Recovery (gpio_jtag) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.5 Hello World (hello) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.6 Interrupts (interrupts) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.7 MPU (mpu_fault) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.8 Project Zero (project0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.9 EK-TM4C123GXL Quickstart Application (qs-rgb) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.10 Timer (timers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.11 UART Echo (uart_echo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.12 uDMA (udma_demo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.13 USB Generic Bulk Device (usb_dev_bulk) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.14 USB HID Gamepad Device (usb_dev_gamepad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.15 USB Serial Device (usb_dev_serial) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3 Buttons Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.2 API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.3 Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4 RGB LED Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.2 API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.3 Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

IMPORTANT NOTICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

July 25, 2016 3

Table of Contents

4 July 25, 2016

1 Introduction

The Texas Instruments® Tiva™ C Series EK-TM4C123GXL evaluation board is a low cost platform
that can be used for software development and to prototype a hardware design. It contains a
Tiva C Series ARM® Cortex™-M4F-based microcontroller, a USB device port, two push buttons,
and a RGB LED that can be used to exercise the peripherals on the microcontroller. Additionally,
most of the microcontroller’s pins are brought to headers, allowing for easy connection to other
hardware for the purposes of prototyping. The outer rows of header pins are compatible with the
MSP430™ Launchpad.

This document describes the example applications that are provided for this evaluation board.

Introduction

July 25, 2016 5

Introduction

6 July 25, 2016