fr/f2mc family softune c analyzer manual ... information on the project management method of source...

FUJITSU SEMICONDUCTORCONTROLLER MANUAL

FR/F2MC FAMILY

SOFTUNE C ANALYZER MANUALfor V3

CM81-00303-5E

FR/F2MC FAMILY

SOFTUNE C ANALYZER MANUALfor V3

FUJITSU LIMITED

PREFACE

� Objectives and Intended Reader

The Softune C Language Analyzer (called the C Analyzer in this document) is a developmentsupport tool to be incorporated into the system. The C Analyzer displays and prints thestructure of a source program written in the C language and the status of data being used by theprogram.

The C Analyzer runs Windows XP, Windows Me, Windows 2000, Windows 98 and Windows NT 4.0.

This manual explains the functions and usage of the C Analyzer.

This manual is intended for persons using the C Analyzer to analyze source programs written inthe C language.

The C Analyzer can only analyze C programs that conform to the "American National Standardfor Information System Programming Language C, X3. 159-1989" (called the ANSI Standard inthis document).

Readers of this manual must be familiar with the basic operation of Windows XP, Windows Me,Windows 2000, Windows 98 or Windows NT 4.0 and must have basic knowledge of the Clanguage specification.

For information about the C language specifications, refer to the "Programming Language C JISX3010-1993" or a reference book complying with ANSI standards.

� Trademarks

SOFTUNE is a trademark of FUJITSU LIMITED.

Microsoft, Windows, Windows NT, and MS-DOS are registered trademarks of MicrosoftCorporation in the U.S. and other countries.

The names of products and systems appearing in this manual are trademarks or registeredtrademarks of their respective companies.

� Structure of This Manual

For an outline of the C Analyzer, read CHAPTER 1 "OVERVIEW."

To analyze source programs using the C Analyzer, read CHAPTER 2 "ANALYSISPROCEDURE," and CHAPTER 5 "ANALYZE."

For information on the project management method of source files to be analyzed, readCHAPTER 3 "PROJECT."

For information on how to handle source files to be analyzed, read CHAPTER 4 "FILE," andCHAPTER 6 "EDIT."

For information on the displayed window status and setting method, read CHAPTER 7 "VIEW,"and CHAPTER 12 "WINDOWS."

To compile source programs, read CHAPTER 8 "COMPILE."

To check source programs, read CHAPTER 9 "CHECK."

i

For information on data utilization in the analyzed source program, read CHAPTER 10"GLOBAL INFORMATION;" CHAPTER 19 "SUMMARY;" and CHAPTER 20 "CROSSREFERENCE."

For information on the settings of the C Analyzer, read CHAPTER 11 "SETUP."

For information on how to use help files, read CHAPTER 13 "HELP."

For information on the internal structure of the analyzed source program, read CHAPTER 15"Analysis Information (Graph Flow);" CHAPTER 16 "CALL TREE;" and CHAPTER 18 "LOGICFLOW."

For information on a listing of functions of the analyzed source program, read CHAPTER17"FUNCTION NAME LIST."

To edit source programs, read CHAPTER 21 "PROGRAM EDITING."

To tune source programs for the FR Family Softune C compiler, read CHAPTER 22 "MAXUSED STACK;" and CHAPTER 23 "USED STACK INFORMATION."

To print analyzed results, read CHAPTER 14 "PRINTING."

If questions or problems occur during operation of the C Analyzer, read APPENDIX A"TROUBLESHOOTING."

This chapter consists of the following 23 chapters and an appendix:

CHAPTER 1 "OVERVIEW"

This chapter provides an overview of analyzing C source programs using the C Analyzer.

CHAPTER 2 "ANALYSIS PROCEDURE"

This chapter explains the procedure for analyzing C source programs using the C Analyzer.

CHAPTER 3 "PROJECT"

This chapter explains how to create and handle projects.

CHAPTER 4 "FILE"

This chapter explains how to create and handle files.

CHAPTER 5 "ANALYZE"

This chapter explains how to use the C Analyzer for file analysis.

CHAPTER 6 "EDIT"

This chapter explains how to use the C Analyzer for editing files.

CHAPTER 7 "VIEW"

This chapter explains how to use the C Analyzer for displaying files.

CHAPTER 8 "COMPILE"

This chapter explains the compilation functions.

CHAPTER 9 "CHECK"

This chapter explains the check functions.

CHAPTER 10 "GLOBAL INFORMATION"

This chapter explains the operation of global information.

CHAPTER 11 "SETUP"

This chapter explains how to set up the C Analyzer.

ii

CHAPTER 12 "WINDOWS"

This chapter explains how to display and use windows.

CHAPTER 13 "HELP"

This chapter explains how to display and use help information.

CHAPTER 14 "PRINTING"

This chapter explains the print functions and how to use them.

CHAPTER 15 "GRAPH FLOW"

This chapter explains how to display and use graph flow windows.

CHAPTER 16 "CALL TREE"

This chapter explains how to display and use analysis information (tree view).

CHAPTER 17 "FUNCTION NAME LIST"

This chapter explains how to display and use a listing of function names.

CHAPTER 18 "LOGIC FLOW"

This chapter explains how to display logic flow windows.

CHAPTER 19 "SUMMARY"

This chapter explains how to display and use statistics.

CHAPTER 20 "CROSS REFERENCE"

This chapter explains how to display and use cross-reference information.

CHAPTER 21 "PROGRAM EDITING"

This chapter explains how to start the standard editor and edit programs.

CHAPTER 22 "MAX USED STACK"

This chapter explains how to display and use the max used stack.

CHAPTER 23 "USED STACK INFORMATION"

This chapter explains the used stack information and max used stack.

APPENDIX A "TROUBLESHOOTING"

This appendix explains troubleshooting.

� Reference Documents

THE C PROGRAMMING LANGUAGE (Brian W. Kernighan & Dennis M. Ritchie)

Japanese Version of "Programming Language C UNIX-like Programming" (translated by H.Ishida)

American National Standard for Infornmation Systems - Programming Language C, X3. 159-1989

Japanese Industrial Standard Programming Language C

(Japanese Standards Association)

iii

©2002 FUJITSU LIMITED Printed in Japan

• The contents of this document are subject to change without notice. Customers are advised to consultwith FUJITSU sales representatives before ordering.

• The information and circuit diagrams in this document are presented as examples of semiconductordevice applications, and are not intended to be incorporated in devices for actual use. Also, FUJITSU isunable to assume responsibility for infringement of any patent rights or other rights of third partiesarising from the use of this information or circuit diagrams.

• The products described in this document are designed, developed and manufactured as contemplatedfor general use, including without limitation, ordinary industrial use, general office use, personal use, andhousehold use, but are not designed, developed and manufactured as contemplated (1) for useaccompanying fatal risks or dangers that, unless extremely high safety is secured, could have a seriouseffect to the public, and could lead directly to death, personal injury, severe physical damage or otherloss (i.e., nuclear reaction control in nuclear facility, aircraft flight control, air traffic control, masstransport control, medical life support system, missile launch control in weapon system), or (2) for userequiring extremely high reliability (i.e., submersible repeater and artificial satellite). Please note that Fujitsu will not be liable against you and/or any third party for any claims or damagesarising in connection with above-mentioned uses of the products.

• Any semiconductor devices have an inherent chance of failure. You must protect against injury, damageor loss from such failures by incorporating safety design measures into your facility and equipment suchas redundancy, fire protection, and prevention of over-current levels and other abnormal operatingconditions.

• If any products described in this document represent goods or technologies subject to certainrestrictions on export under the Foreign Exchange and Foreign Trade Law of Japan, the priorauthorization by Japanese government will be required for export of those products from Japan.

iv

READING THIS MANUAL

� Product Names

In this manual and this product, product names are designated as follows:

SOFTUNE is designated as Softune.

The Microsoft® Windows® 98 operating system is abbreviated to Windows 98.

The Microsoft® Windows® Millennium Edition operating system is abbreviated to Windows Me.

The Microsoft® Windows NT® Workstation operating system Version 4.0 and the Microsoft®

Windows NT® Server network operating system Version 4.0 are abbreviated to Windows NT 4.0.

The Microsoft® Windows® 2000 Professional operating system is abbreviated to Windows 2000.

The Microsoft® Windows® XP Professional operating system is abbreviated to Windows XP.

� Note on Descriptions

The examples of windows and screens shown in this manual are those displayed when the CAnalyzer operates on Windows 2000. Actual windows and screens may vary depending on theoperating system, environment, computer model, and display resolution.

v

CONTENTS

CHAPTER 1 OVERVIEW ................................................................................................... 11.1 What Is the C Analyzer? ........................................................................................................................ 21.2 Window Configuration ............................................................................................................................ 31.3 Basic Functions ..................................................................................................................................... 9

1.3.1 Project ............................................................................................................................................ 111.3.2 File .................................................................................................................................................. 131.3.3 Analyze ........................................................................................................................................... 141.3.4 Edit ................................................................................................................................................. 151.3.5 View ................................................................................................................................................ 161.3.6 Compile .......................................................................................................................................... 181.3.7 Check ............................................................................................................................................. 201.3.8 Global Information .......................................................................................................................... 211.3.9 Setup .............................................................................................................................................. 221.3.10 Window ........................................................................................................................................... 231.3.11 Help ................................................................................................................................................ 241.3.12 Print ................................................................................................................................................ 25

1.4 Display Functions ................................................................................................................................ 261.4.1 Graph Flow ..................................................................................................................................... 281.4.2 Call Tree ......................................................................................................................................... 291.4.3 Function List ................................................................................................................................... 301.4.4 Argument Information ..................................................................................................................... 311.4.5 Logic Flow ...................................................................................................................................... 321.4.6 Summary Information ..................................................................................................................... 331.4.7 Cross Reference Information .......................................................................................................... 341.4.8 Max Used Stack ............................................................................................................................. 351.4.9 Program Editing .............................................................................................................................. 36

CHAPTER 2 ANALYSIS PROCEDURE ........................................................................... 392.1 Starting the C Analyzer ........................................................................................................................ 402.2 Terminating the C Analyzer ................................................................................................................. 412.3 Windows .............................................................................................................................................. 422.4 Menus on Window ............................................................................................................................... 442.5 Creating a Project ................................................................................................................................ 462.6 Project Window .................................................................................................................................... 482.7 Setting Analysis Options ...................................................................................................................... 502.8 Analyzing Source Programs ................................................................................................................ 512.9 Displaying Analysis Results ................................................................................................................. 522.10 Analysis Result Data File ..................................................................................................................... 53

CHAPTER 3 PROJECT .................................................................................................... 553.1 Project Menu ........................................................................................................................................ 563.2 Creating a New Project ........................................................................................................................ 583.3 Opening a Project ................................................................................................................................ 603.4 Saving a Project ................................................................................................................................... 62

vii

3.5 Updating Dependence ........................................................................................................................ 643.6 Printing ................................................................................................................................................ 653.7 Print Preview ....................................................................................................................................... 663.8 Printer Setup ....................................................................................................................................... 67

CHAPTER 4 FILE ............................................................................................................. 694.1 File Menu ............................................................................................................................................ 704.2 Creating a New File ............................................................................................................................ 714.3 Opening a File ..................................................................................................................................... 724.4 Saving a File ....................................................................................................................................... 734.5 Adding or Deleting a File ..................................................................................................................... 75

CHAPTER 5 ANALYZE ................................................................................................... 775.1 Analyze Menu ..................................................................................................................................... 785.2 Setting Analysis Options ..................................................................................................................... 79

5.2.1 General Mode ................................................................................................................................ 815.2.2 C Options ....................................................................................................................................... 835.2.3 Maximum Number of Statements in an Inline Function ................................................................. 865.2.4 Maximum of Total Size of Declaration with _direct ........................................................................ 875.2.5 Preprocessor ................................................................................................................................. 88

CHAPTER 6 EDIT ............................................................................................................ 936.1 Edit Menu ............................................................................................................................................ 94

CHAPTER 7 VIEW ........................................................................................................... 997.1 View Menu ........................................................................................................................................ 1007.2 Tool Bar ............................................................................................................................................ 1027.3 Status Bar ......................................................................................................................................... 1037.4 Project Window ................................................................................................................................. 1047.5 Analysis Message Window ............................................................................................................... 1077.6 Analysis Information (Graph Flow) .................................................................................................... 1097.7 Analysis Information (Tree View) ...................................................................................................... 1117.8 Function List ...................................................................................................................................... 1137.9 Max Used Stack ................................................................................................................................ 1157.10 Find ................................................................................................................................................... 116

CHAPTER 8 COMPILE .................................................................................................. 1198.1 Compile Menu ................................................................................................................................... 1208.2 Setting Options for fcc911s ............................................................................................................... 121

8.2.1 Detailed Options for Preprocessor (fcc911s Compiler) ................................................................ 1248.2.2 Detailed Options for Language Specifications (fcc911s Compiler) .............................................. 1288.2.3 Detailed Options for Optimization (fcc911s Compiler) ................................................................. 1308.2.4 Detailed Options for Output (fcc911s Compiler) .......................................................................... 132

8.3 Setting Options for fcc907s ............................................................................................................... 1338.3.1 Detailed Options for Preprocessor (fcc907s Compiler) ................................................................ 1368.3.2 Detailed Options for Language Specifications (fcc907s Compiler) .............................................. 1408.3.3 Detailed Options for Optimization (fcc907s Compiler) ................................................................. 1428.3.4 Detailed Options for Output (fcc907s) ......................................................................................... 144

viii

8.4 Setting Options for fcc896s ................................................................................................................ 1468.4.1 Detailed Options for Preprocessor (fcc896s Compiler) ................................................................ 1498.4.2 Detailed Options for Language Specifications (fcc896s Compiler) .............................................. 1538.4.3 Detailed Options for Optimization (fcc896s Compiler) .................................................................. 1558.4.4 Detailed Options for Output (fcc896s) .......................................................................................... 157

8.5 Setting Options for ANSI C Compiler ................................................................................................. 158

CHAPTER 9 CHECK ...................................................................................................... 1619.1 Check Menu ....................................................................................................................................... 1629.2 Argument (All) .................................................................................................................................... 1639.3 Inline .................................................................................................................................................. 1649.4 Duplicated Functions ......................................................................................................................... 1669.5 Declaration with _direct ..................................................................................................................... 167

CHAPTER 10 GLOBAL INFORMATION ......................................................................... 16910.1 Selecting Global Information .............................................................................................................. 17010.2 Global (C) .......................................................................................................................................... 171

10.2.1 Global Variable and Project Window ............................................................................................ 17310.2.2 Pop-up Menu of Global Information .............................................................................................. 17410.2.3 Reference View ............................................................................................................................ 17610.2.4 Total Size View ............................................................................................................................. 177

10.3 Candidate for const ............................................................................................................................ 17810.4 Candidate for _direct ......................................................................................................................... 17910.5 Searching for Text ............................................................................................................................. 181

CHAPTER 11 SETUP ....................................................................................................... 18311.1 Setup Menu ....................................................................................................................................... 18411.2 Editor Customization .......................................................................................................................... 18511.3 Environment of Compiler .................................................................................................................. 187

CHAPTER 12 WINDOWS ................................................................................................. 18912.1 [Window] Menu .................................................................................................................................. 190

CHAPTER 13 HELP ......................................................................................................... 19513.1 [Help] Menu ....................................................................................................................................... 196

CHAPTER 14 PRINTING .................................................................................................. 19914.1 Printing the Analysis Window ............................................................................................................ 200

CHAPTER 15 GRAPH FLOW .......................................................................................... 20315.1 Displaying Graph Flow ....................................................................................................................... 20415.2 Pop-up Menu of Graph Flow .............................................................................................................. 20615.3 Enlargement/Reduction Display ........................................................................................................ 20815.4 Focus Display .................................................................................................................................... 21015.5 Argument Check ................................................................................................................................ 21415.6 Displaying Undefined Functions ........................................................................................................ 21715.7 Outputting Bitmap File ....................................................................................................................... 218

ix

CHAPTER 16 CALL TREE .............................................................................................. 21916.1 Displaying Call Tree .......................................................................................................................... 22016.2 Call Tree Pop-up Menu ..................................................................................................................... 222

CHAPTER 17 FUNCTION NAME LIST ............................................................................ 22517.1 Display Function Name List .............................................................................................................. 22617.2 Pop-up Menu of Function Name List ................................................................................................ 227

CHAPTER 18 LOGIC FLOW ........................................................................................... 22918.1 Display Logic Flow ............................................................................................................................ 23018.2 Logic Flow Pop-Up Menu .................................................................................................................. 232

CHAPTER 19 SUMMARY ................................................................................................ 23319.1 Displaying Summary ......................................................................................................................... 23419.2 Summary Pop-up Menu .................................................................................................................... 23619.3 How to Measure and Use Complexity ............................................................................................... 237

CHAPTER 20 CROSS REFERENCE ............................................................................... 23920.1 Displaying Cross Reference ............................................................................................................. 24020.2 Cross Reference Pop-up Menu ........................................................................................................ 243

CHAPTER 21 PROGRAM EDITING ................................................................................ 24521.1 Activate the Standard Editor ............................................................................................................. 24621.2 External Editor Setup ........................................................................................................................ 24721.3 Standard Editor Setup ....................................................................................................................... 24821.4 Standard Editor Pop-up Menu .......................................................................................................... 25221.5 Other Functions ................................................................................................................................ 254

CHAPTER 22 MAX USED STACK .................................................................................. 25722.1 Max Used Stack (Specified Function) ............................................................................................... 25822.2 Max Used Stack (All Functions) ........................................................................................................ 25922.3 Max Used Stack Route (Specified Function) .................................................................................... 26022.4 Max Used Stack Route (All Functions) ............................................................................................. 26122.5 Max Used Stack Route Focus .......................................................................................................... 262

CHAPTER 23 USED STACK INFORMATION ................................................................. 26323.1 Calculating Max Used Stack ............................................................................................................. 26423.2 Limitations on the Max Used Stack ................................................................................................... 26523.3 Creating a Stack Information File ...................................................................................................... 266

APPENDIX .......................................................................................................................... 271APPENDIX A Troubleshooting ................................................................................................................... 272

INDEX...................................................................................................................................281

x

CHAPTER 1 OVERVIEW

This chapter outlines the analysis of a source program in the C language with the C Analyzer.

1.1 "What Is the C Analyzer?"

1.2 "Window Configuration"

1.3 "Basic Functions"

1.4 "Display Functions"

1

CHAPTER 1 OVERVIEW

1.1 What Is the C Analyzer?

The C Analyzer is a tool to display and print the structure of a source program written in the C language and the status of data being used by the program. This tool provides information that can be effectively used to increase program development and code efficiency in object programs. This tool also conforms to the embedded

feature of the FR Family and F2MC Family Softune C Compiler.

� Effects of C Analyzer

The C Analyzer can respond to the following user demands:

• The user wants to examine the structure and processing contents of a program of whichinternal processing is unknown.

• The user wants to create a structured program and obtain an understanding of its structureand processing logic.

• Before modifying a program, the user wants to examine the range of the effect ofmodification.

• The user wants to create documents for a program.

• The user wants to create a embedded application program that is highly efficient in the useof codes.

2

1.2 Window Configuration


This section explains the window configuration of the C Analyzer. The C Analyzer has the following six types of window:• Main window• Project window• Analysis message window• Analysis window• Edit window• Dialog box

� Main Window

When the C Analyzer is started, the main window is first opened. All other windows will bedisplayed on the main window when opened.

Figure 1.2-1 "Example of Main Window" shows an example of the main window on which theanalysis window is displayed.

Figure 1.2-1 Example of Main Window

3

CHAPTER 1 OVERVIEW

� Project Window

The C Analyzer analyzes the source programs that are managed by the project managementfunction. The C Analyzer also manages the stack information files created by a Fujitsu’scompiler.

For details on the project window, see Section 7.4 "Project Window".

Figure 1.2-2 "Example of Project Window" shows an example of the project window on whichsource programs are listed.

Figure 1.2-2 Example of Project Window

4


� Analysis Message Window

The C Analyzer displays analysis messages while analyzing a source program. When the userdouble-clicks on an analysis message, e.g., warning message, the relevant section of thesource program is displayed on the edit window enabling the user to easily modify the section.

For details on the analysis message window, see Section 7.5 "Analysis Message Window".

Figure 1.2-3 "Example of Analysis Message Window" shows an example of the analysismessage window on which analysis status is displayed.

Figure 1.2-3 Example of Analysis Message Window

5

CHAPTER 1 OVERVIEW

� Analysis Windows

After a source program is analyzed normally by the C Analyzer, the user can display varioustypes of analysis window.

For details on the analysis windows, see Section 7.6 "Analysis Information (Graph Flow)" andSection 7.7 "Analysis Information (Tree View)".

Figure 1.2-4 "Analysis Windows" shows an example of some analysis windows on display.

Figure 1.2-4 Analysis Windows

6


� Edit Windows

The C Analyzer has some functions to edit source programs on edit windows. Each editwindow is opened when the user selects it to create a new text file or calls it from the analysismessage window.

For details on the edit windows, see CHAPTER 2 "ANALYSIS PROCEDURE".

Figure 1.2-5 "Edit Windows"shows an example of some edit windows on display.

Figure 1.2-5 Edit Windows

7

CHAPTER 1 OVERVIEW

� Dialog Box

Dialog boxes are used to set up analysis options and printing on the C Analyzer.

For details on each dialog box, see subsequent chapters.

Figure 1.2-6 "Dialog Box for Analysis Options" shows the dialog box for analysis options.

Figure 1.2-6 Dialog Box for Analysis Options

8

1.3 Basic Functions

1.3 Basic Functions

The C Analyzer has the basic functions listed below. This section provides an outline of each basic function in the following order:• Project• File• Analyze• Edit• View• Compile• Check• Global• Setup• Window• Help• Print

� Project

The Project functions permit the user to manage C source files through the project managementfunctions of the C Analyzer.

� File

The File functions permit the user to open C source and stack information files.

� Analyze

The Analyze functions permit the user to analyze the structure of a source program in aselected project and create analysis data.

� Edit

The Edit functions permit the user to edit character strings on various analysis windows andsource programs.

� View

The View functions permit the user to display various analysis windows based on analysis data.

� Compile

The Compile functions permit the user to compile source programs in the selected project byusing the C compiler for Fujitsu microcomputers.

9

CHAPTER 1 OVERVIEW

� Check

The Check functions permit the user to check for a match between a dummy argument and realargument. The functions also permit the user to check for duplicate definitions of an inlineexpansion function candidate or function, or search for _direct type declaration variables.

� Global

The Global functions permit the user to display utilization of global variables or search for consttype qualification and _direct type qualification candidates.

� Setup

The Setup functions permit the user to customize the internal editor and set up the compilerenvironment.

� Window

The Window functions permit the user to change settings on various analysis windows.

� Help

The Help functions permit the user to display the help files showing a functional outline of the CAnalyzer and C Analyzer operation methods.

� Print

The Print functions permit the user to print the analysis window being displayed.

10

1.3 Basic Functions

1.3.1 Project

The Project functions permit the user to manage C source files through the project management functions of the C Analyzer.The project management functions include the following:• Creation of new projects• Management of existing projectsWith these functions, the user can manage source programs collectively.

� Project File

The extension code for a project file name is ".anp".

� New Project

The New Project function permits the user to create a new project. When New Project ischosen from the Project menu, the Project Name & Path dialog box appears. Specify the nameof the new project and the name of the folder to store the new project file in the dialog box.

� Open Project

The Open Project function permits the user to open an existing project. To select the existingproject to be opened, choose Open Project from the Project menu. The Select File dialog boxappears. Select the existing project file in the dialog box.

� Save Project

The Save Project function permits the user to save the currently opened project by writing itscontents over the project saved under the same name.

� Save Project As

The Save Project As function permits the user to save the currently opened project under a newname.

� Close Project

The Close Project function permits the user to close the currently opened project.

� Update Dependence

The Update Dependence function permits the user to also register the header file used by asource program newly registered in the same project.

� Print

The Print function displays a dialog box for printing settings. The range of printing and thenumber of print copies can be specified.

� Print Preview

The Print Preview function displays images of printed pages.

11

CHAPTER 1 OVERVIEW

� Print Setup

The Print Setup function displays a dialog box to set up the printer.

� Quit C Analyzer

The Quit C Analyzer function terminates the C Analyzer. If a file is being edited in a projectwhen the Quit C Analyzer command is chosen from the Project menu, a message dialog boxappears asking if the file is to be saved.

12

1.3 Basic Functions

1.3.2 File

The File functions permits the user to file. The user can save and print modified files of source programs.

� New File

The New File function permits the user to create a new text file. The user can edit a sourceprogram, stack information, or document file.

This function opens an untitled file with the editor.

� Open File

The Open File function permits the user to open an existing file.

To open a file, choose Open File from the File menu. The Select File dialog box appears.Select the file to be opened from the list in the dialog box, and click the Open button.

� Add File in Project

The Add File in Project function permits the user to register files in an opened project. Toregister files, choose Add File in Project from the File menu. The Select File dialog boxappears. Select the files to be registered in the project from the list in the dialog box, and clickthe OK button.

� Delete File from Project

The Delete File from Project function permits the user to delete the files selected on the projectwindow. If no file is selected, this function deletes all files.

� Save File

The Save File function permits the user to save the currently opened file by writing its contentsover the file saved under the same name. This function is valid only when a file is currentlyopened.

� Save File As

The Save File As function permits the user to save the currently opened file under a new name.This function is valid only when a file is currently opened.

13

CHAPTER 1 OVERVIEW

1.3.3 Analyze

The Analyze functions permit the user to analyze a source program statically and create the data required for display by the C Analyzer. The structure of the source program can be easily understood.

� Re-Analyze

The Re-Analyze function analyzes the source programs registered in a specified project.

� Analyze

The Analyze function analyzes only the modified source programs among the source programsregistered in a specified project.

� Interrupt

The Interrupt function cancels analysis operation. When the Interrupt command is chosen fromthe Analyze menu, a dialog box indicating cancellation of analysis operation appears.

This function is valid only while a source program is being analyzed by the Analyze or Re-Analyze function.

� Analysis Options

The Analysis Options function permits the user to set optional information for the analysis ofsource program. When the Analysis Options command is chosen from the Analyze menu, theAnalysis Options dialog box appears.

14

1.3 Basic Functions

1.3.4 Edit

The Edit functions permit the user to edit source programs and text files. The user can perform cut and paste operations for the file being edited.

� Copy

The Copy function copies the data selected on the currently displayed analysis or edit windowand saves the data on the clipboard.

� Select All

The Select All function permits the user to select all data on the currently displayed analysis oredit window and save the data on the clipboard. This function is valid only when an analysis oredit window is displayed.

� Undo

The Undo function cancels the previous file editing operation performed on the currentlydisplayed edit window and restores the relevant file to the status before the file editingoperation. This function is valid only when an edit window is displayed.

� Paste

The Paste function inserts the content of the clipboard in the position indicated by the cursor onthe currently displayed edit window. This function is valid only when an edit window isdisplayed.

� Cut

The Cut function cuts out the selected data and saves the data on the clipboard.

This function is valid only when an edit window is displayed by the internal editor.

� Find

The character sequence in the specified edit window is searched.


� Replace

The character sequence in the specified edit window is searched and replaced.


� Find in Files

It searches whether it is contained in the file specified by the specified character sequence. Areference result is displayed on an analysis message window.


15

CHAPTER 1 OVERVIEW

1.3.5 View

The View functions permit the user to display or hide the tool bar and windows and customize each window and editor. With these functions, the user can freely set up the screen.

� Tool Bar

The Tool Bar function displays or hides the tool bar.

� Status Bar

The Status Bar function displays or hides the status bar.

� Project

The Project function displays or hides a project window.

� Message Bar

The Message Bar function displays or hides the analysis message bar.

� Analysis Information (Graph Flow)

The Analysis Information (Graph Flow) function displays a Graph Flow window.

This function is valid only when there is already an analysis data file created by the Analyze orRe-Analyze command in the Analyze menu.

� Analysis Information (Tree View)

The Analysis Information (Tree View) function displays a Call Tree window.

This function is valid only when there is already an analysis data file created by the Analyze orRe-Analyze command in the Analyze menu.

� Function List

The Function List function displays a function list.

This function is valid only when a Graph Flow window is displayed.

� Max Used Stack

The Max Used Stack function displays the information on maximum used stack on a GraphFlow window.

This function can be used only when a stack information file is already created using theCompile functions.

This function is valid only when analysis option [Call Max Used Stack Calculator] is selected anda Graph Flow window is displayed.

16

1.3 Basic Functions

� Max Used Stack Route

The Max Used Stack Route function displays the route to the maximum used stack on a GraphFlow window.

This function can be used only when a stack information file is already created using theCompile functions.

This function is valid only when analysis option [Call Max Used Stack Calculator] is selected anda Graph Flow window is displayed.

� Find

The Find function permits the user to search data on a selected analysis window to find aspecified character string.

� Find Prev

The Find Prev function permits the user to search the data in a backward direction on a selectedanalysis window to find a specified character string.

This function is valid only when at least an analysis window is displayed.

� Find Next

The Find Next function permits the user to search the data in a forward direction on a selectedanalysis window to find a specified character string.

This function is valid only when at least an analysis window is displayed.

17

CHAPTER 1 OVERVIEW

1.3.6 Compile

The Compile functions permit the user to compile a source program. The user can select following compilers.• fcc911s (C compiler for the FR family)

• fcc907s (Compiler for the F2MC-16 family)

• fcc896s (Compiler for the F2MC-8L family)With the Compile functions, a stack information file required to control the maximum size stack can be created. The user must install at least one of the compilers to use the Compile functions.

� Compilation-target Files

All the source programs registered in the currently displayed project are the targets ofcompilation.

� Start Compilation

The Start Compilation function starts compilation of the source programs registered in thecurrently displayed project.

� Interrupt Compilation

The Interrupt Compilation function cancels the compilation operation in progress. When theInterrupt Compilation command is chosen from the Compile menu, a dialog box indicatingcancellation of compilation operation appears.

This function is valid only while source programs are being compiled by the Start Compilationfunction.

� Option

The Option functions permits the user to set options for the complyer. The user can set teeoptions body and chech the options set.

❍ Target Compiler

This operation specifies a C Compiler for a Fujitsu microcomputer.

When ANSI is specified, fcc911s (compiler for FR family) is started in the ANSI

mode.

❍ Language

This option specifies the language for the messages to be output by the compiler.

❍ Chip Classification

The family name of MCU is specified.

18

1.3 Basic Functions

❍ Optimization Level

This option specifies the level of compiler optimization.

❍ Warning Level

This option specifies the level of warning on the compiler.

❍ Translation Controller

This option specifies the range of compilation.

❍ Memory Model

This Option specifies the Memory Model of CPU. (Only fcc907s)

❍ Target MCU

This option specifies hte type of MCU. It is possible to input cpu type manually.

❍ Output DEBUG information

This option specifies whether to output debug information to object files.

❍ Not reading default option file

This option specifies whether to use the default option file.

❍ Output STACK information

This option specifies whether to output the information on the used size of stack.

❍ Details

• Preprocessor: Specifies options for the preprocessor.

• Language: Specifies detailed options for language specifications.

• Optimization: Specifies detailed options for optimization.

• Output: Specifies detailed options for output.

❍ Put const variables into RAM field

A const variable is located to a RAM area. (Only fcc907s)

❍ Other Option’s Description

This field permits the user to directly set other available options for the compiler.

❍ Confirm

This button permits the user to check the settings of compiler options.

19

CHAPTER 1 OVERVIEW

1.3.7 Check

The Check functions permit the user to check source programs. The functions improve fault detection capability, program portability, and object performance.

� Argument (All)

The Argument (All) function checks for matching of the numbers and types of real and dummyarguments among functions in a source program defined in a project. It also checks forconsistency of function return values. The function thus permits the user to detect interfaceerrors.

� Inline

The Inline function detects a function that can be an inline function expansion candidate of thecompiler, based on the specified number of lines.

� Duplicated Functions

The Duplicated Functions function detects the positions where functions used with the samename are defined or referenced.

� Declaration with _direct

The Declaration with _direct function calculates the total size of variables with _direct. Thisfunction is enabled only when fcc907s or fcc896s is specified for the compiler type in theGeneral Mode field or General Setup field.

20

1.3 Basic Functions

1.3.8 Global Information

The Global Information function displays global information on a source program. The global information permits the user to check the utilization of data that affects the entire program.

� C Global Variable

The C Global function displays the types of the global variable, the size of the global variable,the source program name, the function name which is referring to the global variable and thenumber of times of reference, and a variable.

� const Candidate

The const Candidate function searches for variable candidates that can be subjected tocompiler optimization if the program is qualified by the _direct type.

� _direct Candidate

The const Candidate function searches for variable candidates that can be subjected tocompiler optimization if the program is qualified by the _direct type. This function is enabledonly when fcc907s or fcc896s is specified for the compiler type in the General Mode field.

21

CHAPTER 1 OVERVIEW

1.3.9 Setup

The Setup functions permit the user to set up the internal editor and the installation environment for the compiler.

� Editor Customize

The Editor Customize function permits the user to specify the editor (internal editor or your owneditor) to be used for editing.

If an edit window has already been displayed by the internal editor, a dialog box to customizethe internal editor appears when the Editor Customize command is chosen from the Setupmenu.

� Compilation Environment

The Compilation Environment function permits the user to set the path for the directory wherethe compiler environment in use has been installed. If the compiler environment has not beeninstalled, a dialog box indicating non-installation of compiler environment appears.

22

1.3 Basic Functions

1.3.10 Window

The Window functions permit the user to change the status of various analysis windows on display.

� Cascade

The Cascade function displays multiple windows that overlap.

� Tile Vertically

The Tile Vertically function arranges multiple windows in a row vertically.

� Tile Horizontally

The Tile Horizontally function arranges multiple windows in a row horizontally.

� Arrange Icons

The Arrange Icons function arranges iconized windows horizontally in a row at the bottom of themain window for the current application.

� Close All

The Close All function closes all analysis windows displayed.

� Window names 1, 2,...

The Window menu lists currently displayed analysis windows at the bottom.

The currently active window is indicated by a check mark at the top of its name. If the userwants to activate a window, select the name of the window in the list.

23

CHAPTER 1 OVERVIEW

1.3.11 Help

The Help functions permit the user to display the help files showing a functional outline of the C Analyzer and C Analyzer operation methods. The help files can be printed and searched to find descriptions with a keyword. With these functions, the user can operate this tool and reference analysis information.

� Help Topics

The Help Topics function displays a table of contents and keyword for help information on the CAnalyzer.

� About C Analyzer

The About C Analyzer function displays version information on the C Analyzer.

24

1.3 Basic Functions

1.3.12 Print

The Print function prints the results of analysis. The function permits the user to use the printed results as documents, review materials, or maintenance materials.

� Print

The Print function permits the user to print different types of analysis and edit windows. Formore information on printing, see CHAPTER14 "PRINTING."

25

CHAPTER 1 OVERVIEW

1.4 Display Functions

The C Analyzer can display various items of analysis information based on its analysis functions. The C Analyzer has the display functions listed below. This section gives an outline of each display function in the following order:• Graph Flow• Call Tree• Function List• Argument Information• Logic Flow• Summary Information• Cross Reference Information• Max Used Stack• Program Editing

� Graph Flow

The Graph Flow function displays a diagram showing the call relations between functions.

� Call Tree

The Call Tree function displays the call relations between functions in a list structure.

� Function List

The Function List function lists functions.

� Argument Information

The Argument Information function displays information on function arguments.

� Logic Flow

The Logic Flow function displays a diagram showing the internal structures of functions.

� Summary Information

The Summary Information function displays various kinds of statistical information on eachfunction.

� Cross Reference Information

The Cross Reference Information function displays the status of data usage by each function.

� Max Used Stack

The Max Used Stack function calculates and displays the maximum size of stack used byprogram. This function also displays the route of functions for using a maximum size stack.

26


� Program Editing

The Program Editing function starts the internal editor. When customized, this function can startan external editor.

27

CHAPTER 1 OVERVIEW

1.4.1 Graph Flow

The Graph Flow function displays the call relations between functions in a form of diagram. This diagram enables the user to easily understand the structure of the program.

� Graph Flow Function

The Graph Flow function displays the call relations between functions in a form of diagram. Thefollowing functions can be used on the Graph Flow window:

• Displaying the entire structure of the analyzed program and searching for a specifiedfunction

• Displaying the functions called by a specified function

• Displaying the functions calling a specified function

• Displaying the functions that are not found in the analyzed program but called from thefunctions in the program

• Displaying the number of program lines used for each function

• Displaying the maximum size of stack used by each function

• Displaying the max used stack route

• Outputting the contents of Graph Flow window as a bit map file

28


1.4.2 Call Tree

The Call Tree function displays the call relations between functions in a source program and highlights the relevant function box displayed on the Graph Flow window.

� Call Tree Function

The Call Tree function displays the call relations between functions used in a source program ina list form.

The following functions on the Call Tree window can be used:

• Highlighting a specified function on the Graph Flow window

• Displaying the edit window for the source program that includes a specified functiondefinition

• Displaying the Logic Flow window that includes A specified function definition

• Displaying the summary information on a specified function

• Displaying the mutual reference information on a specified function

• Displaying all the functions used on the Call Tree window

• Displaying only the highest-level functions used on the Call Tree window

• Searching the contents of the Call Tree window to find a function name

29

CHAPTER 1 OVERVIEW

1.4.3 Function List

The Function List function displays the names of analyzed functions and the names of the source files in which the functions are defined. The function permits the user to easily check the functions used in a program.

� Function List Function

The Function List function displays a listing of analyzed program functions. It permits the userto check the following types of information:

• Number of functions invoked by a function

• Nesting level of functions invoked by a function

• Focused display of function box by Graph Flow

• Function definition display by Logic Flow

30


1.4.4 Argument Information

The Argument Information function displays information on the dummy and real arguments between the specified functions. The function permits the user to check for matching between function calls.

� Argument Information Function

The Argument Information function displays information on the arguments between thefunctions specified in the Graph Flow window. The information includes the following:

• Presence of calling relationships between specified functions

• Information on dummy arguments between specified functions

• Information on real arguments between specified functions

• Results of checking for matching of the numbers and types of real and dummy arguments

• Results of checking for matching of the types of function return values

• Source files including dummy arguments and header files

31

CHAPTER 1 OVERVIEW

1.4.5 Logic Flow

The Logic Flow function displays the internal structure of a function in diagram form. This diagram enables the user to easily understand the internal structure of a function.

� Logic Flow Function

The Logic Flow function displays the source program of a specified function in diagram form.

• Visually displaying the control structure of if, for, switch, break, goto, while, pairs of do andwhile, and continue statements and structure and union declarations

• Controlling the display of comment lines

• Controlling the display of the contents of user include or system include files

• Searching for variable, function, tag, and macro names

32


1.4.6 Summary Information

The Summary Information function displays the statistical information as listed below on each function. This information enables the user to understand the characteristics of each function.

� Summary Information Function

The Summary Information function displays the detailed information on a specified function.The user can reference the following information:

• Complexity

• Number of lines

• Number of included lines

• Name of the function this function calls

• Name of the function calling this function

• Numbers of if, while, for, and other statements appearing in the function

33

CHAPTER 1 OVERVIEW

1.4.7 Cross Reference Information

The Cross Reference Information function displays the information listed below on each function. This information enables the user to know the status of data use in each function.

� Mutual Reference Information Function

The Mutual Reference Information function displays the status of data usage and data attributesin a specified function.

• Attributes and types of variable, function, parameter, and enumerator names used in thefunction and the line numbers of the lines declaring, defining, or referencing them

• Kinds and types of structure tag, union tag, and enumerated-type tag names and typedefnames used in the function and the line numbers of the lines defining them

• Line numbers of the lines defining and invalidating the macro names and substitute stringsused in the function

34


1.4.8 Max Used Stack

The Max Used Stack function calculates and displays the maximum size stack used by an entire program or a specified function. This function also displays the route for a maximum size stack. This information enables the user to know the maximum size stack required for the current application and the route for use thereof.

� Calculation of Maximum Used Stack

The Max Used Stack function reads a stack usage information file and calculates the maximumsize stack used. The Max Used Stack function displays the maximum size stack used for thefunctions holding stack usage information on the Graph Flow window.

❍ For all functions

The Max Used Stack function can display the maximum size stack used by all functions,including callee functions, displayed on the Graph Flow window.

❍ For a specified function

The Max Used Stack function can display the maximum size stack used only in a functionspecified on the Graph Flow window. (The callee functions are ignored.)

� Display of Maximum Used Stack Route

The Max Used Stack function displays the maximum used stack route based on the calculatedmaximum size stack used. The Max Used Stack function displays the maximum used stackroute for the functions holding stack usage information on the Graph Flow window.

❍ For all functions

The Max Used Stack function can display the maximum used stack route for all functionsdisplayed on the Graph Flow window.

❍ For a specified function

The Max Used Stack function can display the maximum used stack route only for a functionspecified on the Graph Flow window.

Note:

To calculate the maximum size stack used, the user must create a stack usage informationfile for each source file with the Softune C Compiler fcc911s, fcc907s, or fcc896s.

To create a stack usage information file, choose Option from the Compile menu, click on theOutput STACK information check box, then perform compilation.

For restrictions on the calculation of the maximum size stack used, see CHAPTER 23"USED STACK INFORMATION".

35

CHAPTER 1 OVERVIEW

1.4.9 Program Editing

When a source file name is double-clicked on a displayed analysis window, the user can start the internal editor and edit the source file. The user can also use an external editor after customization.

� Selecting an Editor

Without the Graph Flow window displayed, choose Editor Customize from the Setup menu.Then, the internal editor or an external editor can be selected.

� Internal Editor Functions

In the Internal Editor Setup dialog box, the user can specify the following functions and items:

❍ View/Hide: EOF

Specify this item to display an EOF symbol at the end of file.

❍ View/Hide: Line Number

Specify this item to display logical line numbers on the left side of the edit window.

❍ View/Hide: Return Character

Specify this item to display a special symbol as the return code.

❍ View/Hide: Ruler

Specify this item to display the ruler on the edit window.

❍ View/Hide: Wide Char Space

Specify this item to display a special symbol as the wide char space.

❍ View/Hide: Comment

Specify this item to highlight comments.

❍ View/Hide: Tab

• Specify this item to display a special symbol as the tab code.

❍ Error Tag Display Color

Specify this item to highlight error messages.

❍ Set Tab/Indent

• Automatic Indent: Specify this function to automatically indent each line in the same way asthe preceding line.

• Tab Number: Specify the number of spaces to be skipped using a tab code.

36


❍ Set Keyword

• C Keyword: Specify this item to read a C-language keyword file and highlight the relevantkeywords.

• Assembler Keyword: Specify this item to read an assembler (ASM) keyword file andhighlight the relevant keywords.

• Extended Keyword: Specify this item to read an extended keyword file and highlight therelevant keywords.

• User-defined: Handmade keyword files, such as a system call, are read and the keyword isindicated by emphasis.

❍ Search Results

Specify this function to highlight the lines, including the string found by searching on the editwindow.

❍ Register Keyword

Specify this function to select a keyword file and register a keyword.

37

CHAPTER 1 OVERVIEW

38

CHAPTER 2 ANALYSIS PROCEDURE

This chapter explains the procedure for analyzing a source program written in the C language with the C Analyzer.

2.1 "Starting the C Analyzer"

2.2 "Terminating the C Analyzer"

2.3 "Windows"

2.4 "Menus on Window"

2.5 "Creating a Project"

2.7 "Setting Analysis Options"

2.8 "Analyzing Source Programs"

2.9 "Displaying Analysis Results"

2.10 "Analysis Result Data File"

39


2.1 Starting the C Analyzer

To start the C Analyzer, double-click the C Analyzer icon registered in the system. When the C Analyzer is started, its initial window appears.

� Starting with the Icon

Double-click the C Analyzer icon on the desktop.

Figure 2.1-1 C Analyzer Icon

� Starting from the Start Menu

Choose Program from the Start menu, and choose Softune C Analyzer from the submenu.

� Starting from the Explorer

Choose Program from the Start menu, and choose Explorer from the submenu to start theExplorer, then double-click on cpanalyze.exe in the folder where the Softune C Analyzer hasbeen installed.

� Starting from the MS-DOS Prompt

Choose Program from the Start menu and choose MS-DOS Prompt to start the MS-DOSprompt, then execute the cpanalyze.exe command in the folder where the Softune C Analyzerhas been installed.

40

2.2 Terminating the C Analyzer

2.2 Terminating the C Analyzer

To terminate the C Analyzer, choose Quit C Analyzer from the Project menu.

� Starting the C Analyzer

Figure 2.2-1 "Project Menu" shows the Project menu of the C Analyzer.

Figure 2.2-1 Project Menu

41


2.3 Windows

When the C Analyzer is started, the initial window of the C Analyzer appears.

� Initial Window

Figure 2.3-1 "Initial Window" shows the initial window of the C Analyzer.

Figure 2.3-1 Initial Window

42

2.3 Windows

� Window for Analysis

Figure 2.3-2 "Analysis Information (Graph Flow) Window" shows an example of the AnalysisInformation (Graph Flow) window displayed after a new project has been created.

Figure 2.3-2 Analysis Information (Graph Flow) Window

43


2.4 Menus on Window

This section explains the bars and menus displayed on each window of the C Analyzer.

� Menus and Bars on Window

❍ Tool bar

The tool bar shows the commands of the File and Analyze menus in icon forms.

❍ Status bar

The status bar provides explanations of the menu commands.

❍ Menu bar

The menu bar shows the menus related to the currently focused window.

� Project Menu

See CHAPTER 3 "PROJECT"and CHAPTER14 "PRINTING".

� File Menu

See CHAPTER4 "FILE".

� Analyze Menu

See CHAPTER5 "ANALYZE".

� Edit Menu

See CHAPTER6 "EDIT".

� View Menu

See CHAPTER7 "VIEW".

� Compile Menu

See CHAPTER8 "COMPILE".

� Check Menu

See CHAPTER9 "CHECK."

� Global Menu

See CHAPTER10 "GLOBAL INFORMATION."

44

2.4 Menus on Window

� Setup Menu

See CHAPTER11 "SETUP".

� Window Menu

See CHAPTER12 "WINDOW".

� Help Menu

See CHAPTER13 "HELP".

45


2.5 Creating a Project

To analyze a source program with the C Analyzer, the user must create a project and register the source program in the project. This section explains how to create a project with the New Project command and register the source program in the project with the Add File in Project command.

� Project Name & Path Dialog Box

When New Project is chosen from the Project menu, the Project Name & Path dialog boxappears as shown in Figure 2.5-1 "Project Name & Path Dialog Box".

Figure 2.5-1 Project Name & Path Dialog Box

� Select File Dialog Box

When Add File in Project is chosen from the File menu, the Select File dialog box appears asshown in Figure 2.5-2 "Select File Dialog Box".

46

2.5 Creating a Project

Figure 2.5-2 Select File Dialog Box

� Selecting a File

Select a file as follows:

1. Create a new project with the New Project command or open an existing project with theOpen Project command.

2. Use the Add File in Project command to specify the directory where the file to be selected isstored.

3. Select the name of the file to be selected from the file list in the Look in: box by clicking(multiple files can be selected by dragging). The user can specify the type of files to be listedin the box if necessary. And the type of file displayed if necessary in [kind] box can bespecified.

4. If unnecessary files are selected, specify the unnecessary source files on the Project windowand delete with the Delete File from Project command.

� Specifying the Type of Project File

The user can specify the project file for Softune Workbench or that for Softune C Checker as thefile type as follows:

1. Choose Open Project from the Project menu. The Select File dialog box appears.

2. In the Files of type field, specify the extension code "prj" for the project file for SoftuneWorkbench or "cpj" for the project file for Softune C Checker.

3. Select the specified project file. Only the project file for Softune C Analyzer can be used asthe project file to be saved.

47


2.6 Project Window

The Project window displays the files registered for the project. This section explains the Project window.

� SOURCE tab

The source files and include files registered for the project are displayed. By choosing theUpdate Dependence command from the Project menu, the header file included in the selectedsource file can be automatically registered in the project.

� STACK tab

To use the maximum stack function, a stack information file ( .stk) must be registered for aproject. When the Call Max Used Stack Calculator check box in the Analysis Option dialog boxdisplayed by the Option command selected in the Analyze menu is specified, the stackinformation file in the project folder is automatically registered in the project. If the project foldercontains no stack information file, choose and register it manually in the same way as for sourcefiles.

For information on how to create a stack information file, see Section23.3 "Creating a StackInformation File."

Figure 2.6-1 Pop-up Menu in the Project Window

❍ Add Files...

Select this item to add a source file to the project.

48

2.6 Project Window

❍ Remove Files

Select a source file and then select this item to remove the file from the project. If a folder isselected, all source files in the folder are removed. If a project name is selected, all source filesin the project are removed.

❍ Edit File

Select a source file and then this item to open the file in the edit window.

❍ Import files from Analyzer File List (*.afl)...

Select this item to import the source files prepared in an old version C Analyzer that isincompatible with project management.

❍ Hide Window

Select this item to hide the Project window.

❍ Docking

Select this item to place the Project window at the fixed position.

❍ File Property

Select this item to display the properties of the selected source file.

49


2.7 Setting Analysis Options

The user must set some analysis options when analyzing a source program with the C Analyzer. This section explains how to set analysis options using the Analysis Options dialog box.

� Analysis Options Command

When Analysis Options is chosen from the Analyze menu, the Analysis Options dialog boxappears as shown in Figure 2.7-1 "Analysis Options Dialog Box".

Figure 2.7-1 Analysis Options Dialog Box

See Section 5.2 "Setting Analysis Options", for more information on setting the analysis options.

50

2.8 Analyzing Source Programs

2.8 Analyzing Source Programs

When the Analyze or Re-Analyze command is chosen from the Analyze menu, the source programs registered in the currently opened project are analyzed. If an error occurs during analysis, the content of the error is displayed on the Analysis Message window. If no error occurs and analysis ends, the result of analysis is displayed automatically.

� Analyze

The Analyze command analyzes all source files displayed on the current project window.

The progress of analysis is displayed on the Analysis Message window.

� Re-Analyze

The Re-Analyze command analyzes only the modified source files among the source filesdisplayed on the current project window.

� Interrupt

The Interrupt command cancels analysis operation. When the Interrupt command is chosen, adialog box indicating cancellation of analysis operation appears. Analysis information is thendeleted and the analysis window is not displayed.

This function is valid only while a source program is being analyzed after the Analyze or Re-Analyze command has been chosen.


If an error occurs during the analysis of a source program, an error message is output to theAnalysis Message window and the analysis operation is stopped. The analysis window is notdisplayed as in the case of the Interrupt command.

51


2.9 Displaying Analysis Results

When the Analysis Information (Graph Flow) command is chosen from the View menu, a Graph Flow window appears. The user can display various analysis information on the Graph Flow window.

� Display of Analysis Information (Graph Flow Window)

When the analysis of source programs ends normally, analysis data is saved as a project and aGraph Flow window appears.

Even after the Graph Flow window is closed, it can be displayed again with the AnalysisInformation (Graph Flow) command in the View menu without the need for re-analysis becausethe analysis data has been saved.

The Graph Flow window shows the internal hierarchical structure of C source program. Theuser can also display detailed information on functions and classes on the Graph Flow window.

� Default View

The analysis window that is automatically displayed at the end of analysis can be defined byspecifying it in the Default View menu on the upper part of the Project window.

Analysis Information View Control Bar in Toolbar selected from the View menu can be used toview or hide the Default View menu.

52

2.10 Analysis Result Data File

2.10 Analysis Result Data File

Analysis results are saved as data files in the relevant project.

� Saving an Analysis Result Data File

An analysis result data file is created under a file name with a suffix ".q". For example, if thename of a source file is "test.c", an analysis result data file named "test.q" is created.

� Updating an Analysis Result Data File

If an analysis result data file has been created for a source file and the source file is analyzedagain, the analysis result data file is updated to (or replaced with) a new analysis result data file.

� Displaying an Existing Analysis Result

To display an existing analysis result, open the project that includes the corresponding analysisresult data file and choose Analysis Information (Graph Flow) from the View menu. Thus, theanalysis result can be displayed without performing re-analysis.

� Deleting an Analysis Result Data File

A data file containing analysis results synchronizes with the corresponding source file registeredin the project. Therefore, if a source file is removed from the project, the corresponding data filein the project folder is automatically deleted.

53


54

CHAPTER 3 PROJECT

This chapter explains how to create and operate a project.

3.1 "Project Menu"

3.2 "Creating a New Project"

3.3 "Opening a Project"

3.4 "Saving a Project"

3.5 "Updating Dependence"

3.6 "Printing"

3.7 "Print Preview"

3.8 "Printer Setup"

55

CHAPTER 3 PROJECT

3.1 Project Menu

Projects can be managed using the commands in the Project menu.Project menu commands are as follows:• New Project command• Open Project command• Close Project command• Save Project command• Save Project As command• Update Dependency command• Print command• Print Preview command• Print Setup command• Quit C Analyzer command

� Project Menu

❍ New Project command

The New Project command permits the user to create a new project.

If this command is chosen from the Project menu, the Project Name & Path dialog box appears.Specify the name of the new project and the name of the folder to store the new project file inthe dialog box.

❍ Open Project command

The Open Project command permits the user to open an existing project.

If this command is chosen from the Project menu, the Select File dialog box appears. Specifythe project file created with the New Project command in the dialog box to open.

❍ Close Project command

The Close Project command closes the currently opened project. If the contents of the projecthave not been saved after the last change, a dialog box asking whether to save the projectappears.

❍ Save Project command

The Save Project command saves the currently opened project by writing its contents over theproject saved under the same name. This command does not close the project. To close theproject, use the Close Project command.

❍ Save Project As command

The Save Project As command permits the user to save the currently opened project under anew name. If this command is chosen from the Project menu, the Project Name & Path dialogbox appears. Specify the new name of the project in the dialog box.

56

3.1 Project Menu

❍ Update Dependency command

The Update Dependency command permits the user to register in the same project the includefiles used by the source files belonging to the currently opened project.

❍ Print command

The Print command permits the user to print the contents of a currently opened analysiswindow.

If this command is chosen from the Project menu, the Print dialog box appears. Make settingsfor printing in the dialog box.

❍ Print Preview command

The Print Preview command displays a print image currently opened analysis window.

❍ Print Setup command

The Print Setup command permits the user to set up the printer.

If this command is chosen, the Printer Setup dialog box appears. Make printer settings in thisdialog box.

❍ Quit C Analyzer command

The Quit C Analyzer command terminates the C Analyzer. If the contents of the project havenot been saved after the last change, a dialog box asking whether to save the project appears.

57

CHAPTER 3 PROJECT

3.2 Creating a New Project

To create a new project, choose the New Project command from the Project menu.

� Creating a New Project

If the New Project command is chosen from the Project menu, the Project Name & Path dialogbox appears. Specify the name of the new project and the name of the folder to store the newproject file in the dialog box. When the new project is created, a file named "project-name.anp"is created in the specified folder. If the new project is opened next time, specify the created file.

� Project Name & Path Dialog Box

Use the Project Name & Path dialog box for creating a new project. The following settings canbe made in the dialog box:

• Project Name: Enter the name of the new project.

• Path: Specify the folder to store the new project.

• Change Directory: Use this button to display the Folder Reference dialog box.


Reference:

If no project name is specified or the project or file name specified includes an invalidcharacter, a message dialog box indicating the error appears when the OK button ispressed.

58

3.2 Creating a New Project

� Folder Reference Dialog Box

If the Change Directory button in the Project Name & Path dialog box is clicked, a dialog box toreference the folders appears as follows:

Figure 3.2-2 Folder Reference Dialog Box

59

CHAPTER 3 PROJECT

3.3 Opening a Project

To open an existing project, choose the Open Project command from the Project menu.

� Opening a Project

If the Open Project command is chosen from the Project menu, the Select File dialog boxappears. Specify the project file to be opened in the dialog box.


Use the Select File dialog box for opening an existing project. The following settings can bemade in the dialog box:

❍ Look in:

Specify the folder storing the project file to be opened in this field.

❍ File name:

Specify the name of the project file to be opened by entering it or selecting it from the list. Thelist box shows the files having the identifier (anp) of the project file format for C Analyzer.

❍ Files of type:

Specify the type of the project file to be opened by selection. As the default, this field shows thefile type with the identifier (anp) of the project file format for C Analyzer. The user can alsoselect the identifier (prj) of the project file format for Softune Workbench or the identifier (cpj) ofthe project file format for Softune C Checker.


Note:

The user can specify the project file for Softune Workbench, Softune C Checker, or SoftuneC Analyzer. However, the information in the saved project file can only be used for the

60

3.3 Opening a Project

Softune C Analyzer

61

CHAPTER 3 PROJECT

3.4 Saving a Project

There are two methods of saving a project: Saving it by overwriting and saving it with a new name. To save a project, choose the Save Project or Save Project As command, respectively.

� Save Project Command

The Save Project command saves the currently opened project by writing its contents over theproject saved under the same name. For example, the file names added in the project andchanges in option settings can be saved.

� Save Project As Command

The Save Project As command permits the user to save the currently opened project under anew name. For example, the file names added in the project and changes in option settings canbe saved. If this command is chosen, the Project Name & Path dialog box appears as follows:


� Confirmation Dialog Box

The confirmation dialog box appears if:

• you have made changes in the currently opened project and choose the New Projectcommand without saving the changes,

• you have made changes in the currently opened project and choose the Close Projectcommand without saving the changes, or

• you have made changes in the currently opened project and choose the Quit C Analyzercommand without saving the changes.

62

3.4 Saving a Project

Figure 3.4-2 Confirmation Dialog Box

63

CHAPTER 3 PROJECT

3.5 Updating Dependence

The include files used in the source programs registered in a project can be updated by choosing the Update Dependency command from the Project menu.

� Update Dependency Command

The Update Dependency command checks the source files registered in the currently openedproject and registers the include files used by the source programs in the same project. Theinclude files registered by this function are displayed in the include file category on the relevantproject window.

Figure 3.5-1 Progress of Updating Dependence

64

3.6 Printing

3.6 Printing

The contents of a displayed analysis window can be printed by choosing the Print command from the Project menu.

� Printing

If the Print command is chosen from the Project menu, the Print dialog box appears. The usercan make printing settings in the dialog box.

For details on printing functions, see CHAPTER14 "PRINTING".

65

CHAPTER 3 PROJECT

3.7 Print Preview

A print image of the contents of the currently opened analysis window can be displayed.

� Print Preview

If the Print Preview command is chosen from the Project menu, the Print Preview windowappears.


66

3.8 Printer Setup

3.8 Printer Setup

The printer connected to the computer can be set up directly or via a network by choosing the Print Setup command from the Project menu.

� Printer Setup

If the Print Setup command is chosen from the Project menu, the Printer Setup dialog boxappears. Make printer settings in this dialog box.


67

CHAPTER 3 PROJECT

68

CHAPTER 4 FILE

This chapter explains how to create and operate a file.

4.1 "File Menu"

4.2 "Creating a New File"

4.3 "Opening a File"

4.4 "Saving a File"

4.5 "Adding or Deleting a File"

69

CHAPTER 4 FILE

4.1 File Menu

The user can create a new file, open an existing file, and save a file using the commands in the File menu.File menu commands are as follows:• New command• Open command• Save command• Save As command• Add to Project command• Remove from Project command

� File Menu

❍ New command

The New command creates a new file. If this command is chosen, an untitled edit window isopened. If an existing file is to be opened, use the Open command.

❍ Open command

The Open command permits the user to open an existing file. If this command is chosen, theSelect File dialog box appears. Any type of file can be specified in this dialog box.

❍ Save command

The Save command saves the file being edited without changing its name and folder. If theuser attempts to save a newly created file for the first time, the Save As dialog box appears andthe file can be saved with an appropriate file name. If an existing file is to be saved with a newname in a new folder, use the Save As command.

The Save command is valid only when an edit window is opened.

❍ Save As command

The Save As command permits the user to save the file being edited without a new name. Ifthis command is chosen, the Save As dialog box appears and the file can be saved with anappropriate file name.

The Save As command is valid only when an edit window is opened.

❍ Add to Project command

The Add to Project command permits the user to add a file in a project. As default, the types ofthe files that can be added are "*.c", "*.i". The user can also select "*.stk" as types of files thatcan be added.

❍ Remove from Project command

The Remove from Project command permits the user to delete the files selected on a projectwindow from the relevant project. If no file is selected, this command deletes all files from theproject.

70

4.2 Creating a New File

4.2 Creating a New File

To create a new file, choose the New command from the File menu.

� Creating a New File

Choose the New command from the File menu. An untitled edit window is opened on the mainwindow as follows:

Figure 4.2-1 Example of Edit Window (Untitled)

The edit operations on the edit window are linked with the commands in the Edit menu. Fordetails, see the explanation of the CHAPTER6 "EDIT".

Reference:

If an external editor is registered using the Editor Customize command in the Setup menu,the external editor is activated by the above operation. For details, see the explanation ofthe CHAPTER11 "SETUP".

71

CHAPTER 4 FILE

4.3 Opening a File

If the Open command is chosen, the Select File dialog box appears.

� Opening a File

Choose the Open command from the File menu. The Select File dialog box appears. Specifyan already created text file in the dialog box.


Use the Select File dialog box to open an existing text file. The following settings can be madein the dialog box:

❍ Look in:

Specify the folder storing the text file to be opened in this field.

❍ File name:

Specify the name of the text file to be opened by entering it or selecting it from the list. The listbox lists the files having an identifier corresponding to the file type selected in the Files of typebox.

❍ Files of type:

Specify the type of the text file to be opened by selection. As default, any type of file can beselected. The type of file can be specified by entering the extension code corresponding to thetype in the File name field.

Figure 4.3-1 Example of Select File Dialog Box

72

4.4 Saving a File

4.4 Saving a File

There are two methods of saving a file: Saving by overwriting and saving with a new name.

� Save Command

The Save command saves the currently opened file by writing its contents over the file savedunder the same name.

� Save As Command

The Save As command permits the user to save the currently opened file with a new name. Ifthis command is chosen, the Save As dialog box appears as follows:

Figure 4.4-1 Save As Dialog Box

� Confirmation Dialog Box

The confirmation dialog box appears if:

• you have made changes in the currently opened edit window and choose the New Projectcommand without saving the changes,

• you have made changes in the currently opened edit window and choose the Close Projectcommand without saving the changes, or

• you have made changes in the currently opened edit window and choose the Quit CAnalyzer command without saving the changes.

73

CHAPTER 4 FILE


74

4.5 Adding or Deleting a File

4.5 Adding or Deleting a File

If the Add to Project is chosen, the Select File dialog box appears.

� Adding a File in a Project

Choose the Add to Project from the File menu. The Select File dialog box appears. Specify thename of the program file to be added in a project in the dialog box.


Use the Select File dialog box to register an existing source program in a project. The followingsettings can be made in the dialog box:

❍ File name:

Specify the name of the file to be added by entering it or selecting it from the list. The list boxlists files having an identifier corresponding to the file type selected in the Files of type box.

❍ Files of type:

Select the type of file to be added. As default, the types of files that can be added are "*.c" and"*.i". The user can also select "*.stk" as the types of files that can be added.

❍ File Kind:

The file which dose not depend on the extension can be set.

❍ Look in:

Specify the folder storing the file to be added in this field.


75

CHAPTER 4 FILE

� Remove from a Project

Choose the remove from Project in the File menu. The program files selected on the currentlyopened project window are deleted from the relevant project.

If no program file is selected on the project window, all program files displayed on the projectwindow are deleted from the relevant project.


Reference:

The user can also add and delete files with corresponding commands in the pull-downmenus on the project window. For details, see Section 7.4 "Project Window".

76

CHAPTER 5 ANALYZE

This chapter explains how to operate the Analyze functions.

5.1 "Analyze Menu"

5.2 "Setting Analysis Options"

77

CHAPTER 5 ANALYZE

5.1 Analyze Menu

The user can start and stop analysis and set analysis options using the commands in the Analyze menu.Analyze menu commands are as follows:• Re-Analyze command• Analyze command• Interrupt command• Analysis Options command

� Analyze Menu

Figure 5.1-1 "Analyze Menu" shows the Analyze menu.

Figure 5.1-1 Analyze Menu

❍ Re-Analyze command

The Re-Analyze function analyzes the source programs registered in a specified project tocreate analysis information.

❍ Analyze command

The Analyze function analyzes only modified source programs among source programsregistered in a specified project to create analysis information.

❍ Interrupt command

The Interrupt function cancels analysis operations while in progress. If this command is chosen,the analysis information being created is deleted.

❍ Options command

The Analysis Options function permits the user to set optional information for analysis.

78



This section explains how to set analysis options for the C Analyzer.

� Analysis Options Dialog Box

Figure 5.2-1 "Analysis Options Dialog Box" shows the Analysis Options dialog box.

Figure 5.2-1 Analysis Options Dialog Box

The following options can be set in the Analysis Options dialog box:

� General Mode

❍ Target Compiler

Specify the compiler for the analysis target.


Specify the family name of MCU used.

79

CHAPTER 5 ANALYZE

❍ Target MCU

Specify the type of the MPU used.

❍ Call MUSC

Select this item to use the maximum stack function.

❍ Memory Model

Specify the memory model of target. (Only fcc907s)

❍ Place the const variable in RAM

A const variable is located to a RAM area. (Only fcc907s)

❍ C Options

• Language Level

Specify a language specification level of C source program.

• Warning Level

Specify an output level for warning messages among the diagnostic messages to be outputduring the analysis of a source program.

• Other Options

Specify other options when passing the options directly to the analyzer.

❍ Maximum Count of Statement for INLINE Functions

Specify the maximum limit for the number of executable statements for the function that can bea candidate for inline function.

❍ Maximum of Total Size of Declaration with _direct

Specify the upper limit of the total size of the _direct declaration used in a program.

❍ Preprocessor

Set include paths and macro definitions.

80


5.2.1 General Mode

Use the General Mode items in the Analysis Options dialog box to specify the target of analysis.

� General Mode

The use can specify one of the following analysis methods:

❍ fcc911s

Specifies the analysis based on fcc911s.

❍ fcc907s


❍ fcc896s


❍ ANSI

Specifies the analysis strictly conforming to the ANSI standard.

When fcc907s is selected, Memory Model and Place const Variable in RAM Area can beselected. For Memory Model, specify the memory model specified when creating a stackinformation file ( .stk) using the compilation function.

Do the same for Place const Variable in RAM Area.

� Chip Classification

Specify a Family Name of MPU in the Chip Classification field by selection from menu. Thestack usage information file for the standard library function and predefined macroscorresponding to the specified Chip Classification is selected.

� Target MCU

Specify a MCU number in the Target MCU field by selection from menu or entry. The stackusage information file for the standard library function and predefined macros corresponding tothe specified Target MCU is selected.

� Call MUSC (Max Used Stack Calculator)

When the Call MUSC (Max Used Stack Calculator) check box is turned on, the used stackinformation file corresponding to the source program registered in the project is selected. Bydefault the corresponding stack information file stored in the project folder is selected.However, if the project folder does not contain it, choose Add File to Project from the File menuto open the file selection dialog box, change the file type to the stack file (*.stk), and register adesired used stack information file.

See CHAPTER23 "USED STACK INFORMATION," for information on how to create a usedstack information file.

81

CHAPTER 5 ANALYZE

� Memory Model (Only fcc907s)

Specify a Memory Model in the Memory Model field by selection from menu. The stack usageinformation file for the standard library function corresponding to the specified Memory Model isselected.

� Register Const Variable to RAM Field

Specify a Register const variable to RAM check box. The stack usage information file for thestandard library function corresponding to the specified Register const variable to RAM field isselected.

82


5.2.2 C Options

The user can specify the following options in the Analysis Options dialog box:• Language Level• Warning Level• Other Options

� Language Level

The user can specify one of the following language specification levels of C source program:

❍ ANSI plus Fujitsu Extension

"ANSI plus Fujitsu Extension" specifies the new ANSI C specifications, including extendedspecifications. The structure of a program whose operation varies depending on the languagespecification (new or old) is interpreted in conformance with ANSI C specifications. The warningmessages related to changes in the integer extension rules will be displayed on the AnalysisMessage window. On the other hand, the warning messages related to tri-graph sequences oradded escape sequences will not be displayed.

❍ Strict ANSI

"Strict ANSI" specifies that related header files must much strictly conform to ANSI Cspecifications. However, the files can include those extended ANSI specifications that do notaffect the program strictly conforming to ANSI C specifications. For some of the extendedspecifications, warning messages will be displayed on the Analysis Message window. Amongthe identifiers in the standard header files, only those defined by the ANSI C specifications arevisible.

� Warning Level

Specify the output levels for warning messages among diagnostic messages.

❍ Level 0: Warning messages are suppressed.

❍ Level 1: Basic warning messages are output.

❍ Level 2: The warning messages for the following, in addition to those at level 1 are output:

• A variable not used in a function

• A variable used before initialization in a function

• Use of the static function


• No value returned by a function that should return a value

• No value specified for the return of a function that should return a value

83

CHAPTER 5 ANALYZE

• #pragma that cannot be recognized

• Range of constant values for comparison with a constant during comparison operation


• extern function declared in a block

• Structure or union not defined for extern declaration of structure or union array

• Assignment expression provided instead of relational expression where a conditionalexpression is expected

• Address of the auto variable used as a function return value


• int declaration made implicitly

• Prototype declaration not provided for a function

• A constant provided in a conditional expression

• Implicit int declaration made for a parameter

• Declaration hidden by previous declaration

• enum member followed by a comma

• No initial value specified for a declaration with const

• Variable address compared with 0

• Type definition provided in a cast expression

• A register specified in struct, union, or array variable declaration


• A switch present with no default specified


• Use of int type

• None of int, signed int, and unsigned int in the bit field


• Function called using the pointer to the function

� Other Options

The user can specify the following options in the Other Options field:

❍ -D name [= tokens]

If this option is omitted, token 1 associates "name" with the specified tokens as the processingby the #define preprocessing instruction. This function gives "=tokens" as the result.

84


❍ -U name

This option invalidates the definition of "name" as the processing by the #under preprocessinginstruction. If the same name is specified in both the -D and -U options, the specified name isnot defined regardless of the order of the options.

85

CHAPTER 5 ANALYZE

5.2.3 Maximum Number of Statements in an Inline Function

Specify the maximum limit for the number of executable statements of the function that can be a candidate for inline function. Specify it in the Maximum number of statements in an inline function field of the Analysis Options dialog box.

� Maximum Number of Statements in an Inline Function

Conditions for the function that can be a candidate for inline function are as described below.

• The function is called by another function that is in a source program.

• The function is defined in a source program.

• The type of actual and dummy parameters in a function are consistent.

• The numbers of actual and dummy parameters in a function are consistent.

• No structure or union is specified for a function parameter.

• The function is not called recursively.

• The function does not call a set jmp function.

• The function is not called through reference to an address.

• The number of lines describing the function does not exceed the maximum number ofstatements in an inline function.

Reference:

Although the maximum number of statements in an inline function is 3 by default, specify theproper number in consideration of the area to be used.

86


5.2.4 Maximum of Total Size of Declaration with _direct

The maximum of the total size of declaration with _direct in a source program is specified in the Maximum of total size of declaration with _direct check box in the Option dialog box.

� Maximum of Total Size of Declaration with _direct

This command can be executed only if fcc907s or fcc896s is specified in the Environment fieldas the compiler to be used.

Reference:

_direct identifier can be provided for fcc907s and fcc896s to decrease the addressing codesize of a variable. The maximum size of the variable having _direct can be changed and is256 bytes, by default.

87

CHAPTER 5 ANALYZE

5.2.5 Preprocessor

If the Project’s Setup button is clicked in the Analysis Options dialog box, the Preprocessor Settings dialog box appears. This dialog box has two setting screens: Include Paths and Macro Definition screens.

� Include Paths Screen of Preprocessor Settings Dialog Box

Figure 5.2-2 "Include Paths Screen" shows the Include Paths screen.

Figure 5.2-2 Include Paths Screen

Items and buttons of the Include Paths screen are as follows:

❍ Path

This field shows the include path to be used for analysis.

Registered include paths are shown in the List of registered paths and will be passed to thepreprocessor sequentially from the top.

❍ Browse button

This button displays the window to select a path from existing include paths.

The path selected on the window is shown in the Path field.

88


❍ Add button

This button adds the include path entered in the Path field to the List of registered paths field.The path to the include file directory prepared by the C Analyzer is prepared by default;however, this directory is searched last.

❍ Delete button

This button deletes a selected include path from the List of registered paths box.

❍ Move Upward button

This button shifts the selected include path upward with one line which is in the List of registeredpaths displayed in the box.

❍ Move Downward button

This button shifts the selected include path downward with one line which is in the List ofregistered paths displayed in the box.

The order in which an include file is searched for varies depending on its coding format in thesource file as explained below.

A file name enclosed in double quotation marks (" ") is searched for in the following directoriesin the order shown:

1. Current directory containing a #include preprocessing command

2. Directories in the List of include paths field (in ascending order)

3. Directory in which the default include file prepared by the C Analyzer is installed

A file name enclosed by greater-than and smaller-than symbols (< >) is searched for in thefollowing directories in the order shown:

1. Directories in the List of include paths field (in ascending order)

2. Directory in which the default include file prepared by the C Analyzer is installed

� Macro Definition Screen of Preprocessor Settings Dialog Box

Figure 5.2-3 "Macro Definition Screen" shows the Macro Definition screen.

89

CHAPTER 5 ANALYZE

Figure 5.2-3 Macro Definition Screen

Items and buttons of the Macro Definition screen are as follows:

❍ Name

This field permits the user to specify the name of the macro to be registered for analysis.

❍ Value

This field permits the user to enter the value of the macro.

❍ List of Registered Macro Definition

This box lists registered macro names.

Each MB number specified for the CPU type defines _CPU_MB-number_. Each MB numberalso defines a macro as shown below:

• MB911 type: _COMPILER_FCC911_, _CPU_FR_

• MB907 type: _COMPILER_FCC907_, _CPU_16L_


• MB905 type: _COMPILER_FCC907_, _CPU_16LX_



• MB902 type: _COMPILER_FCC907_, _CPU_16F_


The registered macros are passed to the preprocessor sequentially from the top.

If macro definitions with a same name are registered, the one registered last (shown below) isgiven priority.

90


❍ Add button

This button adds the macro specified in the Name field in the List of Registered Macro Definitionbox.

❍ Delete button

This button deletes a selected macro from the List of Registered Macro Definition box.


This button shifts the selected macro upward with one line which is in the List of RegisteredMacro Definition displayed in the box.


This button shifts the selected macro downward with one line which is in the List of RegisteredMacro Definition displayed in the box.

� Recognize Lines Starting with // as Comment in C Source Check Box

If this check box is clicked, comments in the C++ style can be represented in a source file.Comments in not only the /* */ style but also the // style can be used.

91

CHAPTER 5 ANALYZE

92

CHAPTER 6 EDIT

This chapter explains how to operate the Edit functions.

6.1 "Edit Menu"

93

CHAPTER 6 EDIT

6.1 Edit Menu

The commands in the Edit menus are as follows:• Undo command• Cut command• Copy command• Paste command• Select All command• Find command• Replace command• Find in Files command

� Edit Menu

Figure 6.1-1 "Edit Menu" shows the Edit menu.

Figure 6.1-1 Edit Menu

❍ Undo command

The Undo command cancels the file edit operation previously performed during file editing andrestores the file to the state prior to the file edit operation. This command is enabled duringediting with the internal editor.

❍ Cut command

The Cut command cuts out currently selected data from the relevant file and saves the data onthe clipboard during file editing. If no data is selected, this command is invalid. The dataalready saved on the clipboard is replaced with the data newly saved by the Cut command.

This command is enabled during editing with the internal editor.

94

6.1 Edit Menu

❍ Copy command

The Copy command copies currently selected data on the clipboard during file editing. If nodata is selected, this command is invalid. If no data is selected, this command is invalid. Thedata already copied on the clipboard is replaced with the data newly copied by the Copycommand.

❍ Paste command

The Paste command inserts the content of the clipboard in the position indicated by the cursorduring file editing. If no data is found on the clipboard, this command is invalid.

❍ Select All command

The Select All command selects all data displayed on a specified window. This command isenabled when an analysis window is selected.

❍ Find command

If you choose the Find command from the Edit menu when an edit window is active, the Find inCurrent File dialog box appears.

The following conditions can be set in the Find in Current File dialog box:

• Find What

• Match Whole Word Only

• Match Case

• Normal Expression

• Ambiguous Expression

• Direction

• Position

Figure 6.1-2 "Find in Current File Dialog Box (Edit Window)" shows an example of a display ofthe Find in Current File dialog box for the analysis window.

Figure 6.1-2 Find in Current File Dialog Box (Edit Window)

95

CHAPTER 6 EDIT

❍ Replace command

The Replace command permits the user to replace a specified character string with a newcharacter string on an edit window.

If you choose the Replace command, the Replace dialog box appears. On the Replace dialogbox, enter the character string to be replaced in the Find What field and the character string toreplace it in the Replace With field.

The following conditions can be set in the Replace dialog box:

• Find What

• Replace With


• Match Case



• Direction

• Position

Figure 6.1-3 "Replace Dialog Box (Edit Window)" shows an example of a display of the Replacedialog box.

Figure 6.1-3 Replace Dialog Box (Edit window)

❍ Find in Files command

If you choose the Find in Files command from the Edit menu when an edit window is active, theFind in Files dialog box appears.

The following conditions can be set in the Find in Files dialog box:

• Find What

• In files

• In folder

• Match whole word only

• Match case

Figure 6.1-4 "Find in Files Dialog Box" shows an example of a display of the Find in file dialogbox.

96

6.1 Edit Menu

Figure 6.1-4 Find in Files Dialog Box

97

CHAPTER 6 EDIT

98

CHAPTER 7 VIEW

This chapter explains how to operate the View functions.

7.1 "View Menu"

7.2 "Tool Bar"

7.3 "Status Bar"

7.4 "Project Window"

7.5 "Analysis Message Window"

7.6 "Analysis Information (Graph Flow)"

7.7 "Analysis Information (Tree View)"

7.8 "Function List"

7.9 "Max Used Stack"

7.10 "Find"

99

CHAPTER 7 VIEW

7.1 View Menu

You can display the tool bar, status bar, project window, analysis message window, graph flow, logic flow, and other information using the commands in the View menu.View menu commands are as follows:• Tool Bar command• Status Bar command• Project command• Message Bar command• Analysis Information (Graph Flow) command• Analysis Information (Tree View) command• Function List command• Max Used Stack command• Max Used Stack Route command• Find command• Find Prev command• Find Next command

� View Menu

The commands in the View menu are explained as follows:

❍ Tool Bar command

The Tool Bar command displays or hides the tool bar. When the tool bar is on display, a checkmark is displayed to the left of the command name.

❍ Status Bar command

The Status Bar command displays or hides the status bar. The status bar displays a briefexplanation of a menu command or tool bar button when it is selected, or displays the status ofa special key on the keyboard whether it is pressed being on or off. When the status bar is ondisplay, a check mark is displayed to the left of the command name.

❍ Project command

The Project command displays or hides a project window. When a project window is on display,a check mark is displayed to the left of the command name.

❍ Message Bar command

The Message Bar command displays or hides the analysis message window. While theanalysis message window is displayed, a check mark is provided at the beginning of thiscommand name.

❍ Analysis Information (Graph Flow) command

The Analysis Information (Graph Flow) command displays the call relationships among thefunctions in a source program on a Graph Flow window.

100

7.1 View Menu

❍ Analysis Information (Tree View) command

The Analysis Information (Tree View) command displays the call relationships among thefunctions in a source program on a Call Tree window.

❍ Function List command

The Function List command displays a list of the functions used by a source program.

❍ Max Used Stack command

The Max Used Stack command displays information on the maximum used stack in eachfunction box displayed on a Graph Flow window.

❍ Max Used Stack Route command

The Max Used Stack Route command displays the maximum used stack route for the functionboxes on a Graph Flow window.

❍ Find command

The Find command displays the File dialog box to permit the user to search a specifiedcharacter string in the specified analysis window.

❍ Find Prev command

The Find Prev command searches data in a backward direction on a selected analysis windowto locate the character string specified with the previously executed Find command.

❍ Find Next command

The Find Next command searches data in a forward direction on a selected analysis window tolocate the character string specified with the previously executed Find command.

101

CHAPTER 7 VIEW

7.2 Tool Bar

The tool bar is displayed above the menu bar at the top of the application window. The tool bar contains buttons for the tools of the C Analyzer. To use a tool, click the left side of the mouse on the corresponding tool button.

� Tool Bar

Figure 7.2-1 "Example of a Tool Bar" shows an example of a tool bar.

Figure 7.2-1 Example of a Tool Bar

Figure 7.2-2 Example of a Tool Bar (Analysis information display control bar)

The display control bar is used to specify the default display window after analysis is finished.The Analysis Information (Tree View), Analysis Information (Graph Flow) can be selected.

102

7.3 Status Bar

7.3 Status Bar

The status bar is displayed at the bottom of each window f the C Analyzer.You can display or hide the status bar with the Status Bar command in the View menu.

� Status Bar

Figure 7.3-1 "Example of Status Bar" shows an example of a status bar.

Figure 7.3-1 Example of Status Bar

The status bar displays a brief explanation of a menu command when the command is selected.It also displays a brief explanation of a tool when the button is held down on the tool bar. If youcancel the tool after reading the explanation, move the mouse pointer outside the tool button,then release the mouse button.

103

CHAPTER 7 VIEW

7.4 Project Window

Use the project window to manage the source and stack information files registered in the relevant project.

� Project Window

Figure 7.4-1 "Example of Project Window" shows an example of a source file display on theproject window.

Figure 7.4-1 Example of Project Window

The project window uses Source Files, Include Files, and Stack Files folders to register files.

❍ Source Files folder

This folder is used to register selected source files.

❍ Include Files folder

This folder is used to register selected include files and include files dependent on registeredsource files.

104

7.4 Project Window

❍ Stack Files folder

This folder is used to register the stack information files (stk) corresponding to selected sourcefiles. The stack information files to be registered can also be selected.

❍ Pop-up menu

If you position the mouse cursor inside the project window and click the right button of themouse, a pop-up menu appears.

The pop-up menu permits the user to perform the following types of operation speedily:

• Add Files: Registers additional source files or stack information files in the project.

• Remove Files: Deletes selected registered source files or stack information files from theproject.

• Edit File: Allows you to edit the source file selected on the project window.

• Hide Window: Hides the project window.

• Docking: Permits project window docking with another window or restores it to the originalsize.

• File Property: Displays the File Property dialog box showing a time stamp and pathinformation on a specified file.

Figure 7.4-2 File Property Dialog Box

105

CHAPTER 7 VIEW

Figure 7.4-3 Example of a Pop-up Menu on the Project Window

106

7.5 Analysis Message Window

7.5 Analysis Message Window

The analysis message window shows simple analysis messages.


The analysis message window displays simple analysis messages after analysis. Figure 7.5-1"Example of a Message Display on the Analysis Message Window" shows an example of amessage display on the analysis message window.

Figure 7.5-1 Example of a Message Display on the Analysis Message Window

The analysis message window displays analysis messages and has the following functions:

❍ Jump to indicated line

If you click the left side of the mouse on a file name in an analysis message, you can jump tothe line indicated by the analysis message.

If the file has not been opened, the file is opened before jumping.

❍ Pop-up menu

The user can display the pop-up menu to perform the following types of operation speedily:

• Select All: Selects all character strings on the analysis message window.

• Copy: Saves the character strings selected on the analysis message window to theclipboard.

• Clear: Clears the display contents of the analysis message window.

• Find: Displays the Find dialog box that permits the user to search an analysis messagewindow for character strings.

107

CHAPTER 7 VIEW

Figure 7.5-2 Message Find Dialog Box

• Show/Hide Window: Displays or hides the analysis message window.

• Docking: Permits analysis window docking with the main window or restores it to the originalsize.

• Save Text File: Displays the Save Text File dialog box that permits the user to save thecharacter strings displayed on the analysis message window as a text file.

Figure 7.5-3 Save Text File Dialog Box

Figure 7.5-4 Example of a Pop-up Menu on the Analysis Message Window

108

7.6 Analysis Information (Graph Flow)

7.6 Analysis Information (Graph Flow)

The Analysis Information (Graph Flow) function displays the call relationships among functions. The Graph Flow window has the following functions:• Focus• Logic flow• Summary information• Xreference• Max used stack

� Graph Flow Window

When the analysis of a source program ends normally, a Graph Flow window is displayedautomatically. For a project already analyzed, you can display the relevant Graph Flow windowwith the Analysis Information (Graph Flow) in the View menu.

Figure 7.6-1 "Example of Graph Flow Window" shows an example of display on the Graph Flowwindow.

Figure 7.6-1 Example of Graph Flow Window

The Graph Flow window has the following functions:

109

CHAPTER 7 VIEW

❍ Focus function

The Focus function focuses on a specified function on the Graph Flow window. You can selectthe functions that are called or call a specified function for display using the Focus function.

For details on the Focus function, see CHAPTER15 "GRAPH FLOW".

❍ Logic Flow function

The Logic Flow function visibly displays the internal structure of a function specified on theGraph Flow window. You can control the display of the control structure of if, for, and otherstatements, comment lines, and include files.

For details on the Logic Flow function, see CHAPTER 18 "LOGIC FLOW".

❍ Summary Information function

The Summary Information function displays the summary information on a function specified onthe Graph Flow window.

The summary information includes the characteristics of functions such as calling functionnames, called function names, and the numbers of if and for statements appearing in functions.

For details on the Summary Information function, see CHAPTER 19 "SUMMARY".

❍ Xreference function

The Xreference function displays Xreference information on a function specified on the GraphFlow window, including the variables and functions used in the specified function and thedefinition status of tags and macros.

For details on the Xreference function, see CHAPTER 20 "CROSS REFERRENCE".

❍ Max Used Stack function

The Max Used Stack function displays stack usage information on each function displayed onthe Graph Flow window.

For details on the Max Used Stack function, see CHAPTER 22 "MAX USED STACK".

110

7.7 Analysis Information (Tree View)

7.7 Analysis Information (Tree View)

The Analysis Information (Tree View) command displays the call relationships among functions in list form on a Call Tree window.

� Call Tree Window

The Call Tree window displays the call relationships among functions, the type of information,and the logical number of lines of each function in list form. Figure 7.7-1 "Example of a CallTree Window" shows an example of a display on the Call Tree window.

Figure 7.7-1 Example of a Call Tree Window

❍ Parameter information

The Call Tree window displays the number of parameters, the type of information, and the nameof the function.

❍ Logical number of lines

The Call Tree window displays the number of logical lines and the name of the function.

� Pop-up Menu on the Call Tree Window

The pop-up menu that can be displayed on the Call Tree window has the following commands:

❍ Open All command

This command opens all call relationships among functions on display.

❍ Close All command

This command closes all call relationships among functions on display.

111

CHAPTER 7 VIEW

❍ Find command

This command permits the user to search the function names on the Call Tree window.

❍ Open The File command

This command opens the source file that includes a specified function call section on an editwindow.

❍ Logic Flow command

This command displays the source file that includes a specified function call section on a LogicFlow window.

❍ Summary command

This command displays summary information on a specified function.

❍ Xreference command

This command displays Xreference information on a specified function.

Figure 7.7-2 Example of a Pop-up Menu on the Call Tree Window

112

7.8 Function List

7.8 Function List

The Function List functions displays the function names defined in a source program in list form on the Function List window.

� Function List Window

The Function List window displays the names of analyzed functions and the names of thesource files in which they are defined. If a function name is clicked, the color of the frame of therelevant function box on the Graph Flow window changes to red. If a function name is double-clicked, logic flow information on the relevant function is displayed. Figure 7.8-1 "Example ofFunction List Window" shows an example of a display on the Function List window.

Figure 7.8-1 Example of Function List Window

The Function List window has the following functions:

❍ Contents of display

• [T] attribute: "T" indicates that the function is at the top level and has no caller.

• Function name: This column shows the name of the function.

• File name: This column shows the names of source files containing function definitions.

• Call count: This column shows the number of called functions.

• Nest level: This column shows the hierarchical level of function calling.

❍ Pop-up menu

• Show [All Functions]: This command displays all functions on the Function List window.

• Show [Top Level]: This command displays the top-level functions that are not called byanother function on the Function List window.

• Open the File: This command displays the edit window for a selected function.

113

CHAPTER 7 VIEW

• Logic Flow: This command displays the Logic Flow window for a selected function.

Figure 7.8-2 Example of a Pop-up Menu on the Function List Window.

114

7.9 Max Used Stack

7.9 Max Used Stack

The Max Used Stack function displays information on a maximum used stack on a Graph Flow window:• Max Used Stack• Max Used Stack Route

� Max Used Stack Command

The Max Used Stack command displays information on a maximum used stack in each functionbox on a Graph Flow window so as to provide maximum used stack information on theapplication and each function.

� Max Used Stack Route Command

The Max Used Stack Route command displays the maximum used stack route based on thecalculation of a maximum used stack in the function-call relation display on the Graph Flowwindow so as to provide the functions that determine the maximum used stack for theapplication and each function as a route.

For details on the Max Used Stack function, see CHAPTER 22 "MAX USED STACK".

Note:

To calculate the maximum size of stack used, the user must create a stack information filefor each C source file with the compilation function of the C Analyzer.

115

CHAPTER 7 VIEW

7.10 Find

The Find function permits the user to search data on an active analysis window or edit window and locate a specified character string.• Find• Find Prev• Find Next• Replace• Find in Files

� Locate Operations on an Analysis Window

❍ Find

If you choose the Find command from the View menu when an analysis window is active, theFind dialog box appears.

The following conditions can be set in the Find dialog box:

• Find What

• Match Case

• Direction

Figure 7.10-1 "Find Dialog Box (Analysis Window)" shows an example of a display of the Finddialog box for the analysis window.

Figure 7.10-1 Find Dialog Box (Analysis Window)

❍ Find Prev

The Find Prev command searches data in backward direction on the analysis window.

❍ Find Next

The Find Prev command searches data in forward direction on the analysis window.

116

7.10 Find

� Find Operations on an Edit Window

❍ Find

If you choose the Find command from the View menu when an edit window is active, the Find inCurrent File dialog box appears.

The following conditions can be set in the Find in Current File dialog box:

• Find What


• Match Case



• Direction

• Position

Figure 7.10-2 "Find in Current File Dialog Box (Edit Window)" shows an example of a display ofthe Find in Current File dialog box for the analysis window.

Figure 7.10-2 Find in Current File Dialog Box (Edit Window)

❍ Replace

The Replace command permits the user to replace a specified character string with a newcharacter string on an edit window.

If you choose the Replace command, the Replace dialog box appears. On the Replace dialogbox, enter the character string to be replaced in the Find What field and the character string toreplace it in the Replace With field.

If you choose the Replace command when an edit window is active, the Replace dialog boxappears.

The following conditions can be set in the Replace dialog box:

• Find What

• Replace With


• Match Case



• Direction

117

CHAPTER 7 VIEW

• Position

Figure 7.10-3 "Replace Dialog Box (Edit Window)" shows an example of a display of theReplace dialog box.

Figure 7.10-3 Replace Dialog Box (Edit Window)

❍ Find in Files

If you choose the Find in Files command from the Edit menu when an edit window is active, theFind in Files dialog box appears.

The following conditions can be set in the Find in Files dialog box:

• Find What

• In files

• In folder

• Match whole word only

• Match case

Figure 7.10-4 "Find in Files Dialog Box" shows an example of a display of the Find in file dialogbox.

Figure 7.10-4 Find in Files Dialog Box

118

CHAPTER 8 COMPILE

This chapter explains the Compile functions.

8.1 "Compile Menu"

8.2 "Setting Options for fcc911s"



8.5 "Setting Options for ANSI C Compiler"

119

CHAPTER 8 COMPILE

8.1 Compile Menu

You can compile source programs registered in a project using the following commands in the Compile menu:Start Compilation commandInterrupt Compilation commandOption command

� Compile Menu

Figure 8.1-1 "Compile Menu" shows the Compile menu.

Figure 8.1-1 Compile Menu

❍ Start Compilation command

The Start Compilation command starts compilation of source programs registered in a specifiedproject.

❍ Interrupt Compilation command

The Interrupt Compilation command cancels the compilation operation in progress.

❍ Compilation Option Command

The Option command permits the user to set options for the compiler.

120

8.2 Setting Options for fcc911s


This section explains how to set compilation options for the fcc911s compiler.

� Compile Option Dialog Box for fcc911s

Figure 8.2-1 "Compile Option Dialog Box for fcc911s" shows the Compile Option dialog box forthe fcc911s compiler.

Figure 8.2-1 Compile Option Dialog Box for fcc911s

The following settings can be made in the Compile Option dialog box:

❍ Target Compiler

One of the following four types of compiler can be specified.

• C compiler (fcc911s) for the FR Family

• C compiler (fcc907s) for the F2MC-16 Family

• C compiler (fcc896s) for the F2MC-8L Family

• ANSI C compiler

121

CHAPTER 8 COMPILE

❍ Translation Controller

One of the following two ranges of compilation can be specified. The default is the execution ofprocesses up to compilation.

• Only Pre-Processing: Translation processes up to preprocessing are executed.

• Run Compilation: Translation processes up to compilation are executed.


The Family Nmae of your MCU can be specified.


One of the following seven optimization levels can be specified. The default is level 2.

• None: No optimization

• Level 1: Optimization in level 1




• Priority to size: Optimization with priority to size

• Priority to speed: Optimization with priority to speed

❍ Warning Level

One of the following nine warning levels can be specified.

The default is level 1.

• Level 0: No output of warning messages

• Level 1: Output of warning messages in level 1








See Section5.2.2 "C Options," for details of warning levels.

❍ Target MCU

For the MCU, specify the MB number to be used. The default MCU is MB91101.


You can specify whether to output debug information. The default is no output.


You can specify whether to read the default option file. The default is no reading.

122



You can specify whether to output a stack information file. The default is no output.

❍ Details

• Preprocessor: Specifies the setting of detailed options for the preprocessor.

• Language: Specifies the setting of detailed options for language specifications.

• Optimization: Specifies the setting of detailed options for optimization.

• Output: Specifies the setting of detailed options for output.

❍ Other Options’ Description

Other options available for the compiler can be entered in this field.

Refer to the "Softune C Compiler Manual" for more information.

❍ Buttons

• Confirm button: Permits the user to check the settings of compiler options.

• OK button: Validates the settings made in the dialog box.

• Cancel button: Cancels the settings made in the dialog box.

• Help button: Displays help information.

123

CHAPTER 8 COMPILE

8.2.1 Detailed Options for Preprocessor (fcc911s Compiler)

This section explains how to set detailed options for the preprocessor of the fcc911s compiler using the Preprocessor - fcc911s Compiler dialog box. This dialog box has two setting screens: Include Paths and Macro Definition screens.

� Include Paths Screen of Preprocessor - fcc911s Compiler Dialog Box



❍ Path field

This field shows the include path to be used for compilation.

❍ List of registered paths list box

This box lists registered include paths.

The registered include paths will be passed to the preprocessor sequentially from the top in thisbox.

124


❍ Recognize lines starting with // as comment in C source


❍ Leave a comment in the preprocessing result check box

If this check box is clicked, a comment can be left in the preprocessing result.

❍ Browse button


The path selected on the window is displayed in the Path field.

❍ Add button

This button adds the include path shown in the Path field in the List of registered paths box.

❍ Delete button



This button moves the order of a selected include path, which is registered in the List ofregistered paths box, one place up.


This button moves the order of a selected include path, which is registered in the List ofregistered paths box, one place down.

125

CHAPTER 8 COMPILE

� Macro Definition Screen of Preprocessor - fcc911s Compiler Dialog Box




❍ Name field

This field permits the user to specify the name of the macro to be registered for compilation.

❍ Value field


❍ List of Registered Macro Definition list box


The registered macros will be passed to the preprocessor sequentially from the top in this listbox.

❍ Add button

This button adds the macro specified in the Name field in the List of Registered Macro Definitionbox.

❍ Delete button


126



This button moves the order of a selected macro, which is registered in the List of RegisteredMacro Definition box, one place up.


This button moves the order of a selected macro, which is registered in the List of RegisteredMacro Definition box, one place down.

127

CHAPTER 8 COMPILE

8.2.2 Detailed Options for Language Specifications (fcc911s Compiler)

This section explains how to set the detailed options for the language specifications of the fcc911s compiler.

� Specification of Language - fcc911s Compiler Dialog Box

Figure 8.2-4 "Specification of Language - fcc911s Compiler Dialog Box" shows the Specificationof Language - fcc911s Compiler dialog box.

Figure 8.2-4 Specification of Language - fcc911s Compiler Dialog Box

The following items can be set in the Specification of Language - fcc911s Compiler dialog box:

❍ Sign of plain "char"

An unsigned or signed format can be selected for character-type data.

The default is "Unsigned."

❍ Sign of bitfield of "int"

An unsigned or signed format can be selected for integer-type bit field.


❍ Language

You can specify the level of language specification.

The default is "ANSI C plus Fujitsu Extension."

❍ INLINE expansion of a function qualified with "_interrupt"

You can specify whether to execute inline expansion of the function related to interrupt. Thedefault is execution of inline expansion.

128


❍ Regard a valuable qualified with "_io" as volatile

You can specify whether to regard each "_io" type qualifier to be volatile. The default isregarding it to be volatile.

❍ INLINE expansion of an ITRON system-call functions

You can specify whether to execute inline expansion of the function related to interrupt. Thedefault is non-execution of inline expansion.

129

CHAPTER 8 COMPILE

8.2.3 Detailed Options for Optimization (fcc911s Compiler)

This section explains how to set the detailed optimization options for the fcc911s compiler.

� Option on Optimization [fcc911s] - fcc911s Compiler Dialog Box

Figure 8.2-5 "Option on Optimization [fcc911s] - fcc911s Compiler Dialog Box" shows theOption on Optimization [fcc911s] - fcc911s Compiler dialog box.

Figure 8.2-5 Option on Optimization [fcc911s] - fcc911s Compiler Dialog Box

The following items can be set in the Option on Optimization [fcc911s] - fcc911s Compiler dialogbox:

❍ Address size of external symbols on the code section

You can specify the address size of the external symbols on the code section. The default is"32 bits."

130


❍ Address size of external symbols on data section

You can specify the address size of the external symbols on the data section. The default is "32bits."

❍ Minimal alignment boundary for static variables

You can specify the value of the minimal alignment boundary for static variables. The default is"1 byte."

❍ Method of allocation of an argument area

You can specify the static or dynamic method for the allocation of an argument area. Thedefault is "static."

❍ Type of floating constant without suffix

You can specify the type of the floating constant without suffix. The default is "double."

❍ Optimization of changing the evaluation method of arithmetic operation

You can specify whether to execute optimization to change the method of evaluating arithmeticoperations. The default is non-execution of the optimization.

❍ Optimization of pointer aliasing

You can specify whether to execute optimization of the data indicated by the pointer. Thedefault is execution of optimization.

❍ Instruction scheduling

You can specify whether to execute instruction scheduling. The default is execution ofscheduling.

❍ Loop unrolling

You can specify whether to execute loop unrolling. The default is execution of loop unrolling.

❍ Inline expansion of standard library functions/replacement to other equivalent functions

You can specify whether to execute inline expansion of standard functions or replacement withother functions. The default is no execution of inline expansion or replacement.

❍ Specified functions

If you have turned on this check box, specify the functions as the targets of inline expansion inthe field below. The default of this item is "off."

❍ All functions

If you turn on this check box, specify the number of lines of the functions subjected to inlineexpansion. The check box is unchecked by default.

❍ Specify the limitation of line numbers of functions to be inlined

If you have turned on this check box, specify the number of lines of the functions as targets ofinline expansion. The default of this item is "off."

131

CHAPTER 8 COMPILE

8.2.4 Detailed Options for Output (fcc911s Compiler)

This section explains how to set the detailed output options for the fcc911s compiler.

� Options for Outputs [fcc911s] - fcc911s Compiler Dialog Box

Figure 8.2-6 "Options for Outputs [fcc911s] - fcc911s Compiler Dialog Box" shows the Optionsfor outputs [fcc911s] - fcc911s Compiler dialog box.

Figure 8.2-6 Options for Outputs [fcc911s] - fcc911s Compiler Dialog Box

You can set the following items in the Options for outputs [fcc911s] - fcc911s Compiler dialogbox:

❍ Insert the comment lines of C source files into assembler lines

You can specify whether to insert C source files as comment lines into assembler source files(*.asm). The default is no insertion.

❍ Output assembler lists

You can specify whether to output assembler lists. The default is no output.

❍ Specify the sections of compiler - outputs

You can specify changes in the output sections of the compiler. To specify a section, enter thename, type, and address of the section in the respective fields.

132



This section explains how to set the options for the fcc907s compiler.

� fcc907s Compiler Option Setting Dialog Box

Figure 8.3-1 "fcc907s Compiler Option Setting Dialog Box" shows the fcc907s compiler optionsetting dialog box.

Figure 8.3-1 fcc907s Compiler Option Setting Dialog Box

The functions that can be set in the compiler option dialog box are explained below:

❍ Active selected compiler





• ANSI C compiler (fcc911s)

133

CHAPTER 8 COMPILE

❍ Language

Specify the language used to output diagnostic messages. Select one of the following:

• Japanese (Shift JIS)

• English (ASCII)

❍ Chip Classifcation

The Family Name of your MCU can be specified.

❍ Translation controller

One of the following two ranges of compilation can be specified. The default is "RunCompilation."

• Only Pre-Processing: Translation up to preprocessing is executed.

• Run Compilation: Translation up to compilation is executed.

❍ Optimization level







• Priority on size: Optimization with priority to size

• Priority on speed: Optimization with priority to speed

❍ Warning level

One of the following nine warning levels can be specified. The default is level 1.

• None: No output of warning messages









See Section 5.2.2 "C Options," for details on warning levels.

❍ Memory model

One of the following four memory models can be specified. The default is SMALL.

• SMALL: Use of small memory model

• MEDIUM: Use of medium memory model

• COMPACT: Use of compact memory model

134


• LARGE: Use of large memory model

❍ Target MCU

For the MCU, specify the MB number to be used. The default MCU is MB90704






You can specify whether to output a stack information file. The default is execution of output.

❍ Put ’const’ variables into RAM field

You can specify whether to put const variables into the RAM field. The default is non-execution.

❍ Details





❍ Other Options’ Description



❍ Buttons





135

CHAPTER 8 COMPILE


This section explains how to set detailed compiler options for the preprocessor of the fcc907s compiler. The relevant dialog box has two setting screens: Include Paths and Macro Definition screens. Make settings on the respective screens.


Figure 8.3-2 "Include Paths Screen" 8.3-2 shows the Include Paths screen.


❍ Path field


❍ List of registered paths



136






❍ Browse button



❍ Add button

This button adds the include path shown in the Path field to the List of registered paths box.

❍ Delete button



This button moves a selected include path up by one, which is registered in the List ofregistered paths box.


This button moves a selected include path down by one, which is registered in the List ofregistered paths box.

137

CHAPTER 8 COMPILE





❍ Name field


❍ Value field





❍ Add button

This button adds the macro specified in the Name field to the List of Registered Macro Definitionbox.

❍ Delete button


138



This button moves a selected macro up by one, which is registered in the List of RegisteredMacro Definition box.


This button moves down a selected macro down by one, which is registered in the List ofRegistered Macro Definition box.

139

CHAPTER 8 COMPILE











An unsigned or signed format can be selected for an integer-type bit field.


❍ Language




You can specify whether to execute inline expansion of the function related to an interrupt. Thedefault is execution of inline expansion.

140



You can specify whether to regard each "_io" type qualifier as volatile. The default is regardingit as volatile.


You can specify whether to execute inline expansion of ITRON system-call functions. Thedefault is non-execution of inline expansion.

141

CHAPTER 8 COMPILE






The following items can be set in the Option on Optimization [fcc907s] - fcc907s Compiler dialogbox.

❍ Type of constant without a suffix

You can specify the type of the floating constant without a suffix. The default is "double."

❍ Optimization of the arguments’ area

You can specify whether to allocate argument areas dynamically or statically. The default isstatic allocation.

142


❍ Optimization of the change of evaluation method of arithmetic operation




❍ Loop unrolling


❍ Inline expansion of standard library function/replacement to other equivalent functions

You can specify whether to execute inline expansion of standard functions or replacement withother functions. The default is non-execution of inline expansion or replacement.


If you have turned on this check box, specify the functions as the targets of inline expansion inthe field below. The check box is unchecked by default.

❍ All functions

If you turn on this check box, all functions are chosen as the targets of inline expansion. Thecheck box is unchecked by default.


If you have turned on this check box, specify the number of lines of the functions subjected toinline expansion. The check box is unchecked by default.

143

CHAPTER 8 COMPILE

8.3.4 Detailed Options for Output (fcc907s)



Figure 8.3-6 "Options for Outputs [fcc907s] - fcc911s Compiler Dialog Box" shows the Optionsfor Outputs [fcc907s] - fcc911s Compiler dialog box


You can set the following items in the Options for the Outputs [fcc907s] - fcc911s Compilerdialog box:

❍ Insert the comment lines of C source files in assembler source files

You can specify whether to insert C source files as comment lines in assembler source files(*.asm). The default is no insertion.

144


❍ Output the assembler lists




145

CHAPTER 8 COMPILE


This section explains how to set the options for the fcc896s compiler.

� fcc896s Compiler Option Setting Dialog Box

Figure 8.4-1 "fcc896s Compiler Option Setting Dialog Box" shows the fcc896s compiler optionsetting dialog box.

Figure 8.4-1 fcc896s Compiler Option Setting Dialog Box








146


❍ Language



• English (ASCII)

❍ Chip Classifcation

The Family Name of your MCU can be specified.

❍ Translation controller

One of the following two ranges of compilation can be specified. The default is "RunCompilation."

• Only Pre-Processing: Translation up to preprocessing is executed.

• Run Compilation: Translation up to compilation is executed.








• Priority on size: Optimization with priority on size

• Priority on speed: Optimization with priority on speed

❍ Warning level

One of the following nine warning levels can be specified. The default is level 1.

• None: No output of warning messages

• Level 1: Output of level 1 warning messages








See Section 5.2.2 "C Options," for details of warning levels.

❍ Target MCU

For the MCU, specify the MB number to be used. The default MCU is MB89121



147

CHAPTER 8 COMPILE




You can specify whether to output a stack information file. The default is execution of output.

❍ Details





❍ Other options’ description



❍ Buttons





148



This section explains how to set detailed compiler options for the preprocessor of the fcc896s compiler. The relevant dialog box has two setting screens: Include Paths and Macro Definition screens. Make settings on the respective screens.




❍ Path field


❍ List of registered paths box



149

CHAPTER 8 COMPILE





❍ Browse button



❍ Add button

This button adds the include path shown in the Path field to the List of registered paths box.

❍ Delete button



This button moves a selected include path up by one, which is registered in the List ofregistered paths box,.


This button moves a selected include path down by one, which is registered in the List ofregistered paths box.

150






❍ Name field


❍ Value field





❍ Add button

This button adds the macro specified in the Name field to the List of Registered Macro Definitionbox.

❍ Delete button


151

CHAPTER 8 COMPILE


This button moves a selected macro up by one, which is registered in the List of RegisteredMacro Definition box.


This button moves a selected macro down by one, which is registered in the List of RegisteredMacro Definition box.

152












An unsigned or signed format can be selected for an integer-type bit field.


❍ Language




You can specify whether to execute inline expansion of the interrupt-related function. Thedefault is execution of inline expansion.

153

CHAPTER 8 COMPILE


You can specify whether to regard each "_io" type qualifier as volatile. The default is regardingit as volatile.


You can specify whether to execute inline expansion of ITRON system-call functions. Thedefault is non-execution of inline expansion.

154







The following items can be set in the Option on Optimization [fcc896s] - fcc896s Compiler dialogbox.

❍ Type of constant without a suffix

You can specify the type of the floating constant without a suffix. The default is "double."

❍ Optimization of the arguments’ area

You can specify whether to allocate argument areas dynamically or statically. The default isstatic allocation.

155

CHAPTER 8 COMPILE

❍ Optimization of the change of evaluation method of arithmetic operation




❍ Loop unrolling


❍ Inline expansion of standard library function/replacement to other equivalent functions

You can specify whether to execute inline expansion of standard functions or replacement withother functions. The default is non-execution of inline expansion or replacement.


If you have turned on this check box, specify the functions as the targets of inline expansion inthe field below. The check box is unchecked by default.

❍ All functions

If you turn on this check box, all functions are chosen as the targets of inline expansion. Thecheck box is unchecked by default.


If you have turned on this check box, specify the number of lines of the functions subjected toinline expansion. The check box is unchecked by default.

156


8.4.4 Detailed Options for Output (fcc896s)



Figure 8.4-6 "Options for Outputs [fcc896s] - fcc911s Compiler Dialog Box" shows the Optionsfor Outputs [fcc896s] - fcc911s Compiler dialog box


You can set the following items in the Options for the Outputs [fcc896s] - fcc911s Compilerdialog box:

❍ Insert the comment lines of C source files into assembler source files

You can specify whether to insert C source files as comment lines into assembler source files(*.asm). The default is no insertion.

❍ Output the assembler lists




157

CHAPTER 8 COMPILE

8.5 Setting Options for ANSI C Compiler

The ANSI C compiler performs compilation in complete ANSI mode of fcc911s.

� ANSI C Compiler Option Setting Dialog Box

Figure 8.5-1 "ANSI C Compiler Option Setting Dialog Box"Figure 8.5-1 shows the ANSI Ccompiler option setting dialog box.

Figure 8.5-1 ANSI C Compiler Option Setting Dialog Box








158

8.5 Setting Options for ANSI C Compiler

❍ Language



• English (ASCII)

❍ Details

Only Preprocessor can be specified. See Section 8.2.1 "Detailed Options for Preprocessor(fdd911s Compiler)," for information on how to make detailed settings.


❍ Buttons





159

CHAPTER 8 COMPILE

160

CHAPTER 9 CHECK

This chapter explains the check feature.

9.1 "Check Menu"

9.2 "Argument (All)"

9.3 "Inline"

9.4 "Duplicated Functions"

9.5 "Declaration with _direct"

161

CHAPTER 9 CHECK

9.1 Check Menu

Programs can be checked using the check command. The check command can be executed from the check menu as follows:• Argument (All) command• Inline command• Duplicated Functions command• Declaration with _direct command

� Check Menu

Figure 9.1-1 Check Menu

❍ Argument (All) command

This command checks all functions to be analyzed for matching of the numbers and types ofreal and dummy arguments. It also checks for consistency in the types of function returnvalues.

❍ Inline command

This command checks all functions to be analyzed for the names of the functions that can becandidates for inline expansion.

❍ Duplicated Functions command

This command checks all functions to be analyzed for functions having the same names.

❍ Declaration with _direct command

This command checks all functions to be analyzed for the area size required for variablesdeclared with the _direct type qualification.

162

9.2 Argument (All)

9.2 Argument (All)

When the Argument (All) command in the Check menu is clicked, the command checks all analyzed functions for consistency of the numbers and types of real and dummy arguments. It also checks for consistency of the types of function return values. If an inconsistency is detected, the box frame of the applicable calling function in the Graph Flow window is highlighted in red, and a detailed message is displayed in the Argument window.If no inconsistency is detected, a message to that effect is displayed.

� Argument Window

Figure 9.2-1 "Example of the Argument Window" shows an example of the Argument window.

Figure 9.2-1 Example of the Argument Window

If a mismatch is detected between functions, the command displays the name of the source filethat references the functions and the applicable line number. The command also displays thename of the source file in which the functions are defined and the applicable line number.

See Section 15.5 "Argument Check" for information on how to check arguments betweenspecified functions.

Reference:

The user can edit a source program using the editor by double-clicking the source programname in the Argument window. See CHAPTER 21 "PROGRAM EDITING," for the editor.

163

CHAPTER 9 CHECK

9.3 Inline

When the Inline command in the Check menu is clicked, the command retrieves an inline expansion candidate function for which the expanded line count is equal to or less than the line count specified for the Upper limit of inline candidate executable statement size in the Option dialog box.If no function that can be used as an inline expansion candidate is found, the command displays a message to that effect.

� Displaying Inline Expansion Candidate Function

The Inline command checks all analyzed functions for the names of the functions that can beused as inline expansion candidates. Figure 9.3-1 "Example of Inline Window" shows anexample of the Inline window.

Figure 9.3-1 Example of Inline Window

The Inline window displays the following types of information:

❍ Function name

Name of analyzed function that can be an inline expansion candidate.

❍ Statement

Number of executable statements of a function that can be an inline expansion candidate.

❍ File name

Name of the file in which a function that can be an inline expansion candidate is defined.

❍ Requirements for a function that can be an inline expansion candidate

• The function is called from another function in a source program.

• The function is defined in a source program.

• The real argument type of the function is the same as the dummy argument type.

• The number of real arguments in the function is the same as the number of dummyarguments.

164

9.3 Inline

• The arguments of the function have no structures or unions.

• The function is not recursively called.

• The function does not call the setjmp function.

• The function is not called by referencing the address.

• The number of lines making up the function equals or less than the number specified for theUpper limit of inline candidate executable statement size.

Reference:

The user can edit a source program using the editor by double-clicking the source programname in the Inline window. See CHAPTER 21 "PROGRAM EDITING," for information aboutthe editor.

Specify a number for the Upper limit of inline candidate executable statement size accordingto the size of the area to be used.

165

CHAPTER 9 CHECK

9.4 Duplicated Functions

When the Duplicated Functions command in the Check menu is clicked, the command retrieves functions with the same name that may exist in multiple modules, and displays definition and reference information of the functions if found. If no such function is found, the command displays a message to that effect.

� Displaying Duplicated Functions

Figure 9.4-1 "Example of Duplicated Functions Window" shows an example of the DuplicatedFunctions window.

Figure 9.4-1 Example of Duplicated Functions Window

If a duplicated function is found, the command displays the locations where the function isdefined and referenced. See Section 20.1 "Displaying Cross Reference," for information on thedisplay format.

Reference:

The user can edit a source program using the editor by double-clicking the source programname in the Duplicated Functions window. See CHAPTER 21 "PROGRAM EDITING," forinformation about the editor.

166

9.5 Declaration with _direct

9.5 Declaration with _direct

When the Declaration with _direct command in the Check menu is clicked, the command compares the size (default: 256 bytes) specified for the Upper limit of total size of _direct declaration in the Option dialog box with the size actually used in the program, and displays the results.If the upper limit of the total size of _direct declaration is exceeded, the corresponding variable is displayed in red.If a variable is not declared with the _direct type qualification, a message to that effect is displayed.This function is enabled only when fcc907s or fcc896s is specified for the compiler type in the General Mode field.

� _direct Check Window

Figure 9.5-1 "Example of _direct Check Window" shows an example of the _direct checkwindow.

Figure 9.5-1 Example of _direct Check Window

❍ Name

Name of a variable declared with _direct in the program to be analyzed.

❍ Type

Type of a variable declared with the _direct type qualification.

167

CHAPTER 9 CHECK

❍ Size

Number of times a variable qualified with the _direct type has appeared statically in theanalyzed program.

❍ Reference frequency

Number of times a variable qualified with the _direct type has appeared statically in theanalyzed program.

168

CHAPTER 10 GLOBAL INFORMATION

This chapter explains the operation of global information.

10.1 "Selecting Global Information"

10.2 "Global (C)"

10.3 "Candidate for const"

10.4 "Candidate for _direct"

10.5 "Searching for Text"

169


10.1 Selecting Global Information

Select the [Global] menu in the window. In the [Global] menu, one of the following commands can be specified:• Global (C)• Candidate for const• Candidate for _direct

� Selecting Global Information

Figure 10.1-1 "[Global] Menu" shows an example of selecting global information.

Figure 10.1-1 [Global] Menu

❍ [Global (C)] command

Displays information on the global variable used in the source program to be analyzed.

❍ [Candidate for const] command

Displays the global variable to be used in the source program to be analyzed and as the const-type qualification candidate.

❍ [Candidate for _direct] command

Displays information on the global variable used in the source program to be analyzed and asthe _direct type qualification candidate.

If "display by Declaration with _direct" has already been performed, a _direct candidatecorresponding to the declared variable is displayed.

170

10.2 Global (C)

10.2 Global (C)

Click the [Global(C)] command in the [Global] menu. The function using the global variable used in the analyzed program is displayed.When no global variables are being used, the message indicating the no-global-bariable state is displayed.

� Displaying C Global Variable Information

Figure 10.2-1 "Example of C Global Variable Display Window" shows an example of the Cglobal variable display window.

Figure 10.2-1 Example of C Global Variable Display Window

❍ Type

Declared type of global variable.

❍ Name

Name of global variable used in all parts of an analyzed program.

❍ File name

The file name to which the global variable was declared.

171


❍ Line Number

The line number in the source file to which the global variable was declared.

❍ Size

The size of the global variable.

❍ Reference freqency

The number of times of reference of a global variable.

❍ Initial

Existence of explicit initialization of a global variable.

172

10.2 Global (C)

10.2.1 Global Variable and Project Window

A click of the variable name in a global variable window gives an emphasis indication of the icon of the source file name in a project window.By this function, a user can grasp easily the source program which is defining the specified global variable and is referred to.

� Global Window and Project Window

Figure 10.2-2 "Example of C Global Variable Display Window" shows an example of the Cglobal variable display window.

Figure 10.2-2 Example of C Global Variable Display Window

❍ Icon (Red)

It is the source file by which the global variable was defined.

❍ Icon (Blue)

It is the source file by which the global variable was referred to.

173


10.2.2 Pop-up Menu of Global Information

Click the right side of the mouse while in the Global Variable window to display a pop-up menu in the window

� Pop-up Menu of Global Information

Figure 10.2-3 "Global Variable Windows Pop-up Menu" shows the global variable window pop-up menu.

Figure 10.2-3 Global Variable Windows Pop-up Menu

❍ All global variable

All global variables are displayed.

❍ __io Modification

The display of a global variable by which __io ornamentation was carried out is changed.

❍ __near Modification

The display of a global variable by which __near ornamentation was carried out is changed.

❍ __far Modification

The display of a global variable by which __far ornamentation was carried out is changed.

❍ __direct Modification

The display of a global variable by which __direcr ornamentation was carried out is changed.

174

10.2 Global (C)

❍ General

The display of the global variable which is not embellished is changed.

❍ Reference View

The specified global variable displays the source file referred to and set up.

❍ Total size View

The sum total size of a global variable is displayed.

175


10.2.3 Reference View

In the global variable window, a click of a pop-up menu [Reference View] displays a reference setting list window.

� Reference View

Figure 10.2-4 Example of Reference View of C Global Variable" shows an example of thereference view of C global variable.

Figure 10.2-4 Example of Reference View of C Global Variable

❍ File name

The source file name which is referring to the specified global variable is displayed.

❍ Line Number

The line number of the source file which is referring to the specified global variable is displayed.

❍ Function name

The function name which is referring to the specified global variable is displayed.

176

10.2 Global (C)

10.2.4 Total Size View

In the global variable window, a click of a pop-up menu [Total Size View] displays total size of global variable.

� Total Size View

Figure 10.2-5 "Example of Total Size View of C Global Variable" shows an example of the totalsize view of C global variable

Figure 10.2-5 Example of Total Size View of C Global Variable

❍ Area definition

Type Qualifiers of a global variable.

❍ Size

The sum total of the variable size currently used for every type qualifiers of a global variable isdisplayed.

177


10.3 Candidate for const

Click the [Candidate for const] command in the [Global] menu. The global variables used in the analyzed program and to be optimized with the const-type qualification declaration are displayed.When no const-type candidates are found, the message indicating the no-candidate status is displayed.

� Specifying const-type Qualification Declaration Candidate

Figure 10.3-1 "Example of Window for const-type Qualification Declaration Candidate Display"shows an example of the window for const-type qualification declaration candidate display.

Figure 10.3-1 Example of Window for const-type Qualification Declaration Candidate Display

❍ Name

Name of variables used as const-type qualification declaration candidates in all parts of theanalyzed program

❍ Type

Declared type of variable used as const-type qualification declaration candidate

178

10.4 Candidate for _direct

10.4 Candidate for _direct

Click the [Candidate for _direct] command in the [Global] menu. The global variables that are used in the analyzed program and that are subjected to compiler optimization by _direct type qualification candidates are displayed.If no _direct candidate is found, a message to that effect is displayed.This function is enabled only when fcc907s or fcc896s is specified for the compiler type in the General Mode field.

� Specifying _direct-type Qualification Declaration Candidate

10.4-1 "Example of Candidate for _direct Declaration Window" shows an example of theCandidate for _direct Declaration window.

Figure 10.4-1 Example of Candidate for _direct Declaration Window

❍ Name

Name of variables used as _direct-type qualification declaration candidates in the entireanalyzed program.

❍ Size

Size (bytes) of each variable used as a _direct-type qualification declaration candidate.

❍ Reference frequency

Number of times each variable used as a direct-type qualification declaration candidate appearsstatically in the entire analyzed program.

❍ Reserved

If the "_direct check" window has already been displayed, the size of the variables declared withthe _direct-type qualification in the entire program is displayed.

179


❍ Requirements for a Variable to be a _direct-type Qualification Declaration Candidate

The requirements for a variable to be detected as a _direct-type qualification declarationcandidate are as follows:

• The size of the variable is equal to or less than the value (default: 256 bytes) specified forthe [Upper limit of total size of _direct declaration] in the [Option] dialog box.

• The variable is not declared with the _direct-type qualification.

If the [_direct check] window has not been displayed, variables already declared with the_direct-type qualification are not taken into account.

180

10.5 Searching for Text

10.5 Searching for Text

Searches for text displayed as global information.

� Searching for Text

Click the [Find] command in the [View] menu or click the [Find] command in the pop-up menu ofthe Global Variable window.

The [Find] dialog box shown in Figure 10.5-1 "[Find] Dialog Box for Global Information" isdisplayed.

Figure 10.5-1 [Find] Dialog Box for Global Information

Enter the text to be searched for in the [Find what:] box, specify the search direction and clickthe [Find Next] button to search for the specified text in the specified direction.

When the [Find Prev] command in the [View] menu is clicked, the text is searched for in thebackward direction. When the [Find Prev] command or [Find Next] command in the [View]menu is clicked, the text is searched for in the direction specified by the selected command.

181


182

CHAPTER 11 SETUP

This chapter explains the setup operation.

11.1 "Setup Menu"

11.2 "Editor Customization"

11.3 "Environment of Compiler"s

183

CHAPTER 11 SETUP

11.1 Setup Menu

The standard editor and compiler environment can be set up using setup commands. The following setup commands can be used from the [Setup] menu:• [Editor Customize] command• [Editor Setup] command• [Compilation Environment] command

� Setup Menu

Figure 11.1-1 Setup Menu

❍ [Editor Customize] command

Displays the setup dialog box for the editor to be used in C analyzer.

❍ [Editor Setup] command

Displays the setup dialog box for the standard editor contained in the C analyzer.

This command can only be used if the standard editor is selected.

❍ [Compilation Environment] command

Specifies the compilation environment that will use the C analyzer compilation function.

To use this command, the Softune compiler must be installed in advance.

184

11.2 Editor Customization

11.2 Editor Customization

The C analyzer has the standard editor function. An external editor can also be called using the customization function. This section explains how to set up the external editor.

� Setting External Editor

With the graph flow window not displayed, select the [Editor Customize] command displayed inthe [Setup] menu to display CUSTOMIZE dialog box.

Figure 11.2-1 CUSTOMIZE Dialog Box

Check the [Use External Editor]check box to register and use a familiar external editor.

❍ Editor name

Register the name of the editor used.

185

CHAPTER 11 SETUP

❍ Full path of the executive file

Specify the full-path of the execution file of the editor.

❍ Current directory for the editor

Specify the directory which starts the editor.

❍ Opening command-line

Specify the argument passed to the editor.

❍ List

The registration situation of the editor is displayed.

186

11.3 Environment of Compiler

11.3 Environment of Compiler

A compiler can be activated from the C analyzer. After the environment of the compiler is set up, the compiler can be activated. This section explains how to set up the environment of the compiler.

� Environment of Compiler

Select the [Compilation Environment] command displayed in the [Setup] menu. TheEnvironment of the compiler] dialog box is displayed.

Figure 11.3-1 [Environment of the compiler] Dialog Box (fcc911s)

The Environment of the compiler] dialog box has the following features:

❍ Install Directory

Specify the name of the directory in which the compiler is installed.

The compiler specified for the compiler type in the General Mode field is applicable.

❍ Environmental variables adopted in compilation

• Table Name: Enter the name of the environmental variable to be registered.

• Value: Enter the value of the environmental variable to be registered.

• List of registered environmental variables: Displays the environment variables alreadyregistered.

An environment variable already registered cannot be reregistered.

187

CHAPTER 11 SETUP

• [Register] button: Adds the environment variable (entered in the environmental variableinput field) to the list of registered environmental variables.

• [Remove] button: Deletes an environmental variable already registered in the list ofregistered environment variables. To delete the environmental variable, select theenvironmental variable to be deleted, click the left button of the mouse, then press the[Remove] button.

• [Upward] button: Moves the target environmental variable upwards in the list ofenvironmental variables.

• [Downward] button: Moves the target environmental variable downwards in the list ofenvironmental variables.

Note that the registered environment variables used by the Softune tool cannot be reregistered.

The registered environment variables include FETOOL, FELANG, INC911, and so on.

See CHAPTER 8 "COMPILE," for information on how to specify compiler environments orchange include paths.

Remarks

To use the compilation function, a compiler manufactured by Fujitsu must be installed inadvance. If a Fujitsu compiler is not installed, a message indicating a no-compiler-installedstate is displayed when the compiler environment function is used.

188

CHAPTER 12 WINDOWS

This chapter explains window display and operation.

12.1 "[Window] Menu"

189

CHAPTER 12 WINDOWS

12.1 [Window] Menu

Windows can be operated and the window display method can be changed using window commands. The [Window] menu has the following commands:• [Cascade] command• [Tile Horizontally] command• [Tile Vertically] command• [Arrange Icons] command• [Close all] command• [window-name-1, 2, ...] commands

� [Window] Menu

Figure 12.1-1 [Window] Menu

190

12.1 [Window] Menu

❍ [Cascade] command

Displays two or more windows overlapping.

Figure 12.1-2 Cascade

191

CHAPTER 12 WINDOWS

❍ [[Tile Vertically] command

Displays two or more windows vertically.

Figure 12.1-3 Tile Vertically

192

12.1 [Window] Menu

❍ Tile Horizontally] command

Displays two or more windows horizontally.

Figure 12.1-4 Tile Horizontally

❍ [Arrange Icons] command

Arranges the iconized windows at the bottom of the application main window. When the filewindow is open and overlapping the bottom part of the main window, the icons under thiswindow cannot be viewed.

Figure 12.1-5 Arrange Icons

❍ [Close all] command

Closes all the displayed windows.

193

CHAPTER 12 WINDOWS

❍ [window-name-1, 2, ...] commands

Displays a list of various windows currently opened by the C analyzer. This list is displayed atthe bottom field of the [Window] menu.

194

CHAPTER 13 HELP

This chapter explains the display and operation of the help function.

13.1 "[Help] Menu"

195

CHAPTER 13 HELP

13.1 [Help] Menu

Help topics can be searched for using the help command.The [Help] menu has the following commands:• [Help Topics] command• [About C Analyzer] command

� [Help] Menu

Figure 13.1-1 [Help] Menu

❍ [Help Topics] command

Displays the outline of the C analyzer function and the table of contents of the help data. Theprinting and keyword searching of help files can also be performed.

Figure 13.1-2 Help Topics

196

13.1 [Help] Menu

❍ [About C Analyzer] command

Displays version and copyright information on the C analyzer.

Figure 13.1-3 About C Analyzer

197

CHAPTER 13 HELP

198

CHAPTER 14 PRINTING

This chapter explains the printing operation and features

14.1 "Printing the Analysis Window"

199

CHAPTER 14 PRINTING

14.1 Printing the Analysis Window

It is possible to print the content of each analysis window from C Analyzer.

� Printing Print Information

It is possible to print from the following analysis windows:

• Graph flow window

• Function name list window

• Global variable window

• Inline candidate window

• const candidate window

• Logic flow window

• Summary window

• Xreference window

• Standard editor edit window

� Printer Setup

The printer setup dialog box is displayed by clicking "Printer Setup" from the "Project" menu.

The following can be set from the "Printer Setup" dialog box.

❍ Printer Name:

A list of the printers set up in the computer are displayed.

❍ Properties:

Displays the currently selected printer. The properties dialog box is displayed.

❍ Output to file:

Outputs the document to a file rather than directly to a printer. A dialog box is displayed tospecify the file name and location.

❍ Select Print Area

Specifies the range to be printed.

• All (Prints the whole document)

• Pages (specifies the range of pages to print with two boxes)

• Selected area (prints the area currently selected in the document)

❍ Copies

Specifies the number of copies to print.

200

14.1 Printing the Analysis Window

Figure 14.1-1 Printer Setup Dialog Box

� "Print Preview" Window

Displays the content to be printed in the "Print Preview" window. The following items can be setin the "Print Preview" window.

❍ "Print" button:

Displays the "Print" dialog box.

❍ "Print Setup" button:

Sets the print format. When this button is selected, the "Print Setup" dialog box is displayed,and detailed settings for the printer can be specified.

This feature is only displayed when the standard editor is selected.

• Columns: Sets the number of columns. It is possible to set either 1, 2, 3 or 4 columns. Thedefault is 1.

• Print header : Sets whether or not to print a header. It is possible to set file names, pagenumbers and the date/time as headers. The default has no setting.

• Print footer : Sets whether or not to print a footer. It is possible to set file names, pagenumbers, and the date/time as footer. The default has no setting.

• Print line numbers: Sets whether to print line numbers or not. The default has no setting.

• Print key words in bold: Sets whether or not to print key words in bold. It is possible to set Clanguage, asm language, extensions, and user-defined as key words. The default has nosetting.

• Top margin: Sets the top margin.

• Left margin: Sets the left margin.

❍ "Next page" button:

Displays a preview of the next page.

201

CHAPTER 14 PRINTING

❍ "Previous page" button:

Displays a preview of the previous page.

❍ "Enlarge" button:

Shows the preview enlarged.

❍ "Reduce" button:

Shows the preview reduced.

❍ "Close" button:

Closes the preview window.

Figure 14.1-2 Print Preview Window

202

CHAPTER 15 GRAPH FLOW

This chapter explains the display and operation of a graph flow.

15.1 "Displaying Graph Flow"

15.2 "Pop-up Menu of Graph Flow"

15.3 "Enlargement/Reduction Display"

15.4 "Focus Display"

15.5 "Argument Check"

15.6 "Displaying Undefined Functions"

15.7 "Outputting Bitmap File"

203


15.1 Displaying Graph Flow

A graph flow shows the call relationship between functions contained in a program. When there are recursive functions and undefined functions, the type of the function is displayed.

� Displaying Graph Flow

The [Graph Flow] window shows the call relationship between functions in a program.

If the graph flow analysis is terminated normally, the [Graph Flow] window is displayedautomatically.

An analyzed project can be opened, and its [Graph Flow] window can be opened using the[Display Analysis Information] command in the [Analyze] menu.

Figure 15.1-1 Graph Flow

A box indicates a function.

A line indicates a function-calling relation.

204

15.1 Displaying Graph Flow

A red line indicates a call from a lower box (function) to an upper box (function) or indicates arecursive call to the box (function) itself.

When a function recursively calls itself, a red-line box is displayed in the upper-right corner ofthe box as shown in Figure 15.1-2 "Example of a Recursive Call".

Figure 15.1-2 Example of a Recursive Call

Boxes and lines will not be displayed in the following cases:

• The source program has a function call but the function is not found in the analyzed sourceprogram. (Example: C library, system call)

• To display such functions as boxes, click the [All functions] command displayed in the[View] menu.

• A function is called using a pointer.

205


15.2 Pop-up Menu of Graph Flow

Place the mouse pointer into the function box displayed in the [Graph Flow] window and click the right side of the mouse. A pop-up menu is displayed in the [Graph Flow] window.

� Graph Flow Pop-up Menu

Figure 15.2-1 Graph Flow Pop-up Menu (Displayed Outside the Box)

206

15.2 Pop-up Menu of Graph Flow

Figure 15.2-2 Graph Flow Pop-up Menu (Displayed Inside the Box)

• [Previous Focus Level] and [Top Focus Level] commands: See Section 15.4 "FocusDisplay".

• [Zoom] command: See Section 15.3 "Enlargement/Reduction Display".

• [Open the File] command: Displays the specified function in the edit window.

• [Focus [Callee]] command and [Focus [Callee & Caller]] command: See Section 15.4 "FocusDisplay".

• [Argument Information] command: See Section 15.5 "Argument Check."

• [Logic Flow] command: See CHAPTER 18 "LOGIC FLOW".

• [Summary] command: See CHAPTER 19 "SUMMARY".

• [Xreference] command: See CHAPTER 20 "CROSS REFERENCE".

• [Show Max Used Stack] command: See CHAPTER 22 "MAX USED STACK".

• [Max Used Stack Route] command: See CHAPTER 22 "MAX USED STACK".

• [Tree-viewed Graph Flow] command: See Section 7.7 "Analysis Information (Tree View)".

• [All Functions] command: See Section 15.6 "Displaying Undefined Functions".

• [Focus [Max Used Stack Route]] command: See CHAPTER 22 "MAX USED STACK".

• [Find..] command: See Section 7.10 "Find".

• [Output Bitmap File...] command: See Section 15.7 "Outputting Bitmap File".

207


15.3 Enlargement/Reduction Display

A graph flow can be displayed with a specified magnification factor by clicking the [Zoom] command in the pop-up menu of the Graph Flow window.

� Enlarging Graph Flow

Figure 15.3-1 "Example of Enlarged Graph Flow" shows an example of an enlarged graph flow.

Figure 15.3-1 Example of Enlarged Graph Flow

208

15.3 Enlargement/Reduction Display

� Reducing Graph Flow

Figure 15.3-2 "Example of Reduced Graph Flow" shows an example of a reduced graph flow.

Figure 15.3-2 Example of Reduced Graph Flow

Reference:

When the original size is 100%, an enlarged size (125%, 150%, 175%, or 200%) or reducedsize (75% or 50%) can be displayed. When a 50% size is displayed, the information insideeach box in the graph flow is not displayed and call-relation-indicating boxes and lines onlyare displayed.

209


15.4 Focus Display

Place the mouse pointer in the base function box in the [Graph Flow] window, display the graph flow pop-up menu, and click the [Focus [Callee]] or [Focus [Callee & Caller]] command to display a graph flow starting from the specified function.

� Selecting Focus

Figure 15.4-1 "Pop-up Menu of Graph Flow (Focus Selection)" shows an example of focusselection.

Figure 15.4-1 Pop-up Menu of Graph Flow (Focus Selection)

210

15.4 Focus Display

� Displaying Focus

Focus display can be classified as follows:

• Display of calling relationship from specified function

• Display of calling relationship from and to specified function

When the [Focus [Callee]] command in the graph flow pop-up menu is clicked, the screenshown in Figure 15.4-2 "Display Example of Graph Flow Using the [Focus [Callee]] Command"is displayed.

When the [Focus [Callee & Caller]] command in the graph flow pop-up menu is clicked, thescreen shown in Figure 15.4-3 "Display Example of a Graph Flow Using the [Focus [Callee &Caller]] Command" is displayed. The name of the base calling function is displayed in the box inthe color green.

These operations can be executed consecutively. The [Focus [Callee]] display can becombined with the [Focus [Callee & Caller]] display. The operation count is displayed in the[Focus Level] field at the left top of the Graph Flow window. (The initial value of the Focus Levelis 0.)

To return the display to its previous state, click the [Previous Focus Level] command displayedin the graph flow pop-up menu. To return the display to its initial state (focus level 0), click the[Top Focus Level] command in the graph flow pop-up menu.

211


Figure 15.4-2 Display Example of Graph Flow Using the [Focus [Callee]] Command

212

15.4 Focus Display

Figure 15.4-3 Display Example of a Graph Flow Using the [Focus [Callee & Caller]] Command

213


15.5 Argument Check

Click the [Argument Information] command in the graph flow pop-up menu. Information on checking arguments between specified functions is displayed.

� Selecting Argument Information

Display argument information as follows:

1. In the Graph Flow window, move the mouse pointer to the box of the function on whichargument information needs to be displayed, display the graph flow pop-up menu, and clickthe Argument Information command.

2. The mouse pointer changes to the hand shape.

3. Move the mouse pointer to the box that calls the function or one that is called by the function,and click the mouse button. The argument information window between the two functions isdisplayed.

Figure 15.5-1 "Example of Argument Information Window" shows an example of the argumentinformation window.

Figure 15.5-1 Example of Argument Information Window

� Displaying Dummy Argument Information

Information on the dummy argument is displayed as follows:

❍ Number

Displays the sequence number of the specified dummy argument. "-" is displayed for a functionname.

❍ Name

Displays a dummy argument or function name.

214

15.5 Argument Check

❍ Type

Displays the type of a dummy argument or the function result.

❍ Line Number

Displays the number of the line on which a dummy argument or function is defined, declared,set, or referenced, and also displays its use.

The use is one of the following:

• (Dec): Definition or declaration

• (Def): Setting

• (Ref): Reference

� Displaying Real Argument Information

Information on the real argument includes the following:

• Name of the source file that calls the function, and line number

• Messages about checking for matching of the numbers and types of real and dummyarguments, and for matching of the types of function return values

• Types of function return values, and sequence numbers and types specified for realarguments

The following types of information are displayed in the File Name field:

• Names of source files and include files including dummy arguments, and names of includedfiles and their identification numbers

When the number of the line on which a function name in dummy argument information or adummy argument name appears is the line number of the include file, the identification numberis displayed immediately after the line number. The function name and the name of the file inwhich a dummy argument is declared, set, or referenced can be known from the identificationnumber. If no line number is assigned, the file name is assigned identification number [*0].

Reference:

The user can edit a source program using the editor by double-clicking the source file namein the argument information window. See CHAPTER 21 "PROGRAM EDITING," forinformation about the editor.

� Pop-up Menu of Argument Information

Figure 15.5-2 "Pop-up Menu of Argument Information" shows an example of the pop-up menuof argument information.

215


Figure 15.5-2 Pop-up Menu of Argument Information

• [Copy] command: Copies a selected character string to the clipboard. This command worksin the same manner as the [Copy] command in the [Edit] menu.

• [Select All] command: Selects all characters displayed in the argument information window.This command works in the same manner as the [Select All] command in the [Edit] menu.

• [Logic Flow] command: Displays the logic flow of the function on the real argument side.

• [Find] command: Searches a character string displayed in the argument information window.This command works in the same manner as the [Check] command in the [View] menu.

216

15.6 Displaying Undefined Functions

15.6 Displaying Undefined Functions

Click the [All Functions] command in the graph flow pop-up menu. The call relationship of function boxes in the analyzed source program and the function boxes whose procedures are not contained in the source program are displayed. The bottoms of these boxes are displayed in yellow.

� Displaying Undefined Functions

Usually only function boxes contained in the analyzed source program are displayed. Functionboxes called but whose procedures are not contained in the source program (e.g., C standardlibrary or operating system call) are not displayed.

However, when the [All Functions] command in the graph flow pop-up menu is clicked, both thefunction boxes contained in the analyzed source program and the function boxes that are calledbut whose procedures are not contained in the source program are displayed. The functionboxes called but whose procedures are not contained in the source program are displayed. Thebottom of these boxes are displayed in yellow.

Figure 15.6-1 Display Example of Undefined Functions

217


15.7 Outputting Bitmap File

The window image of a graph flow can be saved in a bitmap file by clicking the [Output Bitmap File...] command in the pop-up menu of the Graph Flow window.

� Outputting Bitmap File

The window image of a graph flow can be saved in a bitmap file. Figure 15.7-1 "Example ofselecting the [Output Bitmap File...] command" shows an example of selecting the [OutputBitmap File...] command.

Figure 15.7-1 Example of selecting the [Output Bitmap File...] command

Figure 15.7-2 "Display of saving a bitmap file" shows a display for saving a bitmap file.

Figure 15.7-2 Display of saving a bitmap file

218

CHAPTER 16 CALL TREE

This chapter explains the display and operation of a call tree.

16.1 "Displaying Call Tree"

16.2 "Call Tree Pop-up Menu"

219


16.1 Displaying Call Tree

Display the graph flow and select the [Analysis Information [Tree View]] command displayed in the [View] menu to display a Call Tree window.

� Displaying Call Tree

A call tree is a list structure that indicates the function call relationship.

Figure 16.1-1 Display Example of Call Tree

Each box in the call tree shows a function in the program. Its function name and arguments arealso displayed. A value enclosed in parentheses indicates the number of logical lines of thefunction.

The box of a function whose procedure does not exist in the source program is displayed withits lower part yellowed.

The number that follows <Detail>: indicates the number of lines in the call tree having detailedcall relationships.

Functions with a recursive call are shown with an arrow (see Figure 16.1-2 "Example ofFunction with Recursive Call").

Figure 16.1-2 Example of Function with Recursive Call

The number that follows <Recursive>: also indicates the number of lines in the call tree havingdetailed call relationships.

220

16.1 Displaying Call Tree

� Linking with Graph Flow Window

If the mouse button is clicked on a function name displayed in the Call Tree window while theGraph Flow window is open, the corresponding function box in the Graph Flow window ishighlighted.

221


16.2 Call Tree Pop-up Menu

Place the mouse pointer in a function box in the Call Tree window. Click the right side of the mouse to display a pop-up menu in the call tree. Click the left side of the mouse to display the function box in red.

� Call Tree Pop-up Menu

Figure 16.2-1 Call Tree Pop-up Menu (Outside Box)

Figure 16.2-2 Call Tree Pop-up Menu (Inside Box)

• [Open The File] command: Displays the edit window of the source program that includes aspecified function definition. For details, See CHAPTER 21 "PROGRAM EDITING".

222

16.2 Call Tree Pop-up Menu

• [Logic Flow] command: Displays the logic flow window that contains a specified functiondefinition. For details, See CHAPTER 18 "LOGIC FLOW".

• [Summary] command: Displays statistical information on a specified function. For details,See CHAPTER 19 "SUMMARY".

• [Xreference] command: Displays cross reference information on a specified function. Fordetails, See CHAPTER 20 "CROSS REFERENCE".

• [Open All] command: Displays all the windows in the Call Tree window.

• [Close All] command: Displays only the top-level function in the Call Tree window.

• [All Functions] command: Displays all functions including those not defined in the Call Treewindow.

• [Find..] command: Searches for a function name in the Call Tree window.

• [Text Output] command: Outputs the structure in the Call Tree window to a text file.

223


224

CHAPTER 17 FUNCTION NAME LIST

This chapter explains the description and operations of the function name list.

17.1 "Display Function Name List"

17.2 "Pop-up Menu of Function Name List"

225


17.1 Display Function Name List

Click the [Function Name List] command in the [View] menu. The Function Name List window is displayed.

� Function Name List

The Function Name List window displays the names of analyzed functions and source files inwhich the functions are defined. Move the mouse pointer to a name to be checked and click themouse button. The frame of the corresponding function box displayed in the Graph Flowwindow changes to red. If the name is double-clicked, the corresponding logic flow appears.

Figure 17.1-1 "Example of Function Name List Window" shows an example of the FunctionName List window.

Figure 17.1-1 Example of Function Name List Window

The following two types of attributes are displayed in the Function Name List window.

Function Name: Displays function names.

❍ [T] Attribute

Indicates the top of the function tree.

❍ File Name

Displays the names of source files containing function definitions.

❍ Call Count

Displays the number of functions called directly by other functions.

❍ Nesting Level

Displays function call nesting levels.

226

17.2 Pop-up Menu of Function Name List

17.2 Pop-up Menu of Function Name List

When the right mouse button is clicked in the Function Name List window, a pop-up menu is displayed in the window. If the left mouse button is clicked, the box of the corresponding function displayed in the Graph Flow window changes to red.

� Pop-up Menu of Function Name List

Figure 17.2-1 Pop-up Menu of Function Name List

❍ Graph Flow [Call Source]

This command displays focus [Mutual Call] in the Graph Flow window for the selected function.

❍ Graph Flow [Call Destination]

This command displays focus [Call Destination] in the Graph Flow window for the selectedfunction.

❍ View [All Functions]

This command displays all functions in the Function Name List window.

❍ View [Top Level]

This command displays only top-level functions that are not called by any other functions.

❍ Open File

This command displays the Edit window for the source program containing the specifiedfunction definition. See CHAPTER 21 "PROGRAM EDITING," for more information.

❍ Logic Flow

This command displays a Logic Flow window containing the specified function definition. SeeCHAPTER 18, "LOGIC FLOW," for more information.

227


228

CHAPTER 18 LOGIC FLOW

This chapter explains how to display and operate Logic Flow

18.1 "Display Logic Flow"

18.2 "Logic Flow Pop-Up Menu"

229


18.1 Display Logic Flow

The pop-up menu is displayed by moving the mouse pointer to the function box displayed in the Graph Flow window and clicking the right side of the mouse.

� Select Logic Flow

The Logic Flow window can be displayed from the following locations:

• Graph Flow window: Function box pop-up menu

• Summary window: Pop-up menu within the window

• Xreference: Pop-up menu within the window

• Call Tree window: Function pop-up menu

• Function List window: Function pop-up menu, or by double-clicking the mouse

� Display Logic Flow

18.1-1 "Logic Flow Window Example" shows an example of the Logic Flow window

Figure 18.1-1 Logic Flow Window Example

The (line) column shows the source file line number.

The (inc) column shows the depth of the structure of the source program included using the#include pre-processing command.

The if statements, for statements, switch statements, break statements, goto statements, whilestatements, return statements, continue statements, structure declarations, and uniondeclarations are displayed as shown in Figure 18.1-2 "Example of Statements and Declarations"

230

18.1 Display Logic Flow

Figure 18.1-2 Example of Statements and Declarations

231


18.2 Logic Flow Pop-Up Menu

The pop-up menu is displayed by clicking the right mouse button within the Logic Flow window.

� Logic Flow Pop-up Menu

Figure 18.2-1 Logic Flow Pop-up Menu

• "Comment" command: Specifies whether to display or not display the comment in the LogicFlow display.

• "User Include" command: Specifies whether to display or not display the contents of the UserInclude file in the Logic Flow display.

• "System Include" command: Specifies whether to display or not display the contents of theSystem Include file in the Logic Flow display.

• "Find" command: Searches for text in the Logic Flow window.

232

CHAPTER 19 SUMMARY

This chapter explains how to display and operate Summary

19.1 "Displaying Summary"

19.2 "Summary Pop-up Menu"

19.3 "How to Measure and Use Complexity"

233

CHAPTER 19 SUMMARY

19.1 Displaying Summary

Displays the Summary for the function specified in the Graph Window.

� Displaying Summary

Figure 19.1-1 "Example of Summary Window" displays an example of the Summary window.

Figure 19.1-1 Example of Summary Window

The following information is displayed in the Summary.

❍ Function Name

Displays the function name

❍ File

Displays the name of the source file containing the function. Double-clicking the source filename will permit the user to edit the source file using an editor. For information on the editor,see "Editing the Program."

❍ Complexity

Displays complexity level. For information on complexity, see Section19.3 "How to Measureand Use Complexity."

❍ Number of Statements

Displays the number of statements that include functions.

❍ Callee Functions

Displays the name of the callee functions. If no function procedures exist in the analyzedsource program, an * mark is placed at the start of the callee function name.

234

19.1 Displaying Summary

❍ Caller Functions

Caller functions are displayed.

❍ If Statement

Displays the number of times the if statement appears.

❍ Switch Statement

Displays the number of times the switch statement appears.

❍ While Statement

Displays the number of times the while statement appears.

❍ Do-while Statement

Displays the number of times the do-while statement appears.

❍ For Statement

Displays the number of times the for statement appears.

❍ Continue Statement

Displays the number of times the continue statement appears.

❍ Break Statement

Displays the number of times the break statement appears.

❍ Return Statement

Displays the number of times the return statement appears.

❍ Goto Statement

Displays the number of times the go to statement appears.

❍ Asm Statement

Displays the number of times the asm statement appears.

❍ Labels

Displays the number of Labels that appear.

❍ Case Labels

Displays the number of Case labels that appear.

❍ Default

Displays the number of Default labels that appear.

235

CHAPTER 19 SUMMARY

19.2 Summary Pop-up Menu

The pop-up menu is displayed in the window by clicking the right side of the mouse in the Summary window.

� Summary Pop-up Menu

Figure 19.2-1 "Summary Pop-up Menu" is an example of the Summary pop-up menu.

Figure 19.2-1 Summary Pop-up Menu

• "Copy" command: Stores the selected text on the clipboard. Provides the same feature asthe "Copy" command from the "Edit" menu.

• "Select All" command: Selects the text displayed in the Summary window. Provides thesame feature as the "Select All" command from the "Edit" menu.

• "Logic Flow" command: Displays the logic flow of the specified function.

• "Find" command: Searches for text displayed in the Summary window. Provides the samefeature as the "Find" command from the "Display" menu.

236

19.3 How to Measure and Use Complexity

19.3 How to Measure and Use Complexity

The initial complexity value for each function is set to 1.

� Measuring Complexity

Complexity is increased according to the following rules:

• When an if statement, while statement, for statement, do-while statement, goto statement, orswitch statement appears, 1 is added.

• Where statement labels or case labels appear, the number is added.

� How to Use Complexity

If the complexity level is high, the control structure for that function is also complex, therebyincreasing the likelihood of bugs occurring.

237

CHAPTER 19 SUMMARY

238

CHAPTER 20 CROSS REFERENCE

This chapter explains how to display and operate Cross Reference.

20.1 "Displaying Cross Reference"

20.2 "Cross Reference Pop-up Menu"

239


20.1 Displaying Cross Reference

Displays Cross Reference for the specified function within the Graph Flow window.

� Displaying Cross Reference

Figure 20.1-1 "Cross Reference Window Example" is an example of the Cross Referencewindow

Figure 20.1-1 Cross Reference Window Example

240

20.1 Displaying Cross Reference

� Variable/Function Information

The following information is displayed for variable/function information.

❍ Name

Displays variable name, function name, parameter name, and enumerator name.

❍ Attributes

The following attributes are displayed.

• Variable

• Function

• Parameter

• Enumerator

Furthermore, in the case of an extern declaration, extern, in the case of a static declaration,static, in the case of a prototype declaration, prototype, in the case of a function definition,definition, and in the case of an implicit declaration, implicit is additionally displayed.

❍ Type

Displays variable type, function result type, and parameter type are displayed.

❍ Line Number

Displays the definitions, declarations, settings, and reference line numbers for variables,functions, parameters, and enumerators and uses thereof.

� Tag/Type Definition Information

The following information is displayed for tag/type definition information.

❍ Name

Displays structure tag names, shared structure tag names, enumerator tag names, and typedefdeclared names.

❍ Type

The following tag names and typedef-declared name types.

• Structure tag

• Union tag

• Enumeration tag

• Typedef

❍ Types

Tag and type definition base types are displayed.

❍ Definition

Defined line numbers are displayed.

� Macro Information

The following information is displayed.

241


❍ Macro Name

The name of the macro being used is displayed.

❍ Replacement Text

When defining a macro, the replacement text is displayed. If the macro is made invalid, this isleft blank.

❍ #define

When defining a macro, the defined line numbers are displayed. If the macro is made invalid,this is left blank.

❍ #undef

When making a macro invalid, the invalid line numbers are displayed. When defining a macro,these are left blank.

� File Name Information

The following information is displayed.

The name of source files or included source files containing variable names, function names,tag name or macro definitions, and reference numbers thereof.

In the case that the line numbers in which the variable names, function names, tag namedefinitions, and macro definitions appear are include file line numbers, the reference number isdisplayed directly after the line number. It is possible to know the name of files in which variablenames, function names, tag name definitions, and macro definitions appear by looking at thisreference number.

When there is no reference number placed next to the line number, the file name becomes thereference number (*0).

Reference:

By double-clicking the name of the source file in the Cross Reference window, it is possibleto edit the source program using an editor. See CHAPTER 21 "PROGRAM EDITING" forinformation on the editor.

242

20.2 Cross Reference Pop-up Menu

20.2 Cross Reference Pop-up Menu

The pop-up menu is displayed in the window by moving the mouse pointer to the Cross Reference window and clicking the right side of the mouse.

� Cross Reference Pop-up Menu

Displays an example of the Cross Reference pop-up menu.

Figure 20.2-1 Cross Reference Pop-up Menu

❍ "Variable/Function Information" Command

Specifies whether or not to display information on Cross Reference variables and functions.

❍ "Tag/Type Information" Command

Specifies whether or not to display information on Cross Reference tags/types.

❍ "Macro Information" Command

Specifies whether or not to display information on Cross Reference macros.

❍ "File Name Information" Command

Specifies whether or not to display information on Cross Reference file names

❍ "Copy" Command

Places the selected text onto the clipboard. This has the same effect as the "Copy" commandfrom the "Edit" menu.

❍ "Select All" Command

Selects the text displayed in the Cross Reference window. This has the same effect as the"Select All" command from the "Edit" menu.

243


❍ "Logic Flow" Command

Displays the logic flow of the specified function.

❍ "Find" Command

Searches for text displayed within the Cross Reference window. This has the same effect asthe "Find" command from the "Display" menu.

244

CHAPTER 21 PROGRAM EDITING

This chapter explains how to start the standard editor and how to edit the program.

21.1 "Activate the Standard Editor"

21.2 "External Editor Setup"

21.3 "Standard Editor Setup"

21.4 "Standard Editor Pop-up Menu"

21.5 "Other Functions"

245


21.1 Activate the Standard Editor

Activate the standard editor by clicking the "New Edit File" command or the "Open Edit File" command from the "File" menu.It is also possible to activate and edit using the specified standard editor by double-clicking the name of the source file listed within each analysis window.

� Activate the Standard Editor

Specifying the "New Edit File" command from the "File" menu will display an untitled editwindow.

Figure 21.1-1 "Standard Editor Activation Screen Example" is an example of the screen of astandard editor upon activation.

Figure 21.1-1 Standard Editor Activation Screen Example

The standard editor can be started from the following analysis windows. See the explanationsfor the analysis windows for details on how to activate.

• Analysis Message Window

• Function Name List Window

• Inline Candidate Window

• Summary Window

• Xreference Window

246

21.2 External Editor Setup

21.2 External Editor Setup

C Analyzer includes a standard editor feature. A specified external editor can also be activated through customization. The extarnal editor is set up as follows.

� External Editor Setup

The "Customization" dialog box in Figure 21.2-1 "Customization Dialog Box Example" isdisplayed by selecting the "Editor Customize" command from the "Setup" menu, with no editwindow displayed.

Figure 21.2-1 Customization Dialog Box Example

Clicking the "Use External Editor" check box will register and edit using a familiar editor.

Refer to 11.2 "Editor Customization" for the details about each item.

247


21.3 Standard Editor Setup

With the standard editor selected, clicking the "Editor Customize" command from the "Setup" menu will display the standard editor set up dialog box.

� Standard Editor Setup (General)

Figure 21.3-1 "Standard Editor Setup Dialog Box (General)" shows the standard editor setupdialog box (General).

Figure 21.3-1 Standard Editor Setup Dialog Box (General)

The following display features can be set up and colors can be displayed from the standardeditor setup window (General).

❍ EOF

Displays the end of file symbol EOF.

❍ Line Number

Displays the logical line number on the left of the edit window.

248


❍ Return Character

Displays the return code with a special symbol.

❍ Ruler

Displays the ruler in the edit window.

❍ Wide Char Space

Displays wide char space with a special symbol.

❍ Comment

Emphasizes the comment section.

❍ Tab

Displays the tab code as a special character.

❍ Error Tag

Sets the tag display character according to the error jump.

❍ Tab & Indent

• Automatic Indent: Automatically matches the indent with the intent on the preceding line.

• Tab Display: Displays the tab as a special symbol.

• Tab: Displays the number of tab code skips.

249


� Standard Editor Setup (Key Words)

Figure 21.3-2 "Standard Editor Setup Dialog Box (Key Words)" shows the standard editor setupdialog box (Key Words)

Figure 21.3-2 Standard Editor Setup Dialog Box (Key Words)

Shows the emphasis for each key word. The display color can be set using the button on theright.

❍ C language keyword emphasis

Displays key words defined in the C language key word file in bold.

❍ ASM keyword emphasis

Displays key words defined in the ASM keyword file in bold.

❍ Extensional keyword

Displays key words defined in the extensional keyword file in bold.

❍ User-defined function

Displayed key words defined in the keyword file (REALOS system call etc.) in bold.

❍ Search Results

Displays search results in bold.

250


❍ Register Keyword Button

Displays the Registration of Keywords dialog box.

Figure 21.3-3 Registration of Keywords Dialog Box

Using the Registration of Keywords dialog box, each type of keyword file can be set up.

❍ Language

Sets the language type. You can choose C, C++, Assembler, User-defined function orExtensional.

❍ Initialize

Registers key word in its initial state.

❍ Add

Adds key word.

❍ Remove

Removes key word.

251


21.4 Standard Editor Pop-up Menu

The pop-up menu is displayed in the edit window by clicking the right side of the mouse in the standard editor edit window.

� Standard Editor Pop-up Menu

Figure 21.4-1 "Example of Standard Editor Pop-up Menu" shows the standard editor pop-upmenu.

Figure 21.4-1 Example of Standard Editor Pop-up Menu

❍ "Undo"

Cancels the most recent edit and the state is returned to that before the edit. When duplicatecharacters or duplicate lines are edited at the same time, the section is restored at the sametime.

❍ "Redo"

Cancels the edit carried out by the "Undo" command.

❍ "Cut"

Cuts the selected area and places the cut content onto the clipboard.

❍ "Copy"

Places the selected area onto the clipboard.

252

21.4 Standard Editor Pop-up Menu

❍ "Paste"

Pastes the text stored on the clipboard.

❍ "Delete"

Deletes the selected area but does not place it on the clipboard.

❍ "Select All"

Selects all of the displayed text.

253


21.5 Other Functions

This section explains the various features available while the standard editor edit window is displayed.

� "File" Menu

❍ "New Edit File" command

Creates a new text file

❍ "Open Edit File" command

Opens a file for editing.

❍ "Close" command

Closes the active edit window.

❍ "Save" command

Saves the amended file.

❍ "Save as.." command

Saves the amended file with a new name.

� "Edit" Menu

❍ "Undo"

Cancels the most recent edit and the state is returned to that before the edit. Where duplicatecharacters or duplicate lines are edited at the same time, the section is restored at the sametime.

❍ "Cut"

Cuts the selected area and places the cut content onto the clipboard.

❍ "Copy"

Places the selected area onto the clipboard.

❍ "Paste"

Pastes the text stored on the clipboard.

❍ Find

The character sequence in the specified edit window is searched.

❍ Replace

The character sequence in the specified edit window is searched and replaced.

254

21.5 Other Functions

❍ Find in Files

It searches whether there is any character sequence specified in the specified file.

255


256

CHAPTER 22 MAX USED STACK

This chapter will explain how to display and operate the max used stack.

22.1 "Max Used Stack (Specified Function)"

22.2 "Max Used Stack (All Functions)"

22.3 "Max Used Stack Route (Specified Function)"

22.4 "Max Used Stack Route (All Functions)"

22.5 "Max Used Stack Route Focus"

257


22.1 Max Used Stack (Specified Function)

It is possible to show the max used stack for the function specified in the graph flow window.

� Display of Max Used Stack for Specified Function

Figure 22.1-1 Show Max Used Stack (Specified Function)

Proceed as follows to show the max used stack for the specified function:

1. Display undefined functions by clicking the "All Functions" command from the graph flowwindow pop-up menu.

2. In the "Graph Flow" window, move the mouse to the box of the function for which the maxused stack is to be displayed and choose "Show Max Used Stack" from the "Graph Flow"pop-up menu.

3. The max used stack can be displayed for the specified function. The max used stack of thecallee function is not taken into consideration at this time.

Note:

To calculate the max used stack, individual C source files must be created for used stackinformation files using the C Analyzer compile feature.

258

22.2 Max Used Stack (All Functions)

22.2 Max Used Stack (All Functions)

Displays the max used stack for all function boxes in the graph flow window.

� Display of Max Used Stack for All Functions

Figure 22.2-1 Show Max Used Stack (All Functions)

Proceed as follows to show the max used stack for all functions:


2. Max used stack can be shown for all displayed functions by clicking the "Max Stack"command from the "Display" menu.

Note:


259


22.3 Max Used Stack Route (Specified Function)

Based on the function specified in the graph flow window (as a base point), displays the route of the function that uses the largest number of stacks.

� Display of Max Used Stack Route for Specified Functions

Figure 22.3-1 Show Max Used Stack Route (Specified Function)

Proceed as follows to show the max used stack route for the specified function:


2. In the "Graph Flow" window, move the mouse to the box of the function for which the maxused stack route is to be displayed and choose "Max Used Stack Route" from the "GraphFlow" pop-up menu.

3. With the specified function as a base point, the route using the most stacks for that functionis displayed.

Note:


260

22.4 Max Used Stack Route (All Functions)

22.4 Max Used Stack Route (All Functions)

Displays the route of the function using the most stacks in the program within the graph flow window.

� Display of Max Used Stack Route for All Functions

Figure 22.4-1 Display of Max Used Stack Route (All Functions)

Proceed as follows to show the max used stack route for all functions:


2. Max used stack can be shown for all displayed functions by clicking the "Max Stack"command from the "Display" menu.

3. The route for the function using the most stacks in the program can be shown by clicking the"Max Used Stack Route" command from the "Display" menu.

Note:


261


22.5 Max Used Stack Route Focus

Focuses on the max used stack route displayed in the graph flow window.

� Display of Max Used Stack Route Focus

Figure 22.5-1 Max Used Stack Route Focus

Proceed as follows to focus on the max used stack route:

1. When the max used stack is not shown, show the max used stack for all functions displayedby clicking the "Max Used Stack" command from the "Display" menu.

2. Display the max used stack route using the "Max Used Stack Route" from the "Display"menu, or the "Max Used Stack Route" from the "Graph Flow" menu.

3. Display the "Graph Flow" pop-up menu and click the "Focus [Max Used Stack Route]"command.

4. This will focus on the max used stack route.

Note:

To calculate the max used stack, individual C source files must be created for used stackinformation files using the C Analyzer compile feature. Furthermore, unless the max usedstack route is displayed in advance, clicking the "Focus [Max Used Stack Route]" commandwill not display anything in the graph flow window. Clicking the "Focus [Max Used StackRoute]" command again will return the window to its previous state.

262

CHAPTER 23 USED STACK INFORMATION

This chapter explains used stack information and max used stack.

23.1 "Calculating Max Used Stack"

23.2 "Limitations on the Max Used Stack"

23.3 "Creating a Stack Information File"

263


23.1 Calculating Max Used Stack

Calculation of the max used stack is explained as follows.

� Calculating Max Used Stack

To calculate the max used stack using C Analyzer, individual C source programs must be

created for used stack information files in advance using the C compiler (FR family and F2MCfamily C compiler).

� How to Calculate the Max Used Stack

The max used stack for the function func is calculated as follows:

1. The stack size secured by function func is n bytes.

2. The function func calls the functions sub0, sub1, ...., subn.

3. The max used stacks used by the functions called by the function func is s1, s2, ..., sn bytes.

4. Of the max used stacks of the functions called by function func, the largest is called smbytes.

5. The max used stack of the function func is n+sm bytes.

When the function func does not call functions, the max used stack for the function func equalsthe stack size secured by the function func.

264

23.2 Limitations on the Max Used Stack

23.2 Limitations on the Max Used Stack

This section explains the limitations on the max used stack.

� Limitations on the Max Used Stack

The following items exist as limitations on calculating the max used stack.

❍ When the asm statement exists within the C source program.

As the C compiler cannot obtain information for functions or secured stacks when an asmstatement is defined within the C source program, it cannot make an accurate calculation of themax used stack.

❍ Where recursive functions exist

When calculating the max used stack, the max used stack for called functions must be known.As a result, if there is a recursive function, the processing is never completed. The calculationfeature for the max used stack, therefore, considers the max used stack for recursively calledfunctions as being the stack size secured by that function and does not consider the max usedstack of functions called by that function. As a result, it cannot accurately calculate the maxused stack.

❍ Where a function is called by a pointer

When calculating the max used stack, the max used stack for called functions must be known.However, when calling the function from a pointer, it is not possible to ascertain the essence ofthe function, making it impossible to calculate the max used stack of called functions. Thecalculation feature for the max used stack, therefore, calculates the max used stack of functionscalled by a pointer to be 0 bytes. As a result, it cannot accurately calculate the max used stack.

❍ When there is a call to a REALOS system call function

As the C compiler cannot obtain information for calls to REALOS system call functions withinthe C, it cannot make an accurate calculation of the max used stack.

❍ When calling a function for whom function definition information does not exist

When calculating the max used stack of called functions, function definition information for thosecalled functions must be known. When definition information does not exist for those calledfunctions, the max used stack calculation tool calculates the max used stack of those calledfunctions as 0 bytes. As a result, it cannot accurately calculate the max used stack.

❍ When standard library functions are used

The qsort function carries out recursive function calls. Therefore, the same limitations exist for"Where recursive functions exist."

Furthermore, the bsort, exit and qsort functions all make function calls using pointers.Therefore, the same limitations exist for "Where a function is called by a pointer."

Of the above limitation items, excepting "Where there is a call to a REALOS system callfunction", the max used stack calculation feature will output a relevant warning message withinthe C Analyzer analysis window when the above limitations occur.

265


23.3 Creating a Stack Information File

This section explains how to create a stack information file. Methods of creating used stack information include using the C compiler used stack information display feature and using an editor.

� Method of Creating Using the C Compiler

The used stack information file is created using the C compiler and the C compiler used stackinformation display feature.

The used stack information file can be created using the C compiler used stack informationdisplay feature with the C source program.

The used stack information file created using the C compiler used stack information displayfeature can be used without modification as a used stack information file.

For details on the C compiler used stack information display feature, refer to the C compilermanual.

� Method of Creating Using the Editor

To create a used stack information file using an editor, create a text file in the format describedbelow.

The numbers of characters per line used for the stack information file must be within 1,024including the line break character.

The used stack information file cannot consist of blank lines (lines consisting only of spaces).

❍ Comment line

The used stack information file can include comments.

If the first character of a line is the character "#", the line is recognized as a comment.

[Example]

❍ Module name description line

Describes the module names (C source programs) defined by the functions that appear in thefunction definition information to follow.

When the first line starts with the "@" character, it is recognized as a module name description.

The module name description line describes the module names defined in the functions in thefunction definition information to follow.

It is not permitted to leave a space or tab between the "@" character and the module name.

When the stack information file is not in the same directory as the module name, use theabsolute path to describe the module name.

#Comment

266


[Example]

In the used stack information file output by the C compiler, a "!" character may be included inthe first line as a module name description line, thereby indicating that the asm statement isincluded within the module. This is used by the max used stack calculation feature asinformation when outputting a warning message. Where a C source program used stackinformation file including an asm statement is edited using an editor, and it reflects informationconcerning the stack size secured by the asm statement or the function defined in the asmstatement, it is possible to prevent the output of unnecessary warning messages by changingthat section to "@".

❍ Function Definition Information Line

Describes the secured stack size, attributes, and name of a function.

When describing the function definition information line, the module descriptions must beincluded at the beginning.

Describes the secured stack size, attributes, and name of functions defined within the modulesincluded within the module name description line.

The function definition information line uses the following format.

• secured stack size attributes Function name asm attributes

The stack size, attributes, and function name must be separated by one or more spaces or tabs.

Secured Stack Size

The secured stack size can be expressed in base 8, base 10, or base 16 formats.

For the secured stack size, the total number of the greatest stack sizes for stack sizesecured at the beginning of that function and the stack size secured when the function wascalled is used.

If the secured stack size starts with "0x", it will be recognized as being in base 16 format.

If the secured stack size starts with "0", it will be recognized as being in base 8 format.

In other cases, it will be recognized as being in base 10 format.

Attributes

Describes attributes of functions.

External functions are indicated by "E", static functions as "S", and interrupt functions by "I".

Furthermore, when the function is called using a pointer, a "*" is added to the symboldescribed above.

Function Name

The name of the function is described as a symbol in assembler source.

[Example]

asm Attributes

asm statements within a function are indicated by "A".

@C:\demo\test.c

@C:\demo\test.c20 E test24 ER func28 S* _sub

267


[Example]

❍ Function Call Information Line

Describes the attributes and the name of functions called by the functions previously describedin the function definition information line.

The function call information line is expressed in the following format:

• Function-call-information-line-reference attributes function-name

The function call information line reference, attributes, and function name must be separated byat least one space or tab.

When describing the function call information line, the function definition information line mustbe placed at the beginning.

Function Call Information Line Reference

"->" is used as a reference mark to indicate the function call information line.

Attributes

Describes the attributes of called functions.

Among the called functions, external functions are indicated by "E", static functions as "S",and calls by pointers with "*".

Function names

The name of the called function is described as a symbol in assembler source.

When the call takes place via a pointer, the function can be named anything but cannot beomitted.

Output from the C Compiler used stack display feature is output as "$pointer_call".

[Example]

❍ Function Calls Using a Pointer

When function calls using a pointer are recognized in advance, the max used stack can becalculated by describing a function call information line for all functions called by the pointerinstead of a function call information line for only the function called by the pointer. By makingthe same amendment to used stack information created using the C compiler, the max usedstack can be calculated.

!C:\demo\asm.c20 E test24 E func A28 S _sub

@C:\demo\test.c20 E test-> E func-> S _sub24 ER func-> E func28 S _sub-> * $pointer_call

268


[Example Sample C source program]

[Example Stack information file (before modification)]

When using the C Analyzer max stack feature, the following type of message is output.

*** W1007N: A function call from a pointer has been detected in function "main"

#include <stdio.h>

void func1(){ fprintf( stdout,"func1\n");}void func2(){ char buffer[255]; sprintf( buffer,"func2\n");}void func3(){ printf( "func3\n" );}

void (*test[3])()={ func1, func2, func3};

void main(){ (*test[2])(); /* call for func3() using a pointer */}

@C:\demo\point.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# ...# 8 E _func1 -> E _fprintf# 264 E _func2 -> E _sprintf# 8 E _func3 -> E _printf# 8 E _main -> * $pointer_call

269


[Example Stack information file (after modification)]

The function call information line "$pointer_call" is replaced by the function func3( ) function callinformation line, and the max used stack can be calculated.

It is necessary, however, to have a stack information file including the function definitioninformation line for function func3( ).

@C:\demo\point.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# ...# 8 E _func1 -> E _fprintf# 264 E _func2 -> E _sprintf# 8 E _func3 -> E _printf# 8 E _main -> E _func3

270

APPENDIX

This appendix explains problems that may occur during the use of Softune C Analyzer.

Appendix A "Troubleshooting"

271

APPENDIX A Troubleshooting


Solves technical problems that may be encountered when using Softune C Analyzer.• Activation problems• Development environment-related• Max stack-related• Standard editor-related• Compatibility with lower versions• Error messages• Frequently asked questions

� Activation Problems

❍ Unable to start Softune C Analyzer

Unable to start and the message "CANALYZE.EXE file is linked to the missing exportOLEAUT32.DLL."

[Answer]

The cause of this problem is the use of an older version of Windows 95 that uses a library notcompatible with the ACTIVE X feature. Execute the attached upgrade command oleaut.exe.

❍ Period of use

The message "[0] day of trial remaining" appears.

[Answer]

The version of Softune C Analyzer being used is an evaluation version.

This version can be used for 45 days after installment. To continue use, the full version must bepurchased.

272


� Development Environment-related

❍ "Compiler environment [C:\~] does not exist"

When trying to close the compiler environment dialog box displayed by the "CompilerEnvironment" command from the "Setup" menu, the dialog box "Compiler environment [C:\~]does not exist" is displayed.

[Answer]

The above message is displayed in an environment in which the Softune compiler is notinstalled.

Close this dialog box using the "Close" button.

❍ Can I use SAMBA?

Is it possible to analyze a UNIX source program on Windows using a SAMBA Server?

[Answer]

It is possible, but the following points must be noted.

• Standard file name

• As the upper case/lower case distinction for directory names and file names on the UNIXServer no longer exists, it is necessary to modify as appropriate.

� Max Stack-related

❍ Max stack is not displayed

When using the max stack feature, the max used stack is not displayed, even though an errormessage is not displayed.

[Answer]

The correct path name may not be set in the used stack information file header.

Resolve this problem by recreating the stack information file using the C Analyzer compilefeature or by editing as follows:

• Choose the "Open File" command from the pop-up menu in the function box for which themax stack is not displayed and confirm the name of the source program.

• Open the "STACK" pane from the "Project" window and double-click the applicable stackinformation file name.

• Edit the first line of the stack information file to the correct path name. (The path name mayalso be omitted).

[Example]

@C:\test\test.c20 E test-> E func

273


[Example]

❍ "Not Correct Max Stack Size"

When using the max stack feature, the message "Not Correct Max Stack Size" appears.

[Answer 1]

The display mode of Graph Flow is not set to "All Functions."

In the case of programs that include standard library functions, it is necessary to check "AllFunctions" within the Graph Flow pop-up menu.

[Answer 2]

One of the max stack feature limitations may apply.

If one of the following elements exist, the max used stack may not be correctly calculated.

• There is an ASM statement in the C source.

• There is a call to a recursive function.

• There is a function call from a pointer or there is a virtual function.

• There is a REALOS system call function call.

• There is a function call for which function definition information does not exist.

In these cases, a relevant message will appear within the C Analyzer.

For appropriate responses to these messages, see "Error messages output when using the maxstack feature", which follows.

� Standard Editor-related

❍ Cannot write to the edit window

When an edit window is activated from the standard editor, a blank edit screen is displayed.

[Answer]

The standard editor may not be registered in the system. Within explorer, drag the library fileSiiEd2.ocx included in the install directory and drop it over regsvr.exe.

If the message [DllRegisterServer in SiiEd2.ocx succeeded] is displayed, the window can beactivated normally.

❍ Member not found

Starting of an internal editor displays "Member not found".

[Answer]

The version of the editor of use may be old. Library file included to an installation directory byExplorer. And check that the version of SiiEd2.ocx is more than 2.3.2.6, drag & drop onregsvr32.exe.

If "DllRegisterServer in SiiEd2.ocx succeeded" is displayed, it is possible to start normally.

SiiEd2.ocx is the editor made by Fujitsu,Ltd. compatible with a higher rank. Please use the oneas new as possible.

@test.c20 E test-> E func

274


� Error Messages Output when Using the Max Stack Feature

The following messages may be output when using the C Analyzer Max Stack Feature.

As the name of the stack information file is displayed in the analysis window, the used stackinformation file can be edited directly by double-clicking the name of the file.

[Countermeasures]

The stack information file "C:\test.stk" may not exist.

Create the "C:\test.stk" file using the C Analyzer compile feature.

[Countermeasures]

This message is not output in C Analyzer.

[Countermeasures]


[Countermeasures]


[Countermeasures]

This message is output if an asm statement exists within the source program.

To prevent this warning from appearing, open the stack information file test.stk, which is theapplicable file for test.c, in an editor and add amend the first line from !C:\test.c to @c:\text.c

[Before amending]

[After amending]

W1001N cannot open file ‘C:\test.stk’

W1002N unrecognized option ‘-s’

W1003N option ‘-model’ requires an argument

W1004N illegal sub-parameter ‘-cpu a’

W1005N module ‘C:\test.c’ has asm statement

!C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}

@C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}

275


See CHAPTER 23 "USED STACK INFORMATION" for information on how to edit the stack

information file.

[Countermeasures]

This message is output if there is a direct or indirect call to a recursive function.

To prevent this warning from appearing, open the stack information file with an editor and setthe stack size in the recursive call line to an estimated amount.

[Before amending]

[After amending]

C Analyzer sets the stack size for all recursive call functions for which a warning appears to 0.

If an estimated stack size is used for the stack size required for the recursive call functions, as

in the example above, the warning can be prevented and the stack size level can be raised.

[Countermeasures]

This message is output when there is a function call from a pointer.

To prevent this warning, open the stack information file in an editor and set the $pointer_callline to an appropriate function call information line.

W1006N found recursive call ‘_func’

W1007N found call by pointer in ‘_main’

@C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# 24 E _func -> E __addd -> E _sub <- Recursive call function# 12 E _sub -> E _func# 8 E _main -> E _sub

@C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# 24 E _func -> E __addd 32 E _sub <- Clearly specified# 12 E _sub -> E _func# 8 E _main -> E _sub

276


[Before amending]

[After amending]

C Analyzer sets the stack size for all functions called by a pointer for which a warning appearsto 0. Calls by C language virtual functions are treated as pointer calls.

If the function call line is specified as in the above example, the warning can be prevented and

the stack size level can be raised.

[Countermeasures]

This message is output when the function "func" used stack information cannot be found inthe specified stack information file.

To prevent this warning, register the source program defined in the function "func" in the

project.

[Countermeasures]


[Countermeasures]


W1008N not found used stack size information of function ‘_func’

W1009N Not found static function

W1010N Not found static function

@C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# 8 E _func1# 8 E _func2# 8 E _main -> * $pointer_call <- Function call by a pointer

@C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# 8 E _func1# 8 E _func2# 8 E _main -> * _func2

277


[Countermeasures]


[Countermeasures]

This message is output when the contents of the stack information file "C:\test.stk" areabnormal.

Re-create the "C:\test.stk" file using the C Analyzer compile feature.

When editing the stack information file with an editor, use a tab to separate each line.

[Countermeasures]

This message is output when an asm statement is included within the source programfunctions. The message "There is an asm statement in the W1005N module "C:\test.c" isdisplayed. This message will not be output, however, if there are no functions includedwithin the asm statement.

To prevent the warning, open the stack information file using an editor, delete the asmattribute in the "func" function definition information line, and set the stack size for the asmstatement.

[Before amending]

[After amending]

[Countermeasures]

This message is not output in the C Analyzer.

W1011N Not found external function

W1012N Abnormal file ‘C:\test.stk’

W1013N Found asm statement in ‘_func’

E4001N Not read used stack size infomation

!C:\test.c# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# 24 E _test 20 E _func A <- Function including asm statement

@C:\test.c <- Amend ! to @# E=Extern S=Static I=Interrupt# {Stack} {E|S|I} {function name} [A]# -> {E|S} {call function}# 24 E _test 32 E _func <- Delete "A" and amend size.

278


[Countermeasures]


When output as a pop-up menu, the stack information file may not be registered in the

project. If not, register the file.

[Countermeasures]


� Frequently Asked Questions

❍ Duplicate trees are displayed in the Graph Flow

[Cause]

If duplicate program units, such as two main function definitions, exist in a source file registeredas a project, two function boxes expressing these main functions will appear.

In the same way, a function without a called creates a tree using this as its head.

[Countermeasures]

Opening the pop-up menu from the function box and using the focus feature will make it easierto see.

Furthermore, deleting from the project source files containing unnecessary function definitionswill result in the definitions being deleted simultaneously from the analysis information file.

❍ The message "The size of a graph flow is too large to display the entire graph flow." is displayed

[Cause]

When the size of a source file registered as a project is too large, the above message isdisplayed. This message is displayed when the number of function trees and the number offunction boxes that can be displayed on the graph flow window exceed the limits specified byWindows.

However, only display of the graph flow is restricted; all internal data is still kept.

[Countermeasures]

Open the Function List window on the View menu and right-click an appropriate function. Thefunction tree of a selected function is then displayed on the graph flow window in a specifiedformat.

If the Top level function on the View menu is selected, only functions that cannot be called byothers are displayed.

E4002N Not found used stack size information of function ‘_func’

F9001N Insufficient memory

279


280

INDEX

INDEX

The index follows on the next page.This is listed in alphabetic order.

281

INDEX

Index

Symbols

- fcc896s compiler dialog box, option on..............155- fcc907s compiler dialog box, option on..............142- fcc911s compiler dialog box, option for......144, 157_direct candidate....................................................21_direct check window ...........................................167_direct-type qualification declaration candidate,

specifying ...................................................179

A

activate standard editor ........................................246activation problem ................................................272add file in project ..............................................13, 75all function, display of max used stack for............259all function, display of max used stack route for...261analysis information (graph flow)............................16analysis information (tree biew)..............................16analysis information, display of (graph flow window)

.....................................................................52analysis message window..........................5, 51, 107analysis option .......................................................14Analysis Option command .....................................50analysis option dialog box ......................................79analysis result data file, deleting ............................53analysis result data file, updating ...........................53analysis window .......................................................6analyze.........................................................9, 14, 51analyze menu...................................................44, 78ANSI C compiler option setting dialog box...........158argument (all) .........................................................20argument information .............................................26argument information function................................31argument information, pop-up menu of ................215argument window .................................................163arrange icon ...........................................................23

B

bar on window ........................................................44bitmap file, outputting ...........................................218

C

C analyzer ..............................................................24C analyzer, effect of .................................................2C analyzer, starting ................................................41

C compiler, method of creating using .................. 266C global variable .................................................... 21C global variable information, displaying ............. 171call MUSC (max used stack calculator) ................. 81call tree .................................................................. 26call tree function..................................................... 29call tree pop-up menu .......................................... 222call tree window ................................................... 111call tree, displaying .............................................. 220cascade.................................................................. 23check...................................................................... 10check menu.......................................................... 162chip classification................................................... 81close all .................................................................. 23close project........................................................... 11compilation environment ........................................ 22compilation-target file............................................. 18compile..................................................................... 9compile menu................................................. 44, 120compile option dialog box for fcc911s.................. 121compiler, environment of...................................... 187complexity, measuring ......................................... 237complexity, using ................................................. 237confirmation dialog box.................................... 62, 73const candidate...................................................... 21const-type qualification declaration candidate,

specifying................................................... 178copy ....................................................................... 15cross reference pop-up menu.............................. 243cross reference, displaying .................................. 240cut .......................................................................... 15

D

declaration with _direct .......................................... 20declaration with _direct, maximum of total size of

..................................................................... 87default view............................................................ 52delete file from project............................................ 13development environment-related ....................... 273dialog box................................................................. 8displaying C global variable information .............. 171displaying focus ................................................... 211displaying graph flow ........................................... 204displaying real argument information................... 215

282

INDEX

displaying undefined function............................... 217dummy argument information, displaying ............ 214duplicated function ................................................. 20duplicated function, displaying ............................. 166

E

edit ........................................................................... 9edit menu ................................................. 44, 94, 254edit window .............................................................. 7editor customize..................................................... 22editor, method of creating using........................... 266enlarging graph flow............................................. 208error message output when using max stack feature

................................................................... 275existing analysis result displaying .......................... 53explorer, starting from ............................................ 40external editor setup ............................................ 247external editor, setting.......................................... 185

F

optimization.......................................................... 155outputs ................................................................. 157fcc896s compiler option setting dialog box .......... 146optimization.......................................................... 142output ................................................................... 144fcc907s compiler option setting dialog box .......... 133fcc911s compiler dialog box......................... 130, 132fcc911s compiler dialog box, macro definition screen

of preprocessor.......................................... 126fcc911s compiler dialog box, specification of

language .................................................... 128fcc911s optimization, option on............................ 130fcc911s output, option for..................................... 132file ............................................................................ 9file menu .................................................. 44, 70, 254file name information............................................ 242find ................................................................... 15, 17find in files .............................................................. 15find next ................................................................. 17find operation on edit window .............................. 117find prev ................................................................. 17focus, display of max used stack route ................ 262focus, displaying .................................................. 211focus, selecting .................................................... 210folder reference dialog box .................................... 59frequently asked question .................................... 279function information.............................................. 241function list ....................................................... 16, 26

function list function ................................................30function list window...............................................113function name list..................................................226function name list, pop-up menu of ......................227

G

general mode....................................................79, 81global ......................................................................10global information, pop-up menu of ......................174global information, selecting .................................170global window .......................................................173graph flow .........................................................16, 26graph flow function .................................................28graph flow pop-up menu.......................................206graph flow window ..........................................52, 109graph flow window, linking with ............................221graph flow, displaying ...........................................204graph flow, enlarging ............................................208graph flow, reducing .............................................209

H

help.........................................................................10help menu.......................................................45, 196help topic ................................................................24

I

icon, starting with....................................................40initial window ..........................................................42inline .......................................................................20inline expansion candidate function, displaying....164internal editor function ............................................36interrupt ............................................................14, 51interrupt compilation ...............................................18

L

language - fcc896s compiler dialog box, specification of ................................................................153



language level ........................................................83locate operation on analysis window....................116logic flow.................................................................26logic flow function ...................................................32logic flow pop-up menu.........................................232logic flow, displaying.............................................230logic flow, selecting...............................................230

283

INDEX

M

macro definition screen of preprocessor - fcc911s compiler dialog box ....................................126

macro information ................................................241main window ............................................................3max stack-related.................................................273max used stack ................................................16, 26Max Used Stack command ..................................115max used stack route .............................................17Max Used Stack Route command........................115max used stack, calculating .................................264max used stack, limitation on ...............................265max used stack, using calculate ..........................264maximum used stack route, display of ...................35maximum used stack, calculation of.......................35memory model (Only fcc907s) ...............................82menu and bar on window .......................................44message bar ..........................................................16MS-DOS prompt, starting from...............................40mutual reference information .................................26mutual reference information function....................34

N

new file ...................................................................13new file creating .....................................................71new project.............................................................11new project creating ...............................................58

O

open file..................................................................13open project ...........................................................11opening file.............................................................72opening project.......................................................60option .....................................................................18other option ............................................................84

P

paste ......................................................................15path dialog box.................................................46, 58pop-up menu of global information.......................174pop-up menu on call tree window ........................111preprocessor - fcc896s compiler dialog box, include

path screen of ............................................149preprocessor - fcc896s compiler dialog box, macro

definition screen of .....................................151preprocessor - fcc907s compiler dialog box, include

path screen of ............................................136preprocessor - fcc907s compiler dialog box, macro

definition screen of .....................................138

preprocessor setting dialog box, include path screen of.................................................................. 88

preprocessor setting dialog box, macro definition screen of ...................................................... 89

preprocessor, include path screen of (fcc911s compiler dialog box)................................... 124

Print........................................................................ 25print .................................................................. 10, 11print information, printing ..................................... 200print preview..................................................... 11, 66print preview window............................................ 201print setup .............................................................. 12printer setup................................................... 67, 200printing ................................................................... 65program editing...................................................... 27project ................................................................ 9, 16project file............................................................... 11project file, specifying type of................................. 47project menu .................................................... 44, 56project name & path dialog box ....................... 46, 58project window ......................................... 4, 104, 173

Q

quit C analyzer ....................................................... 12

R

re-analyze ........................................................ 14, 51recognize line starting with // as comment in C source

check box..................................................... 91reducing graph flow.............................................. 209reference view...................................................... 176register const variable to RAM field ....................... 82remove from project ............................................... 76replace ................................................................... 15

S

Save As command................................................. 73Save command...................................................... 73save file.................................................................. 13save file as ............................................................. 13save project............................................................ 11save project as....................................................... 11Save Project As command..................................... 62Save Project command.......................................... 62saving analysis result data file ............................... 53select all ................................................................. 15select file dialog box............................. 46, 60, 72, 75selecting argument information............................ 214selecting editor....................................................... 36

284

INDEX

selecting file ........................................................... 47selecting focus ..................................................... 210selecting global information ................................. 170setting external editor........................................... 185setup ...................................................................... 10setup menu .................................................... 45, 184SOURCE tab.......................................................... 48specified function, display of max used stack for . 258specified function, display of max used stack route for

260specifying const-type qualification declaration

candidate ................................................... 178STACK tab ............................................................. 48standard editor pop-up menu............................... 252standard editor setup (general) ............................ 248standard editor setup (key word) ......................... 250standard editor-related......................................... 274start compilation..................................................... 18start menu, starting from ........................................ 40statement in inline function, maximum number of.. 86status bar ....................................................... 16, 103summary information ............................................. 26summary information function................................ 33summary pop-up menu ........................................ 236summary, displaying ............................................ 234

T

tag/type definition information .............................. 241

target MCU .............................................................81text, searching for .................................................181tile horizontally........................................................23tile vertically ............................................................23tool bar............................................................16, 102total size view .......................................................177tree biew .................................................................16type definition information.....................................241

U

undefined function, displaying ..............................217undo........................................................................15update dependence................................................11Update Dependency command ..............................64

V

variable/function information.................................241view ..........................................................................9view menu ......................................................44, 100

W

warning level...........................................................83window....................................................................10window for analysis ................................................43window menu..................................................45, 190window name 1, 2...................................................23

285

INDEX

286

CM81-00303-5E

FUJITSU SEMICONDUCTOR • CONTROLLER MANUAL

FR/F2MC FAMILY

SOFTUNE C ANALYZER MANUAL

for V3

September 2002 the fifth edition

Published FUJITSU LIMITED Electronic Devices

Edited Technical Information Dept.