Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Auto provisioning works with Option 66 to allow a SIP phone or gateway to provision itself by loading a configuration file hosted on the Voiceware server. Use of this feature is encouraged because it will save a lot of time during and post installation.

Voiceware version 4.3.0.6 added the ability to set Ringdown (hotline) and the disconnect polarity (loop or ground). New template files for the Phonesuite and Grandstream gateways are available to make use of these features. See their sections below for more info.

How To:

Expand
titleSetup and use auto provisioning
  1. Enable option 66 is the local firewall and point it to the Voiceware server.

    1. See Option 66 section below for the correct option 66 string format.

  2. Setup a user, device, and endpoint in Voiceware

    1. Ensure that the correct device is selected from the template drop down

  3. Plug in the device, it should pull its configuration from Voiceware, reboot once or twice, and then be fully configured.

...

Expand
titleVtech Phones

Vtech Snom

V 1.0 20190218

  • Created the phone template

V 1.1 20190715

  • Added the ability to disable the PC port

V 1.2 20190808

  • Changed the default clock display to 12-hour format

V 1.3 20190913

  • Added a flag to set the phone to accept paging calls, it’s called answer_after_policy.

  • Improved the way that the digit map is handled (faster dial upon pattern match).

V 1.4 20200221

  • Added three template default digit maps to help aid in dialing. These improvements include [8-9]011.....*, [8-9]......*, and * with a timeout of 10 seconds.

  • Edited the numbers the phone thinks are emergency numbers to remove 112 and 999 and add 8911 and 9911.

V 1.5 20210212

  • Set the default ring tone to tone 9 for all lines.

  • Made *97 the default directed call prefix.

  • Set speed dials to type BLF, not Extension.

V 1.6 20210402

  • Added a setting so the phone will automatically refresh its settings once every two hours. This was done so that settings changes made to the Endpoint in Voiceware will take effect automatically without requiring the user to reboot their phone.

V 2.0 20221028 (Tested on firmware 10.1.127.10, 10.1.119.10, and 10.1.33.3)

  • Created a separate file for the D713, D717, D735, and D785. This removes the need to set DHCP option 66 with a Vtech specific value.

Vtech_S2XXX

V1.2 20210618

  • Updated template so that unsupported options are hidden in the Voiceware GUI.

V 1.1 20180801

  • Added support for the config version number, previously it was hard coded to 999

VPS715

V 1.4 20171115

  • Added support for call waiting tone enable / disable via the GUI

  • Changed clock to 12-hour format

  • Changed date format to MM/DD/YY

VSP725

V 1.3 20171115

  • Added support for call waiting tone enable / disable via the GUI

  • Changed clock to 12-hour format

  • Changed date format to MM/DD/YY

VSP726

V 1.4 20171115

  • Added support for call waiting tone enable / disable via the GUI

  • Changed clock to 12-hour format

  • Changed date format to MM/DD/YY

  • Changed adaptive jitter delay to 30 and target to 45

  • Set to auto configure nightly and update its configuration

VPS736

V 1.3 20171115

  • Added support for call waiting tone enable / disable via the GUI

  • Changed clock to 12-hour format

  • Changed date format to MM/DD/YY

  • Changed adaptive jitter delay to 30 and target to 45

  • Set to auto configure nightly and update its configuration

Vtech LS-S3410

Version 1.1 20210618

  • Updated template so that unsupported options are hidden in the Voiceware GUI.

Vtech CTM-S2315

Version 1.0 20210624

  • Built on firmware 2.18.2.0

  • Speed dial keys are assigned M1, M2, M5, M6, M7, M8

  • Note that the emergency extension must be manually set in the template file, not via the Voiceware GUI.

  • Time zone must be manually set in the template file.

Vtech CTM-S2116

Version 1.0 20210624

  • Built on firmware 2.18.6.0

  • Speed dial keys are assigned Front Desk, room Service, Restaurant, Housekeeping, Valet

  • Note that the emergency extension must be manually set in the template file, not via the Voiceware GUI.

  • Time zone must be manually set in the template file.

Vtech CTM-S2411-L

Version 1.0 20210624

  • Built on firmware 2.19.0.0

  • Speed dial keys are assigned lower row left to right, upper row left to right, top down buttons right of key pad.

  • Note that the emergency extension must be manually set in the template file, not via the Voiceware GUI.

  • Time zone must be manually set in the template file.

Vtech CTM-S2415

Version 1.0 20210624

  • Built on firmware 2.18.4.0

  • Speed dial keys are assigned HS M1, M2, BS 1-4.

  • Note that the emergency extension must be manually set in the template file, not via the Voiceware GUI.

  • Time zone must be manually set in the template file.

Vtech M500 Base Station

Version 1.0 20230825. Tested on firmware 1.11.3

  • Auto provision uses option 159NOT 66 as normal.

  • Auto provision is set to disabled after initial configuration.

  • Must use /{mac}.xml in the provisioning URL.

  • A devices display name should be shorter, the name “Jonothon Starsmore” was to long and did not display on the phones (desk and cordless).

  • Speed dials and additional line keys must be manually set by logging into the base station for each hand or desk set.

...

Expand
titleGrandstream

Grandstream 4216

Version 1.1 20210805

  • Tested on firmware 1.0.19.4

  • Set the template to include a default digit map if none was set via the GUI. This fixes an issue where calls will not complete on newer versions of firmware for the gateway.

Version 1.2 20220825 (Tested on firmware 1.0.23.2)

  • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

  • Disabled SSH access

  • Set default web access to HTTPS

  • Disabled the user and viewer access (admin remains)

  • Disabled the DHCP time zone option

  • Disabled option 66 after initial configuration

Version 2.0 20221021 (Tested on firmware 1.0.23.5)

  • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

  • Removed ringdown settings so that the provisioning file will not override custom settings.

  • Set the DHCP time zone option to disabled.

  • Disabled option 66 after initial provision.

  • Disabled most call features like DID and Forward

Grandstream 4224

Version 12.1 20210805

  • Tested on firmware 1.0.19.4

  • Set the template to include a default digit map if none was set via the GUI.

    20240619

    • Added support for ring down with zero delay. (Starting at P4210, all FSX ports)

    • Added support for polarity settings. This setting utilizes different profiles in the gateway to apply features to each port individually.

      • Default: no change, use profile 1.

      • Loop: use profile 2, set Loop Current Disconnect (P893) to yes, set Loop Current Disconnect Duration (P857) to 5000.

      • Ground: use profile 3, set Polarity Reversal (P665) to yes.

    Grandstream 4224

    Version 1.1 20210805

    • Tested on firmware 1.0.19.4

    • Set the template to include a default digit map if none was set via the GUI. This fixes an issue where calls will not complete on newer versions of firmware for the gateway.

    Version 1.2 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DID and Forward

    • after initial provision.

    • Disabled most call features like DID and Forward

    Version 2.1 20240619

    • Added support for ring down with zero delay. (Starting at P4210, all FSX ports)

    • Added support for polarity settings. This setting utilizes different profiles in the gateway to apply features to each port individually.

      • Default: no change, use profile 1.

      • Loop: use profile 2, set Loop Current Disconnect (P893) to yes, set Loop Current Disconnect Duration (P857) to 5000.

      • Ground: use profile 3, set Polarity Reversal (P665) to yes.

    Grandstream 4232

    Version 1.1 20210805

    • Tested on firmware 1.0.19.4

    • Set the template to include a default digit map if none was set via the GUI. This fixes an issue where calls will not complete on newer versions of firmware for the gateway.

    Version 1.2 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DID and Forward

    • zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DID and Forward

    Version 2.1 20240619

    • Added support for ring down with zero delay. (Starting at P4210, all FSX ports)

    • Added support for polarity settings. This setting utilizes different profiles in the gateway to apply features to each port individually.

      • Default: no change, use profile 1.

      • Loop: use profile 2, set Loop Current Disconnect (P893) to yes, set Loop Current Disconnect Duration (P857) to 5000.

      • Ground: use profile 3, set Polarity Reversal (P665) to yes.

    Grandstream 4248

    Version 1.1 20210805

    • Tested on firmware 1.0.19.4

    • Set the template to include a default digit map if none was set via the GUI. This fixes an issue where calls will not complete on newer versions of firmware for the gateway.

    Version 1.2 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DID and Forward

    Version 2.1 20240619

    • Added support for ring down with zero delay. (Starting at P4210, all FSX ports)

    • Added support for polarity settings. This setting utilizes different profiles in the gateway to apply features to each port individually.

      • Default: no change, use profile 1.

      • Loop: use profile 2, set Loop Current Disconnect (P893) to yes, set Loop Current Disconnect Duration (P857) to 5000.

      • Ground: use profile 3, set Polarity Reversal (P665) to yes.

    Grandstream 4216_StaticIP

    Version 1.0 20211012

    • Tested on firmware 1.0.19.4

    • Template allows a static IP to be set.

    Version 1.1 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DND and Forward

    Grandstream 4224_StaticIP

    Version 1.0 20211012

    • Tested on firmware 1.0.19.4

    • Template allows a static IP to be set.

    Version 1.1 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DND and Forward

    Grandstream 4234_StaticIP

    Version 1.0 20211012

    • Tested on firmware 1.0.19.4

    • Template allows a static IP to be set.

    Version 1.1 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DND and Forward

    Grandstream 4248_StaticIP

    Version 1.0 20211012

    • Tested on firmware 1.0.19.4

    • Template allows a static IP to be set.

    Version 1.1 20220825 (Tested on firmware 1.0.23.2)

    • Removed the firmware upgrade URL so that firmware upgrades don’t happen automatically

    • Disabled SSH access

    • Set default web access to HTTPS

    • Disabled the user and viewer access (admin remains)

    • Disabled the DHCP time zone option

    • Disabled option 66 after initial configuration

    Version 2.0 20221021 (Tested on firmware 1.0.23.5)

    • Used the latest template version from Grandstream that organizes the P values into logical groupings and includes information about the settings and valid values.

    • Removed ringdown settings so that the provisioning file will not override custom settings.

    • Set the DHCP time zone option to disabled.

    • Disabled option 66 after initial provision.

    • Disabled most call features like DND and Forward

    Grandstream WP820

    Version 1.0 20210823

    • Tested on firmware 1.0.7.50

    • Note that when the phone configures it will set the server IP as its location to pull configuration files from and disable option 66. This way option 66 can be changed later and the phone will continue to pull configuration from the server.

    • Phone will check daily for new configurations in between the hours of 1 and 3am.

    • Note the digit map must be entered inside curly brackets (i.e. { 3xx | 4xx} otherwise it will not work and the default will remain in use. Note also that things outside the digit map can’t be dialed.

    ...