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

[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]

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

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

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

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

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

[brigval 719]

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

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

я brigval)

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

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

П р и м е ч а н и я

1 .....

2 .....

 

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

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

 

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

 

 

Изменено 18 октября пользователем 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 ГОСТами. Документацию на ПО выпускаю впервые, много вопросов, разъяснений мало. Может есть РД или другие документы, форумы, где больше разбирают вопросы связанные с выпуском документации. Может кто-то поделиться, буду очень благодарна. Еще раз огромное спасибо за внимание к моему вопросу.

[Niki85 56]

18.10.2024 в 14:52, А_Елена сказал:

ХХХХ.ХХХХХХ.ХХХ 90 01

Это обозначение документа и место ему в разделе "Документы", а в разделе "Компоненты" записывают обозначение программ ГОСТ 19.103-77.

[А_Елена 0]

21.10.2024 в 19:42, Niki85 сказал:

Это обозначение документа и место ему в разделе "Документы", а в разделе "Компоненты" записывают обозначение программ ГОСТ 19.103-77.

Огромное спасибо за подсказку. Задумалась.... Так писали до меня, перечитала ГОСТ, Вы правы...но увы...как мне ответили, много документации так сделано, никто не согласиться на такие изменения. Можете для примера привести образец спецификации, с учетом титульного листа и ЛУ. Можно еще вопрос, как в документе спецификация на ПО отражают, что документ исправлен по извещению?  

[Niki85 56]

2 часа назад, А_Елена сказал:

как в документе спецификация на ПО отражают, что документ исправлен по извещению?

Лист регистрации изменений ГОСТ 19.604-78 . 

[А_Елена 0]

15 часов назад, Niki85 сказал:

Лист регистрации изменений ГОСТ 19.604-78 . 

Доброе утро, спасибо за ответы. Да ЛРИ заполняют, не корректно написала.

Интересует вопрос, в какой форме представляют запись на замененных и новых листах? По этому ГОСТу п. 2.11 пишем номер изм., подпись лица, внесшего изм,, дата изм.. В каком виде должна быть представлена эта информация (через запятую, через знак "/" или как-то еще)? Согласно ГОСТ 19.104, поле 9 строка изм на ЛУ и титлисте, тогда она тоже должна быть заполнена или как? В ГОСТе 19.604 написано, что при замене всего документа заполняется только ЛРИ, но требуют заполнять на всех листах. Еще интересует вопрос, согласно ГОСТ 19.106 п. 1.6 основная часть программного документа должна включать раздел "часть регистрации изменений", что это за часть, в каком виде она должна быть представлена? Я так понимаю, что там должны перечисляться все изменения, которые проводили с данным документом (номер изменения, дата, кто проводил и суть изменения). 

[Niki85 56]

Только что, А_Елена сказал:

Согласно ГОСТ 19.104, поле 9 строка изм на ЛУ и титлисте, тогда она тоже должна быть заполнена или как? В ГОСТе 19.604 написано, что при замене всего документа заполняется только ЛРИ, но требуют заполнять на всех листах.

Читайте внимательно пункт 2.10, 2.11 ГОСТ 19.604-78 "только замененных и новых", в других случаях только лист регистрации изменений.

Изменено вчера в 08:14 пользователем Niki85

[А_Елена 0]

2 часа назад, Niki85 сказал:

Читайте внимательно пункт 2.10, 2.11 ГОСТ 19.604-78 "только замененных и новых", в других случаях только лист регистрации изменений.

Спасибо, написала, что требуют писать на всех. Значит правильно интерпретирую, что при замене всего документа заполняют ЛРИ. Еще спрашивала как выглядит сама запись об изменении на этих листах и что такое часть "Регистрации изменений по ГОСТ 19.106? 

[Niki85 56]

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

и что такое часть "Регистрации изменений по ГОСТ 19.106? 

Это место, где должна записываться строка в соответствии с пунктом 2.11 ГОСТ 19.604-78.

[А_Елена 0]

20 минут назад, Niki85 сказал:

Это место, где должна записываться строка в соответствии с пунктом 2.11 ГОСТ 19.604-78.

я так поняла, что это целый раздел. В ГОСТе 19.106 п. 1.6 написано "Материалы программного документа располагают в последовательности....ЛУ, Титлист, аннотация, лист содержания, текст документа....приложения...перечень рисунков, сокращений.....часть регистрации изменений, ЛРИ." и часть "регистрации изменений" это часть, отдельный раздел. Это не строка изменений согласно п. 2.11 ГОСТ 19.604. А вот вид этой строки изменений я спрашивала, как должен выглядеть, перечисление через запятую или косую наклонную черту

[Niki85 56]

1 час назад, А_Елена сказал:

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

Кто работал по старом стандартам, у того не было вопросов по п.2.11 ГОСТ19.604-78, делали без всяких разделительных знаков, по аналогии как в ГОСТ 2.105-95 п.6.9 — Поле 10.