Telcom Research CallShop FONE DISPLAY User manual
CallShop FONE DI$PLAY
Installation & Protocol Manual
Stand Alone Install &
Multiple Install via CallShop Concentrator
Issue 1.10
March 24 2008
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
1
General :
The CallShop Phone Display is a device for controlling and displaying various features
related to the implementation of a CallShop.
The device is enclosed in a small plastic enclosure, and contains an LCD display and
connection jacks. Its internal microprocessor is capable of various functions related to
control and status of a telephone call, as well as display of call information on the LCD
screen for the user to see.
On the right side are the connection jacks. These provide the interconnect with the outside
world.
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
2
Connecting the CallShop Fone Display is quite easy.
• Plug the telephone line cord into the Line Ja k.
• Plug the telephone cord into the Telephone Ja k
• Plug the AC Power Adapter into the Power Ja k
• Plug an RJ45 Patch Cable (Standard network cable) into the Serial Interfa e Ja k
• Plug an RJ45 to DB9 Adapter onto the end of the RJ45 Patch Cable
• Plug the RJ45 to DB9 Adapter into a spare COM port of your PC.
The RJ45 to DB9 Adapter may be obtained directly from Telcom Research, or can be built
from a generic adapter. The connection information for making your own adapter is below:
9 Pin Fone Display Adapter
DB9 Male or DB9 Female
DB9
Signal
Adapter
Color
Adapter
Pin
Number
1 DCD - /C
2 RXD Blue 1
3 TXD Red 4
4 DTR Green 5
5 G D Yellow 6
6 DSR - /C
7 RTS - /C
8 CTS - /C
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
3
The CallShop Fone Display is controlled by a PC via serial communications. The PC’s COM
Port settings must be:
Baud Rate 2400
Data Bits 8
Stop Bits 1
Parity one
Using this serial interface you can send message packets to the device to control its
behavior. Each message packet is ASCII data with a carriage return at the end of each
packet. This simple serial protocol allows for easy implementation and testing using
common tools.
Document Conventions:
In this document the following names and symbols will have the following meanings:
<CR> Carriage Return the hex value 0x0d (‘\r’)
0x Hex Character Representation. The 2 digits after the 0x are a hex value.
ETX The ASCII character ETX which is 0x03 or ‘\3’
Control Commands :
The following list of commands allows a PC program to control the operation of the
CallShop Fone Display as part of an overall call shop solution.
Each command is a single ASCII character followed by 1 or more parameters as text, ending
with a <CR> Each command will cause the device to perform some function and respond
with a confirmation message which is the command character proceeded by the “^” and
ending with a <CR>
Blank LCD Line X:
The “l” (lower case ‘L’) command will cause a line of the LCD display to be cleared or
blanked. This command is a 3 character command with the 2nd character being the line
number, 1 for top, and 2 for bottom.
Format:
lR<CR>
l = “l” (Lower case “L”
R = Row (1 for line 1 and 2 for line 2)
Response:
^l<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
l2<CT>
Clear line 2 of the LCD display
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
4
ote : Clearing a line will only clear a line that contains text. If the line is populated with a
control such as a timer or clock then this will not be removed.
Display Full Screen:
The “L” command allows for the full screen (32 characters) to be written to all at once. The
command is the 34 character command.
Format:
LAAAAAAAAAAAAAAAABBBBBBBBBBBBBBBB<CR>
L = “L”
A = 16 character field of text to appear on line 1 of the LCD display.
B = 16 character field of text to appear on line 2 of the LCD display.
This command is only capable of filling the entire display. If you wish to
modify only a portion of the display, see the “Message” command.
Response:
^L<CR>
The CallShop Fone Display will respond with this confirmation message
Message:
The “M” command provides the ability to put 1 or more characters any place on the LCD
display.
Format:
MRCCLLxxxxx<CR>
M = “M”
R = Row (1 for line 1 and 2 for line 2)
CC = Column (01 to 16)
LL = Length
Xx = Message characters
Response:
^M<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
M10311Hello World<CR>
This example will put the words “Hello World” on line one starting at column 3 and
the message is 11 characters long.
Clock Set:
The “T” command provides the ability to set the devices real time clock.
Format :
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
5
TYYMMDDWhhmmss<CR>
T = “T”
YY = Year
MM = Month
DD = Day
W = day of the week (Sunday is 1)
hh = Hour
mm = Minutes
ss = Seconds
Response:
^T<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
T0802263182400<CR>
This example sets the clock to February 26, 2008 at 18:24:00.
Clock Display:
The “t” command (lower case “T”) allows you to display the default clock on the LCD display
on either line 1 or line 2.
Format:
tx<CR>
X = Row umber
0 = Do not display
1 = Display Clock on Line 1
2 = Display Clock on Line 2
Response:
^t<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
T1<CR>
Put the lock on line one of the display
T0<CR>
Turns off display of the clock, however the clock continues to run in case you
want to display it at a later time. Only a power interruption will cause the
clock to reset and loose time.
Duration Counter:
The “D” command will place a duration counter on the LCD at the location of your choice. A
duration counter will allow you to display the time used by the caller in seconds and
minutes, without the need to constantly update the LCD display.
Format:
DRCCDx<CR>
D = “D”
R = Row ( 1 or 2 )
CC = Column ( 1 to 16 )
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
6
D = Delimiter (character between seconds and minutes)
X = Optional command. If this is a “C” then the counter is cleared.
Response:
^D<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
D101:C<CR>
Display a duration timer on Row 1 at column 1 with a “:” between the
minutes and seconds. The display will look like this:
000:00
D000: <CR>
This will cause the duration counter to be removed from the LCD display.
Duration Start/Stop:
The “d” (lower case “D”) command is used to start and stop the Duration Counter.
Format:
dxy<CR>
d = “d”
x = Enable / Disable
1 = Enable
0 = Disable
y = Optional command. If this character is a “C” then the counter
will also be reset to zero.
Response:
^d<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
d1<CR>
This causes the duration counter to begin counting up.
d0<CR>
This causes the duration counter to stop counting. The d1 command will then
allow you to turn the counter back on.
Cost Counter:
The “C” command will place a Cost Counter on the LCD at the location of your choice. A cost
counter will allow you to display the cost of the call incrementing automatically without the
need to constantly update the LCD display.
Format:
CRCCLDdSTTAAx<CR>
C = “C”
R = Row ( 1 or 2 )
CC = Column ( 1 to 16 )
L = Length of the field
D = Decimal Places
d = Delimiter character.
S = Currency Symbol. Can be any
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
7
ASCII character or special character
TT = Time Period
AA = Amount to Add or Subtract each time period.
X = Optional command
C = Clear the counter
R = Restart/continue the counter
Response:
^C<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
C10882.$1530C<CR>
Display a cost counter on Row 1 at column 8 with a “$” at the start of the
field with a “.” To show 2 decimal places.
The filed would look like this:
$0000.00
This field is 8 characters long if you include the “$” and the “.”
C00000 0000C<CR>
This will cause the Cost Counter to be removed from the LCD display.
Cost Start/Stop:
The “c” (lower case “C”) command is used to start and stop the Cost Counter.
Format:
cxy<CR>
c = “c”
x = Enable / Disable
1 = Enable
0 = Disable
y = Optional command.
If this character is a “C” then the counter will also be cleared.
If this character is an “S” then the counter will be preset to the
incremental amount (see AA from the “C” command above.
Response:
^c<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
c1C<CR>
This causes the cost counter to be cleared, and then begin counting up.
c0<CR>
This causes the cost counter to stop counting.
c1S<CR>
This will cause the counter to be preset to the amount previously entered
from the “C” command (“AA” field above), and then begin counting.
Prepaid:
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
8
The “P” command controls how the costing of a call is done. Costing can be done in two
ways. Standard Cost Mode and Prepaid Cost Mode.
In Standard Mode, the cost counter counts up from zero to tally the total amount of
the calls placed by the user.
In Prepaid Mode, the cost counter is preset to an amount (the amount deposited by
the user) and the proceeds to count down, subtracting amounts from the total to
provide to the user the amount of money he has left.
Format:
Pxxxxxxxx<CR>
P = “P”
X = 8 digit amount with leading zeros.
This is the total to be displayed by the “C” command above.
Response:
^P<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
P00000000<CR>
This command sets the prepaid amount to zero, and so turns off the prepaid
function. The Cost Counter will act in Standard Mode,
P00002000<CR>
This command will set the prepaid amount to 2000 units. If we were working
in dollars, then this would represent $20.00. Because the command sets a
value of greater than zero into the prepaid field, the Cost Counter will work in
Prepaid Mode,
Begin Call/End Call:
The “B” command causes both the duration counter and the cost counter to begin
simultaneously. This is very helpful to “begin” a call or “end” a call, as both counters stop at
exactly the same time.
Format:
Bxyz<CR>
B = “B”
x = Begin / End
1 = Begin
0 = End
y = Optional command to control how the call is charged.
If this character is a “C” then the Cost Counter will also be
cleared. In Standard Cost Mode this means setting the Cost
Counter to zero. In Prepaid Cost Mode, this means presetting
the Cost Count to Prepaid amount.
If this character is a “S” then the cost counter will be
incremented/decremented by the cost “Amount” (see the “C”
command). In Prepaid Cost Mode, the “Amount” is immediately
subtracted from the Cost
Counter. In Standard Cost
A7- 3375 orth Service Road, Burlington O Canada L7 3G2
Phone +905.336.2450
Fax +647-436-6954
Web www.telcomresearch.com
Page
9
Mode, the “Amount” is immediately added to the Cost Counter.
Z = Optional command to control the Duration Counter.
If this character exists and is an “R” then the duration counter
will be reset to zero.
Response:
^B<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
B1CR<CR>
This will cause both the Duration Counter and the Cost Counter to begin
timing and pricing a call. The Duration counter will be reset to zero at the
start and the Cost Counter will be cleared. In Standard Cost Mode this means
setting the Cost Counter to zero. In Prepaid Cost Mode, this means presetting
the Cost Count to Prepaid amount.
B0<CR>
This will cause both the duration counter and the cost counter to stop
counting.
B1S<CR>
This will cause both the duration counter and the cost counter to start
counting. either counter will be altered first, so that if there was a duration
on the Duration Counter, it will simply be added to. Likewise if a cost already
existed on the Cost Counter (from a previous call) then the counter will
simply add to this cost. This is usually used when you want to show the user
the total duration and cost of all his calls, and this command would be used to
start second or subsequent call.
View Digits Dialed:
The “V” command displays the “Digits Dialed” field on the LCD at the location of your
choice.
Format:
VRCC<CR>
V = “V”
R = Row (1 for line 1 and 2 for line 2)
CC = Column (01 to 16)
Response:
^V<CR>
The CallShop Fone Display will respond with this confirmation message
Example:
V203<CR>
Display the digits dialed field on line 2 starting at column 3 of the LCD
display.
V000<CR>
Turn off the digits dialed field.
Table of contents
