RI78V4 Real-Time Operating System User`s Manual: Debug
Contents
1. eee OO l a 5 sf es The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area This area displays the system information e g RTOS Name and Version of the RI78V4 This area consists of the following items RTOS Name The RTOS name RI78V4 is shown Version The version of the RI78V4 is shown System Time The system time is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 15 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Interrupt Nest The nesting level of interrupt processes including CPU exception processes is shown Dispatching The system state of the RI78V4 is shown Disable Dispatch disabled state Enable Dispatch enabled state System Stack Area The start address end address and size in bytes of the system stack are shown in the following format Start address End address Size Current System SP If the processing program is operating on the system stack the start address of the system stack is shown If it is running on the task stack then the current SP value is shown Number of Fixed Sized Memory The total number of fixed sized memory pools is shown Pool Number of Variable Sized Memory is shown Pool Number2. T D Cp lt Q C V LENESAS nRI78V4 V2 00 00 Real Time Operating System User s Manual Debug Target Device RL78 Family All information contained in these materials 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 Mar 2015 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 Renesas Electronics does
3. Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Fixed Sized Memory Pool Name ID Queue Status Top Address Block Size Total Blocks Free Blocks Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation The following items are displayed for selection Selected item name ID Top Address Block Size Total Blocks Free Blocks DEC Displays value in signed decimal number HEX Displays value in hexadecimal number 2 Footer row Jump to Memory Top Address Opens the Memory panel and displays the contents of the fixed sized memory pool Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 40 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Cyclic Handler tab This tab displays the cyclic handler information e g Cyclic Handler Name and ID of the RI78V4 Figure A 18 Cyclic Handler Tab Realtime OS Resource Information EJ 2 Fixed Sized Memor 9 Cyclic Handler Interrupt Handler Q Initialize Routine FJ Ready Queue 2 Timer Queue E System o ki Memory Area Ta Task l 8 Semaphore Eventflag wo Data Queue e P Mailbo
4. Buffer Number of Fixed Sized Memory Pool Number of Variable Sized Memory Pool Number of Cyclic Handler Number of Alarm Handler Number of Interrupt Han dler Number of Initialize Routine Number of Extended Service Call Routine Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection System Time Interrupt Nest System Stack Area Current System SP Idle Routine Start Address Number of Priority Number of Task Number of Semaphore Num ber of Eventflag Number of Data Queue Number of Mailbox Number of Mutex Number of Message Buffer Number of Fixed Sized Memory Pool Number of Variable Sized Memory Pool Number of Cyclic Handler Number of Alarm Handler Number of Interrupt Handler Number of Initialize Routine Number of Extended Service Call Routine Displays value in signed decimal number Displays value in hexadecimal number 2 Footer column Jump to Memory Current System Opens the Memory panel and displays the contents of the Current System SP SP Jump to Source Idle Routine Start Opens the Editor panel and displays the source code of the idle routine Address Jump to Disassemble Idle Rou Opens the Disassemble panel and displays the results of disassembling the idle tine Start Address routine Reset Display Item Resets the disp
5. Ifthe task information Current Task SP Task Stack Area in each cell is double clicked then Mem ory panel displays the contents of the task stack and the caret moves to the corresponding loca tion Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 23 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Prior ity Task Start Address Current PC Current Task SP Task Stack Area Initial Pri ority Suspend Count Wakeup Count Activate Count Attribute Extended Information Tex Start Address Tex Status Tex Request Pattern Tex Executing Pattern Tex Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection ID Wait Factor Wait Data Time Left Current Priority Task Start Address Current PC Current Task SP Task Stack Area Initial Priority Suspend Count Wakeup Count Activate Count Extended Information Tex Start Address Tex Request Pattern Tex Executing Pa
6. Ready Queue EE Timer Queue E System Fi Th Task MM Semaphore Eventflag a Data Queue P Mailbox Queue Status Current Count Max Count Initial Count Attribute Waiting Tasks D 2 TA TFIFO Wait Factor SEM ID SEMI FIFO Current Count 8 ID SEM2 TA TFIFO 9810 SENS u Jew e E Z TALTFIFO C sas sw e w lm TATFEO Remarks 1 lf the waiting task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 Ifthe waiting task information Current Task SP in the cell is double clicked then Memory panel displays the contents of the task stack and the caret moves to the corresponding loca tion Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 26 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row Display Selected item name Notation Selected item name 2 Footer row Reset Display Item Displays cascade menus for selecting the header items to display The following items are displayed for selection Semaphore Name ID Queue Status Current Count Max Count Initial Count Attribute Checked The item in question will be displayed Not check
7. are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area a First layer This layer displays the semaphore information e g Semaphore Name and ID of the RI78V4 This layer consists of the following items Semaphore Name An icon indicating the current status of the semaphore and the name of the semaphore are shown in the following format Icon Name Note that if the name of the semaphore is undefined the name will appear as ID There are waiting tasks There are no waiting tasks Po The ID of the semaphore is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 25 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Queue Status The current status of the semaphore is shown Waiting Tasks There are waiting tasks Empty There are no waiting tasks Current Count Max Count Attribute TA_TFIFO FIFO order b Second layer The waiting task information e g Task Name and ID only appears if there are tasks queued in the semaphore s wait queue See the Task tab for details about waiting task information Figure A 6 Semaphore Tab Waiting Task Information Realtime OS Resource Information HE Fixed Sized A Cyclic Handler rd Interrupt Han y Initialize Routt ry
8. are to be allocated kernel const Area where initial information items related to OS kernel const f resources that do not change dynamically are allo cated as system information tables kernel stack Area where the system stack and the task stack are to be allocated kernel data Area where managed objecis for RI78V4 are to be allocated kernel data init Area where information itemes related to RI78V4 ini tialization kernel workn Area where fixed sized memory pools are to be allo cated kernel data trace n Area where the trace data and information necessary kenrel const trace f to get the trace data are to be allocated kernel system trace f Area where the codes for getting the trace data are to be allocated Area of SADR for RI78V4 Top Address The start address of the managed memory area is shown The size of the managed memory area in bytes is shown Remark Ifthe memory area information e g Area Name and Top Address in each cell is double clicked then Memory panel displays the contents of the managed memory area and the caret moves to the corre sponding location Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 19 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row Display Displays cascade menus for selecting the header items to display Selected item
9. content displayed in the Information display area This panel has the following tabs System tab Memory Area tab Task tab Semaphore tab Eventflag tab Data Queue tab R20UT3374EJ0100 Rev 1 00 LENESAS Page 13 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Mailbox tab Fixed Sized Memory Pool tab Cyclic Handler tab Interrupt Handler tab Initialize Routine tab Ready Queue tab Timer Queue tab 2 Information display area This area displays the resource information e g system information and memory area information of the RI78V4 R20UT3374EJ0100 Rev 1 00 LENESAS Page 14 of 55 Mar 25 2015 RI78V4 V2 00 00 V2 00 00 APPENDIX A WINDOW REFERENCE System tab This tab displays the system information e g RTOS Name and Version of the RI78V4 Figure A 2 System Tab Realtime 05 Resource Information Ek Fixed Siz Sd CyclicHa f interrupt c3 Initialize Ready Q EH Timer Qu Te Task ABSemaph A Eventilag e Data Qu F Mailbox 0 0 Enable Unlocked 1016084 1016366 282 1016366 idle_handler 65559 mak in Number of Data Queue Number of Mailbox Number of Mutex Number of Message Butter Number of Fixed 5ized Memory Pool Number of Vanable Sized Memory Pool Number of Cyclic Handler Number of Alarm Handler Number of Interrupt Handler Number of Initialize Routine Number of Extended Service Call Routine
10. 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 the military includin
11. icon indicating the current status of the eventflag and the name of the eventflag are shown in the following format Icon Name Note that if the name of eventflag is undefined the name will appear as ID There are no waiting tasks Se The ID of the eventflag is shown Queue Status The current status of the eventflag is shown Waiting Tasks There are waiting tasks Empty There are no waiting tasks Current Flag Pattern The current bit pattern of the eventflag is shown Initial Flag Pattern The initial bit pattern 0x0000 of the eventflag is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 28 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Attribute The attributes of the eventflag task queuing method maximum number of tasks that can be queued and bit pattern clearing flag are shown in the following format Queuing method Maximum number Clearing flag Task queuing method TA_TFIFO FIFO order Maximum number of tasks that can be queued TA_WSGL Only one task Bit pattern clearing flag TA_CLR Bit pattern cleared if the request conditions are mel Nothing displayed Bit pattern not cleared if the request conditions are met b Second layer The waiting task information e g Task Name and ID only appears if there are tasks queued in the eventflag s wait queue See the Task tab for details about waiting task information Figure A 8 Eventflag Tab Waiting Task Information Realtime 05 Re
12. name The following items are displayed for selection Area Name Top Address Size Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection Displays value in signed decimal number Displays value in hexadecimal number Top Address Size 2 Footer row Jump to Memory Top Address Opens the Memory panel and displays the contents of the managed memory area Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 20 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Task tab This tab displays the task information e g Task Name and ID of the RI78V4 Figure A 4 Task Tab Realtime 05 Resource Informabon LA Fixed Sized Me EA Cyclic Handler d Interrupt Handler E Initialize Routine Fy Ready Queue E System MH ask 48 Semaphore dk Eventflag a Factor The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area This area displays the t
13. 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 authorized for use in product
14. of Cyclic Handler The total number of cyclic handlers is shown Number of Alarm Handler is shown Number of Interrupt Handler The total number of interrupt handlers is shown Number of Initialize Routine The total number of initialize routines 1 is shown Number of Extended Service Call is shown Routine Remarks 1 If the system information System Stack Area Current System SP in the cell is double clicked then Memory panel displays the contents of the system stack and the caret moves to the corre sponding location 2 Ifthe system information Idle Routine Start Address in the cell is double clicked then Editor panel displays the source file of the idle routine and the caret moves to the corresponding location Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 16 of 55 Mar 25 2015 RI78V4 V2 00 00 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header column Display Displays cascade menus for selecting the header items to display Selected tem name The following items are displayed for selection RTOS Name Version System Time Interrupt Nest Dispatching CPU Lock System Stack Area Current System SP Idle Routine Start Address Number of Priority Number of Task Number of Semaphore Number of Eventflag Number of Data Queue Number of Mailbox Number of Mutex Number of Message
15. to display Selected item name The following items are displayed for selection Object Type Number of Objects Checked The item in question will be displayed Not checked The item in question will not be displayed Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection Number of Objects Displays value in signed decimal number Displays value in hexadecimal number 2 Footer row Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 51 of 55 Mar 25 2015 Revision Record Description Rev Mar 25 2015 ME First Edition issued RI78V4 V2 00 00 User s Manual Debug Publication Date Rev 1 00 Mar 25 2015 Published by Renesas Electronics Corporation ENESAS 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 2801 Scott Boulevard Santa Clara CA 95050 2549 U S A Tel 1 408 588 6000 Fax 1 408 588 6130 Renesas Electronics Canada Limited 9251 Yonge Street Suite 8309 Richmond Hill Ontario Canada L4C 9T3 Tel 1 905 237 2004 Renesas Electronics Europe Limited Dukes Meadow Millboard Road Bourne End Buckinghamshire SL8 5FH U K Tel 44 1628 585 100 Fax 44 1628 5
16. 58 5141 2015 Renesas Electronics Corporation All rights reserved Colophon 4 0 RI78V4 V2 00 00 ENESAS Renesas Electronics Corporation R20UT3374EJ0100
17. 85 900 Renesas Electronics Europe GmbH Arcadiastrasse 10 40472 D sseldorf Germany Tel 49 211 6503 0 Fax 49 211 6503 1327 Renesas Electronics China Co Ltd Room 1709 Quantum Plaza No 27 ZhiChunLu Haidian District Beijing 100191 P R China Tel 86 10 8235 1155 Fax 86 10 8235 7679 Renesas Electronics Shanghai Co Ltd Unit 301 Tower A Central Towers 555 Langao Road Putuo District Shanghai P R China 200333 Tel 86 21 2226 0888 Fax 86 21 2226 0999 Renesas Electronics Hong Kong Limited Unit 1601 1611 16 F Tower 2 Grand Century Place 193 Prince Edward Road West Mongkok Kowloon Hong Kong Tel 852 2265 6688 Fax 852 2886 9022 Renesas Electronics Taiwan Co Ltd 13F No 363 Fu Shing North Road Taipei 10543 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 1207 Block B Menara Amcorp Amcorp Trade Centre No 18 Jin Persiaran Barat 46050 Petaling Jaya Selangor Darul Ehsan Malaysia Tel 60 3 7955 9390 Fax 60 3 7955 9510 Renesas Electronics India Pvt Ltd No 777C 100 Feet Road HALII Stage Indiranagar Bangalore India Tel 91 80 67208700 Fax 91 80 67208777 Renesas Electronics Korea Co Ltd 12F 234 Teheran ro Gangnam Gu Seoul 135 080 Korea Tel 82 2 558 3737 Fax 82 2 5
18. Code Start Address Displays value in hexadecimal number Displays value in signed decimal number 2 Footer row Jump to Source Start Address Opens the Editor panel and displays the source code of the interrupt handler Jump to Disassemble Start Opens the Disassemble panel and displays the results of disassembling the inter Address rupt handler Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 44 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Initialize Routine tab This tab displays the initialize routine information e g Start Address and Extended Information of the RI78V4 Figure A 20 Initialize Routine Tab Realtime 05 Resource Information Laj Fixed Sized Me EA Cyclic Handler Interrupt Handler E Initialize Routine 5 Ready Queue EST mer Queue E System Fi Memory rea Te Task 8 Semaphore amp Eventflag wr Data Queue P Mailbox Extended Information Attribute The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area This area displays the initialize routine informa
19. IFO TA_MPRI PO n The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area a First layer This layer displays the mailbox information e g Mailbox Name and ID of the RI78V4 This layer consists of the following items Mailbox Name An icon indicating the current status of the mailbox and the name of the mailbox are shown in the following format Icon Name Note that if the name of the mailbox is undefined the name will appear as ID There are waiting messages A There are no waiting tasks messages Message Max Priority The maximum priority of the message 0x1F is shown Note that if the message queuing method is TA_MFIFO appears R20UT3374EJ0100 Rev 1 00 LENESAS Page 35 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Attribute The attributes of the mailbox task queuing method and message queuing method are shown in the following format Task Message Task queuing method mama b Second layer lt 1 gt Waiting task information The waiting task information e g Task Name and ID only appears if there are tasks queued in the mailbox s wait queue See the Task tab for details about waiting task information Figure A 14 Mai
20. Information Displays value in signed decimal number Displays value in hexadecimal number 2 Footer row Jump to Source Start Address Opens the Editor panel and displays the source code of the cyclic handler Jump to Disassemble Start Opens the Disassemble panel and displays the results of disassembling the cyclic Address handler Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 42 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Interrupt Handler tab This tab displays the interrupt handler information e g Exception Code and Start Address of the RI78V4 Figure A 19 Interrupt Handler Tab Realtime 05 Resource Information ME Fixed Sized Me EA Cyclic Handler a Interrupt Handler o Initialize Routine ry Ready Queue EE Timer Queue E System Ei Memory rea Taj Task a Semaphore E Eventfl ag A Data Queue P Mailbox Exception Code Start Address Attribute _inthdr1 000003000 TA_HLNG TA_NEAR 1 The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area This area displays the
21. LE OF CONTENTS CHAPTER 1 GENERAL 6 1 1 Overview 6 1 2 Features 6 CHAPTER 2 FUNCTIONS 7 2 1 Overview 7 2 2 Open Realtime OS Resource Information Panel 8 2 2 1 Select item 8 2 2 2 Move column 9 2 2 3 Move tab 10 2 3 Confirm Resource Information 11 APPENDIX A WINDOW REFERENCE 12 A1 Description 12 RI78V4 V2 00 00 V2 00 00 CHAPTER 1 GENERAL CHAPTER 1 GENERAL The CS is an integrated development environment used to carry out tasks such as design coding build and debug for developing application systems for microcontrollers manufactured by Renesas Electronics This manual describes the resource information tool This tool is useful for debugging programs using the RI78V4 real time OS functionality within this integrated program development process 1 1 Overview When debugging programs using the RI78V4 functionality it is possible to use the resource information tool to confirm the resource information e g system information and memory area information that changes dynamically as the pro gram executes 1 2 Features Below are the features of the resource information tool Confirm resource information When the program running in the debugging tool is stopped at an arbitrary location the current status of the resource information appears in the Realtime OS Resource Information panel R20UT3374EJ0100 Rev 1 00 LENESAS Mar 25 2015 Page 6 of 55 RI78
22. V4 V2 00 00 CHAPTER 2 FUNCTIONS CHAPTER 2 FUNCTIONS This chapter describes the key functions provided by the resource information tool along with operation procedures 2 1 Overview The resource information tool can be used to confirm the resource information e g system information and memory area information that changes dynamically as the program executes The operating procedures for the resource information tool are described below 1 Start CS Launch the CS from the start menu of Windows Remark See CS Integrated Development Environment User s Manual Start for details on Start CS 2 Open project Open the project to debug Remark See CS Integrated Development Environment User s Manual Start for details on Open project 3 Select debug tool Select the type of debugging tool with which to debug the program IECUBE E1 E20 or Simulator Remark See CS Integrated Development Environment User s Manual RL78 Debug for details on Select debug tool 4 Download programs Download the program to debug Remark See CS Integrated Development Environment User s Manual RL78 Debug for details on Download programs 5 Open Realtime OS Resource Information Panel Open the Realtime OS Resource Information panel Remarks 1 When a program using the RI78V4 functionality is downloaded this panel opens automatically 2 The value will be indeterminate for the resource information shown when the RI78V4 sy
23. ask information e g Task Name and ID of the RI78V4 This area consists of the following items Task Name An icon indicating the current status of the task and the name of the task are shown in the following format Icon Name EN Ti mer Queue a Data Queue P Mailbox Wait Data Time Left TMO_FEVR Note that if the name of the task is undefined the name will appear as ID 2222 PR aaJ R20UT3374EJ0100 Rev 1 00 Mar 25 2015 LENESAS Page 21 of 55 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Status The current state of the task is shown Waiting Suspended WAITING SUSPENDED state Wait Factor The wait factor type of WAITING state object ID and attribute of WAITING state of the task are shown in the following format Type ID Attribute Note that if the current state of the task is other than WAITING state or WAITING SUSPENDED state appears If the WAITING state type is sleeping state or delayed state then Object ID is not shown Type of WAITING state PRE Task Priority order Wait Data The request conditions triggering the task s transition to WAITING state are shown Note that if the current state of the task is other than waiting state for an eventflag is shown Wait bit pattern Waiting state for an eventtlag The time left until the delayed state is released in tick is shown Time Left Note that if the task is waiting forever TMO FEVR appears I
24. ch area 1 Information display area a First layer This layer displays the data queue information e g Data Queue Name and ID of the RI78V4 This layer consists of the following items An icon indicating the current status of the data queue and the name of the data Data Queue Name queue are shown in the following format Icon Name Note that if the name of the data queue is undefined the name will appear as ID CS There are queued tasks sending waiting tasks du There are queued tasks receiving waiting tasks prJ There are queud data receiving waiting data There are no queued tasks data waiting tasks receiving waiting data A The ID of the data queue is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 31 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Queue Status The current status of the data queue is shown Waiting Tasks Send There are queued tasks sending waiting tasks Waiting Tasks Receive There are queued tasks receiving waiting tasks Waiting Data There are queud data receiving waiting data Empty There are no queued tasks data waiting tasks receiving waiting data Total Buffers Displays the maximum number of data buffers that can be queued Free Buffers Displays the number of free buffers in the data queue The number of free buffers is the total number of buffers minus the number of buffers receiving waiting data Number of data Displays
25. e is shown b Second layer The executing task information e g Task Name and ID only appears if there are tasks queued in the ready queue See the Task tab for details about executing task information R20UT3374EJ0100 Rev 1 00 LENESAS Page 47 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Figure A 22 Ready Queue Tab Executing Task Information Realtime 05 Resource Information EX Fixed Sized 53 Cyclic Handl og Interrupt Ha Initialize Ro be Ready Queue 3 Timer Queue 8 Semaphore kaj Eventilag Data Queue F Mailbox Walt Factor Wait Data Remarks 1 If the executing task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 Ifthe executing task information Current Task SP in the cell is double clicked then Memory panel displays the contents of the task stack and the caret moves to the corresponding loca tion Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Priority Number of Tasks Checked The item in question w
26. ed The item in question will not be displayed Displays cascade menus for selecting the display notation The following items are displayed for selection ID Current Count Max Count Initial Count Displays value in signed decimal number Displays value in hexadecimal number Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 Mar 25 2015 LENESAS Page 27 of 55 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Eventflag tab This tab displays the eventflag information e g Eventflag Name and ID of the RI78V4 Figure A 7 Eventflag Tab Realtime OS Resource Information MX Fixed Sized Memo 4 Cyclic Handler cg Interrupt Handler f Initialize Routine EE Timer Queue Fl System TJ Task e Semaphore Eventilag wr Data Queue P Mailbox Queue Status Current Flag Pattern Initial Flag Pattern Attribute TA TFIFO TA WSGL TA CLR The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area a First layer This layer displays the eventflag information e g Eventflag Name and ID of the RI78V4 This layer consists of the following items Eventflag Name An
27. emor Te Task A Semaphore Eventflag Queue Status Waiting Tasks Receive Wait Factor Wait Date Time Left ctor l aa EIE FIFO E FEVR e Attribute TA_TFIFO TATFIFO j Remarks 1 If the sending waiting task and receiving waiting task information Task Name ID etc in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 Ifthe sending waiting task and receiving waiting task information Current Task SP Task stack area in the cell is double clicked then Memory panel displays the contents of the task stack and the caret moves to the corresponding location lt 2 gt Receiving waiting data information The receiving waiting data information e g Data only appears if there are data queued in the data queue Figure A 12 Data Queue Tab Receiving Waiting Data Information Realtime 05 Resource Information HA Fixed Sized Mem J Cyclic Handler oj Interrupt Handler Initialize Routine Ready Queue E Timer Queue El System ki Memory Ar 8 Semaphore Eventflag 7 Data Queue P Mailbox Queue Status To Attribute Waiting Data TA_TFIFO Queue Status Attn bute Empty TA_TFIFO TA_TFIFO Li D DTGS TATFIFO 4 j This area consists of the following items the contents of the data is shown Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area cl
28. er header column or row in the Realtime OS Resource Information panel and from the context menu that appears select Display Figure 2 1 Select Item HE Fimed Sized FB Cyclic Handler ad Interrupt Han LU Initialize Rout ry Ready Queue EE Timer Queue hi Memory Area Tp Task S Eventilag at Data Queue P Mailbox cranks luo Count Initial Count Object Name 497 TIN p O ee Queue Status 27 TATFFO Current Count V7 z7 TATFFO Max Count O er a o Attribute Remark Select items to display by selecting their checkboxes Table 2 1 Select Item The item in question will be displayed The item in question will not be displayed R20UT3374EJ0100 Rev 1 00 LENESAS Page 8 of 55 Mar 25 2015 RI78V4 V2 00 00 CHAPTER 2 FUNCTIONS 2 2 2 Move column The resource information tool enables you to change the order of items columns displayed in the Realtime OS Resource Information panel To change the display order drag the columns in the Realtime OS Resource Information panel and drop them to the desired position Figure 2 2 Move Column f of initialize Routine SUE R20UT3374EJ0100 Rev 1 00 LENESAS Page 9 of 55 Mar 25 2015 RI78V4 V2 00 00 CHAPTER 2 FUNCTIONS 2 2 3 Move tab The resource information tool enables you to change the order of items tabs displayed in the Realtime OS Resource Information panel To change the display orde
29. esource Informa This panel displays the resource information e g system information and memory area tion panel information of the RI78V4 R20UT3374EJ0100 Rev 1 00 LENESAS Page 12 of 55 Mar 25 2015 RI78V4 V2 00 00 V2 00 00 APPENDIX A WINDOW REFERENCE Realtime OS Resource Information panel This panel displays the resource information e g system information and memory area information of the RI78V4 Figure A 1 Realtime OS Resource Information Panel Realtime 05 Resource Information Ea 1 Ek Fixed Siz Gd CyclicHa f Interrupt c3 Initialize Ready Q EH Timer Qu E Memon T5 Task 0 0 Enable Unlocked 1016084 1016366 282 1016366 _idle_handler 65559 Number of Priority 15 Number of Task Number of Semaphore 2 Number of Eventilag Number of Data Queue Number of Mailbox Number of Mutex Number of Message Butter Number of Fixed Sized Memory Pool Number of Variable Sized Memory Pool Number of Cyclic Handler Number of Alarm Handler Number of Interrupt Handler Number of Initialize Routine Number of Extended Service Call Routine 1 0 0 0 0 i i i oqo i oqo i The following items are explained here How to open Description of each area How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Tab selection area Select a tab to switch the
30. f the current state of the task is other than WAITING state or WAITING SUSPENDED state appears Interrupt The current interrupt state of the task is shown AlI interrupts are disabled All interrupts are enabled Current Priority The current priority of the task is shown Task Start Address The start address of the task is shown Current PC The current PC value of the task is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 22 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Current Task SP The current SP value of the task is shown Task Stack Area The start address end address and size in bytes of the task stack are shown in the following format Start address End address Size Attribute The attributes of the task coding language of task initial activation state of task and initial interrupt state of task are shown in the following format Coding language Initial activation state Initial interrupt state Coding language of task Remarks 1 If the task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC Initial Priority Suspend Count Wakeup Count Activate Count Attribute Extended Information Tex Status Tex Request Pattern Tex Executing Pattern Tex Attribute in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2
31. g 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 This manual is intended f
32. icked R20UT3374EJ0100 Rev 1 00 LENESAS Page 33 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Data Queue Name ID Queue Status Total Buffers Free Buffers Number of Data Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection ID Total Buffers Free Buffers Number of Data Displays value in hexadecimal number Displays value in signed decimal number 2 Footer row Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 34 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Mailbox tab This tab displays the mailbox information e g Mailbox Name and ID of the RI78V4 Figure A 13 Mailbox Tab Realtime 05 Resource Information Ek Fixed Sized M 4 Cyelic Handler j Interrupt Handl Initialize Routi P Ready Queue EH Timer Queue Ei Memory Area WJ Task 8 Semaphore Eventflag a Data Queue FP Mailbox ID Queue Status Message Max Priority Attribute 1 EX Ox 1F TA_TF
33. ill be displayed Not checked The item in question will not be displayed Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection Priority Number of Tasks Displays value in signed decimal number Displays value in hexadecimal number 2 Footer row Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 48 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Timer Queue tab This tab displays the timer queue information e g Object Type and Number of Objects of the RI78V4 Figure A 23 Timer Queue Tab Realtime 05 Resource Information wz Fixed Sized Me 4 Cyclic Handler Cf Interrupt Handler E Initialize Routine Ready Queue XY Timer Queue Te Task 8 Semaphore dk Eventflag el Data Queue P Mailbox The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area a First layer This layer displays the timer queue information e g Object Type and Number of Objects of the RI78V4 This layer consists of the following items Object Type An icon indica
34. ing the current status of the fixed sized memory pool and the name of the fixed sized memory pool are shown in the following format Icon Name Note that if the name of the fixed sized memory pool is undefined the name will appear as ID There are waiting tasks There are no waiting tasks A The ID of the fixed sized memory pool is shown Queue Status The current status of the fixed sized memory pool is shown Waiting Tasks There are waiting tasks Empty There are no waiting tasks Top Address The start address of the fixed sized memory pool is shown Block Size The size per block in bytes of the fixed sized memory pool is shown Total Blocks The block count of the fixed sized memory pool is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 38 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Free Blocks The number of free memory blocks is shown Attribute The task queuing method TA_TFIFO is shown TA_TFIFO FIFO order Remark If the fixed sized memory pool information e g Fixed Sized Memory Pool Name and ID in each cell is double clicked then Memory panel displays the contents of the fixed sized memory pool and the caret moves to the corresponding location b Second layer The waiting task information e g Task Name and ID only appears if there are tasks queued in the fixed sized memory pool s wait queue See the Task tab for details about waiting task information Figure A 17 Fi
35. interrupt handler information e g Exception Code and Start Address of the RI78V4 This area consists of the following items Exception Code An icon indicating the interrupt handler of the exception code are shown in the fol lowing format Icon Exception code Start Address The start address of the interrupt handler is shown Attribute The attributes of the interrupt handler coding language of interrupt handler and information of allocation for interrupt handler are shown in the following format Coding language Information of allocation Coding language of interrupt handler TA_HLNG C language TA_ASM Assembly language Information of allocation for interrupt handler TA_NEAR Allocates NEAR areas TA_FAR Allocates FAR areas Context menu R20UT3374EJ0100 Rev 1 00 LENESAS Page 43 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE The context menu displayed in response to a right mouse click differs as follows depending on the area clicked 1 Header row Display Displays cascade menus for selecting the header items to display Selected tem name The following items are displayed for selection Exception Code Start Address Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection Exception
36. lay item e g whether or not to display header items display notation display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 17 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Memory Area tab This tab displays the memory area information e g Area Name and Top Address of the RI78V4 Figure A 3 Memory Area Tab Realtime OS Resource Information xx lz o Cxu JI em ona oe Dn enas Ca omo fi kernel data init Ox O00F 826A OxOOOFFEZD The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area This area displays the memory area information e g Area Name and Top Address of the RI78V4 This area consists of the following items R20UT3374EJ0100 Rev 1 00 LENESAS Page 18 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Area Name An icon and the name of the managed memory area are shown in the following for mat Icon Name kernel_system Area where kernel codes are to be allocated kernel_system_timer_n Area where the system timer code and the infomation of far branch code for interrupt handler are to be allo cated kernel info Area where information items such as the RI78V4 version
37. lays value in hexadecimal number 2 Footer row Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 37 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Fixed Sized Memory Pool tab This tab displays the fixed sized memory pool information e g Fixed Sized Memory Pool Name and ID of the RI78V4 Figure A 16 Fixed Sized Memory Pool Tab Realtime OS Resource Information Wit Fixed Sized Memory G Cyclic Handler Cd Interrupt Handler Q Initialize Routine FP Ready Queue ZH Timer Queue E System ki Memory Area Pe Task 8 Semaphore i Eventflag e Data Queue P Mailbox Object Name TT ID Queue Status Top Address Block Size Total Blocks Free Blocks Attribute Empty 0x000F83D4 0x10 1 TA_TFIFO TA_TFIFO The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area a First layer This layer displays the fixed sized memory pool information e g Fixed Sized Memory Pool Name and ID of the RI78V4 This layer consists of the following items Fixed Sized Memory Pool Name An icon indicat
38. lbox Tab Waiting Task Information Realtime OS Resource Information Fixed Sized M Cyclic Handler Interrupt Handl y Initialize Routi Ready Queue TimerQueve El System E Memory Area WJ Task 8 Semaphore Eventflag Data Queue P Mailbox Object Name ID Queue Status Message Max Priority Attribute 0x01 Empty Ox 1F TA_TFIFO TA_MPRI Pio vex ox02 Waring Tasks TATFIFOTA WFIFO Wait Factor Wait Data Time Left Interrur MEX ID MEX1 FIFO Remarks 1 If the waiting task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 If the waiting task information Current Task SP in the cell is double clicked then Mem ory panel displays the contents of the task stack and the caret moves to the correspond ing location lt 2 gt Waiting message information The waiting message information e g Message Address and Message Priority only appears if there are messages queued in the mailbox s wait queue R20UT3374EJ0100 Rev 1 00 LENESAS Page 36 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Figure A 15 Mailbox Tab Waiting Message Information Realtime O5 Resource Information Ea Li Fixed Sized M EA Cyclic Handler ad Interrupt Handl ci Initialize Routi ry Ready Queue E Time
39. m name The following items are displayed for selection ID Current Flag Pattern Initial Flag Pattern Displays value in signed decimal number Displays value in hexadecimal number 2 Footer row Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 30 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Data Queue tab This tab displays the data queue information e g Data Queue Name and ID of the RI78V4 Figure A 9 Data Queue Tab Realtime OS Resource Information EJ i Fixed Sized Mem 653 Cyclic Handler Gj interrupt Handler Initialize Routine JJ Ready Queue 2 Timer Queue E System ki Memory Area 9 Task 8 Semaphore i Eventflag Data Queue P Mailbox Object Name ID Queue Status Total Buffers Free Buffers Number of Data Attribute gt DION AN SS a 3 TA TFIFO l ID DTQ2 0x02 0 TA TFIFO 1 ID DTQ4 0x03 TA_TFIFO ID DTQ5 0x04 TA TFIFO le ID DTQG TA_TFIFO ID_DTQ7 7 TA_TFIFO ne The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of ea
40. mble Start Opens the Disassemble panel and displays the results of disassembling the Address initialize routine Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 46 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Ready Queue tab This tab displays the ready queue information e g Priority and Number of Tasks of the RI78V4 Figure A 21 Ready Queue Tab Realtime 05 Resource Information 3 Fixed Sized Cyclic Hand f Interrupt Ha Ej Initialize Ro E e System 8 Semaphore Eventflag ef Data Queue P Mailbox Priorty The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area a First layer This layer displays the ready queue information e g Priority and Number of Tasks of the RI78V4 This layer consists of the following items Priority An icon indicating the current status of the ready queue and the task priority are shown in the following format Icon Task priority There are no queued tasks Number of Tasks The total number of queued tasks tasks with of READY state or RUNNING stat
41. or users who design and develop application systems using RL78 family products This manual is intended for users to understand the functions of real time OS RI78V4 manufactured by Renesas Electronics described the organization listed below This manual consists of the following major sections CHAPTER 1 GENERAL CHAPTER 2 FUNCTIONS APPENDIX A WINDOW REFERENCE lt is assumed that the readers of this manual have general knowledge in the fields of electrical engineering logic circuits microcontrollers C language and assemblers To understand the hardware functions of the RL78 family gt Refer to the User s Manual of each product Data significance Higher digits on the left and lower digits on the right Note Footnote for item marked with Note in the text Caution Information requiring particular attention Remark Supplementary information Numeric representation Decimal XXXX Hexadecimal OXXXXX Prefixes indicating power of 2 address space and memory capacity K kilo 210 1024 M mega 2 1024 Related Documents The related documents indicated in this publication may include preliminary versions However preliminary versions are not marked as such Caution The related documents listed above are subject to change without notice Be sure to use the latest edition of each document when designing All trademarks or registered trademarks in this document are the property of their respective owners TAB
42. r drag the tabs in the Realtime OS Resource Information panel and drop them to the desired position Figure 2 3 Move Tab laj df initialize Routine _init_handler 0x00010018 a z be ej _init_handler 0x00010018 p A ig Initialize Routine Start Address be ak _init_handler 0x00010018 R20UT3374EJ0100 Rev 1 00 LENESAS Page 10 of 55 Mar 25 2015 RI78V4 V2 00 00 CHAPTER 2 FUNCTIONS 2 3 Confirm Resource Information Check the resource information when program execution is stopped via the various tabs of the Realtime OS Resource Information panel e g System tab and Memory Area tab The Realtime OS Resource Information panel is made up of the following tabs System tab Memory Area tab Task tab Semaphore tab Eventflag tab Data Queue tab Mailbox tab Fixed Sized Memory Pool tab Cyclic Handler tab Interrupt Handler tab Initialize Routine tab Ready Queue tab Timer Queue tab Remark Switch tabs in the tab selection area of the Realtime OS Resource Information panel Interrupt Handler tab R20UT3374EJ0100 Rev 1 00 LENESAS Page 11 of 55 Mar 25 2015 RI78V4 V2 00 00 V2 00 00 APPENDIX A WINDOW REFERENCE APPENDIX A WINDOW REFERENCE This appendix describes the panels of the resource information tool A 1 Description The panels of the resource information tool are listed below Table A 1 Panel List Realtime OS R
43. r Queue i En ff Memory Area Te Task 8 Semaphore LA Eventilag wr Data Queue EP Mailbox Queue Status Message Max Priority Attribute Ox 1F TA_TFIFO TA_MPRI Message Address Message Priority Ox000F 8404 Ox3 SJ OKOOOFESFA Object Name Message Max Priority Attribute F ID MBXI i TA TFIFO TA MFIFO This area consists of the following items Message Address The start address of the message is shown Message Priority The priority of the message is shown Note that if the priority is not assigned is shown Remark If the waiting message information Message Address Message Priority in each cell is dou ble clicked then Memory panel displays the contents of the message and the caret moves to the corresponding location Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Mailbox Name ID Queue Status Message Max Priority Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection ID Message Max Priority DEC Displays value in signed decimal number HEX Disp
44. s non operational state appears Start Address The start address of the cyclic handler is shown Extended Information 0x0 is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 41 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Attribute The attributes of the cyclic handler the cyclic handler s initial activation state and existence of saved activation phases are shown in the following format Initial activation state Existence of saved activation phases Initial activation state of cyclic handler Remark If the cyclic handler information e g Cyclic Handler Name and ID in each cell is double clicked then Editor panel displays the source file of the cyclic handler and the caret moves to the corresponding location Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Cyclic Handler Name ID Status Interval Phase Time Left Start Address Extended Information Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection ID Interval Phase Time Left Start Address Extended
45. s 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 to radiation resistance
46. source Information 3 Fixed Sized M 4 Cyclic Handler og Interrupt Handl Initialize Routi EH Timer Queue System Task 8 Semaphore Ca Data Queue Queue Status Current Flag Pattenn Initial Flag Pattern Waiting Tasks be Wait Factor Walt Data FLG ID FLGT ANDW FIFO Remarks 1 If the waiting task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 Ifthe waiting task information Current Task SP in the cell is double clicked then Memory panel displays the contents of the task stack and the caret moves to the corresponding loca tion Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 29 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Eventflag Name ID Queue Status Current Flag Pattern Initial Flag Pattern Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected ite
47. stem initial ization is incomplete because it will not be managed by the RI78V4 6 Execute stop programs Run the program to the location for which you wish to display the resource information Remarks 1 See CS Integrated Development Environment User s Manual RL78 Debug for details on Execute stop programs 2 You can debug a program efficiently using Section skip function of the debugger For example step in execute on a service call issue point the debugger skip all internal process of RI78V4 and break by reaching the user application part See CS Integrated Development Environment User s Manual RL78 Debug for details on Section skip function R20UT3374EJ0100 Rev 1 00 LENESAS Page 7 of 55 Mar 25 2015 RI78V4 V2 00 00 CHAPTER 2 FUNCTIONS Remark 7 Confirm Resource Information On the Realtime OS Resource Information panel tabs e g System tab and Memory Area tab check the current status of the resource information 2 2 Open Realtime OS Resource Information Panel The Realtime OS Resource Information panel is used to confirm the resource information e g system information and memory area information This panel opens automatically when a program using the RI78V4 functionality is downloaded 2 2 1 Select item The resource information tool enables you to select the items to display in the Realtime OS Resource Information panel To select which items are displayed right click on the head
48. the cell is double clicked then Mem ory panel displays the contents of the task stack and the caret moves to the correspond ing location 25 Cyclic handler information The cyclic handler information e g Cyclic Handler Name and ID only appears if there are cyclic handlers queued in the timer queue See the Cyclic Handler tab for details about cyclic handler information Figure A 25 Timer Queue Tab Cyclic Handler Information Realtime 05 Resource Information MX Fixed Sized Me Cyclic Handler j Interrupt Handler j Initialize Routine Ready Queue EJ Timer Queue El System SWE Memory Are WA Semaphore Eventilag e Data Queue P Mailbox Object Type Mumber of Objects EA Task 0 Interval Phase Le Start Sukon _eychdr 000010162 foun roresta ao fe ha SOOT 2 one EE APA OxOB TCYC STA 10 1 _eychdr 0 0001015F oe pesao ESOO Remark Ifthe cyclic handler information e g Cyclic Handler Name and ID in each cell is double clicked then Editor panel displays the source file of the cyclic handler and the caret moves to the corresponding location R20UT3374EJ0100 Rev 1 00 LENESAS Page 50 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked 1 Header row Display Displays cascade menus for selecting the header items
49. the number of data in buffers Attribute Displays the queuing method of the sending waiting tasks If the queuing method of the receiving waiting tasks is data reception request order then the queuing method of the receiving waiting data will be data send request order TA_TFIFO FIFO order b Second layer lt 1 gt Sending waiting task receive waiting task information The sending receiving waiting task information e g Task Name and ID only appears if there are tasks queued in the data queue s wait queue See the Task tab for details about sending receiving waiting task information Figure A 10 Data Queue Tab Sending Waiting Task Information Realtime O5 Resource Infomation Ex Fixed Sized Mem 3 Cyclic Handler Cd Interrupt Handler Initialize Routine P Ready Queue Tej Timer Queue _ Gl System Fi Te Task 8 Semaphore 2 Eventflag Queue Status Total Buffers Attribute Waiting Tasks Send 2 TA_TFIFO Wait Factor Wait Data Amos kela kiemu Current Pi SDTQ ID_DTQ1 FIFO 0x13 li Butters Buffers Attribute TA TFIFO ole iD DTAS TA TFIFO j R20UT3374EJ0100 Rev 1 00 LENESAS Page 32 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Figure A 11 Data Queue Tab Receiving Waiting Task Information Realtime OS Resource Information ME Fixed Sized Mem J Cyclic Handler Cf Interrupt Handler c3 Initialize Routine Ready Queue E Timer Queue El System Fi M
50. ting the current status of the timer queue and the object type are shown in the following format Icon Object type There are queued tasks 3 There are no queued tasks There are queued cyclic handlers There are no queued cyclic handlers Object type Cyclic Handler Cyclic handler Number of Objects The total number of queued objects tasks and cyclic handlers is shown R20UT3374EJ0100 Rev 1 00 LENESAS Page 49 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE b Second layer lt 1 gt Waiting task information The waiting task information e g Task Name and ID only appears if there are tasks queued in the timer queue See the Task tab for details about waiting task information Figure A 24 Timer Queue Tab Waiting Task Information Realtime 05 Resource Information ae Fixed Sized Me Cyclic Handler rd Interrupt Handler CH Initialize Routine Fy Ready Queue Timer Queue A Task Md Semaphore 4 Eventilag at Data Queue P Mailbox Wait Factor Eman SEMI FIFO Number of Objects 3 Cyclic Handler 0 4 Mm Remarks 1 lf the waiting task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 If the waiting task information Current Task SP in
51. tion e g Start Address and Extended Information of the RI78V4 This area consists of the following items Start Address An icon and the start address of the initialize routine are shown in the following for mat Icon Start address Remark Ifthe initialize routine information e g Start Address and Extended Information in each cell is double clicked then Editor panel displays the source file of the initialize routine and the caret moves to the corresponding location Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 45 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row Display Displays cascade menus for selecting the header items to display Selected item name The following items are displayed for selection Start Address Extended Information Attribute Checked The item in question will be displayed Not checked The item in question will not be displayed Notation Displays cascade menus for selecting the display notation Selected item name The following items are displayed for selection Start Address Extended Information Displays value in signed decimal number Displays value in hexadecimal number 2 Footer row Jump to Source Start Address Opens the Editor panel and displays the source code of the initialize routine Jump to Disasse
52. ttern Displays value in signed decimal number Displays value in hexadecimal number 2 Footer row Jump to Source Task Start Opens the Editor panel and displays the source code of the task Address Jump to Disassemble Task Start Opens the Disassemble panel and displays the results of disassembling the task Address Jump to Source Current PC Opens the Editor panel and displays the contents of the Current PC Jump to Disassemble Current PC Opens the Disassemble panel and displays the contents of the Current PC Jump to Memory Current Task SP Opens the Memory panel and displays the contents of the Current Task SP Jump to Source Tex Start This item will be grayed out Address Jump to Disassemble Tex Start This item will be grayed out Address Reset Display Item Resets the display item e g whether or not to display header items display nota tion display order and display width R20UT3374EJ0100 Rev 1 00 LENESAS Page 24 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE Semaphore tab This tab displays the semaphore information e g Semaphore Name and ID of the RI78V4 Figure A 5 Semaphore Tab Realtime 05 Resource Information MI Fixed Sized EA Cyclic Handler dd Interrupt Han g Initialize Rout ry Ready Queue EE Timer Queue an Fi Memory rea e Task E s Eventflag wr Data Queue P Mailbox Count Count The following items
53. x l gE Object arenes ID Status Interval mm r Time Left Start Address S iii Attribute _cychdr1 0x0001002B 0x0 TA_STA 1 EA 1D_CYC2 TCYC_STP _cychdr2 0x0001002F A ID_CYC3 TCYC_STP _cychdr3 0x00010038 The following items are explained here How to open Description of each area Context menu How to open From the Debug menu select Download From the View menu select Realtime OS gt gt Resource Information Description of each area 1 Information display area This area displays the cyclic handler information e g Cyclic Handler Name and ID of the RI78V4 This area consists of the following items Cyclic Handler Name An icon indicating the current status of the cyclic handler and the name of the cyclic handler are shown in the following format Icon Name Note that if the name of the cyclic handler is undefined the name will appear as ID Non operational state STP state Operational state STA state The ID of the cyclic handler is shown Status The current status of the cyclic handler is shown TCYC_STP Non operational state STP state TCYC_STA Operational state STA state The activation cycle in tick of the cyclic handler is shown The initial activation phase in tick of the cyclic handler is shown Time Left The time left before the next activation in tick of the cyclic handler is shown Note that if the current state of the cyclic handler i
54. xed Sized Memory Pool Tab Waiting Task Information Realtime OS Resource Information 2 Fixed Sized Memory A Cyclic Handler Gj Interrupt Handler Q Initialize Routine Ready Queue 3 Timer Queue E System Ei Memory Area Pe Task 8 Semaphore i Eventflag I Data Queue P Mailbox Object Name ID Queue Status Top Address Block Size Total Blocks Free Blocks Attribute ID_MPF1 0x01 Waiting Tasks 0x000F83D4 0x10 1 0 TA_TFIFO Object Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start A _task2 0x0 Object Name ID Queue Status Top Address Block Size Total Blocks Free Blocks Attribute TA_TFIFO e ID_MPF4 Remarks 1 If the waiting task information Task Name ID Status Wait Factor Wait Data Time Left Interrupt Current Priority Task Start Address Current PC in each cell is double clicked then Editor panel displays the source file of the task and the caret moves to the corresponding location 2 Ifthe waiting task information Current Task SP in the cell is double clicked then Memory panel displays the contents of the task stack and the caret moves to the corresponding loca tion Context menu The context menu displayed in response to a right mouse click differs as follows depending on the area clicked R20UT3374EJ0100 Rev 1 00 LENESAS Page 39 of 55 Mar 25 2015 RI78V4 V2 00 00 APPENDIX A WINDOW REFERENCE 1 Header row
Download Pdf Manuals
Related Search