Составление руководства программиста?

Question

[Max Beletsky]

Есть у кого примеры руководства программиста на прошивку для контроллера, составленные по ГОСТ 19.504-79? Или можете объяснить, что писать в разделах, если это прошивка на камень?

Answer 1

[Александр]

Вы вообще получали высшее образование? Лаборатоные работы делали?
Вот нужно примерно тоже самое надо сделать.
ГОСТ 19.504-79 - говорит что там должно быть,
ГОСТ 19.105-78 - говорит как это должно быть оформлено.

не могу проверить пример, так как не знаком с программой
aisup.economy.gov.ru/pubportal/downloadfile?uuid=p...

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

Comments

[Max Beletsky]

Вы вообще получали высшее образование?

Нет

Тот пример, что Вы скинули, я видел

В ГОСТ 19.504-79 не сказано, что нужно описывать на какие выводы какая функция (хотя может я дурак и не так понимаю).
Программа на камне автономна и нет ни входных и выходных данных, ни обращения к программе (ни процедур вызова программы). В разделе "Характеристика программы" только описание основных характеристик и особенностей.
И по сути код и описание функций должны быть в тексте программы и в описании программы.

[Александр]

Как это нет входных и выходных данных? По вашей логике к "камню" подключенны только питание и кварц и он тупо потребляет электроэнергию ничего не делая.
Когда программа выполненна в аппаратном виде - микроконтроллер, то входными данными будут датчики.
Например ПИД-Регулятор:
"Назначение и условия применения программы" заливается в Atmega32u4 и назначение выводов:
выводы 12(SDA),13(SCK) шина i2c сенсор темпиратуры типа MCP9808 по адресу 0x78 - нужно указать чего ожидает программа на входе.
выводы кнопок, комутация на землю 14(вверх), 15(вниз), 16(вправо), 17(влево)
выходные данные : выводы 24(MOSI),25(MISO),26(SCK),27(CS),28(Reset) - цветной дисплей типа ili9341
вывод 29(реле) - управление нагревательным элементом, 30(реле) - управление вентилятором.
формат входных данных цикличный опрос датчика темпиратуры, управление кнопками через графическое меню, формат выходных данных дисплей 240x320 пикселей, порт RS232
"Обращение к программе" - описание структуры меню и вывода на дисплей.
"Входные и выходные данные" - описание комманд управления и параметров на порту RS232.
"Сообщения" - ошибки и расшифровка их кодов и когда возникают.
"Характеристики программы" - циклическое измерение темпиратуры, определение скорости реакции на воздействие нагревателя, поддержание темпиратуры в заданном диапазоне, прием внешних комманд конфигурации и управления.

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

Вобщем в госте все понятно написанно, если вам сложно самому это написать - обратитесь за помощью к специалистам.

[Max Beletsky]

Спасибо за разъяснение)

если вам сложно самому это написать - обратитесь за помощью к специалистам

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