Learn about the five main categories of C/C++ compiler configuration options that HEW provides. Understand how to configure each of these options

Transcription

1 Introduction Purpose This training course describes how to configure the the C/C++ compiler options of the High-performance Embedded Workshop (HEW), a key tool for developing software for embedded systems that use microcontrollers (MCUs) from Renesas Technology Corp. Objectives Learn about the five main categories of C/C++ compiler configuration options that HEW provides. Understand how to configure each of these options Content 43 pages 5 questions Learning Time 60 minutes 1

2 Invoking C/C++ Configuration Click on Build Select H8 Standard Toolchain C/C++ settings for a specific project/ files configuration can be selected here. Here are the corresponding command line entries for all settings in the HEW linker dialog. 2

3 Options in C/C++ Compiler Five categories of options 1. Source 2. Object 3. List 4. Optimize 5. Other To configure the source-file related information; for example, location of the include files, etc. To configure the type of output format for source files, section specification for source files, etc. To select the type of listing file generated for C and C ++ files. To configure the optimization for the C and C++ files during compilation To configure other miscellaneous options 3

4 Overview of Source Category Source settings Include file directories PreInclude files Defines Messages Message level File inline path 4

5 Includes, Preincludes, Defines Source settings Include file directories - Specifies path for include files PreInclude files - Specify an include file that will be inserted into head of a C/C++ source file Defines - Specify definitions of macro names; e.g., #define DEBUG 1 5

6 Display of Information Messages Source settings Messages - Configures the informationlevel messages to be displayed during compilation - Default: Unchecked to keep build output messages as clean as possible Example (command line) ch38 -nomessage=5, test.c 6

7 Adjusting the Level of Messages Source settings Message level - Changes message level of different types of messages that are displayed during compilation - Available settings: - Default - Information - Warning - Error - Custom (such as, error=200) H8S, H8/300 Series C/C++ Compiler, Assembler, Optimizing Linkage Editor User s Manual. User s Manual 7

8 Inter-file Inline Expansion Source settings File inline path* can be used to add location of files for inter-file inline expansion - Add, insert, and remove the path in the list box - Set path priority - Double-click on path to modify the entry in the Include Files Directory * Available only for the following CPUs: AE5 H8SX H8S without Legacy=v4 option 8

9 PROPERTIES On passing, 'Finish' button: On failing, 'Finish' button: Allow user to leave quiz: User may view slides after quiz: User may attempt quiz: Goes to Next Slide Goes to Slide After user has completed quiz After passing quiz Unlimited times

11 Overview of Object Category Object settings Choose Output file type Configure Section Select Multiply/Divide operation specification Select Template Choose Data string storage location Specify variables boundary alignment Modify output directory Select generate debug information choice

12 Files Generated by the Compiler Object settings Output file type - Machine code - Assembly source code - Preprocessed source file* * When this option is selected, no object code is generated, so many of the toolchain settings options no longer apply. 12

13 Section Names Can Be Entered Object settings Options for Section configuration - Program code section - Const data section - Data section - Un-initialized data section 13

14 Multiply/Divide Operations Object settings Multiplication and division operations can be handled in different ways - Based on ANSI* - Non ANSI* - Non ANSI ver6.0* * Available only for the following CPUs: H8/300 H8/300H H8S with Legacy=v4 option 14

15 Specify Template Instances Object settings Five choices for conditions for generating Template instances - None - Static - Used - All - Auto 15

16 String Data Storage Location Object settings Store string data in - Const section - Data section 16

17 Variables Alignment Boundary Object settings Group by alignment - None - Auto - 4byte 17

20 Overview of List Category List Settings Generate list file* - Determines whether or not list file is generated - If selected, enables various options * Not available when Preprocessed source file is selected for the Output file type 20

21 List File Tab Size, Contents List Settings File tab size Contents - Object list - Statistics - Allocation information - Source code listing - After preprocessor expansion 21

23 Overview of Optimize Category Optimization settings Enable optimization* Select type of optimization: Speed or Size Configure details optimization Configure Switch statement generation Configure Function calls indirect addressing mode Specify Data access mode Select Generate file for inter-module optimization source choicefile is selected for the * Not available when Preprocessed source file is selected for the Output file type 23

24 Choice of Optimization Type Optimization settings Size oriented* Speed oriented* Like other compiler options, you can set different optimizations for individual files by first selecting them in the left-hand navigation pane before changing the option. * Not available when Preprocessed source file is selected for the Output file type Size option does not provide a Configuration option 24

25 Speed Optimization Choices Optimization Settings For Speed only - Register - Switch judgment - Shift to multiple - Structure assignment - Expression - Loop optimization - Loop unrolling - Inline function 25

26 Switch Statement Generation Optimization settings Options for generating code for switch statements apply to both Speed and Size optimization - Auto - If then - Table 26

27 Memory Indirect Addressing Optimization settings For Size optimization, Function calls can be made using different memory indirect addressing modes (None) (Normal) section $INDIRECT (Extended) section $EXINDIRECT None Normal Extended 27

28 Access Statically Allocated Data Optimization settings Data access modes for Size optimization None 8-bit absolute addressing 16-bit absolute addressing 28

29 Optimize Details: 3 Categories Optimization settings Inline* Global variables Miscellaneous * Available only for the following CPUs: AE5 H8SX H8S without Legacy=v4 option 29

30 Treatment of Global Variables Optimization settings Four choices for levels: - Level 1 - Level 2 - Level 3 - Custom* * Available only for the following CPUs: AE5 H8SX H8S without Legacy=v4 option 30

31 Global Variable Custom Settings Optimization settings Specify optimizing range - All* - No loop* - No block* * These Custom settings are available only for the following CPUs: AE5 H8SX H8S without Legacy=v4 option 31

32 Customize Register Allocations Optimization settings Allocate registers to global variables - Disable* - Enable* - Default* * Available These Custom only for settings the following are available CPUs: only for AE5 the following CPUs: H8SX AE5 H8SX without Legacy=v4 option H8S without Legacy=v4 option 32

33 Propagation of Global Variables Optimization settings Propagate variables which are const qualified - Disable* - Enable* - Default* Example const int x = 1; int A; void f() { A = x; } void f() { A = 1; /* x = 1 is propagated */ } * These Custom settings are available only for the following CPUs: AE5 H8SX H8S without Legacy=v4 option 33

34 Miscellaneous Category Optimization settings Select Delete vacant-loop choice* Specify maximum unroll factor* Select Allocate registers to structure choice* Select Inline memcpy/strcpy choice** * Available only for the following CPUs: AE5 H8SX H8S without Legacy=v4 option ** Available only for the following CPUs: AE5 H8SX 34

37 Overview of Other Category Other Settings Miscellaneous options User defined options 37

38 Additional Settings Choices Other Settings Miscellaneous options - Allow comment nest - Check EC++ language* - Interrupt handler saves/restores MACH and MACL registers - Enum treatment - Register variable increase - Put common sub-expression on register temporarily * Must be enabled if EC++ library is used. 38

39 Misc. and User Defined Choices Other settings Miscellaneous options - Use EEPMOV in block copy - Loop condition treatment - Suppress #line - Enable register declaration - Obey ANSI specification* Use EEPMOV in in block copy Disable optimization of of loop iteration condition Suppress #line Enable register definition User defined options - change_message= error * Valid only for AE5, H8SX, and H8S without Legacy=v4 option CPU types. Invalid if Preprocessed source file is selected for Output file type Generate your own options here. 39

40 C/C++ Configuation Flexibility Toolchain configuration options Apply settings to match your needs - To specific files - To entire C files only - To entire C++ files only If HEW displays the set of files or folder you have selected in a gray color rather than tan, those files have multiple settings. 40

43 Course Summary Categories for C/C++ files configuration What the many various settings are and do Application of toolchain configuration Download a free evaluation copy of HEW at: 43