РЭ: добавить описание канального окончания R232 блока MC04-DSL-VIP

[alx]

В блоке MC04-DSL-VIP появилась поддержка модулей R232:

Модуль R232 функционально похож на модуль R422, только вместо интерфейса RS-422 он имеет интерфейс RS-232. При установке в блок этих модулей автоматически создаются канальные окончания R232. Канальное окончание R232 описано ​здесь. Необходимо добавить его описание в РЭ аппаратуры MC04-DSL-VIP.

[Vladimir]

Начал добавлять текст по указанной ссылке, но изменил первый абзац:
"Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232 через сеть IP.
Канальное окончание R232 создаётся модулем R232, установленным в плате VE-02
(блоке MC04-DSL-VIP). Модуль R232 позволяет организовать в плате VE-02 (блоке MC04-DSL-VIP) интерфейс RS-232 (TIA/EIA-232)."
Я предлагаю изменить порядок пунктов в РЭ: на первом месте было сначала R422,
затем R485 со ссылкой на R422 и R232 со ссылкой на R422, но мне кажется логичнее другой порядок: R232, R422, R485 со ссылками на полное описание в R232.
Возражения есть?

Всё ли тут хорошо изложено?
Не требуется ли заменить слово "создаётся", например, на "формируется", "реализуется"?
(по ссылке было "...предназначено для работы с модулем R232...", т.е. в первом и третьем предложениях одного абзаца из ТРЁХ строчек была одинаковая фраза "Канальное окончание R232 предназначено для")

[alx]

Replying to Vladimir:

Я предлагаю изменить порядок пунктов в РЭ: на первом месте было сначала R422,
затем R485 со ссылкой на R422 и R232 со ссылкой на R422, но мне кажется логичнее другой порядок: R232, R422, R485 со ссылками на полное описание в R232.
Возражения есть?

Нет. Мне все равно, в каком порядке будет описано, лишь бы все было описано.

Всё ли тут хорошо изложено?

Где "тут"? ​Тут? Изложил настолько хорошо, насколько смог...

Не требуется ли заменить слово "создаётся", например, на "формируется", "реализуется"?

Нет, ведь эти слова - не синонимы...

(по ссылке было "...предназначено для работы с модулем R232...", т.е. в первом и третьем предложениях одного абзаца из ТРЁХ строчек была одинаковая фраза "Канальное окончание R232 предназначено для")

Согласен с замечанием. Сразу два назначения получилось. :) Переформулировал назначение более коротко.

[Vladimir]

Replying to alx:

Replying to Vladimir:

Всё ли тут хорошо изложено?

Где "тут"?

В подобных ситуациях я всегда спрашиваю про свои слова (в Комм-1 про первый абзац).

Про твои слова я вопросы не задаю - они всегда правильные :-)

Не требуется ли заменить слово "создаётся", например, на "формируется", "реализуется"?

Нет, ведь эти слова - не синонимы...

Но близкие по смыслу, однако, пусть будет "создаётся".

Согласен с замечанием. Сразу два назначения получилось. :) Переформулировал назначение более коротко.

Хорошо, первый абзац запишу так:
"Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232
через сеть IP. Канальное окончание R232 создаётся модулем R232, установленным в плате VE-02 (блоке MC04-DSL-VIP), модуль R232 позволяет организовать в плате VE-02 интерфейс RS-232 (TIA/EIA-232)."
Спасибо за комментарии!

[alx]

Replying to Vladimir:

Хорошо, первый абзац запишу так:
"Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232
через сеть IP. Канальное окончание R232 создаётся модулем R232, установленным в плате VE-02 (блоке MC04-DSL-VIP), модуль R232 позволяет организовать в плате VE-02 интерфейс RS-232 (TIA/EIA-232)."

И еще одно замечание. Ты здесь дважды упоминаешь плату VE-02. Несмотря на то, что плата VE-02 в блоке MC04-DSL-VIP действительно есть, этот блок не является "конструктором", в котором пользователь сам может установить такие платы, какие он захочет (как, например, MC04-DSL-3U). Для пользователя блок MC04-DSL-VIP - единое законченное устройство, и что там у него внутри, пользователь может не знать (и, скорее всего, не знает). Поэтому упоминать названия плат я не вижу смысла. Рекомендую вместо "в плате VE-02" писать "в блоке MC04-DSL-VIP".

[Vladimir]

Replying to alx:

Replying to Vladimir:

через сеть IP. Канальное окончание R232 создаётся модулем R232, установленным в плате VE-02 (блоке MC04-DSL-VIP), модуль R232 позволяет организовать в плате VE-02 интерфейс RS-232 (TIA/EIA-232)."

И еще одно замечание. Ты здесь дважды упоминаешь плату VE-02.

Это как бы и не я упоминаю, а я скопировал и вставил текст про это из твоего Эндпоинта,
полагая, что тебе, как Автору виднее :-)

Несмотря на то, что плата VE-02 в блоке MC04-DSL-VIP действительно есть, этот блок не является "конструктором", в котором пользователь сам может установить такие платы, какие он захочет (как, например, MC04-DSL-3U). Для пользователя блок MC04-DSL-VIP - единое законченное устройство, и что там у него внутри, пользователь может не знать (и, скорее всего, не знает). Поэтому упоминать названия плат я не вижу смысла. Рекомендую вместо "в плате VE-02" писать "в блоке MC04-DSL-VIP".

Хорошее замечание, однако, в ТО и РЭ обычно описывают конструкцию блоков
и тут в РЭ на Рис.1.4 показана явно плата VE-02, но в тексте это скромно умалчивается:
"При этом на плате не должны быть установлены перемычки 12V и 0V (смотри рисунок 1.4).",
кроме того, в п."2.3.8 Вкладка Обновление ПО" и есть фразы:
"В верхней части вкладки расположено меню Обновление платы VE-02"
"В строке Ревизия ve 02: отображается номер текущей версии ПО шлюза."
Эти фразы тоже надо изменить? Но на плате, наверное, есть обозначение VE-02,
тогда зачем скрывать правду в тексте РЭ ? :-)

Аналогичные упоминания есть и в КО R422, R485 - по аналогии и там исключим VE-02 ?

Или лучше записать, например, так: ?

"Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232
через сеть IP. Канальное окончание R232 создаётся модулем R232, установленным в плате блока MC04-DSL-VIP, модуль R232 позволяет организовать в плате блока интерфейс RS-232 (TIA/EIA-232).
"

[alx]

Replying to Vladimir:

Это как бы и не я упоминаю, а я скопировал и вставил текст про это из твоего Эндпоинта,

Но ты же, несомненно, не чисто механически и бездумно его скопировал, а, конечно же, перед этим прочитал, понял, и принял решение о том, что этот текст годится для вставки в РЭ. Таким образом, как ни крути, это было твое решение. :)

полагая, что тебе, как Автору виднее :-)

Я как разработчик платы VE-02 не говорил тебе, что в РЭ блока MV04-DSL-VIP надо упоминать плату VE-02. Наоборот, в comment:4 этого тикета я выразил мысль о том, что эту плату в РЭ упоминать не следует! :)

Хорошее замечание, однако, в ТО и РЭ обычно описывают конструкцию блоков

По-моему это очень необычно, когда в РЭ описывают, что находится в местах, не предназначенных для доступа пользователя. Я, например, никогда не встречал в РЭ телевизоров, микроволновок, стиральных машин упоминания названий находящихся в них плат (хотя они там, конечно же, есть!). Мне кажется, что РЭ должно содержать информацию, необходимую для правильной эксплуатации изделия пользователем/владельцем. Для эксплуатации блока MC04-DSL-VPI не требуется знать, какие платы находятся у него внутри...

и тут в РЭ на Рис.1.4 показана явно плата VE-02, но в тексте это скромно умалчивается:
"При этом на плате не должны быть установлены перемычки 12V и 0V (смотри рисунок 1.4).",

Я не понял, для чего ты привел этот факт. Ты хотел этим доказать, что плата VE-02 в блоке MC04-DSL-VIP есть? Если так, то ты ломишься в открытую дверь. :) Я и не утверждал, что этой платы там нет. Наоборот, в comment:4 я прямо написал, что плата VE-02 там действительно есть - перечитай мой комментарий!

кроме того, в п."2.3.8 Вкладка Обновление ПО" и есть фразы:
"В верхней части вкладки расположено меню Обновление платы VE-02"
"В строке Ревизия ve 02: отображается номер текущей версии ПО шлюза."
Эти фразы тоже надо изменить?

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

Но на плате, наверное, есть обозначение VE-02,
тогда зачем скрывать правду в тексте РЭ ? :-)

Ну это уже совсем грубо! Раз ты так, получи тем же в ответ. В блоке MC04-DSL-VIP есть плата PV-01. И на ней тоже написано ее обозначение "PV-01". Упоминается о ней в РЭ? Поиск строки "PV-01" показывает, что нет. Зачем скрываешь правду? :)

Если же говорить серьезно, я не предлагал скрывать правду. Я предложил убрать лишнюю (ненужную для эксплуатации блока) информацию.

Аналогичные упоминания есть и в КО R422, R485 - по аналогии и там исключим VE-02 ?

Разработчик РЭ - ты. Я не знаю, исключишь ты или нет. Я могу только выразить мнение и предложить улучшение, что я и сделал. Принять мое предложение или нет - решать тебе.

Или лучше записать, например, так: ?

"Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232
через сеть IP. Канальное окончание R232 создаётся модулем R232, установленным в плате блока MC04-DSL-VIP, модуль R232 позволяет организовать в плате блока интерфейс RS-232 (TIA/EIA-232).
"

Да, я считаю, что так будет лучше. А еще лучше и плату R232 тоже не упоминать. Например так:

Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP. Канальные окончания R232 создаются автоматически, если в блоке имеются интерфейсы RS-232.

Или даже еще короче:

Канальные окончания R232 предназначены для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP (при наличии таких интерфейсов в блоке).

[Vladimir]

Replying to alx:

Replying to Vladimir:
Но ты же, несомненно, не чисто механически и бездумно его скопировал, а, конечно же, перед этим прочитал, понял, и принял решение о том, что этот текст годится для вставки в РЭ. Таким образом, как ни крути, это было твое решение. :)

Я же понимаю, что у тебя более глубокие знания в этих вопросах,
а я, как ты сам отмечал, часто ошибаюсь и пишу неправду,
поэтому я тебе тут больше доверяю, чем себе :-)

Я как разработчик платы VE-02 не говорил тебе, что в РЭ блока MV04-DSL-VIP надо упоминать плату VE-02.

Основной текст был написан кем-то из Разработчиков хардософта до моего пришествия
и там уже было упоминание плат и модулей.

Наоборот, в comment:4 этого тикета я выразил мысль о том, что эту плату в РЭ упоминать не следует! :)

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

По-моему это очень необычно, когда в РЭ описывают, что находится в местах, не предназначенных для доступа пользователя.

А как же перемычки - к ним и к модулям надо иметь доступ, чтобы правильно поставить и иногда, возможно, изменить?

Для эксплуатации блока MC04-DSL-VPI не требуется знать, какие платы находятся у него внутри...

Знать требуется, т.к. иногда можно докупить новый модуль и поставить его на свободное место или заменить существующий.
Внутри же есть некая плата, показанная на Рис.1.4, а на плате показаны "Модуль 1 и Модуль-2"
и показано, что тип этих модулей может быть разным: вот заметил, что там только 4 типа модулей,
да ещё эти места неравноценны: на месте модуля-2 можно установить не все КО
Кстати, Рис.1.4 надо исправлять: добавить новые типы модулей (R232, R485) -
их тоже можно ставить только на место-1 ?
Уточни - где и какие модули могут быть?

и тут в РЭ на Рис.1.4 показана явно плата VE-02, но в тексте это скромно умалчивается:
"При этом на плате не должны быть установлены перемычки 12V и 0V (смотри рисунок 1.4).",

Я не понял, для чего ты привел этот факт.

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

кроме того, в п."2.3.8 Вкладка Обновление ПО" и есть фразы:
"В верхней части вкладки расположено меню Обновление платы VE-02"
"В строке Ревизия ve 02: отображается номер текущей версии ПО шлюза."
Эти фразы тоже надо изменить?

Первую из упомянутых - да, надо изменить. Спасибо что обратил на это мое внимание. Фразу изменил на "Обновление ПО блока".

Тогда пришли скрин про Обновление ПО без упоминания на скрине VE-02 для замены рисунка

По поводу второй приведенной тобой фразы - не вижу необходимости ее менять, там говорится о ПО шлюза, никакое платы в ней не упоминаются...

Но буквы ve-02 есть :-)

Если же говорить серьезно, я не предлагал скрывать правду. Я предложил убрать лишнюю (ненужную для эксплуатации блока) информацию.

Авторское слово имеет приоритет: я уже убрал названия VE-02,
теперь это просто некая безымянная плата, хотя я бы на стал скрывать,
т.к. на этой плате надо ставить перемычки и модули...

Аналогичные упоминания есть и в КО R422, R485 - по аналогии и там исключим VE-02 ?

Разработчик РЭ - ты. Я не знаю, исключишь ты или нет. Я могу только выразить мнение и предложить улучшение, что я и сделал.

Формально ты предложил только для R232, а мнение про остальные не сказал,
но я догадался и удалил VE-02 из описаний 422 и 485.

Или лучше записать, например, так: ?

"Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232
через сеть IP. Канальное окончание R232 создаётся модулем R232, установленным в плате блока MC04-DSL-VIP, модуль R232 позволяет организовать в плате блока интерфейс RS-232 (TIA/EIA-232).
"

Да, я считаю, что так будет лучше. А еще лучше и плату R232 тоже не упоминать. Например так:

Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP. Канальные окончания R232 создаются автоматически, если в блоке имеются интерфейсы RS-232.

Или даже еще короче:

Канальные окончания R232 предназначены для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP (при наличии таких интерфейсов в блоке).

Но есть же Рис.1.4, где показаны названия модулей и под рисунком есть важный текст:
"Модуль R422 может быть установлен только в слот Модуля1 (Channel 1)",
который теперь, если скажешь, надо изменить:
"Модули R232, R422, R485 могут быть установлены только в слот Модуля1 (Channel 1)"
Изменить этот текст?
А для R422, R485 вместо (TIA/EIA-232) что записать - только цифры поменять,
или буквы будут другие?

И как бы ты изменил текст для R422, R485 в первом абзаце пунктов настройки:
"Модуль R485 функционально соответствует модулю R232, только вместо интерфейса
RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"
с учётом твоих сокращений в конце Коммента-6 ?

Или ничего менять не надо?

[alx]

Replying to Vladimir:

Я как разработчик платы VE-02 не говорил тебе, что в РЭ блока MV04-DSL-VIP надо упоминать плату VE-02.

Основной текст был написан кем-то из Разработчиков хардософта до моего пришествия
и там уже было упоминание плат и модулей.

Не думаю, что я когда-либо говорил кому-либо из разработчиков хардософта, что в РЭ блока MC04-DSL-VIP надо упоминать плату VE-02.

А как же перемычки - к ним и к модулям надо иметь доступ, чтобы правильно поставить и иногда, возможно, изменить?

К каким перемычкам и каким модулям?

Блок собирается на АДС и закрывается со всех сторон крышками. К этому моменту все нужные перемычки должны уже стоять. Все элементы, к которым необходим доступ персонала в процессе эксплуатации, выведены на лицевую или заднюю панели блока. По-моему так. Например для того чтобы подать питание на блок, не надо знать, что разъем питания находится на плате PV-01. Достаточно найти соответствующее обозначение на лицевой панели. Точно так же и для подключения телефонной линии к интерфейсу FXS не требуется знать, что соответствующий разъем находится на плате VE-02. Достаточно следовать обозначениям на морде блока.

Для эксплуатации блока MC04-DSL-VIP не требуется знать, какие платы находятся у него внутри...

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

Нет, нельзя. Разве процедура такой установки или замены описана в РЭ? Мне лень специально искать, но по-моему нет. Следовательно, нельзя - как пользователь узнает, как это сделать, если это не описано в РЭ? :)

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

Внутри же есть некая плата, показанная на Рис.1.4, а на плате показаны "Модуль 1 и Модуль-2"

Ну и зря. Я считаю, что это - лишняя для пользователей информация. Для эксплуатации блока этого знать не требуется.

Кстати, Рис.1.4 надо исправлять: добавить новые типы модулей (R232, R485) -
их тоже можно ставить только на место-1 ?

Нет, на любое место.

Уточни - где и какие модули могут быть?

Любые поддерживаемые модули можно устанавливать на любые места.

Я не понял, для чего ты привел этот факт.

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

В таком случае, в твоем рассуждении я не вижу логики. Каким образом из того факта, что в РЭ изображена плата VE-02, следует вывод о том, что пользователю в процессе эксплуатации нужен к ней доступ? По-моему никаким. Все модули и перемычки уже должны быть установлены правильным образом в момент отгрузки блока с предприятия-изготовителя. Если какая-то плата вышла из строя, владелец должен отправить в ремонт весь блок, а не разбирать его самостоятельно. Добавление модулей также должно производиться квалифицированным персоналом на предприятии-изготовителе.

Первую из упомянутых - да, надо изменить. Спасибо что обратил на это мое внимание. Фразу изменил на "Обновление ПО блока".

Тогда пришли скрин про Обновление ПО без упоминания на скрине VE-02 для замены рисунка

Пожалуйста:

По поводу второй приведенной тобой фразы - не вижу необходимости ее менять, там говорится о ПО шлюза, никакое платы в ней не упоминаются...

Но буквы ve-02 есть :-)

Да, есть. И еще много других букв там тоже есть. И что? :)

Авторское слово имеет приоритет: я уже убрал названия VE-02,
теперь это просто некая безымянная плата, хотя я бы на стал скрывать,
т.к. на этой плате надо ставить перемычки и модули...

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

Формально ты предложил только для R232, а мнение про остальные не сказал,

Формально ты мне в comment:3 написал только про R232, вот я в ответ и дал замечание по нему.

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

...

Изменить этот текст?

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

А для R422, R485 вместо (TIA/EIA-232) что записать - только цифры поменять,
или буквы будут другие?

Не понял вопрос... Интерфейс TIA/EIA-232 не имеет к платам R422 и R485 никакого отношения.

И как бы ты изменил текст для R422, R485 в первом абзаце пунктов настройки:

Что такое "пункты настройки"?

"Модуль R485 функционально соответствует модулю R232, только вместо интерфейса
RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"

??? Ничего не понимаю... Ты процитировал мои слова из описания тикета. У тебя по этому поводу есть какой-то вопрос?

с учётом твоих сокращений в конце Коммента-6 ?

Что "с учетом моих сокращений в конце Коммента-6"? Не мог бы ты изъясняться чуть-чуть яснее? У тебя есть какие-то вопросы по поводу написанного мной в comment:6? Если да, задавай.

Или ничего менять не надо?

Что по моему мнению надо менять изложено в (пока еще) не закрытых тикетах trac.

[Vladimir]

Replying to alx:

Replying to Vladimir:

Я как разработчик платы VE-02 не говорил тебе, что в РЭ блока MV04-DSL-VIP надо упоминать плату VE-02.

Основной текст был написан кем-то из Разработчиков хардософта до моего пришествия
и там уже было упоминание плат и модулей.

Не думаю, что я когда-либо говорил кому-либо из разработчиков хардософта, что в РЭ блока MC04-DSL-VIP надо упоминать плату VE-02.

Первые версии РЭ на DSL-VIP были созданы в 2016г и упоминание платы VE-02 там уже было,
а я тогда не касался никаких РЭ,
Впервые редактировать РЭ на MC04-DSL-3U меня уговорили в 2018г после версии РЭ-28.

Блок собирается на АДС и закрывается со всех сторон крышками. К этому моменту все нужные перемычки должны уже стоять.

В течение 10...20 лет эксплуатации может возникнуть необходимость добавить/заменить модуль или поменять перемычки - обычно в РЭ это указывают и в РЭ на DSL-VIP это тоже было указано,
начиная, как минимум, "с ред. 2 / март 2016" и присутствует во всех последующих версиях.
(версии 1 в моём ПК нет).

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

Нет, нельзя. Разве процедура такой установки или замены описана в РЭ? Мне лень специально искать, но по-моему нет. Следовательно, нельзя - как пользователь узнает, как это сделать, если это не описано в РЭ? :)

У нас народ догадливый, а модули на разъёмных соединениях :-)
Кроме того, перемычки зависят от типа имеющегося на эксплуатации устройства сигнализации,
которое тоже за 10 лет может поменяться, ну и предусмотрено питание внешнего устройства -
всё это прописано в РЭ под Рис.1.4 некой платы без названия.

В отличие от блока MC04-DSL-3U, в блоке MC04-DSL-VIP установка платы - не такая простая процедура.

Замена платы VE-02 - это ремонт, а добавление/замену модуля можно сделать без отправки всего блока на завод и тем более перемычки можно переставить на месте эксплуатации.

Внутри же есть некая плата, показанная на Рис.1.4, а на плате показаны "Модуль 1 и Модуль-2"

Ну и зря. Я считаю, что это - лишняя для пользователей информация. Для эксплуатации блока этого знать не требуется.

Если удалить Рис.1.4 и текст про перемычки, то для выполнения простой работы в течение часа, надо обрывать связь на неопределённо длительное время - кому это понравится :-)
Ты всё-таки рекомендуешь удалить эту информацию?

Любые поддерживаемые модули можно устанавливать на любые места.

Тогда Рис.1.4 надо изменить, или удалить - как ты думаешь про это?

Все модули и перемычки уже должны быть установлены правильным образом в момент отгрузки блока с предприятия-изготовителя. Если какая-то плата вышла из строя, владелец должен отправить в ремонт весь блок, а не разбирать его самостоятельно. Добавление модулей также должно производиться квалифицированным персоналом на предприятии-изготовителе.

И даже при исправном блоке, но при необходимости изменить тип устройства сигнализации
надо отправлять блок на завод даже только для изменения положения перемычек? :-)
Быть без связи неопределённо длительное время никому не понравиться!

Тогда пришли скрин про Обновление ПО без упоминания на скрине VE-02 для замены рисунка

Пожалуйста:

Этот скрин для замены Рис.2.15 ? (см. РЭ-10 на сайте)
Рис.2.15 содержит гораздо больше информации и выше в 3 раза, чем новый.
Или новый скрин достаточен для РЭ ?

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

...

Изменить этот текст?

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

На веб-интерфейсе нет положения перемычек для сигнализации,
кроме того, заказчикам и проектировщикам тоже надо знать заранее что можно, а чего нельзя...

А для R422, R485 вместо (TIA/EIA-232) что записать - только цифры поменять,
или буквы будут другие?

Не понял вопрос... Интерфейс TIA/EIA-232 не имеет к платам R422 и R485 никакого отношения.

Если для RS-232 в РЭ записано так:
"...модуль R232 позволяет организовать в плате интерфейс RS-232 (TIA/EIA-232).",
то я подумал, что и для R422, R485 надо что-то подобное добавить?

И как бы ты изменил текст для R422, R485 в первом абзаце пунктов настройки:

Что такое "пункты настройки"?

Это пункты РЭ, в названии которых первое слово "Настройка..."

"Модуль R485 функционально соответствует модулю R232, только вместо интерфейса
RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"

??? Ничего не понимаю... Ты процитировал мои слова из описания тикета. У тебя по этому поводу есть какой-то вопрос?

с учётом твоих сокращений в конце Коммента-6 ?

Что "с учетом моих сокращений в конце Коммента-6"? Не мог бы ты изъясняться чуть-чуть яснее? У тебя есть какие-то вопросы по поводу написанного мной в comment:6? Если да, задавай.

Или ничего менять не надо?

Что по моему мнению надо менять изложено в (пока еще) не закрытых тикетах trac.

Однако, в конце Коммента-6 ты предложил другую формулировку данного абзаца из тикета:
"Или даже еще короче:
Канальные окончания R232 предназначены для передачи данных интерфейсов
RS-232 (TIA/EIA-232) через сеть IP (при наличии таких интерфейсов в блоке)."

Вот и возник вопрос: ты рекомендуешь именно такую формулировку, а не ту, которая в Тикете?
И надо ли что-то подобное указывать в скобках для R422 и R485?

[Vladimir]

Replying to alx:

Replying to Vladimir:

Первую из упомянутых - да, надо изменить. Спасибо что обратил на это мое внимание. Фразу изменил на "Обновление ПО блока".

Я обратил внимание, что слово "шлюз" применительно к блоку MC04-DSL-VIP в РЭ-10
встречается 129 раз, но ты почему-то на вкладке "Обновление ПО" записал текст
"Обновление ПО блока", а не шлюза. Это не существенно, но всё же неоднообразно :-)

По поводу второй приведенной тобой фразы - не вижу необходимости ее менять, там говорится о

ПО шлюза, никакое платы в ней не упоминаются...

И тут у тебя шлюза, а не "блока".

Рисунок обновления ПО я уже вставил, но т.к. на рисунке записано "Обновление ПО блока",
то я и в тексте этого пункта слова шлюза заменил на слова "блока".
Так и оставить?

[alx]

Replying to Vladimir:

Первые версии РЭ на DSL-VIP были созданы в 2016г и упоминание платы VE-02 там уже было,
а я тогда не касался никаких РЭ,
Впервые редактировать РЭ на MC04-DSL-3U меня уговорили в 2018г после версии РЭ-28.

Не думаю, что я когда-либо говорил кому-либо, что в РЭ блока MC04-DSL-VIP надо упоминать плату VE-02.

В течение 10...20 лет эксплуатации может возникнуть необходимость добавить/заменить модуль или поменять перемычки - обычно в РЭ это указывают и в РЭ на DSL-VIP это тоже было указано,
начиная, как минимум, "с ред. 2 / март 2016" и присутствует во всех последующих версиях.

Да, может. И что? Я не понял, к чему это было сказано. Безусловно, случиться может все что угодно. Например блок может сгореть в первую минуту эксплуатации. Какой из этого следует вывод?

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

Нет, нельзя. Разве процедура такой установки или замены описана в РЭ? Мне лень специально искать, но по-моему нет. Следовательно, нельзя - как пользователь узнает, как это сделать, если это не описано в РЭ? :)

У нас народ догадливый, а модули на разъёмных соединениях :-)

Ну раз догадливый, то и рисунок 1.4 в РЭ ему не нужен - сам догадается! :)

Кроме того, перемычки зависят от типа имеющегося на эксплуатации устройства сигнализации,
которое тоже за 10 лет может поменяться, ну и предусмотрено питание внешнего устройства -
всё это прописано в РЭ под Рис.1.4 некой платы без названия.

Ну и плохо. Я считаю, что это неправильно.

Замена платы VE-02 - это ремонт, а добавление/замену модуля можно сделать без отправки всего блока на завод и тем более перемычки можно переставить на месте эксплуатации.

Насчет перемычек я еще могу согласиться. Установка перемычек никаких особенных знаний/умений/квалификации не требует. Но установка/замена плат - требует. Однако, так как перестановка перемычек требует вскрытия корпуса аппаратуры, это уже не эксплуатация, а модификация. И, следовательно, в руководстве по эксплуатации это описывать не надо.

Если удалить Рис.1.4 и текст про перемычки, то для выполнения простой работы в течение часа, надо обрывать связь на неопределённо длительное время - кому это понравится :-)

Ты имеешь в виду отправку блока изготовителю и ожидание возврата? Я уверен, что из этой ситуации есть масса вариантов выхода. Например можно заранее получить другой блок, быстро выполнить замену на месте, а потом старый блок вернуть изготовителю...

Также в линейке продукции нашей компании есть блок MC04-DSL-3U - в нем пользователь может заменить плату VE-02 (но, наверное, не установленные на ней модули!), не отправляя блок на предприятие-изготовитель, и даже не отключая питания блока!

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

Ты всё-таки рекомендуешь удалить эту информацию?

Мои рекомендации изложены в комментариях. Я считаю, что внутреннее содержимое блока (то, что внутри корпуса) не предназначено для доступа пользователей. Следовательно, нет необходимости описывать это содержимое в РЭ.

Любые поддерживаемые модули можно устанавливать на любые места.

Тогда Рис.1.4 надо изменить, или удалить - как ты думаешь про это?

Я уже неоднократно писал, что я думаю о рисунке 1.4. Он не нужен.

И даже при исправном блоке, но при необходимости изменить тип устройства сигнализации
надо отправлять блок на завод даже только для изменения положения перемычек? :-)

Да, все верно. Пользователь не должен самостоятельно вскрывать блок. Все, что связано с вскрытием - это уже не эксплуатация - это ремонт/модернизация. Владелец, безусловно, имеет право вскрыть блок и делать с ним все что угодно еще, хоть печку им топить, так как блок - это его собственность. Но мы не обязаны описывать в РЭ, как вскрывать блок и заменять платы, так как эти процессы выходят за рамки эксплуатации изделия.

Лично мне задание варианта внутренними перевычками вообще не нравится. Было бы удобнее, например, вывести питание на отдельные контакты разъема. В качестве собственного оправдания могу лишь сказать, что это было не мое решение. Директор поставил задачу сделать все так, как на плате PE-04.

Быть без связи неопределённо длительное время никому не понравиться!

Совсем не обязательно быть без связи неопределённо длительное время - см. выше.

Тогда пришли скрин про Обновление ПО без упоминания на скрине VE-02 для замены рисунка

Пожалуйста:

Этот скрин для замены Рис.2.15 ? (см. РЭ-10 на сайте)

Я не знаю. Ты попросил прислать тебе скриншот, я прислал. Ты не уточнил, для чего он тебе нужен. :)

Или новый скрин достаточен для РЭ ?

Не могу ответить на этот вопрос, так как не знаю, что именно ты предполагаешь иллюстрировать этим скриншотом. Уточни, пожалуйста.

На веб-интерфейсе нет положения перемычек для сигнализации,

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

Наконец, выяснить наличие или отсутствие перемычек легко можно тестером/вольтметром. Ты же сам выше писал, что народ у нас догадливый - вот и догадается, как проверить наличие на разъеме 12 В... :)

кроме того, заказчикам и проектировщикам тоже надо знать заранее что можно, а чего нельзя...

А каким образом рисунок 1.4 отвечает на вопрос, "что можно, а чего нельзя"? :)

Если для RS-232 в РЭ записано так:
"...модуль R232 позволяет организовать в плате интерфейс RS-232 (TIA/EIA-232).",
то я подумал, что и для R422, R485 надо что-то подобное добавить?

Хм... Ты спрашиваешь меня, подумал ли ты, что и для R422, R485 надо что-то подобное добавить? :) Я не знаю. :) Или знак вопроса в конце предложения поставлен по ошибке?

И как бы ты изменил текст для R422, R485 в первом абзаце пунктов настройки:

Что такое "пункты настройки"?

Это пункты РЭ, в названии которых первое слово "Настройка..."

Спасибо за уточнение. Теперь я понял, что ты спрашиваешь о первом абзаце пункта 2.3.4.4. Я бы его записал так:

Канальные окончания R422 предназначены для передачи данных интерфейсов RS-422 (TIA/EIA-422) через сеть IP (при наличии таких интерфейсов в блоке).

О R485 ни в одном из первых абзацев пунктов РЭ, в названии которых первое слово "Настройка...", не говорится.

Однако, в конце Коммента-6 ты предложил другую формулировку данного абзаца из тикета:
"Или даже еще короче:
Канальные окончания R232 предназначены для передачи данных интерфейсов
RS-232 (TIA/EIA-232) через сеть IP (при наличии таких интерфейсов в блоке)."
Вот и возник вопрос: ты рекомендуешь именно такую формулировку, а не ту, которая в Тикете?

Нет, я не рекомендую именно такую формулировку. В comment:6 написано:

А еще лучше и плату R232 тоже не упоминать. Например так:

Из этого текста следует, что моя рекомендация заключается в том, чтобы не упоминать плату R232. А приведенные далее формулировки - это только примеры.

И надо ли что-то подобное указывать в скобках для R422 и R485?

Указывать для чего и где? И подобное чему? Уточни, пожалуйста.

[alx]

Replying to Vladimir:

Рисунок обновления ПО я уже вставил, но т.к. на рисунке записано "Обновление ПО блока",
то я и в тексте этого пункта слова шлюза заменил на слова "блока".
Так и оставить?

??? А какие еще есть варианты?

Ты в каком-то пункте (который ты не называешь) исправил слово "шлюза" на слово "блока". Одно из 129. И спрашиваешь меня, оставить ли так, не давая никаких альтернативных вариантов! :) При отсутствии контекста я не могу ответить на этот вопрос. Разработчик РЭ - ты. Пиши так, как считаешь хорошо и правильно.

[Vladimir]

Replying to alx:

Replying to Vladimir:

Рисунок обновления ПО я уже вставил, но т.к. на рисунке записано

"Обновление ПО блока",

то я и в тексте этого пункта слова шлюза заменил на слова "блока".
Так и оставить?

??? А какие еще есть варианты?

Вариантов 2:

1. Везде пишем про MC04-DSL-VIP, что это "шлюз", но тогда тебе надо на вкладке

"Обновление ПО" напечатать заголовок не "Обновление ПО блока",
а "Обновление ПО шлюза" и выслать мне скрин с новым заголовком: "Обновление ПО шлюза".

2. Везде пишем, что MC04-DSL-VIP это "блок", но тогда мне надо будет в РЭ исправить

129 слов "шлюз" на слово "блок" - и будет полное однообразие:
одно и то же изделие будет называться одинаково: либо блок, либо шлюз :-)

Первый пункт без тебя я не смогу выполнить.

Ты в каком-то пункте (который ты не называешь) исправил слово "шлюза" на слово "блока". Одно из 129. И спрашиваешь меня, оставить ли так, не давая никаких альтернативных вариантов! :) При отсутствии контекста я не могу ответить на этот вопрос.

Контекст простой: речь идёт про вкладку "Обновление ПО" и описание Этой вкладки,
т.е. это "2.3.8 Вкладка Обновление ПО" и, если на обновлённой вкладке есть заголовок
"Обновление ПО блока" (имеется ввиду, конечно, MC04-DSL-VIP),
то и в тексте описания Этой вкладки я записал это словом "ПО блока", а не шлюза
и далее в этом пункте используется слово "блок", а не шлюз, например, первая строка:
"Вкладка Обновление ПО предназначена для обновления программного обеспечения (ПО) блока...",
хотя ранее по тексту РЭ MC04-DSL-VIP 129 раз называют шлюзом.

Разработчик РЭ - ты. Пиши так, как считаешь хорошо и правильно.

Я бы, как и ты 129 раз назвал MC04-DSL-VIP шлюзом, и в пункте
"2.3.8 Вкладка Обновление ПО" тоже назвал бы шлюзом,
но исправить скрин я не могу, а если ты исправишь, то везде будет "шлюз".

[alx]

Replying to Vladimir:

??? А какие еще есть варианты?

Вариантов 2:

1. Везде пишем про MC04-DSL-VIP, что это "шлюз", но тогда тебе надо на вкладке

"Обновление ПО" напечатать заголовок не "Обновление ПО блока",
а "Обновление ПО шлюза" и выслать мне скрин с новым заголовком: "Обновление ПО шлюза".

Здесь ты ошибаешься. Мне это не надо. :)

2. Везде пишем, что MC04-DSL-VIP это "блок", но тогда мне надо будет в РЭ исправить

129 слов "шлюз" на слово "блок" - и будет полное однообразие:
одно и то же изделие будет называться одинаково: либо блок, либо шлюз :-)

Первый пункт без тебя я не смогу выполнить.

Оставляю выбор варианта на твое усмотрение.

[Vladimir]

Replying to alx:

Replying to Vladimir:

??? А какие еще есть варианты?

Вариантов 2:

1. Везде пишем про MC04-DSL-VIP, что это "шлюз", но тогда тебе надо на вкладке

"Обновление ПО" напечатать заголовок не "Обновление ПО блока",
а "Обновление ПО шлюза" и выслать мне скрин с новым заголовком: "Обновление ПО шлюза".

Здесь ты ошибаешься. Мне это не надо. :)

Тогда оставляю всё, как есть: т.е. везде будет "шлюз",
а для обновления ПО это будет "блок".
Если кто-то будет против, то напишет новый тикет :-)

[Vladimir]

Replying to alx:

Replying to Vladimir:

В течение 10...20 лет эксплуатации может возникнуть необходимость добавить/заменить модуль или поменять перемычки - обычно в РЭ это указывают и в РЭ на DSL-VIP это тоже было указано,

начиная, как минимум, "с ред. 2 / март 2016" и присутствует во всех последующих версиях.

Да, может. И что? Я не понял, к чему это было сказано.

К тому, что может потребоваться открыть исправный блок и поменять перемычки.

Безусловно, случиться может все что угодно. Например блок может сгореть в первую минуту эксплуатации.

Это форс-мажор, а я имел ввиду совершенно исправный блок, который не надо ремонтировать...

Раньше было отдельно ТО и отдельно ИЭ, теперь ТО + ИЭ = РЭ,
т.е. описание блока по ЕСКД должно быть, включая рисунки.
САН тоже склоняется оставить Рис.1.4, т.к. на стр.8 РЭ-10 есть 3 текста для которых нужен этот рисунок (хотя бы для наглядности, для поиска перемычек и прочтения текста на рисунке):

"Если устройство сигнализации имеет собственный источник питания, то оно подключается
к контактам 1, 3 разъёма S. При этом на плате не должны быть установлены перемычки 12V и 0V
(смотри рисунок 1.4)."
"Если устройство сигнализации не имеет собственного источника питания, то оно
подключается к контактам 3, 4 разъема S. При этом на плате должны быть установлены
перемычки 12V и 0V."
"Также через разъем S можно запитать внешнее устройство внутренним напряжением блока
+12V. При этом на плате должны быть установлены перемычки 12V и 0V."

Поэтому Рис.1.4 с согласия САН я оставлю в РЭ.

Или новый скрин ("Обновление ПО") достаточен для РЭ ?

Не могу ответить на этот вопрос, так как не знаю, что именно ты предполагаешь иллюстрировать этим скриншотом. Уточни, пожалуйста.

В РЭ-10 на сайте есть текст:
"2.3.8 Вкладка Обновление ПО
Вкладка Обновление ПО предназначена для обновления программного обеспечения (ПО) шлюза с сервера обновлений. Вкладка приведена на рисунке 2.15."

и я вижу, что этот рисунок в 4 раза больше по количеству строк,
чем тот, который на твоём новом скрине, но я не разрабатывал этот шлюз
и никогда не настраивал его, и никогда не обновлял ПО,
поэтому я не могу точно сказать, каким именно должен быть этот
рисунок, чтобы юзеры смогли без лишних вопросов к тебе или к САН сами обновить ПО.
Если ты, как автор хардософта считаешь, что новый, укороченный скрин достаточен для обновления ПО, то я его уже вставил в РЭ, а если ты так не считаешь, то пришли новый скрин.
(сравни Рис.2.15 в РЭ-10 на сайте и свой новый скрин в Комм.8).

На веб-интерфейсе нет положения перемычек для сигнализации,

Тогда, вероятно, это есть в каких-то документах. Возможно, на каких-то приклеенных к блоку этикетках...

Я думаю, что это только в РЭ и тем более пояснительный текст о назначении этих перемычек.
Начальник производства (Олег) уверенно сказал, что никаких этикеток и наклеек про перемычки
нет и никогда не было.

Наконец, выяснить наличие или отсутствие перемычек легко можно тестером/вольтметром. Ты же сам выше писал, что народ у нас догадливый - вот и догадается, как проверить наличие на разъеме 12 В... :)

Зачем такие мучения для эксплуатации: всё должно быть в РЭ!

кроме того, заказчикам и проектировщикам тоже надо знать заранее что можно, а чего нельзя...

А каким образом рисунок 1.4 отвечает на вопрос, "что можно, а чего нельзя"? :)

К этому рисунку есть подробное описание в РЭ.

Если для RS-232 в РЭ записано так:
"...модуль R232 позволяет организовать в плате интерфейс RS-232 (TIA/EIA-232).",
то я подумал, что и для R422, R485 надо что-то подобное добавить?

Хм... Ты спрашиваешь меня, подумал ли ты, что и для R422, R485 надо что-то подобное добавить? :) Я не знаю. :)

Канальные окончания R422 предназначены для передачи данных интерфейсов RS-422 (TIA/EIA-422) через сеть IP (при наличии таких интерфейсов в блоке).

Ну вот, всё-таки надо добавить уточнение "(TIA/EIA-422)" - об этом я и спрашивал.

О R485 ни в одном из первых абзацев пунктов РЭ, в названии которых первое слово "Настройка...", не говорится.

R485 появился только в редактируемой сей момент версии РЭ-11 и на данный момент
там такой текст:
"2.3.4.6 Настройка канального окончания R485

Модуль R485 функционально соответствует модулю R232, только вместо интерфейса

RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"
А тут надо добавить ""(TIA/EIA-485)"" ?
Такой текст одобряешь?

В п.2.3.4.4 теперь подробное описание R232.

Однако, в конце Коммента-6 ты предложил другую формулировку данного абзаца из тикета:
"Или даже еще короче:
Канальные окончания R232 предназначены для передачи данных интерфейсов
RS-232 (TIA/EIA-232) через сеть IP (при наличии таких интерфейсов в блоке)."
Вот и возник вопрос: ты рекомендуешь именно такую формулировку, а не ту, которая в Тикете?

Нет, я не рекомендую именно такую формулировку. В comment:6 написано:

А еще лучше и плату R232 тоже не упоминать. Например так:

Из этого текста следует, что моя рекомендация заключается в том, чтобы не упоминать плату R232. А приведенные далее формулировки - это только примеры.

И надо ли что-то подобное указывать в скобках для R422 и R485?

Указывать для чего и где? И подобное чему? Уточни, пожалуйста.

В скобках было "(TIA/EIA-232)", выше ты добавил "(TIA/EIA-422)",
надо ли добавлять для R485 про "(TIA/EIA-485)" я пока не знаю.

[alx]

Replying to Vladimir:

В течение 10...20 лет эксплуатации может возникнуть необходимость добавить/заменить модуль или поменять перемычки - обычно в РЭ это указывают и в РЭ на DSL-VIP это тоже было указано,

начиная, как минимум, "с ред. 2 / март 2016" и присутствует во всех последующих версиях.

Да, может. И что? Я не понял, к чему это было сказано.

К тому, что может потребоваться открыть исправный блок и поменять перемычки.

И что? Какое отношение этот факт имеет к обсуждаемой теме?

Безусловно, случиться может все что угодно. Например блок может сгореть в первую минуту эксплуатации.

Это форс-мажор, а я имел ввиду совершенно исправный блок, который не надо ремонтировать...

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

Или новый скрин ("Обновление ПО") достаточен для РЭ ?

Не могу ответить на этот вопрос, так как не знаю, что именно ты предполагаешь иллюстрировать этим скриншотом. Уточни, пожалуйста.

В РЭ-10 на сайте есть текст:
"2.3.8 Вкладка Обновление ПО
Вкладка Обновление ПО предназначена для обновления программного обеспечения (ПО) шлюза с сервера обновлений. Вкладка приведена на рисунке 2.15."

Спасибо за уточнение. Насколько я вижу, в приведенном тобой тексте говорится о вкладке "Обновление ПО". На сделанном мной скриншоте изображена именно эта вкладка веб-интерфейса. Думаю, что новый скриншот достаточен для иллюстрации приведенного тобой текста.

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

А при чем тут разработка шлюза? В шлюзе нет рисунка 2.15. Такой рисунок есть в РЭ. Разработчик РЭ - ты. Я не знаю, каким по твоей задумке должен быть этот рисунок. Ты попросил меня сделать скриншот, при этом не уточнил, каким он должен быть. Отсутствие уточнений я понял так, что подойдет любой скриншот. Скриншот я сделал и прикрепил к этому тикету.

Если ты, как автор хардософта считаешь, что новый, укороченный скрин достаточен для обновления ПО,

Для обновления ПО никакой скриншот не нужен.

то я его уже вставил в РЭ, а если ты так не считаешь, то пришли новый скрин.

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

(сравни Рис.2.15 в РЭ-10 на сайте и свой новый скрин в Комм.8).

Сравнил.

Тогда, вероятно, это есть в каких-то документах. Возможно, на каких-то приклеенных к блоку этикетках...

Я думаю, что это только в РЭ и тем более пояснительный текст о назначении этих перемычек.
Начальник производства (Олег) уверенно сказал, что никаких этикеток и наклеек про перемычки
нет и никогда не было.

Очень плохо.

Наконец, выяснить наличие или отсутствие перемычек легко можно тестером/вольтметром. Ты же сам выше писал, что народ у нас догадливый - вот и догадается, как проверить наличие на разъеме 12 В... :)

Зачем такие мучения для эксплуатации:
всё должно быть в РЭ!

То есть снимать блок со своего места (с перерывом связи!), вскрывать его корпус и искать там джамперы, потом завинчивать корпус обратно и устанавливать блок обратно в стойку - это не мученье. А ткнуть вольтметром в два контакта разъема на морде блока - мученье? =8-() У нас с тобой диаметрально различающиеся представления об удобстве... :)

кроме того, заказчикам и проектировщикам тоже надо знать заранее что можно, а чего нельзя...

А каким образом рисунок 1.4 отвечает на вопрос, "что можно, а чего нельзя"? :)

К этому рисунку есть подробное описание в РЭ.

То есть никаким образом не отвечает. Я так и думал. :)

Хм... Ты спрашиваешь меня, подумал ли ты, что и для R422, R485 надо что-то подобное добавить? :) Я не знаю. :)

Ну вот, всё-таки надо добавить уточнение "(TIA/EIA-422)" - об этом я и спрашивал.

Спасибо за уточнение. Теперь понятно, о чем ты спрашивал. Я не знаю, надо ли добавить уточнение "(TIA/EIA-422)".

R485 появился только в редактируемой сей момент версии РЭ-11 и на данный момент
там такой текст:
"2.3.4.6 Настройка канального окончания R485

Модуль R485 функционально соответствует модулю R232, только вместо интерфейса

RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"
А тут надо добавить ""(TIA/EIA-485)"" ?

Не знаю. На твое усмотрение.

Такой текст одобряешь?

Пожалуй, нет.

И надо ли что-то подобное указывать в скобках для R422 и R485?

Указывать для чего и где? И подобное чему? Уточни, пожалуйста.

В скобках было "(TIA/EIA-232)", выше ты добавил "(TIA/EIA-422)",
надо ли добавлять для R485 про "(TIA/EIA-485)" я пока не знаю.

Я этого тоже не знаю. На твое усмотрение.

[Vladimir]

Replying to alx:

Replying to Vladimir:

К тому, что может потребоваться открыть исправный блок и поменять перемычки.

И что? Какое отношение этот факт имеет к обсуждаемой теме?

Безусловно, случиться может все что угодно. Например блок может сгореть в первую минуту эксплуатации.

Это форс-мажор, а я имел ввиду совершенно исправный блок, который не надо ремонтировать...

Я утерял нить повествования. :( В чем смысл твоих комментариев? Ты меня хочешь о чем-то спросить?

Нет, я пытаюсь тебя убедить в том, что рисунок 1.4 и текст к нему необходимы в РЭ
и, как я понял, САН с этим согласен.

Насколько я вижу, в приведенном тобой тексте говорится о вкладке "Обновление ПО". На сделанном мной скриншоте изображена именно эта вкладка веб-интерфейса. Думаю, что новый скриншот достаточен для иллюстрации приведенного тобой текста.

Именно этот ответ я и ждал! Твой скрин уже вставлен и пусть остаётся
(я просто увидел что новый скрин и рисунок в РЭ значительно отличаются и решил уточнить).

... я не могу точно сказать, каким именно должен быть этот
рисунок, чтобы юзеры смогли без лишних вопросов к тебе или к САН сами обновить ПО.

А при чем тут разработка шлюза? В шлюзе нет рисунка 2.15. Такой рисунок есть в РЭ. Разработчик РЭ - ты. Я не знаю, каким по твоей задумке должен быть этот рисунок.

Моя задумка может быть и неправильной, а вот Автор хардософта может правильно описать своё творение и ему виднее, как лучше для юзера изложить "Обновление ПО", и какие рисунки для этого надо вставить в РЭ, поэтому я и советуюсь с тобой.
Выше ты утвердил, что новый скрин достаточен для юзера ия согласился,
хотя, если бы я сам попробовал обновить ПО только по тексту РЭ, то, возможно,
возникли бы другие идеи для улучшения описания.
В Такте С.И.Рабинович всегда давал прочитать новый текст своего РЭ молодому специалисту, или практиканту, или дипломнику и, если им было что-то непонятно, то СИР исправлял текст РЭ.
Считай, что я - молодой специалист в отношении VIP :-).

Если ты, как автор хардософта считаешь, что новый, укороченный скрин достаточен для обновления ПО,

Для обновления ПО никакой скриншот не нужен.

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

то я его уже вставил в РЭ, а если ты так не считаешь, то пришли новый скрин.

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

Так и я не могу точно знать, что надо юзеру для понимания процесса Обновления ПО,
т.к. сам ни разу не обновлял: может ли кто-то описывать то, чего не знает? :-)
Скриншот должен устраивать юзера, а не меня (я не обновляю ПО), но Автору софта проще предположить, что лучше для юзера, чем тому, кто не пользовался этим софтом.
А ты почему-то считаешь, что новичок конкретно в этом вопросе знает лучше тебя,
как Автора и харда, и софта:-)
Обычно кто что придумал, сотворил, тот то и описывает что это и как с этим работать :-)

(сравни Рис.2.15 в РЭ-10 на сайте и свой новый скрин в Комм.8).

Сравнил.

И не можешь даже предположить, какой вариант лучше для юзера?
Тогда оставлю обновлённый укороченный скрин.

Я думаю, что это только в РЭ и тем более пояснительный текст о назначении этих перемычек.
Начальник производства (Олег) уверенно сказал, что никаких этикеток и наклеек про перемычки
нет и никогда не было.

Очень плохо.

Поэтому-то и надо это подробно с рисунками изложить в РЭ!

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

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

А ткнуть вольтметром в два контакта разъема на морде блока - мученье?

Профессиональные монтажники, согласно Рис.1.3, Рис.1.4 и текста на стр.8 РЭ
это сделают, но если надо переставлять перемычки, то вскрытие неизбежно.
А перемычки для того и поставлены, чтобы их можно было менять.

А каким образом рисунок 1.4 отвечает на вопрос, "что можно, а чего нельзя"? :)

К этому рисунку есть подробное описание в РЭ.

То есть никаким образом не отвечает. Я так и думал. :)

В РЭ всё прописано (почти целая страница), а если чего-то упущено, то подскажи и я добавлю.

Ну вот, всё-таки надо добавить уточнение "(TIA/EIA-422)" - об этом я и спрашивал.

Спасибо за уточнение. Теперь понятно, о чем ты спрашивал. Я не знаю, надо ли добавить уточнение "(TIA/EIA-422)".

Т.е. для R232 должно быть уточнение "(TIA/EIA-232)", а для R422, R485 не должно ?

R485 появился только в редактируемой сей момент версии РЭ-11 и на данный момент
там такой текст:
"2.3.4.6 Настройка канального окончания R485

Модуль R485 функционально соответствует модулю R232, только вместо интерфейса

RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"
А тут надо добавить ""(TIA/EIA-485)"" ?

Не знаю. На твое усмотрение.

Т.е. ""(TIA/EIA-485)"" это ложь и не относится к нашему интерфейсу R485 ?

Такой текст одобряешь?

Пожалуй, нет.

А какой текст из приведённых тут ранее ты точно одобряешь для РЭ?
Скопируй сюда, я вставлю в РЭ-11 и закрою этот тикет!

И надо ли что-то подобное указывать в скобках для R422 и R485?

Указывать для чего и где? И подобное чему? Уточни, пожалуйста.

В скобках было "(TIA/EIA-232)", выше ты добавил R485, R422
надо ли добавлять для R485 про "(TIA/EIA-485)" я пока не знаю.

Я этого тоже не знаю. На твое усмотрение.

Так и я не знаю, т.к. не Автор этих модулей и софта.
Тогда хотя бы скажи: R422 (TIA/EIA-422), R485 (TIA/EIA-485) это ложь?
Наши R422, R485 не соответствуют этим TIA/EIA и указывать это нельзя?
Если не знаешь (а я тем более), то для R422, R485 не буду указывать TIA/EIA.

[alx]

Replying to Vladimir:

Я утерял нить повествования. :( В чем смысл твоих комментариев? Ты меня хочешь о чем-то спросить?

Нет, я пытаюсь тебя убедить в том, что рисунок 1.4 и текст к нему необходимы в РЭ

Это довольно странно, так как ты не приводишь никаких новых аргументов, а повторяешь старые. Ну хорошо, сейчас я в ответ на них повторю свои уже приводившиеся ранее возражения:

Вскрытие даже исправного блока для перестановки перемычек или замены/добавления плат выходит за рамки эксплуатации изделия. Это уже не эксплуатация, а ремонт/модернизация. Такое вскрытие должен выполнять квалифицированный представитель предприятия-изготовителя, который руководствуется не эксплуатационной, а конструкторской и технологической документацией. Таким образом, наличие в эксплуатационной документации рисунка 1.4 для этого не нужно.

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

Моя задумка может быть и неправильной,

Как и задумка любого другого. :)

а вот Автор хардософта может правильно описать своё творение

Наверное может. Но ты не просил меня описывать мое творение.

Так и я не могу точно знать, что надо юзеру для понимания процесса Обновления ПО,
т.к. сам ни разу не обновлял: может ли кто-то описывать то, чего не знает? :-)

Наверное нет. Но есть очевидный выход из этой проблемы: обнови ПО.

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

Извини, но я вынужден констатировать, что ты плохой телепат. :)

И не можешь даже предположить, какой вариант лучше для юзера?

Могу. Предполагаю, что последний, так как он более точно отражает текущий вид вкладки.

Профессиональные монтажники, согласно Рис.1.3, Рис.1.4 и текста на стр.8 РЭ
это сделают, но если надо переставлять перемычки, то вскрытие неизбежно.

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

В РЭ всё прописано (почти целая страница), а если чего-то упущено, то подскажи и я добавлю.

Смотри описание тикета.

Т.е. для R232 должно быть уточнение "(TIA/EIA-232)", а для R422, R485 не должно ?

Этого я не знаю.

Т.е. ""(TIA/EIA-485)"" это ложь и не относится к нашему интерфейсу R485 ?

R485 - это не интерфейс, а название платы, а также тип канального окончания.

А какой текст из приведённых тут ранее ты точно одобряешь для РЭ?
Скопируй сюда, я вставлю в РЭ-11 и закрою этот тикет!

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

Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP. Канальные окончания R232 создаются автоматически, если в блоке имеются интерфейсы RS-232.

Или даже такой:

Канальные окончания R232 предназначены для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP (при наличии таких интерфейсов в блоке).

Тогда хотя бы скажи: R422 (TIA/EIA-422), R485 (TIA/EIA-485) это ложь?

Странный вопрос... а луна - это ложь? :)

Это не ложь, так как здесь нет никакого утверждения.

Наши R422, R485 не соответствуют этим TIA/EIA и указывать это нельзя?

Этого я не знаю. Рекомендую спросить об этом разработчиков плат R422 и R485.

[Vladimir]

Replying to alx:

Replying to Vladimir:

Нет, я пытаюсь тебя убедить в том, что рисунок 1.4 и текст к нему необходимы в РЭ

Это довольно странно, так как ты не приводишь никаких новых аргументов, а повторяешь старые.

Были и новые аргументы - пуско-наладочные работы чужими монтажниками.
Да и наши специалисты приезжая на место не могут помнить наизусть всё, что есть в РКД,
поэтому тоже открывают РЭ и выполняют необходимые действия,
например, переставляют перемычки согласно Рис.1.4.

а вот Автор хардософта может правильно описать своё творение

Наверное может. Но ты не просил меня описывать мое творение.

Это очевидно: кто же ещё может описать своё творение, как не Автор!
Я вот пытаюсь, но не получается, поэтому и общаюсь с Автором,
но получается слишком много комментов :-)

Наверное нет. Но есть очевидный выход из этой проблемы: обнови ПО.

А зачем, если автор рядом, а у меня кроме РЭ много и других задач,
например, в этом году разработал/модернизировал 15 схем организации связи
(собственно для этой работы меня и пригласили в АДС из УСИ,
где я делал более 10 лет то же самое и выбрал АДС в качестве основного
поставщика ЦСП по национальному проекту "Образование" в части
интернетизации 1116 школ Пермского края).
Автором харда я был четверть века тому назад, а софт вообще никогда не разрабатывал)

И не можешь даже предположить, какой вариант лучше для юзера?

Могу. Предполагаю, что последний, так как он более точно отражает текущий вид вкладки.

Тут уже было много "последних" вариантов, лучше повторить наипоследнийший :-)

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

Если есть разные перемычки, предназначенные для перестановки, то это надо указать,
хотя бы для пуско-наладчиков и для решения возникающих проблем/потребностей,
что и было изначально сделано с наглядным рисунком 1.4.

В РЭ всё прописано (почти целая страница), а если чего-то упущено, то подскажи и я добавлю.

Смотри описание тикета.

Это уже учтено в редактируемом РЭ-11

R485 - это не интерфейс, а название платы, а также тип канального окончания.

Хорошо, но только, начиная со стр.5 во всех версиях РЭ FXO, FXS, ТЧ, RS232, R422, R485 назывались не платами, а модулями (а на самом деле, с подачи МВН, это субмодули).

Но раз ты просишь, повторю. Например такой:

Канальное окончание R232 предназначено для передачи данных интерфейсов RS-232 (TIA/EIA-232) через сеть IP. Канальные окончания R232 создаются автоматически, если в блоке имеются интерфейсы RS-232.

Хорошо, выберу этот вариант.

Для R485 в РЭ-11 будет такой текст:
"Модуль R485 функционально соответствует модулю R232, только вместо интерфейса
RS-232 он имеет интерфейс RS-485. При установке в блок этих модулей автоматически создаются канальные окончания R485. Настройка канального окончания R485 аналогична п. 2.3.4.4"
(и аналогично для R422). Теперь одобряешь этот выбор ?

[alx]

Replying to Vladimir:

Это довольно странно, так как ты не приводишь никаких новых аргументов, а повторяешь старые.

Были и новые аргументы - пуско-наладочные работы чужими монтажниками.

Пусконаладочные работы не требуют вскрытия блока.

Да и наши специалисты приезжая на место не могут помнить наизусть всё, что есть в РКД,
поэтому тоже открывают РЭ и выполняют необходимые действия,

Это очень странные специалисты, действия которых лишены логики... Когда мне надо что-то, что написано в КД (а я не помню), я читаю КД, а не РЭ.

Это очевидно: кто же ещё может описать своё творение, как не Автор!

Это выражение лишено смысла. Любой, кто описывает свое творение, является автором по определению. Иначе это творение не было бы его. :)

Наверное нет. Но есть очевидный выход из этой проблемы: обнови ПО.

А зачем, если автор рядом, а у меня кроме РЭ много и других задач,

Разумный довод. У Автора же, в отличие от тебя, никаких других задач нет!

Тут уже было много "последних" вариантов,

Это неправда.

Если есть разные перемычки, предназначенные для перестановки, то это надо указать,
хотя бы для пуско-наладчиков и для решения возникающих проблем/потребностей,
что и было изначально сделано с наглядным рисунком 1.4.

Ну пошли на 7-й круг. :) Нет, не надо. Эти перемычки не предназначены для перестановки в процессе эксплуатации аппаратуры.

Смотри описание тикета.

Это уже учтено в редактируемом РЭ-11

Смотри остальные еще не закрытые тикеты.

[Vladimir]

Replying to alx:

Replying to Vladimir:

Это довольно странно, так как ты не приводишь никаких новых аргументов, а повторяешь старые.

Были и новые аргументы - пуско-наладочные работы чужими монтажниками.

Пусконаладочные работы не требуют вскрытия блока.

Если есть 3 варианта подключения внешних устройств, тип которых может измениться
во время пусконаладки, то потребуется поменять перемычки.

Да и наши специалисты приезжая на место не могут помнить наизусть всё, что есть в РКД,
поэтому тоже открывают РЭ и выполняют необходимые действия,

Это очень странные специалисты, действия которых лишены логики... Когда мне надо что-то, что написано в КД (а я не помню), я читаю КД, а не РЭ.

А если ты за тыщи км от АДС, а интернет ещё не на всех ГРС,
особенно там, где до сих пор работают К6Т (6 каналов ТЧ) ?

Это очевидно: кто же ещё может описать своё творение, как не Автор!

Это выражение лишено смысла. Любой, кто описывает свое творение, является автором по определению. Иначе это творение не было бы его. :)

А вот я пишу РЭ на то, что не разрабатывал и даже не пользовался:
поэтому я и жду, когда Автор изделия подскажет или опишет то, что он придумал.

Наверное нет. Но есть очевидный выход из этой проблемы: обнови ПО.

А зачем, если автор рядом, а у меня кроме РЭ много и других задач,

Разумный довод. У Автора же, в отличие от тебя, никаких других задач нет!

Но мне надо будет потратить в сотни раз больше времени,
чтобы достигнуть уровня Автора изделия и правильно описать изделие, и его применение.
Мне, наверное, уже не дожить до твоего уровня :-)

Смотри описание тикета.

Это уже учтено в редактируемом РЭ-11

Смотри остальные еще не закрытые тикеты.

А ты не ответил на важный для меня вопрос вопрос в конце Комм-20:
" Теперь одобряешь этот выбор ?" (выбор отмечен жирным шрифтом).

[alx]

Replying to Vladimir:

Если есть 3 варианта подключения внешних устройств, тип которых может измениться
во время пусконаладки, то потребуется поменять перемычки.

А еще во время пусконаладки аппаратура может выйти из строя, и потребуется ее ремонт. И что? Все это - пусконаладка/ремонт/модернизация аппаратуры - не имеет отношения к эксплуатации.

А если ты за тыщи км от АДС, а интернет ещё не на всех ГРС,
особенно там, где до сих пор работают К6Т (6 каналов ТЧ) ?

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

Это выражение лишено смысла. Любой, кто описывает свое творение, является автором по определению. Иначе это творение не было бы его. :)

А вот я пишу РЭ на то, что не разрабатывал и даже не пользовался:

Значит ты описываешь не свое творение, и твоя фраза неприменима.

поэтому я и жду, когда Автор изделия подскажет или опишет то, что он придумал.

Ты будешь ждать очень долго, если автор не знает о том, что ты от него что-то ждешь... :)

А ты не ответил на важный для меня вопрос вопрос в конце Комм-20:
" Теперь одобряешь этот выбор ?" (выбор отмечен жирным шрифтом).

Я не ответил и, надеюсь, никогда больше не буду отвечать на такие вопросы.

Владимир Александрович, я тебя очень уважаю и как доброго и отзывчивого человека, и как грамотного и очень опытного сотрудника. Бог свидетель, я по много раз отвечаю даже на самые странные твои вопросы, часто не имеющие ни малейшего отношения к теме тикета, в котором ты их задаешь. Но, прости меня, моему терпению тоже есть предел. В comment:20 ты в точности, до буквы и знака препинания повторил текст, который я предложил тебе в comment:6, и спрашиваешь, одобряю ли я его. Я уже много раз тебе говорил, что если я предлагаю тебе какой-то текст, то я с ним согласен, и поэтому не надо его со мной еще раз согласовывать. Зачем бы я стал предлагать тебе то, что сам же не одобряю? В целях вредительства? Ты подозреваешь меня в саботаже? :) Если человек не согласен со своим собственным предложением - он ментально нездоров, это симптом шизофрении (или какого-то еще серьезного расстройства, я не знаю точно какого, я не психиатр). Каждый раз, когда ты спрашиваешь, согласен ли я со своим собственным предложением, ты тем самым интересуешься, не душевнобольной ли я. Мне это обидно. Я уже несколько раз обещал тебе, что не буду такие вопросы согласовывать. Я тебе что-то предложил - и дальше ты сам решай, что с моим предложением делать. Поэтому подобные вопросы я буду просто игнорировать.

[Vladimir]

Replying to alx:

Replying to Vladimir:

А ты не ответил на важный для меня вопрос вопрос в конце Комм-20:
" Теперь одобряешь этот выбор ?" (выбор отмечен жирным шрифтом).

Я не ответил и, надеюсь, никогда больше не буду отвечать на такие вопросы.

Хорошо, извини за вопросы, просто в этих описаниях я всегда сомневаюсь
и поэтому всегда жду подтверждения от более опытных в этих вопросах знатоков,
хотя бы двумя буквами "Ок" :-)

Поддержку R232 я уже вставил согласно этого тикета и обсуждения с тобой,
за которое и за твоё терпение спасибо, поэтому этот Тикет закрываю,
а после публикации, если потребуется, то исправлю в будущем РЭ-12.

В РЭ-11 от 25.03.2022 добавлена поддержка R232

[san]

Milestone deleted