Как изменить настройки телефона cisco

Время прочтения
13 мин

Просмотры 204K

В статье будут описаны нюансы настройки IP-телефона Cisco на примере цискофона 7942G.
Итак, если вы присматриваетесь к VoIP-устройствам Cisco серии 79XX, то добро пожаловать под кат.

Используется:

Cisco VoIP Phone 7942G
Asterisk 1.4.39
TFTP-server-0.49
Внимание! Инструкция подходит не для всех телефонов Cisco 79XX. См. здесь

Настройка

Комбинации клавиш в Cisco

**#** — перезагрузка телефона (через меню)
**# — разблокировка настроек (также через меню). Разблокировка нужна, например, для того чтобы поставить настройки DHCP-клиента

TFTP

Первое что нам понадобиться сделать — это настроить tftpserver. Я использовал стандартный линуксовый. Рекомендую сразу настроить, чтобы tftp-запросы записывались в лог-файл (по умолчанию /var/log/messages).
cat /etc/xinetd.d/tftp:
...
server_args = -s /tftpboot -v
...


Смена прошивки

Итак, сначала нужно разыскать нужную прошивку для работы по SIP, т.к. по умолчанию используется версия с SCCP. Для этого есть гугл или торренты.

Далее заходим на известный всем сайт voip-info.org. По ссылке выложена информация о прошивке. Т.к. у меня версия астериска 1.4 (которая не умеет работать по tcp), то советуют брать версию 8.5.4. По этой ссылке есть много и другой полезной информации.
Таким образом, нам нужен файл cmterm-7942_7962-sip.8-5-4.zip. Все файлы которые там есть нужно вывалить в корень тфтп-сервера.

Русская локаль

Еще бы нам не помешала русская локаль. Ну т.е. чтобы все надписи на экране были на русском языке.
Я её брал из файла po-locale-ru_RU-8.4.3.1000-1.exe (тоже можно найти в интернете). Тут есть одна хитрость — при запуске программы она вываливает ошибку и потом закрывается. Но нам ведь всего лишь нужны файлы локали, установить мы их можем и сами.
Поэтому после запуска идем в папку %TEMP% (советую предварительно её очистить) и смотрим что там программа вывалит.
Там в числе прочего будет папка Russian_Russian_Federation. Вот её нам и нужно будет поместить в корень tftp-сервера.
Версия локали будет как раз 8.4.3.1000-1.

Файл кофигурации цискофона

Теперь перейдем непосредственно к файлу конфигурации. Цискофон загружает его исключительно с tftp-сервера. Сначала кажется неудобно, с другой стороны, нужно настроить всего один раз, а затем можно эти телефоны хоть штабелями закупать — настройка их будет аналогичной и займет минимум времени. Кроме того, этим Cisco обезопасил телефон от «шаловливых ручек» пользователей. Через меню сделать практически ничего нельзя.
Файл должен называться SEP<MAC-адрес Cisco-телефона>.cnf.xml.
Мак-адрес записан на тыльной стороне устройства.
Определим некоторые значения:
$ASTERISK — ай-пи нашего астериска
$SERVICESURL — полный путь до скрипта, который генерирует адресную книгу (например, 192.168.0.22/asterisk/directory.php)
$ACCOUNT — пользователь/номер нашего аккаунта на астериске. Если у вас нет соответствия номер<=>пользователь, то конфиг нужно будет соответствующим образом поменять.
$ACCOUNT_PASS — пароль от SIP-аккаунта

<device>
    <fullConfig>true</fullConfig>
    <deviceProtocol>SIP</deviceProtocol>
    <devicePool>
        <dateTimeSetting>
            <dateTemplate>D.M.Y</dateTemplate>
            <timeZone>Ekaterinburg Standard Time</timeZone>
            <ntps>
                <ntp>
                    <name>$ASTERISK</name>
                    <ntpMode>Unicast</ntpMode>
                </ntp>
            </ntps>
        </dateTimeSetting>
        <callManagerGroup>
            <tftpDefault>true</tftpDefault>
                <members>
                <member priority="0">
                <callManager>
                <name>$ASTERISK</name>
                <description>CallManager 5.0</description>
                <ports>
                  <ethernetPhonePort>2000</ethernetPhonePort>
                  <sipPort>5060</sipPort>
                  <securedSipPort>5061</securedSipPort>
                </ports>
                <processNodeName>$ASTERISK</processNodeName>
                </callManager>
                </member>
                </members>
             </callManagerGroup>
    </devicePool>
    <commonProfile>
        <phonePassword></phonePassword>
        <backgroundImageAccess>true</backgroundImageAccess>
        <callLogBlfEnabled>0</callLogBlfEnabled>
    </commonProfile>
    <loadInformation>SIP42.8-5-4S</loadInformation>
    <loadInformation434  model="Cisco 7942">SIP42.8-5-4S</loadInformation434>
    <vendorConfig>
        <disableSpeaker>false</disableSpeaker>
        <disableSpeakerAndHeadset>false</disableSpeakerAndHeadset>
        <pcPort>0</pcPort>
        <settingsAccess>1</settingsAccess>
        <garp>0</garp>
        <voiceVlanAccess>0</voiceVlanAccess>
        <videoCapability>0</videoCapability>
        <autoSelectLineEnable>0</autoSelectLineEnable>
        <daysDisplayNotActive>1,7</daysDisplayNotActive>
        <displayOnTime>10:30</displayOnTime>
        <displayOnDuration>06:05</displayOnDuration>
        <displayIdleTimeout>00:05</displayIdleTimeout>
        <webAccess>1</webAccess>
        <spanToPCPort>1</spanToPCPort>
        <loggingDisplay>1</loggingDisplay>
        <loadServer></loadServer>
    </vendorConfig>

<userLocale> 
  <name>Russian_Russian_Federation</name> 
  <uid></uid> 
  <langCode>ru_RU</langCode> 
  <version>8.4.3.1000-1</version> 
  <winCharSet>utf-8</winCharSet> 
</userLocale>


<networkLocale>Russian_Federation</networkLocale> 
<networkLocaleInfo> 
  <name>Russian_Federation</name> 
  <uid></uid> 
  <version>8.4.3.1000-1</version> 
</networkLocaleInfo>
    
    <deviceSecurityMode>1</deviceSecurityMode>
    <idleTimeout>0</idleTimeout>
    <directoryURL></directoryURL> 
    <servicesURL>$SERVICESURL</servicesURL> 
    <idleURL></idleURL>
    <messagesURL></messagesURL>
    <proxyServerURL></proxyServerURL>
    <dscpForSCCPPhoneConfig>96</dscpForSCCPPhoneConfig>
    <dscpForSCCPPhoneServices>0</dscpForSCCPPhoneServices>
    <dscpForCm2Dvce>96</dscpForCm2Dvce>
    <transportLayerProtocol>2</transportLayerProtocol>
    <capfAuthMode>0</capfAuthMode>
    <capfList>
        <capf>
            <phonePort>3804</phonePort>
        </capf>
    </capfList>
    <certHash></certHash>
    <encrConfig>false</encrConfig>
    <sipProfile>
        <sipProxies>
            <backupProxy>$ASTERISK</backupProxy>
            <backupProxyPort>5060</backupProxyPort>
            <emergencyProxy>$ASTERISK</emergencyProxy>
            <emergencyProxyPort>5060</emergencyProxyPort>
            <outboundProxy>$ASTERISK</outboundProxy>
            <outboundProxyPort>5060</outboundProxyPort>
            <registerWithProxy>true</registerWithProxy>
        </sipProxies>
     <sipCallFeatures>
        <cnfJoinEnabled>true</cnfJoinEnabled>
        <callForwardURI>x--serviceuri-cfwdall</callForwardURI>
        <callPickupURI>x-cisco-serviceuri-pickup</callPickupURI>
        <callPickupListURI>x-cisco-serviceuri-opickup</callPickupListURI>
        <callPickupGroupURI>x-cisco-serviceuri-gpickup</callPickupGroupURI>
        <meetMeServiceURI>x-cisco-serviceuri-meetme</meetMeServiceURI>
        <abbreviatedDialURI>x-cisco-serviceuri-abbrdial</abbreviatedDialURI>
        <rfc2543Hold>false</rfc2543Hold>
        <callHoldRingback>2</callHoldRingback>
        <localCfwdEnable>true</localCfwdEnable>
        <semiAttendedTransfer>true</semiAttendedTransfer>
        <anonymousCallBlock>2</anonymousCallBlock>
        <callerIdBlocking>2</callerIdBlocking>
        <dndControl>0</dndControl>
        <remoteCcEnable>true</remoteCcEnable>
     </sipCallFeatures> 
     <sipStack>
        <sipInviteRetx>6</sipInviteRetx>
        <sipRetx>10</sipRetx>
        <timerInviteExpires>180</timerInviteExpires>
        <timerRegisterExpires>3600</timerRegisterExpires>
        <timerRegisterDelta>5</timerRegisterDelta>
        <timerKeepAliveExpires>120</timerKeepAliveExpires>
        <timerSubscribeExpires>120</timerSubscribeExpires>
        <timerSubscribeDelta>5</timerSubscribeDelta>
        <timerT1>500</timerT1>
        <timerT2>4000</timerT2>
        <maxRedirects>70</maxRedirects>
        <remotePartyID>false</remotePartyID>
        <userInfo>None</userInfo>
     </sipStack>
     <autoAnswerTimer>1</autoAnswerTimer>
     <autoAnswerAltBehavior>false</autoAnswerAltBehavior>
     <autoAnswerOverride>true</autoAnswerOverride>
     <transferOnhookEnabled>false</transferOnhookEnabled>
     <enableVad>false</enableVad> 
        <preferredCodec>g711alaw</preferredCodec>
       <dtmfAvtPayload>101</dtmfAvtPayload>
       <dtmfDbLevel>3</dtmfDbLevel>
       <dtmfOutofBand>avt</dtmfOutofBand>
        <alwaysUsePrimeLine>false</alwaysUsePrimeLine>
        <alwaysUsePrimeLineVoiceMail>false</alwaysUsePrimeLineVoiceMail>
        <kpml>3</kpml>
        <stutterMsgWaiting>1</stutterMsgWaiting>
        <callStats>true</callStats>
        <silentPeriodBetweenCallWaitingBursts>10</silentPeriodBetweenCallWaitingBursts>
        <disableLocalSpeedDialConfig>true</disableLocalSpeedDialConfig>
        <startMediaPort>10100</startMediaPort>
        <stopMediaPort>10300</stopMediaPort>
        <voipControlPort>5060</voipControlPort>
        <dscpForAudio>184</dscpForAudio>
        <ringSettingBusyStationPolicy>0</ringSettingBusyStationPolicy>
        <dialTemplate>dialplan.xml</dialTemplate> 
        <phoneLabel>Cisco</phoneLabel>
          <natReceivedProcessing>false</natReceivedProcessing>
          <natEnabled>false</natEnabled>
          <natAddress></natAddress>
        <sipLines>
          <line button="1">
            <featureID>9</featureID>
            <featureLabel>$ACCOUNT</featureLabel>
            <proxy>$ASTERISK</proxy>
            <port>5060</port>
            <name>$ACCOUNT</name>
            <displayName>$ACCOUNT</displayName>
            <autoAnswer>
              <autoAnswerEnabled>2</autoAnswerEnabled>
            </autoAnswer>
            <callWaiting>3</callWaiting>
            <authName>$ACCOUNT</authName>
            <authPassword>$ACCOUNT_PASS</authPassword>
            <sharedLine>false</sharedLine>
            <messageWaitingLampPolicy>3</messageWaitingLampPolicy>
            <messagesNumber></messagesNumber>
            <ringSettingIdle>4</ringSettingIdle>
            <ringSettingActive>5</ringSettingActive>
            <contact>$ACCOUNT</contact>
            <forwardCallInfoDisplay>
              <callerName>true</callerName>
              <callerNumber>false</callerNumber>
              <redirectedNumber>false</redirectedNumber>
              <dialedNumber>true</dialedNumber>
            </forwardCallInfoDisplay>
          </line>
          <line button="2">
          <featureID></featureID>
          <featureLabel></featureLabel>
          <speedDialNumber></speedDialNumber>
          </line>
        </sipLines>
    </sipProfile>
</device>

Теперь будем комментировать.

<timeZone>Ekaterinburg Standard Time</timeZone> - настройки часового пояса, которые будут использовать при получении информации от NTP-сервере (в конфиге это наш астериск). 

Все часовые пояса можно найти, например, здесь.

<loadInformation>SIP42.8-5-4S</loadInformation> - имя прошивки, которая будет загружена

Следующие настройки нужны для настройки локали:

<userLocale> 
  <name>Russian_Russian_Federation</name> 
  <uid></uid> 
  <langCode>ru_RU</langCode> 
  <version>8.4.3.1000-1</version> 
  <winCharSet>utf-8</winCharSet> 
</userLocale>
<networkLocale>Russian_Federation</networkLocale> 
<networkLocaleInfo> 
  <name>Russian_Federation</name> 
  <uid></uid> 
  <version>8.4.3.1000-1</version> 
</networkLocaleInfo>

<servicesURL>$SERVICESURL</servicesURL> - указываем откуда загружать XML для сервисов (в нашем случае там будет передаваться список абонентов).

<dialTemplate>dialplan.xml</dialTemplate>  - это очень важная строчка, о ней будет ниже.

<line button="2"> - у нас пустой, т.к. используем один SIP-аккаунт.

<preferredCodec>g711alaw</preferredCodec> - кодек G711 alaw у нас будет предпочтительным.

Конфигурация sip.conf астериска

...
[$ACCOUNT]
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/255.255.255.0
type=friend
host=dynamic
context=НАШ_КОНТЕКСТ
dtmfmode=rfc2833
disallow=all
allow=alaw
allow=ulaw
allow=gsm
username=$ACCOUNT
secret=$ACCOUNT_PASS
call-limit=2
...

Самое интересное здесь — call-limit=2. Суть в том, что можно будет получать 1 или 2 звонка (3 звонок уже на циску не пойдет — зачем её напрягать?), их можно обрабатывать на телефоне, переключаясь между ними. Больше чем 2 звонка в этом аппарате не поддерживается (возможно будет поддерживаться в новых прошивках), хотя обрабатывать 3 звонка уже достаточно накладно.

Настройка диалплана цискофона

Циско настолько умная, что может использовать свой собственный диалплан. Но тут есть обратная сторона медали. Если этот диалплан не указать, то исходящие звонки вообще ходить не будут. Точней будут, но только на номера от 0 до 9 =).

<DIALTEMPLATE>
  <TEMPLATE MATCH="*" Timeout="3"/> <!-- Anything else -->
</DIALTEMPLATE>

В этом конфиге мы по сути передаем всю ответственность на астериск — т.е. просто после 3-х секунд передаем номер. Более изящные номерные планы можно найти на voip-info.org.

Адресная книга абонентов

У нас есть LDAP (в связке с samba), в нем есть информация о телефонах пользователей. Так почему бы этим не воспользоваться?
Сервер LDAP, filter поиска нужно будет поменять на свои настройки.
directory.php:

<?
   header("Content-type: text/xml");
   header("Connection: close");
   header("Expires: -1");

  $page=1;
  if(isset($_GET['page']))
  {
    $page = $_GET['page'];
    if(settype($page,"integer") == false)
      die("<b>BAD REQUEST (invalid type)</b>");
  }

  echo '<?xml version="1.0" encoding="UTF-8"?>'."n";

  $ldapconfig['host'] = '192.168.0.8';
  $ldapconfig['port'] = NULL;
  $ldapconfig['basedn'] = 'ou=users,dc=MyCompany,dc=ru';
  $ldapconfig['filter'] = "(&(uid=*)(objectClass=sambaSamAccount)(objectClass=inetOrgPerson))";

   print("<CiscoIPPhoneDirectory>n");
   print("t<Title> </Title>n");
   print("t<Prompt> </Prompt>n");

  $DS = @ldap_connect($ldapconfig['host'], $ldapconfig['port']);

  if ( $DS === false )
    exit("ldap_connect problem: ".ldap_error($DS));

  $SRes = @ldap_search($DS, $ldapconfig['basedn'], $ldapconfig['filter']);

  if ( $SRes === false )
    exit("ldap_search problem: ".ldap_error($DS));

  $res = @ldap_get_entries($DS, $SRes);
  if ( $res === false )
    exit("ldap_get_entries problem: ".ldap_error($DS));


  $results = array();

  for ($i = 0; $i < $res["count"]; $i++)
  {

    if (!isset($res[$i]["telephonenumber"]))
      continue;
    if (!isset($res[$i]["displayname"]))
      continue;

    $r_ar = array();

    $r_ar['displayname']=$res[$i]["displayname"][0];
    $r_ar['telephonenumber']=$res[$i]["telephonenumber"][0];
    array_push($results, $r_ar);

  }

  for ($i = 0; $i < (count($results)-1); $i++)
    for ($k = $i+1; $k < count($results); $k++)
    {
      if (strcmp($results[$i]['displayname'],$results[$k]['displayname']) > 0)
      {
        $r_tmp = array();
        $r_tmp = $results[$i];
        $results[$i] = $results[$k];
        $results[$k] = $r_tmp;
      }

    }



  for ($i = (32*($page-1)); $i < (32*$page); $i++)
  {

    if ($i == count($results))
      break;

    print("t<DirectoryEntry>n");

    print("tt<Name>");
    print($results[$i]['displayname']);
    print("</Name>n");


    print("tt<Telephone>");
    print($results[$i]['telephonenumber']);
    print("</Telephone>n");

    print("t</DirectoryEntry>n");
  }

  print("<SoftKeyItem>");
  print("<Name>Dial</Name>");
  print("<URL>SoftKey:Dial</URL>");
  print("<Position>1</Position>");
  print("</SoftKeyItem>");

  if ($page > 1)
  {
    print("<SoftKeyItem>");
    print("<Name>Prev</Name>");
    print("<URL>http://".$_SERVER['SERVER_NAME']."/asterisk/directory.php?page=".($page-1)."</URL>");
    print("<Position>2</Position>");
    print("</SoftKeyItem>");
  }

  $count_pages = (int) (count($results) / 32);

  if ((count($results) % 32) !=0)
    $count_pages++;

  if ($page < $count_pages)
  {
    print("<SoftKeyItem>");
    print("<Name>Next</Name>");
    print("<URL>http://".$_SERVER['SERVER_NAME']."/asterisk/directory.php?page=".($page+1)."</URL>");
    print("<Position>3</Position>");
    print("</SoftKeyItem>");
  }

  print("<SoftKeyItem>");
  print("<Name>Exit</Name>");
  print("<URL>SoftKey:Exit</URL>");
  print("<Position>4</Position>");
  print("</SoftKeyItem>");

  print("</CiscoIPPhoneDirectory>n");

?>

Обновление. Заметьте, что на странице только 32 контакта. Почему так? Не знаю, чем это объяснить, но так реализовано в прошивке — больше чем 32 контакта не поддерживается. Впрочем, это не беда, т.к. можно реализовать при помощи софткеев механизм отображения пред. и след. страниц.

Делаем настройки для логотипа

Для начала по логам tftp смотрим куда cisco обращается за картинкой. Происходит это в момент выбора фонового изображения
через меню телефона (как разблокировать меню написано выше).
изображения из меню
/tftpboot/Desktops/320x196x4/List.xml:

<CiscoIPPhoneImageList>
  <ImageItem Image="TFTP:Desktops/320x196x4/Logo-TN.png" URL="TFTP:Desktops/320x196x4/Logo.png"/>
</CiscoIPPhoneImageList>

Нам нужно создать одну картинку 320×196 и одну картинку в 4 раза меньше (80×49).
Logo-TN.png — эскиз.
Logo.png — полноценная картинка.
Изменять логотип нужно через меню телефона.

Что не вошло в статью

— Настройка сигналов вызовов. Да, это тоже можно делать. Другое дело — зачем? Если для вас оно имеет смысл — то дерзайте.
— Настройка directories. Есть возможность, например, читать RSS с телефона и вообще добавлять различные контент-каталоги.

Проблемы, возникшие в процессе настройки

1. Нужна была прошивка для SIP (по умолч. SCCP)
2. Не регистрировался телефон (поставил прошивку 9.0.3, которая работает только по TCP)
3. Не шли исходящие звонки (см. dialplan.xml)
4. Отображаются только 32 контакта в адресной книге (ограничение прошивки)

Ссылки

www.voip-info.org/wiki/view/Asterisk+phone+cisco+79×1+xml+configuration+files+for+SIP
www.voip-info.org/wiki/view/Asterisk+phone+cisco+7970+SIP
www.asteriskguru.com/tutorials/cisco_7960_ip_phone_configuration.html
Опыт настройки:
3090607.ru/note/27-cisco-ip-phone-locale
forum.sysadmins.su/index.php?showtopic=20489
www.voipstore.com/configuring-cisco-7975-ip-phones-for-sip
asteriskpbx.ru/display/Asterisk/CISCO+7911
www.gho.no/2009/05/cisco-ip-phone-configuration-with-asterisk
Офиц. руководство:
www.cisco.com/en/US/docs/voice_ip_comm/cuipph/7960g_7940g/sip/2_0/english/administration/guide/admin2.pdf
www.cisco.com/en/US/docs/voice_ip_comm/cuipph/7962g_7942g/6_0/english/administration/guide/7962G-Admin-Book-Wrapper.html
XML objects:
www.cisco.com/univercd/cc/td/doc/product/voice/vpdd/cdd/5_0/5_0_1/ipphsv/ip503ch2.htm#wp1033491
www.ibm.com/developerworks/wireless/library/wi-voip
webmaxtor.blogspot.com/2009/04/cisco-ipphonedirectory-exit-softkey.html
www.cisco.com/univercd/cc/td/doc/product/voice/vpdd/cdd/5_0/5_0_1/ipphsv/ip503ch2.htm
docstore.mik.ua/univercd/cc/td/doc/product/voice/vpdd/cdd/5_0/ipphsv/ip502apa.htm#wp1007090
my.safaribooksonline.com/book/telephony/1587050609/using-cisco-ip-phone-xml-objects-and-tags/ch04#X2ludGVybmFsX0ZsYXNoUmVhZGVyP3htbGlkPTEtNTg3MDUtMDYwLTkvNjE=

Потребовалось на предприятии внедрить в уже существующую sip-телефонию (на Asterisk) телефоны фирмы Cisco 7960.

Подключив телефоны, увидел что загрузка останавливается на получении ip, и запроса файлов с TFTP сервера, понял, что дело не обойдется “легкой кровью”. И засел курить мануалы, и рыть интернет. По итогу после пары дней танцев с бубном все же удалось подружить эти телефоны, с уже имеющимся сервером  Asterisk.

Для IP телефонов Cisco серии 79XX есть довольно неприятный момент в настройке со сторонним оборудованием – у этих аппаратов нет веб-интерфейса, все настройки производятся через XML-шаблон, который нужно править руками, что довольно неудобно. Это руководство покажет вам, как настроить IP телефоны Cisco 7940/7941/7960 или 7961 под sip-телефонию.

Как выглядит общая картина: Телефон включается, получает от DHCP-сервера ip, адрес tftp сервера, далее, с tftp телефон запрашивает файл версии прошивки, сравнивает со своей, если своя – более старая – качает новую прошивку с tftp, прошивается, скачивает дефолтный конфиг, конфиг для своего МАК-адреса, диалплан и т.п. И после этого уже подключается к серверу Asterisk. И собственно, начинает работать.

Итак, разобью всю задачу настройки на этапы:

1. Настройка телефона
2. Создание файлов конфигурации для телефона
3. Создание нового SIP на сервере
4. Конфигурация сервера DHCP
5. Конфигурация сервера TFTP
6. Настройка параметров из меню

Настройка телефона

Мануал по подключению, можно посмотреть здесь

Как минимум нужно сбросить телефон к заводским настойкам, прежде чем приступать к дальнейшей настройке.

Комбинации клавиш телефона:

зажать #, подать питание. как появится текст нажать последовательно 123456789*0# - сброс телефона
**#** — перезагрузка телефона (через меню)
**# — разблокировка настроек (также через меню).
Разблокировка нужна, например, для того чтобы поставить настройки DHCP-клиента

Создание файлов конфигурации для телефона

Вот список файлов, которые потребуются для корректной работы телефона:

OS79XX.txt
Здесь указывается модель телефонов, а внутри файла – версия актуальной прошивки. В моём случае это версия прошивки PS03-8-12-00

P0S3-8-12-00.loads
P0S3-8-12-00.sb2
P0S3-8-12-00.bin
P0S3-8-12-00.sbin
Файлы прошивки для SIP-телефонии. Скачать можно тут, или тут

SIPXXXXXXXXXXXX.cnf
Файл конфигурации для конкретного телефона, где XXXXXXXXXXXX – его MAC-адрес телефона

; phone-specific configuration file
; Phone Label (Text desired to be displayed in upper right corner). This displays "TESTer"
phone_label: "Disnetern"
; Inbound port used for SIP messages (default - 5060, 5061, 5062) Remember to port forward this port on your router!
voip_control_port: 5061
; Line 1 phone number
line1_name: 120
; Displayed on the Phone screen
line1_shortname: 120
; Line 1 name for authentication with proxy server
line1_authname: 120
; Line 1 authentication name password
line1_password: megahardpassword
; Line 1 Display Name (Display name to use for SIP messaging)
line1_displayname: 120
; Proxy Server
proxy1_address: 10.20.30.40
; Proxy Server Port (default - 5060)
proxy1_port: 5060

где 500 – номер SIP, учетной записи Asterisk,
10.20.30.40 – ip сервера Asterisk

SIPDefault.cnf
Общий файл конфигурации для всех телефонов:

; Sip default configuration file. Extra config options found on the cisco site
; http://www.cisco.com/univercd/cc/td/doc/product/voice/c_ipphon/sip7960/sipadm30/maintain.htm
; Image Version the phone will boot
image_version: P0S3-8-12-00
; Phone Registration Expiration [1-3932100 sec] (Default - 3600)
timer_register_expires: 3600
; Codec for media stream (g711ulaw (default), g711alaw, g729a)
preferred_codec: g711alaw
; Time Server
sntp_server: 10.20.30.40
; Time sync mode unicast, multicast, anycast, or directedbroadcast (default)
sntp_mode: directedbroadcast
; Time Zone Phone is in
time_zone: EADT
; As the timezone above is AEDT we dont need to advance the clock another hour
dst_auto_adjust: 0
; Date format D/M/Y, M/D/Y
date_format: D/M/Y
; 24 hour clock- 0=No, 1=Yes
time_format_24hr: 0
; DTMF AVT Payload
dtmf_avt_payload: 96
; Use dialplan.xml as the dialplan
dial_template: "dialplan"
; NAT/Firewall Traversal- 0=Disabled, 1=Enabled
nat_enable: 1
; WAN IP address of NAT box. Recommend using dyndns.org to make life easier
nat_address: 192.168.10.1
nat_received_processing: 1
; Start RTP range for media (default - 16384)
start_media_port: 16384
; End RTP range for media (default - 32766)
end_media_port: 32766
; Disable Call Waiting
call_waiting: 0
; Allow Telnet access
telnet_level: 2
proxy_register: 1

Нужно обязательно проверить, что бы название версии прошивки в этом файле соответствовала названию самих файлов и названию в файле OS79XX.txt

dialplan.xml

Собственно диалплан (правила набора) самого телефона. Например, для коротких номеров. Заполняется в таком виде:

<DIALTEMPLATE>
<TEMPLATE MATCH="" TIMEOUT="1" REWRITE="100"/>
</DIALTEMPLATE>

TEMPLATE MATCH – номер, шаблон
TIMEOUT – ожидание
REWRITE – набор номера, при совпадении с шаблоном и окончанием таймаута.

Создание нового SIP на сервере

Заходим на наш сервер Asterisk и добавляем в файл /etc/asterisk/sip.conf наши настройки для нового телефона:

[120]
context=local-phones
host=dynamic
secret=megahardpassword
type=friend
callerid="TESTer_120" <364>
qualify = yes
nat=force_rport,comedia

Далее при надобности правим /etc/asterisk/extensions.conf или /etc/asterisk/queues.conf

И после перезагружаем настройки Asterisk сервера тех файлов, которые меняли:

[disnetern@asterisk]#sudo asterisk -rx "config reload /etc/asterisk/sip.conf"

Конфигурация сервера DHCP

В моем случае есть роутер Mikrotik RB2011Ui-2Hnd.
Сам DHCP сервер уже настроен на роутере, для работы компьютеров внутри офиса.
Но что бы при получении IP адреса, телефон “знал” что нужно ему делать дальше и где искать дальше файлы – в настройках dhcp-сервера нужно создать и добавить в networks  опцию 158.

Создаем, где 192.168.10.1 – локальный ip адрес моего Mikrotik :

/ip dhcp-server option 
add code=158 name=tftp-158 value="s'192.168.10.1'"

Добавляем. (в моем случае запись уже есть, я только добавляю в нее опцию 158):

/ip dhcp-server network
set 0 dhcp-option=tftp-158

Возможные варианты опций:

Опция 66. Опция 66 (option 66) – это аналог проприетарной опции 150 (option 150), разработанной компанией Cisco для автоматического обновления прошивок и конфигурации (Auto Provisioning) телефонов Cisco IP Phone. Данная опция содержит в себе адрес TFTP сервера, на который должен обратиться телефон, чтобы скачать прошивку и файл с конфигурацией, как только подключается к сети. Единственным различием между опцией 150 и 66, является то, что благодаря опции 150 можно указывать IP адреса для нескольких TFTP серверов, а в опции 66 можно указать только один адрес. Опция 66 является открытым стандартом IEEE, который поддерживается большинством производителей роутеров и VoIP-оборудования. Описывается в RFC 2132.

Давайте её настроим, для этого переходим на вкладку Options → + и видим следующее окно:

Важно! Прежде чем вводить IP адрес TFTP сервера в поле Value, проверьте версию RouterOS, от этого будет зависеть синтаксис данной настройки.

• Для версий с 6.0 -6.7, значение IP адреса нужно вводить, используя одинарные кавычки – ’192.168.1.1’
• Для версий от 6.8, значение IP адреса нужно вводить, используя следующий синтаксис – s’192.168.1.1’

Конфигурация сервера TFTP

В Mikrotik настройка tftp сводится к паре кликов, или 1 строчке в cli:

/ip tftp add read-only=no real-filename=/pub/

Здесь мы указываем папку, где будут храниться файлы для нашего телефона.

И собственно, нужно с помощью winbox залить туда все файлы:

OS79XX.txt
P0S3-8-12-00.loads 
P0S3-8-12-00.sb2
P0S3-8-12-00.bin
P0S3-8-12-00.sbin 
SIPXXXXXXXXXXXX.cnf 
SIPDefault.cnf 
XMLDefault.CNF
dialplan.xml

Может получиться так, что телефон начнет ругаться на то, что не нашел какой-то файл на TFTPсервере. Тогда нужно будет открыть логи tftp и посмотреть, какой файл он не может найти.

Настройка параметров из меню

Некоторые параметры можно настроить вручную, из меню IP-телефона Cisco.

По умолчанию настройки в IP-телефоне Cisco 7940/7960 заблокированы. Для разблокирования нужно ввести пароль, заданный в конфигурационном файле телефона (или  дефолтый  – cisco ), нажав Settings > Unlock Config.

Для блокировки нажмите Lock Config или Exit.

После изменения параметров нужно их сохранить и телефон перезагрузится с новыми настройками.

Помимо основный настроек, таких как IP-адрес или адрес TFTP-сервера, при настройке вручную нужно настроить параметры SIP.

После разблокировки телефона выберите Settings > SIP Configuration. В появившемся меню установите line1_name, proxy1_address, proxy1_port – их формат описан выше. Если телефон должен авторизоваться на прокси-сервере SIP, введите также line1_authname и line1_password. По умолчанию их значение равно UNPROVISIONED.

Вот, собственно, и все. Телефон Загружен и готов к работе.

Конфигурационные файлы

Общий конфигурационный файл

Общим конфигурационным файлом для модели телефонов SPAXXX является файл с именем spa$PSN.cfg Где $PSN — это обозначение модели телефонного аппарата. 

В общий конфигурационный файл рекомендуется выносить настройки, общие для всех телефонных аппаратов одной модели. Пример общего конфигурационного файла ниже:

<flat-profile>
 
<Resync_On_Reset>Yes</Resync_On_Reset>
<Resync_Periodic></Resync_Periodic>
<Profile_Rule>/spa$PSN.cfg</Profile_Rule>
<Profile_Rule_B>/spa$MA.xml</Profile_Rule_B>
 
<Dictionary_Server_Script>serv=tftp://192.168.1.1/spa/; d0=English; x0=spa50x_30x_en_v747.xml; d1=Russian; x1=spa50x_30x_ru_v746.xml;</Dictionary_Server_Script>
<Default_Character_Encoding>UTF-8</Default_Character_Encoding>
 
<Upgrade_Enable>Yes</Upgrade_Enable>
<Upgrade_Error_Retry_Delay>3600</Upgrade_Error_Retry_Delay>
<Downgrade_Rev_Limit></Downgrade_Rev_Limit>
<Upgrade_Rule>/spa50x-30x-7-4-8a.bin</Upgrade_Rule>
 
<Time_Format>24hr</Time_Format>
<Date_Format>day/month</Date_Format>
<Time_Zone>GMT+04:00</Time_Zone>
 
</flat-profile>

Общий конфигурационный файл для модели из примера содержит «ссылки» на индивидуальный конфигурационные файлы для конкретного аппарата. Так, в опциях <Profile_Rule> и <Profile_Rule_B>
указываются имена конфигурационных файлов (а точнее пути к файлам на TFTP сервере), которые должен загружать телефон.

Индивидуальный конфигурационный файл

Индивидуальный конфигурационный файл может содержать настройки для конкретного аппарата (определяется по MAC адресу), в частности реквизиты учетной записи при подключении к серверу телефонии.

<flat-profile>
 
  <!-- Proxy and Registration -->
 
  <Proxy_1_ ua="na">сервер_регистрации</Proxy_1_>
  <Outbound_Proxy_1_ ua="na"></Outbound_Proxy_1_>
  <Use_Outbound_Proxy_1_ ua="na">No</Use_Outbound_Proxy_1_>
  <Use_OB_Proxy_In_Dialog_1_ ua="na">Yes</Use_OB_Proxy_In_Dialog_1_>
  <Register_1_ ua="na">Yes</Register_1_>
  <Make_Call_Without_Reg_1_ ua="na">No</Make_Call_Without_Reg_1_>
  <Register_Expires_1_ ua="na">900</Register_Expires_1_>
  <Ans_Call_Without_Reg_1_ ua="na">No</Ans_Call_Without_Reg_1_>
  <Use_DNS_SRV_1_ ua="na">No</Use_DNS_SRV_1_>
  <DNS_SRV_Auto_Prefix_1_ ua="na">No</DNS_SRV_Auto_Prefix_1_>
  <Proxy_Fallback_Intvl_1_ ua="na">3600</Proxy_Fallback_Intvl_1_>
  <Proxy_Redundancy_Method_1_ ua="na">Normal</Proxy_Redundancy_Method_1_>
 
  <!-- Subscriber Information -->
 
  <Display_Name_1_ ua="na">номер_абонента</Display_Name_1_>
  <User_ID_1_ ua="na">номер_абонента</User_ID_1_>
  <Password_1_ ua="na">пароль_абонента</Password_1_>
  <Use_Auth_ID_1_ ua="na">No</Use_Auth_ID_1_>
  <Auth_ID_1_ ua="na">номер_абонента</Auth_ID_1_>
  <DTMF_Tx_Method_1_ group="Ext_1/Audio_Configuration">INFO</DTMF_Tx_Method_1_>
 
</flat-profile>

Параметры конфигурационных файлов

Не обязательно описывать все параметры в конфигурационных файлах. Достаточно указать те, которые требуется установить (поменять).

Телефонным аппаратом можно управлять удалённо посредством HTTP запросов (через CURL или обычным браузером). Вот некоторые запросы, которые можно использовать:

Если производится обновление прошивки телефона с версии младше 7-5-2b на версию старше 7-5-2b, сначала необходимо произвести обновление на 7-5-2b. Иначе телефон будет перезагружаться каждый час, пытаясь установить прошивку заново. Т.е. если производится апдейт прошивки с версии, например, 7-4-9с на 7-5-5, нужно сначала обновиться с версии 7-4-9с до версии 7-5-2b, а затем с 7-5-2b на 7-5-5. 

В конфигурационном файле можно использовать следующее правило для обновления прошивки:

<Upgrade_Rule ua="na">( $SWVER lt 7.5.2b )? tftp://192.168.1.1/spa50x-30x-7-5-2b.bin | tftp://192.168.1.1/spa50x-30x-7-5-5.bin </Upgrade_Rule>

В данном апгрейд-правиле условие проверки версии, телефон сам проверяет, если версия меньше 7.5.2B — скачивать 7.5.2b. Если не меньше — то 7.5.5

Установка изображения на SPA502G, SPA504G

Требования к изображению:

• BMP
• монохромная
• 128х48

Стоит иметь в виду, что нижние 5 пикселей занимают кнопки типа redial, dir, dnd и прочие. Поэтому снизу до самого изображения нужно оставлять БОЛЬШЕ 5 пикселей. Вверх вплотную также не следует помещать изображение, чтобы оно не сливалось со строкой, где написаны дата и время.

Изображение нужного формата закачать на HTTP сервер, например, в директорию /var/www/localhost/htdocs/static/images/, где /var/www/localhost/htdocs — DocumentRoot

В конфигурационный файл телефонного аппарата добавить строки:

<flat-profile>
..
<BMP_Picture_Download_URL>http://ip_адрес_сервера/static/images/имя_файла.bmp</BMP_Picture_Download_URL>
<Select_Background_Picture>BMP Picture</Select_Background_Picture>
..
</flat-profile>

После этого перезагрузить телефон.

Возможно создание единой телефонной книги для всех аппаратов CISCO. Для этого на HTTP сервере нужно расположить XML файл следующего содержания:

<CiscoIPPhoneDirectory>
<Title>Заголовок телефонной книги</Title>
<Prompt>Выберите контакт</Prompt>
<DirectoryEntry>
<Name>Антон</Name>
<Telephone>104</Telephone>
</DirectoryEntry>
<DirectoryEntry>
<Name>Файбекс</Name>
<Telephone>84957485588</Telephone>
</DirectoryEntry>
</CiscoIPPhoneDirectory>

Для подключения единой телефонной книги на аппаратах CISCO, в настройках телефонного аппарата через административный WEB интерфейс, в меню Phone, секции XML Service, указать:

XML Directory Service URL: http://192.168.1.1/phonebook.xml
XML Directory Service Name: Corp phonebook

Сisco SPA50X способен обработать телефонную книгу в 86 записей (кто-то писал, что загружаемый файл с телефонной книгой не должен превышать 10240 байт или 32 записи, у меня же получилось подгрузить 86). Но в CISCO возможно создание поддиректорий, например, по подразделениям, площадкам. Таким образом единый файл разбивается на несколько файлов по площадкам и можно получить список абонентов. 

Для создания меню с вложенными подменю нужно создать XML файл и расположить его на HTTP сервере. 

Error rendering macro ‘code’: Invalid value specified for parameter ‘firstline’

<CiscoIPPhoneMenu>
<Title>Phonebook menu</Title>
<Prompt>Select sub-menu</Prompt>
<MenuItem>
<Name>Menu option 1</Name>
<URL>http://192.168.1.1/phonebook_1.xml</URL>
</MenuItem>
<MenuItem>
<Name>Menu option 2</Name>
<URL>http://192.168.1.1/phonebook_2.xml</URL>
</MenuItem>
</CiscoIPPhoneMenu>

Стоит учитывать, что пункты меню, заголовок и промт должны быть написаны латинскими буквами.

Аналогичные файлы телефонной книги подойдут и для CISCO CP79XX.

Более подробное описание находится здесь: http://www.voip-info.org/wiki/view/Asterisk+Cisco+79XX+XML+Services

Настройка клавиш на панели производится в веб интерфейсе конкретного телефонного аппарата, к которому подключена панель. При просмотре интерфейса в режиме admin / advanced, доступна вкладка Attended console, на которой и представлены параметры клавиш панелей расширения. 

ВАЖНОЕ ЗАМЕЧАНИЕ: Панель работает тогда, когда зарегистрирована первая линия EXT1 на телефоне. 

Для работы с Asterisk панели расширения, нужно указать параметры:

Subscribe Expires: 900
Server Type: Asterisk
Attendant Console Call Pickup Code: *7

Код перехвата *7 соответствует комбинации pickupexten в конфигурационном файле features.conf

Каждая клавиша программируется строкой вида:

fnc=sd+blf+cp;sub=35890@192.168.1.11;nme=35890

• fnc — это функции клавиши: 

• sd — быстрый набор 

• blf — отображение занятости абонента 

• cp — перехват вызова 

• sub — запрос для обращения к номеру абонента на АТС при вызове функции 

• nme — номер абонента

Здесь 35890 — номер абонента, который контролируется; 192.168.1.11 — IP адрес сервера телефонии.

Таким образом, для тогда чтобы клавиша работала только для быстрого вызова, нужно прописать:

fnc=sd;sub=084992621305@192.168.2.1;nme=084992621305

Также необходимо произвести редактирование конфигурационных файлов. В номерном плане, в extensions.conf должен быть контекст

[hints]
exten => _1XX,hint,SIP/${EXTEN}

Где _1XX — маска номеров внутренних абонентов. Похожий контекст в AEL работать НЕ будет! В конфигурационном файле sip.conf, секции [globals] должны быть раскомментированы и указаны следующие параметры:

allowsubscribe=yes
subscribecontext=hints
notifyringing=yes
notifyhold=yes
callcounter=yes
limitonpeer=yes

Для новых телефонов, которые ранее не были подключены к сети 

1. Включите телефонный аппарат 

2. Нажмите клавишу меню

3. Перейдите в раздел «Call Control Settings»

4. Для параметра «SPCP Auto Detect» установите значение «No» и нажмите клавишу «Save» 

5. Телефон перезагрузится 

6. Подключите телефон к ЛВС, он получит IP адрес и конфигурационный файл с настройками 

Для телефонов, которые уже подключены к сети и находятся в режиме SPCP 

1. Отключите сетевой кабель и перезагрузите телефон. 

2. Нажмите клавишу меню 

3. Выберите пункт «factory reset»

4. Телефон перезагрузится 

5. Нажмите клавишу меню 

6. Перейдите в раздел «Call Control Settings»

7. Для параметра «SPCP Auto Detect» установите значение «No» и нажмите клавишу «Save» 

8. Телефон перезагрузится 

9. Подключите телефон к ЛВС, он получит IP адрес и конфигурационный файл с настройками

<Default>
  <device>
    <deviceProtocol>SIP</deviceProtocol>
    <callManagerGroup>
      <members>
        <member  priority="0">
        <callManager>
          <ports>
            <ethernetPhonePort>2000</ethernetPhonePort>
          </ports>
          <processNodeName>10.147.163.139</processNodeName>
        </callManager>
        </member>
      </members>
    </callManagerGroup>
  <device>
</Default>

Если телефон перезагружается каждую минуту, значит в общем конфигурационном файле для моделей и личном конфигурационном файле для аппарата (па мак адресу) есть одинаковые параметры. Параметры не должны повторяться в файлах. 

Можно включить логгирование на syslog сервер. Для этого, если syslog установлен на Gentoo (используется syslog-ng) необходимо в конфигурационном файле /etc/syslog-ng/syslog-ng.conf внести следующие изменения:

options {
         ...
         create_dirs(yes); #will recursively create log files/directories if necessary
        };
# The port where the logs will be sent to by the clients
source remote_log {udp(ip("SERVERIPADDRESS")
                   port(514));};
# where to log the files on the server. $HOST is a macro and will be replaced by the hostname sending the log
destination remote {file("/var/log/remote.d/$HOST.log");};
# link the source to the destination
log {source(remote_log); destination(remote);};

Создать директорию /var/log/remote.d Дать её права 777. После этого применить конфигурацию для logger сервера.

Можно использовать любой другой syslog сервер (например GrayLog)

В самом телефонном аппарате нужно выполнить следующее:

1. Configure your phone by directing your browser to:

http://<IP_address_of_Phone>/admin/advanced [WIP310: http://<IP_address_of_WIP310>/admin/ ]
Example: http://192.168.0.100/admin/advanced if the phone’s IP address is 192.168.0.100

2. Enable Debug Messages by editing the following fields:

• Phone’s web-ui > System tab > Optional Network Configuration > Debug Server: <IP address of syslog server> Example: 192.168.0.200
  [if you are capturing with Wireshark, you do not need to use a valid syslog server’s IP address, any «fake» address can be used, example 10.0.0.1]
• iPhone’s web-ui > System tab > Optional Network Configuration > Debug Level: 3
• Phone’s web-ui > Ext N > SIP Settings > SIP Debug Option: full

3. Enable Syslog Messages by editing the following: [step 3b is not needed if you have enabled Debug]

Phone’s web-ui > System tab > Optional Network Configuration > Syslog Server: <IP address of syslog server> Example: 192.168.0.200

4. Scroll down and click Submit All Changes

The Phone will reboot and send all debug / syslog messages to the specified IP address of the syslog server.

[Don’t forget to make sure that your syslog server is running and that its IP address is what you configured on the phone.]

Tips

Ожидание вызова (CallWaiting)

Call waiting alerts you when you are on a call by ringing your phone and displaying a status message that another call is ringing. If you turn call waiting off, incoming calls do not ring your phone if you are on another call, and the caller hears a busy signal or message.

Второй входящий звонок может мешать оператору, отвлекать от работы. Для включения или отключения функции call waiting на телефонном аппарате: 

1. Зайдите на WEB интерфейс телефона 

2. Во вкладке Voice, выберите вкладку User. 

3. В разделе «Supplementary Services» найдите опцию «CW Setting». 

4. Выберите «yes» или «no» для включения или отключения функции. 

5. Внизу страницы нажмите «Submit All Changes» 

Отключить гудок в ухо при поступлении второго звонка на вторую линию 

В настройках телефона Admin → Advanced → Regional изменить параметр Call Waiting Tone в секции Call Progress Tones на значение

Этот же параметр может быть задан в индивидуальном конфигурационном файле

<Call_Waiting_Tone>0@-10;30(.3/9.7/1)</Call_Waiting_Tone>

Функция Paging осуществляется уведомление всех абонентов, у кого телефоны SPA5XX, в локальной сети. Функция позволяется одному абоненту произвести голосовое уведомление всех остальных абонентов по громкой связи, при этом происходит автоматическое поднятие трубки на всех телефонных аппаратах. 

В настройках телефонного аппарата, в вкладке Voice → Phone, в разделе Multiple Paging Group Parameters имеется параметр Group Paging Script, который определяет настройки группового уведомления:

pggrp=224.168.168.168:34560;name=All;num=800;listen=yes;

Этот параметр так же можно прописать в конфигурационном файле:

<Group_Paging_Script>pggrp=224.168.168.168:34560;name=All;num=800;listen=yes;</Group_Paging_Script>

Установка времени на телефонном аппарате

Перезагрузка телефонов каждый час

Телефонные аппараты могут перезагружаться каждый час самостоятельно в случае, если телефоны были настроены вручную и для них отсутствует индивидуальный конфигурационный файл.

Данной ситуации также соответствую значения следующих параметров:

• Resync Fails On FNF: yes — file-not-found response
• Resync Error Retry Delay: 3600

Телефоны перезагружаются в попытке получить конфигурационный файл, которого нет.

Сброс на Factory Defaults

• For Cisco SPA phone mode SPA301 lift the handset and enter ****, enter 7373 and press #, press 1 to confirm, hang up to exit and begin the restore process, phone will be reset to the factory default settings.
• For Cisco SPA phone models SPA502G, SPA504G, SPA508G, SPA509G press the Setup button, scroll to Factory Reset and press select, phone will be reset to the factory default settings.
• For Cisco SPA phone model SPA501G press the Setup button, enter 73738, then press #, enter 1 to confirm, hang up to exit and begin the restore process, phone will be reset to the factory default settings.
• For Cisco SPA phone model SPA525G press the Setup button, select Device Administration, scroll to Factory Reset, press Select, phone will be reset to
  the factory default settings.