Skip to main content
Jump to: navigation, search


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!


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, ...
Toast demonstrates three scenarios for the use of Equinox and OSGi on the server
p2 provisioning 
Various elements of p2 are included in Toast; building, deploying, managing profiles, ...
Toast is a distributed application and uses ECF to do vehicle discovery, remote services and various other nifty things (Twitter?)
The Toast control center runs on servers and presents a rich user interface using RAP including Google Map and Earth integration.
The control center needs to store and manage data about vehicles, drivers, packages, ..
The basic Toast server side data is, of course, modeled using EMF.
Toast allows for reporting on the activities of the vehicles, package delivery, ... through RAP integrated reportlets.
Riena is used to give users a rich client application experience using remote messaging and focused workflows.


The Toast code has been donated to Eclipse by the authors of the OSGi and Equinox book and a number of people who participated in the development of Toast extensions for EclipseCon 2009. It is currently winding its way through the Eclipse IP process and should pop out the other end any day now. Watch Bug 289164 and CQ 3536.

Getting started

To get started with Toast do the following

  1. Connect to the repo at and navigate to /org.eclipse.examples/toast
  2. Check out the Toast project
  3. Open your Target Platform preferences (Window > Preferences > Plugin Development > Target Platform) and select the Toast Target as the current target. Click OK.
  4. Find toast.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 platform-specific below notes for any variations to this process

Back End

  1. Open backend.product
  2. Launch using the green arrow at the top right or the link on the Overview page.
  3. Look at the console to see that the backend has started. You should see some port and URL registrations
  4. 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
  5. Point your browser at http://localhost:8080/fleet to get the RAP back end UI.


  1. Open client.product or client-full.product
  2. Launch using the green arrow at the top right or the link on the Overview page.

Back to the top