Extractor Format
Требования к приборам и расходникам

Требования к приборам и расходникам

UID:
VERSION:
1
CLASSIFICATION:
PREFIX:
Type
Level
MID
UID
PREFIX
STATUS
CANCEL_REASON
TAGS
REFS
Title
Statement
Rationale
Comment
TEXT
e6ec74d3f7bf4262a8b6d14c9e7298d0

Различайте номинальное описание модели прибора и текущую конфигурацию физического экземпляра этой модели.
SECTION
1
ee5be565e1e34a1daf0f25c25d62c9d3
DEV-
Описание устройства
SECTION
1.1
074ff1913cbe4212a0c1524fddb71c72
DEV-
Описание модели
REQUIREMENT
1.1.1
bbbedf8cc9ed46e397c290fc8b34d10f
DEV-001
ACTIVE
DEV-001
Определение модели прибора

Описание модели прибора должно содержать:

  • ссылку на схему в объекте schema (as in 🔗 1. Версионирование схемы);
  • номер ревизии описания;
  • уникальный идентификатор модели (as in 🔗 FMT-001);
  • непустое название title;
  • непустой номер изделия part_number;
  • короткое описание модели;
  • список совместимых защитных колпачков supported_sleeves;
  • список совместимых планшетов supported_plates;
  • описание нагревателей;
  • описание двигателей;
  • описание посадочных мест;
  • список максимально поддерживаемых моделью capabilities.
REQUIREMENT
1.1.2
005634788668416ca2ade6f476d4864b
DEV-002
ACTIVE
DEV-002
Возможности модели прибора

Используйте в capabilities модели идентификаторы возможностей из [LINK: DEVICE-CAPABILITIES].
TEXT
fd9485d9259d46bfaa95c6708d044cea
DEVICE-CAPABILITIES
Avaliable tags
tag description g-codes
motion_absolute поддерживается движение осей в абсолютном режиме G0, G1
homing поддерживается уход в нулевую позицию G28
mixing_time поддерживается перемешивание по времени M56
mixing_cycles поддерживается перемешивание по количеству циклов M57
motion_configuration поддерживается управление скоростью перемещения M789
temperature_control поддерживается ручное управление нагревателем M104, M105
temperature_wait поддерживается ожидание достижения целевой температуры M109
sleeves_detection поддерживается проверка наличия защитных насадок M410, M411
offsets_configurations поддерживается работа с предустановленными наборами оффсетов M420
plate_detection поддерживается проверка наличия планшетов M600
uv_sterilization поддерживается УФ-стерилизация x
status_leds поддерживается управление RGB-светодиодами M300, M301, M302
notify_beeper поддерживается управление buzzer M500, M501
safety_interlocks поддерживается контроль двери, кнопки питания x
power_management поддерживается контроль цепей питания, управление питанием x
REQUIREMENT
1.1.3
d53d85ac12bf416aa394912a82e0cb75
DEV-003
ACTIVE
DEV-003
Двигатель модели прибора

Описание двигателя модели должно содержать:

  • код оси одной буквой;
  • название оси;
  • параметр микрошага;
  • минимальную и максимальную координату в мм (as in 🔗 UNIT-001);
  • минимальную и максимальную скорость в мм/мин (as in 🔗 UNIT-005).

Достаточное количество информации для преобразования в команды перемещения в формате G-Code
REQUIREMENT
1.1.4
9287696e90b249b9bc3c6379c26b4478
DEV-004
ACTIVE
DEV-004
Посадочное место модели прибора

Описание посадочного места должно содержать:

  • порядковый номер от 1 до 5;
  • координата в мм (as in 🔗 UNIT-001);
  • список capabilities;
  • если в capabilities указан heating, локальный heater_id нагревателя модели.
REQUIREMENT
1.1.5
3fa85807eae4413b80361b229309674b
DEV-005
ACTIVE
DEV-005
Возможности посадочного места модели

Описывайте возможности каждого места
TEXT
571458cf07cf42e3a0da98373a5cb9f2
SEAT-CAPABILITIES
Avaliable tags
tag description
heating доступен нагреватель
REQUIREMENT
1.1.6
6d55874d191c40b88784f1909a2b7296
DEV-006
ACTIVE
DEV-006
Нагреватель модели прибора

Описание нагревателя модели должно содержать:

  • локальный строковый id;
  • минимальную и максимальную температуру в градусах Цельсия (as in 🔗 UNIT-003).
SECTION
1.2
2c3cb3ef52f746d8b189d7acc60bffb2
DEV-
Описание экземпляра
REQUIREMENT
1.2.1
aa2dbea23b9e4e92b4957d61dbf7e47d
DEV-007
ACTIVE
DEV-007
Определение экземпляра прибора

Описание экземпляра прибора должно содержать:

  • ссылку на схему в объекте schema (as in 🔗 1. Версионирование схемы);
  • номер ревизии описания;
  • уникальный uid физического прибора (as in 🔗 FMT-001);
  • model_uid модели прибора;
  • непустой serial_number;
  • версии программного обеспечения и firmware;
  • оффсеты двигателей;
  • адреса нагревателей;
  • список фактически доступных capabilities.
REQUIREMENT
1.2.2
d611dbf830a24338aa69e112fceed394
DEV-008
ACTIVE
DEV-008
Ссылка экземпляра на модель

Связывайте экземпляр с моделью через model_uid в формате UUID. Ссылка должна указывать на существующее описание модели прибора.
REQUIREMENT
1.2.3
2a912ff37be44eb1ab39a27a1ddaf391
DEV-009
ACTIVE
DEV-009
Идентификация экземпляра

Храните uid экземпляра неизменным в течение срока службы прибора. Храните заводской серийный номер в непустом serial_number.
REQUIREMENT
1.2.4
a70e77b45d744d0b92070df4bee0c46a
DEV-010
ACTIVE
DEV-010
Версии программного обеспечения экземпляра

Указывайте текущие software_version и firmware_version экземпляра непустыми строками.
REQUIREMENT
1.2.5
7127be0418e14acca00d22a49063d70e
DEV-011
ACTIVE
DEV-011
Оффсеты двигателей экземпляра

Описывайте оффсет двигателя объектом с однобуквенным кодом axis и числовым offset_mm в миллиметрах. Код оси должен существовать в описании модели, а в одном описании экземпляра ось не должна повторяться.
REQUIREMENT
1.2.6
18dd1ab85ef04b9ebba9747d7a4fbf87
DEV-012
ACTIVE
DEV-012
Адреса нагревателей экземпляра

Связывайте адрес нагревателя с локальным heater_id из модели. Адрес должен быть целым числом от 1 до 255; heater_id и адрес не должны повторяться в одном описании экземпляра.
REQUIREMENT
1.2.7
03d125ee2b28453abfaca249e43f8415
DEV-013
ACTIVE
DEV-013
Возможности экземпляра

Используйте в capabilities экземпляра идентификаторы из 🔗 DEVICE-CAPABILITIES. Список описывает фактически доступную конфигурацию, а не временную работоспособность устройства.
REQUIREMENT
1.2.8
78588438662b405fb7852e2b089e4bb4
DEV-014
ACTIVE
DEV-014
Ограничение возможностей экземпляра

Каждая capability экземпляра должна присутствовать в capabilities связанной модели. Допускайте отсутствие у экземпляра части возможностей модели.
REQUIREMENT
1.2.9
7b23e98fa8da473cbedc60ad86ecd014
DEV-015
ACTIVE
DEV-015
Ревизия описания экземпляра

Увеличивайте revision описания экземпляра после изменения software, firmware, оффсетов, адресов нагревателей или фактически доступных capabilities.
REQUIREMENT
1.2.10
508f53d6c85b42aaad75b52e79d37ee0
DEV-016
ACTIVE
DEV-016
Экспорт описания экземпляра

Формат описания экземпляра должен позволять управляющему ПО экспортировать собственную идентичность и текущую конфигурацию без включения оперативного состояния, ошибок и измерений.
SECTION
2
113348dade094b0683405ff236eba744
LW-
Описание расходников
REQUIREMENT
2.1
42d8c04a44ab4e7ba4193da9b7e20535
LW-001
LW-001
Определение расходника

Описание расходника должно содержать объект schema со значениями:
REQUIREMENT
2.2
0cbc8446b4944dcf97271fc4ffed156d
LW-002
ACTIVE
LW-002
Совместимость расходников

Не храните в описании планшета список совместимых колпачков и не храните в описании гребёнки список совместимых планшетов.

Модель прибора должна определять допустимые планшеты и колпачки независимыми списками. Принадлежность расходников этим спискам является достаточной проверкой совместимости.
SECTION
2.3
9c88de3211874d1cbcfd93e34b6289b8
Описание планшетов
REQUIREMENT
2.3.1
2389632e70e4445f8f5e2ede7f972cc7
LW-003
ACTIVE
LW-003
Тип определения планшета

Описание планшета должно содержать объект schema со значениями:

Поле labware_kind должно иметь значение plate.
REQUIREMENT
2.3.2
4f427e84d30149f581c0820dfaa59a39
LW-004
ACTIVE
LW-004
Идентификация планшета

Описание планшета должно содержать:

  • неизменный между ревизиями uid в формате UUID (as in 🔗 FMT-001, 🔗 FMT-003);
  • целочисленный revision не меньше 1 (as in 🔗 FMT-004);
  • непустое название title.
REQUIREMENT
2.3.3
8a304fcd8c364dcbb7eba16a45ca1670
LW-005
ACTIVE
LW-005
Каталожные данные и тип упаковки планшета

Описание планшета должно содержать изготовителя manufacturer, каталожный номер catalog_number и тип упаковки package_type.

Неизвестное значение должно быть записано как null, а не как пустая строка или предполагаемое значение.
REQUIREMENT
2.3.4
b71368af007c4a718d8af96caaa3aa60
LW-006
ACTIVE
LW-006
Габариты планшета

Описание планшета должно содержать положительные габариты расходника width, depth и overall_height в объекте dimensions_mm (as in 🔗 UNIT-001).
REQUIREMENT
2.3.5
9b0d1a6e85224740ae90ab25fdafa5d1
LW-007
ACTIVE
LW-007
Сетка лунок планшета

Объект well_layout должен содержать положительные целые rows, columns и total_wells.

Количество лунок должно удовлетворять равенству rows * columns = total_wells.
REQUIREMENT
2.3.6
3cdcd787866748f182f1d9c3c0a6fec5
LW-008
ACTIVE
LW-008
Вертикальные границы лунки

Объект well должен содержать bottom_offset_mm и top_offset_mm — высоты внутреннего дна и верхней границы лунки в миллиметрах относительно поверхности, на которую установлен планшет (as in 🔗 UNIT-007).

Заданные значения должны быть конечными неотрицательными числами, причём bottom_offset_mm < top_offset_mm.
REQUIREMENT
2.3.7
de7a89765d70419ca2ff4ce3fb6a01d6
LW-009
ACTIVE
LW-009
Объёмы лунки

Объект well должен содержать объёмы на одну лунку в микролитрах (as in 🔗 UNIT-002):

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

Оба значения должны быть заданы числами, отличными от null, причём total_volume_ul > effective_volume_ul.
REQUIREMENT
2.3.8
db650b5d949c47a1ba830c88aa596ac3
LW-010
ACTIVE
LW-010
Применимость эффективного объёма

Значение effective_volume_ul не должно определять совместимость планшета и колпачка и не должно использоваться для расчёта уровня жидкости после погружения колпачка.

Значение должно быть безопасным для полного погружения любого защитного колпачка, совместимого с планшетом согласно модели прибора.
REQUIREMENT
2.3.9
8793ba2e725445a0aaea11086dae9694
LW-011
ACTIVE
LW-011
Incoming link from: 2.4.6. Расширения описания гребёнки
1
 Расширения описания планшета

Запрещайте неизвестные поля верхнего уровня и вложенных стандартных объектов.

Дополнительные данные разрешается хранить только в необязательном объекте extensions. Имя каждого расширения должно быть пространством имён из строчных латинских букв и цифр с разделителем ., _ или -; например, syntol.migration.source.
SECTION
2.3.10
8caa590ed59046999e2ecb9ec4a4b4c0
GEO-
Таблица объем-высота
REQUIREMENT
2.3.10.1
e587741773954818b9265a214c63ed1d
LW-012
ACTIVE
LW-012
Точки таблицы объём-высота

Массив liquid_height_curve.points должен содержать не менее двух объектов с конечными неотрицательными volume_ul и height_mm.

Точки должны быть расположены по строго возрастающему объёму и строго возрастающей высоте. Точку (0 uL, 0 mm) разрешается добавлять только при наличии подтверждённых измерений, что нулевая высота соответствует внутреннему дну лунки.
TEXT
15a180daec6941ac862e409865cf91d3

Допустимую погрешность высоты определите до приёмки справочников. Добавляйте точки около дна и переходов формы, если проверка выявляет недостаточную точность. Не добавляйте точку (0, 0) без подтверждения её применимости. GeoJSON не используется: пары описывают физическую зависимость, а не географические координаты. Исполнитель выполняет интерполяцию. Этот документ определяет её смысл и эталонные результаты.
REQUIREMENT
2.3.10.2
ee73f87793054b76b65cec947a984b55
GEO-001
ACTIVE
GEO-001
формат хранения

Храните зависимость высоты жидкости от объёма как массив пар в JSON.
REQUIREMENT
2.3.10.3
cc6d87db396a487f9dd14b5a80e8b256
GEO-002
ACTIVE
GEO-002
единицы измерения

Задавайте объём в микролитрах на одну лунку, а высоту в миллиметрах.
REQUIREMENT
9a314acbfad04affba2790900ababcf2
GEO-003
ACTIVE

Относите таблицу к лунке без погружённого колпачка.
REQUIREMENT
93ef03e77eea491385c0ed27ede53aa2
GEO-004
ACTIVE

Храните не менее двух точек с конечными неотрицательными значениями.
REQUIREMENT
89e473fdb3db4f72840646bceeab005c
GEO-005
ACTIVE

Располагайте точки по строго возрастающему объёму и строго возрастающей высоте.
SECTION
2.4
9e388b4fa6a64e57bd334f22f0b5baf8
Описание защитных колпачков
REQUIREMENT
2.4.1
d7e96b35fe404833aa46b4d38bf37e1c
LW-013
ACTIVE
LW-013
Тип определения гребёнки колпачков

Описание гребёнки защитных колпачков должно содержать:

  • объект schema с name: syntol.labware.sleeve-comb и положительной целочисленной ревизией revision (as in 🔗 1. Версионирование схемы);
  • labware_kind со значением sleeve_comb.
REQUIREMENT
2.4.2
078eb6211e48415498c38b572e552b92
LW-014
ACTIVE
LW-014
Идентификация гребёнки колпачков

Описание гребёнки должно содержать:

  • неизменный между ревизиями uid в формате UUID (as in 🔗 FMT-001, 🔗 FMT-003);
  • целочисленный revision не меньше 1 (as in 🔗 FMT-004);
  • непустое название title.
REQUIREMENT
2.4.3
f56a334638b943a5a53913fd6dd913a1
LW-015
ACTIVE
LW-015
Сведения о производителе и изделии колпачков

Описание гребёнки должно содержать изготовителя manufacturer и номер детали изготовителя mpn.

Неизвестное значение должно быть записано как null, а не как пустая строка или предполагаемое значение.
REQUIREMENT
2.4.4
32fed534602b40709341453560673299
LW-016
ACTIVE
LW-016
Сетка гребёнки колпачков

Описание гребёнки должно содержать положительные целые rows и columns.

Ряды возрастают вдоль ширины, столбцы — вдоль глубины гребёнки при виде сверху.
REQUIREMENT
2.4.5
89f2c47277c14fdbabe632663ecee5f2
LW-017
ACTIVE
LW-017
Геометрия колпачка

Описание гребёнки должно содержать положительные размеры в миллиметрах (as in 🔗 UNIT-001):

  • overall_height_mm — общую высоту гребёнки;
  • working_length_mm — длину рабочей части колпачка;
  • rod_diameter_mm — наружный диаметр погружаемой части.

Длина рабочей части не должна превышать общую высоту гребёнки.
REQUIREMENT
2.4.6
5344c689fe5f4bbc8554087919746a82
LW-018
ACTIVE
LW-018
Расширения описания гребёнки

Запрещайте неизвестные поля верхнего уровня.

Дополнительные данные разрешается хранить только в необязательном объекте extensions с именами в пространствах имён по правилу 🔗 2.3.9. Расширения описания планшета.