Программное обеспечение.

[luffyfuffy 0]

Друзья,

Вновь подниму данный вопрос.

Если с инструкцией по прошивке и замой прошивкой в виде бинарника или HEX всё понятно, как сказал ранее @Niki85:

27.03.2017 в 08:56, Niki85 сказал:

Разрабатывается документ "Инструкция по программированию микросхем" И33 в которой есть ссылка на носитель с прошивкой, с наименованием "Данные программирования" Д42. Эти документы записывают в раздел "Документация" спецификации.

 

Но возникает вопрос, как добавляется в КД (и добавляется ли вообще?), исходный код на прошивку?

В прекрасном РД 107.2.1002 есть документ с кодом Д40, с отсылкой к загадочному понятию «конструкторская документация программного обеспечения», которое помимо РД 107.2.1002 встречается только в достаточно свежем ГОСТ Р 58711-2019 по авиационной технике:

Цитата

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

При этом возникает противоречие КД на ПО составные части которого «необходимые и достаточные для загрузки программного обеспечения в память изделия», т.е. фактически идёт речь именно про прошивку)

 

Понимаю, что можно махнуть на всё и добавить свой собственный код для документа ДХХХ, но хотелось бы оставаться хоть в каком-то регламентированном поле. Или для исходного кода всё же создаётся вообще отдельная программная документация в соответствии с ЕСПД, которая в КД на изделие с микросхемой и прошивкой не попадает?

[BSV1 1 749]

17 часов назад, luffyfuffy сказал:

Или для исходного кода всё же создаётся вообще отдельная программная документация в соответствии с ЕСПД ...

Создается.

 

17 часов назад, luffyfuffy сказал:

... которая в КД на изделие с микросхемой и прошивкой не попадает?

Запишите в раздел "Документация" и попадет.

[А_Елена 0]

Добрый день! помогите пожалуйста в таком вопросе. Выпускается Спецификация на программное обеспечение. В спецификации есть графа ПРИМЕЧАНИЕ и в ней необходимо указать дополнительную информацию, относящуюся к элементу этой спецификации. Как правильно оформить эту графу. Выполните в таком виде, оформили как сноску в разделе примечания. Это правильно? Нигде нет указания как правильно оформить. ГОСТ 19.202 говорит просто, что информация должна располагаться в графе ПРИМЕЧАНИЕ и что это примечание. ГОСТ 19.106 тоже не дает разъяснений.

Обозначение	Наименование	Примечание
	Документация
ХХХХ.ХХХХХХ.ХХХ ПО-ЛУ	ХХХХХХХ	Рассылка по
	Спецификация	указанию
	Лист утверждения
	Компоненты
ХХХХ.ХХХХХХ.ХХХ 90 01	ХХХХХХХ	1)2)
	ХХХХХХХХХХХ	Компакт-диск
		CD-R

 

1)	Размер файла: ХХХХХХХ байт
2)	Контрольная сумма MD5: ХХХХХХХХХХХХХХХ

 

 

[brigval 719]

В принципе, вариант на вашем скриншоте соответствует ГОСТу.

 

Скрытый текст

 

[А_Елена 0]

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

[Богоманшин Игорь 312]

46 минут назад, А_Елена сказал:

подскажите, на что надо сослаться, что этот вариант правильный. 

Можете на этот сайт :Росстандарт ГОСТ 19.202-78 статус - действующий (на 18/10/2024)

[brigval 719]

56 минут назад, А_Елена сказал:

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

я brigval)

Я привел выдержку из ГОСТа. Она не устраивает? Там сказано, что делать при длинных примечаниях.

Только я бы записал как в ГОСТ Р 2.105

П р и м е ч а н и я

1 .....

2 .....

 

Ставить или не ставить скобки, думаю не принципиально. В данном случае.

Если ставить, то всегда. Если не ставить, то тоже всегда.

 

Скрытый текст

 

 

Изменено В пятницу в 13:17 пользователем brigval

[А_Елена 0]

Спасибо. Я тоже рассматривала написание как примечание, но ссылка только на ГОСТ 19.106 (п 2.6 про сноски в таблицах, впрочем как и оформила  и примечания (п.2.7)). Но если писать как примечания, то внешне в графе ПРИМЕЧАНИЕ спецификации надпись смотрится, что вроде хотели написать что-то и забыли (по ГОСТу этому надо писать 1. , а затем внизу само примечание указывать. Встречала в  ГОСТ Р 58711-2019 Авиационная техника. Программное обеспечение встроенных систем Требования к КД, там пишут в графе примечание "см. примечание, пункт 1). Вот и сомневалась, а нормоконтроль требует как раньше было, чтоб цифру со скобкой ставили в разделе Наименование после текста и внизу таблицы расшифровка, что противоречит ГОСТ 19.202. Хочу сделать правильно. 

[brigval 719]

12 минут назад, А_Елена сказал:

Спасибо. Я тоже рассматривала написание как примечание, но ссылка только на ГОСТ 19.106 (п 2.6 про сноски в таблицах, впрочем как и оформила  и примечания (п.2.7)). Но если писать как примечания, то внешне в графе ПРИМЕЧАНИЕ спецификации надпись смотрится, что вроде хотели написать что-то и забыли (по ГОСТу этому надо писать 1. , а затем внизу само примечание указывать. Встречала в  ГОСТ Р 58711-2019 Авиационная техника. Программное обеспечение встроенных систем Требования к КД, там пишут в графе примечание "см. примечание, пункт 1). Вот и сомневалась, а нормоконтроль требует как раньше было, чтоб цифру со скобкой ставили в разделе Наименование после текста и внизу таблицы расшифровка, что противоречит ГОСТ 19.202. Хочу сделать правильно. 

 

Правильно так, как говорит нормоконтроль. Не зависимо от того, что написано в ГОСТах.

Я бы написал как говорит нормокнтроль. В конце концов это его зона ответственности.

Номер есть, примечание за этим номером есть. Этого достаточно для работы. И это по ГОСТ.

[А_Елена 0]

Доброе утро. Простите, но я склонна придерживаться мнения, что правильно так, как в ГОСТах. Все могут ошибаться и нормоконтроль тоже. А если учесть, что у нас нормоконтролем занимается человек некомпетентный но с большими амбициями, человек который до недавнего времени вообще не знал, что существуют ГОСты и что такое КД, то  в спорном вопросе решила спросить компетентных лиц. В ГОСТах не всегда однозначно описаны некоторые моменты. Для документов на ПО стараюсь руководствоваться 19 ГОСТами. Документацию на ПО выпускаю впервые, много вопросов, разъяснений мало. Может есть РД или другие документы, форумы, где больше разбирают вопросы связанные с выпуском документации. Может кто-то поделиться, буду очень благодарна. Еще раз огромное спасибо за внимание к моему вопросу.