Shkerka.ruзаметки админа
Asterisk и IP-АТС

DTMF-генератор на Asterisk

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция Shkerka.ru

Приложение SendDTMF превращает Asterisk в генератор тональных сигналов: он может имитировать нажатия клавиш, проходить голосовые меню и проверять, как удалённая сторона принимает DTMF. Собираем тестовый номер, который отправляет цифры с заданным интервалом.

Зачем Asterisk генерировать DTMF

DTMF — это тональные сигналы, которые телефон отправляет при нажатии клавиш. Обычно Asterisk их принимает: в голосовых меню, при вводе PIN-кодов, при переводе вызова. Но он умеет и отправлять их сам приложением SendDTMF. Это пригодится, когда нужно:

  • автоматически пройти голосовое меню чужой АТС, например набрать добавочный номер после ответа автосекретаря;
  • проверить, как оператор или шлюз передаёт DTMF — доходят ли цифры, не дублируются ли, не теряются ли на транскодировании;
  • держать соединение активным: некоторые сервисы разрывают «молчащий» вызов, а периодический сигнал показывает, что на линии кто-то есть;
  • проверить стойкость защиты собственных сервисов, например конференц-комнат с PIN-кодом: насколько быстро система блокирует перебор.

Проверять подбором кодов можно только свои системы или системы, владелец которых дал на это согласие.

Синтаксис SendDTMF

SendDTMF(digits[,timeout_ms[,duration_ms[,channel[,options]]]])
  • digits — строка из цифр 0–9, *, # и букв A–D. Символ w вставляет паузу 0,5 секунды, W — 1 секунду.
  • timeout_ms — пауза между цифрами, по умолчанию 250 мс.
  • duration_ms — длительность каждого сигнала.
  • channel — имя другого канала, если цифры надо отправить не в текущий.

Пример: ответить, подождать приветствия меню и набрать добавочный 205:

exten => 3559010,1,Dial(PJSIP/4951234567@provider,60,D(ww205))

Опция D() у Dial отправляет цифры вызываемой стороне сразу после ответа. Две w дают секунду паузы.

Генератор по таймеру

Задача: тестовый номер отвечает и в течение заданного времени каждые 30 секунд отправляет #, а ещё через 30 секунд — 1. Один круг занимает минуту, число кругов задаёт длительность. Номер 3559000 работает около 10 минут, 3559001 — около получаса.

[dtmf-gen]
exten => 3559000,1,Set(ROUNDS=10)
 same => n,Goto(dtmf-loop,s,1)

exten => 3559001,1,Set(ROUNDS=30)
 same => n,Goto(dtmf-loop,s,1)

[dtmf-loop]
exten => s,1,Answer()
 same => n,Wait(2)
 same => n,Set(i=0)
 same => n,While($[${i} < ${ROUNDS}])
 same => n,SendDTMF(#)
 same => n,Wait(30)
 same => n,SendDTMF(1)
 same => n,Wait(30)
 same => n,Set(i=$[${i} + 1])
 same => n,EndWhile()
 same => n,Hangup()

Переменная ROUNDS устанавливается в канале до перехода и остаётся доступной в контексте dtmf-loop. Внутри цикла не нужен Goto на первую строку: EndWhile() сам возвращает выполнение к While. Если добавить Goto(s,1), счётчик будет обнуляться каждый круг, и вызов никогда не закончится.

Для страховки ограничьте максимальную длительность канала — добавьте сразу после Answer() строку:

 same => n,Set(TIMEOUT(absolute)=2000)

После 2000 секунд Asterisk завершит вызов, даже если в логике цикла ошибка.

DTMF из звукового файла

Иногда нужно передать сигнал именно как звук в разговорном канале — например, если на другой стороне аналоговая линия или устройство не понимает RFC 4733. Тогда вместо SendDTMF используют PlayTones или заранее записанный файл:

; тон DTMF «1» длительностью 200 мс
exten => s,n,PlayTones(697+1209/200)
exten => s,n,Wait(1)
exten => s,n,StopPlayTones()

Частоты DTMF — сочетание низкой (697, 770, 852, 941 Гц) и высокой (1209, 1336, 1477, 1633 Гц) составляющих. Для «1» это 697 + 1209 Гц, для «#» — 941 + 1477 Гц.

Звук в канале чувствителен к кодеку: при сжатии G.729 или в джиттер-буфере тоны искажаются. Для таких тестов используйте G.711 (alaw или ulaw).

Режимы передачи DTMF

От настройки endpoint в pjsip.conf зависит, как SendDTMF доставит цифры:

dtmf_mode Как передаётся Когда подходит
rfc4733 Отдельные RTP-события Большинство операторов и IP-телефонов
inband Звуком в аудиопотоке Старые шлюзы, только с G.711
info SIP-сообщения INFO Отдельные операторы и шлюзы
auto rfc4733, если поддерживается, иначе inband Смешанные устройства
auto_info rfc4733 или INFO Если inband нежелателен

Режим rfc4733 — это бывший rfc2833 из chan_sip. Набор доступных значений немного отличается между версиями, поэтому сверьтесь с документацией своей версии Asterisk.

Запуск генератора из консоли

Не обязательно звонить на тестовый номер с телефона. Вызов можно создать из консоли и сразу передать в контекст генератора:

asterisk -rx "channel originate PJSIP/4951234567@provider extension s@dtmf-loop"

Переменную ROUNDS при таком запуске нужно задать в самом контексте или через call-файл с Setvar. Механизм call-файлов подробно описан в статье про автообзвон на Asterisk.

Отладка

  1. Откройте консоль asterisk -rvvvvv.
  2. Включите вывод SIP-сообщений: pjsip set logger on.
  3. Для RTP-событий используйте rtp set debug on — в выводе будут видны пакеты с DTMF-событиями.

Если цифры уходят, но удалённая сторона их не распознаёт, сравните payload type события telephone-event в SDP обеих сторон. Несовпадение — частая причина «потерянных» DTMF у операторов.

Ещё один приём работы с циклами разобран в статье как проиграть звуковой файл несколько раз.

Частые вопросы

Почему удалённая сторона не видит DTMF от SendDTMF?

Чаще всего не совпадает режим передачи. Проверьте dtmf_mode у endpoint: rfc4733, inband, info или auto, и что выбранный режим поддерживает оператор или устройство на другой стороне.

Как сделать паузу между цифрами в SendDTMF?

Символ w в строке цифр означает паузу в полсекунды, W — секунду. Например, SendDTMF(1w2w#) отправит 1, 2 и решётку с паузами.

Можно ли отправить DTMF в уже идущий разговор?

Да: SendDTMF умеет отправлять цифры в другой канал, его имя передаётся четвёртым параметром. Через AMI для этого есть действие PlayDTMF.

Как распознать DTMF, которые прислали Asterisk?

Read, WaitExten и Background принимают цифры от звонящего. Для отладки включите в консоли core set verbose 5 и core set debug 1 — получение DTMF будет видно в журнале.