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

[mixyil1.1]

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

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

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

[mixyil1.1]

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]

Тикеты, касающиеся руководства по эксплуатации, ведутся в проекте ​mc-04. А в этом проекте (sip_ua) создаются тикеты, касающиеся работы над программным обеспечением плат VE-01/VE-02.

Я перенес этот тикет в mc-04: ​MC-04:#626.

[san]

Алексей, я думаю ты не понял что хотел Михаил в этом тикете.
Насколько я понял, Михаил хочет, чтобы ты предоставил ему(и институту Агат) ссылки на части исходного когда соответствующего функциям процитированным из описания.
К редактированию РЭ это не имеет отношения.
Михаил, переформулируй задачу понятней. пожалуйста.

[mixyil1.1]

Речь идет не об изменении руководства по эксплуатации. Необходимо предоставить текст данных пунктов уточненный ссылками на исходный код.

[alx]

Replying to mixyil1.1:

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

Канальное окончание FXS позволяет абоненту (пользователю) переключить установленное соединение в режим удержания

ua_reinvite() fxs.cpp:341

и, в то время как соединение удерживается, инициировать

ua_dial_out() fxs.cpp:288

или принять новый вызов.

FXSChannel::processEvent() fxs.cpp:986

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

FXSChannel::switchCalls() fxs.cpp:344, fxs.cpp:876

Активное соединение можно перевести в режим удержания, передав сигнал Flash (на телефонных аппаратах для этой цели служит клавиша, обозначаемая "Flash" или "R").

FXSChannel::on_flash() fxs.cpp:1397

Допустимая длительность сигнала Flash определяется конфигурационным параметром "Длительности Flash" и может быть выбрана в пределах от "только 80 мс" до "80 мс -900 мс".

FXSChannel::cb_suv() fxs.cpp:1395

После получения сигнала Flash канальное окончание FXS переводит текущее соединение в режим удержания: прекращается прием и передача медиапотока, удаленному UA передается reINVITE
с атрибутом a=inactive.

SIPChannel::hold() comcerto.cpp:6104

В абонентскую линию передается сигнал готовности к набору номера.

ComcertoChannel::startTone() fxs.cpp:373

В этом состоянии пользователь может сделать новый вызов, продолжая удерживать уже существующий.

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

SIPChannel::hold() comcerto.cpp:6115

---

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

Если параметр "Режим ДВО" установлен в значение "только flash", абонент может переключаться между активным и удерживаемым соединениями с помощью сигнала Flash.

FXSChannel::switchCalls() fxs.cpp:344

Если в глобальных конфигурационных параметрах платы VE-01 отмечен чекбокс "Разрешить передачу вызова опусканием трубки", то при опускании трубки будет инициирована
передача вызова между удерживаемым и активным соединениями,

ua_refer() fxs.cpp:1512, fxs.cpp:1514

иначе оба соединения будут разорваны.

SIPChannel::hangup() fxs.cpp:1507

Если параметр "Режим ДВО" установлен в значение "flash+цифра",

то при нажатии Flash в абонентскую линию начнет передаваться сигнал готовности,

ComcertoChannel::startTone() fxs.cpp:1127

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

1. отбой удерживаемого соединения;

ua_hangup() fxs.cpp:865

2. отбой активного соединения;

ua_hangup() fxs.cpp:881

3. переключение между активным и удерживаемым соединениями;

FXSChannel::switchCalls() fxs.cpp:876

4. передача вызова между удержваемым и активным соединениями;

ua_refer() fxs.cpp:954, fxs.cpp:956

5. объединение соединений в конференцию.

ua_dial_out() fxs.cpp:937

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

VirtualChannelManager::processEvent() virtualChannel.cpp:113

Как и в режиме "только 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.

FXSChannel::processEvent() fxs.cpp:920

Если значение параметра пустое,

будет использоваться URL conference-factory@127.0.0.1.

FXSChannel::processEvent() fxs.cpp:919

Функция объединения соединений в конференцию доступна только при значении конфигурационного параметра "Режим ДВО" "flash+цифра".
При активации услуги канальное окончание FXS обращается к conference factory для создания конференции,

ua_dial_out() fxs.cpp:937

после чего выполняет передачу существующих соединений конференции.

ua_refer() fxs.cpp:1146, fxs.cpp:1148, fxs.cpp:1158, fxs.cpp:1175

Если конференция создается встроенным в плату VE-01 conference-factory, URI фокуса созданной конференции имеет параметр x-id, значением которого является случайная
последовательность символов, генерируемая при создании конференции.

VirtualChannelManager::processEvent() virtualChannel.cpp:168

При получении сообщений INVITE или REFER фокус конференции проверяет наличие и валидность параметра

x-id. Только запросы, имеющие верное значение параметра x-id, обслуживаются фокусом конференции.

ConferenceFocus::processEvent() conference.cpp:49, conference.cpp:134

Это защищает созданную конференцию от неавторизованного подключения

посторонних абонентов.

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

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

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

ua_refer() fxs.cpp:1158

После получения REFER фокус

конференции посылает абоненту соединения INVITE с заголовком Replaces, заменяя существующее соединение новым.

ua_refer_to() conference.cpp:238

После получения от фокуса конференции уведомления

о завершении трансфера инициатор создания конференции аналогичным образом инициирует трансфер в конференцию второго соединения.

ua_refer() fxs.cpp:1175

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

ua_refer() fxs.cpp:1146, fxs.cpp:1148

---

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

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

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

Я не понял, что требуется дополнить в это разделе. Во-первых, здесь не говорится о какой-либо функции платы (канального окончания), здесь говорится, что у оператора или пользователя в принципе есть какие-то возможности (включать/выключать какие-то функции). Во-вторых, на самом деле в MC04-DSL-VIP у оператора и абонента этих возможностей нет, так как в веб-интерфейсе просто нет чекбоксов, о которыъх здесь написано (видимо, этот фрагмент взят из руководства MC04-DSL-3U, а не MC04-DSL-VIP)...

[alx]

Так как дополнительных вопросов нет, будем считать, что Агат удовлетворен уточнениями.