Texas Instruments EK-LM4F232 Manuale utente

Texas Instruments Incorporated

SW-EK-LM4F232-UG-2.1.4.178

USER’S GUIDE

EK-LM4F232 Firmware Development

Package

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.4.178 of this document, last updated on February 22, 2017.

2 February 22, 2017

Table of Contents

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

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

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

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

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

2.3 Boot Loader Demo 1 (boot_demo1) .................................... 7

2.4 Boot Loader Demo 2 (boot_demo2) .................................... 8

2.5 Boot Loader (boot_serial) .......................................... 8

2.6 USB Boot Loader (boot_usb) ........................................ 9

2.7 Hello World (hello) .............................................. 9

2.8 Hibernate Example (hibernate) ....................................... 9

2.9 Interrupts (interrupts) ............................................ 10

2.10 MPU (mpu_fault) ............................................... 10

2.11 Data Logger (qs-logger) ........................................... 10

2.12 SD card using FAT ﬁle system (sd_card) ................................. 11

2.13 Sine Demo (sine_demo) .......................................... 12

2.14 SoftUART Echo (softuart_echo) ...................................... 12

2.15 Timer (timers) ................................................ 12

2.16 UART Echo (uart_echo) ........................................... 12

2.17 uDMA (udma_demo) ............................................ 12

2.18 USB Generic Bulk Device (usb_dev_bulk) ................................. 12

2.19 USB HID Keyboard Device (usb_dev_keyboard) ............................. 13

2.20 USB MSC Device (usb_dev_msc) ..................................... 13

2.21 USB Serial Device (usb_dev_serial) .................................... 13

2.22 USB host audio example application using SD Card FAT ﬁle system (usb_host_audio) ........ 14

2.23 USB HID Keyboard Host (usb_host_keyboard) .............................. 14

2.24 USB HID Mouse Host (usb_host_mouse) ................................. 14

2.25 USB Mass Storage Class Host Example (usb_host_msc) ........................ 14

2.26 USB Stick Update Demo (usb_stick_demo) ................................ 14

2.27 USB Memory Stick Updater (usb_stick_update) ............................. 15

2.28 Watchdog (watchdog) ............................................ 15

3 Buttons Driver ............................................... 17

3.1 Introduction .................................................. 17

3.2 API Functions ................................................ 17

3.3 Programming Example ........................................... 18

4 Display Driver ................................................ 19

4.1 Introduction .................................................. 19

4.2 API Functions ................................................ 19

4.3 Programming Example ........................................... 20

IMPORTANT NOTICE ............................................... 22

February 22, 2017 3

Table of Contents

4 February 22, 2017

Introduction

1 Introduction

The Texas Instruments® Stellaris® EK-LM4F232 evaluation board is a platform that can be used

for software development and prototyping a hardware design. It can also be used as a guide for

custom board design using a Stellaris microcontroller.

The EK-LM4F232 includes a Stellaris ARM® Cortex™-M3-based microcontroller and the following

features:

Stellaris® LM4F232H5QD microcontroller

Four 20V analog inputs

3-axis analog accelerometer

On-board temperature sensor

Bright 96 x 64 16-bit color OLED display

5 user buttons

User LED

Shunt for microcontroller current consumption measurement

MicroSD card connector

USB OTG connector

On-board In-Circuit Debug Interface (ICDI)

Coin cell backup battery for Hibernate feature

Power supply option from USB ICDI connection, or OTG connection

This document describes the board-speciﬁc drivers and example applications that are provided for

this development board.

February 22, 2017 5

Introduction

6 February 22, 2017

Example Applications

2 Example Applications

The example applications show how to utilize features of the EK-LM4F232 evaluation board. Exam-

ples are included to show how to use many of the general features of the Stellaris microcontroller,

as well as the feature that are unique to this evaluation board.

A number of drivers are provided to make it easier to use the features of the EK-LM4F232. These

drivers also contain low-level code that make use of the Stellaris peripheral driver library and utili-

ties.

There is an IAR workspace ﬁle (ek-lm4f232.eww) that contains the peripheral driver library

project, along with all of the board example projects, in a single, easy-to-use workspace for use

with Embedded Workbench version 5.

There is a Keil multi-project workspace ﬁle (ek-lm4f232.uvmpw) that contains the peripheral

driver library project, along with all of the board example projects, in a single, easy-to-use

workspace for use with uVision.

All of these examples reside in the examples/boards/ek-lm4f232 subdirectory of the ﬁrmware

development package source distribution.

2.1 Bit-Banding (bitband)

This example application demonstrates the use of the bit-banding capabilities of the Cortex-M3

microprocessor. All of SRAM and all of the peripherals reside within bit-band regions, meaning that

bit-banding operations can be applied to any of them. In this example, a variable in SRAM is set to

a particular value one bit at a time using bit-banding operations (it would be more efﬁcient to do a

single non-bit-banded write; this simply demonstrates the operation of bit-banding).

2.2 Blinky (blinky)

A very simple example that blinks the on-board LED.

2.3 Boot Loader Demo 1 (boot_demo1)

An example to demonstrate the use of a ﬂash-based boot loader. At startup, the application will

conﬁgure the UART and USB peripherals, and then branch to the boot loader to await the start

of an update. If using the serial boot loader (boot_serial), the UART will always be conﬁgured at

115,200 baud and does not require the use of auto-bauding.

This application is intended for use with any of the three ﬂash-based boot loader ﬂavors (boot_serial

or boot_usb) included in the software release. To accommodate the largest of these (boot_usb),

the link address is set to 0x2800. If you are using serial, you may change this address to a 1KB

boundary higher than the last address occupied by the boot loader binary as long as you also

rebuild the boot loader itself after modifying its bl_conﬁg.h ﬁle to set APP_START_ADDRESS to

the same value.

February 22, 2017 7

Example Applications

The boot_demo2 application can be used along with this application to easily demonstrate that the

boot loader is actually updating the on-chip ﬂash.

Note that the LM4F232 and other Blizzard-class devices also support the serial and USB boot

loaders in ROM. To make use of this function, link your application to run at address 0x0000 in ﬂash

and enter the bootloader using the ROM_UpdateSerial and ROM_UpdateUSB functions (deﬁned

in rom.h). This mechanism is used in the utils/swupdate.c module when built speciﬁcally targeting

a suitable Blizzard-class device.

2.4 Boot Loader Demo 2 (boot_demo2)

An example to demonstrate the use of a ﬂash-based boot loader. At startup, the application will

conﬁgure the UART, USB and Ethernet peripherals, wait for a widget on the screen to be pressed,

and then branch to the boot loader to await the start of an update. If using the serial boot loader

(boot_serial), the UART will always be conﬁgured at 115,200 baud and does not require the use of

auto-bauding.

This application is intended for use with any of the three ﬂash-based boot loader ﬂavors (boot_eth,

boot_serial or boot_usb) included in the software release. To accommodate the largest of these

(boot_usb), the link address is set to 0x2800. If you are using serial or Ethernet boot loader, you

may change this address to a 1KB boundary higher than the last address occupied by the boot

loader binary as long as you also rebuild the boot loader itself after modifying its bl_conﬁg.h ﬁle to

set APP_START_ADDRESS to the same value.

The boot_demo1 application can be used along with this application to easily demonstrate that the

boot loader is actually updating the on-chip ﬂash.

Note that the LM4F232 and other Blizzard-class devices also the support serial and USB boot

loaders in ROM. To make use of this function, link your application to run at address 0x0000 in

ﬂash and enter the bootloader using either the ROM_UpdateUSB or ROM_UpdateSerial functions

(deﬁned in rom.h). This mechanism is used in the utils/swupdate.c module when built speciﬁcally

targeting a suitable Blizzard-class device.

2.5 Boot Loader (boot_serial)

The boot loader is a small piece of code that can be programmed at the beginning of ﬂash to act as

an application loader as well as an update mechanism for an application running on a Tiva C Series

microcontroller, utilizing either UART0, I2C0, SSI0, or USB. The capabilities of the boot loader are

conﬁgured via the bl_conﬁg.h include ﬁle. For this example, the boot loader uses UART0 to load an

application.

The conﬁguration is set to boot applications which are linked to run from address 0x2800 in ﬂash.

This is higher than strictly necessary but is intended to allow the example boot loader-aware appli-

cations provided in the release to be used with any of the three boot loader example conﬁgurations

supplied (serial or USB) without having to adjust their link addresses.

Note that the LM4F232 and other Blizzard-class devices also support serial boot loaders in ROM.

8 February 22, 2017

Example Applications

2.6 USB Boot Loader (boot_usb)

The boot loader is a small piece of code that can be programmed at the beginning of ﬂash to act as

an application loader as well as an update mechanism for an application running on a Tiva C Series

microcontroller, utilizing either UART0, I2C0, SSI0, or USB. The capabilities of the boot loader are

conﬁgured via the bl_conﬁg.h include ﬁle. For this example, the boot loader uses the USB Device

Firmware Upgrade (DFU) class to download an application.

Applications intended for use with this version of the boot loader should be linked to run from

address 0x2800 in ﬂash (rather than the default run address of 0). This address is chosen to

ensure that boot loader images built with all supported compilers may be used without modifying

the application start address. Depending upon the compiler and optimization level you are using,

however, you may ﬁnd that you can reclaim some space by lowering this address and rebuilding

both the application and boot loader. To do this, modify the makeﬁle or project you use to build

the application to show the new run address and also change the APP_START_ADDRESS value

deﬁned in bl_conﬁg.h before rebuilding the boot loader.

The USB boot loader may be demonstrated using the boot_demo1 and boot_demo2 example ap-

plications in addition to the boot_usb boot loader binary itself. Note that these are the only two

example applications currently conﬁgured to run alongside the USB boot loader but making any of

the other applications boot loader compatible is simply a matter of relinking them with the new start

address and adding a mechanism to transfer control to the boot loader when required.

The Windows device driver required to communicate with the USB boot loader can be found on

the software and documentation CD from the development kit package. It can also be found in the

Windows driver package which can be downloaded via a link from http://www.ti.com/tiva.

A Windows command-line application, dfuprog, is also provided which illustrates how to per-

form uploads and downloads via the USB DFU protocol. The source for this application can be

found in the /ti/TivaWare_C_Series-x.x/tools directory and the prebuilt executable is available in

the package “TivaWare for C Series PC Companion Utilities” available for download via a link from

http://www.ti.com/tivaware .

2.7 Hello World (hello)

A very simple “hello world” example. It simply displays “Hello World!” on the display and is a starting

point for more complicated applications. This example uses calls to the TivaWare Graphics Library

graphics primitives functions to update the display. For a similar example using widgets, please see

“hello_widget”.

2.8 Hibernate Example (hibernate)

An example to demonstrate the use of the Hibernation module. The user can put the microcontroller

in hibernation by pressing the select button. The microcontroller will then wake on its own after 5

seconds, or immediately if the user presses the select button again. The program keeps a count

of the number of times it has entered hibernation. The value of the counter is stored in the battery

backed memory of the Hibernation module so that it can be retrieved when the microcontroller

wakes.

February 22, 2017 9

Example Applications

2.9 Interrupts (interrupts)

This example application demonstrates the interrupt preemption and tail-chaining capabilities of

Cortex-M4 microprocessor and NVIC. Nested interrupts are synthesized when the interrupts have

the same priority, increasing priorities, and decreasing priorities. With increasing priorities, pre-

emption will occur; in the other two cases tail-chaining will occur. The currently pending interrupts

and the currently executing interrupt will be displayed on the display; GPIO pins D0, D1 and D2 will

be asserted upon interrupt handler entry and de-asserted before interrupt handler exit so that the

off-to-on time can be observed with a scope or logic analyzer to see the speed of tail-chaining (for

the two cases where tail-chaining is occurring).

2.10 MPU (mpu_fault)

This example application demonstrates the use of the MPU to protect a region of memory from

access, and to generate a memory management fault when there is an access violation.

2.11 Data Logger (qs-logger)

This example application is a data logger. It can be conﬁgured to collect data from up to 10 data

sources. The possible data sources are:

4 analog inputs, 0-20V

3-axis accelerometer

internal and external temperature sensors

processor current consumption

The data logger provides a menu navigation that is operated by the buttons on the EK-LM4F232

board (up, down, left, right, select). The data logger can be conﬁgured by using the menus. The

following items can be conﬁgured:

data sources to be logged

sample rate

storage location

sleep modes

clock

Using the data logger:

Use the CONFIG menu to conﬁgure the data logger. The following choices are provided:

CHANNELS - enable speciﬁc channels of data that will be logged

PERIOD - select the sample period

STORAGE - select where the collected data will be stored:

•FLASH - stored in the internal ﬂash memory

•USB - stored on a connected USB memory stick

10 February 22, 2017

Indice

Altri manuali Texas Instruments Scheda madre

Texas Instruments

Texas Instruments TLV767EVM-014 Manuale utente

Texas Instruments

Texas Instruments LMX2615EVM-CVAL Manuale utente

Texas Instruments

Texas Instruments TPS25741EVM-802 Manuale utente

Texas Instruments

Texas Instruments LAUNCHXL-F280025C Guida per l'amministratore

Texas Instruments

Texas Instruments TMS320DM644 Series Manuale utente

Texas Instruments

Texas Instruments LM5180-Q1 Manuale utente

Texas Instruments

Texas Instruments MSP430FR58 Series Manuale utente

Texas Instruments

Texas Instruments BQ24450EVM Manuale utente

Texas Instruments

Texas Instruments TPS3899EVM Manuale utente

Texas Instruments

Texas Instruments DS90UB934-Q1EVM Manuale utente

Texas Instruments

Texas Instruments bq50002AEVM-607 Manuale utente

Texas Instruments

Texas Instruments TAS3208EVM Manuale utente

Texas Instruments

Texas Instruments ADC DJ 00SE Series Manuale utente

Texas Instruments

Texas Instruments bq76940 Manuale utente

Texas Instruments

Texas Instruments UCD3138LLCEVM-028 Manuale utente

Texas Instruments

Texas Instruments LM2796 Manuale utente

Texas Instruments

Texas Instruments CC3100MOD Boosterpack Manuale utente

Texas Instruments

Texas Instruments PCM182xEVM Manuale utente

Texas Instruments

Texas Instruments DS280DF810EVM Manuale utente

Texas Instruments

Texas Instruments TPS715EVM-074 Manuale utente

Texas Instruments

Texas Instruments PGA450Q1EVM-S Manuale utente

Texas Instruments

Texas Instruments DS320PR810-SMP-EVM Manuale utente

Texas Instruments

Texas Instruments bq27421 Manuale utente

Texas Instruments

Texas Instruments UCC28780EVM-021 Manuale utente

Manuali Scheda madre popolari di altre marche

DFI

DFI SD170 Manuale utente

ASROCK

ASROCK ROMED8-2T Manuale utente

Asus

Asus P2L97A Manuale utente

Winmate

Winmate IC70 Manuale utente

Asus

Asus MES-B Manuale utente

Grantech

Grantech SYS8F377VGGA-3OMN Manuale utente

Telit Wireless Solutions

Telit Wireless Solutions SL869-3DR Manuale utente

Gigabyte

Gigabyte GA-9IVDT Manuale utente

Commell

Commell MS-C73 Manuale utente

IBT Technologies

IBT Technologies MB860 Manuale utente

Nvidia

Nvidia TEGRA DG-04927-001_V01 Manuale utente

Biostar

Biostar M7VIT Bravo Istruzioni per l'uso e l'installazione

Intel

Intel D33217CK Manuale utente

Asus

Asus F1A55-M LX PLUS R2.0 Manuale utente

EPC

EPC EPC9147C Manuale utente

Asus

Asus EX-B760M-V5 D4 Manuale utente

EPOX

EPOX MU-8KHA0010 Manuale utente

Ski-Doo

Ski-Doo Bombardier MPEM 219 700 090 Manuale utente