|What:||Conversion of EPOC Agenda and Contacts documents to native GNOME documents. Works on EPOC release 5 devices such as the Psion 5mx, Psion 7 and Netbook.|
|How:||Provided are EPOC services which sit on the EPOC device and respond to requests over the remote link. The services convert the Agenda and Contacts data to a format similar to XML. Linux clients here can talk to the services using the PLP link software provided by the plptools project and output the data in a format which can be read by the GNOME calendar and address book applications (gnomecal and gnomecard).|
|Licencing:||All software is licenced under GPL. That means it's free to use and you can copy it limitlessly. See the licence for the actual details.|
v1.0.1 contains minor updates to support presence of European characters in contact and agenda files. Support for international versions of Contact application.
You need Linux source code to make the Linux clients:
You need the EPOC install binaries:
You don't need the EPOC source code:
sayancnt.*.tgz. Unless you have an
urge to start developing or compiling the code yourself, for which you'll
need a fairly complex development environment. To compile for EPOC,
you need the EPOC ER5 SDK installed under Windows, or the SDK installed
under Linux following These
(c) MA 2001.
Download and install plptools
Download the .sis file(s). Copy the .sis file(s) to your EPOC device, and once there, double-click on them to install. You can use the plptools plpftp utility to transfer.
Download the Linux clients (epocagenda.tgz and epoccontacts.tgz). Unpack and compile using:
make -f epocagenda.mk make -f epoccontacts.mk
The Linux clients can output in GNOME formats and a raw format which should be convertible to other formats.
Works with EPOC ER5 only. Quartz, Crystal, not supported.
Narrow builds only - not UNICODE devices (yet).
You need to download and install plptools to get the Linux clients to communicate with the EPOC device.
Software has been stress-tested to 5000 connections. Reliability should be good - better than PsiWin!
Conversion to other formats should be possible, either by writing a conversion engine in the Linux client, or processing the raw "nearly XML" data with a perl script or something.
If you are interested in delving deeper into how it all works, you may be interested in this document.
Compiling: the Linux source can be compiled fairly simply. Just type 'make -f ...mk'. Compiling the EPOC code requires quite a lot of work. You need the EPOC R5 SDK and some complex configuration. I compile using a ARM gcc compiler running on a Linux PC.
Usage: epoccontacts OPTIONS Options: -h, --help Print this message and exit. -V, --version Print version and exit. -p, --port=<port> Connect to ncpd using given port. -v, --verbose Increase verbosity. -i, --input=<file> Specify contacts file on EPOC device. -o, --output=<file> Specify output file. -f, --format=<fmt> Specify output format. <fmt> Output format, one of: raw gnomecard
Usage: epocagenda OPTIONS Options: -h, --help Print this message and exit. -V, --version Print version and exit. -p, --port=<port> Connect to ncpd using given port. -v, --verbose Increase verbosity. -i, --input=<file> Specify agenda file on EPOC device. -o, --output=<file> Specify output file. -f, --format=<fmt> Specify output format. <fmt> Output format, one of: raw gnomecal
epocagenda -i C:\\Documents\\MyAgenda -o ~/.gnome/user-cal.vcf epoccontacts -o ~/.gnome/GnomeCard.gcrd
This has been static for ages, and is unlikely to change. I'm not buying a newer EPOC device, so it's unlikely this will work on newer devices unless someone else is willing, (or someone buys some devices for me).
An agenda view on the Psion
Same information in gnomecal
Same information in gnomecard
(c) MA 2001. Last updated 15th Dec 2001