Monitors and anaesthesia machines (HL7)

Мониторы и наркозные аппараты (HL7)

Мониторы пациента и наркозные аппараты операционной передают показатели по сети по протоколу HL7 v2 (профиль IHE PCD-01, как у Mindray, Philips, Dräger, GE). Vidicap показывает ЧСС, SpO₂, давление, ЧД, EtCO₂, температуру, тренды и тревоги, а с наркозного аппарата ещё FiO₂, газы и параметры вентиляции.

Устройство само подключается к получателю по TCP (протокол MLLP) и раз в 10–60 секунд присылает результаты (ORU^R01), а тревоги сразу (ORU^R40). Получатель отвечает подтверждением (ACK) и слушает порт 2575.

Какой вариант выбрать

Мониторы реанимации и палат (вне операционных) подключаются к Vidicap Connect: см. «Vidicap Connect: мониторы отделений и передача данных в МИС».

Разбор HL7 у вариантов общий. ФИО, ID и дата рождения пациента не сохраняются ни в одном из них.

Перед началом: что подготовить

1. Сеть. Монитор и получатель (Vidicap или сервер) должны видеть друг друга по IP. Проще всего, когда они в одной сети (один коммутатор или VLAN). Если мониторы в отдельной сети мониторинга (сеть центральной станции), попросите ИТ-службу открыть доступ из неё на IP получателя по TCP-порту 2575 или подключите Vidicap к этой сети второй сетевой картой.
2. Постоянный IP получателя. Монитор хранит адрес получателя в своих настройках, поэтому IP Vidicap или сервера не должен меняться: попросите ИТ-службу закрепить адрес (резервирование DHCP) или задайте его вручную.
3. Адрес для монитора. На Vidicap он написан на экране «Настройки» → «Доп. модули» → «Показатели пациента» («В мониторе укажите: адрес …, порт 2575»), внизу экрана «Показатели пациента» и выводится командой vidicap-vitals show. Адрес сервера платформы указан в разделе «Новые устройства» на странице «Показатели пациента и устройства» точки.
4. Пароль сервисного меню Mindray. Сетевые настройки мониторов и наркозных аппаратов Mindray закрыты паролем техобслуживания (раздел «Обслуживание» / Maintenance или System). Пароль есть в сервисной документации аппарата или у сервисного инженера Mindray.
5. Сведения о пациенте на мониторе. Мониторы Mindray не отправляют данные, пока не заполнены обязательные поля пациента (у мониторов VS-серии это MRN). Vidicap эти поля не читает. Если в больнице не принято вводить пациента в монитор, впишите условное значение: в MRN номер операционной, в «Палата» её название, в «Кровать» 1.

Вариант 1: прямо на Vidicap

Шаг 1. Поставить модуль на Vidicap

Подходят Vidicap Touch 2.0 и Vidicap Touch 1.0 с программой 1.4.0 и новее. Vidicap Touch 1.0 сначала обновите: «Платформа» → «Программа устройства» → «Обновить программу».

1. Поставьте модуль «Показатели пациента (HL7)» с экрана Vidicap, как любой доп. модуль (пошагово и со скриншотами: «Дополнительные модули: установка с экрана Vidicap»): - устройство подключено к платформе (vidicap.cloud или сервер больницы): Vidicap Touch 2.0 «Настройки» → «Платформа», Vidicap Touch 1.0 кнопка «Платформа» → «Проверить обновления»; в блоке «Доп. модули» → «Показатели пациента (HL7)» → «Установить модуль» → подтвердить; - без платформы: скачайте vidicap-module-vitals-<версия>.zip на любом компьютере («Выпуски для устройств» → «Дополнительные модули»), положите на флешку, вставьте её в Vidicap и в том же блоке нажмите «Установить с флешки».

Порт 2575 в брандмауэре модуль откроет сам, если брандмауэр включён. 2. Нажмите «Перезагрузить устройство». В главном меню появится плитка «Показатели пациента». 3. Откройте её. Пока монитор не подключён, на экране написано «Ждём данные от мониторов… укажите адрес …, порт 2575». Запишите адрес: его нужно ввести в мониторе.

Для техников есть и установка из терминала (по SSH): unzip vidicap-module-vitals-<версия>.zip && sudo ./vidicap-module-vitals/install-module.sh, затем перезагрузка.

Проверка без монитора, прямо на Vidicap: vidicap-vitals send 127.0.0.1. Через несколько секунд на экране появятся показатели имитатора «MINDRAY_D1». Остановите имитатор (Ctrl+C): его значения посереют через 2 минуты и исчезнут через 10.

Шаг 2. Настроить монитор и наркозный аппарат

Укажите на каждом устройстве операционной IP Vidicap и порт 2575 (по моделям: раздел «Настройка устройств Mindray» ниже). Всё, что присылает данные на этот Vidicap, считается оборудованием его операционной: привязывать ничего не нужно.

Шаг 3. Проверить

• На экране «Показатели пациента» в списке «Устройства» появился монитор (зелёная точка, IP, «N с назад»), а сверху плитки с показателями.
• На мониторе в окне настройки HL7 «Connection Status: Connected» (VS-серия) или успешный «Test» (A9/A8).

Так выглядит экран, когда монитор на связи: сверху крупные значения, ниже тренды за 30 минут, 2 или 6 часов (коснитесь графика, чтобы увидеть значения в этот момент), справа тревоги и список устройств. Значения монитора, который замолчал, сереют через 2 минуты.

Чтобы врачи видели те же показатели в браузере с компьютера или планшета, поставьте ещё доп. модуль «Веб-доступ» (инструкция «Веб-доступ: платформа на самом Vidicap», раздел «Показатели пациента в браузере»). Нужны версии модулей 1.1.0 или новее. Как это выглядит в браузере и на телефоне, показано там же на скриншотах.

Настройки модуля на экране Vidicap

Порт, сеть мониторов, приём и названия приборов меняются прямо на экране, без терминала. Нужны доп. модуль «Показатели пациента» 1.2.0 и программа Vidicap Touch 2.0 2.17.0 или Vidicap Touch 1.0 1.21.0 (или новее).

1. Откройте «Настройки» (на Vidicap Touch 1.0 кнопка «Настройки» в главном меню). В группе «Доп. модули» слева нажмите « «Показатели пациента».

2. Слева, в блоке «В мониторе укажите», написаны адрес и порт: их вводят в мониторе и наркозном аппарате (шаг 2 выше). Точка в заголовке зелёная, когда Vidicap принимает данные; красная, когда приём выключен или порт занят другой программой.
3. При необходимости измените: - «Приём»: «Включён» или «Выключен». Когда приём выключен, плитка «Показатели пациента» исчезает из главного меню, а этот экран остаётся, чтобы приём можно было включить обратно; - «Порт»: обычно 2575. Если сменили, укажите тот же порт на всех мониторах; - «Сеть мониторов»: адреса или сети через запятую, например 10.20.0.0/16. Тогда Vidicap принимает данные только от приборов из этих сетей. Пустое поле: от любого прибора в сети Vidicap.
4. Нажмите «Сохранить». Vidicap сразу начинает принимать с новыми настройками, перезапуск не нужен. Если написано «порт занят другой программой», выберите другой порт.
5. Справа, в блоке «Приборы операционной», видны все приборы, которые прислали данные: зелёная точка, когда прибор на связи, модель, IP и когда он присылал данные последний раз. Чтобы медсёстрам было понятно, что есть что, нажмите «Назвать», введите название («Монитор у стола», «Наркозный аппарат») или выберите готовое и нажмите «Готово». Название видно и на экране «Показатели пациента». Прибор, который больше не присылает данные (серая точка), убирается кнопкой «Убрать».

Настройки, сделанные на экране, хранятся рядом с модулями (/opt/vidicap/modules/vitals.json) и не сбрасываются обновлениями. Если техник потом поменяет настройки командой ниже, действуют более новые.

Те же настройки из терминала (по SSH; после изменения перезапустите программу или перезагрузите Vidicap):

Всплывающие тревоги монитора

Когда монитор пациента или наркозный аппарат подаёт тревогу, она всплывает на экране Vidicap поверх любой страницы: главного меню, записи, трансляции, других модулей. Если подключён внешний монитор доп. модуля «Вывод видео», та же тревога всплывает и на нём, крупнее, вверху экрана, поверх любого изображения. Нужны доп. модуль «Показатели пациента» 1.6.0 и «Вывод видео» 1.1.0 (или новее); на сенсорном экране тревоги всплывают с версии 1.5.0.

1. Монитор присылает тревогу. На экране Vidicap открывается окно: приоритет и время сверху, параметр, значение крупно, что случилось («выше предела») и какой прибор («Монитор у стола», если прибор назван в настройках выше). Красная рамка: высокий приоритет, жёлтая: средний.

2. На внешнем мониторе та же тревога видна вверху экрана, без кнопок: видео под ней остаётся видно.

3. Нажмите «Понятно»: окно закроется на экране Vidicap и на внешнем мониторе. В шапке остаётся красная плашка «⚠ Тревоги: N», она открывает экран «Показатели пациента» со списком тревог (на самом этом экране плашки нет). Тревога уходит с плашки, когда монитор присылает её конец; монитор, который конец не присылает (Mindray), повторяет тревогу, пока она идёт, и тогда тревога уходит через минуту после последнего повтора (модуль 1.7.1 и новее). Кнопка «Показатели пациента» сразу открывает экран модуля.
4. Окно закрывается само, когда монитор присылает конец тревоги. Тревога среднего приоритета закрывается через 30 секунд. Та же тревога в течение 2 минут после «Понятно» окно не открывает, только увеличивает счётчик.

5. Какие тревоги всплывают, выбирается в настройках модуля (выше), пункт «Всплывающие тревоги»: «Высокие и средние» (так по умолчанию), «Только высокие» или «Выкл.». Тревоги низкого приоритета и сообщения монитора не всплывают, они видны в списке тревог.

6. Проверить окно без монитора: «Настройки» → «Показатели пациента» → «Проверить тревогу» (модуль 1.7.0 или новее). Поверх экрана всплывёт тревога «SpO₂ ниже предела» с пометкой «Проверка: тревога не настоящая». В список «Тревоги» она не попадает и на платформу не уходит. Рядом с кнопкой написана версия модуля.

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

Приборы Vidicap на платформе

Если Vidicap с модулем «Показатели пациента» подключён к платформе (vidicap.cloud или сервер больницы), его мониторы и наркозные аппараты видны и там. Ничего настраивать не нужно: нужны модуль «Показатели пациента» 1.4.0 и новее и агент 1.39.0 и новее (оба приходят обновлением). Если к Vidicap не подключён ни один прибор, на платформе ничего не появляется.

Где смотреть:

1. Страница управления точкой и «Журнал устройства»: раздел «Приборы HL7 этого Vidicap». Для каждого прибора: название (как его назвали в настройках модуля на Vidicap), модель, на связи он или молчит, когда пришло последнее сообщение, какие показатели приходят и IP-адрес. Ниже строка приёма: включён ли он, порт, разрешённые сети, версия модуля. В сводке устройства строка «Приборы HL7: 2 на связи · 1 молчит».

В журнале событий отмечается, когда прибор подключился, перестал присылать данные (больше двух минут) и снова вышел на связь.

2. Трансляция: сразу под видео раздел «Показатели пациента». В нём живые цифры (ЧСС, SpO₂, давление, ЧД, EtCO₂, температура), тренды за 10, 20 или 30 минут (кнопки над графиком, можно и 2 или 6 часов), тревоги, другие параметры и список приборов: какой на связи, какой молчит и когда пришло последнее сообщение. На телефоне раздел идёт сразу после видео, до чата.

3. «Показатели пациента» (ссылка «все показатели и тревоги»): то же на отдельной странице, с крупным графиком. Тренды за 10, 20, 30 минут, 2 или 6 часов; на сервере больницы ещё и за сутки.

Что передаётся и что нет. С Vidicap уходят только название и модель прибора, его IP-адрес, список показателей, их значения, графики и тревоги. ФИО, ID, дата рождения, номер палаты и кровати с монитора никогда не передаются: модуль убирает их ещё на Vidicap, платформа ещё раз проверяет каждое поле.

В облаке vidicap.cloud значения передаются, только пока кто-то смотрит трансляцию или страницу показателей этой точки. В облаке они не хранятся: держатся в памяти, пока страница открыта, и стираются через минуту после того, как её закрыли. Графики приходят с Vidicap (он хранит последние 6 часов, по точке в минуту). Пока страница открыта, облако добавляет к ним значения каждые 3 секунды за последние 30 минут, поэтому на трендах за 10–30 минут видна каждая точка, а не одна в минуту.

На сервере больницы значения приходят всегда и хранятся как от своих мониторов: 30 дней, не чаще одного значения в 15 секунд на параметр. Для этого Vidicap Connect не нужен. Если на сервере есть Vidicap Connect, эти значения и тревоги можно передавать дальше по HL7 в МИС или архив: у получателя Connect отметьте «Операционные: мониторы через Vidicap» (см. «Vidicap Connect», шаг 5).

Кто видит. Показатели видят пользователи, которым разрешено смотреть трансляцию этой точки. Гости по ссылке их не видят. Раздел «Приборы HL7 этого Vidicap» видят владельцы точки и администраторы. Переименовать или отвязать такой прибор на платформе нельзя: название задаётся на Vidicap («Настройки» → «Доп. модули» → «Показатели пациента»).

Понятные названия параметров

Параметры без своей плитки показываются в «Других параметрах» понятными словами на языке программы, а не кодами монитора: например, «Желудочковые экстрасистолы, в мин» вместо ECG V P C RATE, «Рост» вместо LEN BODY ACTUAL, «Вес» вместо MASS BODY ACTUAL, «Индекс перфузии» вместо PI. Так же они названы на платформе. Параметр, которого Vidicap ещё не знает, показывается под названием из монитора.

Вариант 2: на сервере больницы с Vidicap Connect

• На сервере больницы приём HL7 — часть Vidicap Connect: служба работает, только если на сервере включён Connect (VIDICAP_ROLES=platform,connect в deploy/.env, см. «Vidicap Connect»). На серверах, установленных раньше (строки VIDICAP_ROLES нет), Connect включён сам, и приём HL7 продолжает работать. Если задано VIDICAP_ROLES=platform, сервер HL7 не принимает; на самом Vidicap модуль «Показатели пациента» работает без Connect.
• Работает только в локальной версии платформы: данные пациента не покидают больницу и в vidicap.cloud не передаются.
• Показатели хранятся 30 дней (VIDICAP_HL7_KEEP_DAYS), не чаще одного значения в 15 секунд на параметр.
• Видят их только владельцы точки и администраторы организации. Зрители трансляции и гости не видят.
• Передать показатели, тревоги и кривые операционных дальше по HL7 (в МИС, ЛИС, архив), в том числе архив за период: у получателя Connect отметьте «Операционные: мониторы, подключённые к серверу» (см. «Vidicap Connect», шаг 5).

Шаг 1. Проверить службу на сервере

Служба hl7 входит в локальную версию и запускается вместе с платформой; принимает данные, если включён Connect.

cd deploy
docker compose ps hl7               # состояние running
docker compose logs --tail 20 hl7   # строка «HL7 listener on 0.0.0.0:2575»

Если брандмауэр сервера включён, откройте порт: sudo ufw allow 2575/tcp. Чтобы принимать данные только из сети мониторов, задайте её в deploy/.env: VIDICAP_HL7_ALLOWED=10.20.0.0/16, затем docker compose up -d hl7.

Шаг 2. Настроить устройства

На каждом мониторе и наркозном аппарате укажите IP сервера и порт 2575 (раздел «Настройка устройств Mindray» ниже). В полях «Палата» и «Кровать» впишите название операционной: по ним проще узнать устройство при привязке.

Шаг 3. Привязать устройство к операционной

1. Откройте «Устройства» → устройство → вкладка «Подключения» → «Показатели пациента и устройства».
2. В разделе «Новые устройства» появится монитор: программа (например MINDRAY_VS900), серийный номер, место (палата и кровать из настроек монитора), IP и текущие значения.
3. Нажмите «Привязать к этой операционной». С этого момента показатели сохраняются и видны на странице точки. Привязывают администраторы организации и платформы.
4. Задайте понятное название («Монитор анестезиолога»). Отвязанное устройство перестаёт сохранять данные, накопленные показатели остаются.

Шаг 4. Смотреть показатели

На странице «Показатели пациента» точки видны последние значения крупными плитками, графики за 10, 20, 30 минут, 2 часа, 6 часов или сутки, тревоги монитора и другие параметры. Наведите или нажмите на график, чтобы увидеть значения в это время.

Проверка без монитора: docker compose exec hl7 python manage.py hl7 send 127.0.0.1 --bed OR-1. Имитатор печатает ответы сервера: MSA|AA|… значит, что сообщение принято.

Настройка устройств Mindray

Названия пунктов меню зависят от модели и версии программы аппарата; ниже они взяты из интерфейсных руководств Mindray. Если пункта нет, ищите в сетевых настройках раздел «HL7», «EMR», «DOC» или «Data Export».

Мониторы VS-серии (VS 8 / VS 9 / VS-900, Accutorr 7)

1. «Главное меню» → «Обслуживание» (Maintenance) → пароль → Network Setup.
2. Data Send Method: HL7.
3. EMR Communication >>: заполните по таблице ниже и нажмите Ok. Внизу окна должно появиться Connection Status: Connected.
4. Alarm Server Setup >>: тот же IP и порт 2575, Ok. Тогда тревоги приходят сразу, а не раз в 30 секунд.
5. ADT Communication >> не трогайте: Vidicap не отвечает на запросы о пациенте.
6. Сведения о пациенте (Patient Demographics): заполните обязательное поле *MRN (можно номер операционной), Room No. и Bed No. Без MRN монитор данные не шлёт.

Наркозные аппараты A9 / A8

1. «Меню» → System → пароль → вкладка Network.
2. Подвкладка Ethernet1: задайте аппарату IP, маску и шлюз в той же сети, что Vidicap или сервер (если это ещё не сделано).
3. Подвкладка HL7, блок Data+Waveforms: заполните по таблице ниже и нажмите Test, проверка должна пройти успешно.
4. Блок Alarms на той же подвкладке: тот же Destination IP, Port 2575, Test. Включите Send Alarms.
5. Подвкладка SNTP (необязательно): сервер времени больницы, чтобы часы аппарата совпадали с остальными.
6. Сведения о пациенте (Patient Information): на вкладке Location впишите палату и кровать (операционную), на вкладке Patient достаточно условного Patient ID.

Аппарат держит одно сетевое подключение HL7: если раньше он слал данные в другую систему (МИС, центральную станцию), после настройки он будет слать только на новый адрес. Последовательный порт (RS-232, HL7 MR-Link) можно оставить другой системе.

Мониторы BeneVision, ePM, uMEC, iMEC

«Главное меню» → «Обслуживание» → пароль → «Сеть» (Network Setup) → «HL7» / «Сервер EMR» (по-английски HL7 Setup или EMR Server): IP Vidicap или сервера, порт 2575, интервал 30 с; отправку тревог включите на тот же адрес. Если монитор подключён к центральной станции Mindray (CMS), его данные удобнее брать с eGateway (ниже).

Центральная станция Mindray eGateway / CMS (только вариант 2)

Одна станция собирает данные со многих коек, поэтому её подключают к серверу платформы, а не к Vidicap.

1. В программе eGateway: меню mindray → Configure… → пароль.
2. Вкладка Result: добавьте канал (их до четырёх) в режиме Unsolicited Client (станция сама подключается к серверу), адрес сервера платформы, порт 2575, интервал 30 с.
3. Вкладка Alert (если есть): канал на тот же адрес и порт.
4. На странице точки в «Новых устройствах» появятся койки станции: привяжите каждую к своей операционной.

Аппараты ИВЛ Mindray SV-серии

Отдают данные только по своему протоколу через RS-232, не по HL7. В этот модуль они пока не входят.

Другие производители

Ищите в сетевых настройках «HL7 export», «DOC», «EMR/CIS»: протокол MLLP по TCP, IP Vidicap или сервера, порт 2575. Коды параметров IEEE 11073 (MDC) и LOINC распознаются автоматически, остальные показываются под своими названиями в «Других параметрах».

Что приходит и как показывается

• Плитки: ЧСС, SpO₂, ИАД, НИАД, пульс, ЧД, EtCO₂, температура, FiO₂.
• Тренды как в наркозной карте: давление и ЧСС на одной шкале (ИАД полосой между систолическим и диастолическим, НИАД значками ▼▲ на каждое измерение), отдельно SpO₂, EtCO₂ с ЧД и температура. Коснитесь графика (на платформе наведите мышь), чтобы увидеть значения на это время.
• «Другие параметры»: всё остальное (Ppeak, PEEP, MV, Vte, газы, BIS, режим ИВЛ). Значения, заданные на аппарате, помечены «уст.».
• Если монитор настроен на кПа, давление и EtCO₂ пересчитываются в мм рт. ст. Если EtCO₂ приходит в %, а FiO₂ в мм рт. ст., значение показывается в «Других параметрах» в единицах монитора.
• Серые значения: устройство больше двух минут ничего не присылало.

Коды параметров и тревог сверены с «eGateway HL7 Reference Manual» Mindray (v30, 2024).

Неполадки

Настройки службы на сервере (deploy/.env): VIDICAP_ROLES (приём HL7 только с connect), VIDICAP_HL7_PORT, VIDICAP_HL7_ALLOWED (сети, например 10.20.0.0/16), VIDICAP_HL7_KEEP_DAYS.

← Electrosurgery (add-on module, Mindray energy platform) Vidicap Connect: ward monitors and data transfer to the HIS →