Application Report
SPRAA74A – December 2004
1
Creating Device Initialization GEL Files
Alan Campbell, Ki-Soo Lee, Dan Rinkes, Darian Sale SDS Applications Engineering
ABSTRACT
Startup GEL files are used to automate device initialization when Code Composer Studio
starts up. As devices become more complex, the startup GEL files also increase in
complexity, making it more difficult to write proper startup GEL files. This application note
describes how Code Composer Studio uses the startup GEL files and provides guidelines
on how to properly write such files.
This application note focuses on CCStudio versions 2.40 and greater.
Contents
1
Introduction.................................................................................................................................. 2
2
Code Composer Studio Startup Process.................................................................................... 2
3
Using the GEL Callback functions.............................................................................................. 2
3.1
StartUp() Function .................................................................................................................. 2
3.2
OnTargetConnect() Function .................................................................................................. 4
3.3
OnPreFileLoaded() Function................................................................................................... 6
3.4
OnFileLoaded() Function........................................................................................................ 6
3.5
OnReset() Function ................................................................................................................ 6
3.6
OnRestart() Function.............................................................................................................. 7
3.7
OnHalt() Function ................................................................................................................... 7
4
Memory Mapping.......................................................................................................................... 8
4.1
GEL_MapAdd() Function........................................................................................................ 8
4.2
GEL_MapAddStr() Function.................................................................................................... 8
4.3
GEL_MapDelete() Function.................................................................................................... 8
4.4
GEL_MapOn() and GEL_MapOff() Functions......................................................................... 9
4.5
GEL_MapReset() Function..................................................................................................... 9
5
Avoiding GEL Initialization Entirely for Production Applications............................................. 9
6
References.................................................................................................................................... 9
Appendix A: CCStudio Version Support Matrix............................................................................... 10
Appendix B: GEL Guidelines ............................................................................................................ 11
Tables
Table 1.
CCStudio Version Support Matrix ................................................................................ 10
