Everyware™ Software Framework
PART 2. GETTING STARTED
Installing ESF Tooling into Wind River Workbench
· Installing the Prerequisites
Wind River Workbench
Introduction
This document explains how to install of the Java tooling and ESF tooling into Wind River Workbench. This document is only applicable if you have a Eurotech/Wind River LiveUSB and would like to use Wind River Workbench to develop ESF applications. If you do not have a LiveUSB and are not doing any native (C/C++) development you can use this document to perform ESF development in a standard Eclipse environment.
Installing the Prerequisites
Start by booting Fedora from the LiveUSB. Accept the 'Product Evaluation License Agreement' when Fedora boots to get to the Fedora Desktop by clicking 'Close' and then 'ACCEPT' in the pop up window. You should now be looking at the Fedora desktop as shown in figure 1.
Figure 1 The Fedora Desktop and the Firefox icon
This howto assumes the WRL License has already been activated. If not, see the Wind River 'Getting Started Guide' on the LiveUSB Fedora desktop. The license activation process is explained there.
The first thing to do is download the Sun JDK 1.6. Open Firefox by clicking the icon highlighted in figure 1. Type: http://www.oracle.com/technetwork/java/javase/downloads/jdk6-jsp-136632.html in the address bar and hit enter. This is shown in figure 2.
Figure 2 The Oracle/Sun JDK Download Site
Click the ‘Download’ button that is highlighted in figure 2. This will open the page shown in figure 3.
Figure 3 Logging in or Registering for an Oracle Account
To continue you must register for the Sun Online Account if you are not already. Either log in if you already have an account or click the ‘Register Now’ button as highlighted in figure 3. This will open the page shown in figure 4.
Figure 4 Registering
Fill in all of the required fields and click ‘Submit’ to continue. This will result in an email being sent to your registered email address with a JDK 1.6 download link. When it arrives, download it by manually typing the link into Firefox address bar in Fedora. This page is shown in figure 5.
Figure 5 Selecting the Platform for Download
Once the page is open, select ‘Linux’ and then click ‘Continue’ as shown in figure 5. This will open the page shown in figure 6.
Figure 6 Selecting the Download
There will be two links to choose from. There is a *-i586-rpm.bin file and also a *-i586.bin file. Select the *-if586-rpm.bin file for download. This is highlighted in figure 6. This will result in the dialog shown in figure 7.
Figure 7 Saving the JDK
Select ‘Save File’ and click ‘OK’ to continue. Once the download is complete you can verify if is present. Do so by clicking ‘Places’ and the ‘Download’ as shown in figure 8.
Figure 8 Verifying the JDK is present
This will open the window shown in figure 9.
Figure 9 The JDK Install Package
Go ahead and close this window and go to ‘Applications -> System Tools -> Terminal’ as shown in figure 10.
Figure 10 Opening a Terminal
This will open the Terminal window . To install the JDK run the following commands in the terminal window.
cd ~/Download
chmod +x jdk-6u21-linux-i586-rpm.bin
sudo ./jdk-6u21-linux-i586-rpm.bin
This will take a couple of minutes depending on the system it is being installed on. When this is complete close the terminal window. With the most recent JDK installed you can now start Wind River Workbench. Do so by clicking on the Desktop icon shown in figure 11.
Figure 11 The Wind River Desktop Icon
This will open the dialog box shown in figure 12.
Figure 12 Selecting the Workbench Workspace
Use the default workspace called /WindRiver/workspace as shown in figure 12. This will open the Wind River Workbench as shown in figure 13.
Figure 13 Wind River Workbench
Now we need to install the ESF components, Java Development Tools (JDT), and Plugin Development Environment (PDE) into Wind River Workbench. Start the install wizard as shown in figure 14 by clicking ‘Help -> Install New Software…’.
Figure 14 Opening the Install Wizard
This will open the dialog shown in figure 15.
Figure 15 The Install Wizard
Click the 'Add...' button as shown in figure 15. This will open the window shown in figure 16.
Figure 16 Setting up the New Update Site
Enter in ESF for the Name and the location as http://esfdownload.eurotech-inc.com/update_site as shown in figure 16. Then click ‘OK’. You will then be prompted for your password as shown in figure 17.
Figure 17 ESF Authorization Dialog
Enter in the username you received from the ESF registration page (if you haven’t done this you can do so now here) and your password. Click 'Save password' if you want your password saved and click 'OK'. This will open the window shown in figure 18.
Figure 18 Selecting the Plug-ins to Install
Expand ESF and Wind River Workbench Plugins as shown in figure 18 and select at a minimum:
· ESF Core Tooling and JVM Feature from the ESF category
· An 'ESF [platform] Base Feature' where [platform] should match the Eurotech platform you are running on. The platform is Helios is this example.
· All of the Features listed under 'Wind River Workbench Plugins'. This is required for all Java and Plug-in development.
Then click 'Next'. This will open the windows shown in figure 19.
Figure 19 Verifying the Selected Plug-ins
Click 'Next' after verifying you have selected the proper features. This will open the window shown in figure 20.
Figure 20 Accepting the License Agreements
Review the license agreements and click the radio button 'I accept the terms of the license agreements' to continue as shown in figure 20. Finally click ‘Finish’ to start the download and install of the selected features. This will take a few minutes depending on the system and the available bandwidth. You may get a security warning as shown in figure 21.
Figure 21 Accepting the Unsigned Content Warning
Click 'OK' to continue. Finally, you will get a message prompting you to restart Workbench. Click 'Yes' to do so as shown in figure 22. Workbench will then restart.
Figure 22 Restarting Workbench Dialog
When Workbench restarts you will again be prompted for the workspace. Click 'OK' after accepting the default of /WindRiver/workspace. Workbench will now be showing a new Eclipse 'Welcome screen'. Feel free to review any of the newly added 'Java development' or 'Eclipse plug-in development' features. Once you are done, you can close the welcome screen by clicking the highlighted area in figure 23.
Figure 23 Closing the Welcome Screen
Configuring the Environment
You should now be looking at the default workspace. We will now switch to the 'Java Perspective'. This is done by clicking 'Window -> Open Perspecitve -> Other...' as shown in figure 24.
Figure 24 Switching the Perspective
This will open the window shown in figure 25.
Figure 25 Selecting the Java Perspective
Select 'Java' and click 'OK'. Now you should be looking at the default Java perspective as shown in figure 26.
Figure 26 The Java Perspective
You should also note there are two projects open in the upper left pane (the 'Package Explorer'). We are going to close these so when they automatically build they don't consume so much time. When going through the core Wind River tooling and examples don't forget these are closed and need to be reopened. To close these projects, right click on one and go to 'Close Project' as shown in figure 27. Repeat for the other project. You will see they are both not expandable now. This is ok. To reopen at a later time simply right click on one and go to 'Open Project'
Figure 27 Closing the Example Projects
We are now ready to import the ESF service API projects and continue configuring our environment. Right click anywhere in empty space in the 'Package Exporer' (except on a project) and select 'File -> Import' as shown in figure 28.
Figure 28 Getting to the ESF Import Wizard
This will open the window in figure 29.
Figure 29 Selecting the ESF Import Wizard
Choose 'ESF -> ESF Import Wizard' as shown in figure 29 and click 'Next'. This will open the ESF Import Wizard as shown in figure 30.
Figure 30 Selecting all ESF Projects to Import
Select all projects and click 'Finish'. This will take a couple minutes to finish depending on the speed of your system. You should see the projects now in your workspace 'Package Explorer' as shown in figure 31. You will also note there are red X marks over some of the projects indicating errors. This is fine for now.
Figure 31 The Workspace Now Filled with ESF API Projects
We now need to set up the JDK we installed early. To do so open ‘Window-> Preferences’ and expand ‘Java’ and then select ‘Installed JREs’. You should see something similar to what is shown in figure 32. The default JRE will be what you have installed on your system.
Figure 32 The Default JRE
We need to add a custom JVM description. To do so, click the ‘Add...’ button, select ‘Standard VM’, and click ‘Next’ as shown in figure 33.
Figure 33 Selecting the VM Type
This will open the dialog shown in figure 34.
Figure 34 Adding the JRE
Click the 'Directory...' button shown in figure 34. This will open the dialog box shown in figure 35.
Figure 35 Selecting the New JDK
Browse to /usr/java/default as shown in figure 35 and click 'OK'. You should now see what is shown in figure 36.
Figure 36 Finalizing the JRE Configuration
Now click 'Finish'. This will bring us back to the main Preferences menu as shown in figure 37.
Figure 37 Preferences Showing the New JRE
Highlight default VM (not the one we just added) and click 'Remove' as shown in figure 37. This will then make the JDK we just installed the new default for development. This is shown in figure 38.
Figure 38 The New Default JRE
Finally, click 'OK'.
Now we can set the target platform. Do so by finding the 'com.esf.tooling.target.platfrom.product.eurotech.[platform].esf_foundation project in the 'Package Explorer'. Expand it as shown in figure 39.
Figure 35 Setting the Target Platform
Now double click the eurotech_[platform]_esf_foundation.target file to open in into the center Eclipse pane. In the upper right you will see a 'Set as Target Platform' button. This is also highlighted in figure 39. Go ahead and click it. The target platform is now set.
Once done setting the target platform, we should set up Eclipse to 'automatically build'. As we use the Eclipse editor Eclipse will continually build in the background and show us syntax errors as they occur. Set this by clicking 'Project -> Build Automatically' as shown in figure 40.
Figure 40 Setting the Workspace to Build Automatically
Note that having the builds occur automatically is not recommended when doing native (C/C++) development in Workbench. This will significantly slow down the system. However, for Java development it is preferred.
The last step is to set the compiler compliance level. Do so by going to 'Window -> Preferences'. Now select 'Java -> Compiler' as shown in figure 41.
Figure 41 Setting the Compiler Compliance Level
Change the 'Compiler compliance level' to 1.4 as highlighted in figure 41. Now click 'Apply' which will prompt you to do a full rebuild as shown in figure 42.
Figure 36 Rebuilding After Changing the Compiler Compliance Level
Click 'Yes' to start a rebuild. Finally click 'OK' to close the preferences dialog.
You should see Eclipse perform the initial build and now there should be no errors in the workspace. You are now ready to use Wind River Workbench for ESF development.
Copyright © 2010 Eurotech Inc. All rights reserved.