MANUAL FOR CLIDUSER (BBC BASIC+6502 Machine code) This file describes the program CLIDUSER which interfaces to a Mitel MT8843 based calling line indentity hardware. It offers logging facilities for the incoming calls while unattended, and can be programmed to highlight known numbers and filter out unwanted calls. It also uses the speech system to announce the calls without needing to turn a monitor on. The manual and software is (C)2005 SPROW INSTRUCTIONS- At the BASIC prompt, type CHAIN"CLIDUSR". The program will load up and attempt to find a file called "CLIDINI" in which the last saved settings are stored, and "CLIDNOS" for the list of known numbers. If a file cannot be opened then the program defaults will be used instead. The main display screen will then be shown, which is divided into areas: * title bar, reminds which section is being viewed * rolling number log, a carousel of the last incoming calls * menu options, see below * help area, where help text is show From the main screen there are 4 options to choose from: 1. Mark calls as old When a call comes in its number is logged and it will be listed in the display area with the word "New". When the new calls have been reviewed they can have the "New" marker removed by chosing this option. 2. Clear old calls Deletes all calls not marked as "New" from the log. 3. Manage known numbers This changes the display to the editor for known numbers, see the separate section below. Pressing enter when not in the number editor will save and return to the main screen. 4. Setup This changes the display to the settings screen, where a number of default options can be modified, see the separate section below. Pressing enter will save and return to the main screen. MANAGING KNOWN NUMBERS- The list of known numbers allows the software to take a numeric caller identity and display a textual version instead, for example "Work" in place of a long number. Optionally known numbers can be highlighted in the log if they are high priority for example. Use the following keys when in this screen: f0 = inserts a new line f1 = deletes an existing line TAB = jumps between columns Each known number consists of the number it refers to, a text equivalent, and either "Yes" or "No" set using the left and right arrow keys to decide whether to highlight that number when found. While in the known numbers screen up to one call can occur in the background, this will be processed when returning to the main screen. SETUP- The setup screen allows the customisation of the application. Each option is grouped by the catagory which it affects, and the one currently being edited will flash - use the arrow keys to navigate up and down and the left and right keys to alter the values. The values are * Announce with CAPS LOCK When "Yes" any new calls will also flash the caps lock LED so that the computer monitor does not need to be left turned on. * Speak new numbers When new calls are available, pressing a key will have the speech system (if fitted) read the number of calls and the numbers out. * Speak start key Allows the key used to trigger the "Speak new numbers" option to be changed. * Log hidden numbers When a call comes in with the number withheld or unavailable this option chooses whether to store it in the log or simply throw it away. * Auto delete age When calls have been in the log for a long time they can be automatically deleted after a certain time. By default this is set to "Memory" so log entries will only be deleted when the memory is full. * Set current year The protocol for caller id does not include the year in the message, so a base year must be set. The program will try to guess this using the real time clock (if fitted) so no changes may be required. * Local dialling code Type in the dialling code for your area. * Local number length Some service providers only send the local number when you are called by somebody in the same area as you. However, this makes comparing the number difficult, so the program will look out for numbers of this length and add on the local dialling code automatically. While in the setup screen up to one call can occur in the background, this will be processed when returning to the main screen. KNOWN PROBLEMS/FUTURE ENHANCEMENTS- No known problems HISTORY- V1.07 Clearing the 'new' flags was also resetting the alias to always be the first number in the list of known numbers regardless of what number was actually stored. Non voice calls announced by the network were erroneously being logged - fixed. V1.08 Altered the function which looks up known numbers to give up if a non numeric character is found in the number, previously only the service privider specific strings "INTERNATIONAL" and "WITHHELD" were trapped. V1.09 The text for "log hidden numbers" was the opposite logic to that used in the logger, so yes meant no and no meant yes. V1.10 Added buffer limit check to machine code portion, sometimes during a long voice call with people talking about 1200Hz enough bytes would be recovered that it overflowed. Increased buffer to intended size. V1.11 Scrolling of missed calls would look wrong if a mixture of new and old numbers were in the list - fixed. V1.12 Added ageing and auto deletion of old calls (the menu option was always present, but never happened).