We've tried to negotiate with the Sensable company, but as the communication has been stopped, we've opened our CVS tree for free public access again.

News:

2001/03/22 fixed few old bugs in driver, started for on even more user friendly version
2001/03/20 RTLinux works stable again (and Linux too). Big thanks have to go to Michael Barabanov for his discovery and patch
2001/01/11 corrected support for pencil and added support for button
2000/11/30 phantom works with the latest version of RTlinux3.0pre9
2000/06/10 phantom plays the music
1999/11/04 phantom is now working with the latest version of RTlinux2.0.

CVS Tree

You can browse our Phantom CVS tree directly. But you can also get its current snapshot directly from CVS:
  1. export CVSROOT=:pserver:anonymous@decibel.fi.muni.cz:/var/cvs
  2. Login to the server (using: cvs login)
  3. The password is empty (hit enter when asked)
  4. Checkout the source (read-only) using: cvs co phantom
  5. It will create directory phantom with the source code
  6. cd phantom; make
  7. follow the makefile advice
  8. read some documents in doc directory.

Beware: there is still small amount of documentation present, and most of the existing documentation is outdated. You use the software on your own risk. We are not responsible for any damage it may cause (but we always try to minize the risk of damage). It contains RTLinux kernel module that can override any protection on your system!.

To use it you need fairly recent version of RTLinux. We are always trying to be on the bleeding edge of development of this system, at the moment of writing this we are runnig RTLinux 3.0 patched on 2.4.2-ac20 Linux kernel (2001/03/22) with M.Barabanov vmalloc patch. Driver should also still support kernel 2.2. If you think its not true, let me know (as bug is on our side).

Notice: As more people tries to use this driver in their software projects I would like to put couple of link to their project on this page. Also I would like to express some thanks for bugreport and new ideas to Timothy Miller

Hopefully this project will move now a bit faster ahead (as I finaly doens't have to search for the weird linux crashes too)

Few selected versions

They may be more stable than what is in CVS. But use them only if CVS version fails for some reason for you

Date
7:00am UTC download
22 Mar 2001download
30 Nov 2000download


Used and strongly suggested version of RTL is 3.0

rtlinux-3.0 - follow instalation guide inside this package to get RTLinux working (but use suggested patch bellow instead)

Makefile patch for the main Makefile in RTLinux3.0 final release. Needed if you want to build kernel with modversion symbols. you should apply this patch inside rtlinux-3.0 directory.


following patches are appliable by entering linux kernel tree and using these commands:
zcat patch_file_name | patch -p1 

Currently used version is 2.4.7 with RTL3.0 (with vmalloc fix inside)

clean kernel 2.4.7   -   it looks like these kernel are not producing coredumps for multithreaded applications - and it's not a feature (use your nearest mirror!)

patch for RTL3.0 and 2.4.7 kernel (i386)   -   use this patch file instead of the one included in the rtlinux-3.0.tar.gz archive file above (this patch is only modified and tested for i386 architecture!) This patch contains vmalloc patch.


Previously used version is 2.4.5-pre1 with RTL3.0 and vmaloc fix patch
clean kernel 2.4.4   -   it looks like these kernel are not producing coredumps for multithreaded applications - and it's not a feature

prepatch for 2.4.5-pre1   -   this will create 2.4.5-pre1 kernel from clean 2.4.4 one.

patch for RTL3.0 and 2.4.5-pre1 kernels (i386)   -   use this patch file instead of the one included in the rtlinux-3.0.tar.gz archive file above (this patch is only modified and tested for i386 architecture!) This patch contains vmalloc patch.


Previously used quite stable kernels

Currently used version is 2.4.3-ac9 with RTL3.0 and vmaloc fix patch
Fix are getting a bit more complicated this time. But I believe its worth to upgrade - especialy if you have SMP machines clean kernel 2.4.3 - this kernel is already know to have some bugs, but so far it looks pretty stable so I'm waiting till they will provide 2.4.4 version probably. I had to write some article for EuroHaptics2001 now :).

vmalloc stability patch for post 2.4.3-acXX kernels created by Michael Barabanov

patch for RTL3.0 for 2.4.3-acXX kernels (i386) - use this patch file instead of the one included in the rtlinux-3.0.tar.gz archive file above (this patch is only for i386 architecture)

smp.c patch to reverse some weird change in ac kernel tree which currently causes deadlock of rtl - this patch just reverse the patch from -ac branch and the magically works - this has to be explored by rtl maintainers probably


Previously used version is 2.4.3 with RTL3.0 and vmaloc fix patch
clean kernel 2.4.3 - this kernel is already know to have some bugs, but so far it looks pretty stable so I'm waiting till they will provide 2.4.4 version probably. I had to write some article for EuroHaptics2001 now :).

stability patch for post 2.4.0 kernels created by Michael Barabanov - included in the patch below

patch for RTL3.0 for 2.4.3 kernel (i386) - use this patch file instead of the one included in the rtlinux-3.0.tar.gz archive file above (this patch is only for i386 architecture) and includes the vmalloc patch inside.


Previously used version is 2.4.2-ac20 with RTL3.0 and vmaloc fix patch
clean kernel 2.4.2

prepatch for 2.4.2-ac20

stability patch for post 2.4.0 kernels created by Michael Barabanov

coredump patch for post 2.4.2-ac2x kernels created by me. Should fix deadlock problem with SMP machines and multithreaded coredumps

patch for RTL3.0 for 2.4.2-ac20 kernel (i386) - use this patch file instead of the one included in the rtlinux-3.0.tar.gz archive file above (this patch is only for i386 architecture)


Suggested RTL version is 2.4.0-test1 with RTL3.0
(this is what RTL maintainers advice to use)
Try to use this version if the above setup fails for you.

I've BEEN having some serious problems with RTL and the new XFree4.0 But this has been fixed with M.Barabanov patch

Here are the links to the referenced files:
linux kernel 2.4.0-test1, rtlinux 3.0
as you might know its always faster to use nearest kernel.org mirror to you :)


VRLab

Implementation

Phantom sources & documentation

Internal notes

Shared memory documentation


Petr Konecny
Zdenek Kabelac
Last modified: Thu Mar 22 13:38:35 CET 2001