Debugging Extension User`s Manual
Contents
1. Start Address Ma inTask hitial Priority D E Stack Size H200 Figure 2 18 Create Task Dialog Box Rev 1 0 08 03 page 21 of 38 19 Selecting Hide from the pop up menu of the Task window or Action Result window will close this window Before doing so a breakpoint has to be set so that execution of the program will stop at the while 1 statement of Task7 To set a breakpoint double click the part circled in figure 2 19 GE ZU nie Piar sarisruziniea amea por argg san Options Build Debug Memory Tools Window Help ee 2 me u osuos i e e oT a w 1 Sa seas dse lzojum jassszajnu nanT E Zo o ENRERE ERENER ERI m ELEA ENI Seu Fass Rees o zi xi 0x8000d024 ercd set_fle 6 Dxffffffff 7707 cfe Ox8000d034 while 1 107 def TIMI miv EI Build A Debug A Find in Files A Version Control Objects KNL_IDLE KERNEL OTHERS TSK D 0006 TSK D 0007 7100Cycle Task ID Pc nt Tine Stamp No Task H 80004a50 0003378747 Cycle No Task H 80004d50 Ju 0003379078 Cycle No Task H 80004a50 0006706683 Cycle No Task H s0004d50 E_OK 0006707178 Cycle No Task Kernel Idling 0006707768 Cycle No Task H 80004a50 0010034620 Cycle No Task H 80004a50 OK 0010034977 Cycle Read write 64 65 Figure 2 19 Setting a Breakpoint Rev 1 0 08 03 page 22 of 38 20 When the execution of the target is resumed MainTask is initiated and execution sto2. Rev 1 0 08 03 page 37 of 38 Rev 1 0 08 03 page 38 of 38 Debugging Extension User s Manual Publication Date Rev 1 00 August 5 2003 Published by Sales Strategic Planning Div Renesas Technology Corp Edited by Technical Documentation amp Information Department Renesas Kodaira Semiconductor Co Ltd 2003 Renesas Technology Corp All rights reserved Printed in Japan Debugging Extension User s Manual LTENESAS Renesas Electronics Corporation 1753 Shimonumabe Nakahara ku Kawasaki shi Kanagawa 211 8668 Japan REJ10B0029 0100H
3. Rotates the ready queue Raise Task Exception Routine Requests task exception processing dialog box Start Overrun Handler dialog box Starts operation of the overrun handler Stop Overrun Handler dialog box Stops the overrun handler Note Cannot be used when the RTOS in use was configured without enabling the manipulation of objects Rev 1 0 08 03 page 30 of 38 Table 3 2 Classification Windows and Dialog Boxes cont Window Name Functions Semaphores Semaphore window e Displays states of all semaphores e Displays the wait task queue for each semaphore Increment Semaphore Count Increments semaphore count dialog box Decrement Semaphore Count Decrements semaphore count dialog box Event flags EventFlag window e Displays the states for all event flags e Displays the wait task queue for each event flag Set EventFlag dialog box Sets an event flag Clear EventFlag dialog box Clears an event flag Data queue DataQueue window e Displays the states of all data queues e Displays the receive data acquired in all data queues Send Data to DataQueue dialog Sends data to data queue box DataQueue Wait Task Queue Displays the wait task queue for each window data queue Mailboxes Mailbox window e Displays the states of all mailboxes e Displays the wait task queue for each mailbox e Displays the received message queues for all mailboxes Send Message to Mailbox dialog Sen
4. 0xffffffff 0000019663 Cycle H 8000d000 E OK 0000020174 Cycle H 8000dOOe del flg OxOOO6 OOOOOZ0440 Cycle H 8000dOOe E OK OOOOO20757 Cycle H 8000d018 ext tski OOOOOZIO19 Cycle Figure 3 4 RTOS Trace Diagram Window and RTOS Trace Text Window Rev 1 0 08 03 page 28 of 38 3 4 List of Functions 3 4 1 Menu Items After the DX has been installed the items listed in table 3 1 which allow accesses to the DX functions are added to the View menu of the HEW Table 3 1 Items to be Added to the HEW s View Menu Pull Down Menu Submenu Function RTOS Task Opens the Task window Semaphore Opens the Semaphore window EventFlag Opens the EventFlag window DataQueue Opens the DataQueue window Mailbox Opens the Mailbox window Mutex Opens the Mutex window MessageBuffer Opens the MessageBuffer window V MemoryPool Opens the V MemoryPool window F MemoryPool Opens the F MemoryPool window Timer Opens the Timer window Interrupt Opens the Interrupt window Trap Opens the Trap window Cyclic Opens the Cyclic window Alarm Opens the Alarm window Extended SVC Opens the Extended SVC window Action Result Opens the Action Result window Trace Opens the Trace window Selecting View gt CPU gt Status displays the DX state in the Status window common in HEW Note that some functions are not supported depending on the RTOS in use Rev 1 0 08 03 page 2
5. 6 Since Task is still in the RUN state it must be forcibly terminated before deletion To terminate Task7 select highlight Task7 in the Task window click the right hand mouse button to launch the pop up menu then select Action gt Terminate Task This opens the Terminate Task dialog box so press the OK button Task7 can then be deleted in the same way as MainTask Terglrzito Jass sinroro Cok Cancel Figure 2 16 Terminate Task Dialog Box Rev 1 0 08 03 page 19 of 38 17 You can check the result of the manipulation of kernel objects such as the termination and deletion of a task by selecting View gt RTOS gt Action Result However even if the Action Result window is opened the results will not be visible here The DX sends requests for the execution of service calls to the kernel to realize manipulation of kernel objects Thus a task will be actually deleted after execution by the kernel To obtain the results in this case resume the execution of the target by selecting Debug gt Go The results will be automatically displayed Then select Refresh task sheet from the pop up menu of the Task window You will see that MainTask task ID 6 and Task7 task ID 7 are both in the NOEXS state WAY tie Fllepecarigsuaines Emesdlel poresrog lasag File Edit View Project Options Build Debug Memory Tools Window Help tvome nu e cision e osaga aena ais masa jemi x fm kons A ER lla ss 2
6. 9 of 38 3 4 2 Windows and Dialog Boxes Table 3 2 is a list of windows and dialog boxes for the DX For further details on the windows and dialog boxes refer to the online help file The online help file can be launched by selecting Help gt RTOS Help Table 3 2 Classification Windows and Dialog Boxes Window Name Functions Tasks Task window e Displays the states of all tasks e Displays the ready queue e Displays locked mutexes for all tasks Task Detail Information window Displays detailed information on tasks Create Task dialog box Creates tasks Delete Task dialog box Deletes tasks Activate Task dialog box Initiates tasks Cancel Activate Task dialog box Cancels request for task initiation Start Task dialog box Initiates task with initiation code specified Terminate Task dialog box Forcibly terminates tasks Release Wait dialog box Forces tasks out of the wait state Suspend Task dialog box Moves tasks into SUSPENDED state Resume Task dialog box Resumes the execution of tasks in the SUSPENDED state Wakeup Task dialog box Wakes tasks up Cancel Wakeup Task dialog box Cancels wakeup requests Change Task Priority dialog box Changes task priority levels Set Task EventFlag dialog box Sets task dependent event flags Clear Task EventFlag dialog box Clears task dependent event flags Rotate Ready Queue dialog box
7. 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 LENESAS C 7 D T on lt D D Debugging Extension User s Manual HS6400IWIN1SE Renesas Microcomputer Development Environment System Renesas Electronics Rev 1 0 2003 08 www renesas com Cautions Keep safety first in your circuit designs l Renesas Technology Corporation puts the maximum effort into making semiconductor products better and more reliable but there is always the possibility that trouble may occur with them Trouble with semiconductors may lead to personal injury fire or property damage Remenber to give due consideration to safety when making your circuit designs with appropriate measures such as i placement of substitutive auxiliary circuits ii use of nonflammable material or iii prevention against any malfunction or mishap Notes regarding these materials 1 These materials are intended as a reference to assist our customers in the selection of the Renesas Technology Corporation product best suited to the customer s application they do not convey any license under any intellectual property rights or any other rights belonging to Ren
8. FL DEL PO he T 5 mmm B a mim Te C Ae apes 20086 aa ms Reais e a 100cycle E Event Time Stamp o No Task E 0002 66 cre _cyc 0x000b Ox8c000c54 0000015827 Cycle No Task H 80002f66 E DOK 0000016262 Cycle 0006 H 8000cf98 Task start 0x00000000 0000016777 Cycle 0006 H s8000cfb cre_flg 0x0006 0x8c0ZZ17c 0000017050 Cycle 0006 H 8000cfb6 E OK O000017371 Cycle 0006 H 8000cfe6 cre_tsk 0x0007 0x8c02217c 0000017665 Cycle 0006 H EOGUSEAS E 0K ONI CEO H wai flg 0x0006 0x11111111 0x00000000 c0 Bi H 20004020 Task start 0x00000000 0000019399 Cycle H 8000d03Z2 set_flg 0x0006 0xffffffff 0000019663 Cycle Hiannnannn R AR ANANNZNI SEIC el Priority Ste Wait Factor ReturnParam Param Paran2 g H 00000006 TER_TSK H 00000007 H 00000000 DEL TSK Zi H 00000007 Read write 143 65 Figure 2 17 Result of the Manipulation of Objects Rev 1 0 08 03 page 20 of 38 18 Select Debug gt Halt Program to stop the program execution To create and initiate MainTask with a priority of 8 that is lower than Task7 select highlight task ID 6 in the Task window and then select Action Create Task from the pop up menu This opens the Create Task dialog box Make the entries as shown in figure 2 18 Greate lask Actoni Extended Info HO Cancel Attribute C TA ASM e TA HLNG WM TA ACT Troe fa II e Fe pest oo bo JES Vo
9. Help LIIE SL Eu j raejoTo a Ja IE ai ka 25 obi big JELE deja E 83320 HO POD S Fe ESA Sue uM ERIE E uouE ns LAL Build A Vebug A Findin tiles A _ er trol KNL_IDLE KERNEL OTHERS TSK D 0006 TSK D 0007 100Cycle Display Task Information Task ID PC LIES Change Task Priority No Task H 80002f66 cre cyc 0xO0Ob Ox8c0 No Task H 80002 f66 E OK Set Task EventFlag eeru D 0006 H 8000cf98 Task start Ox00000000 Clear Task EventFlae Cancel Activate Task D 0006 H 8000cfb6 cre_flg 0x0006 0x8c0 Rotate Ready Queue Start Task D 0006 H 8000cfb6 E_OK 4 D 0006 H 8000cfe6 cre tsk 0x0007 0x8c0 Raise Task Exception Terminate Task D 0006 H900DC eb KOK Start Overrun Handler Release Wait 8 D 0006 H s wai flg 0x000 E D 0007 H 8000d020 Task start 0Ox0OODODO Stop Overrun Handler Suspend Task D 0007 H 8000d032 set flg 0xO0006 0Oxfffi View Task Top Source Resume Task nani panne Hw annnannn R AR 3 View Task PC Source Wakeup Task Cance WakeupTask Wait Factor NOEXS NOEXS NOEXS NOEXS Sopy Refresh Task sheet V Allow Docking Hide NOEXS MainTask Open Delete Task dialog Read write 43 65 Figure 2 14 Task Window Pop Up Menu Rev 1 0 08 03 page 18 of 38 15 Press the OK button in the Delete Task dialog box Bajara lask Acuon Figure 2 15 Delete Task Dialog Box 1
10. Help Slasjeun s z EN u Dsugo Ra 07 co la p a rie e FUDMBTVEV T S Mmm Bi mi mom mO An 3 mM maest AOD Bae jaa m a n ea om SLE _ Build A Uebug A Find n Files A Version Control KNL IDLE KERNEL OTHERS TSK D 0006 TSK D 0007 l100Cycle Task ID PC Event Time Stamp No Task H 8000Zf66 cre_cyc 0x000b 0x8c000c54 0000015828 Cycle No Task H 80002f66 E OK 0000016263 Cycle D O006 H 8000cf98 Task start 0x00000000 0000016778 Cycle D oo06 H 8000cfb6 cre_flg 0x0006 0x8c02217c 0000017051 Cycle D O0006 H s000cfb E OK 0000017372 Cycle H 8000cfe6 cre_tsk 0x0007 0x8c0Z217c 0000017666 Cycle H s000cfe6 EEPE CEGA H 8000a020 0000019400 Cycle H 8000d03Z2 set flg 0OxODO6G Oxffffffff O000019664 Cycle Hiannnannn R NR NANNNZNI SEICE Priority Wait Factor _MainTask H OOOOOOOO D 0006 task H 00000000 D 0007 Task Lock Mutex Read write 143 65 Figure 2 13 Task Window Rev 1 0 08 03 page 17 of 38 14 Next execute the user program when the priority of MainTask is lower than Task7 First MainTask and Task7 must be deleted to return them to their initial state To delete MainTask select highlight MainTask in the Task window click the right hand mouse button to launch the pop up menu then select Action Delete Task from this pop up menu TRU mie rliurresriurgene Egeo urso Irege ject Options Build Debue Memory Tools Window
11. To our customers Old Company Name in Catalogs and Other Documents On April 1 2010 NEC Electronics Corporation merged with Renesas Technology Corporation and Renesas Electronics Corporation took over all the business of both companies Therefore although the old company name remains in this document it is a valid Renesas Electronics document We appreciate your understanding Renesas Electronics website http www renesas com April 1 2010 Renesas Electronics Corporation Issued by Renesas Electronics Corporation http www renesas com Send any inquiries to http Awww renesas com inquiry TENESAS 10 11 12 Notice All information included in this document is current as of the date this document is issued Such information however is subject to change without any prior notice Before purchasing or using any Renesas Electronics products listed herein please confirm the latest product information with a Renesas Electronics sales office Also please pay regular and careful attention to additional and different information to be disclosed by Renesas Electronics such as that disclosed through our website Renesas 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 gra
12. a jm mom mom Gm a mm 1a seas ala we w ey Gq 7707 cfe GI 7708 def l 7708 mix TI09 cfe 7709 def TIO9 mix 7709a cfe TI09a def TI09a mix lj 7729 cfe a 7729 def iz 7729 mix UUI FIU GI GUU GU a E E E ic a H E EI B m 2 7729_cpuasmsre 4 1729 expentsrc 2 7729 intdwnsro QC source file 7729 cpuini c 7729 sysdwnc 7729_tmrdrv c kernel cfec kernel def Assembly source file F11 F10 Shift F11 PI Steph P Step Over P Step Qut Step Step Mode Halt Program hitialize Disconnect Unload Modules Figure 2 5 Downloading the Load Module Rev 1 0 08 03 page 9 of 38 6 Make the settings for RTOS tracing Select View gt RTOS gt Trace Click the right hand mouse button on the RTOS Trace window and then select Set Trace Options from the popup menu LOJ PAY ike plivrresriurgsigeo Smeal urnoj File Edit View Project Options Build Debug Memory Tools Window Help enlnis as ecve2 seijuoimjoscojs kejovuja ae a al oS ae lems fee aleo zzojum asssiao n menas FROM P POS RR hm e Hala Th om eM B be AERE TET ISTE Ve z x E zi gt 7707 cfe TO def TM mi I E EN Tem navi Objects KNL IDLE KERNEL OTHERS Link Trace Text Select Diagram Object Input Trace File Output Trace File Output Text File Task ID PC E
13. ae aaea aes sia m lmxa gat mm i ek mmm mM SEZACO ECO Aap Eu em o ER ercd Ox8000d024 ercd set_fle 6 Oxffffffff TIO def TIOJ sine Statistics Statistics Range Start No End No Value O Oycle Acti z D 0000 21 Cycle J H 8C02217C 5 Cycle SP Bottom Address H 8C022144 9 Oycle SP Limit Address H 8C021DA4 O Oycle SP Total Size H 00000400 SP Used Size H 00000020 H 000003E0 mul Objects KNL_IDLE 00002 No Task H 800 Ju 00003 D OOOSE H s000cf98 Task start 0x00000000 00004 D OOO6 H 8000cfb6 cre_flg 0x0006 0x8c02217c OTHERS 00005 D OOOS H 8000cfb6 E OK 00006 D OOO6 H 8000cfe6 cre _tsk 0x0007 0x8c02217c rears 00007 D OOOE H 8000cfe6 E TSK D 0007 os 0 i LULI GIDONGANOB sL FLG D 0006 B 100Cycle Read write 61 65 Figure 1 1 DX Overview Rev 1 0 08 03 page 1 of 38 1 2 Features e Graphical user interface The status of objects such as tasks can be referred to and modified through windows and dialog boxes and multitasking applications can be debugged in the HEW environment e Display of tracing information for service calls The history of service calls in RTOS systems can be displayed graphically The user can also select the items to be displayed in this history 1 3 Preparations for Using the DX The followings must be done before using the DX for debugging Install the DX Follow the instr
14. 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 products are classified according to the following three quality grades Standard High Quality and Specific The recommended applications for each Renesas Electronics product depends on the product s quality grade as indicated below 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 categorized as Specific without the prior written consent of Renesas Electronics Further you may not use any Renesas Electronics product for any application for which it is not intended without the prior written consent of Renesas Electronics 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 an application categorized as Specific or for which the product is not intended where you have failed to obtain the prior written consent of Renesas Electronics The quality grade of each Renesas Electronics product is Standard unless otherwise expressly specified in a Renesas Electronics data sheets or data books etc Standard Computers
15. c 0000017666 Cycle D 0006 H 8000cfe6 E OK 0000018531 Cycle D 0006 H 8000d000 wai_flg 0x0006 0x11111111 0x00000000 0x8c02219c 0000018805 Cycle D 0007 H 8000d020 Task start 0OxOOOOOOOO 0000019400 Cycle D 0007 H 8000d032 set_flg 0x0006 0xffffffff 0000019664 Cycle D ANNA H RANNANNN R NR NANNAZNISA ewe ed Read write Figure 2 110 Source Window with the Execution Stopped Rev 1 0 08 03 page 14 of 38 11 You can check how the program was executed by using the service call trace function To display MainTask task ID 6 and Task7 task ID 7 in such a way that the diagram is easy to see click the right hand mouse button on the RTOS Trace window and select Select Diagram Object from the pop up menu Add task IDs 6 and 7 and close the dialog box Salasa Hijsen Ole sier Available Object item Selected Object item KNL IDLE KERNEL Semaphore OTHERS Mailbox L il ATSKD OOOG lMessageBuffer TSK D 0007 V MemoryPool F MemoryPool Interrupt DataQueue Delete Mutex OK Cancel Figure 2 11 Select Diagram Object Window Rev 1 0 08 03 page 15 of 38 12 Task IDs 6 and 7 are displayed in the RTOS Trace Diagram window With a glance at the window you can see that the execution of Task7 starts after MainTask has issued wai flg Double clicking the row where the service call is displayed in the RTOS Trace Text window opens the corresponding source window TI sie riurreariu
16. der certain use conditions Further Renesas Electronics products are not subject to 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 system 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 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
17. dow e Displays the object item list e Displays trace information textual form RTOS Trace Options dialog box Makes various settings for trace Select Diagram Object dialog box Defines the target object for trace display in the diagrammatic form Select Text Object dialog box Defines trace information for the kernel resource Load RTOS Trace Information File Inputs the trace information file dialog box RTOS Trace Statistics dialog box Displays overall view of program execution RTOS Trace Find window Searches for event information Save As dialog box Outputs trace information to a file Note Cannot be used when the RTOS in use was configured without enabling the manipulation of objects Rev 1 0 08 03 page 33 of 38 Rev 1 0 08 03 page 34 of 38 Section 4 Precautions and Restrictions 4 1 Realtime Operation of the User System and Cyclic Handler The DX functions are realized by referencing or updating data in the memory of the user system If the following functions are used during the execution of the user program memory access will occur and operation will not be in realtime e Opening or updating a window e Clicking the OK button of a dialog box to manipulate an object If the RTOS in use was configured with the manipulation of objects enabled the throughput of the user system falls a little because a cyclic handler for the DX with a certain cycle is automatically installed in the system 4 2 Consistency of Display
18. ds messages to mailboxes box Receive Message from Mailbox Receive messages from mailboxes dialog box Mutex Mutex window e Displays the states of all mutexes e Displays the wait task queue for each mutex Note Cannot be used when the RTOS in use was configured without enabling the manipulation of objects Rev 1 0 08 03 page 31 of 38 Table 3 2 Classification Windows and Dialog Boxes cont Window Name Functions Message buffer MessageBuffer window e Displays the states of all message buffers e Displays the wait task queue for each message buffer e Displays the received message queue for each message buffer Send Message to MessageBuffer dialog box Sends messages to message buffers Variable size Variable size MemoryPool window Displays the states of all variable memory pool size memory pools e Displays the wait task queue for each variable size memory pool Get Variable size MemoryPool Acquires variable size memory blocks dialog box Release Variable size Releases variable size memory blocks MemoryPool dialog box Fixed size Fixed size MemoryPool window e Displays the states of all fixed size memory pool memory pools e Displays the wait task queue for each fixed size memory pool Get Fixed size MemoryPool dialog Acquires fixed size memory blocks box Release Fixed size MemoryPool Releases fixed size memory blocks dialog box Timer Tim
19. ecution NE VIAJ nibo plisrresriuruslneo Emesblo Urug File Edit View Project Options Build ESU Memory Tools Window Help len im is s eva z suoja tse orua Jaka ssss Jesua OS f dhe un asssza n msasa E LEED o T eO Too 00 cursor pum Te x ae PETTE ia 1e a e suo xixi le 7707 cfe I 7707 def Download Modules Unload Modules 100Cycle Stop running the program Figure 2 9 Stopping the Program Execution Rev 1 0 08 03 page 13 of 38 10 Execution stops within the while 1 statement of Task7 as shown in figure 2 10 Ui VIAJ nike riivtecariurisines emesis Eorsi TERR File Edit View Project Options Build Debue Memory Tools Window Help gt GS ewe 2 mEnE Osea S szelorT uel aas zlzojnmjiase sa BBL Bt Bh He alsm Dw ie mmm mmm mom mim M E He EPAKTO IE EAMES zi xi 0x8000d024 ercd set fle 6 Dxffffffff 7707 cfe Ox8000d034 7707 def FIN miv al Gre sm oe KNL IDLE KERNEL OTHERS 100Cycle Task ID PC Event Tine Stamp No Task H 80002f66 cre_cyc 0x000b 0x8c000c54 0000015828 Cycle No Task H 80002f66 E OK 0000016263 Cycle D 0006 H 8000cf98 Task start 0x00000000 0000016778 Cycle D 0006 H 8000cfb6 cre_flg 0x0006 0x8c0ZZ217c 0000017051 Cycle D 0006 H 8000cfb6 E OK 0000017372 Cycle D O006 H 8000cfe6 cre _tsk 0x0007 0x8c02217
20. ed Contents Reference to an object s state is by directly reading from data in the memory of the user system Therefore if such data is read during the execution of an RTOS kernel routine the information displayed may not be correct Also if an object s state is referred to before the initialization of the kernel has been completed the information displayed may not be correct Rev 1 0 08 03 page 35 of 38 Rev 1 0 08 03 page 36 of 38 Appendix A Troubleshooting A 1 Displaying Action Result Window Results If an object manipulation request is made through a dialog box and the user program is executed but the display is not updated this could be because the cyclic handler for the DX is not operating correctly The following is a list of causes and the measures to be taken in such cases 1 No timer interrupt occurs A Timer interrupts do not occur Correct the timer driver so that timer interrupts will occur B Timer interrupts do occur but are not accepted In the following cases timer interrupts are not accepted Too many interrupts occur that have an interrupt level higher than the timer interrupt b The timer interrupt level has been masked for a long time For interrupts that have a level equal to or higher than the timer interrupt level keep the masking time as short as possible 2 The system goes down When the system goes down timer interrupts may not be accepted Take care so that the system will not go down
21. er window e Displays the system clock setting e Displays the wait queue for the timer Set Time dialog box Modifies the system clock setting Interrupt Interrupt Handler window Displays the states of all interrupt handler handlers and exception processing exception routines processing routine Trap exception Trap Routine window Displays the states of all trap exception processing processing routines routine Note Cannot be used when the RTOS in use was configured without enabling the manipulation of objects Rev 1 0 08 03 page 32 of 38 Table 3 2 Classification Windows and Dialog Boxes cont Window Name Functions Cyclic handler Cyclic Handler window Displays the states of all cyclic handlers Start Cyclic Handler dialog box Starts up cyclic handlers Stop Cyclic Handler dialog box Stops cyclic handlers Alarm handler Alarm Handler window Displays the state of all alarm handlers Start Alarm Handler dialog box Starts up alarm handlers Stop Alarm Handler dialog box Stops alarm handlers Extended SVC routine Extended SVC Routine window Displays the states of all extended SVC routines Result Action Result window Displays the results of object manipulation Trace RTOS Trace Diagram window e Displays the object item list e Displays trace information diagrammatic form RTOS Trace Text win
22. ervice call is issued The DX will display the results in the Action Result window as shown in figure 3 3 Rev 1 0 08 03 page 26 of 38 Ze feriu slesule pisjarspns No SVC Ercd ReturnParam Paraml Param2 Param3 Param 00001 DEL TSK E OK H 00000006 00002 TER TSK E OK H o0000007 H OOOOOOOO 00003 DEL TSK E OK H 00000007 00004 CRE TSK E DOK H o0000006 H scoo9ps4 00005 WSCR TSK E OK H OOOOOOOL H SCOOSCTIC 00006 STA_TSK E OK H OOOOOOOL H OOOOOOOO Figure 3 3 Result of Manipulation of an Object The processing of the request for manipulation of an object starts when the target is executed A request can be made for the manipulation of the object after the target has been stopped but execution Will not start until the next execution of the target The request for manipulation of the object is queued in the target memory and the release of the request from the queue is indicated by the display of the result in the Action Result window Up to four requests can be queued If manipulation of an object is requested after the target has been stopped the result is not displayed in the Action Result window until the next execution of the target Accordingly up to four requests for manipulation of an object can be made at the same time While the target is stopped The display in the Action Result window is updated with the following timing e During execution of the target cyclic e Refresh is selected from t
23. esas Technology Corporation or a third party Renesas Technology Corporation assumes no responsibility for any damage or infringement of any third party s rights originating in the use of any product data diagrams charts programs algorithms or circuit application examples contained in these materials All information contained in these materials including product data diagrams charts programs and algorithms represents information on products at the time of publication of these materials and are subject to change by Renesas Technology Corporation without notice due to product improvements or other reasons It is therefore recommended that customers contact Renesas Technology Corporation or an authorized Renesas Technology Corporation product distributor for the latest product information before purchasing a product listed herein The information described here may contain technical inaccuracies or typographical errors Renesas Technology Corporation assumes no responsibility for any damage liability or other loss rising from these inaccuracies or errors Please also pay attention to information published by Renesas Technology Corporation by various means including the Renesas Technology Corporation Semiconductor home page http www renesas com When using any or all of the information contained in these materials including product data diagrams charts programs and algorithms please be sure to evaluate all information as a total sy
24. guidance of Dr Ken Sakamura of The University of Tokyo 1 uITRON is an acronym of the Micro Industrial TRON and TRON is an acronym of The Realtime Operating system Nucleus 2 Microsoft Windows 98 operating system Microsoft Windows Millennium Edition Windows ME operating system Microsoft Windows NTE operating system Microsoft Windows 2000 operating system and Microsoft Windows XP operating system are registered trademarks of Microsoft Corporation in the United States and or other countries 3 SuperH is a trademark of Renesas Technology Corp All other product names are trademarks or registered trademarks of the respective holders Rev 1 0 08 03 page i of v Preface The Debugging Extension hereafter called the DX is software for adding the multitasking debugging functions of the Realtime Operating System hereafter called the RTOS to the High performance Embedded Workshop hereafter called the HEW This manual describes how the DX is used Please read this manual and the related manuals listed below before use so that you fully understand the DX before using it This user s manual contains the following four sections and appendixes Section 1 Introduction to the DX Section2 How to operate the DX based on an example Section 3 The functions of the DX Section 4 Precautions and restrictions Appendix Troubleshooting Be sure to read section 4 Precautions and Rest
25. he pop up menu displayed by clicking the right hand mouse button in the Action Result window e User system break stopped Rev 1 0 08 03 page 27 of 38 3 3 Displaying Service Call Trace When View gt RTOS gt Trace is selected the history of service calls is displayed in diagrammatic and textual forms as shown in figure 3 4 To use this function the RTOS you are using needs to be configured so as to enable display of service call tracing by the DX The location of the data that forms the history of service call tracing can be selected as the tool simulator debugger or emulator or the target memory Depending on the configurator in use Emulator may be displayed instead of Tool Note that this configurator can also be used with the simulator debugger The acquired information can be saved in a file and this file can be read and displayed e STU ree Diaeram Objects KNL IDLE KERNEL OTHERS TSK D O0OO6 TSK D 0007 FLG D OOO6 100Cycle PIUS rino aer Task ID PC Event Time Stamp H 80002 f66 cre _cyc 0x000b 0x8c000c54 OOOOO15827 Cycle H 80002f66 E OK 0000016262 Cycle H 8000cf98 Task start Ox00000000 0000016777 Cycle H 8000Ocfb6 cre _flg 0x0006 0x8c02217c 0000017050 Cycle H 8000Ocfb6 E OK OOOOO17371 Cycle H 8000Ocfe6 cre tsk 0x0007 0x8c02217c OOOOOL7665 Cycle H s000cfe6 E OK 0000018530 Cycle D o006 H 8000dO20 Task start 0x00000000 0000019399 Cycle H so00d032 set_flg Ox0006
26. l the following service calls cre_tsk ext_tsk cre_flg wai_flg and set_flg 2 1 2 Build The whole linkage method of HI7700 4 is used in this example Use the HEW to open the sample hios hws and select 7729_mix as the project name for the build Select Options gt SuperH RISC engine Standard Toolchain and then User from Gbr relative logic operation in the Optimize category on the C C page Select Build gt Build to start a build Rev 1 0 08 03 page 3 of 38 22 Contents of the Sample Program The sample source program is hiuser tutorial task c which includes two tasks MainTask and Task7 When the system is initiated MainTask is automatically executed because creation and initiation of MainTask is specified by the configurator with the following conditions e Task ID 6 e Initial priority 6 e Start address MainTask e Initial state READY the TA ACT attribute is specified TASK7 is dynamically created by MainTask with the following conditions e Task ID 7 e Initial priority level 7 e Start address Task7 e Initial state READY TA_ACT attribute is specified The priority of MainTask is higher MainTask creates an event flag with ID6 and Task7 and uses the service call wai_flg to wait for the event flag with ID6 Then the event flag with ID6 is deleted with the service call del_flg and MainTask is exited by the service call ext_tsk Task7 uses the service call set_flg to set the event f
27. lag with ID6 then enters an endless loop with a while 1 statement Note that this sample program is created for the user to learn the operation of the kernel and the DX and its contents in terms of processing have no meaning Rev 1 0 08 03 page 4 of 38 2 3 Executing the Sample Program 1 Start up the simulator debugger Select Options gt Debug Settings in the HEW to display the Debug Settings dialog box Then select 7729 mix from the list on the left SH3 DSP Simulator from the Target list box on the Target page and hiuser obj_big 7729_mix abs of HI7000 4 by the Add button respectively Poe w SENES obj big Session Target Options 7707 cfe a 7707 def SH3 DSP Simulator a 7707 mix Uebue Ft at Ky Elf Dwarf2 de a 7708 mix Download Modules 5 7709_cfe sd Offset Ad Former a 7709 def CC serkobi bieV7729 mixabs HODODOOOO Elf Dwarf2 a 7709 mix E 7709a_cte 3 77098 det a 7709a mix Down a sees Figure 2 1 Debug Settings Dialog Box Rev 1 0 08 03 page 5 of 38 2 Start up the DX Select RTOS HI7000 4 4DX ECX from Project gt Components Then press Load and OK Cuen agr Celllary Figure 2 22 Component Gallery Dialog Box Rev 1 0 08 03 page 6 of 38 3 Set up the simulator debugger Check Enable Timer in the Simulator System dialog box displayed by selecting Options gt Simulator System a
28. ls on these functions refer to the online help file 3 1 Referencing the States of Objects Selecting an object such as a task from the View RTOS menu will display a window which shows the state of each object type as shown in figure 3 1 Ze use Ins srsgus ExtInf Priority Wait Factor Attribute H OOOOOOOL D o002 SLP H OOOOOOOZ D OOOZ SEM TA COPl TA COPZ H OOOOOODO3 D OOOZ FLG H 00000004 D OOQOJ FLG TA COPl TA_COP2 task tex chk H 00000007 D OOOl task tex chk H 00000008 D OOOJ TA COPl TA COP2 _tpll H OOOOOOOA D OO73 TA COPl TA COP2 Task Lock Mutex Figure 3 1 Example Display of Task State Rev 1 0 08 03 page 25 of 38 3 2 Manipulating the Objects From the window for each object type the user can request the manipulation of the object to the kernel To use this function the RTOS you are using needs to be configured so as to allow the DX to manipulate the objects The manipulation of each object can be requested through the dialog box that can be opened from the pop up menu of each object window as shown in figure 3 2 Greate lask Actoni Extended Info HO Cancel Attribute C TA ASM e TA HLNG V TA ACT FAGORSI Io 2 Pa oo Su A luj r r Start Address Ma inTask hitial Priority D E Stack Size H 200 Figure 3 2 Example of a Request for Manipulation of an Object The request for manipulation of the object is sent to the target and the corresponding s
29. nd select Continue from the Execution Mode list box Ssmulabor system System Memory CPU SH3 DSP x Bit size System Call Address Enable D32 H ooo0o00o Endian j Bie Endian Response D 0000 Round To Zero bd Clock Rate Step Unit Stage Peripheral Glock Rate v Enable Timer 1 v ia amw Figure 2 3 Simulator System Dialog Box System Page Rev 1 0 08 03 page 7 of 38 4 The memory resources listed in table 2 1 must be ensured in the Memory page of the Simulator System dialog box Table 2 1 Memory Resources for the Simulator Debugger Start Address End Address Attribute H 00000000 H 0000FFFF Read H 0C000000 H OCOFFFFF Read Write Bill abo Sy SeN System Memory Memory Map OSFFFFFF lt Toon FO000FFFF se O4FFFFFF orron 05066 O5008F FF 050 osos 05018FFF qc UC000000 OCOFFFFF Road We DFFFFFFF FFFFFFFF LO HAH Figure 2 4 Simulator System Dialog Box Memory Page Rev 1 0 08 03 page 8 of 38 5 Download the load module Select hiuser obj_big 7729_mix abs from Debug gt Download Modules 2 impe pliorresriurieirieo smelled urs uo File Edit View Project Options Build PESTI Memory Tools Window Help joma o mus e g 8 MT Reset CPU jae EEE El Go F5 ET ELE iR PPID Le JE El Reset Go Shift F5 B Re as Ba Bo EF suo S isecrau u a ro dzo ua aas s 2a
30. nted 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 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 When exporting the 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 You should not use Renesas Electronics products or the technology described in this document for any purpose relating to military applications or use by the military including but not limited to the development of weapons of mass destruction 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 Renesas Electronics has used reasonable care in preparing the information included in this document
31. office equipment communications equipment test and measurement equipment audio and visual equipment home electronic appliances machine tools personal electronic equipment and industrial robots High Quality Transportation equipment automobiles trains ships etc traffic control systems anti disaster systems anti crime systems safety equipment and medical equipment not specifically designed for life support Specific Aircraft aerospace equipment submersible repeaters nuclear reactor control systems medical equipment or systems for life support e g artificial life support devices or systems surgical implantations or healthcare intervention e g excision etc and any other applications or purposes that pose a direct threat to human life 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 un
32. ps at the breakpoint which was set at the while 1 statement of Task7 Check the execution by updating the information displayed for the service call trace Since the execution is switched to Task7 after the cre tsk service call by MainTask MainTask has not yet issued the wai fleg service call Options Build Debug Memory Tools Window Help sie ae e us g Ose S a Ovo Bi e ml fotitin Sesion l um Jes FB lt MB DP S G B W wB a Tm Ts Ge Mn aaa Se s4 5 w smm Su ama m E Rees eo O 8000d024 0x8000d034 m Mw BAG s ercd set_fle 6 Oxffffffff while 1 7707 def TIM miv x1 Stop gi PO Breakpoint Build A Debug A Find in Files AL Version Control Objects KNL_IDLE KERNEL OTHERS TSK D 0006 TSK D 0007 100Cycle Task ID PC Event Time Stamp No Task H s0004d50 No Task H s0004d50 D o006 H 8000cf98 D o006 H s8000cfb D 0006 H 8000c fb6 D 0007 D 0007 D 0007 H 8000d032 cre tsk 0xO006 0x8c009c7c E OR Task start 0x00000000 gre a H s000e e6 cre tskiO0x E OK O010034611 Cycle 0010035437 Cycle 0010035933 Cycle 0010036206 Cycle 0010037992 Cycle 0010038293 Cycle Read write 163 65 Figure 2 20 RTOS Trace Diagram Window and RTOS Trace Text Window Rev 1 0 08 03 page 23 of 38 Rev 1 0 08 03 page 24 of 38 Section 3 Functions This section is an outline of the functions of the DX For detai
33. rictions before using the DX Please refer to the online help file for details of the DX functions The following is a list of the related manuals High performance Embedded Workshop HEW User s Manual The user s manual for the RTOS you are using The user s manual for the compiler you are using The hardware manual and programming manual for the microcomputer you are using Rev 1 0 08 03 page ii of iv Symbols used in this manual have the following meanings Menu gt Menu Option The menu name is on the left of the gt and the item to be selected from the menu is on the right of the gt Example File New H and D The prefix H is attached for hexadecimal integers The prefix D is attached for decimal integers If no prefix is attached a decimal integer is assumed Rev 1 0 08 03 page iii of iv Contents Section l OVerVleW ss A Lal 1 Ll Otieno o u ida TT TT TTT TTT E E TET E A TI ean wats 1 1 2 HEeMUTES s io bs ker rt as ere sj 2 1 3 Preparations for Using the DX eee eeceseceseceneceeeceeecaeeeseeseeeseeeeeesesesecaeeaessaeeaee 2 Section 2 MONA sss a Gorges natu gages vena anv a aea TETE 3 21 Configuring the Tutorlal ies estes esrov kas repaso seuss so atus te rper S Ens s os aTe sasi 3 2l CONUSUTADOE esp p p RR O Re 3 212 Build ea TE aba see E A thins aA E JM 3 2 2 Contents of the Sample Program sseesseseeseerseeesssreer
34. ruzineo emesis pureo Kei File Edit View Project Options Build Debug Memory Tools Window Help lo e HSle ne eiun ujosuoja ise Taja TEC UTEE um FE De mM E mi e Te Te mm NO Bses ecas Sue sam geass o xxi iene Wait for eventf lag B aka Ox8000cfe8 7707 cfe 0x8000cfee 7707 def TIN miv lola Build A Debug A Find in Files AL Version Control Objects KNL_IDLE KERNEL OTHERS TSK D 0006 TSK D 0007 7100Cycle Task ID Pc Event Time Stamp No Task H 80002 66 cre_cyc 0x000b 0x8c000 54 0000015828 Cycle No Task H 80002f66 E OK OOOOO16263 Cycle D 0006 H 8000cf98 Task start 0xOOOOOOOO 0000016778 Cycle D 0006 H 8000cfb6 cre flg 0xODO6 0Ox8cO2217c 0000017051 Cycle D 0006 H 8000cfb6 E OK 0000017372 Cycle D 0006 H 8000cfe6 cre tsk 0x0007 0x8c02217c 0000017666 Cycle D o006 H 8000cfe6 E OE OOOUULSSALTETCLAJ H 8000d0P wai flg OxO x c Cy D 0007 0000019400 Cycle D 0007 H 8000d032 set TIgIUxOOOG Oxffffffff 0000019664 Cycle D ANNA H ANNNANNN R NR NANNANFNISAICwelel Read write 143 65 Figure 2 12 RTOS Trace Window Rev 1 0 08 03 page 16 of 38 13 You can check the states of MainTask and Task in the Task window Select View gt RTOS gt Task to open the Task window The MainTask is in the DORMANT state While Task7 is in the RUN state RAS ribe E Embedded ores tasko kj Eile Edit View Project Options Build Debug Memory Tools Window
35. sseerrssestenrestenrrsrerrsserresesrenreseeernsee 4 2 3 Executing the Sample Pro gran ss i sape stare eare sa oiaue 5 Section 3 PURCHONS anion NUNAN RL aa 25 3 1 Referencing the States of ObjectSs sssirsssrirsersii riisist sesser srei is tenrias 25 3 2 Manipulating the Objects se isten ss een eb eecescs osteuecbentduecb svhevnabunteudebaseespebcpniueuscopeneted 26 3 3 Displaying Service Call rta e ss stiio oo cosine riski poera pe Seres ka SETE PTEE eR EES ERSE EPIS oo 28 34 LIStOf Functions 3a si sk l A kd eee 29 341 Menu Mems 4 ss nusis su eu need austin apre aaa 29 3 4 2 Windows and Dialog Boxes eeeceeee esse cneeceeeeeeeeeeeeseeeeeeseenseeesecaeseeeeeneees 30 section 4 Precautions and REStrictons 2 ccccn cvicsasstsegesssavavsedivonconnsovacessanesvnes 35 4 1 Realtime Operation of the User System and Cyclic Handler 35 42 Consistency of Displayed Content 0 eee cee cseereeeeeeeeceeeeeseeeseceaecsaecsaecaeecneseneseatees 35 Appendix A Troubleshooting sss sa a ask ca 37 A Displaying Action Result Window Results see esee sees seesseeseeeeeeeeeeeeeeeeto 37 Rev 1 0 08 03 page iv of iv Section Overview 1 1 Outline The DX is software for debugging applications which are created for the RTOS It is installed in the HEW and RTOS systems a asa Memory Tools Window Help u 0osuo se oTa ja alm Su a sasa d
36. stem before making a final decision on the applicability of the information and products Renesas Technology Corporation assumes no responsibility for any damage liability or other loss resulting from the information contained herein Renesas Technology Corporation semiconductors are not designed or manufactured for use in a device or system that is used under circumstances in which human life is potentially at stake Please contact Renesas Technology Corporation or an authorized Renesas Technology Corporation product distributor when considering the use of a product contained herein for any specific purposes such as apparatus or systems for transportation vehicular medical aerospace nuclear or undersea repeater use The prior written approval of Renesas Technology Corporation is necessary to reprint or reproduce in whole or in part these materials If these products or technologies are subject to the Japanese export control restrictions they must be exported under a license from the Japanese government and cannot be imported into a country other than the approved destination Any diversion or reexport contrary to the export control laws and regulations of Japan and or the country of destination is prohibited Please contact Renesas Technology Corporation for further details on these materials or the products contained therein The product described in this publication is based on the ITRON specifications and was developed under the
37. uctions by the installer to install the DX Configure the RTOS Configure the RTOS system you are using to match the DX For an example of configuration refer to section 2 Tutorial Initiate the HEW Initiate the HEW so that multitasking debugging is enabled after a program has been built For examples of the use of the DX refer to section 2 Tutorial For the functions of the DX refer to section 3 Functions and to the online help file Rev 1 0 08 03 page 2 of 38 Section 2 Tutorial Examples of the operation of the DX using the HI7000 4 series as the RTOS are explained in this section For details refer to the online help file The following environment is assumed e RTOS HI7700 4 e Microcomputer SH7729 e Debugger SuperH RISC engine simulator debugger 2 1 Configuring the Tutorial The sample provided by the HI7700 4 is used For details on the configuration refer to section 5 Configuration in the HI7000 4 Series User s Manual 2 1 1 Configurator The sample HCF file hiuser sh7729 7729 hcf provided by the HI7700 4 is used to create the configuration file The following configurator settings must be made e Check CFG_ACTION e Check CFG_TRACE e Set CFG_TRCTYPE to emulator trace This setting allows RTOS tracing by the DX even in the simulator e Set CFG_MAXTSKID to seven or more e Set CFG_STSTKID to five or less e Set CFG_MAXTSKPRI to seven or more e Set CFG_MAXFLGID to six or more e Instal
38. vent Time Stamp Allow Docking Open RTOS Trace Options dialog Figure 2 6 Setting RTOS Tracing Rev 1 0 08 03 page 10 of 38 7 Select Cycle from Scale Type and 100 Cycle from Scale List respectively Preece Searing Select Scale Trace Configuration Scale Type 9 Auto Refresh data Time iv Auto Link Trace Diagram C Serial Number Scale List v caren Figure 2 7 Trace Options Dialog Box Rev 1 0 08 03 page 11 of 38 8 Select Debug gt Reset Go to execute the program T Embedded Workshop E EX e 7720 mix File Edit View Project Options Build PASTA Memory Tools Window Help mio m5 e naa E remoru 3 zin amp al A Ae GR loee 2 umen gaz EFE I ith a faite Sla i rusa woo jm Grom am e me e Oe e mmm mlmo A BR mm oreo es jusosu n o xx e EI VI Steph F11 7707 cfe F TP Step Over an ae Nia P Step Out Shift F11 Step eroj E Tem navi Step Mode Connected Halt Program hitialize STE Build Debug A Find in Files AL Version zi Objects Download Modules a Unload Modules 7100Cycle No Task ID PC Event Time Stamp Reset hardware and start execution Figure 2 8 Executing the Program Rev 1 0 08 03 page 12 of 38 9 Select Debug gt Halt Program to stop the program ex
Download Pdf Manuals
Related Search