API Commands
12
40-400-00025, Rev. D
TC_DISPLA
TC_DISPLA
TC_DISPLA
TC_DISPLA
TC_DISPLAY
Y
Y
Y
Y
F
F
F
F
For
or
or
or
ormat
mat
mat
mat
mat
TC_DISPLAY,type,message
Descr
Descr
Descr
Descr
Description
iption
iption
iption
iption
Displays a message on the TLE front-panel display. If type is TP_SYSTEM, the message is
displayed starting at the upper left and uses the entire display. If type is TP_LINE1-TPLINE4,
the message is displayed in the appropriate quadrant of the display for the selected line.
System messages are displayed for 1 second, then the display reverts to the individual line
messages. Line messages are displayed until replaced by new line messages.
P
P
P
P
Par
ar
ar
ar
arameter
ameter
ameter
ameter
ameter
Type: type of message
TP_SYSTEM
TP_LINE1
TP_LINE2
TP_LINE3
TP_LINE4
Message: message to display
If type is TP_SYSTEM, 0-40 characters, else 0-10 characters
Note
Note
Note
Note
Note
The TLE Display message type is broken into 2 types, TLE status messages (Onhook,
Offhook, Ringing, etc..), and User generated messages, of which there are two types. User
generated Line Messages broken into four 10 character sets (which remain in the display
until updated), and a User generated System Message, a 40 character set that is displayed
for 1 second. The TLE remembers what message type (status vs. user) was in the Display
when a TP_SYSTEM message is displayed for 1 second, and returns that message after the
TP_SYSTEM message is complete. However, if a user generated message (e.g. TP_LINE1)
was in the TLE Display when a TP_SYSTEM message is sent, then the TLE remembers and
displays the user specified portion of the TP_SYSTEM message in the 10 character quadrant
until updated. Confused? Let’s look at the examples for clarification.
Example
Example
Example
Example
Example
Current message in display window for all four 10 character sets is “Onhook”.
This command displays any text entered for one second:
TC_DISPLAY,TP_SYSTEM,Teltone Corporation Bothell, Washington
Teltone Corporation Bothell, Washington
and then the display returns to:
Onhook Onhook
Onhook Onhook
This command places “Hello” in the lower right quadrant left justified in the 10 character
set:
TC_DISPLAY,TP_LINE3,Hello
Now if we repeat the TP_SYSTEM message as shown above, the TLE Display will show:
Teltone Corporation Bothell, Washington
Then after 1 second:
Onhook Onhook
Onhook Ohook
After a device connected to Line 3 goes off-hook, the display is updated and displays:
Onhook Onhook
Onhook Offhook