Getting Started with EK-TM4C123GXL LaunchPad

From EdWiki

Install Codelite

  • Add CodeLite public key to avoid warnings from apt
    sudo apt-key adv --fetch-keys
  • Add Codelite Repositories
    sudo apt-add-repository 'deb trusty universe'
  • You then need to update your repositories.
    sudo apt-get update
  • You should now be able to install CodeLite by doing:
    sudo apt-get install codelite
  • Install ARM GCC Build Settings
    After Installing CodeLite, Download Build Settings for GNU ARM and untar in the ~/.codelite/config folder.
    tar xvf ~/Downloads/build_settings.xml.tar.gz -C ~/.codelite/config
  • Install EK-TM4C123GXL ARM GCC Template
    If you are developing programs for EK-TM4C123GXL LaunchPad Board, Download EK-TM4C123GXL ARM GCC Template and extract to /usr/share/codelite/templates/projects/
    sudo tar xvf ~/Downloads/ek-tm4c123gxl-armgcc-template.tar.gz -C /usr/share/codelite/templates/projects/

Run Codelite

codelite &

Create New Workspace

  1. To create a new workspace in codelite, select File-->New-->New Workspace
  2. In the Select New Workspace Type Dialog Box, Select C++ and click OK
  3. Next, Select the Folder where you want to create new workspace and type name for it.

Create New Project

  1. Click on the Newly created workspace, Select File-->New-->New Project
  2. In the New Project Wizard, expand Others Category from Template and Select ek-tm4c123gxl-arm-gcc template
  3. Type a name for the Project and click Next
  4. Select Project toolchain as arm gcc and Debugger as GNU GDB Debugger
  5. Click Finish

Configure OpenOCD

  1. Select Plugins-->External Tools-->Configure External Tools ...
  2. Click on the New... Button
  3. Fill in the fields as follows:
    Tool ID: Choose from the drop-down box
    Name: OpenOCD
    Tool Path: Click on the ... button, browse and select openocd binary folder (ex: ~/openocd-0.9.0-bin/openocd)
    Working Directory: Click on the ...button, browse and select openocd folder (ex: ~/openocd-0.9.0-bin)
    Arguments: --file board/ek-tm4c123gxl.cfg
  4. Check Capture process output
  5. Click OK

Connect EK-TM4C123GXL LaunchPad Board to PC

Tiva™ C Series TM4C123G LaunchPad

The TM4C123GXL LaunchPad Board ICDI USB port (marked DEBUG and shown in the picture below) is a composite USB port and consists of three connections:

  • Stellaris ICDI JTAG/SWD Interface - debugger connection
  • Stellaris ICDI DFU Device - firmware update connection
  • Stellaris Virtual Serial Port - a serial data connection

Using the included USB cable, ► connect the USB emulation connector on your evaluation board (marked DEBUG) to a free USB port on your PC. A PC’s USB port is capable of sourcing up to 500 mA for each attached device, which is sufficient for the evaluation board. If connecting the board through a USB hub, it must be a powered hub.


Make sure that the power switch in the upper left hand corner of your board is in the right-hand DEBUG position as shown:

Run OpenOCD

Run OpenOCD

Select Plugins-->External Tools-->OpenOCD


  1. Tiva C Series TM4C123G LaunchPad -- Readme First
  2. Tiva C Series TM4C123G LaunchPad Evaluation Kit -- User's Manual
  3. TM4C123GH6PM Microcontroller -- Data Sheet
  4. TivaWare Peripheral Driver Library -- User's Guide
  5. Sensor Hub BoosterPack -- Documentation