"user manual"
Contents
1. 15 7 95 T N S ND iita iate itn DN AA AAA AAA AA Daci datae stra ta Sulla cd 16 7 4 Demos InstalldtlOEP na nA eran Deve E Dien Mes e toe od netta A AAA 17 s BreeviiduiEsioaA e cc 18 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started List of Figures Nimm rr UE 6 MICroEJ Welcome PS Cy esteem ln n na kelay Ne an Sli teen eh Asus dul abo tuia Fate uu e NE or daa 7 Available Plat orm S cedet ecuaves ea SEES oS a lie datus e osudu adc md oncle data aeons incu oaa acd 8 Java Platform Configuration Page L cetero cx a ERE EORR aS USER VE QU SUO SA MGE RNV EIN A uU OR Ue EUR kel 9 Java Platform Configuration page 2 K A h E keke keke k eee keke kek k k K KK K KK KK KK KA 10 Platform Configuration Hil AA 10 New MicroEJ Example Project page 1 MK K E keke ek keke k k k KK KK KAKA 11 New MicroEJ Example Project page 2 ccccsccseecssecesccscceseccecceeesasecsscesscoseceeesaseeasensees 12 MG Example on the SimiuldtOE i55 Pay kkin A Pay k KENE ka Ked KOR B N Ak ad ea NN Feu saec ke WAR 12 Keil TEVAIGION Project BIG uus asics abe n CN p pe n O al iS dump Led dye eina n eh 9 0 w porn en KAWA 13 a COL J len a eae pera e Y an nn anne ene N e y SO n SA ege eee nO KORA 14 sg BD E O 15 isole Mee nue m T U 16 ULINK Probe Conn Ural gt 53 42. Install Update J Java Ti Import MicroEJ Available Platforms Naming Convention Plug in Development Run Debug Team Restore Defaults Malidatian Uninstall Figure 3 1 Available Platforms This Available Platforms page shows all platforms installed in MicroEJ Each platform has its own characteristics and specific behavior qj Note The Available Platforms page is automatically populated by the work in progress JPFs The Available Platforms page is also accessible from the menu Window Preferences MicroEJ Available Platforms 3 2 ARM Cortex M3 ARMCC This Java platform architecture has been designed to be extended to run on any board with a COR TEX M3 based 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 Keil n Vision C compiler to create the final binary file for a Java application MicroEJ ONE Build Your First Java Platform On STM3220G EVAL 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 pla
3. E S ERU ANNA 17 List of Tables 7 1 STM3220G EVAL Technical Specifications ccccccessccseccesscensccsccenscesscceuseesecseeseessenes 15 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started 1 Introduction 1 1 Intended Audience The intended audience for this document are developers who wish to develop their first Java application with MicroEJ Notes This document is for STM3220G EVAL board 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 Please visit the website http www is2t com get started for more information about MicroEJ ONE products platforms videos examples application notes etc 1 2 Scope This document describes step by step how to start your development with MicroEJ Register your product Understand the package Create your own platform e Runa 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 STM3220G EVAL board The ST LINK utility normally installed as part of the MicroEJ installation e Keil pn Vision 4 60 or higher The Keil pn Vision evaluation version is 32Kb code size limited To get a Keil p Vision evaluation license for MicroEJ please visit
4. See the illustration below DB 9 female ajea gr Figure 7 1 Serial Cable 15 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started 7 2 4 Summary ST LINK V2 connector ia cp T 4 ar To PC COMX 4 Power Supply Mode Figure 7 2 Board configuration 7 3 Keil uVision 7 3 1 Project Compatibility The p Vision projects available as Java platform examples are compatible Keil p Vision 4 60 5 0 Several options have to be updated manually to be compatible with Keil pn Vision 5 x such as the choice of the microprocessor 7 3 2 Probe Configuration This chapter explains how to use a ULINK probe instead of using the ST LINK V2 This step is useful if you use Keil u Vision 4 5 x as older versions of Keil u Vision do not manage the ST LINK V2 probe well e Open a Keil y Vision project e Open the menu Project gt Options for Target your target Open the tab Utilities Select the item ULINK2 ME Cortex Debugger in the combo box of the menu Use Target Driver for Flash Programming 16 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started Options for Target Device Target Output Listing User C C Asm Linker Debug Utities Configure Flash Menu Command Use Target Driver for Flash Programming Settings I Update Target before Debugging C Use Extemal Tool for Flash Programming Figure 7 3 ULINK Probe Configurati
5. welcome Press the Try out Java Examples button to open the New Java Example Project wizard Select the Java platform STM3220GEVAL MyPlatform CM3 ARMCC from the combo box e Select the example Examples gt MicroUI gt MVC New MicroEJ Example Project 9 ES 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 Check Input Events gt Filters LS Fonts LS Hello World iS Images Iz LCD Iz LEDs Iz Layers This example shows how to create and use a MVC design pattern 2 Back 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 STM3220G EVAL Getting Started New MicroEJ Example Project o ES Create a MicroEJ Project Enter a project name Project Name MyMVCSample ez lt Back Next gt Cancel Figure 5 2 New MicroEJ Example Project page 2 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 EN Note Note The New Java Example Project wizard is also accessible from the menu File New gt Java Example 5 2 Run Example e Open the run dialog Run gt Run configurations andselect the MicroEJ launcher
6. the display of the board Congratulations you have built the Java application on your own platform 14 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started 7 Appendix 7 1 STM3220G EVAL 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 Cortex M3 STM32F207IGH6 MCU Clock speed 120MHz 150 DMIPS Internal Flash 1 MBytes Internal RAM 128 KBytes External RAM 2 MBytes SDRAM Table 7 1 STM3220G EVAL Technical Specifications 7 2 Board Setup This section explains how to configure and connect the STM3220G EVAL board 7 2 1 Jumpers and Switches Set all jumpers and switches to their default settings please refer to the STM3220G EVAL documenta tion STMicroelectronics documentation UM1461 User manual STM3220G EVAL evaluation board 7 2 2 Power Supply Select your power supply mode please refer to the STM3220G EVAL documentation STMicroelec tronics documentation UM1461 User manual STM3220G EVAL evaluation board 7 2 3 PC Board Connection Plug a serial cable between the PC and the board USART 3 connector CN16 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
7. the website https is2t microej com Keil Vision 4 5x is sufficient except for deploying your application on the board using a ST LINK V2 Refer to the appendix to use a ULINK probe instead of using the integrated ST LINK V2 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 drivers 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 STM3220G EVAL Getting Started Java Kickstart Platform Tool Flow 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 Vi
8. 16 static U64 javaTaskStack MICROJVM_STACK_SIZE 8 a Es uu 17 5 microui bsp c 3H void vm amp putchar c 19 E sensors c 20 __ task void javaTask void EE sram_driver c 21 stm32f2xx_it c 22 task void javaTask void time hardware timer c 23 int32 vt err 8 acs 24 int32_t exitcode 25 P touch listener c 26 printf VM START n Gig STM32_EVAL 27 err SNI startVM vm 0 NULL fj STM32F2xx StdPeriph Driver 28H if err lt 0 1 H E CMSIS 29 Error occurred j MDK ARM 30 El if err LLMJVM E EVAL LIMIT 2 8 libs 31 printf Evaluation limits reached Wn 8 mjvm lib E rn m 339 else amp alpha numeric display lib i audio lib 34 printf VM execution error err d n err 10 35 display lib 36 l display_decoder_bmpm lib 37H else amp display decoder png lib 38 NM execution ends normally X input lib 39 exitcode SNI getExitCode vm l inp di NI javaapp o 40 printf VM END exit code d n exitcode leds lib J seli l 43 SNI_destroyVM vm E Project Books Functio Oy Templa 4 m ST Link Debugger Figure 6 2 C IDE e Build the Keil pn Vision project by clicking on the menu Project gt Build target The project is compiled and linked Deploy the link result on the STM3220G EV AL board by clicking on the menu Flash Download The application starts The result of the execution is shown on
9. 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 STM3220G EVAL Getting Started Table of Contents Ttt CUE ii dedo alee blister em ont Bit deovtese dn etn bai eaten ag ga set ates eae eee NE 5 1 1 Enterdecd Wi GI C eeii E E E TAE a E 5 TE 2a COD sar E E E T AA K en E SEAN K 5 iS R sada CCUM sE ND E T LI UU NEN 5 E LerminoloBy oaee qure t e AA AAA ATE S E Ke AAA 5 Be ROGUE GR Na ALOU S daos ipee da idR Ede aa 7 MO Jud pe EE 8 SAP PT AIL OTIS Ay TERT AA 8 2 2 ARM Cortex M3 ARMGC yn dekar P l rn I n e ea ee ENS Dee pda Sagen ea Gun Re e EIE TP ay Redes 8 Create and Use Your First Java Platform ccccccescceseccoeccenscceccensceecceuscesscsauscessesseeeeuss 9 Run an Example on the Simulated Java Platform SimJPF ke 11 SEG SUM CRIT T TO TT AINA 11 SP nns cnni cp ET 12 Run the Example on the STM3220G EVAL Board EmbJPF ue 13 oL Conmpile Java ADDIICaLt O eoi ce BTE canteen cheng Fux Wad ERO REO OR a i e k 9 2 WERA DI 13 6 2 Link and Deploy Java Application s5 yi e EOE Meteo rho E Pan FLU TE oleae eae 13 PEE A DPE II IDE oceani Maa WA MN eret tnm Meu E TE EE I IM II RU t A 15 7 1 STM3220G EVAL Technical Specifications eese 15 PME BOA SEUD CERT CH
10. MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started S27 Reference TLT 0673 MAN PlatformGettingStarted STM3220G EVAL Revision B Architecture ARM Cortex M3 Compiler Keil uVision Board STM3220G EVAL MicroEJ ONE Build Your First Java Platform On STM3220G EVAL 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 IS2T amp MicroJvm MicroEJ 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 Java 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 symbol it includes implementations of the technology by companies other than Sun Java all
11. MyMVCSam ple SimJPF Click on Run the application starts It is executed on the simulator SimJPF of the selected JPF STM3220GEVAL MyPlatform CM3_ARMCC 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 Bl STM32x0GEVAL Reed STM13220G JAVA ILLE dard n AA m o F 3 ur Da j di T iS ic Beye r oes 53 e Figure 5 3 MVC Example on the Simulator 12 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started 6 Run the Example on the STM3220G EVAL Board EmbJPF 6 1 Compile Java Application e Open the run dialog Run gt Run configurations and select the MicroEJ launcher MyMvCSample 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 Keil p Vision 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 STM3220G EVAL board qj Note This final step uses Keil p Vision n MicroEJ expand the project example bsp and the folder Project MicroEJ MDK ARM A Keil y Vision project file Pr
12. me along the platform file It could contain Micro Min Version 1 7 0 anoptional module properties file optional module specific files and folders Modifying one these files requires to build the platform again uild enerate and test the Java platform 2 PP Build Platform The new platform is now available and visible in Available Platforms Figure 4 3 Platform Configuration File The build starts This 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 STM3220G EVAL board and is ready to be linked into the Keil p Vision project The name of this platform is STM3220GEVAL MyPlat forn CM3 ARMCC 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 STM3220G EVAL 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 STM3220G EVAL board using the EmbJPF 5 1 Create Example Open MicroEJ Open the welcome page Help
13. oject uvproj is available 4 l gt MyPlatform bsp gt htmresc Libraries 4 amp Project 4 z MicroEJ inc gt includeAPIs amp lib 4 amp MDK ARM 2 Project STM322xG EVAL dep gt Project uvgui is2t 2 Project uvopt amp Project uvproj src STM32F2xx StdPeriph Template gt Utilities MCD ST Liberty SW License Agreement V2 pdf EO Release Notes html Figure 6 1 Keil uVision Project File e Double click on this file to open Keil p Vision The remaining steps are performed within Keil p Vision 13 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started mision ele zan File Edit View Project Flash Debug Peripherals Tools SVCS Window Help sual da e EE DISPLAY_COPY amp e 5 eE amp amp Ej amp 98 STM322xG_EvaL BENE amp Project n E main c x E STM322xG_EVAL 2 c 6 MicroEJ 3 LLDISPLAY_STM32x0GEVAL c 4 Copyright 2012 IS2T All rights reserved F 5 For demonstration purpose only amp LLINPUT c LLLEDS c 6 IS2T PROPRIETARY CONFIDENTIAL Use is subject to license terms gt g F HAMMI 8 include lt stdio h gt amp LLSP_RTX c 9 include sni h 2 RTX_Conf_CM c 10 include LLMJVM h buttons c 11 include lt RTL h gt amp buttons listener c 12 include sram driver h interrupts c 13 2 ioe c 14 define MICROJVM STACK SIZE 2048 joystick c s T main c
14. on Click on OK 7 4 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 17 MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started 8 Document History Revision Description May 22th 2014 B MicroEJ 3 0 compatibility 18
15. rtual 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 STM3220G EVAL Getting Started 2 Product Registration The development version of MicroEJ uses hardware activation keys Open MicroEJ Open welcome page Help gt Welcome e MicroEJ amp Es File Edit Navi Search Project Run Window Help Welcome Xd ti Welcome to MicroEJ Getting Started B3 Manage Licenses 3 Try out Java Examples View Documentation Manage Platforms Create New Project MICR EJ Figure 2 1 MicroEJ Welcome Page Insert your USB dongle Press the Manage Licenses button Hardware dongles are automatically detected when the MicroEJ preferences main page is shown Click on Refresh when a new hardware dongle is plugged in N N The MicroEJ preferences page is also accessible from the menu Window gt Preferences gt MicroEJ MicroEJ ONE Build Your First Java Platform On STM3220G EVAL Getting Started 3 Overview 3 1 Platforms Several Java platforms JPF are pre installed in MicroEJ Open MicroEJ Open the welcome page Help gt Welcome Press the Manage Platforms button El Preferences ET Available Platforms b DES General z Add or remove platforms Ant C C Platforms and Packs Cache Name Version License Select All Help Fi Platform X X X
16. t Cancel Figure 4 2 Java Platform Configuration page 2 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 Keil un Vision on STM3220G EVAL board example configuration contains some files to configure the platform automatically example microuiGeneratorExtension contains some files to extend the MicroUI Image Gen erator tool A README 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 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 MyBoard Fi Environment select the Java platform environment architecture and version o N Platf lt A A ame MyPlatform 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 na
17. tform that is already configured for the STM3220G EVAL Open MicroEJ Open the Java Platform Example wizard File New Java Platform e Select the Java platform architectue ARM Cortex M3 ARMCC from the combo box A list of examples is available Create a Java Platform Configuration n ES Create a Java Platform lt gt Create a new Java Platform configuration Target Extensible JPF Platform v v Create a platform from an example or a template 4 5 Platform 4 BA Board Iz Basic Iz Basic SNI and SP Iz Basic Ul i Full 4 B Template Iz Java Platform Template Includes MicroEJ Java Virtual Machine CLDC EDC B ON SNI SP NLS ECOM COMM and embedded Ul 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 Select the example configuration Full in menu STM3220G EVAL 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 STM3220G EVAL Getting Started 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 MicroE Min Version 1 7 0 lt Back Nex
Download Pdf Manuals
Related Search