Prodys ProntoNet
This connection type controls and monitors a Prodys ProntoNet codec over its TCP control interface.
BTConnect polls the device regularly and exposes per-line status information as read-only parameters. It also provides write-only parameters for placing, answering, and hanging up calls.
Configuration
On the network tab, the following settings are available:
- Host: The IP address or host name of the ProntoNet device.
- Port: The TCP port of the ProntoNet control interface.
The default port is
50031.
On the settings tab, the following additional options are available:
- Poll Interval: The polling interval in seconds.
The default is
2. - Line Count: The number of codec lines to expose.
The default is
1; the maximum supported value is2.
When the connection is established, BTConnect performs the ProntoNet login handshake automatically and then starts polling the configured lines.
Parameters
For each configured line, the following parameters are created:
line/<id>/status(enum, read-only) - the current line status.line/<id>/connected(boolean, read-only) -truewhile the line is connected.line/<id>/number(string, read-only) - the current or last remote number reported by the device.line/<id>/disconnectioncode(integer, read-only) - the last disconnection code reported for the line.line/<id>/calltype(enum, read-only) - the current call type.line/<id>/outgoing/number(string, write-only) - the number to be used for the next outgoing call on that line.line/<id>/outgoing/calltype(enum, write-only) - the call type to be used for the next outgoing call on that line.line/<id>/action/call(trigger, write-only) - places a call using the currently configured outgoing number and call type.line/<id>/action/callfrombook(integer, write-only) - places a call using the specified phonebook entry number.line/<id>/action/answer(trigger, write-only) - answers an incoming call on the line.line/<id>/action/hangup(trigger, write-only) - hangs up the line.
The line index <id> starts at 1.
Enums
The status parameter uses the ProntoNet line status enum values, such as:
DisconnectedDisconnectingCallingReceivingCallConnected_CalledConnected_ReceivedCallRejectedNotAvailable
The calltype parameters use the ProntoNet IP call type enum values:
UnicastBidirectionalUnicastUnidirectional_TxMulticast_TxMulticast_RxUnicastUnidirectional_Rx
Typical Usage
To place a call on line 1:
- Set
line/1/outgoing/numberto the desired destination. - Optionally set
line/1/outgoing/calltype. - Trigger
line/1/action/call.
To answer or hang up a call, trigger line/1/action/answer or
line/1/action/hangup respectively.