#1013 closed улучшение (готово)
РЭ: Ошибки в описании вкладки сервис:
Reported by: | san | Owned by: | Vladimir |
---|---|---|---|
Priority: | major | Component: | Руководство по эксплуатации |
Keywords: | Cc: |
Description
У меня есть несколько замечаний к таблицеТабл. 6.22 Назначение граф вкладки Сервис на Рис. 6.61
- Почти в каждой строке повторяется фраза
пакетов служебной информации по шине SPI управления
, на мой взгляд это просто текстовый мусор, т.к. вся вкладка посвящена этой шине и незачем повторять это в каждой строке. - Тут есть какая-то не однозначность, если пакеты "дропнутые", то как они могут быть передаваемыми :
Dropped - Отображает количество пакетов служебной информации по шине SPI управления, передаваемых платой SW-01 размером больше максимальной длины
- А здесь пропущено важное слово "неожиданных":
Unexpected requests - Отображает количество запросов, переданных данной платой к плате SW-01.
Как любит Vladimir, я предложу сразу готовый текст всей таблицы на замену:
Табл. 6.22 Назначение граф вкладки Сервис на Рис. 6.61
Название колонки | Назначение |
Слот | Номер плато-места в блоке |
Режим | Текущий режим контроля целостности информационных сообщений(контрольная сумма). Возможные значения: XOR8, CRC16, CRC32 |
Rx-OK | Счетчик безошибочно принятых пакетов платой SW-01 от данного слота |
Rx-Bad | Счётчик пакетов с неправильной контрольной суммой, принятых платой SW-01 от данного слота |
Discarded | Счетчик пакетов, отброшенных из-за нарушения кодирования(чередования флагов), среди принятых платой SW-01 от данного слота |
Short | Счетчик пакетов размером меньше минимальной длины, принятых платой SW-01 от данного слота |
Big | Счетчик пакетов размером больше максимальной длины, принятых платой SW-01 от данного слота |
Tx-OK | Счетчик пакетов переданных платой SW-01 в данный слот |
Dropped | Счетчик попыток передачи пакетов размером больше максимальной длины, платой SW-01 в данный слот |
Rx-Bytes | Счетчик байт, принятых платой SW-01 от данного слота |
Tx-Bytes | Счетчик байт, переданных платой SW-01 в данный слот |
Unexpected requests | Счётчик неожиданных запросов (с точки зрения алгоритма обмена данными по служебной шине), принятых платой SW-01 от данного слота |
Change History (10)
comment:1 by , 2 years ago
Resolution: | → готово |
---|---|
Status: | new → closed |
follow-up: 3 comment:2 by , 2 years ago
Replying to san:
- А здесь пропущено важное слово "неожиданных":
Unexpected requests - Отображает количество запросов, переданных данной платой к плате SW-01.
Я могу пояснить. Раньше, почти 10 лет назад, когда только придумали и реализовали протокол управления, предполагалось, что только SW-01 может по своей инициативе передавать запросы другим платам. А другие платы должны передавать на эти запросы ответы. Поэтому любой запрос, принятый SW-01, трактовался как "неожиданный". Таким образом, слово "неожиданный" в данной фразе не является таким уж важным...
Позже я сделал алгоритм более гибким, допустив получение и обработку запросов от периферийных плат, но на практике эта возможность никакими платами не применяется...
follow-up: 6 comment:3 by , 2 years ago
Replying to alx:
Replying to san:
- А здесь пропущено важное слово "неожиданных":
Unexpected requests - Отображает количество запросов, переданных данной платой к плате SW-01.
Я могу пояснить. Раньше, почти 10 лет назад, когда только придумали и реализовали протокол управления, предполагалось, что только SW-01 может по своей инициативе передавать запросы другим платам. А другие платы должны передавать на эти запросы ответы. Поэтому любой запрос, принятый SW-01, трактовался как "неожиданный". Таким образом, слово "неожиданный" в данной фразе не является таким уж важным...
Позже я сделал алгоритм более гибким, допустив получение и обработку запросов от периферийных плат, но на практике эта возможность никакими платами не применяется...
И что при этом надо изменить в тексте от САН в редактируемом РЭ-55 ?
follow-up: 5 comment:4 by , 2 years ago
Пользователю мало что известно о взаимодействии плат по Spi, не думаю что пользователь видит разницу между запросами и ответами, поэтому я считаю, что слово 'неожиданных' тут важно, т.к. сразу указывает пользователю, что увеличение этого счётчика это не нормально.
follow-up: 9 comment:5 by , 2 years ago
Replying to san:
Пользователю мало что известно о взаимодействии плат по Spi, не думаю что пользователь видит разницу между запросами и ответами, поэтому я считаю, что слово 'неожиданных' тут важно,
По такой логике, неважным (и даже вредным, так как непонятно, что значит) является слово "запрос". Однако ты его почему-то из текста не исключил... :)
follow-up: 7 comment:6 by , 2 years ago
Replying to Vladimir:
И что при этом надо изменить в тексте от САН в редактируемом РЭ-55 ?
Надо кому? Кому адресован вопрос?
follow-up: 8 comment:7 by , 2 years ago
Replying to alx:
Replying to Vladimir:
И что при этом надо изменить в тексте от САН в редактируемом РЭ-55 ?
Надо кому? Кому адресован вопрос?
Вопрос к тебе в связи с твоим комм-2 - как ты думаешь, надо ли мне что-то изменить в тексте РЭ,
или годится на 100% тот текст для Табл.6.22, который предложил в этом тикете САН?
Это же был ответ тебе на твой коммент-2, т.е. и вопрос в краткой форме был к тебе :-)
comment:8 by , 2 years ago
Replying to Vladimir:
Вопрос к тебе в связи с твоим комм-3 - как ты думаешь, надо ли мне что-то изменить в тексте РЭ,
или годится на 100% тот текст для Табл.6.22, который предложил в этом тикете САН?
Во-первых, comment:3 я не писал.
Во-вторых, я думаю, что тебе как разработчику РЭ это лучше знать, чем мне.
Это же был ответ тебе на твой коммент-2,
Это я понял из первой строчки твоего комментария.
т.е. и вопрос в краткой форме был к тебе :-)
Спасибо за уточнение. Мой ответ - не знаю. Делай с текстом то, что считаешь нужным и правильным. А я - специалист по аппаратуре, поэтому мне лучше задавать вопросы по аппаратуре, а не по тексту.
comment:9 by , 2 years ago
Replying to alx:
По такой логике, неважным (и даже вредным, так как непонятно, что значит) является слово "запрос". Однако ты его почему-то из текста не исключил... :)
Ага. Пользователь знает, что платы обмениваются некими пакетами и "неожиданных пакетов" было бы точнее в этой терминологии.
Replying to san:
Все бы ТАК предлагали - было бы короче и быстрее!
В РЭ-55 от 22.12.2022 заменил текст всей Табл.6.22 на предложенный.