"user manual"
Contents
1. KE File Edit Navi Search Project Run Window Help Welcome ES ti Welcome to MicroEJ Getting Started B3 Manage Licenses E Try out Java Examples View Documentation Manage Platforms Create New Project MICR EJ Figure 2 1 MicroEJ Welcome Page Insert your USB dongle e Press the Manage Licenses button Hardware dongles are automatically detected when the MicroEJ preferences main page is shown e Click on Refresh when a new hardware dongle is plugged in NI Na The MicroEJ preferences page is also accessible from the menu Window gt Preferences gt MicroEJ MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 3 Overview 3 1 Platforms Several Java platforms JPF are pre installed in MicroEJ e Open MicroEJ Open the welcome page Help gt Welcome Press the Manage Platforms button E Preferences Available Platforms General E Add or remove platforms Ant C C Platforms and Packs Cache Name Version License Select All Hel X elp P Platform X X X E Install Update Ji j Java Ti Import MicroEJ Available Platforms RES Naming Convention Plug in Development Run Debug Team Restore Defaults Malidatian M Figure 3 1 Available Platforms This Available Platforms page shows all platforms installed in MicroEJ Each platform has its own characteristics and specific behavior Note N e The Available2. JavaTM all Java based marks and all related logos are trademarks or registered trademarks of Sun Microsystems Inc in the United States and other Countries Other trademarks are proprietary of their authors MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started Table of Contents J NO CCO Ee RE N oe Sd a OE N Go ee GR RD 5 1 1 Entended Andien E uoo Ra ANIA RE ANUS quU DE A adita EDS aad e MEN 5 1 2 5359 CODE Er oe SE Ee N Sok dG e a TTT 5 iS RI sada CCUM SIG Si tse tte E T LI UU r GE Ee D LA PETMMOLOS si MEE N Ee E DOJ NN RN A a De GE INNA 5 Be ROGUE GR Na Dad a A ON De 7 OJ pe EE 8 Duls Mr ure naa D DD ND AE EG GE DD OG EG MANA 8 Sal zin SS RA GOO ua ER EE EG e aa ad 8 Create and Use Your First Java Platform sss essscssscessscssscscstessscssstesnsessssos 9 Run an Example on the Simulated Java Platform SimJPF ke 11 S is Greater CRI RTT D o T T T GE He GEN NNN A 11 SM UTI ESAT T vines tard terr PP 12 Run the Example on the YLCDRX63N WQVGA Board EMDJPF eeeeesse 13 6 1 Compile Java ADDICA ON ia con e best eR Ud abe Ge E E N ERAM KAN ENG e deu pin ANE iUd 13 6 2 Link and Deploy Java Application oor ERE elo rot PR Pan FLU TE DON Se AA 13 AIDE rp a E A E M IH M EE LI I II RU TERE 15 LLOYDNGDRX6O3N Technical Specificaions es rere PE E rex e e e vim cut dip Eres 15 Z2 DOMO SEUD sss EN E E IO
3. Platforms page is automatically populated by the work in progress JPFs The Available Platforms page is also accessible from the menu window gt Preferences gt MicroEJ gt Available Platforms 3 2 Renesas RX GCC This Java platform architecture has been designed to be extended to run on any board with a Renesas RX CPU The Section 4 Create and Use Your First Java Platform uses this platform to run your first Java application on your first extended platform This platform requires the Renesas E2Studio C compiler to create the final binary file for a Java appli cation MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 4 Create and Use Your First Java Platform The aim of this chapter is to create a platform from a Java platform architecture The platform will then be used to run a Java application in subsequent chapters Although it is possible to use MicroEJ to create every aspect of a platform in accordance with specific requirements in this chapter we will use a pre packaged example of a platform that is already configured for the YLCDRX63N WQVGA e Open MicroEJ Open the Java Platform Example wizard File New Java Platform Select the Java platform architectue Renesas Rx GCC from the combo box A list of examples is available Create a Java Platform Configuration n EM Create a Java Platform lt gt Create a new Java Platform configuration Target Extensible J
4. files to extend the MicroUI Image Gen erator tool AREADME file and a platform configuration file are automatically opened The README file explains the aim of the projects and how to launch an example We recommend you follow the steps described in this document and refer to the README file for more detail and latest changes The platform needs to be built with several additional modules Java and natives libraries scripts etc e From the platform configuration file click on the link Build Platform P Overview Java Platform Properties Platform Content General information about this Java platform The content of the platform is composed of two parts Device MyBoardl Fi Environment select the Java platform environment architecture and version n a N Modules select modules to import in the Java platform Version 1 0 0 Provider MyCompany Platform Configuration Once the content of the platform is chosen it can be configured 2 Configuration Each module can be configured creating a folder with its name along the platform file It could contain MicroEJ Min Version 1 7 0 e an optional module properties file e optional module specific files and folders Modifying one these files requires to build the platform again Build Generate and test the Java platform IP Build Platform The new platform is now available and visible in Available Platforms Figure 4 3 Platform Configuration File The build starts Th
5. Lite RX and the YLCDRX63N WQVGA Plug a USB cable between the PC and YLCDRX63N WQVGA Plug a USB cable between the PC and the Segger J Link Lite RX connector This allows you to program the board using the Segger J Link Lite RX 15 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 7 2 4 Summary J4 connector JTAG connector USB power supply Dl i HTETDIMO231 n Li Figure 7 1 Board configuration 7 3 Demos Installation This chapter explains how to install extra demos and application notes They have to be imported as a standard Eclipse project archive file Go to the website http www is2t com download Download zip files containing one or more demos Open MicroEJ Open the wizard Import File Import Select the item General Existing Projects into Workspace Click on Next Select the downloaded zip file 16 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 8 Document History 17
6. MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started S27 Reference TLT 0680 MAN PlatformGettingStarted Y_LCDRX63N WQVGA Revision A Architecture Renenas RX Compiler Renenas E2Studio Board YLCDRX63N WQVGA MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started Confidentiality amp Intellectual Property All right reserved Information technical data and tutorials contained in this document are confidential secret and IS2T S A Proprietary under Copyright Law Without any written permission from IS2T S A copying or sending parts of the document or the entire document by any means to third parties is not permitted including but not limited to electronic communication photocopies mechanical reproduction systems Granted authorizations for using parts of the document or the entire document do not mean they give public full access rights IceTea amp IS2T amp MicroJvm MicroEJO S3 SNI SOAR Drag Emb Drop IceOS Shielded Plug and all associated logos are trademarks or registered trademarks of IS2T S A in France Europe United States or others Countries JavaTM is Sun Microsystems trademark for a technology for developing application software and deploying it in crossplatform networked environments When it is used in this documentation without adding the TM symbol it includes implementations of the technology by companies other than Sun
7. N OE 15 Za Demos Mistallatior sss no a kO 16 Document ISTON Vs Lay r S y alae 17 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started List of Figures Nimm i len a eyn AA UE 6 MICIOE Welcome Base usa sinne A H e la ewane LU ayy n d w na keweke G NE AO 7 Available Plat orm S sss E a lie datus OE data b Sata 8 Java Platform Configuration page L yan shara asd aa k d be rere 9 Java Platform Configuration page 2 ss ssssessscesscesasesascenaseeaseenasssascesseessses 10 Platform Configuration PIO suuo no E A VOR DOK VEO Ka n Pad 10 New MicroEJ Example Project page l es sssesscesscesscesseessessseessenscenseentesssess 11 New MicroEJ Example Project page 2 kek kek kek kek arara cera crer eres ens 12 MVC Example on th Simulator asiro KI gran Cada ugue ka RO AS a KO 12 Renesas EZStudio Project NG siu ERR S DA a A ULO 13 CD re KE a O UE 14 BOLA COUT UAL OM uy o ya nin RAN a KO NUNA NE 16 List of Tables Z4 XECGDRX63N Pechrnical SDecifiCdtlOHS vu eui su sivan oU ga Een l Ha ee K k n ene tees 15 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 1 Introduction 1 1 Intended Audience The intended audience for this document are developers who wish to develop their first Java appl
8. NE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started Q Note If an error occurred on Renesas E2Studio path location please update the Ant property e2studio in the e2studio xml file with the right Renesas E2Studio path location The remaining steps are performed within Renesas E2Studio El C C ezstudio Mn sees serves n File Edit Source Refactor Navigate Search Run Project Window Help r r ID v ia Z rv amp rv rv rv i v rv Q Project Explorer 5 Eu 4 i SHIPWareExampleUCosIII s Includes Za Micrium amp gt MicroEJ Em Renesas Em Serious Ga SHIPWareExampleUCosIII Release launch Figure 6 2 C IDE e Build the Renesas E2Studio project by right clicking on the project in the Project Explorer and se lecting menu Build project The project is compiled and linked Ensure that e The YLCDRX63N WQVGA board is connected via JTAG cable to the Segger J Link RX e The YLCDRX63N WQVGA board is connected via a USB cable to the PC The Segger J Link RX is connected via USB cable to the PC Deploy and run the application Right click on the project launcher launch file in your project Run Debug Configurations SHIPWareExampleUCosIII Release The application downloads and starts this takes approximately 15 20 seconds The result of the exe cution is shown on the display of the board Congratulations you have built the Java application on
9. PF Platform v v Create a platform from an example or a template 4 2 Platform 4 BA Board Iz Basic Basic SNI and SP Iz Basic Ul amp Full 4 B Template Iz Java Platform Template Includes MicroEJ Java Virtual Machine CLDC EDC B ON SNI SP NLS ECOM COMM and embedded UI extension MicroUl MWT Comes with a BSP example for the board 2 Back Next gt Finish Cancel Figure 4 1 Java Platform Configuration page 1 e Select the example configuration Full in menu YLCDRX63N WQVGA e Click on Next Give a name which be used as prefix for all platform projects For instance MyPlat form MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 9 Create a Java Platform e EE Create a Java Platform mmm Create a new Java Platform Project name MyPlatform V Use default location C Users JPF Properties Device Name MyPlatform Version 1 0 0 Provider MyCompany Vendor URL MicroEJ Min Version 1 7 0 Back Ned Cancel Figure 4 2 Java Platform Configuration page 2 e Click on Finish The selected example is imported as several projects prefixed by the given name e example bsp contains a ready to use package for Renesas E2Studio on YLCDRX63N WQV GA board e example configuration contains some files to configure the platform automatically e example microuiGeneratorExtension contains some
10. Simulator 12 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 6 Run the Example on the YLCDRX63N WQVGA Board Emb JPF 6 1 Compile Java Application e Open the run dialog Run gt Run configurations and select the MicroEJ launcher MyMVCSamp1e EmbJPF Click Run the application is compiled and the compilation result an ELF file is copied into a well known location in the workspace The Renesas E2Studio BSP project will look for it there when it performs the final link 6 2 Link and Deploy Java Application The aim of the final step is to Compile the BSP project such as drivers Link the BSP and the others libraries MicroJvm Virtual Machine native stacks Java application Deploy the full application on the YLCDRX63N WQVGA board N Note This final step uses a C IDE this document assumes the use of the Renesas E2Studio e In MicroEJ expand the project example bsp and the folder MicroEJ e2studio A Ant file e2studio xml is available 4 12 MyPlatform bsp gt gt Micrium a MicroEJ 4 e2studio SHIPWareExampleUCosIII e2studio xml El readme txt Inc includeAPIs lib E src Renesas l Serious E LEGAL txt SHIPWareExampleUCosIll Release launch Figure 6 1 Renesas E2Studio Project File e Right click on this file and select Run As gt Ant Build to open the C IDE Renesas E2Studio 13 MicroEJ O
11. ck Input Events gt Filters Iz Fonts LS Hello World iS Images te LCD Iz LEDs Iz Layers This example shows how to create and use a MVC design pattern 2 lt Bacl Next Finis Cancel Figure 5 1 New MicroEJ Example Project page 1 Click on Next The next page suggests a name for the new project 11 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started New MicroEJ Example Project OE Create a MicroEJ Project Enter a project name Project Name MyMVCSample SN 2 lt Back Next gt Cancel Figure 5 2 New MicroEJ Example Project page 2 e Click on Finish The selected example is imported into a project with the given name The main class the Java class which contains the main method here MVCDemo java is automatically opened N Note Note The New Java Example Project wizard is also accessible from the menu File gt New Java Example 5 2 Run Example e Open the run dialog Run gt Run configurations and select the MicroEJ launcher MyMVCSam ple SimJPF e Click on Run the application starts It is executed on the simulator SimJPF of the selected JPF YLCDRX63N WQVGA MyPlatform RXx_GCC A picture of the board appears The result of the execution is shown on the display of the board The touchscreen can be used to adjust the division of the screen areas Hi YLCDRX63N ee BE RENESAS o YLCORX63N Figure 5 3 MVC Example on the
12. ers or BSP and some Java libraries that characterize an application domain Depending on these libraries some specific tools are provided too Every embedded JPF EmbJPF has a sibling platform that simulates it on a PC called the SimJPF The SimJPF exactly mimics the semantics of the JPF The SimJPF can be extended with Mocks to simulate the native C Ada asm code of the JPF such as drivers or to connect hardware to the workstation Mocks can feed the SimJPF with real external stimuli so that the Java application can behave as if it was running on the EmbJPF SimJPF allows the design and functional testing of an embedded Java application in a development environment MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started Java Kickstart Platform Tool Flow ee ey MicroEJ SDK Application software Java Virtual Machine Embedded Libraries BSP Library Executable Binary elf hex out Hardware Figure 1 1 Java Platform Tool Flow MicroEJ SDK Application software Java Virtual Machine amp Embedded Libraries C C IDE BSP Source Executable Binary elf hex out Hardware Platforms Flow MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 2 Product Registration The development version of MicroEJ uses hardware activation keys e Open MicroEJ Open welcome page Help Welcome e MicroEJe
13. ication with MicroEJ Notes e This document is for YLCDRX63N WQVGA board e This document is not a user guide for the C development environment used for the final application link Please consult the supplier of the C development environment for more information e Please visit the website http www is2t com get started for more information about MicroEJ amp ONE products platforms videos examples application notes etc 1 2 Scope This document describes step by step how to start your development with MicroEJ e Register your product e Understand the package Create your own platform e Run a Java application on the simulation platform SimJPF and on the embedded platform EmbJPF 1 3 Prerequisites PC with Windows XP or later The MicroEJ amp ONE environment must be installed e YLCDRX63N WQVGA board The Segger J Link Lite RX utility normally installed as part of the Renesas E2Studio installation A GNU C development environment The examples are packaged ready to run using the Renesas E2Studio C IDE which this document assumes has been successfully installed Please visit the Re nesas website to obtain a version of the Renesas E2Studio C IDE Note however that developers are free to use a different CDT packaging 1 4 Terminology A Java platform JPF is a library that at a minimum embeds a JVM the MicroJvm virtual machine from IS2T some native libraries also called firmware or driv
14. is step can take several minutes You can see the progress of the build steps in the Eclipse console Please wait for the final message BUILD SUCCESSFUL At the end of the execution the platform is fully built for the YLCDRX63N WQVGA board and is ready to be linked into the Renesas E2Studio project The name of this platform is YLCDRX63N WQVGA MyPlatform RXx GCC The platform is now ready for use and available in the Platforms list of your MicroEJ repository Windows Preferences MicroEJ 10 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 5 Run an Example on the Simulated Java Platform SimJPF The aim of this chapter is to create a simple Java application from a built in example This example will initially be run on the simulator SimJPF of the platform created in the previous chapter Then in the next chapter this application will be compiled and deployed on the YLCDRX63N WQVGA board using the EmbJPF 5 1 Create Example e Open MicroEJ Open the welcome page Help welcome Press the Try out Java Examples button to open the New Java Example Project wizard e Select the Java platform YLCDRX63N WQVGA MyPlatform RXx GCC from the combo box e Select the example Examples gt MicroUI gt MVC New MicroEJ Example Project o EE Select an Example v Target JPF Platform 4 Samples m BON m ECOM COMM m EDC m Getting Started m MWT 4 BA MicroUl Iz Che
15. your own platform 14 MicroEJ ONE Build Your First Java Platform On YLCDRX63N WQVGA Getting Started 7 Appendix 7 1 YLCDRX63N Technical Specifications The following table illustrates some board features used by the Java platform It doesn t list all board features such as all available memories on the board MCU architecture RX RX63N MCU Clock speed 100MHz 165 DMIPS Internal Flash 2 MBytes Internal RAM 128 KBytes External RAM 16 MBytes SDRAM Table 7 1 YLCDRX63N Technical Specifications 7 2 Board Setup This section explains how to configure and connect the YLCDRX63N WQVGA board 7 2 1 Jumpers and Switches Set all jumpers and switches to their default settings please refer to the YLCDRX63N WQVGA documentation Renesas documentation YLCDRX63N WQVGA Embedded GUI Solution Kit User Manual 7 2 2 Power Supply Select your power supply mode please refer to the YLCDRX63N WQVGA documentation YLCDRX63N WQVGA Embedded GUI Solution Kit User Manual 7 2 3 PC Board Connection Plug a serial cable between the PC and the board serial communication interface channel 6 SCI6 This channel is available on J4 connector pins 17 and 18 Note the PC s COM port it will be used later in the application launcher This allows all traces to be received from the board and printed on the console Use a simple serial cable with only data lines crossed and signal ground Plug a JTAG cable between the Segger J Link
Download Pdf Manuals
Related Search