wiki:EndpointParameters

Version 9 (modified by alx, 7 years ago) ( diff )

Добавлены ссылки на канальные окончания FXO и АДАСЭ.

Сводная страница конфигурационных параметров канальных окончаний

На этой странице описана большая часть параметров канальных окончаний платы VE-01. Так как многие параметры присутствуют сразу в нескольких (а некоторые - во всех!) типах канальных окончаний, они сведены в общие таблицы вместо того чтобы повторять их описание на странице каждого канального окончания.

Конфигурационные параметры TDM

Название параметра В каких канальных окончаниях используется Описание параметра
Канал Все кроме PRI Номер канала платы VE-01. Допустимые значения - от 1 до 256. Если плата VE-01 работает в режиме канальной платы, могут использоваться 8 каналов с 1 по 8. Если плата VE-01 работает не в режиме канальной платы, каналы с 1 по 32 занимают первый поток E1 (КИ с 0 по 31 соответственно), каналы с 33 по 64 - второй поток E1 и т.д.

Следует учитывать, что если соответствующий поток E1 сконфигурирован в режим PCM30, КИ16 этого потока используется для передачи СУВ и не может использоваться канальными окончаниями. КИ0 такого потока может использоваться только канальными окончаниями, не использующими СУВ.
Поток E1 PRI ISDN PRI использует в качестве транспорта первичный поток E1, включающий 30 разговорных B-канала и один канал D, используемый для сигнализации. При создании канального окончания PRI реально создается сразу 31 канал, поэтому вместо номера канала при создании окончания PRI указывается номер потока E1. Может быть выбрано значение от 1 до 8.
ИКМ код Все Параметр устанавливает закон кодирования голосовой информации в канале TDM. Возможен выбор одного из вариантов - "a-law" или "μ-law".
Усиление IP→TDM Все Параметр устанавливает величину усиления в дБм (или ослабления при отрицательных значениях параметра) сигналов, передаваемых в канал TDM. Значение параметра влияет на любые сигналы, передаваемые в канал - речь, акустические информационные сигналы, тональные сигналы сигнализации и т.п. Допустимые значения - от -14.0 до +6.

Значение по умолчанию - 0.
Усиление TDM→IP Все Параметр устанавливает величину усиления в дБм (или ослабления при отрицательных значениях параметра) сигналов, принимаемых из канала TDM. Значение параметра влияет на любые сигналы, принимаемые из канала - речь, акустические информационные сигналы, тональные сигналы сигнализации и т.п. Допустимые значения - от -14.0 до +6.

Значение по умолчанию - 0.
АРУ IP→TDM Все Если чекбокс отмечен, усиление сигнала при передаче в канал TDM будет адаптироваться к уровню сигнала: при слабом сигнале усиление увеличивается, при сильном - уменьшается.

Значение по умолчанию - выключено.
АРУ TDM→IP Все Если чекбокс отмечен, усиление сигнала при приеме из канала TDM будет адаптироваться к уровню сигнала: при слабом сигнале усиление увеличивается, при сильном - уменьшается.

Значение по умолчанию - выключено.

Конфигурационные параметры SIP

Название параметра В каких канальных окончаниях используется Описание параметра
SIP транспорт Все Параметр устанавливает тип транспорта, через который канальное окончание передает сообщения SIP. Возможен выбор одного из вариантов - "UDP", "TCP" или "TLS". Следует учитывать, что при выборе транспорта UDP сообщение SIP все равно может быть отправлено через транспорт TCP в случае, если размер датаграммы UDP, содержащей сообщение, превышает MTU сетевого интерфейса.
Принимать только TLS Все При отметке данного чекбокса канальное окончание будет принимать входящие со стороны сети IP вызовы только в том случае, если они приняты через безопасный транспорт (на текущий момент таким является транспорт TLS).
SIP URI Все SIP URI канального окончания. Обязательный параметр. Если домен SIP URI не совпадает с IP адресом платы VE-01 (и не равен "127.0.0.1"), канальное окончание будет пытаться зарегистрироваться на удаленном сервере. Если имя домена совпадает с IP адресом платы, регистрация не производится ("локальное" канальное окончание).

В качестве домена в SIP URI может использоваться значение "127.0.0.1". В этом случае канальное окончание также не делает попыток регистрации. Канальное окончание с таким доменом удобно тем, что оно остается локальным при любом изменении IP адреса платы (в противном случае изменение IP адреса платы потребовало бы изменения SIP URI всех локальных канальных окончаний). Следует учитывать, что канальные окончания с доменом "127.0.0.1" могут взаимодействовать только с другими локальными канальными окончаниями той же платы.
Реальное имя Все Необязательный параметр. Устанавливает отображаемое имя (Display Name), передаваемое в поле From: сообщений SIP (например "John Smith").

Обратите внимание, что некоторые типы канальных окончаний могут получать реальное имя абонента со стороны TDM (например окончание FXO может получить реальное имя вызывающего абонента в посылке Caller ID), в этом случае в поле From: будет использоваться реальное имя вызывающего абонента, полученное в посылке Caller ID, а значение, заданное параметром "Реальное имя" будет использоваться только в случаях, когда реальное имя не было получено при приеме вызова.

Значение по умолчанию - пустая строка ("") - DisplayName в заголовке From: не указывается.
Логин Все Необязательный параметр. Устанавливает имя пользователя, используемое в паре со значением параметра "Пароль" для аутентификации на удаленном сервере, если таковая требуется.
Пароль Все Необязательный параметр. Устанавливает пароль пользователя, используемый в паре со значением параметра "Пароль" для аутентификации на удаленном сервере, если таковая требуется.
Expires Все Обязательный параметр. Используется при регистрации канального окончания на удаленном сервере. Устанавливает величину желаемого периода регистрации SIP UAC в секундах. Значение передается в поле Expires: запроса REGISTER. Допустимы значения от 300 до 3600. Значение по умолчанию - 3600 (1 час).
SIP прокси Все Необязательный параметр. Если значение параметра - непустая строка, то все исходящие из платы сообщения SIP передаются указанному прокси-серверу (исключение - сообщения REGISTER при установленом параметре "Регистратор" - см. ниже). Если значение "SIP прокси" не установлено (пустая строка, ""), исходящие сообщения SIP передаются напрямую получателю (в соответствии с доменом URI получателя).

Значение по умолчанию - пустая строка ("").
To домен FXS, PRI Необязательный параметр. При получении вызова со стороны TDM канальное окончание формирует запрос INVITE, при этом вызываемый SIP URI формируется из номера вызываемого абонента в качестве имени пользователя. Если значение параметра - непустая строка, то это значение используется как имя домена при формировании вызываемого SIP URI. Если значение - пустая строка (""), в качестве имени домена используется домен параметра "SIP URI". Такой механизм позволяет направлять вызовы в домен, отличный от "родного" домена канального окончания. Например если SIP URI канального окончания FXS 123@home.org, а параметр "To домен" установлен в значение domain.net, то при наборе номера 456 будет выполнен вызов 123@home.org --> 456@domain.net.

Значение по умолчанию - пустая строка ("").
Session-Expires Все Обязательный параметр. Если значение параметра не 0, для данного канального окончания активируется расширение SIP "Session Timer" (RFC4028). Значение параметра помещается в поле Session-Expires: сообщений SIP и устанавливает предельное время существования сессии без ее обновления с помощью re-INVITE или UPDATE. Если значение параметра равно нулю, расширение "Session Timer" отключено. Допустимые значения параметра - от 90 до 3600 или 0.

Значение по умолчанию - 0.
Блокировать исходящие при отсутствии регистрации Все При включении (отметке) этого чекбокса исходящие вызовы в направлении сети IP возможны только при успешной регистрации SIP UAC канального окончания на внешнем сервере.

Значение по умолчанию - выключено.

Конфигурационные параметры медиа

Название параметра В каких канальных окончаниях используется Описание параметра
Запрет VAD Все Если чекбокс не отмечен, разрешено использование функции VAD (Voice Activity Detection) - она предлагается и принимается в сообщениях SDP. Также в списке предлагаемых Payload Type присутствует тип 13 (CN/8000), и он передается в ответе на SDP если выбран кодек, не имеющий встроенной поддержки VAD. Если обе стороны соединения согласовали использование VAD, медиапоток RTP передается только при наличии в канале речи.

Если чекбокс отмечен, в отправляемых сообщениях SDP для кодеков со встроенной поддержкой VAD добавляется атрибут fmtp, запрещающий использование VAD, например a=fmrp:18 annexb=no для кодека G729, также не предлагается (и не принимается предложение) Payload Type 13 (CN).

Значение по умолчанию - чекбокс не отмечен (использование VAD разрешено).
Запрет VBD Все Если чекбокс не отмечен, разрешено использование функции VBD (Voice Band Data) в соответствии с рекомендацией ITU-T V.152. При передаче предложения SDP SIP UA предлагает, а при ответе на предложение соглашается использовать кодек PCMA/PCMU (в зависимости от выбранного закона кодирования канала TDM) в режиме VBD (добавлением атрибута a=gpmd:98 vbd=yes). Если сторонами соединения согласовано использование VBD, то при обнаружении в канале TDM работающего факса или модема происходит автоматическое переключение с передачи голоса на передачу данных VBD, при котором над передаваемыми данными не производится никаких преобразований - отключено изменение уровня сигнала, подавление эха и т.п.

Если чекбокс отмечен, то режим VBD запрещен: кодек в режиме VBD не добавляется в предложение DSP и в ответ на предложение DSP.

Значение по умолчанию - чекбокс не отмечен (VBD разрешен).
Отключить эхоподавление Все Если чекбокс не отмечен, разрешено использование функции подавления эха. Если чекбокс отмечен, функция подавления эха запрещена.

Значение по умолчанию - чекбокс не отмечен (эхоподавление разрешено).
Отключить комфортный шум Все Если чекбокс не отмечен, то при использовании VAD удаленной стороной соединения, когда во время пауз удаленная сторона перестает передавать поток RTP, в канал TDM генерируется комфортный шум в соответствии с полученными от удаленной стороны параметрами.

Если чекбокс отмечен, то во время пауз в канал TDM передается константа, представляющая уровень 0 для выбранного закона кодирования (a-law или μ-law), что дает полную тишину в паузах.

Значение по умолчанию - чекбокс не отмечен (комфортный шум разрешен).
Размер пакета RTP Все Параметр определяет интервал отправки пакетов RTP передаваемого медиапотока (в принимаемом медиапотоке RTP поддерживаются любые размеры пакета). Может быть выбран один из вариантов: 5 мс, 10 мс, 20 мс, 30 мс, 40 мс, 50 мс или 60 мс. Следует учитывать, что пакет должен содержать целое число фреймов кодека. Если выбранный интервал не позволяет уместить целое число фреймов используемого кодека, выбранный интервел будет увеличен до значения, способного вместить целое число вреймов.

Значение по умолчанию - 20мс.
Битрейт G723.1 Все Параметр определяет, какой битрейт будет использоваться при выборе кодека G.723. Может быть выбран один из вариантов: 5.3 kbps или 6.3 kbps.

Значение по умолчанию - 5.3 kbps.
Включить RTCP Все Если чекбокс отмечен, будут передаваться и приниматься пакеты RTCP. Если чекбокс не отмечен, пакеты RTCP не генерируются, принимаемые пакеты игнорируются.

Значение по умолчанию - чекбокс отмечен.
Медиа Все кроме потоков RTP Параметр определяет, будет ли использоваться шифрование медиапотока:
• только RTP - шифрование запрещено (RTP/SAVP не предлагается и не принимается в SDP);
• RTP/SRTP - шифрование разрешено (в передаваемых предложениях SDP присутствует как RTP/SAVP, так и RTP/AVP, при ответе на предложение SDP предпочтение отдается RTP/SAVP, но если такого не предлагается, принимается и RTP/AVP);
• только SRTP - шифрование обязательно (RTP/AVP не предлагается и не принимается в SDP).
Мониторинг качества RTP Все Если чекбокс отмечен, при активности медиапотока контролируется задержка, джиттер, коэффициент потерь, период RTCP. При выходе какого-либо параметра за допустимые пределы формируется авария. Если чекбокс не отмечен, параметры медиапотока не контролируются, аварии не формируются.

Значение по умолчанию - чекбокс не отмечен.
Задержка Все Параметр действует только если чекбокс "Мониторинг качества RTP" отмечен. Устанавливает верхний и нижний пороги круговой задержки в мс. Если измеренное значение превышает верхний порог, формируется авария "превышен порог круговой задержки". Авария снимается, если задержка снижается ниже нижнего порога.

Значения по умолчанию - 500 мс (верхний порог), 300 мс (нижний порог.
Джиттер Все Параметр действует только если чекбокс "Мониторинг качества RTP" отмечен. Устанавливает верхний и нижний пороги джиттера в мс. Если измеренное значение превышает верхний порог, формируется авария "превышен порог джиттера" и/или "превышен порог джиттера удаленной стороны". Авария снимается, если джиттер снижается ниже нижнего порога.

Значения по умолчанию - 20 мс (верхний порог), 14 мс (нижний порог.
Потери RTP Все Параметр действует только если чекбокс "Мониторинг качества RTP" отмечен. Устанавливает верхний и нижний пороги потерь пакетов RTP в %. Если измеренное значение превышает верхний порог, формируется авария "превышен порог потери RTP пакетов" и/или "превышен порог потери RTP пакетов удаленной стороны". Авария снимается, если величина потерь снижается ниже нижнего порога.

Значения по умолчанию - 25% (верхний порог), 15% (нижний порог.
Таймаут RTCP Все Параметр действует только если чекбокс "Мониторинг качества RTP" отмечен. Устанавливает величину таймаута приема пакетов RTCP в секундах. Если в течение заданного промежутка времени не было принято ни одного пакета RTCP, формируется авария "таймаут RTCP". Авария снимается при получении пакета RTCP.

Значение по умолчанию - 40 с.
RTP TTL Все Параметр определяет значение поля TTL (Time To Live) в заголовке IP передаваемых пакетов RTP.

Значение по умолчанию - 128.
RTCP TTL Все Параметр определяет значение поля TTL (Time To Live) в заголовке IP передаваемых пакетов RTCP.

Значение по умолчанию - 128.
RTP DSCP Все Параметр определяет значение поля DSCP (DiffServ Code Point) в заголовке IP передаваемых пакетов RTP.

Значение по умолчанию - 0.
RTCP DSCP Все Параметр определяет значение поля DSCP (DiffServ Code Point) в заголовке IP передаваемых пакетов RTCP.

Значение по умолчанию - 0.
Режим буферизации Все Параметр определяет выбор величины буфера принимаемого медиапотока и может принимать одно из следующих значений:
• автоматический - размер буфера выбирается и изменяется автоматически в диапазоне от 0 до 200 мс в зависимости от текущей величины джиттера;
• фикс. 10 мс - фиксированный размер буфера 10 мс;
• фикс. 20 мс - фиксированный размер буфера 20 мс;
• фикс. 50 мс - фиксированный размер буфера 50 мс;
• фикс. 100 мс - фиксированный размер буфера 100 мс;
• фикс. 200 мс - фиксированный размер буфера 200 мс;
• адаптивный 1 - размер буфера выбирается и изменяется автоматически в диапазоне от 0 до 50 мс в зависимости от текущей величины джиттера с быстрым возвратом к низким значениям при снижении джиттера;
• адаптивный 2 - размер буфера выбирается и изменяется автоматически в диапазоне от 60 до 200 мс в зависимости от текущей величины джиттера.

Значение по умолчанию - автоматический.
Назначение потоки RTP Параметр определяет адрес и порт назначения передаваемого медиапотока RTP. Значение задается в формате "<IP адрес>:<порт>", например 192.168.0.75:1234.
Избыточность RTP потоки RTP Параметр определяет величину избыточности передаваемого медиапотока:
• нет - избыточность отсутствует;
• x2 - двукратная избыточность;
• x3 - трехкратная избыточность;
• x4 - четырехкратная избыточность.
Передавать СУВ потоки RTP Если чекбокс не отмечен, в RTP потоке передаются только голосовые пакеты. Если чекбокс отмечен, кроме голосовых пакетов передаются также RTP пакеты RFC2833 с сигналами СУВ.

Значение по умолчанию - чекбокс отмечен (СУВ передаются).
СУВ Payload Type потоки RTP Параметр действует только если чекбокс "Передавать СУВ" отмечен. Параметр определяет значение поля Payload Type для пакетов RTP, передающих значения СУВ.

Значение по умолчанию - 101.
Мастер-ключ потоки RTP Параметр устанавливает мастер-ключ для шифрования потока RTP. Допустимыми значениями являются пустая строка (шифрование отсутствует, передается незашифрованный RTP) или строка, состоящая из 60 шестнадцатеричных символов (передается зашифрованный поток SRTP). Для организации шифрованного канала на обоих сторонах должен быть установлен одинаковый мастер-ключ.

Значение по умолчанию - пустая строка (поток RTP без шифрования).
Маскировать аварии "LOS" / "Rem. host down" потоки RTP Если чекбокс не отмечен, в случае отсутствия входящего потока RTP формируется авария "LOS (нет входящего потока RTP)", а при отсутствии ответов на запросы ARP формируется авария "Remote host is down". Если чекбокс отмечен, эти аварии не формируются.

Значение по умолчанию - чекбокс не отмечен (аварии формируются).
Комментарий потоки RTP Параметр устанавливает текстовый комментарий для медиапотока RTP.

Значение по умолчанию - пустая строка.

Конфигурационные параметры T.38

Параметры T.38 используются во всех канальных окончаниях SIP кроме PPS и АДАСЭ.

Название параметра Описание параметра
Разрешить использование T.38 Если чекбокс не отмечен, канальное окончание не использует T.38 (не реагирует на наличие сигналов факс-машины в канале, не принимает медиапотоки image/udptl). Если чекбокс отмечен, использование T.38 разрешено (канальное окончание принимает предложение медиапотока image/udptl и может само инициировать переход в режим T.38 в зависимости от установок других параметров).

Значение по умолчанию - чекбокс не отмечен (использование T.38 запрещено).
Разрешить переход в режим T.38 по приему флагов V.21 после ответного тона V.25 Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Если чекбокс отмечен, при обнаружении в канале TDM ответного тона V.25 с последующими флагами V.21 (10 последовательных флагов HDLC V.21 ch2) канальное окончание инициирует переход в режим T.38. Если чекбокс не отмечен, канальное окончание на прием флагов V.21 не реагирует.

Значение по умолчанию - чекбокс отмечен.
Разрешить переход в режим T.38 по приему Fax Calling Tone (CNG 1100 Гц) Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Если чекбокс отмечен, при обнаружении в канале TDM Fax Calling Tone (CNG 1100 Гц) канальное окончание инициирует переход в режим T.38. Если чекбокс не отмечен, канальное окончание на прием Fax Calling Tone (CNG 1100 Гц) не реагирует.

Значение по умолчанию - чекбокс не отмечен.
Запретить Error Correction Mode (ECM) Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Если чекбокс отмечен, канальное окончание не использует Error Correction Mode в режиме T.38. Если чекбокс не отмечен, Error Correction Mode может использоваться.

Значение по умолчанию - чекбокс не отмечен.
Включить имитацию факс-машины (T.38 spoofing) Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Если чекбокс отмечен, канальное окончание имитирует факс-машину при передаче факса в режиме T.38. Если чекбокс не отмечен, T.38 spoofing не используется.

Значение по умолчанию - чекбокс не отмечен.
Максимальная скорость передачи Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Параметр устанавливает верхний предел скорости передачи факса и может принимать одно из следующих значений:
• не ограничена;
• 2400 бит/с;
• 4800 бит/с;
• 7200 бит/с;
• 9600 бит/с;
• 12000 бит/с;
• 14400 бит/с.

Значение по умолчанию - не ограничена.
Избыточность передачи данных Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Параметр устанавливает величину избыточности при передаче данных факса в режиме T.38 и может принимать одно из следующих значений:
• нет - избыточность отсутствует;
• 1 - передается 1 повтор пакета;
• 2 - передается 2 повтора пакета;
• 3 - передается 3 повтора пакета.

Значение по умолчанию - нет (избыточность отсутствует).
Избыточность передачи сообщений T.30 Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Параметр устанавливает величину избыточности при передаче сообщений T.30 в режиме T.38 и может принимать одно из следующих значений:
• нет - избыточность отсутствует;
• 1 - передается 1 повтор пакета;
• 2 - передается 2 повтора пакета;
• 3 - передается 3 повтора пакета;
• 4 - передается 4 повтора пакета;
• 5 - передается 5 повторов пакета;
• 6 - передается 6 повторов пакета;
• 7 - передается 7 повторов пакета.

Значение по умолчанию - 3 (3 повтора пакета).
Сокрытие потерянных пакетов (PLC) Параметр действует только если чекбокс "Разрешить использование T.38" отмечен. Параметр устанавливает метод сокрытия потерь данных при приеме факса в режиме T.38 и может принимать одно из следующих значений:
• отключено - сокрытия потерь данных не производится;
• белая строка - плохая строка замещается белой строкой;
• предыдущая строка - плохая строка замещается предыдущей строкой.

Значение по умолчанию - отключено.

Разные параметры

Название параметра В каких канальных окончаниях используется Описание параметра
Таймаут соединения Все окончания SIP Параметр устанавливает максимальную длительность соединения в минутах. При достижении заданной длительности соединение разрывается. Значение 0 означает, что длительность соединения не ограничена.

Значение по умолчанию - 0 (длительность соединения не ограничена).
Таймаут RTP Все окончания SIP Параметр устанавливает максимально допустимое время отсутствия входящего медиапотока RTP в секундах. Если медиапоток RTP не принимается в течение заданного времени, соединение разрывается. Значение 0 означает, что время отсутствия потока RTP не ограничено.

Значение по умолчанию - 0 (время отсутствия потока RTP не ограничено).
Рег. выражение вызова Все окончания SIP кроме FXS и PPS Параметр устанавливает регулярное выражение, на совпадение с которым проверяется username вызываемого SIP URI на втором проходе поиска канального окончания. Допустимы две формы значения:
• простое регулярное выражение - строка, не начинающаяся с символа '/', представляет собой только регулярное выражение, например ^+7\d{4,7};
• регулярное выражение с заменой - значение имеет формат /<regexp>/<replacement>, где regexp - регулярное выражение, replacement - строка, на которую заменяется вызываемый номер в случае его совпадения с регулярным выражением. Replacement может содержать подстановки фрагментов регулярного выражения '\1', '\2' и т.д. Пример: /^+?7342(\d{7})/\1 - принимается номер, начинающийся с необязательного символа '+' и префикса '7342', от которого отбрасывается префикс. Пустое значение параметра означает, что канальное окончание не принимает вызовы на втором проходе поиска.

Значение по умолчанию - пустая строка.
Рег. выражение набора (в FXS - "Рег. выражение номера") FXS, 1IND, R2, АДАСЭ Параметр устанавливает регулярное выражение, на совпадение с которым проверяется принимаемый из канала TDM номер вызываемого абонента. После приема каждой очередной цифры номера принятая последовательность проверяется на совпадение с регулярным выражением, и если совпадение есть, немедленно выполняется вызов набранного номера без ожидания таймаута набора. Допустимы две формы значения:
• простое регулярное выражение - строка, не начинающаяся с символа '/', представляет собой только регулярное выражение, например ^(1..|2.{6}) - вызывать номера из трех цифр, начинающиеся с цифры 1, или номера из 7 цифр, начинающиеся с цифры 2;
• регулярное выражение с заменой - значение имеет формат /<regexp>/<replacement>, где regexp - регулярное выражение, replacement - строка, на которую заменяется вызываемый номер в случае его совпадения с регулярным выражением. Replacement может содержать подстановки фрагментов регулярного выражения '\1', '\2' и т.д. Пример: /^2(\d{6})/73422\1 - при наборе номера из 7 цифр, начинающегося с цифры 2, вызывать этот номер, добавляя к нему префикс '7342'. Пустое значение параметра означает, что набираемый номер на совпадение с регулярным выражением не проверяется, вызов происходит только по таймауту набора.

Значение по умолчанию - пустая строка.
Note: See TracWiki for help on using the wiki.