XMC4700/XMC4800 RelaxKit HelloWorld (USB)

Transcription

1 Cookery-Book, V1.0, A pril 2017 XMC4700/XMC4800 RelaxKit HelloWorld (USB) Programming ( Hello World ) an Infineon XMC4700 (ARM Cortex M4) 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 Softw are 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 XMC4700 RelaxKit 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 XMC4700 RelaxKit. 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 XMC4700 RelaxKit! Cookery-Book 2

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

4 Used/selected microcontroller: XMC4700 Block Diagram (Source: Manual/DataSheet) Note: Just by looking at the block diagram, you should be able to get a picture of the microcontroller and to answer some of your initial questions. Cookery-Book 4

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

6 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 6

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

8 Cookery-Book 8

9 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 9

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

11 Project Name: insert XMC4700_RelaxKit_HelloWorld_USB Project Type: select Dave CE Project Click Next Cookery-Book 11

12 Microcontrollers -> XMC4000 -> XMC4700 Series: select XMC4700-F144F2048 Click Finish Cookery-Book 12

13 Cookery-Book 13

14 Click Add New APP Cookery-Book 14

15 Add New APP -> Communication -> USB -> Device -> select/click USBD_VCOM Click Add, click Close Note: USB virtual COM port application: This Dave APP implements the VCOM over USB CDC class driver (USB Communications Device Class). Cookery-Book 15

16 Double click USBD_VCOM Cookery-Book 16

17 Cookery-Book 17

18 Note (Eclipse hint): Window -> Reset Perspective restores your IDE windows/perspective/view anytime! Click Yes Cookery-Book 18

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

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

21 Note: We are going to copy some code from APP Help: Right mouse button click at USBD_VCOM: click APP Help Cookery-Book 21

22 Click Methods Cookery-Book 22

23 Cookery-Book 23

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

25 Double click MAIN.C: Cookery-Book 25

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

27 Double click MAIN.C and insert Code: #include <DAVE.h> #include <stdio.h> #include <ctype.h> #include <string.h> #include <stdbool.h> // ***** Defines: ***** // ***** Global Variables: ***** // Delay: volatile uint32_t i = 0; // 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: "; char mb[200]; // MessageBuffer for sprintf() unsigned int imainmenuloopcounter = 0; // Receive: uint16_t bytesreceived = 0; uint8_t ucuartreceiveddata = '\0'; // ***** Function Prototypes: ***** // Delay: static void delay(uint32_t cycles); // Transmit: void fmyprintf(const unsigned char *p); void main(void) { DAVE_Init(); USBD_VCOM_Connect(); while (!USBD_VCOM_IsEnumDone()); while(!cdc_event_flags.line_encoding_event_flag); delay(0xffff); // Ensure the status of line encoding request is properly send to host imainmenuloopcounter++; sprintf(mb,"\n\n\n*** MainMenuLoopCounter = %d ***",imainmenuloopcounter); // Write formatted data to string mb (MesssageBuffer) fmyprintf(mb); Cookery-Book 27

28 fmyprintf(ucarraymenu); while(1) { bytesreceived = USBD_VCOM_BytesReceived(); if (bytesreceived == 1) { USBD_VCOM_ReceiveByte(&ucUartReceivedData); switch (ucuartreceiveddata) { case '1': fmyprintf("\n*** > LEDs ON!!! ***\n"); break; case '2': fmyprintf("\n*** > LEDs OFF!!! ***\n"); break; case '3': fmyprintf("\n*** > LEDs TOGGLED!!! ***\n"); break; case '4': fmyprintf("\n*** > LEDs BLINKING!!! ***\n"); break; case '5': ; break; default : ; break; } imainmenuloopcounter++; sprintf(mb,"\n\n\n*** MainMenuLoopCounter = %d ***",imainmenuloopcounter); // Write formatted data to string mb fmyprintf(mb); fmyprintf(ucarraymenu); } } } static void delay(uint32_t cycles) { for(i = 0; i < cycles; ++i) { NOP(); } } void fmyprintf(const unsigned char *p) { USBD_VCOM_SendString(p); CDC_Device_USBTask(&USBD_VCOM_cdc_interface); } Cookery-Book 28

29 Cookery-Book 29

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

31 Cookery-Book 31

32 Connect the XMC4700 RelaxKit (Debugger) to the host computer: USB Connection (Debugger!) Cookery-Book 32

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

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

35 Click Debug Cookery-Book 35

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

37 Tick Remember my decision Click Yes Cookery-Book 37

38 Welcome to the Debug perspective: Cookery-Book 38

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

40 Connect the XMC4700 RelaxKit (Application) to the host computer: USB Connection (Debugger!) USB Connection (Application!) Cookery-Book 40

41 Cookery-Book 41

42 Note: A USB driver must be installed the first time while connecting the XMC4700 RelaxKit via USB to your host computer. Note: A default virtual COM Port is generated. Note: Installation of USB Driver on your PC: Connect USB Connection (Application). Open Windows Device Manager. Select Unknown Device. Choose the option in the properties to update the driver. Use the manual driver location and point to: C:\DAVE_4_3_2_Workspace_HelloWorld\XMC4700_RelaxKit_HelloWorld_USB\Dave\Generate d\usbd_vcom\inf Cookery-Book 42

43 Cookery-Book 43

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

45 Click Project Settings: Cookery-Book 45

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

47 Check: Click OK Cookery-Book 47

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

49 Repeat for 2, 3, 4, and 5 and see the result: Click Connect Cookery-Book 49

50 Docklight is ready: And see the result: Cookery-Book 50

51 Send/insert/click 1, 2, 3, and 4: Cookery-Book 51

52 Cookery-Book 52

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

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

55 Part 2: Ports (LEDs) Click Add New APP Cookery-Book 55

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

57 Click Add, click Close Cookery-Book 57

58 See the result: Cookery-Book 58

59 Rename IOs: Right mouse button click at DIGITAL_IO DIGITAL_IO_0 (APP): click Rename Instance Label Cookery-Book 59

60 Insert LED_P5_P8 Click OK Cookery-Book 60

61 Right mouse button click at DIGITAL_IO DIGITAL_IO_1 (APP): click Rename Instance Label Cookery-Book 61

62 Insert LED_P5_P9 Click OK Cookery-Book 62

63 And see the result: Cookery-Book 63

64 Change IOs from Input to Output: Double click LED_P5_P8: General Settings -> Pin direction: select Input/Output Cookery-Book 64

65 Double click LED_P5_P9: General Settings -> Pin direction: select Input/Output Cookery-Book 65

66 Connect IOs to Pins: Right mouse button click at LED_P5_P8: click Manual Pin Allocator Cookery-Book 66

67 Pin Number (Port): select #58 (P5.8) Click Save, click Close Cookery-Book 67

68 Right mouse button click at LED_P5_P9: click Manual Pin Allocator Cookery-Book 68

69 Pin Number (Port): select #57 (P5.9) Click Save, click Close Cookery-Book 69

70 Note: LEDs: Cookery-Book 70

71 Cookery-Book 71

72 Cookery-Book 72

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

74 Pin Mapping Perspective: Cookery-Book 74

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

76 Generate Code: click Generate Code Cookery-Book 76

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

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

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

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

81 Cookery-Book 81

82 Double click MAIN.C and insert Code: void fleds_on (void) { DIGITAL_IO_SetOutputHigh(&LED_P5_P8); DIGITAL_IO_SetOutputHigh(&LED_P5_P9); } bledsonoffstatusglobal = ON; void fleds_off (void) { DIGITAL_IO_SetOutputLow(&LED_P5_P8); DIGITAL_IO_SetOutputLow(&LED_P5_P9); } bledsonoffstatusglobal = OFF; void fleds_toggle (void) { if (bledsonoffstatusglobal == ON) { fleds_off(); } else { fleds_on(); } } Cookery-Book 82

83 Cookery-Book 83

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

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

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

87 Click Rebuild Active Project: Cookery-Book 87

88 Cookery-Book 88

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

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

91 And see the result in the Serial Terminal Program AND on the XMC4700 RelaxKit: e.g.: send/insert/click 1, send/insert/click 2, send/insert/click 3: Cookery-Book 91

92 Cookery-Book 92

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

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

95 Part 3: Blinking LEDs (SystemTimer) Click Add New APP: Cookery-Book 95

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

97 Cookery-Book 97

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

99 Insert SoftwareTimer1ms Click OK Cookery-Book 99

100 Double click SYSTIMER SoftwareTimer1ms: General Settings: Number of software timers: insert 1 <ENTER> Note: Validate each alpha numeric entry by pressing <ENTER>. Cookery-Book 100

101 Generate Code: Click Generate Code Cookery-Book 101

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

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

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

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

106 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 106

107 Cookery-Book 107

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

109 Cookery-Book 109

110 Click Rebuild Active Project: Cookery-Book 110

111 Cookery-Book 111

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

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

114 Start the debugger: Click Debug: Cookery-Book 114

115 Start the program: Click Resume: Cookery-Book 115

116 And see the result in the Serial Terminal Program AND on the XMC4700 RelaxKit: e.g.: send/insert/click 3, send/insert/click 4: Cookery-Book 116

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

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

119 Save your XMC4700 Hello World (USB) project: File > Export Cookery-Book 119

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

121 Tick XMC4700_RelaxKit_HelloWorld, click Select Archive File, click Browse Cookery-Book 121

122 Export To Archive File: Select/Create any Windows Directory of your choice (e.g. C:\XMC4700_Hello-World_USB) File name: e.g. insert XMC4700_RelaxKit_HelloWorld_USB Click Save Cookery-Book 122

123 Click Finish File - Exit Cookery-Book 123

124 Conclusion: In this step-by-step book you have learned how to use the XMC4700 RelaxKit 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 XMC4700 RelaxKit. 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 XMC4700 RelaxKit! Cookery-Book 124

125 4.) Feedback (XMC4700, RelaxKit, Hello World, USB): Your opinion, suggestions, and/or criticisms If you have any suggestions please give feedback to: Your suggestions/ideas: Cookery-Book 125

126