Peripheral Driver Generator User`s Manual
Contents
1. For the relationship between the RPDL and the functions output by the PDG refer to 1 3 Functions Output by the PDG and Renesas Peripheral Driver Library RPDL c Assigning an include file directory The PDG assigns the folder containing each of the header files which are necessary for the use of functions output by the PDG as an include file directory d Exclude conflicting files from building The application project created by the HEW includes a startup program Part of the program mostly the processes related to interrupt handlers may conflict with some source files to be added to the HEW so the PDG excludes such files from building For details on source files excluded from building refer to the reference manual for the MCU in use 2 User Operation To add source files to the HEW select Generate source files from the Tool menu in the PDG or click on the Generate source files toolbar button Te The confirmation message shown in figure3 18 appears Click on OK to start adding of source files to the HEW The generated source files will be registered in HEW project Make sure the destination project of source registration has been opened as an active project Make sure that the Hew Targetserver haz been set up If two or more workspaces are opened close the workspaces which does not include target project Glick OK if registration is ready are TIL Figure 3 18 Confirmation Message on Adding Sour2. R20UT0149EJO102 Rev 1 02 Page 6 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Preparations 1 4 Compatibility with PDG V 1 0x V 1 0x and V 2 xx of the PDG support different types of MCUs Thus V 2 xx cannot load project files created by V 1 0x It is also not possible to convert project files created by V 1 0x to suit the MCUs supported by V 2 xx R20UT0149EJ0102 Rev 1 02 Page 7 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Preparations 2 Preparations 2 1 Preparing the IDE 2 1 1 When the HEW is in Use If you wish to use the source files generated by the PDG to create programs or build files in the HEW install the HEW and set it up so that files for the MCU in use can be built You need to upgrade the HEW to V 4 05 01 1f the version of the HEW you are currently using 1s V 4 05 00 or earlier 2 1 2 When the CubeSuite is in Use If you wish to use the source files generated by the PDG to create programs or build files in the CubeSuite install the CubeSuite and set it up so that files for the MCU in use can be built You need to upgrade the CubeSuite to V1 02 01 if the version of the CubeSuite you are currently using is V1 02 00 or earlier 2 2 Installing the PDG Start up the installer and follow the instructions given on the screen You should have an administrator right to install the PDG If you are installing the PDG in an environment where no HEW has been instal
3. O D 0 lt A 5 C v Peripheral Driver Generator User s Manual 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 Corporation without notice Please review the latest information published by Renesas Electronics Corporation through various means including the Renesas Electronics Corporation website http www renesas com Renesas Electronics Rev 1 02 Jun 2012 www renesas com 10 11 i Notice All information included in this document is current as of the date this document is issued Such information however 1s 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 granted hereby under any patents copyrights or other intellectual property
4. Operating e RODA arterial tido torcida 10 3 1 Proce OU rca aat E 10 3 2 aaa 11 3 3 Greatine or o a aa EEEE eee eee ee 11 3 4 A A 12 3 4 1 MA tata 13 DAE ee E eee en er en ee eee ee 14 3 4 3 Peripheral Module Selection Tabs oo cccccciccccccccsccsscsscssceeeeseessecseseeceesevseeseseesesseusessesseseesessesseuseueeseseesessesseusenseeenees 14 a REO e AN tao 15 3 4 5 Ye Coxe eet O AI ee eee ee 16 JA40 Sourcerle Panas ue 17 3 9 Setting up Peripheral MOMO cuate 18 3 5 1 Base aia 18 3 9 2 Errors and Warnings td 19 3 6 Generating source FOSA ans 20 3 6 1 Starting Generation of Source Files ines 20 3 6 2 Location of Output Source Files cece ccc cece ceecesceeseeeeseesesceeseeseesesseseeseuseuseusessesseseeseuseuseusevseseeseeseuseuseusenseeanses 20 3 6 3 Changing Periperal Module Settings and Generating Source Files Again 0 ccececcecessesesessessesseseeeeeeeees 20 3 6 4 When an Error or Warning is ENCON la a taioaneneeemenchsentins meena en 20 3 6 5 Checking the Source Files ici 20 3 7 Adding Source Files to the IDE eae Neen tenon eon on nf een ae ee Ene aoe ee eee NE Eea Ea 21 3 7 1 Processes of Adding Source Files to the HEW 0 ccccssscssscesssscosssscesesssceosesresssuscenseecerssesceessecanssessenssssansoeseenseess 21 3 1 2 Processes of Adding Source Files to the CubeSuitet cccccicnicnccicnccncncnncnncnnnonanano canon cnn arc nn nana nana nana nn cana caccnnns 23 R20UT0149EJ0102 Rev 1 02 Page 4 of 27 Jun 1 2012 RENESAS Periphe
5. Ontario L3Y 9C3 Canada Tel 1 905 898 5441 Fax 1 905 898 3220 Renesas Hectronics Europe Limited Dukes Meadow Millboard Road Bourne End Buckinghamshire SL8 5FH U K Tel 44 1628 585 100 Fax 44 1628 585 900 Renesas Hectronics Europe GmbH Arcadiastrasse 10 40472 Dusseldorf Germany Tel 49 211 65030 Fax 49 211 6503 1327 Renesas Hectronics China Co Ltd 7th Hoor Quantum Plaza No 27 ZhiChunLu Haidian District Beijing 100083 PRChina Tel 86 10 8235 1155 Fax 86 10 8235 7679 Renesas Hectronics Shanghai Co Lid Unit 204 205 AZIA Center No 1233 Lujiazui Ring Rd Pudong District Shanghai 200120 China Tel 86 21 5877 181 8 Fax 86 21 6887 7858 7898 Renesas Hectronics Hong Kong Limited Unit 1601 1613 16 F Tower 2 Grand Century Place 193 Prince Edward Road West Mongkok Kowloon Hong Kong Tel 852 2886 931 8 Fax 852 2886 9022 9044 Renesas Hectronics Taiwan Co Lid 7F No 363 Fu Shing North Road Taipei Taiwan Tel 886 2 81 75 9600 Fax 886 2 81 75 9670 Renesas Hectronics Singapore Pte Lid 1 harbourFront Avenue 06 10 keppel Bay Tower Sngapore 098632 Tel 65 6213 0200 Fax 65 6278 8001 Renesas Hectronics Malaysia Sdn Bhd Unit 906 Block B Menara Amcorp Amcorp Trade Centre No 18 Jin Persiaran Barat 46050 Petaling Jaya Selangor Darul Ensan Malaysia Tel 60 3 7955 9390 Fax 60 3 7955 9510 Renesas Hectronics Korea Co Ltd 11F Samik Lavied or Bldg 720 2 Yeo
6. 0 a A a Error Example b Warning Example Figure 3 14 Error and Warning Icons To show the additional information the information icon appears Include this channel to synchronous operation ES Figure 3 15 Information Icon 2 Detailed Information Placing the mouse pointer on each icon shows the tooltip information on the error or warning 125 me ER The value must be with in the range of 8O000000MmMHz to 14 000000 bm Hz Figure 3 16 Tooltip Information on an Error and Warning 3 Definitions Table 3 5 shows the definitions of error and warning and whether the PDG will still generate source files Table 3 5 Definitions of Error and Warning Error Not allowed by hardware specification or may cause a problem Available with behavior of the PDG Warning Allowed by hardware specification but may cause unintended Not available behavior of the PDG For how to generate source files refer to 3 6 Generating Source Files R20UT0149EJ0102 Rev 1 02 Page 19 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 6 Generating Source Files 3 6 1 Starting Generation of Source Files To start generation of source files select Generate source files from the Tool menu or click on the Generate source files toolbar button E 3 6 2 Location of Output Source Files Source files are generated in the PDG s project directory and its subdirectories 3 6 3 Changing Peripe
7. Driver Generator User s Manual Operating the PDG 3 5 Setting up Peripheral Modules 3 5 1 Basic Operation Take the following steps to set up peripheral modules 1 Select the tab for a peripheral module that you wish to set up The resource pane is updated to show information specific to the selected module figure 3 13 1 2 Select a resource in the resource pane The detailed setting pane is updated to show information specific to the selected resource figure 3 13 2 3 Make settings in the detailed setting pane figure 3 13 3 Detailed setting pane Es TAL input frequency 12 5 MHz amp Sistem clock CLE Y System MO Glock Generation Circuit l Pin Resource pane Multiplication Ex TAL 2 Frequency 5 000000 MHz Peripheral module clock PELE Multiplication EXTAL 2 Y Frequency 25 000000 MHz 1 evsren icu ovac Peripheral module selection tabs Figure 3 13 Setting up a Peripheral Module R20UT0149EJ0102 Rev 1 02 Page 18 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 5 2 Errors and Warnings 1 Error and Warning Icons When there is a problem with setting of a peripheral module an error or warning icon appears on the corresponding section in the detailed setting pane resource pane and peripheral module selection tabbed page EXTAL input frequency 125 MHz E CPU interrupt priority level
8. 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 Peripheral Driver Generator User s Manual Introduction Introduction This document gives the outline of the Peripheral Driver Generator PDG V 2 xx features and basic usage For how to set up peripheral modules for each MCU specifications of functions output by the PDG and other points for caution refer to the reference manual for the MCU in use R20UT0149EJO102 Rev 1 02 Page 3 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Contents Contents la COV OPV ina 5 1 1 Fernpheral Diver eN SALTO iO ade 5 1 2 System Configuration and ProcedureS cocccininnnnnninnnn nananana nnen n nenene 5 1 3 Functions Output by the PDG and Renesas Peripheral Driver Library RPDL ccccescccssesesceseseesesesteseseeees 6 1 4 Compatibility with PDG Vy sesers eSa os eaeis 7 2 TPO A o e 8 2 1 PE A as 8 2 1 1 When the HEW IS SS supra cietea 8 2 1 2 When the CubeSuite is in Use cecssssssssssssssessssssssssssssssesescscscscscscsesesssesessssssssssssssssesescscacacacscsesesesseesseseeseseseseseseseas 8 2 2 DS PA oa 8 2 3 HewTargetServer Setting in the HEW When the HEW is in USe cccccecccsecececececsececesececeesesesesererscsesesererseseses 9 Se
9. counter value c renesas P OG proj deftault TMRYR_PG_Timer TMRUOc bool RPG Timer GetRequestFlag TMR_ Aequire and clear the TMR interrup c renesas POG2 proj default TMRYR PG Timer TMR UO bool RPG Timer StopModule TMRUO amp Shut down the TMF unit c renesas POG profdefault TMRER_PG_ Timer _TMR_UDh unti Generated Source Ale Inf r thers Figure 3 12 Source File Pane RX610 This pane shows the information on the source files generated by the PDG Nothing 1s displayed in the pane if you have created a project but have not executed Generate source files yet When Generate source files is executed the PDG generates source files based on the current settings on the selected peripheral module and the contents of this pane are updated Source files are managed in units of peripheral modules Clicking on button for a peripheral module opens a list of souce files for that module Other related files are shown on Others Table 3 4 lists the columns in the source file pane Table 3 4 Columns in the Source File Pane Name of the source file full path Generated function Name Definition of the output function Explanation of functions Action triggered by the function For how to generate source files refer to 3 6 Generating Source Files For specifications of the output functions refer to the reference manual for the MCU in use R20UT0149EJ0102 Rev 1 02 Page 17 of 27 Jun 1 2012 RENESAS Peripheral
10. results of the search are shown in the Located Components list Select a HewTarget Server whose version number is 1 07 00 or later and click on the Register button 6 Click on the Close button to close the Search Disk for Components dialog box Then click on the OK button in the Tools Administration dialog box 3 Add the HewTargetServer to the registry If you have used Install Manager Version 1 02 or earlier to install multiple HEWs and switched the active HEW to another add the HewTargetServer to the registry again as follows 1 Execute REGISTERSERVER bat stored in the HEW installation directory When you are using the Windows Vista operating system execute the file via the command prompt you have opened as an administrator R20UT0149EJO102 Rev 1 02 Page 9 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 Operating the PDG 3 1 Procedure Figure 3 1 shows the procedure from setting up peripheral modules in the PDG to adding source files to the IDE to build them For details on how to operate the IDE refer to the related documents Operations in the PDG Start up the PDG to section 3 2 Starting up Create or load a PDG project Refer to section 3 3 Creating or Loading a Project Set up periheral modules tod to section 35 Setting up Peripheral Modules Generate source files Refer to section 3 6 Generating Source Files Add source files
11. File Pane R20UT0149EJ0102 Rev 1 02 Page 20 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 7 Adding Source Files to the IDE 3 7 1 Processes of Adding Source Files to the HEW 1 Processes of adding source files Executing Add files to a HEW project not only adds source files to the HEW but also makes further setting for building the source files and RPDL The following processes are included a Add source files to the HEW C source files generated by the PDG are added to the HEW These files are displayed within the AddFromPDG folder in the HEW s workspace window Adding source files does not mean copying the C source files and header files generated by the PDG into the HEW project file directory The files are just registered with the HEW b Make setting for linkage of library files The functions output by the PDG use the API functions of the RPDL So linkage setting must be made to build source files The RPDL s library files are not copied into the HEW project file directory these files in the PDG installation directory are just registered with the HEW During this process the library link priority setup dialog box appears so that you can specify the linkage order of the library files including those you have already added For how to make settings in the library link priority setup dialog box dialog box refer to 3 7 3 Specifying the Linkage Order of Library Files
12. PDG cannot add source files if the HEW has not been started up or no workspaces are open Before executing Generate source files check that the HEW has been activated and a workspace is open If building or some related setting is attempted or already in progress in the HEW when Generate source files is executed the message shown in figure 3 20 appears to stop the process of adding source files Execute Generate source files after building or other setting has been completed Figure 3 19 Message on completion Figure 3 20 Message on HEW busy R20UT0149EJ0102 Rev 1 02 Page 22 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 6 Creating Programs Including the PDG Output Functions You can control peripheral modules by simply calling PDG output functions through a user program For details on the functions and usage refer to the reference manual for the MCU in use 3 7 2 Processes of Adding Source Files to the CubeSuite 1 Processes of adding source files Executing Add files to a CubeSuite project not only adds source files to the CubeSuite but also makes further setting for building the source files and RPDL The following processes are included 2 a Add source files to the CubeSuite C source files generated by the PDG are added to the CubeSuite These files are displayed within the AddFromPDG folder in the CubeSuite s workspace window Adding source f
13. ce R20UT0149EJ0102 Rev 1 02 Page 21 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 Specifying the Linkage Order of Library Files When all of the source files have been added to the HEW the library link priority setup dialog box appears so that the linkage order of the RPDL library and other library files can be specified Select desired library files and click on the Up or Down button to change the linkage order of those files Clicking on OK finalizes the linkage order and starts to make the setting 4 Completion of Adding Source Files When all processes are completed a dialog box shown in figure 3 19 appears 5 Points for Caution Take the following points into account when adding source files to the HEW a HewTargetServer setting To add source files to the HEW you need to set up the HewTargetServer in the HEW in advance If you execute Add source files to a HEW project with no HewTargetServer set up in the HEW source files are not added to the HEW but no error messages are displayed For details on setting up the HewTargetServer refer to 2 3 HewTargetServer Setting in the HEW b Location of the added source files Source files are added to the current project in the HEW that is active when Generate source files 1s executed Do not execute Generate source files while two or more HEWs are open c State of the HEW at the time of adding source files The
14. ct Generate source files from the Tool menu in the PDG or click on the Generate source files toolbar button 3 Specifying the Linkage Order of Library Files When all of the source files have been added to the HEW the library link priority setup dialog box appears so that the linkage order of the RPDL library and other library files can be specified Select desired library files and click on the Up or Down button to change the linkage order of those files Clicking on OK finalizes the linkage order and starts to make the setting R20UT0149EJ0102 Rev 1 02 Page 23 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 4 Completion of Adding Source Files When all processes are completed a dialog box shown in figure 3 21 appears 5 Points for Caution Take the following points into account when adding source files to the CubeSuite a Location of the added source files Source files are added to the current project in the CubeSuite that is active when Generate source files is executed Do not execute Generate source files while two or more CubeSuite s are open b State of the CubeSuite at the time of adding source files The PDG cannot add source files if the CubeSuite has not been started up or no projects are open Before executing Generate source files check that the CubeSuite has been activated and a workspace is open If building or some related
15. dio 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 under certain use conditions Further Renesas Electronics products are not sub
16. ee 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 office equipment communications equipment test and measurement equipment au
17. enu items Table 3 2 Menu Items File New Project Opens the New Project dialog box that allows you to create a new project Opens the Open File dialog box that allows you to open an existing project Close Closes the current project When the project has been modified the confirmation dialog box appears asking whether you wish to save the project Saves the current project Save As Opens the Save As dialog box that allows you to save the current project with a new name 1 to 5 project names Shows the names of the five projects most recently opened Quits the PDG View Switches a and hiding of the toolbar Status bar bar Switches Switches showing and hiding of the status bar dl and hiding of the status bar Generated source file Switches showing and hiding of the source file pane information window Character size of the The size large medium or small of characters in the source file pane is selectable from the sub menu generated source information window Tool Options Opens the Options dialog for setting up the editor used when opening the source file generated in the project Generate source files Generates source files project CubeSuite project Generate pin lists Outputs pin lists to CSV files Help About PDG2 Shows the version information Device Information Shows the device information R20UT0149EJ0102 Rev 1 02 Page 13 of 27 Jun 1 2012 RENESAS Perip
18. he PDG through a user program Always use the RPDL included in the PDG package Correct operation of the PDG is not guaranteed if the RPDL alone is upgraded Figure 1 2 shows the relationship between an API function of the RPDL function output by the PDG and user program in the case of setting up the 8 bit timer TMR in the RX610 group as an example User program R PG Timer Start TMR_U1 Set up the Call a function output by the PDG F peripheral module Function output by the PDG bool R_PG_Timer_Start_TMR_U1 void 1 PDL_TMR_CLK_PCLK_DIV_64 PDL_TMR_CLEAR_DISABLE PDL_TMR_ADC_TRIG_DISABLE PDL_TMR_DTC_TRIGGER_DISABLE PDL_TMR_OUTPUT_IGNORE_CM_A PDL_TMR OUTPUT_IGNORE CM B O 0x6000 The parameter to call the API OxB000 function reflects GUI settings TmrOf2IntFunc TmrCGma2IntFunc TmrCmb2IntFunc 7 Call the corresponding API function of the RPDL API function of the RPDLfor the RX610 bool R_TMR_CreateUnit uint8_t data1 uint32_t data2 uint8_t data3 uint16_t data4 uint16_tdata5 uint16_tdata6 void func1 void func2 void func3 uint8_t data7 Processing for control of the peripheral module Figure 1 2 Relationship between an API Function of the RPDL Function Output by the PDG and User Program It is also possible to directly call API functions from a user program For specifications of the API functions of the RPDL refer to the RPDL user s manual specific to the MCU
19. heral Driver Generator User s Manual Operating the PDG 3 4 2 Toolbar ei ewe Fl e Figure 3 5 Toolbar Some items in the main menu are also available as toolbar buttons Table 3 3 lists these items Table 3 3 Toolbar Buttons and Corresponding Menu ltems Toolbar Button Y File New File Open File Save a y E fool gt Generate source files o Pp Too a S Tool Add files to a CubeSuite project Toon eemper ooo B H Abowpoe2 o 3 4 3 Peripheral Module Selection Tabs SYSTEM TMR ro fcu ao Figure 3 6 Peripheral Module Selection Tabs RX610 Use these tabs to select peripheral modules that you wish to set up When you click on a tab the resource detailed setting and source file panes all show the information specific to the selected peripheral module Along with the tabs specific to peripheral modules the SYSTEM tab is provided for settings associated with the entire system of the MCU e g clock sources and pin functions When the PDG is reporting an error or warning in setting of a peripheral module the icon shown in figure 3 7 appears on the corresponding tabbed page For details on errors or warnings refer to 3 5 2 Errors and Warnings 3 SYSTEM lcu VO TMR scr Figure 3 7 Tabbed Page in Case of an Error or Warning The tabs vary with the MCU For details on the tabs refer to the reference manual for the MCU in use R20UT0149EJ0102 Rev 1 02 Page 14
20. iles does not mean copying the C source files and header files generated by the PDG into the CubeSuite project file directory The files are just registered with the CubeSuite b Make setting for linkage of library files The functions output by the PDG use the API functions of the RPDL So linkage setting must be made to build source files The RPDL s library files are not copied into the CubeSuite project file directory these files in the PDG installation directory are just registered with the CubeSuite During this process the library link priority setup dialog box appears so that you can specify the linkage order of the library files including those you have already added For how to make settings in the library link priority setup dialog box dialog box refer to 3 7 3 Specifying the Linkage Order of Library Files For the relationship between the RPDL and the functions output by the PDG refer to 1 3 Functions Output by the PDG and Renesas Peripheral Driver Library RPDL c Delete conflicting files from project The application project created by the CubeSuite includes a startup program Part of the program mostly the processes related to interrupt handlers may conflict with some source files to be added to the CubeSuite so the PDG deletes such files from project For details on source files deleted from project refer to the reference manual for the MCU in use User Operation To add source files to the CubeSuite sele
21. ject 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 Electronics products or if you have any other inquiries Note 1 Renesas
22. ksam Dong Kangnam Ku Seoul 135 080 Korea Tel 82 2 558 3737 Fax 82 2 558 5141 O 2012 Renesas Electronics Corporation and Renesas Solutions Corporation All rights reserved Colophon 1 1 Peripheral Driver Generator User s Manual ENESAS Renesas Electronics Corporation R20UT0149EJ0102
23. led the message shown in figure 2 1 will be displayed Click on Yes to continue installation Question The High performance Embedded Workshop CHEW is not installed To build and debug programs that use source Files generated by the Peripheral Driver Generator PDG wou need the HEW and a compiler that corresponds to the MCU in use To add the source files generated by the PDS to a HEW project through an option in the PEG the HewTargetserver must be set up The HewTargetServer is automatically set up when vou install the POG after installing the HEW IF you install the HEY after installing the PEG manually set up the HewTargetserver For how to set up the Hew TargetServer refer bo the POG User s Manual TF the Cubesuite has been installed you can use the Facility to make the POG operate in coordination with the Cubesuite Do vou want bo continue the installation Figure 2 1 Message in Cases Where No HEW has been Installed Even if PDG V2 0 is installed in an environment where V 1 0x has been installed V 1 0x will not be overwritten Thus you can also use V 1 0x after V2 0 is installed R20UT0149EJO102 Rev 1 02 Page 8 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Preparations 2 3 HewTlargetServer Setting in the HEW When the HEW is in Use The PDG is capable of adding source files to the HEW and automatically making settings on the HEW required to build the files To utilize this facili
24. n the RPDL and the functions output by the PDG refer to 1 3 Functions Output by the PDG and Renesas Peripheral Driver Library RPDL 5 The driver can be used by calling the functions output by the PDG from user program Create a program that calls the functions output by the PDG 6 Build the program e g created by using the IDE PDG output source files and RPDL to create a load module 7 The source files and RPDL will be the driver software for peripheral modules in the user system Hardware peripheral modules 5 EET E User system EAEEREN EE Ea of Figure 1 1 System Configuration and Procedures R20UT0149EJO102 Rev 1 02 Page 5 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Preparations 1 3 Functions Output by the PDG and Renesas Peripheral Driver Library RPDL The functions output by the PDG use the API functions of the RPDL included in the PDG package The RPDL is a driver API library that that is provided for each of the MCUs The API functions of the RPDL control the peripheral modules that correspond to the parameters being called Each of the functions output by the PDG internally calls the corresponding API function s of the RPDL so that the peripheral module will operate in the way that has been defined The parameters to call the API functions are automatically selected from the settings made though the GUI You can control peripheral modules by calling simple functions output by t
25. of27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 4 4 Resource Pane y 8 Bit Timer TMR ty 8 Bit Timer TMR unit O EA unit 0 Y TMR EY TMRO Y TMA EY TMRI Y unit 1 unit 1 Y TMR ma TMR Y TMR A TMR Figure 3 8 Resource Pane RX610 TMR Figure 3 9 Icon Indicating an Error or Warning This pane shows the resources e g timer channels and ports of the selected peripheral module Clicking on a resource switches the display in the detailed setting pane the information will now be specific to the selected resource For some peripheral modules other categories e g pin functions are displayed as well as the MCU resources When the PDG is reporting an error or warning in setting of a peripheral module the icon shown in figure 3 9 is attached to the resource having the problem For details on errors or warnings refer to 3 5 2 Errors and Warnings The contents of this pane vary with the MCU For details on the resources refer to the reference manual for the MCU in use R20UT0149EJ0102 Rev 1 02 Page 15 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 4 5 Detailed Setting Pane EX TAL input frequency 12 5 MHz System Clock ICLE Multiplication EX TAL 2 Frequency 25 000000 MHz Peripheral Module Cclock PELE Multiplication EXTAL ae Frequency 25 000000 MHz External Bus Clock BLE Multi
26. oject Dialog Box 2 Load an existing project 1 Select Open from the File menu in the PDG 2 Select a project file in the Open File dialog box The extension for project files 1s pg2 Clicking on the OK button opens the selected project R20UT0149EJ0102 Rev 1 02 Page 11 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 4 Window The PDG s main window appears when a project is opened The configuration of the main window is shown below Ps a PDG2 default_pd2 Eile View Tool Help b Co y System A Clock Generation Circuit Y Pin EXTAL input frequency 12 5 MHz a System clock ICLK Multiplication EXTAL 2 v Frequency 25 000000 MHz Peripheral module clock PELK Multiplication EXTAL 2 Frequency 25 000000 MHz c DMAC vo TPU TMR CMT sci RIC AD c renesas PDG2_proj default SYSTEM R_PG_Clock_S bool R_PG_Clock_Set void c renesas PDG2_proj default SYSTEM R_PG_Clock_S Set up the clocks Clock Generation Circuit f Figure 3 3 Main Window a Main menu b Toolbar c Peripheral module selection tabs d Resource pane e Detailed setting pane f Source file pane d R20UT0149EJ0102 Rev 1 02 Jun 1 2012 RENESAS Page 12 of 27 Peripheral Driver Generator User s Manual Operating the PDG 3 4 1 Main Menu ie File View Tool Help Figure 3 4 Main Menu Table 3 2 lists the m
27. plication lEXTAL e Frequency 5 000000 MHz BCLE pin output Mo output T Figure 3 10 Detailed Setting Pane RX610 Clock This pane allows you to set up details on the selected peripheral module or entire system When opened the pane shows the current settings on the hardware resources or other categories selected in the resource pane When the PDG is reporting an error or warning in setting of a peripheral module the icon shown in figure 3 11 is attached to the item having the problem For details on errors or warnings refer to 3 5 2 Errors and Warnings Ee TAL input frequency 125 MHz 3 CPU interrupt priority level 0 A a Error b Warning Figure 3 11 Icon Indicating an Error or Warning R20UT0149EJ0102 Rev 1 02 Page 16 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Operating the PDG 3 4 6 Source File Pane x c renesas POG2 projtdefault TMREYR PG Timer TMR UO bool RPG Timer Start TMR UO COtvoid Set up the TMR and start the count c renesas POG profdetault TMRE R_PG Timer TMR_UOc bool RPG Timer_HaltGount TMR_UO CO Halt the TMF count c renesas P OG proj default TMRYR_PG_Timer TMR_UOc bool RLPG_TimerResumeCountTMR_U Resume the TMR count c renesas P OG profdetault TMRER_PG_ Timer TMR_UOc bool RLPG_TimerGetCounterValue THR Acquire the TMR counter value c renesas POG profdefault TMRER_PG_ Timer TMR_UOc bool RPG Timer SetCounterValue TMR Set the TMR
28. ral Driver Generator User s Manual Preparations 1 Overview 1 1 Peripheral Driver Generator The Peripheral Driver Generator hereafter referred to as the PDG outputs functions for controlling the MCU s peripheral modules e g serial communications interface timers I O ports when the corresponding settings have been input through the GUI Calling these functions from a user program makes the peripheral modules operate in the way you have defined When the source files output by the PDG is registered with the integrated development environment IDE High performance Embedded Workshop hereafter referred to as the HEW or CubeSuite and built with a user program the control of the peripheral modules will also be implemented in the user program 1 2 System Configuration and Procedures Figure 1 1 shows the system configuration of the PDG and associated tools and the procedures 1 PDG 1 The PDG settings are saved in project files When you use project the PDG for the first time you need to create a new project or open the sample project that has been provided 2 Set up peripheral modules through the GUI of the PDG The settings will vary with the MCU 3 The PDG outputs source files based on the settings made in step 2 4 Add the output source files and Renesas Peripheral Driver Library RPDL to the IDE The functions included in the source files only work in combination with the RPDL For the relationship betwee
29. ral Module Settings and Generating Source Files Again Executing Generate source files generates all source files associated with the periperhal modules for which settings have been made If any of the source files has the same name as an existing source file that has already been generated in the current project the older file is overwritten i e the older file is replaced with new one regardless of whether peripheral module settings have been changed or not since the previous generation When Generate source files is executed after the settings for a peripheral module at the time of previous generation have been cleared the existing files associated with the cleared settings are deleted Note however that these files are not automatically removed from the IDE You need to manually remove obsolete files from IDE projects 3 6 4 When an Error or Warning is Encountered When there are one or more errors in peripheral module settings the message shown in figure 3 17 appears indicating that Generate source files 1s not executable Check the location of the error and modify the setting A There ls an error in a set item The source generation cannot be executed Figure 3 17 Message When an Error is Encountered 3 6 5 Checking the Source Files As soon as Generate source files is executed the source file pane displays the source files and functions For contents of the source file pane and how to handle them refer to 3 4 6 Source
30. 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 but Renesas Electronics does not warrant that such information is error fr
31. setting is attempted or already in progress in the CubeSuite when Generate source files is executed the message shown in figure 3 22 appears to stop the process of adding source files Execute Generate source files after building or other setting has been completed Failed to register the source files A The source files have been registered successfully The registration process has been canceled When the CubeSuite project is being built retry after building is Finished Figure 3 21 Message on completion Figure 3 22 Message on CubeSuite busy 6 Creating Programs Including the PDG Output Functions You can control peripheral modules by simply calling PDG output functions through a user program For details on the functions and usage refer to the reference manual for the MCU in use R20UT0149EJ0102 Rev 1 02 Page 24 of 27 Jun 1 2012 RENESAS Peripheral Driver Generator User s Manual Publication Date Jun 1 2012 Rev 1 02 Published by Renesas Electronics Corporation Edited b Microcomputer Tool Development Department 1 r Renesas Solutions Corporation ENESAS SALES OFFICES Renesas Electronics Corporation http www renesas com Refer to http www renesas com for the latest and detailed information Renesas Hectronics America Inc 2880 Scott Boulevard Santa Clara CA 95050 2554 U SA Tel 1 408 588 6000 Fax 1 408 588 6130 Renesas Hectronics Canada Limited 1101 Nicholson Road Newmarket
32. to the IDE Refer to section 3 7 Adding Source Files to the IDE Operations in the IDE Start up the IDE Create or load a IDE project Create a program Run and debug the program Figure 3 1 Operating Procedures in the PDG and IDE R20UT0149EJ0102 Rev 1 02 Jun 1 2012 RENESAS Page 10 of 27 Peripheral Driver Generator User s Manual Operating the PDG 3 2 Starting up Select Peripheral Driver Generator 2 from the Windows Start menu 3 3 Creating or Loading a Project MCU settings created with the PDG must be saved in a project Create a new project or open an existing project 1 Create a new project 1 Select New Project from the File menu in the PDG 2 Make necessary settings in the New Project dialog box and click on OK Items shown in the New Project dialog box are listed below The settings made in the New Project dialog box cannot be modified after a project has been created Table 3 1 Items in the New Project Dialog Box Description Project Name Enter the name of a new project Specify the directory in which you wish to create a project CPU Type Select the series group and type names of the MCU that you wish to use Project new Project name default Directory cMenesas PDG2_proj Type of CPL Series RXBOO Group Ate O r ae Rarser Package PLOPOI4KA A ROM capacity OM byte s ARAM capacity 120 byte s Cancel Figure 3 2 New Pr
33. ty to add source files to the HEW you need to set up the HewTargetServer in the HEW Follow the procedures below to check the current HewTargetServer setting and modify it if necessary If multiple HEWs have been installed select one that you wish to add source files to For how to add sources from the PDG to the HEW refer to 3 7 Adding Source Files to the HEW 1 Check the HewTargetServer setting Take the following steps to check the HewTargetServer setting 1 Select Administration from the Tool menu in the HEW 2 Click on Extension Components in the Tools Administration dialog box and see if the HewTargetServer is included in the list Also check the version number of the HewTargetServer 2 Set up the HewTargetServer When the HewTargetServer is not included in the list or the version number is earlier than 1 07 00 take the following steps 1 Select Administration from the Tool menu in the HEW with no workspaces open 2 If the version number of the HewTargetServer listed under Extension Components in the Tools Administration dialog box is earlier than 1 07 00 select the HewTargetServer and click on the Unregister button 3 Click on the Search disk button in the Tools Administration dialog box The Search Disk for Components dialog box opens 4 Enter the name of the directory in which the HEW has been installed and click on the Start button The PDG starts searching for components 5 The
Download Pdf Manuals
Related Search