РЭ: не выдержана единая схема при описании канальных окончаний VE-01/VE-02

[alx]

в РЭ аппаратуры MC04-DSL-3U редакции 42 при описании большинства канальных окончаний плат VE-01/VE-02 используется более-менее одинаковая схема изложения материала. Так, описание большинства типов канальных окончаний начинается с раздела "Подключение к шлюзу канального окончания", в котором описываются действия оператора, которые необходимы для создания канального окончания данного типа. Однако в случае канальных окончаний MFC R2, R2DTMF, МБ и АДАСЭ от этой схемы почему-то сделано отступление, и раздел "Подключение к шлюзу канального окончания" описывает линейные и частотные сигналы, передаваемые и принимаемые через соединительную линию, а действия оператора, необходимые для создания канального окончания - не описываются.

Считаю такое отступление от общей схемы нерациональным, так как читатель, прочитав описания нескольких других канальных окончаний, будет по аналогии искать информацию о том, как создать канальное окончание R2, R2DTMF, МБ и АДАСЭ, в разделе "Подключение к шлюзу канального окончания" (а его там нет!), и наоборот, мысль о поиске информации о линейных и тональных сигналах в разделе "Подключение к шлюзу канального окончания" ему в голову не придет.

Дополнение от 17.09.21:

В РЭ редакции 51 частное предложение тикета (добавить описание подключения к шлюзу всех кананых окончаний) было выполнено (хотя из большинства из них убран собственно раздел "Подключение к шлюзу канального окончания"), однако основная суть предложения - привести структуру описания всех канальных окончаний VE-01/VE-02 - осталась не выполненной. Разбор различий в структурах разделов трех первых (я их специально не выбирал!) канальных окончаний приведен в comment:5.

Учитывая сказанное выше, более четко формулирую свое предложение (почти точной цитатой из комментария san): предлагаю выработать единую оптимальную структуру изложения материала описаний канальных окончаний плат VE-01/VE-02 и применить её ко всем окончаниям в тексте РЭ.

[alx]

Как оказалось, то же самое справедливо для канального окончания R2DTMF. Чтобы не создавать второй почти точно такой же тикет, расширил описание этого.

[alx]

Как оказалось, то же самое справедливо для канального окончания АДАСЭ. Чтобы не создавать второй почти точно такой же тикет, расширил описание этого.

[alx]

Как оказалось, то же самое справедливо для канального окончания МБ. Чтобы не создавать второй почти точно такой же тикет, расширил описание этого.

[Vladimir]

В РЭ-51 от 27.07.2021 создание канальных окончаний R2/R2DTMF/АДАСЭ/МБ добавил в разделы "Подключение к шлюзу канального окончания" как и для всех остальных КО.

[alx]

Replying to Vladimir:

В РЭ-51 от 27.07.2021 создание канальных окончаний R2/R2DTMF/АДАСЭ/МБ добавил в разделы "Подключение к шлюзу канального окончания" как и для всех остальных КО.

Хм... Насколько я вижу, раздела "Подключение к шлюзу канального окончания" в описании этих канальных окончаний нет. Более того, он исчез и из описания некоторых других канальных окончаний, в которых ранее был. Такой раздел я вижу в описании единственного типа канального окончания - FXS.

Главная мысль, суть улучшения, предложенного мной в этом тикете - сделать так, чтобы структура описаний канальных окончаний была единообразной - по возможности использовалась одинаковая схема. Однако то, что я вижу в РЭ-51, мне трудно назвать единой схемой. Давай для примера рассмотрим структуры описания трех первых типов канальных окончаний. Вот структура описания канального окончания FXS:

• 7.4.4.1 Подключение к шлюзу окончания FXS
• 7.4.4.2 Описание работы канального окончания
• 7.4.4.3 Прием вызова со стороны сети IP
• 7.4.4.4 Вызов в сторону сети IP
• 7.4.4.5 Ограничение некоторых видов связи
• 7.4.4.6 Отбой соединения
• 7.4.4.7 Удержание вызова
• 7.4.4.8 Управление двумя соединениями
• 7.4.4.9 Передача вызова (Call Transfer)
• 7.4.4.10 Объединение соединений в конференцию
• 7.4.4.11 Дополнительные виды обслуживания (ДВО)
• 7.4.4.12 ДВО / Описание функции «Перехват вызова»
• 7.4.4.13 ДВО / Скажи мой номер
• 7.4.4.14 ДВО / Текущее время
• 7.4.4.15 ДВО / Режим "Не беспокоить"
• 7.4.4.16 ДВО / Ожидание вызова (Call Waiting)
• 7.4.4.17 ДВО / Переадресация вызова (Call Forward)
• 7.4.4.18 ДВО / Пароль на Междугородную связь и ДВО
• 7.4.4.19 Параметры конфигурации канального окончания
• 7.4.4.20 Состояния канального окончания FXS
• 7.4.4.21 Password –Запрос на ввод пароля абонентом.

Вот структура описания канального окончания FXO:

• 7.4.5.1 Описание работы канального окончания
• 7.4.5.2 Входящий вызов
• 7.4.5.3 Исходящий вызов
• 7.4.5.4 Отбой
• 7.4.5.5 Автоматическая блокировка при неисправности линии
• 7.4.5.6 Параметры конфигурации
• 7.4.5.7 Таймаут звонка
• 7.4.5.8 Таймаут гудка
• 7.4.5.9 Игнорировать наличие гудка
• 7.4.5.10 Префикс межгорода
• 7.4.5.11 Пауза межгорода
• 7.4.5.12 Число звонков
• 7.4.5.13 Преобразование Caller-ID
• 7.4.5.14 Отбой после "X" циклов "Занято"
• 7.4.5.15 Вызывать URI (унифицированный идентификатор ресурса)
• 7.4.5.16 Состояния канального окончания

А вот структура описания канального окончания 1IND:

• 7.4.6.1 Инверсия СУВ
• 7.4.6.2 Использовать сигнал "Снятие ответа"
• 7.4.6.3 Воспринимать первый "Ответ" как запрос АОН
• 7.4.6.4 Межцифровой интервал
• 7.4.6.5 Префикс межгорода
• 7.4.6.6 Пауза межгорода
• 7.4.6.7 Таймаут набора
• 7.4.6.8 Макс. число запросов АОН
• 7.4.6.9 Преобразование АОН
• 7.4.6.10 Шаблон посылки АОН
• 7.4.6.11 Категория по умолчанию
• 7.4.6.12 Тип окончания – 1IND / Состояния канального окончания 1IND
• 7.4.6.13 Вызов со стороны TDM
• 7.4.6.14 Определение номера входящего вызова TDM ‒ > IP
• 7.4.6.15 Вызов со стороны IP
• 7.4.6.16 Определение номера исходящего вызова IP ‒ > TDM
• 7.4.6.17 Встречное занятие
• 7.4.6.18 Отбой

Уже можно видеть различия в структуре описаний.

Описание канального окончания FXS начинается с раздела "Подключение к шлюзу канального окончания", в котором в-основном описаны конфигурационные параметры окончания. Затем идут разделы, каждый из которых описывает какую-то часть работы окончания - входящий вызов, исходящий вызов, отбой, удержание и т.д. (перед этим идет раздел "Описание работы канального окончания", что нелогично, так как следующие за ним разделы тоже описывают работу канального окончания, и поэтому, по логике, должны были бы в него входить, но сейчас не об этом). Затем идет раздел "Параметры конфигурации канального окончания", в котором повторно (видимо, для закрепления ранее пройденного материала) описаны конфигурационные параметры. Заканчивается описание разделами "Состояния канального окончания" и "Password –Запрос на ввод пароля абонентом" (непонятно, зачем одно из состояний выделено в самостоятельный раздел, но сейчас опять не об этом).

Сравниваем это со структурой описания FXO и сразу видим различия. Раздела "Подключение к шлюзу" нет, то, что для окончания FXS описано в разделе "Подключение к шлюзу", для окончания FXO описано в разделе более верхнего уровня (7.4.5). Далее, как и в FXO описывается работа канального окончания. Затем, как и для FXS, идет раздел "Параметры конфигурации", но, в отличие от канального окончания FXS, повторное описание каждого параметра выделено в отдельный раздел - "7.4.5.7 Таймаут звонка", "7.4.5.8 Таймаут гудка" и т.д...

Сравниваем это с описанием окончания 1IND. В отличие от предыдущих двух окончаний конфигурационные параметры описаны только один раз (а как же мать учения?). Как и в случае FXO, описание каждого конфигурационного параметра вынесено в отдельный раздел ("7.4.6.5 Префикс межгорода", "7.4.6.6 Пауза межгорода" и т.д.), но материал изложен в другом порядке: сначала идет разделы конфигурационных параметров, затем описаны состояния канального окончания, и только потом описывается его работа (вызов, определение номера, отбой)...

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

Подключаю к тикету Александра и прошу его совета, что делать с данной ситуацией: переоткрыть этот тикет, так как суть предложения не реализована? Оставить этот такрытым, но создать новый? Оставить все как есть и ничего не делать, так как информация как таковая изложена полно и точно, а единообразие изложения материала не является важным и существенным для РЭ?

[san]

Согласен с аргументами Алексея, думаю, что для описания окончаний нужно выработать единую оптимальную структуру и применить её ко всем окончаниям.
Думаю, что проще переоткрыть этот тикет и хорошо-бы добавить пояснения сути из последнего коммента в текст тикета.

[alx]

Выполняя пожелание san, дополнил описание тикета более четко сформулированным предложением по улучшению РЭ.

[san]

Milestone deleted

[Vladimir]

Replying to alx:

Выполняя пожелание san, дополнил описание тикета более четко сформулированным предложением по улучшению РЭ.

В РЭ-59 от22.09.2023 с учётом предложений в этом тикете
сделана единая структура описаний канальных окончаний плат VE.
В оглавлении РЭ реализована 4-х уровневая структура пунктов.

[alx]

Replying to Vladimir:

В РЭ-59 от22.09.2023 с учётом предложений в этом тикете
сделана единая структура описаний канальных окончаний плат VE.

Где она??? :-/ Посмотрел для примера описания параметров тех же трех канальных окончаний, которые упоминались для примера в comment:5. Что я вижу:

• у канального окончания 1IND конфигурационные параметры описаны в одном разделе (7.3.4) один раз;
• у канального окончания FXS конфигурационные параметры описаны дважды в двух разделах (7.3.1 и 7.3.1.18);
• у канального окончания FXO каждый конфигурационный параметр описан в своем отдельном разделе (7.3.2.7 ... 7.3.2.13).

Насколько я вижу, даже замечания, приведенные в пример в comment:5, не были учтены. Разве что разделов "подключение к шлюзу" больше нет...