qadesk.ru / Документация / Железо и прошивки
Документация · Железо и прошивки

Железо и прошивки: устройства, прошивочный стек и измерения

Проект типа «Железо и прошивки» знает объект испытаний — экземпляр устройства с серийным номером, версии прошивок на каждом прогоне и числовые результаты с допусками. Ниже — модель данных, матрица совместимости, формат JSON для CI и работа в кабинете.

Обновлено: 7 октября 2026

Что умеет QA Деск для тестирования железа?

Три вещи поверх обычных кейсов, планов и прогонов: справочник моделей и экземпляров устройств (DUT), прошивочный стек — версии BIOS, BMC, микрокода, ОС и драйверов, снятые на каждом прогоне, — и измерительные шаги кейса: число с единицей и допуском, вердикт по которому считает сервис.

Из этих трёх частей собирается пруф качества для железа: «кейс пройден на экземпляре SN-0142 ревизии B, BIOS 1.2.3 + BMC 4.5, температура 72,5 °C при допуске ≤ 85 °C». Прогон месячной давности по-прежнему относится к своим версиям прошивок, а матрицу совместимости не нужно вести в Excel рядом с сервисом.

  1. Модель и экземплярКонкретная железка с серийным номером
  2. Прошивочный стекВерсии компонентов снимком на старте прогона
  3. Измерение с допускомПоле «Допуск измерения» у шага кейса
  4. Число из CI или стендаФайл *.qadesk.json через qadesk-cli
  5. Вердикт по допускуСчитает QA Деск, границы включительные
  6. Тренд и матрицаИзмерения по прогонам и матрица совместимости
Путь испытания железа в QA Деск: от экземпляра и стека до вердикта, тренда и матрицы

Как включить разделы железа в проекте?

Выберите тип проекта «Железо и прошивки»: Настройки → Карточка проекта → Тип проекта. У этого типа сразу включены все разделы железа — справочник устройств, прошивочный стек, испытания на стенде, логи железа во вложениях, средства измерений и несоответствия.

У других типов их нет по умолчанию, но любой раздел включается отдельно: Настройки → Карточка проекта → Разделы проекта. Стек версий пригодится веб-проекту для нагрузки, приборы — пусконаладке, и менять ради этого тип не нужно.

Смена типа и выключение раздела ничего не удаляют: модели, экземпляры, снимки стека и привязки старых дефектов и прогонов остаются, подписи в старых карточках видны. Закрывается только новая запись. При переводе проекта в «Железо и прошивки» стек заполняется умолчаниями, если он пуст: bios, bmc, microcode, os, driver.

Чем модель устройства отличается от экземпляра?

Модель — это вендор, модель и аппаратная ревизия: то, что пишут в HCL. Экземпляр — конкретная железка этой модели с серийным и инвентарным номером, ревизией и состоянием «в работе», «в ремонте» или «списан». Прогон и дефект привязываются к экземпляру, поэтому «не воспроизводится на втором образце» записывается двумя разными экземплярами.

Правила, которые держит база данных, а не только интерфейс:

  • серийный номер уникален в проекте без учёта регистра — среди всех состояний, включая списанные: списанный экземпляр с тем же номером — та же железка, и история не раздваивается;
  • модель с экземплярами и экземпляр с историей не удаляются: модель архивируется, экземпляр списывается;
  • модель у экземпляра не меняется — ошибка ввода лечится списанием и новым экземпляром;
  • списанный экземпляр нельзя выбрать для нового прогона или дефекта, старые ссылки не рвутся.

На карточке экземпляра — последние 50 прогонов и 50 дефектов на нём, а у составного изделия — ещё и дерево его узлов. Лимиты проекта — 100 действующих моделей и 500 несписанных экземпляров. Дефект, заведённый из упавшего шага прогона, наследует экземпляр прогона.

Как вести состав изделия: вагон, тележки, колёсные пары?

Экземпляр может входить в другой экземпляр — получается дерево «как собрано»: вагон → тележки → колёсные пары, тяговые двигатели, преобразователи, у каждого узла свой серийный номер, свои прогоны и свои несоответствия. Состав ведётся в карточке экземпляра, в блоке «Состав изделия»: кнопки «Установить узел», «Заменить» и «Снять».

Состав хранится как журнал вхождений, а не как поле «родитель»: по каждому узлу записано, кто и когда его установил, кто и когда снял, по какому NCR и почему. Замена — одно действие: старый узел снимается, новый встаёт на его позицию и помнит, кого заменил. После замены тележки по журналу видно, какая стояла на вагоне в день приёмки.

На карточке изделия видно всё дерево сразу: по каждому узлу — итог последнего завершённого прогона («прошёл», «с отказами», «частично») и открытые NCR и дефекты, сверху — сводка по узлам. На карточке узла — путь «в составе» до изделия верхнего уровня. Снятый узел уходит из дерева вместе со своими узлами; его история остаётся на его карточке и в журнале.

Правила держит база данных, а не только интерфейс:

  • узел в один момент стоит не больше чем в одном изделии;
  • изделие не может входить в себя ни прямо, ни через свои узлы;
  • глубина дерева — до 8 уровней;
  • названная позиция («ось 1») занята одним узлом;
  • запись о снятии не правится: ошибка ввода исправляется новой записью, обе остаются в журнале;
  • узел снимается по несоответствию (NCR) этого узла или изделия, в котором он стоит, — не по обычному дефекту.

Это фактический состав экземпляра, а не конструкторская спецификация: состав из PDM или ERP сюда не переносится. Менять состав может тот, кто управляет проектом; читать — любой участник.

Что такое прошивочный стек прогона?

Это набор компонентов с версиями, который снимается снимком на старте прогона: {"bios": "1.2.3", "bmc": "4.5"}. Список компонентов задаётся на проект — до 12 штук, ключ латиницей вроде bios или fpga. Снимок не редактируется: прогон остаётся историческим артефактом, даже если компонент потом переименуют или удалят.

Прогоны испытаний оборудования в QA Деск
Экземпляр устройства, снапшот версий прошивочного стека и партия на каждом прогоне.

Версии указываются в диалоге старта прогона — поле на каждый компонент, пустые не отправляются — или флагом --stack у qadesk-cli. Пропущенный компонент — честная запись «не трогали»; ключ не из справочника проекта отклоняется целиком с ошибкой stack_key_unknown и списком чужих ключей. На прогоне версии видны чипом 🧩 в списке, карточке и исполнении.

Как построить матрицу совместимости (HCL)?

Откройте вкладку прогонов железного проекта и нажмите «▦ Матрица совместимости». По умолчанию строки — модели устройств, колонки — версии первого компонента стека; любую ось можно заменить другим компонентом и сузить срез по сборке (через API — ещё и по тест-плану). Матрица считается на лету из снимков стека, отдельно не хранится.

Матрица совместимости в QA Деск
Результат испытаний по версиям компонентов прошивочного стека.

Клетка — все прогоны с этим сочетанием: счётчики строк, число прогонов и ссылка на последний. Вердикт клетки — по худшему прогону, а не по последнему: fail, если есть хоть одна упавшая строка; pass, если все исполненные строки пройдены и неисполненных нет; partial — упавших нет, но есть заблокированные, пропущенные или непройденные; none — исполненных нет. Прогон без устройства попадает в строку «без устройства», без версии компонента — в колонку «версия не указана»: пробел в покрытии виден, а не схлопнут в соседнюю клетку. Оси обрезаются до 40 значений.

Как задать измерение с допуском в тест-кейсе?

В редакторе кейса железного проекта у шага есть поле «Допуск измерения» — одна строка: ≤ 85 °C, ≥ 900 МБ/с, 12 ± 0.5 В, 180…220 Вт. Поддерживаются два вида: «ожидаемое ± допуск» и диапазон, где одна из границ может отсутствовать. Границы включительные: 85,0 при «≤ 85» — пройдено.

Единица — только подпись: сервис ничего не конвертирует и сравнивает число с числом. Допуск входит в версию кейса, поэтому старый прогон помнит, по какому допуску его мерили. При ручном исполнении у измерительного шага вместо кнопок — поле числа с подсказкой «будет пройден / провален»; итоговый вердикт приходит с сервера. «Заблокирован» и «Пропущен» работают как обычно: замер не сделан — это состояние, а не число.

Как отправить измерения из CI в JSON?

Сохраните результаты в файл *.qadesk.json и загрузите его утилитой qadesk-cli 0.3.0 или запросом POST /ingest/v1/qadesk. В файле — тест, ключ кейса и числа по номерам шагов. Вердикт по допуску считает QA Деск: число вне допуска валит строку даже при "status": "passed" от автотеста.

{ "results": [
  { "name": "thermal load", "caseKey": "SRV-C12", "status": "passed",
    "durationMs": 600000,
    "metrics": [ { "step": 2, "value": 72.5 }, { "step": 3, "value": 12.4 } ] },
  { "name": "tests.SRV_C7.boot" }
] }
qadesk-cli upload --run "burn-in стенд 3" \
  --stack bios=1.2.3 --stack bmc=4.5 ./out

Поля формата:

ПолеОбязательноЧто
nameдаимя теста; ключ кейса ищется и в нём (SRV-C7, SRV_C7)
caseKeyнетключ кейса, если его нет в имени
statusнетpassed по умолчанию, failed, skipped; error и broken — как failed
durationMsнетдлительность в миллисекундах
messageнеттекст ошибки
metrics[].stepда, если есть метрикиномер шага кейса, с 1
metrics[].valueда, если есть метрикиконечное число, не больше 100 метрик на результат

Неизвестное поле — ошибка всего отчёта: опечатка metrcis не должна молча потерять числа. Метрика на шаг без допуска (step_not_measured) или на несуществующий шаг (no_step) не записывается и возвращается в ответе блоком metrics — утилита печатает такие поимённо, а строку принимает по статусу. Числа входят в отпечаток идемпотентности: другие значения при тех же статусах — другой отчёт. В режиме auto файлы *.qadesk.json имеют приоритет над Allure и JUnit и склеиваются в один отчёт. Обёртка над fio, stress-ng или Phoronix Test Suite — это скрипт, который переписывает их JSON в этот формат.

Как запустить длительное испытание (burn-in) на стенде?

Поставьте строку прогона «на стенд»: в исполнении строки — «🔥 Поставить на стенд» со сроком от 1 до 168 часов. Итог пришлёт сам стенд командой qadesk-cli upload --target-run <id прогона>; не пришлёт к сроку — QA Деск поставит строке «заблокирован» с пометкой.

Время стенда от постановки до итога ложится в строку целиком, без ограничения таймера в 8 часов. Прогон с отметкой «закрыть сам» переходит в «завершён», когда в нём не остаётся строк без итога — после итога стенда, испытателя или по сроку. На карточке прогона строка помечена чипом «🔥 стенд до …».

qadesk-cli upload --target-run https://app.qadesk.ru/projects/…/runs/<uuid> \
  --stack bios=1.2.3 ./burnin-out

Правила доставки итога стенда:

  • ложатся только строки, стоящие на стенде; итог, поставленный испытателем, стенд не перезаписывает (not_on_bench), кейс не из прогона — not_in_run;
  • --stack обязан совпасть со снимком стека прогона, иначе ошибка target_stack_mismatch: стенд гонялся на другой прошивке — это новый прогон;
  • ключ идемпотентности CI не нужен и отклоняется: строка принимает итог один раз, повтор отсекает она сама;
  • метрики формата qadesk ложатся на измерительные шаги той версии кейса, что зафиксирована в прогоне.

Как приложить к дефекту SEL, dmesg или консольный лог?

Прикрепите файл к дефекту проекта «Железо и прошивки» — QA Деск сам узнает лог железа и покажет сводку прямо в карточке. Распознаются IPMI SEL (ipmitool sel list и sel elist), журнал Redfish, dmesg и journalctl -k, консоль UART/serial, отчёты memtester и MemTest86, JSON-вывод fio.

На плитке вложения появляется чип вида «🔧 IPMI SEL · 2 крит. · событий 12», цвет — по худшему, что нашлось в логе. Ниже — блок «Логи железа»: таблица событий SEL с временем, датчиком и серьёзностью (критические наверху), строки dmesg с признаками сбоя и флаг паники ядра, итог теста памяти, задания fio с IOPS, пропускной способностью и задержками.

Правила распознавания:

  • вид ставится только по сильной сигнатуре: несколько строк формата, а не одно слово; markdown-таблица с «|» или лог приложения остаются обычными файлами;
  • серьёзность события SEL выводится из текста: снятое состояние (Deasserted) — информация, Failure, Uncorrectable ECC, IERR, Critical — критическое, Non-critical и Correctable ECC — предупреждение;
  • читаются первые 2 МиБ файла; длинный лог, разобранный не целиком, помечен «разобрана голова файла», сам файл хранится и скачивается целиком;
  • картинки и бинарные файлы не читаются; вложения комментариев не распознаются — лог железа кладут в дефект.

Где смотреть тренд замеров?

На карточке кейса в разделе «Измерения по прогонам»: SVG-график по измерительному шагу текущей версии с полосой допуска, точки окрашены по вердикту, до 200 последних прогонов проекта. В подсказке точки — прогон, дата, сборка и прошивочный стек, клик открывает прогон. Шаги сопоставляются между версиями кейса по номеру шага.

Измерения с допуском и тренд в QA Деск
Числовой результат, прибор с поверкой и тренд по версиям прошивки: выход за допуск виден сразу.

Тот же тренд отдаёт API: GET /api/v1/workspaces/{ws}/projects/{project}/cases/{case}/measurements. Точка помнит вердикт по допуску своей версии кейса: одно и то же значение 82 °C будет провалом по старому «≤ 80» и успехом по новому «≤ 85».

Откуда взято число замера: испытатель, стенд или прибор?

QA Деск хранит рядом с числом результата шага его источник. «Введено вручную» — число набрал испытатель в кабинете, через API или MCP. «Из отчёта (CI / стенд)» — число принял приёмник отчётов: qadesk-cli, CI или доставка стенда в ручной прогон. Источник описывает текущее число: если испытатель поправил значение из отчёта, оно снова считается введённым вручную.

«С прибора» — число снял сам прибор командой qadesk-cli scpi, и вместе с ним сохранён ответ прибора на *IDN?.

Источник виден на строке прогона, в подсказке точки тренда, а в протоколе испытаний стоит под измеренным значением — ручной ввод подсвечен, чтобы читатель протокола отличал его от числа из лога стенда. Записи, сделанные до появления источника, помечены «источник не определён»: система не угадывает, кто их ввёл. Сам источник вердикт по допуску не меняет и не проверяет, что приложенный лог подтверждает число.

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

Как снять число с мультиметра или источника питания без скрипта?

Командой qadesk-cli scpi с версии 0.6.0. Утилита спрашивает прибор по сети через SCPI-сокет — порт 5025, у Rigol 5555 — и пишет файл *.qadesk.json, который уходит обычной загрузкой.

qadesk-cli scpi idn 192.168.1.50
qadesk-cli scpi read --profile bench.json --out out/bench.qadesk.json
qadesk-cli upload --format qadesk out/

Профиль стенда описывает приборы (адрес и серийный номер карточки средства измерений), кейсы и шаги: на каждый измерительный шаг — один запрос, например MEAS:VOLT:DC?. Утилита только спрашивает: запрос без «?» или цепочка через «;» отклоняется до подключения, прибором и стендом она не управляет.

Серийный номер из ответа прибора QA Деск сверяет с карточкой. Ответил другой прибор — число приписывается ему, а в ответе загрузки предупреждение; поверка истекла — число записано с отметкой «недостоверно». Перегрузка прибора (9.9E37) числом не становится: строка прогона помечается проваленной с пояснением. VXI-11, HiSLIP, USB и GPIB пока не поддержаны — для них значение отправляет свой скрипт в формате выше. Профиль подробно — на странице qadesk-cli, модели приборов с SCPI по сети — в разделе «Приборы и СИ».

Чего в этом разделе пока нет?

Статистики по трендам (перцентили, регрессия), нормирования по стенду и конвертации единиц нет. Версии прошивок кабинет с устройства не снимает — их передаёт CI через --stack после Redfish, IPMI или dmidecode на стенде. Планировщика запусков на стенде и бронирования стендов нет — стенд запускает CI или инженер стенда. Просмотрщика логов с поиском нет — только сводка и ссылка на файл.

Настройку приборов, сценарии измерений и опрос по USB, GPIB, VXI-11 qadesk-cli scpi не делает.

Документы для ОТК и заказчика — ПМИ и протокол испытаний, поверка средств измерений, подписи, отступления и несоответствия — описаны на странице «Протокол испытаний и ОТК».

Частые вопросы

Нужен ли отдельный тариф для тестирования железа?

Нет. Тип проекта «Железо и прошивки» доступен на всех тарифах, включая бесплатный Community. Устройства, прошивочный стек и измерения отдельно не тарифицируются — считаются только специалисты, наблюдатели бесплатны.

Можно ли отправить измерения без qadesk-cli?

Да. Отправьте тот же JSON запросом POST https://api.qadesk.ru/ingest/v1/qadesk с токеном приёма проекта в заголовке Authorization: Bearer. Версии стека передаются параметрами запроса stack=bios%3D1.2.3, имя прогона — параметром name.

Кто считает вердикт измерения — CI или QA Деск?

QA Деск. CI и утилита только сообщают число, сервер сравнивает его с допуском шага включительно по границам. Провал метрики валит строку прогона, даже если автотест прислал passed.

Что будет, если сменить тип проекта обратно на программный?

Ничего не удалится: модели, экземпляры, снимки стека и замеры останутся, а старые прогоны и дефекты продолжат показывать свои устройства. Закроется только новая запись в справочники. Вернёте тип — всё на месте.

Можно ли запустить один прогон сразу на нескольких экземплярах?

Нет, один старт — один экземпляр: прогон и его результаты относятся к конкретной железке. Проверка на трёх образцах — три старта из одного тест-плана; в матрице совместимости они сойдутся в строке своей модели.

Как попробовать на своём стенде

Заведите пространство и проект типа «Железо и прошивки» — бесплатный тариф без карты: до 5 специалистов, наблюдатели без лимита. Утилита для CI — на странице qadesk-cli. Нужно демо на ваших испытаниях — напишите на hello@qadesk.ru.

Создать пространство