Phone Control

DV2000/DV4 provides support for setting call restrictions on guest room phones when integrating with certain PBX systems. The Phone Control dialog is used to configure the relevant options related to this feature, including whether a call accounting system is involved.

To configure the communication layer for the given PBX, refer to the Connectors dialog instead.

PBX

Select your PBX type from the drop-down list provided. If your PBX is not listed, then phone status control may not be supported for that PBX system at this time; contact your authorized DuVoice reseller for assistance.

If phone control is not supported or not used at your site, select --none-- from the list (if it is not already selected by default).

Some PBX systems may require special drivers or other software in order for the DV2000/DV4 to link to the PBX in a way that allows for phone control (for example, a TAPI link may be required); see Connectors for more information.

Protocol	Comments
Avaya ACM	Select this option for any Avaya ACM PBX. May work with some Avaya Definity systems as well. Does not support normal or transparent mode; only ASCII mode.
Avaya IP Office	Select this option for any Avaya IP Office PBX.
Cisco	Select this option for the Cisco Unified Communications Manager PBX (CUCM)
Mitel	Select this option for any Mitel PBX that supports the SX-2000 Light protocol.
NEC KTS-i (5-digit)	Select this option for any NEC PBX that supports the KTS-i w/ENQ protocol. Note: There are two versions of the KTS-i protocol: one using 5-digit extension numbers and one that uses 8-digit extensions. The DV2000/DV4 only supports the 5-digit extension version of this protocol.
NEC NEAX 60	Select this option for any NEC PBX that supports the NEC NEAX Model 60 protocol. Note: Only Model 60 commands are supported. Commands unique to the Model 90 will be ignored.
Nortel	Select this option to connect with a Nortel Meridan 1 or Communication Server 1000 PBX that supports the Nortel protocol defined in document NN43001-553 (Release 7.0, Document Revision 04.01).
Panasonic	Select this option for any Panasonic KX-TDA (or similar model). Requires the use of TAPI.
ShoreTel	Select this option for any ShoreTel PBX.
Sphere	Select this option for any NEC Sphere PBX.
Vodavi	Select this option for any Vodavi PBX that supports changing the extension COS via inband dial strings.
SIEMENS	Select this option for any supported SIEMENS PBX.
HTTP Post	Select this option for the IPitomy PBX or any other PBX that supports the HTTP Name Post protocol.

Auto-set phone state on

Configure these automation settings to indicate whether the system should automatically change the call restriction status for guest rooms at check in and check out. Check the box provided to enable the feature, then use the associated drop-down list to select which user group restriction should be assigned in that case. Selecting the --no change-- option is effectively the same as removing the check from the check box. The contents of the drop-down list is determined by the contents of the User group restrictions table.

Call accounting

The DV2000/DV4 is able to integrate with a couple of different call accounting systems (CAS) in such a way that the CAS tells the DV2000/DV4 what the user group restriction should be for each guest room, and the DV2000/DV4 passes that information on to the PBX.

Note: When call accounting is enabled, the Auto-set phone state on options will be disabled and any manual changes to phone status (e.g., via InnDesk) will be overridden by the value set by the CAS.

Setting	Description
Type	Select the call accounting package you are using from the list provided. If your CAS package is not listed, contact your authorized DuVoice reseller for assistance. If CAS integration is not in use, select --none-- to disable this feature.
Enabled	Select the user group restriction value to be applied when the CAS indicates the phone should be enabled. Selecting --no change-- will prevent the restriction value from ever being changed.
Disabled	Select the user group restriction value to be applied when the CAS indicates the phone should be disabled. Selecting --no change-- will prevent the restriction value from ever being changed.

Vodavi-specific settings

Unlike the other supported PBX systems, the Vodavi requires the DV2000/DV4 to send phone status changes to the PBX via inband DTMF signalling. The required dial string consists of a prefix code followed by the extension number followed by the day and night class of service codes. For example, the string 470,105,1,1 tells the Vodavi to change both the day and night COS assignments for extension 105 to COS 1. However, there are some situations where the prefix code is not 470. The Outdial prefix setting is provided so that you can change the prefix string if the default setting is not correct for your Vodavi installation.

Note: The DV2000/DV4 will automatically add a pause (comma) between the prefix string and the extension number when it builds the final dial string, so you do not have to include a comma in the prefix string itself unless you want an extra long pause.

This setting will be disabled (grayed-out) if the PBX type is not set to Vodavi.

User group restrictions

The user group restrictions table is used to map the supported PBX values to the supported PMS values, and also to provide the desired text to use whenever the system must display the phone status in a human-readable format. Note: Each PBX system for which the DV2000/DV4 currently supports the phone control feature may use slightly different terminology, such as: profile, class of service, group, call restriction level. For the most part, they mean essentially the same thing.

Note: When you select a PBX type, the user group restrictions table may be reset with some suggested default values for that PBX. You can always add to, edit or delete them as needed, unless otherwise noted.

Column	Description
Display Text	Enter a descriptive word or short phrase for this restriction level or user group.
PBX Value	Enter the value sent to the PBX to assign this restriction level or user group to the specified extension. This value may be either a digit or a text string, depending on the PBX. Since set restriction packets are never sent to the PMS, it is okay to have PBX values that do not match up to a PMS value. Such values can only be assigned via InnDesk or via the call accounting settings listed above.
PMS Value	Enter the value sent by the PMS to assign this restriction level or user group to the specified extension. If a PMS is being used and it can send messages to change the phone restriction level, and you are not using call accounting, always match each possible PMS value to a PBX value, even if you have to use the same PBX value for multiple PMS values. If you have enabled the call accounting option, then you only need two PBX values, one that equates to enabled and one that equates to disabled. The PMS value column can be left blank because the PMS should be setting the phone state via the call accounting software and not directly to the DV2000/DV4.
Active PMS	Displays the PMS protocol currently assigned to this hospitality server instance. Read-only.

Editing the User Group Restrictions Table

Option	Description
Edit a row	To edit the display text, PBX value or PMS value for an existing row, left-click on the given field to edit it in-place.
Add a row	To add a row, right-click anywhere on the table and select Add new row from the context menu. This will add a new row to the table with the text NEW ENTRY in the Display Text field and the other two fields will be blank. You can then left-click on each field to edit them.
Delete a row	To delete a row, right-click on it and select Delete selected row from the context menu.
Reset to defaults	To reset the entire table to the default entries for the given PBX and PMS protocol combination (if known), right-click anywhere on the table and select Reset to defaults from the context menu.

The Nortel and Vodavi PBX systems require that the PBX values be configured in a specific way. Refer to the following two sections for more details.

Configuring the Nortel profile string

In order for the system to correctly translate between PBX and PMS values when the Nortel PBX is selected, it is necessary to configure the PBX profile strings exactly as the Nortel protocol defines them. The exact meaning of each setting is configurable on the PBX; you will need to ascertain how the Controlled COS, System COS, Enhanced Level 1 COS and Enhanced Level 2 COS are each programmed on your Nortel PBX in order to match them up with the values sent by your PMS.

The table below shows the possible profile strings and their descriptions as provided in the Nortel interface specification:

Profile	Meaning
CO ON	Controlled COS On
E1 ON	Enhanced Controlled COS Level 1 On
E2 ON	Enhanced Controlled COS Level 2 On
CO OF	Controlled COS Off - equates to System COS in the PBX.
E1 OF	Enhanced Controlled COS Level 1 Off - equates to System COS in the PBX.
E2 OF	Enhanced Controlled COS Level 2 Off - equates to System COS in the PBX.

You may change the Display Text in the User Restrictions table to be anything you wish, but the Profile string must be one of the 6 possible choices listed in the table above. The PMS digit (or string) may vary depending on which PMS you are using and how it is configured.

Configuring the Vodavi profile string

For Vodavi, the DV2000/DV4 must dial a series of DTMF codes over an analog voice connection to the Vodavi PBX. Typically, this dial string will be:

where <ext> is the extension number, <day cos> is the daytime class of service and <night cos> is the nighttime class of service. However, on some versions of the Vodavi, this suffix string may be different. Consequently, you need to configure the profile string to be everything that comes after the <ext>, portion of the example dial string. Note that a pause (comma) is automatically added after the extension number, so you don't need to start the profile string with a comma.

By default, the DV2000/DV4 is configured assuming the following possible class of service values on the Vodavi (some versions of Vodavi may vary; consult the documentation for your PBX to verify the available classes and what they mean):

COS #	Meaning
1	No restrictions
2	Table A governs
3	Table B governs
4	Table A and B govern
5	Restricts 0, 1, * and # dialed as the first digit, with a 7-digit maximum
6	Intercom only (no CO line access - will block 911 unless 911 Feature is active - consult your Vodavi documentation)
7	Restricts 0, 1, *, and # dialed as the first digit, with a 10-digit maximum

The DV2000/DV4 defaults to assuming that the same COS will apply for both day and night, and will therefore use assign a profile string of 1,1 for restriction levels that equate to not restricted and will use 6,6 for restriction levels that equate to restricted. You can of course change the profile strings as needed.

Note: Since the actual dial string conventions may vary depending on the version of Vodavi installed, consult the documentation and/or configuration software for your Vodavi PBX to verify the classes of service available and how the dial string should be configured.