Ericsson Chatboard support for Agenda VR3
2002/09/21 Milan Pikula, <www@terminus.sk>

Driver source, configuration utility and documentation can be
found at http://www.terminus.sk/~www/agenda/ .

Contents
~~~~~~~~~
	1. Physical connection
	2. Communication protocol
	3. Linux support

This document describes usage of Ericsson Chatboard
(3V model) together with Agenda VR3 PDA and Linux.
All information provided here is obtained by experimenting
and comes
 	without ANY WARRANTY,
and I am not responsible for any damage, caused by
following the instructions found hereafter.

1. Physical connection
~~~~~~~~~~~~~~~~~~~~~~
The keyboard can be connected to Agenda using
serial line, see
	<add url here>

2. Communication protocol
~~~~~~~~~~~~~~~~~~~~~~~~~
After connection the Chatboard sends various
AT commands to Agenda, using asynchronous serial
communication, 9600 bps, 8N1.

Some of them are identification strings, some are
actual keypresses. Each command must be acknowledged
by "OK" sent from Agenda to the Chatboard.

The keyboard apperantly has two modes, which can
be switched by pressing shift-space. Some keys can
produce up to 4 different codes, using these two modes
and shift key.

Here are keys and their AT commands from Chatboard:

---------------------------------------------------------------
mode	shift	key	command				remark
---------------------------------------------------------------
		0-9	AT*EKSE=0 to AT*EKSE=9		0-31
	shift	0-9	AT*EKSE=32 to AT*EKSE=41	32-63
		a-z	AT*EKSE=65 to AT*EKSE=90	64-95	
		spac	AT*EKSE=91
		.	AT*EKSE=92
sh-spac		a-z	AT*EKSE=97 to AT*EKSE=122	96-127
sh-spac		spac	AT*EKSE=123
sh-spac		.	AT*EKSE=124
	shift	a-z	AT*EKSE=129 to AT*EKSE=154	128-159
	shift	.	AT*EKSE=156
sh-spac	shift	a-z	AT*EKSE=161 to AT*EKSE=186	160-191
sh-spac	shift	.	AT*EKSE=188


		WWW	AT*EAPP=0,5,"WWW: ","WWW"	192
		Attach	AT+CKPD="#:"			193
		E-mail	AT*EAPP=0,5,"To: ","WWW"	194
		SMS	AT*EAPP=0,0			195

		PhBook	AT*EAPP=1,0			196
		YES	AT+CKPD="S"			197
		NO	AT+CKPD="E"			198

		Backsp	AT+CKPD="C"			199
		<-	AT+CKPD="<"			200
		->	AT+CKPD=">"			201
---------------------------------------------------------------

3. Linux support
~~~~~~~~~~~~~~~~

Linux driver uses the device through a line discipline.

Here are installation instructions:

* configure the kernel to define CONFIG_CHATBOARD:
	Character devices -> Ericsson Chatboard support

* compile the driver
  Build the driver either as a module, or directly into kernel.
  Install the module and/or kernel on your machine.

* compile the utility 'charboardattach'.

* start it!
	- make sure nothing uses the serial port
	- run chatboardattach /dev/ttyS0
	- load new keymap for X (but how?;)

	(./chatboardattach /dev/ttyS0 & ) ; DISPLAY=:0 ./xmodmap agenda-pc.map