Уточнение разделов руководства по эксплуатации. Агат.

[mixyil1.1]

Тикет перенес alx из ​sip_ua:#348

Добавить ссылки на исходный код для разделов руководства по эксплуатации, указанных ниже.

Пример описания.

При совершении телефонного вызова через шлюз сначала проверяется, имеется ли набранный номер в списке SIP пользователей (MyLocationServer::process() repro.cpp:185) (список пользователей задается при конфигурации платы).Если пользователь найден в списке, шлюз отправляет сообщение пользователю в соответствии с его контактами (ua_dial_out() user_agent.cpp:3377) (если пользователь зарегистрирован на SIP REGISTRAR) или возвращает ответ с кодом 480 (MyLocationServer::process() repro.cpp:259) (если пользователь не зарегистрирован).

---

7.4.10 Тип окончания – FXS/Удержание вызова

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

Активное соединение можно перевести в режим удержания, передав сигнал Flash (на телефонных аппаратах для этой цели служит клавиша, обозначаемая "Flash" или "R").
Допустимая длительность сигнала Flash определяется конфигурационным параметром "Длительности Flash" и может быть выбрана в пределах от "только 80 мс" до "80 мс -900 мс".
После получения сигнала Flash канальное окончание FXS переводит текущее соединение в режим удержания: прекращается прием и передача медиапотока, удаленному UA передается reINVITE
с атрибутом a=inactive. В абонентскую линию передается сигнал готовности к набору номера. В этом состоянии пользователь может сделать новый вызов, продолжая удерживать уже существующий.

При отсутствии активного соединения возврат к удерживаемому соединению выполняется передачей сигнала Flash. При этом удаленному UA удерживаемого соединения вновь отправляется reINVITE,но уже без атрибута a=inactive, и после получения ответа вновь активируется медиапоток.

---

7.4.11 Тип окончания – FXS/ Управление двумя соединениями
При наличии двух активных соединений (активного и удерживаемого) возможности абонента зависят от конфигурационного параметра "РежимДВО" канального окончания FXS.

Если параметр "Режим ДВО" установлен в значение "только flash", абонент может переключаться между активным и удерживаемым соединениями с помощью сигнала Flash.
Если в глобальных конфигурационных параметрах платы VE-01 отмечен чекбокс "Разрешить передачу вызова опусканием трубки", то при опускании трубки будет инициирована
передача вызова между удерживаемым и активным соединениями, иначе оба соединения будут разорваны.Если параметр "Режим ДВО" установлен в значение "flash+цифра",
то при нажатии Flash в абонентскую линию начнет передаваться сигнал готовности, сигнализирующий о необходимости набрать цифру, определяющую одно из возможных действий:

1. отбой удерживаемого соединения;
2. отбой активного соединения;
3. переключение между активным и удерживаемым соединениями;
4. передача вызова между удержваемым и активным соединениями;
5. объединение соединений в конференцию.

Цифры, которыми инициируются перечисленные функции, назначаются глобальными настройками платы VE-01 (вкладка "ДВО" диалога конфигурации платы в веб-интерфейсе).
Как и в режиме "только flash", если в глобальных конфигурационных параметрах платы VE-01 отмечен чекбокс "Разрешить передачу вызова опусканием трубки", то при
опускании трубки будет инициирована передача вызова между удерживаемым и активным соединениями.
Обратите внимание, что цифра, с помощью которой инициируется одна из перечисленных функций, должна передаваться методом DTMF (в тональном режиме телефонного аппарата).Прием цифры импульсным способом не поддерживается.

---

7.4.13 Тип окончания – FXS/ Объединение соединений в конференцию
Канальное окончание FXS имеет функцию организации конференций методом, описанным в "SIP conferencing framework" (​RFC:4579). В зависимости от значения глобального конфигурационного
параметра "Conference factory URL" платы VE-01 может использоваться внешний или встроенный в плату VE-01 сервер конференций. Если значение параметра
"Conference factory URL" не пустое, канальное окончание FXS использует указанный URL в качестве Conference factory. Если значение параметра пустое,
будет использоваться URL conference-factory@127.0.0.1.

Функция объединения соединений в конференцию доступна только при значении конфигурационного параметра "Режим ДВО" "flash+цифра".
При активации услуги канальное окончание FXS обращается к conference factory для создания конференции, после чего выполняет передачу существующих соединений конференции.
Если конференция создается встроенным в плату VE-01 conference-factory, URI фокуса созданной конференции имеет параметр x-id, значением которого является случайная
последовательность символов, генерируемая при создании конференции. При получении сообщений INVITE или REFER фокус конференции проверяет наличие и валидность параметра
x-id. Только запросы, имеющие верное значение параметра x-id, обслуживаются фокусом конференции. Это защищает созданную конференцию от неавторизованного подключения
посторонних абонентов.

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

1. REFER фокусу конференции;
2. REFER абонентам.

Для выбора одного из методов служит глобальный конфигурационный параметр платы VE-01 "Метод создания конференции". При выборе метода "REFER фокусу конференции"
канальное окончание FXS посылает фокусу конференции сообщение REFER, в поле Refer-Toкоторого указаны параметры одного из соединений. После получения REFER фокус
конференции посылает абоненту соединения INVITE с заголовком Replaces, заменяя существующее соединение новым. После получения от фокуса конференции уведомления
о завершении трансфера инициатор создания конференции аналогичным образом инициирует трансфер в конференцию второго соединения.

При выборе метода "REFER абонентам" канальное окончание FXS посылает сообщения REFER абонентам, указывая в поле Refer-ToURI фокуса конференции.

---

7.4.14 Тип окончания – FXS/ Дополнительные виды обслуживания (ДВО)
Дополнительные виды обслуживания имеют два уровня управления: во-первых, оператор может разрешить или запретить использование абонентом (пользователем) той
или иной услугой ДВО, во-вторых, если использование услуги разрешено оператором, то пользователь имеет возможность самостоятельно активировать,
деактивировать и настраивать услуги ДВО (например,включать и выключать переадресацию вызовов).

Обратите внимание, что настройки услуг ДВО, в отличие от параметров канального окончания, привязаны не к канальному окончанию, а к URI пользователя.
Такими образом, если имеется несколько канальных окончаний с одним и тем же URI, услуга ДВО, активированная любым из них (например,"Не беспокоить")
будет действовать для всех канальных окончаний с тем же URI.

Оператор может разрешать и запрещать пользование услугами ДВО, устанавливая и снимая отметки чекбоксов в колонке "Разрешение" вкладки "Установки ДВО" диалога
конфигурации канального окончания

[alx]

Поясню, что речь идет об аппаратуре MC04-DSL-VIP.

Мое мнение - для успешной эксплуатации аппаратуры MC04-DSL-VIP оператору не требуется знать имена функций и номера строк в исходном коде.

[san]

В РЭ ссылки на исходный код мы публиковать не будем.

[san]

Milestone deleted