CubeSuite+ Partner OS Aware Debugging Plug
Contents
1. 1 to the minimum ID e g MIN TSKID the minimum priority MIN PRI the debug ger support function USE DBGSPT and the object name USE OBJECT NAME in the configura tion files config h and config inc The debugging function might not operate normally if the contents of the configuration file os cfg h and cpu cfg h are changed from the initial values The task IDs displayed in this plug in are internal IDs for debugging and are different from the task IDs of uC OS The maximum task ID number displayable in the resource information pane is 255 Task names are not displayed while the XR library is in use The task IDs displayed in this plug in are internal IDs for debugging and are different from the task IDs of embOS The maximum task ID number displayable in the resource information pane is 255 R20UT0946EJ0100 Rev 1 00 TENESAS Page 18 of 22 Oct 01 2012 Revision History Before Modification After Modification Oct 01 2012 NE First Edition issued CubeSuite Partner OS Aware Debugging Plug in User s Manual Publication Date Rev 1 00 Oct 01 2012 Published by Renesas Electronics Corporation LENESAS SALES OFFICES Renesas Electronics Corporation http www renesas com Refer to http www renesas com for the latest and detailed information Renesas Electronics America Inc 2880 Scott Boulevard Santa Clara CA 95050 2554 U S A Tel 1 408 588 6000 Fax 1 42. Resource Information pane R20UT0946EJ0100 Rev 1 00 TENESAS Page 16 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIXB Messages APPENDIX B Messages In this appendix the messages output by the Partner OS Aware Debugging Plug in are explained The messages are output to the output pane or in message boxes B 1 Fatal Error Table B 1 Fatal Errors E1160020 Message Failure to open a file Explanation The plug in was unable to open a file How to cope with Confirm whether the file is or is not accessible E1160021 Message Failure to read a file Explanation The plug in was unable to read a file How to cope with Confirm whether the file is or is not readable E1160022 Message Failure in writing to a file Explanation The plug in was unable to write to a file How to cope with Confirm whether the file is or is not writable E1160023 B 2 Warning Message Failure to close a file Explanation The plug in was unable to close a file How to cope with Confirm whether the file is or is not accessible Table B 2 Warning Name Description W1160020 Message The maximum number of resources one thousand which can be registered on a tabbed page of the resource information pane was exceeded Explanation The upper limit on the number of resources which can be registered was exceeded The number of r
3. This manual is intended for users who are using RL78 Family and RX Family in the design and development of application systems This manual is intended to bring users to understand the functions of the CubeSuite Partner OS Aware Debugging Plug in and its organization is as listed below This manual consists of the following major sections CHAPTER 1 GENERAL CHAPTER 2 FUNCTIONS APPENDIXA WINDOW REFERENCE APPENDIXB Messages APPENDIXC Notes It is assumed that the readers of this manual have general knowledge in the fields of electrical engineering logic circuits microcontrollers the C language and assembly languages To understand the hardware functions of the RL78 Family or RX Family Refer to the User s Manual for the given product Data significance The higher order digits are to the left and the lower order digits are to the right Note Footnotes for items marked with Note in the text Caution Information requiring particular attention Remark Supplementary information Numeric representation Decimal XXXX Hexadecimal OxXXXX Prefixes indicating powers of 2 for address spaces and memory capacities kilo 219 1024 M mega 229 1024 All trademarks or registered trademarks in this document are the property of their respective owners uC OS IIl is a trademark of Micrium Inc embOS is a trademark of SEGGER Microcontroller Systems UCT uT Kernel DevKit tuned is a trademark of Ubiquitous Computing Techno
4. a program Download the program for debugging 5 Selecting the real time OS When a program is downloaded the Select OS Dialog Box is automatically displayed At this time select the real time OS you are using Figure 2 1 Select OS Dialog Box Don t load the information of the OS data when downloading This check is possible only when the OS is not re configured Never show this dialog box at download Cancel 6 Executing stopping a program Run the program and then stop it at the location for which you wish to display resource information from the Cube Suite Partner OS Aware Debugging Plug in 7 Confirm the Resource Information from the Partner OS Aware Debugging Plug in Select View menu gt Realtime OS gt Resource Information to open the Resource Information pane R20UT0946EJ0100 Rev 1 00 TENESAS Page 8 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in CHAPTER 2 FUNCTIONS Task Tama rai am ata ra Evtl let Eee rd E l dej Figure 2 2 Resource Information Pane E a f 1 kask b 1 1 d H La sk_b 1 T 1 ina Famlisa aca d I Funt imaa d nTen T rur Count Fal dern Dann nnne LILIOJ na LLH Ian dm dm dm du um j dm du Remark For details on working with CubeSuite refer to the user s
5. 08 588 6130 Renesas Electronics Canada Limited 1101 Nicholson Road Newmarket Ontario L3Y 9C3 Canada Tel 1 905 898 5441 Fax 1 905 898 3220 Renesas Electronics Europe Limited Dukes Meadow Millboard Road Bourne End Buckinghamshire SL8 5FH U K Tel 44 1628 651 700 Fax 44 1628 651 804 Renesas Electronics Europe GmbH Arcadiastrasse 10 40472 Dusseldorf Germany Tel 49 211 65030 Fax 49 211 6503 1327 Renesas Electronics China Co Ltd 7th Floor Quantum Plaza No 27 ZhiChunLu Haidian District Beijing 100083 P R China Tel 86 10 8235 1155 Fax 86 10 8235 7679 Renesas Electronics Shanghai Co Ltd Unit 204 205 AZIA Center No 1233 Lujiazui Ring Rd Pudong District Shanghai 200120 China Tel 86 21 5877 1818 Fax 86 21 6887 7858 7898 Renesas Electronics Hong Kong Limited Unit 1601 1613 16 F Tower 2 Grand Century Place 193 Prince Edward Road West Mongkok Kowloon Hong Kong Tel 852 2886 9318 Fax 852 2886 9022 9044 Renesas Electronics Taiwan Co Lid 13F No 363 Fu Shing North Road Taipei Taiwan Tel 886 2 8175 9600 Fax 886 2 8175 9670 Renesas Electronics Singapore Pte Ltd 80 Bendemeer Road Unit 06 02 Hyflux Innovation Centre Singapore 339949 Tel 65 6213 0200 Fax 65 6213 0300 Renesas Electronics Malaysia Sdn Bhd Unit 906 Block B Menara Amcorp Amcorp Trade Centre No 18 JIn Persiaran Barat 46050 Petaling Jaya Selangor Darul Ehsan Malaysia Tel 60 3 7955 9390 F
6. 424 NESAS C e D m o lt RV D CubeSuite Partner OS Aware Debugging Plug in User s Manual Target Device RL78 Family RX Family All information contained in these matenals including products and product specifications represents information on the product at the time of publication and is subject to change by Renesas Electronics Corp without notice Please review the latest information published by Renesas Electronics Corp through various means including the Renesas Electronics Corp website http www renesas com Renesas Electronics www renesas com Rev 1 00 Oct 2012 10 11 12 Notice Descriptions of circuits software and other related information in this document are provided only to illustrate the operation of semiconductor products and application examples You are fully responsible for the incorporation of these circuits software and information in the design of your equipment Renesas Electronics assumes no responsibility for any losses incurred by you or third parties arising from the use of these circuits software or information Renesas Electronics has used reasonable care in preparing the information included in this document but Renesas Electronics does not warrant that such information is error free Renesas Electronics assumes no liability whatsoever for any damages incurred by you resulting from errors in or omissions from the information included herein Re
7. ax 60 3 7955 9510 Renesas Electronics Korea Co Ltd 11F Samik Lavied or Bldg 720 2 Yeoksam Dong Kangnam Ku Seoul 135 080 Korea Tel 82 2 558 3737 Fax 82 2 558 5141 2012 Renesas Electronics Corporation All rights reserved Colophon 1 3 CubeSuite Partner OS Aware Debugging Plug in 2 N S AS Renesas Electronics Corporation R20UT0946EJ0100
8. cally over time during program execution Figure 1 1 CubeSuite Partner OS Aware Debugging Plug in UCTuT Kernel DevKit tuned Resource Information task b 1 ID 3 E gt lt Notation N Resource Type Value Address Task Status READY 00003603 Task 2 task a 1 Status NON EXISTENT 00003687 Task 4 task a 2 Status WAITING 000037 8F Task 3task bl Status RUNNING 000037 0B Task Task Task 1 2 task a 1 3 task bl RunTime ms RunTime ms RunTime ms RunTime ms 0 0 420 730 000036 4C 000036 00 00003754 00003708 Task 4 task_a_2 Semaphore 1 Count 00003280 Semaphore 2 Count 0 000032 44 EventFlag 1 Pattern 00000000 000023 CC EventFlag 2 Pattern 12345678 000023EC 4 Resource2 Resource3 Resource4 Resources Resource6 Ta a fa a a fa a fa 1 2 Features The features of the CubeSuite Partner OS Aware Debugging Plug in are listed below Information from the CubeSuite Partner OS Aware Debugging Plug in can be used to confirm information on resources The Resource Information pane of the Partner OS Aware Debugging Plug in displays the current states of resource information for programs running within the debugging tool R20UT0946EJ0100 Rev 1 00 TENESAS Oct 01 2012 Page 6 of 22 Partner OS Aware Debugging Plug in CHAPTER1 GENERAL 1 3 Operation Environment The features of the CubeSuite Partner OS Aware Debugging Plug in are listed below For the latest info
9. e View menu select Realtime OS gt Resource Information Displayed items Name of Header Description Resource Resource type e g Task Semaphore ID Resource ID Name Symbolic name of the address where a task or handler starts or the name of a resource Type Type of resource information such as status and the number of resources Value Value of resource information Address Address where the value is stored Size Size of the value R20UT0946EJ0100 Rev 1 00 TENESAS Page 11 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIXA WINDOW REFERENCE File Menu When the File menu of CubeSuite is selected while the resource information pane is active the following items are displayed for the Resource Information pane Name of Menu Description Save Resource Data Save the data in the text file txt in which the context of the pane was previously saved Note that when this item is selected for the first time after booting up the operation is the same as when selecting Save Resource Data As This item is invalid while the program is running Save Resource Data As Selecting this item opens Save as dialog box for saving the context of the pane in a specified text file txt This item is invalid while the program is running Edit Menu When the Edit menu of CubeSuite is selected while the resource information pane is active the following item
10. esources which can be registered on a tabbed page is up to one thousand How to cope with Delete unnecessary resources or register some of the resources on other tabbed pages so that the number on the given page is no greater than one thousand W1160021 Message There is not available resource that can be registered Explanation The specified resource does not exist How to cope with Specify valid resources W1160022 Message The specified ID number is invalid Explanation The specified ID number does not exist How to cope with Specify valid ID numbers R20UT0946EJ0100 Rev 1 00 Oct 01 2012 TENESAS Page 17 of 22 Partner OS Aware Debugging Plug in APPENDIXC Notes APPENDIX C Notes This appendix contains cautionary notes C 1 Cautionary Notes Table C 1 Cautionary Notes Name Description General If the Partner OS Aware Debugging Plug in is to be used downloaded programs must have been assembled or compiled with the output of debugging information The debugging function might not operate normally if the build options for the compiler or assembler in the tool chain are changed from those provided for use with the OS Refer to the pane after initializing the real time OS The pane might not be displayed normally while a program is running Smalight OS The task ID 255 means idling of the OS kernel uT Kernel Be sure to set
11. g Notation The following cascaded menu is displayed for specification of the display s notation This item is invalid when nothing is selected This item is invalid while a program is running Automatic Automatically set the notation of the selected item Hexadecimal Display the selected item in hexadecimal Decimal Display the selected item in decimal Jump to source Selecting this item opens an editor pane in which the source code of the task or handler is dis played This item is invalid when nothing is selected and when two or more items are selected This item is invalid while a program is running Select OS Selecting this item opens the Select OS Dialog Box This item is invalid while a program is running R20UT0946EJ0100 Rev 1 00 TENESAS Page 13 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIXA WINDOW REFERENCE Select Resource Dialog Box This dialog box is for select the resource information to be displayed in the resource information pane One ID number or all of the ID numbers can be specified The items selectable for a resource vary according to the real time OS Figure A 2 Select Resource Dialog Box Resource Task ID number Select Status Cancel Help Z The following items are explained here Opening the box Selected contents Opening the box Select Add new resource or Edit
12. logy Corporation NORTi is a registered trademark of MiSPO Co Ltd Smalight is a registered trademark of Renesas Northern Japan Semiconductor Inc T Engine Forum holds the copyright on the uT Kernel specifications TABLE OF CONTENTS CHAPTER 1 GENERAL 6 1 1 Overview 6 1 2 Features 6 1 3 Operation Environment 7 CHAPTER 2 FUNCTIONS 8 APPENDIX A WINDOW REFERENCE 10 A 1 Description 10 APPENDIX B Messages 17 B 1 Fatal Error 17 B 2 Warning 17 APPENDIX C Notes 18 C 1 Cautionary Notes 18 Partner OS Aware Debugging Plug in CHAPTER1 GENERAL CHAPTER 1 GENERAL CubeSuite is an integrated development environment for use in tasks such as design coding building and debugging in the development of application systems for microcontrollers manufactured by Renesas Electronics This manual describes the tool which is useful for debugging programs that employ real time OS from a Renesas part ner functionality within this integrated program development process 1 1 Overview The Partner OS Aware Debugging Plug in is an optional product for extending the debugging capabilities of CubeSu ite and is only for use within CubeSuite When debugging a program that has real time OS functionality the resource information tool of Partner OS Aware Debugging Plug in can be used to confirm information on real time OS resources i e system information and task information that change dynami
13. manual or help system for CubeSuite R20UT0946EJ0100 Rev 1 00 Oct 01 2012 TENESAS Page 9 of 22 Partner OS Aware Debugging Plug in APPENDIXA WINDOW REFERENCE APPENDIX A WINDOW REFERENCE A 1 Description The pane for the Partner OS Aware Debugging Plug in is described Table A 1 Pane for the Plug in Resource Information pane This pane displays information on the usage of resources i e system information and task information by the real time OS R20UT0946EJ0100 Rev 1 00 TENESAS Page 10 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIXA WINDOW REFERENCE Resource Information pane This pane displays information on the usage of resources i e system information and task information by the real time OS Add further items for display as required by selecting Add new resource in the context menu Items that can be displayed vary according to the real time OS Figure A 1 Resource Information Pane LK T T banal Dave KC it Tired Heston dn oar bun eni e W RT tedden a 10081687 INUNNIEF ETET ELLLERIS 1 inas uri Fun 0 FunT wea 42 Pai leet TA 10181219 Count Count Ad Fal tenti TLE RE Fal teen Tera aBENTBEL The following items are explained here Opening the pane Displayed items File Menu Edit Menu Context Menu Opening the pane From th
14. nesas Electronics does not assume any liability for infringement of patents copyrights or other intellectual property rights of third parties by or arising from the use of Renesas Electronics products or technical information described in this document No license express implied or otherwise is granted hereby under any patents copyrights or other intellectual property rights of Renesas Electronics or others You should not alter modify copy or otherwise misappropriate any Renesas Electronics product whether in whole or in part Renesas Electronics assumes no responsibility for any losses incurred by you or third parties arising from such alteration modification copy or otherwise misappropriation of Renesas Electronics product Renesas Electronics products are classified according to the following two quality grades Standard and High Quality The recommended applications for each Renesas Electronics product depends on the product s quality grade as indicated below Standard Computers office equipment communications equipment test and measurement equipment audio and visual equipment home electronic appliances machine tools personal electronic equipment and industrial robots etc High Quality Transportation equipment automobiles trains ships etc traffic control systems anti disaster systems anti crime systems and safety equipment etc Renesas Electronics products are neither intended nor authori
15. o radiation resistance design Please be sure to implement safety measures to guard them against the possibility of physical injury and injury or damage caused by fire in the event of the failure of a Renesas Electronics product such as safety design for hardware and software including but not limited to redundancy fire control and malfunction prevention appropriate treatment for aging degradation or any other appropriate measures Because the evaluation of microcomputer software alone is very difficult please evaluate the safety of the final products or systems manufactured by you Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental compatibility of each Renesas Electronics product Please use Renesas Electronics products in compliance with all applicable laws and regulations that regulate the inclusion or use of controlled substances including without limitation the EU RoHS Directive Renesas Electronics assumes no liability for damages or losses occurring as a result of your noncompliance with applicable laws and regulations Renesas Electronics products and technology may not be used for or incorporated into any products or systems whose manufacture use or sale is prohibited under any applicable domestic or foreign laws or regulations You should not use Renesas Electronics products or technology described in this document for any purpose relating to military applications or use by
16. resource in the context menu of the Resource Information pane Selected contents Selected item Description Resource Selecting this item allows selection of the type of resource ID number Selecting this item specifies all of the ID numbers Selecting this item allows specification of an ID number Enter an ID number or click on the Select button to open the Select ID Dialog Box then select an ID number from the list Selecting this item allows selection of a type of resource information R20UT0946EJ0100 Rev 1 00 TENESAS Page 14 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIX A WINDOW REFERENCE Select ID Dialog Box Select a resource ID from the list Figure A 3 Select ID Dialog Box iSelect Resource ID X 0002 task a 1 The following items are explained here Opening the Box Opening the Box Select the Select button in the Select Resource Dialog Box R20UT0946EJ0100 Rev 1 00 TENESAS Page 15 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIX A WINDOW REFERENCE Select OS Dialog Box Select the real time OS that is to be used Figure A 4 Select OS Dialog Box UCT uT Kernel DevKit tuned The following items are explained here Opening the box Opening the box This dialog box is automatically opened when a program is downloaded Select Select OS in the context menu of the
17. rmation on operating environments refer to the page below Real time operating systems Table 1 1 Supported Real Time Operating Systems Real time OS RL78 Family RX Family uC OS III from Micrium Inc http www renesas com qs osp env Version V3 02 embOS from SEGGER Microcontroller Systems Version 3 84 uT Kernel DevKit tuned for RX62N CubeSuite from Ubiquitous Computing Technology Corporation Version 1 01 01 NORTi from MiSPO Co Ltd Version 4 Release 4 4 Smalight OS from Renesas Northern Japan Semicon ductor Inc Integrated Development Environment CubeSuite V1 03 Debugger Simulator on chip debugging emulator E1 E20 Compilers Compilers from Renesas Electronics Corporation PC PC running on Windows 7 R Windows Vista R Windows R XP Other conditions comply with the operating environment of CubeSuite V3 10 R20UT0946EJ0100 Rev 1 00 RENESAS Oct 01 2012 Page 7 of 22 Partner OS Aware Debugging Plug in CHAPTER 2 FUNCTIONS CHAPTER 2 FUNCTIONS This chapter describes the key functions provided by the Partner OS Aware Debugging Plug in along with the operating procedures 1 Start CubeSuite Launch CubeSuite from the Start menu of Windows 2 Opening a project Open the project for debugging 3 Selecting the debugging tool Select the type of debugging tool with which to debug the program 4 Downloading
18. s are displayed in the resource information pane Delete Delete an item selected in the pane This item is invalid if nothing is selected This item is invalid while the program is running R20UT0946EJ0100 Rev 1 00 TENESAS Page 12 of 22 Oct 01 2012 Partner OS Aware Debugging Plug in APPENDIXA WINDOW REFERENCE Context Menu The context menu is displayed by right clicking the mouse on the resource information pane Name of Menu Description Real time display update Selecting this item opens the property pane for setting up updating of the real time display setting This item is invalid while a program is running Update information Selecting this item updates the information Add new resource Selecting this item allows registration of a new resource The Select Resource Dialog Box is displayed An added resource is displayed in the lowest line Note that the number of resources to be registered on a tabbed page is up to 1000 This item is invalid while a program is running Edit resource Selecting this item allows editing of the selected resource The Select Resource Dialog Box is displayed This item is invalid when nothing is selected and when two or more items are selected This item is invalid while a program is running Delete Selecting this item deletes the selected item in the pane This item is invalid when nothing is selected This item is invalid while a program is runnin
19. the military including but not limited to the development of weapons of mass destruction When exporting the Renesas Electronics products or technology described in this document you should comply with the applicable export control laws and regulations and follow the procedures required by such laws and regulations It is the responsibility of the buyer or distributor of Renesas Electronics products who distributes disposes of or otherwise places the product with a third party to notify such third party in advance of the contents and conditions set forth in this document Renesas Electronics assumes no responsibility for any losses incurred by you or third parties as a result of unauthorized use of Renesas Electronics products This document may not be reproduced or duplicated in any form in whole or in part without prior written consent of Renesas Electronics Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this document or Renesas Electronics products or if you have any other inquiries Note 1 Renesas Electronics as used in this document means Renesas Electronics Corporation and also includes its majority owned subsidiaries Note 2 Renesas Electronics product s means any product developed or manufactured by or for Renesas Electronics 2012 4 Readers Purpose Organization How to Read This Manual Conventions How to Use This Manual
20. zed for use in products or systems that may pose a direct threat to human life or bodily injury artificial life support devices or systems surgical implantations etc or may cause serious property damages nuclear reactor control systems military equipment etc You must check the quality grade of each Renesas Electronics product before using it in a particular application You may not use any Renesas Electronics product for any application for Which it is not intended Renesas Electronics shall not be in any way liable for any damages or losses incurred by you or third parties arising from the use of any Renesas Electronics product for which the product is not intended by Renesas Electronics You should use the Renesas Electronics products described in this document within the range specified by Renesas Electronics especially with respect to the maximum rating operating supply voltage range movement power voltage range heat radiation characteristics installation and other product characteristics Renesas Electronics shall have no liability for malfunctions or damages arising out of the use of Renesas Electronics products beyond such specified ranges Although Renesas Electronics endeavors to improve the quality and reliability of its products semiconductor products have specific characteristics such as the occurrence of failure at a certain rate and malfunctions under certain use conditions Further Renesas Electronics products are not subject t
Download Pdf Manuals
Related Search