РЭ: использование канального окончания EM с модулем EM01

[alx]

Изменил название пункта:
"7.3.3 Субмодуль EM01 (1 интерфейс ТЧ или 1 интерфейс E&M)"
Выделил подпункты:
"7.3.3.1 Интерфейс ТЧ канала (канальное окончание RTP)"
"7.3.3.2 Интерфейс E&M тип 5 (канальное окончание EM)"

Дополнил "Табл.5.32 Назначение контактов на разъёмах Х20 и Х21 платы VE-02":
назначение контактов указаны отдельно для EM01 (ТЧ) и EM01 (E&M).

• добавлены два новых конфигурационный параметра "Номинальный уровень входа" и "Номинальный уровень выхода", устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно;
• Не отображается конфигурационный параметр "ИКМ код".

В п "7.3.3.2 Интерфейс E&M тип 5 (канальное окончание EM)"
добавлен текст:
"• имеются конфигурационные параметры Номинальный уровень входа и Номинальный уровень выхода, устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (данные настройки не доступны при добавлении окончания EM
на вкладке Параметры канального окончания EM и могут быть настроены только в окне редактирования окончания EM);

• отсутствует настройка ИКМ код."

Используется 5-й тип интерфейса E&M.
Это указано прямо в заголовке пунктов.

Предлагаю добавить эту информацию в РЭ аппаратуры Mc04-DSL-3U.

В РЭ-55 от 26.12.2022 добавлена указанная в тикете инфломация.

[san]

По просьбе Vladimir опишу, что, на мой взгляд, стоит добавить в п.7.3.3 Субмодуль EM01 (1 интерфейс ТЧ)

7.3.3 Субмодуль EM01 (1 интерфейс ТЧ или 1 интерфейс E&M)
На плате VE-02 может быть установлено до 2 субмодулей EM01. Интерфейсы субмодулей расположены на лицевой стороне платы – разъемы Channel 1 и 2 (Рис. 5.36).
Субмодуль EM01 имеет возможность работать двумя типами канальных окончаний: RTP (ТЧ канал) или ​EM (интерфейс E&M). По умолчанию для субмодуля EM01 создается окончание RTP.
Интерфейс ТЧ канала (канальное окончание RTP)
Для каждого субмодуля EM01 по умолчанию автоматически создаётся RTP поток. На вкладке “Канальные окончания” канал 255 отображает состояние и настройки субмодуля EM01, установленного на первое место, канал 256 – второе место. Все имеющиеся конфигурационные ... <и далее продолжается существующий текст пункта.>

Интерфейс E&M тип (канальное окончание EM)
Для создания окончания EM для субмодуля EM01 нужно удалить автоматически созданное окончание RTP в соответствующем субмодулю канале: 255 - первое место(Channel 1) или 256 - второе место(Channel 2), а затем создать новое окончание EM указав в настройке "Канал" этот номер канала.
Настройки окончания EM субмодуля EM01 будут аналогичны описанному в <ссылка на п.7.4.6>, за исключением некоторых особенностей:

• имеются конфигурационные параметры "Номинальный уровень входа" и "Номинальный уровень выхода", устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно;
• отсутствует настройка "ИКМ код".

При использовании канального окончания EM c интерфейсом субмодуля EM01 индикаторы разъема RJ45 отображают состояние канального окончания следующим образом: зеленый индикатор горит при успешной регистрации канального окончания на внешнем сервере, желтый индикатор горит при занятости канального окончания (при любом состоянии, отличном от Idle).

Также в Табл. 5.32 Назначение контактов на разъемах Х20 и Х21 платы VE-02 нужно добавить что EM01 умеет E&M и указать контакты сигнальных линий.

Также где-то в тексте нужно исправить заботливые уточнения к названию субмодуля: EM01 (ТЧ канал), EM01 (канал ТЧ)

alx, проверь пожалуйста, не наврал ли я где-нибудь.

[alx]

Replying to san:

alx, проверь пожалуйста, не наврал ли я где-нибудь.

??? А ты сам разве проверить не можешь?

[san]

Как там Vladimir обычно говорит, про авторов хардаисофта ...? :-)
А если серьёзно, то я про эту часть:

Для создания окончания EM для субмодуля EM01 нужно удалить автоматически созданное окончание RTP в соответствующем субмодулю канале: 255 - первое место(Channel 1) или 256 - второе место(Channel 2), а затем создать новое окончание EM указав в настройке "Канал" этот номер канала.

Она получена эмпирическим путём, а как задумано автором я не знаю. Так и задуманно?

[alx]

Replying to san:

Как там Vladimir обычно говорит, про авторов хардаисофта ...? :-)

"Если ты имеешь ввиду Автора тикета, или, тем более, Автора создания КО, то согласен,
но я имел ввиду Редактора авторского текста, а уровень знаний и опыта по теме разработки КО
у редактора гораздо меньше, чем у Автора КО, поэтому редактор может исказить смысл Автора КО,
т.е. должен быть Авторский надзор за результатом любых изменений оформителем текста" - вот как-то так... :)

А если серьёзно, то я про эту часть:

Для создания окончания EM для субмодуля EM01 нужно удалить автоматически созданное окончание RTP в соответствующем субмодулю канале: 255 - первое место(Channel 1) или 256 - второе место(Channel 2), а затем создать новое окончание EM указав в настройке "Канал" этот номер канала.

Она получена эмпирическим путём,

Что ты имеешь. ввиду? Разве сейчас в РЭ не написано, как создать или удалить канальное окончание платы?

а как задумано автором я не знаю. Так и задуманно?

Да, так и задумано. Создание и удаление канальных окончаний сделано давным-давно, и я не видел причин для канального окончания EM модуля EM01 задумывать как-то по-другому... Как было, так и осталось.

Меня в comment:1 удивило другое. Ты в нем пишешь, что по твоему мнению надо добавить, и при этом половина написанного там в РЭ и так уже есть. Зачем добавлять второй раз? Для "закрепления пройденного материала"? :)

А вот распиновку разъема я указать забыл (упустил этот момент). Добавил в описание.

[san]

Зачем добавлять второй раз

Второй раз не нужно) Моё слово добавить нужно заменить на изменить.

Да, так и задумано. Создание и удаление канальных окончаний сделано давным-давно, и я не видел причин для канального окончания EM модуля EM01 задумывать как-то по-другому... Как было, так и осталось.

Поясню мои сомнения. Создание окончаний для EM01 всё-таки не так всё очевидно пользователю, как может быть тебе(разработчику) кажется. Потому-что для субмодулей всегда создаётся автоматически канальное окончание и ещё нужно догадаться его удалить, чтобы заменить на другое. Как бы это объяснить ... необычная механика, свойственная только EM01. Например если я проделаю тоже самое с R232, удалю окончание и создам там какое-нибудь другое, или оставлю пустым, то после открытия окна платы вновь увижу R232. Поэтому такое действие(удаление и добавление другого) и кажется некорректным по отношению к окончаниям привязанным к модулям, изначально создаётся ощущение, что невозможно удалить такое окончание. А в РЭ никаких уточнений по этому поводу нет. Я, как пользователь, сначала искал какую-то настройку внутри окончания, чтобы переключить RTP на EM и только потом решил попробовать удалить и создать)

[san]

Так же отмечу, что неинтуитивно ещё и то, что настройки номинальных уровней недоступны на этапе создания окончания EM для EM01. Чтобы их изменить, нужно создать окончание EM, а затем вызвать диалог редактирования. А при создании других окончаний доступны все те же настройки, что и при редактировании.
Наверное тоже стоит указать это в РЭ

[san]

Предлагаю изменить текст описывающий настройки "Номинальный уровень входа" и "Номинальный уровень выхода" на:

• имеются конфигурационные параметры "Номинальный уровень входа" и "Номинальный уровень выхода", устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (эти настройки не доступны на этапе создания окончания EM для субмодуля EM01, но будут доступны при редактировании окончания);

[Vladimir]

Replying to san:

Предлагаю изменить текст описывающий настройки "Номинальный уровень входа" и "Номинальный уровень выхода" на:

• имеются конфигурационные параметры "Номинальный уровень входа" и "Номинальный уровень выхода", устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (эти настройки не доступны на этапе создания окончания EM для субмодуля EM01, но будут доступны при редактировании окончания);

Добавил в РЭ-55:
"• имеются конфигурационные параметры Номинальный уровень входа и Номинальный уровень выхода, устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (доступны только в режиме редактирования окончания EM);"

[alx]

Replying to san:

Поясню мои сомнения. Создание окончаний для EM01 всё-таки не так всё очевидно пользователю, как может быть тебе(разработчику) кажется. Потому-что для субмодулей всегда создаётся автоматически канальное окончание

Да, даже если в конфиге нет канального окончания, оно создается автоматически, и об этом уже написано в РЭ. Разве нет?

и ещё нужно догадаться его удалить, чтобы заменить на другое.

В этом нет никакого отличия от любых других много лет существующих канальных окончаний: ты не сможешь добавить канальное окончание, если канал уже занят другим канальным окончанием. И нужно догадаться его удалить, чтобы заменить на другое. По-моему ничего сложного в этом догаывании нет. ~7 лет пользователи успешно об этом догадываются, и никто не жаловался.

Как бы это объяснить ... необычная механика, свойственная только EM01.

Эта механика свойственна любым канальным окончаниям. Только что специально попытался создать канальное окончание FXS, указав канал 17 (где уже есть канальное окончание DS) и получил сообщение об ошибке: "Канал 17 уже существует". За 7 последних лет (включая появление окончания EM и модуля EM01) в этой механике ничего не изменилось.

Например если я проделаю тоже самое с R232, удалю окончание и создам там какое-нибудь другое, или оставлю пустым, то после открытия окна платы вновь увижу R232. Поэтому такое действие(удаление и добавление другого) и кажется некорректным по отношению к окончаниям привязанным к модулям, изначально создаётся ощущение, что невозможно удалить такое окончание.

Неочевиден тот факт, что для модуля EM01 можно создать не один единственный тип канального окончания, а один из двух возможных вариантов? Так ведь это ровно то, что я и написал в описании тикета (перечитай два первых абзаца!) и предложил добавить в РЭ! Как только Vladimir добавит - это станет очевидно.

А в РЭ никаких уточнений по этому поводу нет.

Именно поэтому я и создал этот тикет - чтобы эта новая возможность появилась в РЭ и стала очевидной для пользователей!

Я, как пользователь, сначала искал какую-то настройку внутри окончания, чтобы переключить RTP на EM

Сначала меня это удивило. :) Но потом я догадался, что это ты пытался перенести опыт использования блока VIP на блок 3U. В блоке VIP по-другому нельзя, так как там, в отличие от блока 3U, пользователь вообще не создает сам никаких канальных окончаний, и поэтому там вообще нет соответствующего интерфейса. И лично мне как раз то, как сделано в VIP, кажется неочевидным (не догадаешься без РЭ)...

[alx]

Replying to san:

Так же отмечу, что неинтуитивно ещё и то, что настройки номинальных уровней недоступны на этапе создания окончания EM для EM01.

Это потому, что веб-интерфейс не знает, установлен ли на соответствующем месте платы VE-02 модуль EM01. Если бы веб-интерфейс точно знал, что на этом месте стоит EM01, он мог бы сразу отобразить диалог со всеми дополнительными параметрами...

[san]

Это потому, что веб-интерфейс не знает

Это я понимаю, но пользователю до таких тонкостей далеко)

Добавил в РЭ-55:

• имеются конфигурационные параметры Номинальный уровень входа и Номинальный уровень выхода, устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (доступны только в режиме редактирования окончания EM);

В вашем пересказе упущено именно то на чём я хотел акцентировать внимание, что настройки будут не доступны при создании канала :) Потому что именно это 'удивит' пользователя.
А что такое режим редактирования ?

[alx]

Replying to san:

Это потому, что веб-интерфейс не знает

Хотя я сейчас подумал, что, наверное, знать и не обязательно. Ведь если EM01 нет, то канальное окончание все равно не будет создано. Поэтому для каналов 255 и 256 можно сразу отображать дополнительные настройки...

Это я понимаю, но пользователю до таких тонкостей далеко)

Ему, наверное, такие тонкости знать и не надо. Чтобы пользоваться аппаратурой, достаточно знать, как. А "почему так" - это уже другой вопрос. :)

[Vladimir]

Replying to san:

Это потому, что веб-интерфейс не знает

Это я понимаю, но пользователю до таких тонкостей далеко)

Добавил в РЭ-55:

• имеются конфигурационные параметры Номинальный уровень входа и Номинальный уровень выхода, устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (доступны только в режиме редактирования окончания EM);

В вашем пересказе упущено именно то на чём я хотел акцентировать внимание, что настройки будут не доступны при создании канала :) Потому что именно это 'удивит' пользователя.

Тогда такой вариант:
"• имеются конфигурационные параметры Номинальный уровень входа и Номинальный уровень выхода, устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (данные настройки не доступны при добавлении окончания EM и могут быть настроены только в окне редактирования окончания EM);"

А что такое режим редактирования ?

Это режим работы веб-интерфейса, в котором можно редактировать параметры :-)

[Vladimir]

Replying to alx:

Replying to san:

Поэтому для каналов 255 и 256 можно сразу отображать дополнительные настройки...

Это я понимаю, но пользователю до таких тонкостей далеко)

Ему, наверное, такие тонкости знать и не надо. Чтобы пользоваться аппаратурой, достаточно знать, как. А "почему так" - это уже другой вопрос. :)

А почему бы на вкладке "Добавление канального окончания EM"
(Рис.7.34 в п.7.4.6.1 Подключение к шлюзу канального окончания EM, см.РЭ-54))
сразу нельзя было добавить "параметры Номинальный уровень входа и Номинальный уровень выхода" - зачем заставлять юзера делать много лишних телодвижений? :-)

Исправленный вариант текста:
"• имеются конфигурационные параметры Номинальный уровень входа и Номинальный уровень выхода, устанавливающие номинальный уровень входа и выхода речевого тракта интерфейса соответственно (данные настройки не доступны при добавлении окончания EM на вкладке Параметры канального окончания EM и могут быть настроены только в окне редактирования окончания EM);"

[san]

Milestone deleted