====== Автоматическая настройка телефонов ======

**Autoprovisioning Plug & Play (PnP)**, эту технологию поддерживают многие производители — **Yealink**, **Snom**. Телефоны этих производителей могут быть настроен текущей версией модуля. 

Основные достоинства автоматической настройки телефонов:

  * **Облегчает первичную настройку** — не требуется заходить в web интерфейс каждого устройства. Достаточно на сервере автонастройки указать соответствие MAC адреса устройства и акканута.
  * **Упрощает поддержку** — действительно становится легче при необходимости изменить настройки устройства. Управляем настройками опять же на сервере
  * **Возможно свести настройку к набору старкода** «*911*<SIP_ACC>» — в ряде случаев этой функции просто цены нет. Не каждый офисный работник сможет настроить IP телефон, а вот набрать комбинацию цифр задача простая.

Подробнее о принципах работы можно почитать в статье [[https://habr.com/ru/post/471522/ | Как работает Autoprovisioning Plug & Play]]

===== Системные требования =====

  * Модуль может работать **только** в локальной сети
  * В сети должны быть разрешены **multicast запросы на IP 224.0.1.75**
  * На текущий момент в качестве адреса регистрации можно задать только одно общее значение для всех устройств
  * На АТС должны быть открыты порты web интерфейса (**HTTP**) и **SIP** - 80 и 5060
  * Работа по **HTTPS пока не поддерживается**
  * В сети не должно быть запущено других PnP серверов. Устройство будет получать настройки от первого ответившего сервера
===== Поддерживаемые телефоны =====
  * Yealink T19(P)
  * Yealink T28(P)
  * Yealink W52
  * Yealink WP530
  
  * Snom D120
  * Snom D785
  * Snom D735
  * Snom D715
  * Snom D385
  * Snom D335
  
  * Fanvil X5U
  * Fanvil X3SP
  * Fanvil X1SP

<note important>Мы обязательно будем расширять линейку поддерживаемых телефонов.</note>

===== Настройка модуля =====

  - Перейдите в интерфейс "**Модули**" - "**Управление модулями**"
  - Установите модуль "Модуль автоматической настройки телефонов" 
  - **Запускайте модуль только после завершения его настройки**
  - Перейдите к его интерфейсу: {{ ::autoprov_10002.jpg |}}
  - **Шаблон внутреннего номера** - укажите добавочны номер для возможности настройки телефона старкодом
  - **Адрес сервера для регистрации телефонов** - ip или имя сервера MikoPBX. По этому адресу будут подключаться телефоны к АТС
  - **Черный список MAC адресов телефонов** - перечислите MAC телефонов, которые НЕ требуется настраивать Это список описывает исключения. Черный список имеет более высокий приоритет, чем белый
  - **Белый список MAC адресов телефонов** - ограничте настраиваемые телефоны только перечисленными
<note important>Если **Черный** и **Белый** списки не настроены, то модуль будет пытаться настроить все телефоны.</note>

===== Анализ проблем с Yealink =====
<note tip>Первым делом, убедитесь, что используете актуальную версию прошивки телефона. 

http://support.yealink.com</note>

  - Перейдите в web интерефс устройства
  - Перейдите в меню "**Настройки**" - "**Конфигурация**" {{ ::autoprov_2.jpg |}}
  - Включите уровень журнала на максимальное **значение 6**
  - **Перезагрузите** устройство
  - Выполните действие "**Экспорт**"

В скачанном логе следует обратить внимание на строки вида:
<code>
LIBD[528]: HTTP<5+notice> URL : http://172.16.32.105:56080/y000000000000.cfg
LIBD[528]: HTTP<3+error > Connect Error
AUTP[528]: AUTP<3+error > http to file failed, code = -3, msg = Connect Failed, cout = 0
</code>
Видно, что телефон попытался скачать конфигурационный файл с 172.16.32.105:56080. В моем случае это был сервер со старой Askozia 4. 

Корректный ответ должен выглядеть следующим образом:
<code>
Oct 17 11:26:58 LIBD[548]: HTTP<5+notice> URL : http://172.16.32.225:80/pbxcore/api/modules/ModuleAutoprovision/...
Oct 17 11:26:58 LIBD[548]: DCMN<6+info  > Connecting 172.16.32.225:80
Oct 17 11:26:58 LIBD[548]: DCMN<6+info  > Connecting IP = 172.16.32.225, Port = 80
Oct 17 11:26:58 LIBD[548]: HTTP<6+info  > Request Line: GET /pbxcore/api/modules/ModuleAutoprovision/...
Oct 17 11:26:58 LIBD[548]: HTTP<6+info  > Host: 172.16.32.225
Oct 17 11:26:58 LIBD[548]: HTTP<6+info  > User-Agent: Yealink SIP-T28P 2.72.14.2 00:15:65:18:72:eb
Oct 17 11:26:58 LIBD[548]: HTTP<6+info  > process response
Oct 17 11:26:58 LIBD[548]: HTTP<5+notice> response code: 200
Oct 17 11:26:58 LIBD[548]: HTTP<6+info  > Content-Length: 961
Oct 17 11:26:58 LIBD[548]: HTTP<5+notice> response process finish!
Oct 17 11:26:58 LIBD[548]: HTTP<5+notice> recv : 961 bytes
Oct 17 11:26:58 AUTP[548]: AUTP<6+info  > download file success!!
</code>

===== Дополнительные параметры конфигурации телефонов =====
В поле "**Дополнительные параметры**" допускается описать произвольные настройки для конфигурационных файлов телефонов. 

==== Yealink ====
Сервер по умолчанию генерирует следующий конфигурационный файл:

<code>
#!version:1.0.0.1
account.1.enable = 1
account.1.label = Askozia (204)
account.1.display_name = 204
account.1.auth_name = 204
account.1.user_name = 204
account.1.password = 1c9709222690713dd
account.1.sip_server_host = 172.16.156.223
account.1.sip_server_port = 5060
account.1.transport = 0
account.1.codec.1.enable = 1
account.1.codec.1.payload_type = PCMU
account.1.codec.1.priority = 1
account.1.codec.1.rtpmap = 0
account.1.cid_source = 4
voice_mail.number.1 = *001
phone_setting.lcd_logo.mode=0
auto_provision.dhcp_option.enable = 0
features.intercom.allow = 1
features.intercom.mute = 0
features.intercom.tone = 1
features.intercom.barge = 1
features.dtmf.transfer = ##
features.dtmf.replace_tran = 1
features.headset_prior = 1
features.intercom.allow = 1
</code>

К нему можно добавить в конец произвольный набор параметров. Для этого необходимо в поле "**Дополнительные параметры**" описать секцию "**[yealink]**". Пример:

<code>
[yealink]
features.headset_prior = 1
features.intercom.allow = 1
</code>

Каждый новый параметр выделяется отдельной строкой. 

Ссылка на [[http://support.yealink.com/documentFront/forwardToDocumentDetailPage?documentId=78#userdocument | сайт поддержки Yealink]] 

==== Snom ====

Пример файла конфигурации:
<code>
<?xml version="1.0" encoding="utf-8"?>
<settings>
<time_24_format perm="R">off</time_24_format>
    <phone-settings>
        <user_pname idx="1" perm="RW">203</user_pname>
        <user_name idx="1" perm="RW">203</user_name>
        <user_realname idx="1" perm="RW">Smirnova Irina Aleksandrovna</user_realname>
        <user_pass idx="1" perm="RW">3256157a99f176eb959ef9c1fdd947f0</user_pass>
        <user_host idx="1" perm="RW">172.16.32.225</user_host>
        <user_srtp idx="1" perm="RW">off</user_srtp>
        <user_mailbox idx="1" perm="RW">*001</user_mailbox>
        <user_dp_str idx="1" perm="RW">!([^#]%2b)#!sip:\1@\d!d</user_dp_str>
        <contact_source_sip_priority idx="INDEX" perm="PERMISSIONFLAG">PAI RPID FROM</contact_source_sip_priority>
        <answer_after_policy perm="RW">idle</answer_after_policy>

    </phone-settings>
</settings>

</code>

Файл имеет более сложную структуру, чем у Yealink. 

Для добавления данных в узел "**<settings>**" следует описать секцию "**[snom]**":
<code>
[snom]

 <tbook>
  <item context="line1" type="none" index="0">
   <name>Adrian</name>
   <number>42965</number>
  </item>
  <item context="active" type="colleagues" index="1">
   <name>Roland</name>
   <number>16424</number>
  </item>
 </tbook>

 <dialplan>
  <template match="0" timeout="4" scheme="sip" user="phone" rewrite="" />
  <template match="00" timeout="0" scheme="sip" user="phone" rewrite="" />
  <template match="011............" timeout="4" scheme="sip" user="phone" rewrite="" />
  <template match="*79" timeout="0" scheme="sip" user="phone" rewrite="" />
  <template match="*234" timeout="0" scheme="sip" user="phone" rewrite="" />
 </dialplan>
</code>

Для добавления данных в узел "**<phone-settings>**" следует описать секцию "**[snom-phone-settings]**":
<code>
[snom-phone-settings]
  <firmware_status perm="R">http://domain/snom/snom3x0-firmware.htm</<firmware_status>
  <update_policy perm="R">auto_update</update_policy>
  <firmware_interval perm="R">2880 </firmware_interval>
</code>
Документация доступна на сайте [[http://wiki.snom.com/Features/Auto_Provisioning/Configuration_Files/XML | wiki.snom.com ]]

==== Fanvil ====
Пример файла конфигурации:
<code>
<<VOIP CONFIG FILE>>Version:2.0002
PNP Enable         :0

<SIP CONFIG MODULE>
--SIP Line List--  :
SIP1 Enable Reg    :1
SIP1 Phone Number  :203
SIP1 Display Name  :Smirnova Irina Aleksandrovna
SIP1 Sip Name      :203
SIP1 Register Addr :172.16.156.223
SIP1 Register Port :5060
SIP1 Register User :203
SIP1 Register Pswd :3256157a99f176eb959ef9c1fdd947f0
SIP1 MWI Num       :*001
SIP1 Proxy User    :
SIP1 Proxy Pswd    :
SIP1 Proxy Addr    :


<TELE CONFIG MODULE>
SIP1 Caller Id Type:4
P1 Enable Intercom :1
P1 Intercom Mute   :0
P1 Intercom Tone   :1
P1 Intercom Barge  :1


<AUTOUPDATE CONFIG MODULE>
PNP Enable         :1
PNP IP             :224.0.1.75
PNP Port           :5060
PNP Transport      :0
PNP Interval       :1


<<END OF FILE>>
</code>

Принцип кастомизации схож. В поле "Дополнительные параметры" есть возможность описать следующие секции:
  * **[fanvil]** - добавляет конфигурацию в начало файла
  * **[fanvil-sip]** - добавляет строки конфигурации в конец раздела "**<SIP CONFIG MODULE>**"
  * **[fanvil-tele]** - добавляет строки конфигурации в конец раздела "**<TELE CONFIG MODULE>**"
  * **[fanvil-autoupdate]** - добавляет строки конфигурации в "**<TELE CONFIG MODULE>**"