View Categories

DECT Handset: Account Registration

10 min read

Introduction #

Any handset must get assigned an individual SIP account. After registering the handset to the system, the handset can be assigned an account for receiving and sending VoIP connection.

Supported Accounts #

The number of registered accounts must meet the following:

  1. W70B
    Assigned Account(s) Registered Accounts on W70B
    W73P/W76P/W79P/W53H/DDPhone/CP935W Base CP930W Base
    10 1 10
  2. W80 Multi-Cell System
    Registered Accounts on W80DM Assigned Account per Handset
    100 Only one
  3. W90 Multi-Cell System
    Registered Accounts in W90 Multi-Cell System Registered Accounts in VIM System Assigned Account per Handset
    250 2500 Only one

SIP Server Template Configuration #

Description #

You can use up to ten different SIP servers in the system. You can pre-configure up to 10 SIP server templates for choosing when registering SIP accounts.

Configuration #

Set via the Web User Interface

  1. On the web user interface, go to Handset & Account > SIP Server Settings > Edit.
    Parameter Description
    Template Name It sets the name of the SIP server template.
    Server Host It configures the IP address or domain name of the SIP server in which the account is registered.
    Port It configures the port of the SIP server in which the account is registered.
    Transport It configures the type of transport protocol.
    Server Expires It configures the registration expiration time (in seconds) of SIP server x.
    Server Retry Counts It configures the retry times for the device to resend requests when the SIP server x is unavailable or there is no response from the SIP server x. The handset moves to the next available server after three failed attempts.
    Enable Outbound Proxy Server It enables or disables the device to send requests to the outbound proxy server.
    Outbound Proxy Server 1 It configures the IP address or domain name and the port of the outbound proxy server x.

    NOTE

    It works only if template.X.outbound.enable is set to 1 (Enabled).
    Outbound Proxy Server 2 It configures the IP address or domain name and the port of the outbound proxy server x.

    NOTE

    It works only if template.X.outbound.enable is set to 1 (Enabled).
    Proxy Fallback Interval It configures the time interval (in seconds) for the device to detect whether the working outbound proxy server is available by sending the registration request after the fallback server takes over call control.

Auto Provisioning

template.X.name
template.X.sip_server.Y.address
template.X.sip_server.Y.port
template.X.sip_server.Y.transport_type
template.X.sip_server.Y.expires
template.X.sip_server.Y.retry_counts
template.X.nat.traversal
template.X.outbound.enable
template.X.outbound.Y.address
template.X.outbound.Y.port
template.X.outbound.fallback_interval
Parameter Permitted Values Default Description
template.X.name[1] String within 64 characters Blank It sets the name of the SIP server template.
template.X.sip_server.Y.address[1] [2] String within 64 characters Blank It configures the IP address or domain name of the SIP server Y in which the account is registered.
template.X.sip_server.Y.port[1] [2] Integer from 0 to 65535 5060 It configures the port of SIP server Y.
template.X.sip_server.Y.transport_type[1] [2] 0-UDP
1-TCP
2-TLS
3-DNS-NAPTR, if no server port is given, the device performs the DNS NAPTR and SRV queries for the service type and port.
0 It configures the type of transport protocol.
template.X.sip_server.Y.expires[1] [2] Integer from 30 to 2147483647 3600 It configures the registration expiration time (in seconds) of SIP server Y.
template.X.sip_server.Y.retry_counts[1] [2] Integer from 0 to 20 3 It configures the retry times for the device to resend requests when the SIP server Y is unavailable or
there is no response from the SIP server Y.
The handset moves to the next available server after three failed attempts.
template.X.nat.traversal[1] [2] Integer from 0 to 20 3 It configures the retry times for the device to resend requests when the SIP server Y is unavailable or
there is no response from the SIP server Y.
template.X.outbound.enable[1] 0-Disabled
1-Enabled
0 It enables or disables the device to send requests to the outbound proxy server.
template.X.outbound.Y.address[1] [2] String within 64 characters Blank It configures the IP address or domain name of the outbound proxy server Y.

NOTE

It works only iftemplate.X.outbound.enable is set to 1 (Enabled).
template.X.outbound.Y.port[1] [2] Integer from 0 to 65535 5060 It configures the port of the outbound proxy server Y.

NOTE

It works only if template.X.outbound.enable is set to 1 (Enabled).
template.X.outbound.fallback_interval[1] Integer from 30 to 2147483647 3600 It configures the time interval (in seconds) for the device to detect whether the working outbound proxy server is available by sending the registration request after the fallback server takes over call control.

[1]X is the template ID. X=1-30.
[2]Y is the server ID. Y=1-2.

Accounts Registration Configuration #

Set via the Web User Interface

  1. For W70B: On the web user interface, go to Account > Register.
  2. For W80/90 Multi-Cell System: On the web user interface, go to Handset & Account > Handset Registration > Add Handset/Edit.

Auto Provisioning

account.X.enable
account.X.label
account.X.display_name
account.X.auth_name
account.X.user_name
account.X.password
account.X.sip_server.template
account.X.reg_fail_retry_interval
account.X.reg_failed_retry_min_time
account.X.reg_failed_retry_max_time
Parameter Permitted Values Default Description
account.X.enable[1] 0-Disabled
1-Enabled
0 It defines the activation status of the account.
account.X.label[1] String within 99 characters Blank It configures the display label of the account.
account.X.display_name[1] String within 99 characters Blank It configures the display name of the account.
account.X.auth_name[1] String within 99 characters Blank It configures the user name for authentication registration.
account.X.user_name[1] String within 99 characters Blank It configures the user name of the account.
account.X.password[1] String within 99 characters Blank It configures password of the account.
account.X.sip_server.template[1] Integer from 1 to 10 1 It configures which SIP server template to use for registering an account.
account.X.reg_fail_retry_interval[1] Integer from 0 to 1800 30 It configures the re-registration period (in seconds) after the account registration fails.

NOTE

It works only if account.X.reg_failed_retry_min_time and account.X.reg_failed_retry_max_time are set to 0.
account.X.reg_failed_retry_min_time[1] Integer greater than or equal to 0 0 It configures the base time to wait (in seconds) for the phone to retry to re-register after the account registration fails.

NOTE

It is used in conjunction with the parameter account.X.reg_failed_retry_max_time to determine how long to wait. The algorithm is defined in RFC 5626. We recommend that you set this value to an integer between 10 to 120 if needed. If the values of this parameter and the parameter account.X.reg_failed_retry_max_time are set to 0, the interval configured by account.X.reg_fail_retry_intervalwill be used.
account.X.reg_failed_retry_max_time[1] Integer greater than or equal to 0 60 It configures the maximum time to wait (in seconds) for the phone to retry to re-register after the account registration fails.

NOTE

It is used in conjunction with the parameter account.X.reg_failed_retry_min_time to determine how long to wait. The algorithm is defined in RFC 5626. We recommend that you set this value to an integer between 60 to 1800 if needed. If the values of this parameter and the parameter account.X.reg_failed_retry_min_time are set to 0, the interval configured by account.X.reg_fail_retry_interval will be used.

[1]X is the account ID.

  • For W70B, X=1-10.
  • For W80 multi-cell system, X=1-100.
  • For W90 multi-cell system, X=1-250.
  • For VIM system, X=1-2500.

[2]Y is the server ID. Y=1-2.

Registration Settings Configuration #

The following table lists the parameters you can use to change the registration settings.

Set via the Web User Interface

  1. For W70B: On the web user interface, go to Account > Advanced.
  2. For W80/90 Multi-Cell system: On the web user interface, go to Handset & Account > Handset Registration > Add Handset/Edit.

Auto Provisioning

account.X.enable_user_equal_phone
account.X.register_mac
account.X.register_line
account.X.unregister_on_reboot
account.X.sip_server_type
sip.reg_surge_prevention
account.X.subscribe_register
phone_setting.disable_account_without_username.enable
account.X.register_expires_overlap
account.X.subscribe_expires_overlap
Parameter Permitted Values Default Description
account.X.enable_user_equal_phone[1] 0-Disabled
1-Enabled
0 It enables or disables the phone to add “user=phone” to the SIP header of the INVITE message.
account.X.register_mac[1] 0-Disabled
1-Enabled
0 It enables or disables the phone to add MAC address to the SIP header of the REGISTER message.
account.X.register_line[1] 0-Disabled
1-Enabled
0 It enables or disables the phone to add a line number to the SIP header of the REGISTER message.
0-99 stand for line1-line100.
account.X.unregister_on_reboot[1] 0-Disabled
1-Enabled
0 It enables or disables the phone to unregister first before re-registering account X after a reboot.
account.X.sip_server_type[1] 0-Default
2-BroadSoft (It works only if bw.enable is set to 1 (Enabled))
8-Genesys
10-Genesys Advanced
0 It configures the type of SIP server.
sip.reg_surge_prevention[2] Integer from 0 to 60 0 It configures the waiting time (in seconds) for account register after startup.
account.X.subscribe_register[1] 0-Disabled
1-Enabled
0 It enables or disables the phone to subscribe to the registration state change notifications.
phone_setting.disable_account_without_username.enable 0-Disabled
1-Enabled
0 It enables or disables the phone to disable the account whose username is empty.
account.X.register_expires_overlap[1] Positive integer and -1 -1 It configures the renewal time (in seconds) away from the registration lease.
account.X.subscribe_expires_overlap[1] Positive integer and -1 -1 It configures the renewal time (in seconds) away from the subscription lease.

[1]X is the account ID.

  • For W70B, X=1-10.
  • For W80 multi-cell system, X=1-100.
  • For W90 multi-cell system, X=1-250.
  • For VIM system, X=1-2500.

[2]If you change this parameter, the phone will reboot to make the change take effect.

Account Registration File Customization #

You can ask the distributor or Yealink FAE for the account registration template (Account_configuration.csv).

Before You Begin

This feature is only applicable to W80/W90 Multi-Cell System.

Account Registration File Elements #

The following table lists the elements and attributes you can use to assign accounts for handsets in the account registration file. We recommend that you do not edit these attributes.

Attributes Description
account Specify the account ID (1-100).
This is required. If not filled, the line will not take effect.
ipui Specify the IPUI of the handset to which you want to assign the account.
reg.enable Enable or disable the registration status for the handset.
auth_name Specify the register name of the account.
user_name Specify the user name of the account.
password Specify the password of the account.
display_name Specify the display name of the account.
label Specify the label of the account.
enable Specify the activation status of the account.
sip_server.template Specify the SIP server template.

Customize Account Registration File #

  1. Open the account registration file.
  2. Specify the account information. For example:

3. Save the changes.

Account Registration File Upload #

You can upload account registration file to register accounts in batches and associate the account with the handset IPUI.

Before You Begin

This feature is only applicable to W80/W90 Multi-Cell System.

Set via the Web User Interface

  1. On the web user interface, go to Handset & Account > Handset Registration > Import.

Auto Provisioning

ipui_account.data.url
Parameter Permitted Values Default Description
ipui_account.data.url String within 512 characters Blank It configures the access URL of the custom account registration file (*.csv).
Twisted VoIP