====== ARM-CM4 TM4C Texas Instruments DK-TM4C123G IAR EWARM ======

===== Supported firmware update interfaces =====

^ RS232         ^ CAN            ^ USB         ^ TCP/IP      ^ SD-card      ^ Modbus RTU   ^
| Yes           | No             | Yes         | No          | Yes           | No           |

===== Development Environment =====

{{:manual:demos:dk_tm4c123g.jpg?200 |}}

This demo is targeted towards the [[http://www.ti.com/tool/dk-tm4c123g|Texas Instruments DK-TM4C123G]] development kit, with 256 kB internal Flash EEPROM and 32 kB internal RAM.

To program the bootloader into the internal flash on the TM4C123G microcontroller, the In-Circuit Debugger Interface (ICDI), that is available on the board, was used. However, this is not required if you have another means of programming the internal flash.

To compile the demo programs you can use the [[http://www.iar.com/|IAR Embedded Workbench for ARM]] development environment. 

===== Building and programming the Bootloader =====
Before the bootloader can be used, it needs to be built and programmed into the TM4C123G's internal flash memory. The steps in this section only need to be done once.

When using IAR EWARM, simply open the workspace from within the Embedded Workbench. The workspace file (tm4c123g.eww) is located at: \Target\Demo\ARMCM4_TM4C_DK_TM4C123G_IAR\**Boot**\ide\. Once opened, select Project->Rebuild All from the menu to compile all the bootloader sources and link the together into the final executable.

The bootloader program is now ready to be programmed into the internal flash memory of the TM4C123G. Using your favorite programmer (such as the LM Flash Programmer), flash the bootloader using one of the following files, depending on what file type your programmer supports:

  * \Target\Demo\ARMCM4_TM4C_DK_TM4C123G_IAR\**Boot**\bin\**openblt_dk_tm4c123g.out**
  * \Target\Demo\ARMCM4_TM4C_DK_TM4C123G_IAR\**Boot**\bin\**openblt_dk_tm4c123g.bin**

===== Building the Demo Program =====
When using IAR EWARM, simply open the workspace from within the Embedded Workbench. The workspace file (tm4c123g.eww) is located at: \Target\Demo\ARMCM4_TM4C_DK_TM4C123G_IAR\**Prog**\ide\. Once opened, select Project->Rebuild All from the menu to compile all the demo program sources and link the together into the final executable.

The output file is
  * \Target\Demo\ARMCM4_TM4C_DK_TM4C123G_IAR\**Prog**\bin\**demoprog_dk_tm4c123g.srec**

===== Firmware update procedure =====
To download the demo program \Target\Demo\ARMCM4_TM4C_DK_TM4C123G_IAR\**Prog**\bin\**demoprog_dk_tm4c123g.srec** using the bootloader, follow the instructions in the following links, depending on the communication interface you intend to use:

  * [[manual:rs232_demo|Firmware updates using the RS232 communication interface]]
  * [[manual:usb_demo|Firmware updates using the USB communication interface]]
  * [[manual:sdcard_demo|Firmware updates from SD-card]]