Setup:

1) create database.  It's a fairly simple schema, which can be found
   in the file 'DatabaseSchema.txt' in the project directory.  The file
   assumes that the current user is 'aland', the app user is 'cid' and the
   database is named 'callerid'.  You can modify the database file, and run
   the command:

	psql -d callerid -f DatabaseSchema.txt

2) Create the configuration file /etc/cid.conf (or change the name in
   the code).  The file consists of one line:

	databaseName:databaseUser:databasePassword

3) Enable the databaseUser and give it access rights to the database table.

4) Configure your modem to return caller ID data.  My modem's docs are below.
   If your modem returns the data differently, and you need help with it,
   let me know.
   NOTE that my modem returns either 'O' or '0' when no data is available.

5) Run the cid.pl script similar to:

	perl -w cid.pl /dev/tts/0

   where /dev/tts/0 is the port where my modem sits on my server.

6) Retrieve the (full) list with 'retrieve.pl'.


Still To Do:
* Set up as 'startup script'




Dummy Data
----------

RING

DATE = 1122
TIME = 1457
NMBR = 5087884321
NAME = NULL,DEV

RING


...


RING

DATE = 1122
TIME = 1502
NMBR = 2175334216
NAME = O

RING




-------------------------

Settings for Alan's modem:

+VCID - Caller ID (CID)
This command controls the reporting and presentation of data associated with the Caller ID services in the Incoming Call Line ID (ICLID) data format for the next call.

Syntax
+VCID=<pmode>
Defined Values
<pmode> Decimal number corresponding to the selected option.
0 Disable Caller ID reporting. (Default.)
1 Enables Caller ID with formatted presentation to the DTE. The modem presents the data items in a <Tag><Value> pair format. The expected pairs are date, time, name, and caller code (telephone number),
2 Enables Caller ID with unformatted presentation to the DTE.

Reporting Current or Selected Values
Command: +VCID?
Response: +VCID: <pmode>
Example: +VCID: 0 For the default setting.
Reporting Supported Range of Parameter Values
Command: +VCID=?
Response: +VCID: (<pmode> range)
Example: +VCID: (0-2)


+VRID - Report Retrieved Caller ID (CID)
This command reports the data associated with the Caller ID services in the Incoming Call Line ID (ICLID) data format for the last received call.

Syntax
+VRID=<pmode>
Defined Values
<pmode> Decimal number corresponding to the selected option.
0 Reports Caller ID with formatted presentation to the DTE. The modem presents the data items in a <Tag><Value> pair format. The expected pairs are date, time, name, and caller code (telephone number),
1 Reports Caller ID with unformatted presentation to the DTE.

Reporting Supported Range of Parameter Values
Command: +VRID=?
Response: +VRID: (<pmode> range)
Example: +VRID: (0,1)