TMS320C6000 Basic Learning (6) - gel file

fish001

TMS320C6000 Basic Learning (6) - gel file [Copy link]

What is a gel file? What can a gel file do?

GEL stands for General Extended Language, which is a general extended language file. The GEL file is composed of codes similar to C language. GEL language is an interpreted language. The extension of GEL file is .gel.

GEL files are used to (1) extend CCS functionality, such as menu options, and (2) provide access to the target board's memory.

1. Basic syntax of gel - Class C

Gel functions and gel parameters do not need to be defined in the DSP program. Gel has many similarities to C language: functions, return statements, if-else statements, while statements, the same comment method as C, #define, and the usage of these functions or statements is also very similar to that in C.

GEL Function

funcName(param1 "discription" [,param2 "discription", param3 "discription",...])

{

statements;

}

There is no need to declare the return type and parameter type in the gel function, but the return statement can be used in the function;

Parameters are composed of "parameter + string type description". Parameters do not need to be defined and can be any of the following: symbolic value of the actual/simulated DSP target board; digital constant (expression or constant); string constant.

GEL function call: You can usually call a GEL function anywhere you enter a C expression, or you can call a GEL function from within another GEL function. GEL functions cannot be called recursively.

GEL Statements

Return statement:

return [expression];

Conditional Statements:

1. if (exp)

2. statements 1;

3. else

4. statements 2;

Loop statement:

1. while (exp) {

2. statements;

3. }

GEL Pretreatment

#define identifier(arguments list)     token-expression

GEL Notes

// Comments

/* Comments */

2. Gel-specific keywords

menuitem/hotmenu

Tested in CCS v4.2, menuitem adds submenu items under the Scripts menu, and hotmenu adds submenu items of the menu item defined by menuitem. Refer to the examples later in this article.

Functions declared with these two keywords do not require parameters, such as

1. menuitem "Addressing Modes";

2. hotmenu C27x_Mode()

3. {

4. AMODE = 0;

5. OBJMODE = 0;

6. }

8. hotmenu C28x_Mode()

9. {

10. AMODE = 0;

11. OBJMODE = 1;

12. }

14. hotmenu C2xLP_Mode()

15. {

16. AMODE = 1;

17. OBJMODE = 1;

18. }

The above code will generate the following menu structure,

Scripts

-Addressing Modes

-C27x_Mode

- C28x_Mode

- C2xLP_MODE

dialog

Add an entry submenu to the menu defined by menuitem and pop up a dialog box when the submenu is clicked.

menuitem "MyFunc"

dialog InitTarget(StartAddr "Starting Address", EndAddr "Ending Address")

{

statements;

}

dialog RefreshTarget()

{

statements;

}

slider

Add a slider. Each time you move the slider, call the GEL file again with the new value on the slider. The definition format is as follows:

slider param_def(minVal, maxVal, increment, pageIncrement, paramName)

{

statements;

}

3. GEL file example

1. /*

2. * This GEL file (DSP621x_671x.gel) provides example code on how to

3. * reset the C6x DSP and initialize the External Memory Interface.

4. *

5. * You will have to edit settings in emif_init() to your own

6. * specifications as the example is applicable to the C6711 DSK.

7. *

8. * This file is has minimal functionality and is designed to be used

9. * as a starting point for custom GEL files.

10. *

11. * Refer to CCS Help for detailed information on GEL commands.

12. *

13. */

15. /*

16. * The StartUp() function is called every time you start Code Composer.

17. * It should only include functions that do not "touch the hardware" -

18. * Hardware initialization should be invoked from the OnTargetConnect()

19. * function or the GEL menu.

20. */

21. StartUp()

22. {

24. /* setMemoryMap;

25. this should be a function to initialize the mem map based

26. on the particular hardware that is used

27. */

28. }

30. /*--------------------------------------------------------------*/

31. /* OnTargetConnect() -- this function is called after a target */

32. /* connect. */

33. /*--------------------------------------------------------------*/

34. OnTargetConnect()

35. {

36. /* GEL_Reset is used to deal with the worst case senario of

37. unknown target state. If for some reason a reset is not

38. desired upon target connection, GEL_Reset may be removed

39. and replaced with something "less brutal" like a cache

40. initialization function

41. GEL_Reset();

42. */

43. }

45. OnReset(int nErrorCode){

46. /* emif_init(); */

47. }

49. /*

50. * OnPreFileLoaded()

51. * This function is called automatically when the 'Load Program'

52. * Menu item is selected .....

53. */

54. OnPreFileLoaded()

55. {

56. CleanCache();

57. }

59. /*

60. * CleanCache()

61. * Actually Invalidate L1D, L1P, and L2

62. */

63. CleanCache() {

64. *(int *)0x01845004 = 1;

65. }

67. emif_init()

68. {

69. /*---------------------------------------------------------------------------*/

70. /* EMIF REGISTERS */

71. /*---------------------------------------------------------------------------*/

73. #define EMIF_GCTL 0x01800000

74. #define EMIF_CE1 0x01800004

75. #define EMIF_CE0 0x01800008

76. #define EMIF_CE2 0x01800010

77. #define EMIF_CE3 0x01800014

78. #define EMIF_SDRAMCTL 0x01800018

79. #define EMIF_SDRAMTIMING 0x0180001C

80. #define EMIF_SDRAMEXT 0x01800020

82. /*---------------------------------------------------------------------------*/

83. /* EMIF REGISTER VALUES - these should be modified to match TARGET hardware */

84. /*---------------------------------------------------------------------------*/

86. *(int *)EMIF_GCTL = 0x00003040;/* EMIF global control register */

87. *(int *)EMIF_CE1 = 0xFFFFFF23; /* CE1 - 32-bit asynch access after boot*/

88. *(int *)EMIF_CE0 = 0xFFFFFF30; /* CE0 - SDRAM */

89. *(int *)EMIF_CE2 = 0xFFFFFF23; /* CE2 - 32-bit asynch on daughterboard */

90. *(int *)EMIF_CE3 = 0xFFFFFF23; /* CE3 - 32-bit asynch on daughterboard */

91. *(int *)EMIF_SDRAMCTL = 0x07117000; /* SDRAM control register (100 MHz)*/

92. *(int *)EMIF_SDRAMTIMING = 0x0000061A; /* SDRAM Timing register */

93. }

The gel above comes from the ccsv4\emulation\gel\DSP621x_671x.gel file in the CCS v4 installation directory. It not only uses #define to define the register address, but also uses pointers similar to C to configure the EMIF (external memory interface).

1. /******************************************************************/

2. /* Code Composer Studio supports five reserved GEL functions that */

3. /* automatically get executed if they are defined. They are: */

4. /* */

5. /* StartUp() - Executed whenever CCS is invoked */

6. /* OnReset() - Executed after Debug->Reset CPU */

7. /* OnRestart() - Executed after Debug->Restart */

8. /* OnPreFileLoaded() - Executed before File->Load Program */

9. /* OnFileLoaded() - Executed after File->Load Program */

10. /* */

11. /******************************************************************/

13. StartUp()

14. {

15. /* Initialize F2812 memory map */

16. GEL_Reset();

17. F2812_Memory_Map();

18. /* Enable_DFT(); */

19. GEL_TextOut("Gel StartUp Complete.\n");

20. }

22. OnReset(int nErrorCode)

23. {

24. Enable_DFT();

25. }

27. /* commented out to avoid execution

28. OnRestart(int nErrorCode)

29. {

30. }

32. OnPreFileLoaded()

33. {

34. }

36. OnFileLoaded(int nErrorCode, int bSymbolsOnly)

37. {

38. }

39. */

41. menuitem "Initialize Memory Map";

43. /*------------------- F2812 Memory Map, MPNMC=0 --------------------*/

44. /* */

45. /* Note: M0M1MAP and VMAP signals tied high on F2812 core */

46. /* */

47. /* 0x000000 - 0x0007ff M0/M1 SARAM (Prog and Data) */

48. /* 0x000800 - 0x000fff Peripheral Frame0 (PF0) (Data only) */

49. /* 0x002000 - 0x003fff XINTF ZONE 0 (Prog and Data) */

50. /* 0x004000 - 0x005fff XINTF ZONE 1 (Prog and Data) */

51. /* 0x006000 - 0x006fff Peripheral Frame1 (PF1) (Data only) */

52. /* 0x007000 - 0x007fff Peripheral Frame2 (PF2) (Data only) */

53. /* 0x008000 - 0x009fff L0/L1 SARAM (Prog and Data) */

54. /* 0x080000 - 0x0fffff XINTF ZONE 2 (Prog and Data) */

55. /* 0x100000 - 0x17ffff XINTF ZONE 6 (Prog and Data) */

56. /* 0x3d7800 - 0x3d7fff OTP (Prog and Data) */

57. /* 0x3d8000 - 0x3f7fff FLASH (Prog and Data) */

58. /* 0x3f8000 - 0x3f9fff H0 SARAM (Prog and Data) */

59. /* 0x3fc000 - 0x3fffff XINTF ZONE 7 (MPNMC=1) (Prog and Data) */

60. /* 0x3ff000 - 0x3fffff BOOT ROM (MPNMC=0) (Prog and Data) */

61. /*------------------------------------------------------------------*/

62. hotmenu F2812_Memory_Map()

63. {

64. GEL_MapReset();

65. GEL_MapOn();

67. /* Program memory maps */

68. GEL_MapAdd(0x0,0,0x800,1,1); /* M0/M1 SARAM */

69. GEL_MapAdd(0x2000,0,0x2000,1,1); /* XINTF ZONE 0 */

70. GEL_MapAdd(0x4000,0,0x2000,1,1); /* XINTF ZONE 1 */

71. GEL_MapAdd(0x8000,0,0x2000,1,1); /* L0/L1 SARAM */

72. GEL_MapAdd(0x80000,0,0x80000,1,1); /* XINTF ZONE 2 */

73. GEL_MapAdd(0x100000,0,0x80000,1,1); /* XINTF ZONE 6 */

74. GEL_MapAdd(0x3d7800,0,0x800,1,0); /* OTP */

75. GEL_MapAdd(0x3d8000,0,0x20000,1,0); /* FLASH */

76. GEL_MapAdd(0x3f8000,0,0x2000,1,1); /* H0 SARAM */

78. /* Data memory maps */

79. GEL_MapAdd(0x0,1,0x800,1,1); /* M0/M1 SARAM */

80. GEL_MapAdd(0x800,1,0x800,1,1); /* PF0 */

81. GEL_MapAdd(0x2000,1,0x2000,1,1); /* XINTF ZONE 0 */

82. GEL_MapAdd(0x4000,1,0x2000,1,1); /* XINTF ZONE 1 */

83. GEL_MapAdd(0x6000,1,0x1000,1,1); /* PF1 */

84. GEL_MapAddStr(0x7000,1,0x1000,"R|W|AS2",0); /* PF2 */

85. GEL_MapAdd(0x8000,1,0x2000,1,1); /* L0/L1 SARAM */

86. GEL_MapAdd(0x80000,1,0x80000,1,1); /* XINTF ZONE 2 */

87. GEL_MapAdd(0x100000,1,0x80000,1,1); /* XINTF ZONE 6 */

88. GEL_MapAdd(0x3d7800,1,0x800,1,0); /* OTP */

89. GEL_MapAdd(0x3d8000,1,0x20000,1,0); /* FLASH */

90. GEL_MapAdd(0x3f8000,1,0x2000,1,1); /* H0 SARAM */

92. /* Uncomment the map that corresponds to the MPNMC value. */

93. F2812_Boot_ROM_Map();

94. /* F2812_XINTF_Zone7_Map(); */

95. }

97. /* Map Boot ROM if MPNMC = 0 */

98. F2812_Boot_ROM_Map()

99. {

100. GEL_MapAdd(0x3ff000,0,0x1000,1,0); /* BOOT ROM */

101. GEL_MapAdd(0x3ff000,1,0x1000,1,0); /* BOOT ROM */

102. }

104. /* Map External Interface Zone 7 if MPNMC = 1 */

105. F2812_XINTF_Zone7_Map()

106. {

107. GEL_MapAdd(0x3fc000,0,0x4000,1,1); /* XINTF ZONE 7 */

108. GEL_MapAdd(0x3fc000,1,0x4000,1,1); /* XINTF ZONE 7 */

109. }

111. /* Enable DFT read/write for SARAM blocks */

112. Enable_DFT()

113. {

114. *0x950 = 0x0300; /* M0 */

115. *0x951 = 0x0300; /* M1 */

116. *0x952 = 0x0300; /* L0 */

117. *0x953 = 0x0300; /* L1 */

118. *0x954 = 0x0300; /* H0 */

119. }

121. menuitem "Watchdog";

122. hotmenu Disable_WD()

123. {

124. /* Enable WD override */

125. *0x7029 = *0x7029 | 0x0068;

126. *0x7025 = 0x0055;

127. *0x7025 = 0x00AA;

128. }

130. menuitem "Code Security Module"

131. hotmenu Unlock_CSM()

132. {

133. /* Assumes flash is erased */

134. *0xAE0 = 0xFFFF;

135. *0xAE1 = 0xFFFF;

136. *0xAE2 = 0xFFFF;

137. *0xAE3 = 0xFFFF;

138. *0xAE4 = 0xFFFF;

139. *0xAE5 = 0xFFFF;

140. *0xAE6 = 0xFFFF;

141. *0xAE7 = 0xFFFF;

143. /* Read the password locations */

144. XAR0 = *0x3F7FF8;

145. XAR0 = *0x3F7FF9;

146. XAR0 = *0x3F7FFA;

147. XAR0 = *0x3F7FFB;

148. XAR0 = *0x3F7FFC;

149. XAR0 = *0x3F7FFD;

150. XAR0 = *0x3F7FFE;

151. XAR0 = *0x3F7FFF;

152. }

154. menuitem "Addressing Modes";

155. hotmenu C27x_Mode()

156. {

157. AMODE = 0;

158. OBJMODE = 0;

159. }

161. hotmenu C28x_Mode()

162. {

163. AMODE = 0;

164. OBJMODE = 1;

165. }

167. hotmenu C2xLP_Mode()

168. {

169. AMODE = 1;

170. OBJMODE = 1;

171. }

The above code is a GEL file for DSP320F2812

A screenshot of the results is as follows,