Cookery-Book, V1.0, February XMC1400 BootKit HelloWorld

Transcription

1 Cookery-Book, V1.0, February 2017 XMC1400 BootKit HelloWorld Programming ( Hello World ) an Infineon XMC1400 (ARM Cortex M0) Microcontroller. Using Dave/Eclipse( Code Generator, IDE, Compiler, Linker, Locator, Debugger, Flash Programmer, Utility Too ls). State-of-the-art component-based (= Dave Apps ) Embedded Softwa re Engineering/Development. Microcontrollers

2 Introduction: This is a Hands-On Training / Cookery Book / step-by-step book. It will help inexperienced users to get the XMC1400 BootKit up and running. With this step-by-step book you should be able to get your first useful program in less than 2 hours. The purpose of this document is to gain know-how of the microcontroller and the tool-chain. Additionally, the "hello world example" can easily be expanded to suit your needs. You can connect either a part of - or your entire application to the XMC1400 BootKit. You are also able to benchmark any of your algorithms to find out if the selected microcontroller fulfils all the required functions within the time frame needed. Note: The style used in this document focuses on working through this material as fast and easily as possible. That means there are full screenshots and dialog-window-screenshots; extensive use of colours and page breaks; and listed source-code is not formatted to ease copy & paste. Have fun and enjoy the XMC1400 BootKit! Cookery-Book 2

3 XMC1400 BootKit: Note: For further information, please refer to the XMC1400 BootKit home page: Cookery-Book 3

4 Used/selected microcontroller: XMC1400 Block Diagram (Source: Product Marketing) Cookery-Book 4

5 XMC1400 Block Diagramm (Source: Data Sheet) Note: Just by comparing the different sources of block diagrams, you should be able to get a picture of the product and to answer some of your initial questions. Cookery-Book 5

6 Cookery book For your first programming example for the XMC1400 BootKit: Your program: Chapter/ Step *** Recipes *** 0.) Dave Installation.) Dave Installation.) Dave Updates 1.) Using Dave Part 1: Transmit Data To A Serial Terminal Program.) Microcontroller initialization.) Programming of your application (hello world) with the Dave toolchain.) Using the debugger 2.) Part 2: Receive Data From The Terminal Program 3.) Part 3: Ports (LEDs) 4.) Part 4: Blinking LEDs (SystemTimer) Feedback: 5.) Feedback Cookery-Book 6

7 0.) Dave Installation: Install Dave: Go to and install the latest Dave version ( ). Note: Install all/everything offered. Do not use blanks/spaces in windows directory names and windows path names! Result: Start Dave: Double click Cookery-Book 7

8 Workspace Launcher -> Workspace: insert C:\DAVE_4_3_2_Workspace_HelloWorld Click OK Cookery-Book 8

9 Cookery-Book 9

10 Update Dave: Help -> Check for Updates Help -> Check for DAVE APP Updates Help -> Install Dave APP/Example/Device Library -> Dave Site: Work with: select Dave Project Library Manager Help -> Install Dave APP/Example/Device Library -> Dave Site: Work with: select Dave APPS Library Manager Help -> Install Dave APP/Example/Device Library -> Dave Site: Work with: select Contributed Dave APPS Library Manager Note: Select All and install all/everything Note: In case your Update Process is frozen check your network connection: Window -> Preferences -> General -> Network Connections -> Active Provider -> change from Direct (= default after installation) to Native (Company-Proxy) -> Apply -> OK Cookery-Book 10

11 1.) Using Dave Part 1: Transmit Data To The Serial Terminal Program Create your Dave CE project and select the XMC1400 microcontroller: Dave Digital Application virtual/valuable/verbose Engineer CE Code Engine/Generator File New click DAVE Project Cookery-Book 11

12 Project Name: insert XMC1400_BootKit_HelloWorld Project Type: select Dave CE Project Click Next Cookery-Book 12

13 Microcontrollers -> XMC1400 Series: select XMC1404-Q064X0200 Click Finish Cookery-Book 13

14 Cookery-Book 14

15 Click Cookery-Book 15

16 Add New APP -> Communication -> General Purpose -> select/click UART Click Add, click Close Cookery-Book 16

17 Double click UART UART_0 Cookery-Book 17

18 Note: Window -> Reset Perspective restores your IDE windows/perspective/view anytime! Cookery-Book 18

19 UART_0 Configuration: UART_0 -> General Settings -> Operating mode: check Full Duplex UART_0 -> General Settings -> Desired speed[baud]: insert 9600 <ENTER> Note: Validate each alpha numeric entry by pressing <ENTER>. Cookery-Book 19

20 UART_0 -> Advanced Settings -> Protocol Handling -> Transmit mode: check/select Interrupt UART_0 -> Advanced Settings -> Protocol Handling -> Receive mode: select Direct UART_0 -> Advanced Settings -> FIFO Settings: click to untick Enable transmit FIFO UART_0 -> Advanced Settings -> FIFO Settings: click to untick Enable receive FIFO Cookery-Book 20

21 Note: To understand the difference between Interrupt und Direct see APP Help: Right mouse button click at UART-APP: click APP Help Cookery-Book 21

22 APP Help: see UART Documentation, e.g. Architecture Description, Methods, Cookery-Book 22

23 APP Help: see UART Documentation, Methods: Cookery-Book 23

24 UART_0 -> Interrupt Settings -> Transmit: tick End of transmit callback: Click OK Cookery-Book 24

25 UART_0 -> Interrupt Settings -> Transmit: End of transmit callback: insert fendoftransmitcallback <ENTER> Cookery-Book 25

26 UART_0 -> Pin Settings: tick Enable advanced pin characteristics Cookery-Book 26

27 UART Pin Connection: Right mouse button click at UART UART_0 (APP): click Manual Pin Allocator Cookery-Book 27

28 Manual Pin Allocator -> UART_0 -> Receive Pin: select #31 (P1.3) Manual Pin Allocator -> UART_0 -> Transmit Pin: select #32 (P1.2) Click Save, click Close Cookery-Book 28

29 Note: Cookery-Book 29

30 Note: Cookery-Book 30

31 Generate your file system: Click Generate Code Cookery-Book 31

32 Insert your application specific program: Note: Dave doesn t change code in main.c Cookery-Book 32

33 Change Dave s Perspective from DAVE CE to DAVE IDE: -> Click DAVE IDE Cookery-Book 33

34 Double click MAIN.C: Cookery-Book 34

35 Double click MAIN.C and delete everything (e.g. Strg+A and DELETE): Cookery-Book 35

36 Double click MAIN.C and insert Code: #include <DAVE.h> // Declarations from DAVE Code Generation (includes SFR declaration) #include <stdio.h> #include <ctype.h> #include <string.h> #include <stdbool.h> // ***** defines: ***** // ***** Global Variables: ***** // Transmit: const unsigned char ucarraymenu[] = "\n" "1... LEDs ON\n" "2... LEDs OFF\n" "3... LEDs Toggle\n" "4... LEDs Blinking\n" "\n" "your choice: "; unsigned int ucstringlength1 = 0; unsigned int ucstringlength2 = 0; char mb[200]; // MessageBuffer for sprintf() unsigned int imainmenuloopcounter = 0; bool btransmitbusy = true; // ***** function prototypes: ***** // Transmit: void fmyprintf(const unsigned char *p); void fendoftransmitcallback(void); int main(void) { DAVE_Init(); // Initialization of DAVE APPs imainmenuloopcounter++; sprintf(mb,"\n\n\n*** MainMenuLoopCounter = %d ***",imainmenuloopcounter); // Write formatted data to string mb (MesssageBuffer) fmyprintf(mb); while (btransmitbusy); fmyprintf(ucarraymenu); while (btransmitbusy); while(1u) Cookery-Book 36

37 { //=================================================================================== ====== //=================================================================================== ====== } } void fendoftransmitcallback(void) { btransmitbusy = false; } void fmyprintf(const unsigned char *p) { unsigned char *helpstarttextpointer = p; btransmitbusy = true; // will be cleared by fendoftransmitcallback ucstringlength1 = 0; ucstringlength2 = strlen(p); while(*p) { ucstringlength1++; *p++; } } if(ucstringlength1 == ucstringlength2) { UART_Transmit(&UART_0, helpstarttextpointer, ucstringlength2); } Cookery-Book 37

38 Cookery-Book 38

39 Generate your application program: Click Rebuild Active Project Cookery-Book 39

40 Cookery-Book 40

41 Connect the XMC1400 BootKit to the host computer: USB Connection USB Connection: Note: A USB driver is installed the first time while connecting the XMC1400 BootKit via USB to your host computer. Note: A default virtual COM Port is generated. Cookery-Book 41

42 Connecting a serial terminal program (e.g. Docklight): Start Docklight Click X Cookery-Book 42

43 Click Project Settings: Cookery-Book 43

44 Project Settings -> Communication Mode -> Send/Receive on Comm. Channel: select YOUR COM Project Settings -> COM Port Settings -> Baud Rate: select/check 9600 Cookery-Book 44

45 Check: Click OK Cookery-Book 45

46 Click Connect: Cookery-Book 46

47 Configure what you want to send (1, 2, 3, 4, 5) to the XMC1400 BootKit: Double click inside : Insert 1 <Tab key> 1 Click OK Cookery-Book 47

48 Repeat for 2, 3, 4, and 5 and see the result: And click Connect again Cookery-Book 48

49 Docklight is ready: Cookery-Book 49

50 Configure/Start/Launch the debugger: Click Debug Cookery-Book 50

51 Double click GDB SEGGER J-Link Debugging Cookery-Book 51

52 Click Debug Cookery-Book 52

53 If asked Do you want to update to the latest firmware version? > click Yes Cookery-Book 53

54 Tick Remember my decision Click Yes Cookery-Book 54

55 Welcome to the Debug perspective: Cookery-Book 55

56 And start your program: Click Resume (F8) Cookery-Book 56

57 And see the result: Cookery-Book 57

58 Terminate the Debugger Connection: Click Terminate: Cookery-Book 58

59 And go back to the DAVE CE perspective/view: Cookery-Book 59

60 Part 2: Receive Data From The Terminal Program Click Add New APP Cookery-Book 60

61 Add New App -> System: select/click INTERRUPT Click Add, click Close Cookery-Book 61

62 Cookery-Book 62

63 Right mouse button click at INTERRUPT INTERRUPT_0 click Rename Instance Label Cookery-Book 63

64 Insert INT_UART_Receive Click OK Cookery-Book 64

65 Double click INTERRUPT INT_UART_Receive Cookery-Book 65

66 Interrupt Settings -> Interrupt handler: insert INT_UART_Receive_ISR <ENTER> Cookery-Book 66

67 Dave Signal Connection (UART_0 Receive -> INT_UART_Receive): Right mouse button click UART UART_0 (APP) -> click HW Signal Connections Cookery-Book 67

68 HW Signal Connections: select event_std_receive, select INT_UART_Receive, select sr_irq Click Save, click Close Cookery-Book 68

69 You can see the result (Signal Connection) in the HW Signal Connectivity view: Cookery-Book 69

70 Click Generate Code: Cookery-Book 70

71 Change to DAVE IDE Perspective/view: Cookery-Book 71

72 Double click MAIN.C and insert Code: // Receive: uint8_t ucuartreceiveddataglobal = '\0'; volatile unsigned int uireceivedcounterglobal = 0; unsigned int uireceivedcounterold_global = 0; Cookery-Book 72

73 Double click MAIN.C and insert Code: if (uireceivedcounterold_global!= uireceivedcounterglobal) { switch (ucuartreceiveddataglobal) { case '1': fmyprintf("\n*** > LEDs ON!!! ***\n"); while (btransmitbusy); break; case '2': fmyprintf("\n*** > LEDs OFF!!! ***\n"); while (btransmitbusy); break; case '3': fmyprintf("\n*** > LEDs TOGGLED!!! ***\n"); while (btransmitbusy); break; case '4': fmyprintf("\n*** > LEDs BLINKING!!! ***\n"); while (btransmitbusy); break; case '5': ; break; default : ; break; } uireceivedcounterold_global = uireceivedcounterglobal; imainmenuloopcounter++; sprintf(mb,"\n\n\n*** MainMenuLoopCounter = %d ***",imainmenuloopcounter); // Write formatted data to string mb fmyprintf(mb); while (btransmitbusy); } fmyprintf(ucarraymenu); while (btransmitbusy); Cookery-Book 73

74 Cookery-Book 74

75 Double click MAIN.C and insert Code: void INT_UART_Receive_ISR (void) { uireceivedcounterglobal++; UART_Receive(&UART_0, &ucuartreceiveddataglobal, 1); } Cookery-Book 75

76 Click Rebuild Active Project Cookery-Book 76

77 Cookery-Book 77

78 Start the debugger: click Debug: Cookery-Book 78

79 Start the program: click Resume: Cookery-Book 79

80 And see the result in the Serial Terminal Program: Cookery-Book 80

81 Cookery-Book 81

82 Terminate the Debugger Connection: Click Terminate: Cookery-Book 82

83 And go back to the DAVE CE perspective/view: Cookery-Book 83

84 Part 3: Ports (LEDs) Click Add New APP Cookery-Book 84

85 Add New APP -> System: select/click DIGITAL_IO Click Add Cookery-Book 85

86 Click Add, click Add, click Add, click Close Cookery-Book 86

87 See the result: Cookery-Book 87

88 Rename IOs: Right mouse button click at DIGITAL_IO DIGITAL_IO_0 (APP): click Rename Instance Label insert LED_P4_P0 click OK Right mouse button click at DIGITAL_IO DIGITAL_IO_1 (APP): click Rename Instance Label insert LED_P4_P1 click OK Right mouse button click at DIGITAL_IO DIGITAL_IO_2 (APP): click Rename Instance Label insert LED_P4_P2 click OK Right mouse button click at DIGITAL_IO DIGITAL_IO_3 (APP): click Rename Instance Label insert LED_P4_P3 click OK And see the result: Cookery-Book 88

89 Change IOs from Input to Output: Double click LED_P4_P0: General Settings -> Pin direction: select Input/Output Double click LED_P4_P1: General Settings -> Pin direction: select Input/Output Double click LED_P4_P2: General Settings -> Pin direction: select Input/Output Double click LED_P4_P3: General Settings -> Pin direction: select Input/Output Cookery-Book 89

90 Connect IOs to Pins: Right mouse button click at LED_P4_P0: click Manual Pin Allocator -> Pin Number (Port): select #59 (P4.0) Click Save, click Close Cookery-Book 90

91 Right mouse button click at LED_P4_P1: click Manual Pin Allocator -> Pin Number (Port): select #60 (P4.1) Click Save, click Close Cookery-Book 91

92 Right mouse button click at LED_P4_P2: click Manual Pin Allocator -> Pin Number (Port): select #61 (P4.2) Click Save, click Close Cookery-Book 92

93 Right mouse button click at LED_P4_P3: click Manual Pin Allocator -> Pin Number (Port): select #62 (P4.3), Click Save, click Close Cookery-Book 93

94 Note: Cookery-Book 94

95 Note: Instead of the Manual Pin Allocater you can use you can use the Pin Mapping Perspective Cookery-Book 95

96 Click Pin Mapping Perspective: Cookery-Book 96

97 Change from Perspective Pin Mapping to Perpective DAVE IDE: Cookery-Book 97

98 Generate Code: click Generate Code Cookery-Book 98

99 Double click MAIN.C and insert Code: // LED Blinking: #define ON 1 #define OFF 0 Cookery-Book 99

100 Double click MAIN.C and insert Code: // LED Blinking: bool bledsblinkingstatusglobal = OFF; // used by the BLINKING INTERRUPT bool bledsonoffstatusglobal = OFF; // used by the fleds_toggle function Cookery-Book 100

101 Double click MAIN.C and insert Code: // LEDs: void fleds_on (void); void fleds_off (void); void fleds_toggle (void); Cookery-Book 101

102 Double click MAIN.C and DELETE the Switch Case Statement and insert the new Switch Case Statement: switch (ucuartreceiveddataglobal) { case '1': bledsblinkingstatusglobal = OFF, fleds_on(), fmyprintf("\n*** > LEDs ON!!! ***\n"); while (btransmitbusy); break; case '2': bledsblinkingstatusglobal = OFF, fleds_off(), fmyprintf("\n*** > LEDs OFF!!! ***\n"); while (btransmitbusy); break; case '3': bledsblinkingstatusglobal = OFF, fleds_toggle(), fmyprintf("\n*** > LEDs TOGGLED!!! ***\n"); while (btransmitbusy); break; case '4': bledsblinkingstatusglobal = ON, fmyprintf("\n*** > LEDs BLINKING!!! ***\n"); while (btransmitbusy); break; case '5': ; break; default : ; break; } Cookery-Book 102

103 Cookery-Book 103

104 Double click MAIN.C and insert Code: void fleds_on (void) { DIGITAL_IO_SetOutputLow(&LED_P4_P0); DIGITAL_IO_SetOutputLow(&LED_P4_P1); DIGITAL_IO_SetOutputLow(&LED_P4_P2); DIGITAL_IO_SetOutputLow(&LED_P4_P3); } bledsonoffstatusglobal = ON; void fleds_off (void) { DIGITAL_IO_SetOutputHigh(&LED_P4_P0); DIGITAL_IO_SetOutputHigh(&LED_P4_P1); DIGITAL_IO_SetOutputHigh(&LED_P4_P2); DIGITAL_IO_SetOutputHigh(&LED_P4_P3); } bledsonoffstatusglobal = OFF; void fleds_toggle (void) { if (bledsonoffstatusglobal == ON) { fleds_off(); } else { fleds_on(); } } Cookery-Book 104

105 Cookery-Book 105

106 Note: DAVE CE Perspective -> IO methods see APP Help: Right mouse button click at DIGITAL_IO: click APP Help Cookery-Book 106

107 Note: IO methods see APP Help: Cookery-Book 107

108 Note: IO methods see APP Help: Cookery-Book 108

109 Click Rebuild Active Project: Cookery-Book 109

110 Cookery-Book 110

111 Start the debugger: click Debug: Cookery-Book 111

112 Start the program: click Resume: Cookery-Book 112

113 And see the result in the Serial Terminal Program AND on the XMC1400 BootKit: e.g.: click 2, click 3: Cookery-Book 113

114 Terminate the Debugger Connection: Click Terminate: Cookery-Book 114

115 And go back to the DAVE CE perspective/view: Cookery-Book 115

116 Part 4: Blinking LEDs (SystemTimer) Click Add New APP: Cookery-Book 116

117 Add New APP -> System: select/click SYSTIMER Click Add, click Close Cookery-Book 117

118 Cookery-Book 118

119 Rename SYSTIMER: Right mouse button click at SYSTIMER SYSTIMER_0: click Rename Instance Label Cookery-Book 119

120 insert SoftwareTimer1ms click OK Cookery-Book 120

121 Double click SYSTIMER SoftwareTimer1ms: General Settings: Number of software timers: insert 1 <ENTER> Cookery-Book 121

122 Generate Code: click Generate Code Cookery-Book 122

123 Change from Perspective DAVE CE to Perspective DAVE IDE: Cookery-Book 123

124 Double click MAIN.C and insert Code: // SoftwareTimer: #define ONESEC U Cookery-Book 124

125 Double click MAIN.C and insert Code: // LEDs Blinking: void feverysecond (void); Cookery-Book 125

126 Double click MAIN.C and insert Code: uint32_t SoftwareTimer; SYSTIMER_STATUS_t statussystimer; Cookery-Book 126

127 Double click MAIN.C and insert Code: SoftwareTimer = (uint32_t)systimer_createtimer(onesec,systimer_mode_periodic,(void*)feverysecond,null ); if (SoftwareTimer!= 0U) { ; // Software timer is created successfully } else { while (1); // Software timer creation is failed } statussystimer = SYSTIMER_StartTimer(SoftwareTimer); if (statussystimer == SYSTIMER_STATUS_SUCCESS) { ; // Software timer is running } else { while (1); // Error during Software timer start operation } Cookery-Book 127

128 Cookery-Book 128

129 Double click MAIN.C and insert Code: void feverysecond (void) { if (bledsblinkingstatusglobal == ON) { fleds_toggle(); } } Cookery-Book 129

130 Cookery-Book 130

131 Click Rebuild Active Project: Cookery-Book 131

132 Cookery-Book 132

133 Note: SYSTIMER: methods see APP Help: DAVE CE Perspective -> right mouse button click at SYSTIMER SoftwareTimer1ms -> APP Help: Cookery-Book 133

134 Note: SYSTIMER: methods see APP Help: DAVE CE Perspective -> right mouse button click at SYSTIMER SoftwareTimer1ms -> APP Help -> click Methods: Cookery-Book 134

135 Start the debugger: click Debug: Cookery-Book 135

136 Start the program: click Resume: Cookery-Book 136

137 And see the result in the Serial Terminal Program AND on the XMC1400 BootKit: Cookery-Book 137

138 Terminate the Debugger Connection: Click Terminate: Cookery-Book 138

139 And go back to the DAVE IDE perspective/view: Cookery-Book 139

140 Save your XMC1400 Hello World project: File > Export Cookery-Book 140

141 Export -> Select: select/expand Infineon: select/click DAVE Projects Click Next Cookery-Book 141

142 Tick XMC1400_BootKit_HelloWorld, click Select Archive File, click Browse Cookery-Book 142

143 Export To Archive File: Select/Create any Windows Directory of your choice (e.g. C:\XMC1400_Hello-World) File name: e.g. insert XMC1400_BootKit_HelloWorld Click Save Cookery-Book 143

144 Click Finish File - Exit Cookery-Book 144

145 Conclusion: In this step-by-step book you have learned how to use the XMC1400 BootKit together with the Dave tool chain. Now you can easily expand your hello world program to suit your needs! You can connect either a part of - or your entire application to the XMC1400 BootKit. You are also able to benchmark any of your algorithms to find out if the selected microcontroller fulfils all the required functions within the time frame needed. Have fun and enjoy working with the XMC1400 BootKit! Cookery-Book 145

146 5.) Feedback (XMC1400, BootKit, Hello World): Your opinion, suggestions, and/or criticisms If you have any suggestions please give feedback to: Your suggestions/ideas: Cookery-Book 146

147