*Currently on the Mac the client's Google Earth integration only works on Carbon on a 32-bit VM. Further there is a bug in PDE 3.5.1 that makes it impossible to set the target platform to Carbon (unless you are running Carbon on a 32-bit VM). To work around this we provide toast-carbon.target setup for use on Macs. Be sure to use this target if you are on a Mac. Hopefully we can address the base issue and allow Google Earth integration to work on Cocoa but until then...

*Currently on the Mac the client's Google Earth integration only works on Carbon on a 32-bit VM. Further there is a bug in PDE 3.5.1 that makes it impossible to set the target platform to Carbon (unless you are running Carbon on a 32-bit VM). To work around this we provide toast-carbon.target setup for use on Macs. Be sure to use this target if you are on a Mac. Hopefully we can address the base issue and allow Google Earth integration to work on Cocoa but until then...

−

* Note also that this [[Toast]] has nothing to do with that [http://www.macupdate.com/info.php/id/6351 Toast].

+

* Note also that this [[Toast]] has nothing to do with that [http://www.roxio.com/enu/products/toast/default.html Toast].

Revision as of 20:40, 19 November 2009

Toast is an example application meant to demonstrate a wide range of EclipseRT technologies. It operates in the telematics and fleet management domain. Telematics is the integration of telecommunications and informatics. You will have seen this in car navigation and infotainment devices. A typical telematics system interfaces to the devices in the vehicle and provides a user interface for interacting with or managing the devices. More sophisticated systems connect to a fleet management control center over a wireless network and allow remote control of the devices. For the fleet control center think of a large courier company with vehicles and packages going from place to place. This application domain is extremely rich with technology possibilities. That's why it makes such a great example!

Overview

Toast has its origins as the example application developed throughout the OSGi and Equinox book. What you see in this project is the extension of the Toast found in the book. This example takes Toast far beyond anything that could be covered in just one book and includes the use of:

Of course Equinox is used as the base runtime across the Toast client, server and embedded elements. The example also demonstrates a wide range of OSGi services such as HttpService, ConfigAdmin, Log, ...

Find toast-pserver.psf and using the context menu Import Project Set... to load all the Toast code into your workspace

Running Toast

There are several different parts to Toast. There are client and server bits, provisioning and application bits, RAP and Riena bits, etc. More will evolve over time. Below are the steps to running a basic Toast system. See the technology-specific documents for instructions on how to run other example setups.

Fundamentally Toast is split into the Back End and the Client. The back end is a server that has various amounts of function in it depending on the scenario. The client represents a vehicle and has the basic in-dash UI (Crust) and various applications. All configurations are described using Product Description (.product) files. To find the various ways of running, start by looking for *.product files (Ctrl-Shft-R).

See the platform-specific notes below for any variations to this process

Back End

Open backend.product

Launch using the green arrow at the top right or the link on the Overview page.

Look at the console to see that the backend has started. You should see some port and URL registrations

Open a web browser and point it at http://localhost:8080/toast for the simple web portal UI. Here you can navigate the various sample vehicles

Client

Launch using the green arrow at the top right or the link on the Overview page.

You should see the Toast in-dash UI (gray window) with a few applications (CD player, Emergency, ...)

Look at the console for the backend and notice the registration of client ABC123

Click the Emergency button (top left) on the client and notice the messages showing up on the server.

For more scenarios see the individual technologoy pages listed above.

Platform-specific Notes

Mac

Currently on the Mac the client's Google Earth integration only works on Carbon on a 32-bit VM. Further there is a bug in PDE 3.5.1 that makes it impossible to set the target platform to Carbon (unless you are running Carbon on a 32-bit VM). To work around this we provide toast-carbon.target setup for use on Macs. Be sure to use this target if you are on a Mac. Hopefully we can address the base issue and allow Google Earth integration to work on Cocoa but until then...