Installation from the package

Environment specification :

- This implementation works on linux, kernel (2.4.19) or any compatible version. Everything is standard implementation.
- The pcmcia_cs package has to be installed. This package is required because it contains modules we still use in this release and drivers for pcmcia cards.
- We rely on oscar 0.9.3a
- We need to run oscar as root, since the program makes some kernel calls
- We need an access to Internet

Installation :

Untar the .jar package.
In this release, you will find a file called : pcmciacards.properties.dist . This file contains a list describing a few cards. You have to rename this file as pcmciacards.properties and place it in the directory oscar/lib/
If the card you are using is not present in this file, you have to add it. The information you will need to do that can be found in /etc/pcmcia/config. Please be carefull to respect the format of the existing file.

Configuration :

You need to specify some System properties for oscar. Create the file lib/bundle.properties and add the following properties:

org.osgi.service.device.driverlocator.driverslocation=http://ares.insa-lyon.fr/~sfrenot/devel/osgiprov/drivers/
org.osgi.service.device.driverlocator.driverlistfile=drivers.txt
com.softsell.osgi.log.threshold=4

Runnning the service

  1. Oscar must be run as root for pcmciadriver to work
  2. # stands for shell prompt
  3. xx-> stands for command number xx on oscar prompt
  4. I use obr to install the packages

1) Start oscar

#sudo /run.sh
Welcome to Oscar.
=================

Enter profile name: b
-> ps
[  0] [Active     ] System Bundle
[  1] [Active     ] Oscar Shell Service
[  2] [Active     ] Shell TUI
[  3] [Active     ] Oscar Bundle Repository

2) install the logging system 

-> obr start "Log Reader"
Installing dependency Log Service...
Installing Log Reader...
-> ps
START LEVEL 1
   ID   State         Level  Name
[   0] [Active     ] [    0] System Bundle
[   1] [Active     ] [    1] Shell Service
[   2] [Active     ] [    1] Shell TUI
[   3] [Active     ] [    1] Oscar Bundle Repository
[   4] [Installed  ] [    1] Log Service
[   5] [Installed  ] [    1] Log Reader
-> start 4 5
-> INFO : 5 : Logger.start : 0.1
INFO : 5 : BundleEvent.STARTED

3) Install the OSGi services 


-> obr start "OSGi Service"
Installing OSGi Services...
INFO : 6 : BundleEvent.INSTALLED
-> start 6
-> INFO : 6 : BundleEvent.STARTED

4) Install the Device Manager 

-> obr start "Device Manager"
Installing Device Manager...
-> INFO : 7 : BundleEvent.INSTALLED
-> start 7
INFO : 7 : DeviceManager 0.1.4 has been started
INFO : 7 : BundleEvent.STARTED

4) Install the DriverLocator 

-> obr start "HTTP Driver Locator"
Installing HTTP Driver Locator...
INFO : 8 : BundleEvent.INSTALLED
-> start 8
DEBUG : 7 : DeviceManager.serviceRegistered
INFO : 7 : DriverLocator : Bundle #[8]
INFO : 8 : ServiceEvent.REGISTERED
INFO : 8 : org.osgi.service.device.DriverLocator 0.0.2 has been started
INFO : 8 : BundleEvent.STARTED
At this step, the device manager and the driver locator are installed. You should skip to the provider section, in order to test the device manager. provider.

If you wan to serve your own drivers, on your own OSGi web site, you can also install the HTTP Driver Resource. It declares a context that serves drivers. The context is defined in the the lib/bundle.properties properties : org.osgi.service.http.port=8080 org.osgi.service.device.tools.http.context=/drivers org.osgi.service.device.tools.http.map=/opt/osgiprov/devices/ In that case, you should also modify the driverlocator property org.osgi.service.device.driverlocator.driverslocation=http://ares.insa-lyon.fr/~sfrenot/devel/osgiprov/devices/ In order to access localhost org.osgi.service.device.driverlocator.driverslocation=http://localhost:8080/drivers/ then

5) Install the Driver Resource and a local http server 

-> obr start "HTTP Service"
Installing dependency: Servlet
Installing: HTTP Service

22:57:08.621 EVENT  Starting Jetty/4.2.x
22:57:08.898 WARN!! Failed to start: SocketListener@0.0.0.0:8080
Http2: org.mortbay.util.MultiException[java.net.BindException: Address already in use]

-> obr start "HTTP Driver Resource"
Installing dependency Servlet...
INFO : 9 : BundleEvent.INSTALLED
Installing HTTP Driver Resource...
INFO : 10 : BundleEvent.INSTALLED
-> start 9
-> INFO : 9 : BundleEvent.STARTED
-> start 10
INFO : 10 : Service started 0.0.2
INFO : 10 : BundleEvent.STARTED
At this step, the device manager, the driver locator are installed and drivers will be search on your local httpserver. You should skip to the provider section, in order to test the device manager. provider.

Contributors

Stephane Frenot
A special thanks to all INSA students that contributed to that code
Mathias Faure
Cedric Logeais
Yannick Presumey
Marouane Sefiani
$Id: start.html,v 1.2 2004/06/20 13:30:39 sfrenot Exp $: