Skip to content

Technician manual — uMe vital signs on-device (preview)

Status as of 04.11.2026, package vitals/ in the repository ume-eyes, version 0.4.0 (preview, UME-297). Draft — not yet released. The package is in development, not yet adopted and not yet installed on any device. It has not been tested with a real camera, real measuring devices or people. The page follows in German, French, Spanish, Italian and Dutch below: Deutsch · Français · Español · Italiano · Nederlands. Related pages: Operating guide and Interfaces — uMe vital signs on-device.

For IT, technicians and integration partners

Technical reference for IT departments, URG technicians and trained partners. It is not written as operating instructions for end users.

Demonstration – not a medical device. No diagnosis.

The software shows values for demonstration only. It assesses nothing. The accuracy of pulse and breathing rate from the camera has not yet been checked on people.

Booth operation at MEDICA: camera only

At the MEDICA booth only pulse and breathing rate from the camera are measured, locally on the device; SpO₂, blood pressure and body temperature are not measured or displayed. The Bluetooth LE devices are prepared in the code but switched off by configuration (no address in ble); the page then shows no device fields. The stand staff press "New person" at every change of visitor (mandatory). Images and values stay on the device.

1 Overview

Part Task
Camera source USB webcam at the monitor computer (default), ROS 2 camera topic (read only) or simulator
Signal processing face detection, measuring areas forehead and cheeks, pulse and breathing rate (rPPG, methods POS or CHROM), signal quality
Bluetooth LE receiver values of CE-marked devices with Bluetooth LE standard profile: pulse oximeter (0x1822), upper-arm blood pressure monitor (0x1810), contactless forehead thermometer (0x1809; °C with one decimal, no fever assessment)
Display full-screen web page, served only on 127.0.0.1, six languages (DE, EN, FR, ES, IT, NL)

The package has no interface to speech output, the uMe Eyes relay service or any cloud. It sends nothing over ROS, writes nothing to the measuring devices and has no access to drive or motion functions of the robot.

2 Data protection (G-02a)

Rule Implementation
No image and no value leaves the device Display only on 127.0.0.1 (no setting for another address); network guard in the process (section 7); no network libraries in the code
No storage no file, no database, no browser storage; each camera frame is reduced to three mean values; HTTP responses with Cache-Control: no-store
No logging of values or images the log contains only fixed status messages without values
No personal data face detection returns only a rectangle; user ID and time stamp sent by the devices are read but never kept
End of session clears everything buttons or endpoints "End session" and "New person", time-out (60 s without a face and without a valid device value), maximum duration (120 s, hard limit), change of person (see "Change of person" in section 6): fields empty, ring buffers overwritten with zeros, display empty; outdated estimates are discarded
No value for the next person device values are cleared after 20 s without a face, as soon as there has been no device message for 30 s; camera values are cleared 2 s after the last image; after a device connects, only its newest value is shown (section 6)
No assessment no traffic-light colours, no normal ranges, no assessing words; the device bits "irregular pulse" and "pulse range" are not evaluated

Limit: Python releases intermediate values after use (for example the JSON response) but does not overwrite that memory. The ring buffers of the measuring chain are overwritten; the session fields are set to empty. After the process ends nothing remains.

3 Installation

Requirements: Python 3.12, a working copy of ume-eyes with the adopted version under %USERPROFILE%\dev\ume-eyes. Internet is needed once for the installation; in measuring mode everything runs without a network. All commands: PowerShell, no admin.

cd $env:USERPROFILE\dev\ume-eyes\vitals
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -v

All packages are pinned exactly (==) in requirements.txt (operation) and requirements-dev.txt (tests only); the reasons are in vitals/ABHAENGIGKEITEN.md. None loads models or data at run time, none sends telemetry.

Package Version Purpose
numpy 2.5.4 signal processing
opencv-python-headless 4.14.0.94 read the webcam, face detection with the face model included in the package (no download)
bleak 3.0.2 Bluetooth LE: connect to the configured devices, receive measurements
winrt-runtime, winrt-Windows.* 4.1.0 / 4!10.0.28000.2957 Windows only: bridge to the Bluetooth interface of Windows
dbus-fast 5.2.0 Linux only: bridge to the Bluetooth stack over the local D-Bus
pytest 9.2.0 tests only

Licence note: the software is not passed on to customers. The OpenCV package includes the FFmpeg library under the GNU LGPL 2.1; this is recorded in NOTICE and the licence texts in LICENSES/ of the package. The obligations of the LGPL apply only if the package is passed on.

Linux (perception board, Bash, no sudo): python3.12 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt. ROS 2 (rclpy) comes from the ROS installation, not from requirements.txt; create the venv with --system-site-packages in that case. Not tested under Linux.

4 Configuration vitals.json

File %USERPROFILE%\.ume-vitals\vitals.json (outside the repository; template vitals/vitals.beispiel.json). If it is missing, the defaults apply without measuring devices. Another file can be given with --konfig. Unknown entries and values outside the ranges below are refused with an error message.

Entry Default Meaning
quelle webcam webcam, ros or simulator (the start option --quelle takes precedence)
kamera_index 0 number of the USB webcam, integer 0–9
ros_thema /ume/camera/color/image_raw camera topic (read only), must start with /
verfahren pos pos or chrom
fenster_s 15 pulse window, 10–20 s
atem_fenster_s 20 breathing window, 15–60 s
qualitaet_schwelle_db null minimum signal quality (whitened SNR) for a pulse value; null = default of the method (POS 1 dB, CHROM 2.5 dB), otherwise 0 to 20 dB
stabil_anzahl 3 number of consecutive estimates above the threshold before a camera value appears, 1–10
stabil_toleranz_bpm 5 all these pulse estimates must lie within ± this value around their median, 1–20 /min
stabil_toleranz_atem 3 the same for the breathing rate, 1–10 /min
sitzung_timeout_s 60 end of session without a face and without a valid device value, 10–600 s
max_sitzung_s 120 maximum duration of a session from the first activity, 30–900 s
ohne_gesicht_leeren_s 20 clear device values when there has been no face in the image for this long, 5–120 s
personenwechsel_s 15 after this long without a face (and without a device measurement, see geraet_nachlauf_s), a new face counts as a new person, 5–120 s
geraet_nachlauf_s 30 for this long after the last device message, a device measurement counts as ongoing: no change of person, no clearing without a face, 10–300 s
port 8790 port of the display on 127.0.0.1, 1024–65535
ble_schwall_s 3 after connecting, collect blood pressure and temperature packets for this long (and until 1 s of silence) and show only the newest, 0.5–10 s
ble.pulsoximeter, ble.blutdruck, ble.thermometer empty Bluetooth address of the previously paired device (format AA:BB:CC:DD:EE:FF); empty = device not used

There is deliberately no entry for a server address.

5 Start

PowerShell, no admin. The console shows the display address and the process ID (for the network capture). Stop with Ctrl+C; the session is cleared. Once per second a watchdog checks the session times and restarts a camera source that has stopped.

Between restart attempts of the camera source the watchdog waits 1, 2, 4, 8 and 16 s, then 30 s each time; when the source runs again, it starts again at 1 s.

Only this package for the vital signs measurement

Start only this package for the vital signs measurement at the booth; the previous vital signs detection of ume_main is not used there.

Simulator (without camera; by default camera measurement only, with --mit-geraeten also simulated pulse oximeter, blood pressure and temperature values; the page visibly shows "Simulation – no real measurements"):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle simulator

USB webcam (default):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle webcam

ROS camera topic (on the perception board, Bash, ROS environment loaded). The source starts only when ROS is limited to the device (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST or ROS_LOCALHOST_ONLY=1); otherwise the program ends with "Nicht verfügbar: ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1 fehlt":

cd "$HOME/ume-eyes/vitals"
ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ROS_LOCALHOST_ONLY=1 .venv/bin/python -m ume_vitals --quelle ros

The camera must then publish on the same device with the same setting, otherwise no images arrive.

Display in full screen (second PowerShell, no admin). --inprivate: no history and no cache beyond the window; --disable-features=Translate: no translation offers (a translation would send the page text to a service). Check the switches on the installed browser version before the acceptance:

cd $env:USERPROFILE
Start-Process msedge.exe -ArgumentList '--kiosk http://127.0.0.1:8790/ --edge-kiosk-type=fullscreen --inprivate --disable-features=Translate --no-first-run'

If the chosen source is not available (for example ROS 2 missing), the program ends with "Nicht verfügbar: …" and return code 2.

6 Pairing the Bluetooth LE devices

Not used in MEDICA operation

At the MEDICA booth no measuring devices are used; this section applies only to a later operation with devices.

Only devices with the Bluetooth LE standard profile are supported: CE-marked pulse oximeter (Pulse Oximeter Service 0x1822), CE-marked upper-arm blood pressure monitor (Blood Pressure Service 0x1810), CE-marked contactless forehead thermometer (Health Thermometer Service 0x1809).

  1. Before first use, check with a Bluetooth LE scanner app that the device offers service 0x1822, 0x1810 or 0x1809. A device without the standard profile cannot be used.
  2. Pair the device in the operating system (Windows: Settings › Bluetooth & devices; Linux: the Bluetooth tools of the system), following the instructions for use of the device. Some devices accept only one paired receiver at a time — pairing with another receiver ends the first pairing.
  3. Enter the Bluetooth address of the device in vitals.json under ble.pulsoximeter, ble.blutdruck or ble.thermometer. Addresses are site data — do not put them in tickets, documents or repositories.
  4. Restart the program. It connects only to the configured addresses, subscribes to the measurement characteristics (section 3 of the interface page) and reconnects every 5 s if the connection is lost. There is no device search for other devices.
  5. Test with one measurement: the value must appear on the display after the device has finished.

Burst after connecting. Many blood pressure monitors and thermometers connect only after the measurement, send at once (often stored older measurements first, then the current one, usually with a device time stamp) and disconnect. Therefore, after every connection, the package collects blood pressure and temperature packets until ble_schwall_s (3 s) has passed and nothing has arrived for 1 s (at most 9 s), or until the device disconnects, and shows only the newest: by device time stamp if all packets carry one, otherwise the one received last. Single packets arriving after that are shown at once. Device time stamps are no longer discarded. Limit: if the current measurement fails on the device (no new value), the newest packet is an older measurement and is shown — check at the acceptance with the chosen device whether this occurs. If the device clock is wrong, the order by time stamp is wrong. The pulse oximeter is not affected (it marks stored data itself).

Change of person. Face detection finds frontal faces only; someone looking at the arm during a blood pressure measurement is "no face" for the camera. A new face therefore only counts as a new person (new session, all values empty) when (1) there has been no face for at least personenwechsel_s (15 s), (2) no valid device value has arrived since the face was lost and (3) the last device message (including "measuring") is at least geraet_nachlauf_s (30 s) ago. Device values without a face are only cleared after ohne_gesicht_leeren_s (20 s) and only if there has also been no device message for 30 s. The maximum duration max_sitzung_s (120 s) remains a hard limit. For an immediate change there is the button "New person". Consequence: if someone else sits down within 30 s after a device measurement, the values stay until the maximum duration ends or the stand staff press "New person" — brief the stand staff accordingly. At the booth, pressing "New person" at every change of visitor is mandatory; the automatic detection is only a fallback.

Clock on the device. Some blood pressure monitors expect the receiver to write the time after connecting (Date Time 0x2A08 or Current Time Service 0x1805) and otherwise do not measure or send. The package deliberately writes nothing to devices (read only). Check this at the acceptance with the chosen device; if it needs the time, that is a separate step that needs approval.

7 Network capture for acceptance

Network guard in the process. When measuring mode starts, the program blocks every connection to addresses other than 127.0.0.0/8, ::1, localhost and local Unix sockets (local D-Bus for Bluetooth under Linux) before a packet is sent, including name resolution. The log then shows "Verbindung nach außen abgelehnt" (without the address).

For the acceptance, two proofs are recorded during the measurements (a capture of the whole computer also contains traffic of other programs, for example Windows and the browser):

  1. Connections of the vital signs process (PowerShell, no admin; stop with Ctrl+C). Shows every connection of the process that does not go to 127.0.0.1 or ::1 — no line is expected:

    cd $env:USERPROFILE
    $ids = (Get-CimInstance Win32_Process -Filter "Name = 'python.exe'" | Where-Object { $_.CommandLine -like '*-m ume_vitals*' }).ProcessId
    while ($true) { Get-NetTCPConnection -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess -and $_.RemoteAddress -notin @('127.0.0.1', '::1', '0.0.0.0', '::') } | Format-Table -AutoSize; Get-NetUDPEndpoint -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess } | Format-Table -AutoSize; Start-Sleep -Seconds 1 }
    
  2. Capture of the whole computer with pktmon (PowerShell as administrator; check the syntax with pktmon help before the acceptance):

    cd $env:USERPROFILE
    pktmon filter remove
    pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etl
    

    Carry out the measurements, then:

    cd $env:USERPROFILE
    pktmon stop
    pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapng
    

    Open the .pcapng file in a network analyser and filter for traffic not to the loopback addresses (!(ip.addr == 127.0.0.0/8) && !(ipv6.addr == ::1)); assign every connection found to the vital signs process with proof 1, or rule it out.

Linux (perception board, Bash with sudo):

cd "$HOME"
sudo tcpdump -i any -n -w "$HOME/vitals-mitschnitt.pcap" 'not (net 127.0.0.0/8 or ip6 host ::1)'

Afterwards sudo tcpdump -n -r "$HOME/vitals-mitschnitt.pcap" and ss -tunap | grep python.

Treat capture files like measurement data: do not pass them on, remove them after the evaluation.

8 Limits of this state

  • Accuracy not checked on people. All tests run with synthetic signals, mock-ups and the simulator; no real camera, no real measuring device, no person.
  • The quality thresholds (pulse: whitened SNR, default POS 1 dB, CHROM 2.5 dB; breathing 3 dB in the breathing band and 25 dB above the noise floor) were derived from synthetic signals. Whether they fit real cameras is open; the pulse threshold can be set in vitals.json. With slow drift POS delivered fewer pulse values in the synthetic tests than before; CHROM is weak with drift and is not recommended for the booth.
  • ROS network (DDS). The network guard works on the Python level only; ROS 2 opens its sockets outside Python. The ROS source therefore starts only in a ROS environment limited to the device (section 5). Which ROS version runs on the perception board and whether the camera topic is available locally there is still being clarified.
  • Linux, the perception board and ROS 2 are not installed and not tested.
  • Stability rule: a camera value appears only when stabil_anzahl (3) consecutive estimates (one per second) lie above the threshold and within ± stabil_toleranz_bpm (5 /min; breathing ± stabil_toleranz_atem, 3 /min) around their median; the median is shown. An estimate below the threshold or an outlier removes the value again. In synthetic tests with 8000 noise runs, POS still gave two and CHROM one wrong value with this rule.
  • The behaviour of the chosen measuring devices when connecting (burst, stored measurements, time stamp, clock, failed measurement) has to be checked at the acceptance (section 6).
  • Automatic exposure and white balance of the webcam can distort the measurement; they are not switched off (depends on the camera).
  • Face detection finds frontal faces only; glasses, masks, backlight and a dark booth make detection worse.
  • The browser at the monitor computer is not part of this package; assess its own traffic in the capture.

9 Tests

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m pytest -v

Covered: pulse and breathing rate with synthetic signals (POS and CHROM), no value with noise (including 1/f² noise), too short a window or without a face, Bluetooth LE parser with packets built according to the specification (including body temperature), stored measurements, sensor status, ranges and time stamps, no outgoing connection in measuring mode, display only on 127.0.0.1, end of session, maximum duration and change of person clear everything, log without values, ROS source only when limited to the device, device values at the display interface ≤ 5 s after the end of the measurement (simulator). State 04.11.2026: 419 tests passed (Windows, Python 3.12.10).


Technikerhandbuch — uMe Vitalmessung on-device (Vorschau)

Stand 04.11.2026, Paket vitals/ im Repository ume-eyes, Fassung 0.4.0 (Vorschau, UME-297). Entwurf — noch nicht freigegeben. Das Paket ist in Entwicklung, noch nicht übernommen und auf keinem Gerät eingespielt. Es ist nicht mit einer echten Kamera, echten Messgeräten oder Personen geprüft.

Für IT, Techniker und Integrationspartner

Technische Referenz für IT-Abteilungen, URG-Techniker und geschulte Partner. Keine Bedienungsanleitung für Endanwender.

Demonstration – kein Medizinprodukt. Keine Diagnose.

Die Software zeigt Werte nur zur Vorführung an. Sie bewertet nichts. Die Genauigkeit von Puls und Atemfrequenz aus der Kamera ist an Menschen noch nicht geprüft.

Standbetrieb auf der MEDICA: nur Kamera

Am Stand auf der MEDICA werden nur Puls und Atemfrequenz aus der Kamera gemessen, lokal auf dem Gerät; SpO₂, Blutdruck und Körpertemperatur werden nicht gemessen und nicht angezeigt. Die Bluetooth-LE-Geräte sind im Code vorbereitet, aber per Konfiguration abgeschaltet (keine Adresse unter ble); die Seite zeigt dann keine Gerätefelder. Das Standpersonal drückt bei jedem Besucherwechsel „Neue Person“ (Pflicht). Bilder und Werte bleiben auf dem Gerät.

1 Überblick

Teil Aufgabe
Kameraquelle USB-Webcam am Monitorrechner (Vorgabe), ROS-2-Kamerathema (nur lesen) oder Simulator
Signalverarbeitung Gesichtserkennung, Messflächen Stirn und Wangen, Puls und Atemfrequenz (rPPG, Verfahren POS oder CHROM), Signalqualität
Bluetooth-LE-Empfang Werte CE-gekennzeichneter Geräte mit Bluetooth-LE-Standardprofil: Pulsoximeter (0x1822), Oberarm-Blutdruckmessgerät (0x1810), kontaktloses Stirnthermometer (0x1809; °C mit einer Nachkommastelle, keine Fieberbewertung)
Anzeige Vollbild-Webseite, nur auf 127.0.0.1, sechs Sprachen (DE, EN, FR, ES, IT, NL)

Das Paket hat keine Schnittstelle zur Sprachausgabe, zum Vermittlungsdienst von uMe Eyes oder zu einer Cloud. Es sendet nichts über ROS, schreibt nichts an die Messgeräte und hat keinen Zugriff auf Fahr- oder Bewegungsfunktionen des Roboters.

2 Datenschutz (G-02a)

Regel Umsetzung
Kein Bild und kein Wert verlässt das Gerät Anzeige nur auf 127.0.0.1 (keine Einstellung für eine andere Adresse); Netzschutz im Prozess (Abschnitt 7); keine Netzwerk-Bibliotheken im Code
Keine Speicherung keine Datei, keine Datenbank, kein Browser-Speicher; jedes Kamerabild wird auf drei Mittelwerte verdichtet; HTTP-Antworten mit Cache-Control: no-store
Kein Logging von Werten oder Bildern das Protokoll enthält nur feste Zustandsmeldungen ohne Werte
Keine Personendaten die Gesichtserkennung liefert nur ein Rechteck; Benutzer-ID und Zeitstempel der Geräte werden gelesen, aber nie gehalten
Sitzungsende leert alles Tasten bzw. Endpunkte „Sitzung beenden“ und „Neue Person“, Zeitüberschreitung (60 s ohne Gesicht und ohne gültigen Gerätewert), Höchstdauer (120 s, harte Grenze), Personenwechsel (siehe „Personenwechsel“ in Abschnitt 6): Felder leer, Ringpuffer mit Nullen überschrieben, Anzeige leer; veraltete Schätzungen werden verworfen
Kein Wert für die nächste Person Gerätewerte nach 20 s ohne Gesicht leer, sobald seit 30 s keine Gerätemeldung kam; Kamerawerte 2 s nach dem letzten Bild leer; nach dem Verbinden eines Geräts wird nur sein jüngster Wert angezeigt (Abschnitt 6)
Keine Bewertung keine Ampelfarben, keine Normbereiche, keine wertenden Wörter; die Gerätebits „unregelmäßiger Puls“ und „Pulsbereich“ werden nicht ausgewertet

Grenze: Python gibt Zwischenwerte (z. B. die JSON-Antwort) nach Gebrauch frei, überschreibt diesen Speicher aber nicht. Überschrieben werden die Ringpuffer der Messkette; die Felder der Sitzung werden auf leer gesetzt. Nach Prozessende ist nichts mehr vorhanden.

3 Installation

Voraussetzungen: Python 3.12, Arbeitskopie von ume-eyes mit dem übernommenen Stand unter %USERPROFILE%\dev\ume-eyes. Internet wird einmalig für die Installation gebraucht; im Messmodus läuft alles ohne Netz. Alle Befehle: PowerShell, ohne Administratorrechte.

cd $env:USERPROFILE\dev\ume-eyes\vitals
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -v

Alle Pakete sind in requirements.txt (Betrieb) und requirements-dev.txt (nur Tests) exakt gepinnt (==); die Begründung steht in vitals/ABHAENGIGKEITEN.md. Keines lädt zur Laufzeit Modelle oder Daten nach, keines sendet Telemetrie.

Paket Fassung Zweck
numpy 2.5.4 Signalverarbeitung
opencv-python-headless 4.14.0.94 Webcam lesen, Gesichtserkennung mit dem im Paket enthaltenen Gesichtsmodell (kein Download)
bleak 3.0.2 Bluetooth LE: mit den eingetragenen Geräten verbinden, Messwerte empfangen
winrt-runtime, winrt-Windows.* 4.1.0 / 4!10.0.28000.2957 nur Windows: Brücke zur Bluetooth-Schnittstelle von Windows
dbus-fast 5.2.0 nur Linux: Brücke zum Bluetooth-Stapel über den lokalen D-Bus
pytest 9.2.0 nur Tests

Lizenzhinweis: Die Software wird nicht an Kunden weitergegeben. Das OpenCV-Paket enthält die Bibliothek FFmpeg unter der GNU LGPL 2.1; das ist in NOTICE und mit den Lizenztexten in LICENSES/ des Pakets vermerkt. Die Pflichten der LGPL greifen nur bei einer Weitergabe.

Linux (Perception-Board, Bash, ohne sudo): python3.12 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt. ROS 2 (rclpy) kommt aus der ROS-Installation, nicht aus requirements.txt; das venv dann mit --system-site-packages anlegen. Unter Linux nicht getestet.

4 Konfiguration vitals.json

Datei %USERPROFILE%\.ume-vitals\vitals.json (außerhalb des Repositorys; Vorlage vitals/vitals.beispiel.json). Fehlt sie, gelten die Vorgaben ohne Messgeräte. Eine andere Datei lässt sich mit --konfig angeben. Unbekannte Einträge und Werte außerhalb der Bereiche unten werden mit einer Fehlermeldung abgelehnt.

Eintrag Vorgabe Bedeutung
quelle webcam webcam, ros oder simulator (die Startoption --quelle hat Vorrang)
kamera_index 0 Nummer der USB-Webcam, ganze Zahl 0–9
ros_thema /ume/camera/color/image_raw Kamerathema (nur lesen), beginnt mit /
verfahren pos pos oder chrom
fenster_s 15 Pulsfenster, 10–20 s
atem_fenster_s 20 Atemfenster, 15–60 s
qualitaet_schwelle_db null Mindest-Signalqualität (geweißtes SNR) für einen Pulswert; null = Vorgabe des Verfahrens (POS 1 dB, CHROM 2,5 dB), sonst 0 bis 20 dB
stabil_anzahl 3 so viele aufeinanderfolgende Schätzungen über der Schwelle, bevor ein Kamerawert erscheint, 1–10
stabil_toleranz_bpm 5 alle diese Pulsschätzungen innerhalb ± dieses Werts um ihren Median, 1–20 /min
stabil_toleranz_atem 3 dasselbe für die Atemfrequenz, 1–10 /min
sitzung_timeout_s 60 Sitzungsende ohne Gesicht und ohne gültigen Gerätewert, 10–600 s
max_sitzung_s 120 Höchstdauer einer Sitzung ab der ersten Aktivität, 30–900 s
ohne_gesicht_leeren_s 20 Gerätewerte leeren, wenn so lange kein Gesicht im Bild ist, 5–120 s
personenwechsel_s 15 so lange ohne Gesicht (und ohne Gerätemessung, siehe geraet_nachlauf_s), dann gilt ein neues Gesicht als neue Person, 5–120 s
geraet_nachlauf_s 30 so lange nach der letzten Gerätemeldung gilt eine Gerätemessung als laufend: kein Personenwechsel, kein Leeren ohne Gesicht, 10–300 s
port 8790 Port der Anzeige auf 127.0.0.1, 1024–65535
ble_schwall_s 3 nach dem Verbinden so lange (und bis 1 s Ruhe) Blutdruck- und Temperaturpakete sammeln und nur das jüngste zeigen, 0,5–10 s
ble.pulsoximeter, ble.blutdruck, ble.thermometer leer Bluetooth-Adresse des vorher gekoppelten Geräts (Format AA:BB:CC:DD:EE:FF); leer = Gerät nicht verwenden

Es gibt bewusst keinen Eintrag für eine Server-Adresse.

5 Starten

PowerShell, ohne Administratorrechte. Die Konsole zeigt die Anzeigeadresse und die Prozess-ID (für den Netzwerkmitschnitt). Beenden mit Strg+C; dabei wird die Sitzung geleert. Ein Wächter prüft einmal je Sekunde die Sitzungszeiten und startet eine ausgefallene Kameraquelle neu.

Zwischen den Neustartversuchen der Kameraquelle wartet der Wächter 1, 2, 4, 8 und 16 s, danach jeweils 30 s; läuft die Quelle wieder, beginnt es erneut bei 1 s.

Nur dieses Paket für die Vitalmessung

Am Stand ausschließlich dieses Paket für die Vitalmessung starten; die bisherige Vitalerkennung von ume_main wird dort nicht verwendet.

Simulator (ohne Kamera; standardmäßig nur Kameramessung, mit --mit-geraeten zusätzlich simulierte Pulsoximeter-, Blutdruck- und Temperaturwerte; die Seite zeigt sichtbar „Simulation – keine echten Messwerte“):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle simulator

USB-Webcam (Vorgabe):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle webcam

ROS-Kamerathema (auf dem Perception-Board, Bash, ROS-Umgebung geladen). Die Quelle startet nur, wenn ROS auf das Gerät beschränkt ist (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1); sonst endet das Programm mit „Nicht verfügbar: ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1 fehlt“:

cd "$HOME/ume-eyes/vitals"
ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ROS_LOCALHOST_ONLY=1 .venv/bin/python -m ume_vitals --quelle ros

Die Kamera muss dann auf demselben Gerät mit derselben Einstellung veröffentlichen, sonst kommen keine Bilder an.

Anzeige im Vollbild (zweite PowerShell, ohne Administratorrechte). --inprivate: kein Verlauf und kein Cache über das Fenster hinaus; --disable-features=Translate: keine Übersetzungsangebote (eine Übersetzung würde den Seitentext an einen Dienst schicken). Die Schalter vor der Abnahme an der installierten Browserfassung prüfen:

cd $env:USERPROFILE
Start-Process msedge.exe -ArgumentList '--kiosk http://127.0.0.1:8790/ --edge-kiosk-type=fullscreen --inprivate --disable-features=Translate --no-first-run'

Ist die gewählte Quelle nicht verfügbar (z. B. ROS 2 fehlt), endet das Programm mit „Nicht verfügbar: …“ und Rückgabewert 2.

6 Bluetooth-LE-Geräte koppeln

Nicht im MEDICA-Betrieb

Am Stand auf der MEDICA werden keine Messgeräte verwendet; dieser Abschnitt gilt nur für einen späteren Betrieb mit Geräten.

Unterstützt werden nur Geräte mit Bluetooth-LE-Standardprofil: CE-gekennzeichnetes Pulsoximeter (Pulse Oximeter Service 0x1822), CE-gekennzeichnetes Oberarm-Blutdruckmessgerät (Blood Pressure Service 0x1810), CE-gekennzeichnetes kontaktloses Stirnthermometer (Health Thermometer Service 0x1809).

  1. Vor dem ersten Einsatz mit einer Bluetooth-LE-Scanner-App prüfen, dass das Gerät den Dienst 0x1822, 0x1810 bzw. 0x1809 anbietet. Ein Gerät ohne Standardprofil lässt sich nicht verwenden.
  2. Das Gerät im Betriebssystem koppeln (Windows: Einstellungen › Bluetooth und Geräte; Linux: die Bluetooth-Werkzeuge des Systems), wie in der Gebrauchsanweisung des Geräts beschrieben. Manche Geräte nehmen nur einen gekoppelten Empfänger an — die Kopplung mit einem anderen Empfänger beendet die erste.
  3. Die Bluetooth-Adresse des Geräts in vitals.json unter ble.pulsoximeter, ble.blutdruck bzw. ble.thermometer eintragen. Adressen sind Standortdaten — nicht in Tickets, Dokumente oder Repositorys.
  4. Das Programm neu starten. Es verbindet sich nur mit den eingetragenen Adressen, abonniert die Messmerkmale (Abschnitt 3 der Schnittstellenseite) und verbindet sich bei Verbindungsverlust alle 5 s neu. Eine Suche nach anderen Geräten gibt es nicht.
  5. Mit einer Messung prüfen: Der Wert muss an der Anzeige erscheinen, nachdem das Gerät die Messung beendet hat.

Schwall nach dem Verbinden. Viele Blutdruckmessgeräte und Thermometer verbinden sich erst nach der Messung, senden sofort (oft zuerst gespeicherte Altmessungen, dann die aktuelle, meist mit Gerätezeitstempel) und trennen. Deshalb sammelt das Paket nach jedem Verbinden Blutdruck- und Temperaturpakete, bis ble_schwall_s (3 s) vergangen und 1 s nichts mehr gekommen ist (höchstens 9 s) oder das Gerät trennt, und zeigt davon nur das jüngste: nach Gerätezeitstempel, wenn alle Pakete einen haben, sonst das zuletzt empfangene. Danach eingehende Einzelpakete erscheinen sofort. Gerätezeitstempel werden nicht mehr verworfen. Grenze: Scheitert die aktuelle Messung am Gerät (kein neuer Wert), ist das jüngste Paket eine Altmessung und erscheint — ob das bei den gewählten Geräten vorkommt, bei der Abnahme mit dem Gerät prüfen. Geht die Geräteuhr falsch, stimmt die Reihenfolge nach Zeitstempel nicht. Das Pulsoximeter ist nicht betroffen (es kennzeichnet Speicherdaten selbst).

Personenwechsel. Die Gesichtserkennung findet nur frontale Gesichter; wer während der Blutdruckmessung auf den Arm schaut, ist für die Kamera „kein Gesicht“. Ein neues Gesicht gilt deshalb nur dann als neue Person (neue Sitzung, alle Werte leer), wenn (1) mindestens personenwechsel_s (15 s) kein Gesicht im Bild war, (2) seit dem Gesichtsverlust kein gültiger Gerätewert kam und (3) die letzte Gerätemeldung (auch „Messung läuft“) mindestens geraet_nachlauf_s (30 s) zurückliegt. Gerätewerte ohne Gesicht werden erst nach ohne_gesicht_leeren_s (20 s) geleert und nur, wenn ebenfalls 30 s keine Gerätemeldung kam. Harte Grenze bleibt die Höchstdauer max_sitzung_s (120 s). Für einen sofortigen Wechsel gibt es die Taste „Neue Person“. Folge: Setzt sich innerhalb von 30 s nach einer Gerätemessung jemand anderes hin, bleiben die Werte stehen, bis die Höchstdauer endet oder das Standpersonal „Neue Person“ drückt — das Standpersonal entsprechend einweisen. Am Stand ist „Neue Person“ bei jedem Besucherwechsel Pflicht; die automatische Erkennung ist nur eine Rückfallebene.

Uhrzeit am Gerät. Manche Blutdruckmessgeräte erwarten, dass der Empfänger nach dem Verbinden die Uhrzeit schreibt (Date Time 0x2A08 bzw. Current Time Service 0x1805), und messen oder senden sonst nicht. Das Paket schreibt bewusst nichts an Geräte (nur lesen). Bei der Abnahme mit dem gewählten Gerät prüfen; braucht es die Uhrzeit, ist das ein eigener, freizugebender Schritt.

7 Netzwerkmitschnitt zur Abnahme

Netzschutz im Prozess. Beim Start des Messmodus sperrt das Programm jede Verbindung zu anderen Adressen als 127.0.0.0/8, ::1, localhost und lokalen Unix-Sockets (lokaler D-Bus für Bluetooth unter Linux), bevor ein Paket gesendet wird, einschließlich Namensauflösung. Im Protokoll steht dann „Verbindung nach außen abgelehnt“ (ohne Adresse).

Für die Abnahme werden während der Messungen zwei Nachweise aufgenommen (ein Mitschnitt des ganzen Rechners enthält auch Verkehr anderer Programme, z. B. Windows und Browser):

  1. Verbindungen des Vitalprozesses (PowerShell, ohne Administratorrechte; Ende mit Strg+C). Zeigt jede Verbindung des Prozesses, die nicht zu 127.0.0.1 oder ::1 geht — erwartet ist keine Zeile:

    cd $env:USERPROFILE
    $ids = (Get-CimInstance Win32_Process -Filter "Name = 'python.exe'" | Where-Object { $_.CommandLine -like '*-m ume_vitals*' }).ProcessId
    while ($true) { Get-NetTCPConnection -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess -and $_.RemoteAddress -notin @('127.0.0.1', '::1', '0.0.0.0', '::') } | Format-Table -AutoSize; Get-NetUDPEndpoint -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess } | Format-Table -AutoSize; Start-Sleep -Seconds 1 }
    
  2. Mitschnitt des ganzen Rechners mit pktmon (PowerShell als Administrator; Syntax vor der Abnahme mit pktmon help gegenprüfen):

    cd $env:USERPROFILE
    pktmon filter remove
    pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etl
    

    Messungen durchführen, danach:

    cd $env:USERPROFILE
    pktmon stop
    pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapng
    

    Die .pcapng-Datei in einem Netzwerkanalysewerkzeug öffnen und nach Verkehr ohne Loopback-Adressen filtern (!(ip.addr == 127.0.0.0/8) && !(ipv6.addr == ::1)); jede gefundene Verbindung über Nachweis 1 dem Vitalprozess zuordnen oder ausschließen.

Linux (Perception-Board, Bash mit sudo):

cd "$HOME"
sudo tcpdump -i any -n -w "$HOME/vitals-mitschnitt.pcap" 'not (net 127.0.0.0/8 or ip6 host ::1)'

Danach sudo tcpdump -n -r "$HOME/vitals-mitschnitt.pcap" und ss -tunap | grep python.

Mitschnittdateien wie Messdaten behandeln: nicht weitergeben, nach der Auswertung entfernen.

8 Grenzen dieses Stands

  • Genauigkeit nicht am Menschen geprüft. Alle Tests laufen mit synthetischen Signalen, Attrappen und dem Simulator; keine echte Kamera, kein echtes Messgerät, keine Person.
  • Die Qualitätsschwellen (Puls: geweißtes SNR, Vorgabe POS 1 dB, CHROM 2,5 dB; Atmung 3 dB im Atemband und 25 dB über dem Rauschgrund) sind an synthetischen Signalen hergeleitet. Ob sie an echten Kameras passen, ist offen; die Pulsschwelle ist in vitals.json einstellbar. Bei langsamer Drift lieferte POS in den synthetischen Tests weniger Pulswerte als zuvor; CHROM ist bei Drift schwach und für den Stand nicht empfohlen.
  • ROS-Netz (DDS). Der Netzschutz wirkt nur auf Python-Ebene; ROS 2 öffnet seine Sockets an Python vorbei. Die ROS-Quelle startet deshalb nur in einer auf das Gerät beschränkten ROS-Umgebung (Abschnitt 5). Welche ROS-Fassung auf dem Perception-Board läuft und ob das Kamerathema dort lokal anliegt, wird noch geklärt.
  • Linux, Perception-Board und ROS 2 sind nicht installiert und nicht getestet.
  • Stabilitätsregel: Ein Kamerawert erscheint erst, wenn stabil_anzahl (3) aufeinanderfolgende Schätzungen (eine je Sekunde) über der Schwelle und innerhalb ± stabil_toleranz_bpm (5 /min; Atmung ± stabil_toleranz_atem, 3 /min) um ihren Median liegen; angezeigt wird der Median. Eine Schätzung unter der Schwelle oder ein Ausreißer nimmt den Wert wieder weg. In synthetischen Tests mit 8000 Rauschläufen lieferte POS mit dieser Regel noch zwei, CHROM einen falschen Wert.
  • Das Verhalten der gewählten Messgeräte beim Verbinden (Schwall, Altmessungen, Zeitstempel, Uhrzeit, gescheiterte Messung) ist bei der Abnahme zu prüfen (Abschnitt 6).
  • Automatische Belichtung und Weißabgleich der Webcam können die Messung verfälschen; sie werden nicht abgeschaltet (kameraabhängig).
  • Die Gesichtserkennung findet nur frontale Gesichter; Brille, Maske, Gegenlicht und eine dunkle Kabine verschlechtern die Erkennung.
  • Der Browser am Monitorrechner ist nicht Teil dieses Pakets; seinen eigenen Verkehr im Mitschnitt mitbewerten.

9 Tests

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m pytest -v

Abgedeckt: Puls und Atemfrequenz mit synthetischen Signalen (POS und CHROM), kein Wert bei Rauschen (auch 1/f²-Rauschen), zu kurzem Fenster oder ohne Gesicht, Bluetooth-LE-Parser mit Paketen nach Spezifikation (auch Körpertemperatur), gespeicherte Messungen, Sensorstatus, Bereiche und Zeitstempel, keine Verbindung nach außen im Messmodus, Anzeige nur auf 127.0.0.1, Sitzungsende, Höchstdauer und Personenwechsel leeren alles, Protokoll ohne Werte, ROS-Quelle nur bei Beschränkung auf das Gerät, Gerätewerte an der Anzeige-Schnittstelle ≤ 5 s nach Messende (Simulator). Stand 04.11.2026: 419 Tests bestanden (Windows, Python 3.12.10).


Manuel du technicien — Mesure des signes vitaux sur l’appareil uMe (aperçu)

État au 04.11.2026, paquet vitals/ du dépôt ume-eyes, version 0.4.0 (aperçu, UME-297). Projet — pas encore validé. Le paquet est en développement, pas encore intégré et installé sur aucun appareil. Il n’a pas été testé avec une vraie caméra, de vrais appareils de mesure ou des personnes.

Pour l’informatique, les techniciens et les partenaires d’intégration

Référence technique pour les services informatiques, les techniciens URG et les partenaires formés. Ce n’est pas une notice d’utilisation pour les utilisateurs finaux.

Démonstration – pas un dispositif médical. Aucun diagnostic.

Le logiciel affiche des valeurs uniquement à des fins de démonstration. Il n’évalue rien. La précision du pouls et de la fréquence respiratoire issus de la caméra n’a pas encore été vérifiée sur des personnes.

Fonctionnement sur le stand de la MEDICA : caméra uniquement

Sur le stand de la MEDICA, seuls le pouls et la fréquence respiratoire issus de la caméra sont mesurés, localement sur l’appareil ; SpO₂, pression artérielle et température corporelle ne sont ni mesurées ni affichées. Les appareils Bluetooth LE sont prévus dans le code mais désactivés par configuration (aucune adresse sous ble) ; la page n’affiche alors aucun champ d’appareil. Le personnel du stand appuie sur « Nouvelle personne » à chaque changement de visiteur (obligatoire). Les images et les valeurs restent sur l’appareil.

1 Vue d’ensemble

Élément Rôle
Source caméra webcam USB sur l’ordinateur du moniteur (par défaut), topic caméra ROS 2 (lecture seule) ou simulateur
Traitement du signal détection du visage, zones de mesure front et joues, pouls et fréquence respiratoire (rPPG, méthodes POS ou CHROM), qualité du signal
Réception Bluetooth LE valeurs d’appareils marqués CE avec profil standard Bluetooth LE : oxymètre de pouls (0x1822), tensiomètre à brassard (0x1810), thermomètre frontal sans contact (0x1809 ; °C avec une décimale, aucune évaluation de fièvre)
Affichage page web plein écran, servie uniquement sur 127.0.0.1, six langues (DE, EN, FR, ES, IT, NL)

Le paquet n’a aucune interface avec la sortie vocale, le service relais d’uMe Eyes ou un cloud. Il n’envoie rien via ROS, n’écrit rien sur les appareils de mesure et n’a aucun accès aux fonctions de déplacement ou de mouvement du robot.

2 Protection des données (G-02a)

Règle Mise en œuvre
Aucune image et aucune valeur ne quitte l’appareil affichage uniquement sur 127.0.0.1 (aucun réglage pour une autre adresse) ; protection réseau dans le processus (section 7) ; aucune bibliothèque réseau dans le code
Aucun enregistrement aucun fichier, aucune base de données, aucun stockage navigateur ; chaque image de la caméra est réduite à trois valeurs moyennes ; réponses HTTP avec Cache-Control: no-store
Aucune journalisation de valeurs ou d’images le journal contient uniquement des messages d’état fixes sans valeurs
Aucune donnée personnelle la détection du visage ne fournit qu’un rectangle ; l’identifiant utilisateur et l’horodatage envoyés par les appareils sont lus mais jamais conservés
La fin de session efface tout boutons ou points d’accès « Terminer la session » et « Nouvelle personne », délai d’inactivité (60 s sans visage et sans valeur d’appareil valide), durée maximale (120 s, limite stricte), changement de personne (voir « Changement de personne » en section 6) : champs vides, mémoires tampons circulaires écrasées par des zéros, affichage vide ; les estimations périmées sont rejetées
Aucune valeur pour la personne suivante valeurs d’appareil effacées après 20 s sans visage, dès qu’aucun message d’appareil n’est arrivé depuis 30 s ; valeurs de la caméra effacées 2 s après la dernière image ; après la connexion d’un appareil, seule sa valeur la plus récente est affichée (section 6)
Aucune évaluation pas de couleurs de feu tricolore, pas de plages normales, pas de mots évaluatifs ; les bits d’appareil « pouls irrégulier » et « plage de pouls » ne sont pas exploités

Limite : Python libère les valeurs intermédiaires après usage (par exemple la réponse JSON) mais n’écrase pas cette mémoire. Les mémoires tampons de la chaîne de mesure sont écrasées ; les champs de la session sont vidés. Après la fin du processus, il ne reste rien.

3 Installation

Prérequis : Python 3.12, copie de travail de ume-eyes avec la version intégrée sous %USERPROFILE%\dev\ume-eyes. Internet n’est nécessaire qu’une fois pour l’installation ; en mode mesure, tout fonctionne sans réseau. Toutes les commandes : PowerShell, sans droits d’administrateur.

cd $env:USERPROFILE\dev\ume-eyes\vitals
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -v

Tous les paquets sont épinglés exactement (==) dans requirements.txt (fonctionnement) et requirements-dev.txt (tests uniquement) ; la justification figure dans vitals/ABHAENGIGKEITEN.md. Aucun ne charge de modèles ou de données à l’exécution, aucun n’envoie de télémétrie.

Paquet Version Rôle
numpy 2.5.4 traitement du signal
opencv-python-headless 4.14.0.94 lire la webcam, détection du visage avec le modèle inclus dans le paquet (aucun téléchargement)
bleak 3.0.2 Bluetooth LE : connexion aux appareils configurés, réception des mesures
winrt-runtime, winrt-Windows.* 4.1.0 / 4!10.0.28000.2957 Windows uniquement : passerelle vers l’interface Bluetooth de Windows
dbus-fast 5.2.0 Linux uniquement : passerelle vers la pile Bluetooth via le D-Bus local
pytest 9.2.0 tests uniquement

Note de licence : le logiciel n’est pas transmis aux clients. Le paquet OpenCV contient la bibliothèque FFmpeg sous GNU LGPL 2.1 ; cela est consigné dans NOTICE et avec les textes de licence dans LICENSES/ du paquet. Les obligations de la LGPL ne s’appliquent qu’en cas de transmission.

Linux (carte de perception, Bash, sans sudo) : python3.12 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt. ROS 2 (rclpy) provient de l’installation ROS, pas de requirements.txt ; créer alors le venv avec --system-site-packages. Non testé sous Linux.

4 Configuration vitals.json

Fichier %USERPROFILE%\.ume-vitals\vitals.json (hors du dépôt ; modèle vitals/vitals.beispiel.json). S’il manque, les valeurs par défaut s’appliquent sans appareils de mesure. Un autre fichier peut être indiqué avec --konfig. Les entrées inconnues et les valeurs hors des plages ci-dessous sont refusées avec un message d’erreur.

Entrée Défaut Signification
quelle webcam webcam, ros ou simulator (l’option de démarrage --quelle est prioritaire)
kamera_index 0 numéro de la webcam USB, entier 0–9
ros_thema /ume/camera/color/image_raw topic caméra (lecture seule), commence par /
verfahren pos pos ou chrom
fenster_s 15 fenêtre du pouls, 10–20 s
atem_fenster_s 20 fenêtre de la respiration, 15–60 s
qualitaet_schwelle_db null qualité minimale du signal (SNR blanchi) pour une valeur de pouls ; null = valeur par défaut de la méthode (POS 1 dB, CHROM 2,5 dB), sinon 0 à 20 dB
stabil_anzahl 3 nombre d’estimations successives au-dessus du seuil avant qu’une valeur caméra n’apparaisse, 1–10
stabil_toleranz_bpm 5 toutes ces estimations du pouls doivent se situer à ± cette valeur autour de leur médiane, 1–20 /min
stabil_toleranz_atem 3 idem pour la fréquence respiratoire, 1–10 /min
sitzung_timeout_s 60 fin de session sans visage et sans valeur d’appareil valide, 10–600 s
max_sitzung_s 120 durée maximale d’une session à partir de la première activité, 30–900 s
ohne_gesicht_leeren_s 20 effacer les valeurs d’appareil après cette durée sans visage, 5–120 s
personenwechsel_s 15 après cette durée sans visage (et sans mesure d’appareil, voir geraet_nachlauf_s), un nouveau visage compte comme une nouvelle personne, 5–120 s
geraet_nachlauf_s 30 pendant cette durée après le dernier message d’appareil, une mesure d’appareil est considérée en cours : pas de changement de personne, pas d’effacement sans visage, 10–300 s
port 8790 port de l’affichage sur 127.0.0.1, 1024–65535
ble_schwall_s 3 après la connexion, collecter pendant cette durée (et jusqu’à 1 s de silence) les paquets de pression artérielle et de température et n’afficher que le plus récent, 0,5–10 s
ble.pulsoximeter, ble.blutdruck, ble.thermometer vide adresse Bluetooth de l’appareil préalablement appairé (format AA:BB:CC:DD:EE:FF) ; vide = appareil non utilisé

Il n’existe volontairement aucune entrée pour une adresse de serveur.

5 Démarrage

PowerShell, sans droits d’administrateur. La console affiche l’adresse de l’affichage et l’identifiant du processus (pour la capture réseau). Arrêt avec Ctrl+C ; la session est alors vidée. Un chien de garde vérifie chaque seconde les durées de session et redémarre une source caméra arrêtée.

Entre deux tentatives de redémarrage de la source caméra, le chien de garde attend 1, 2, 4, 8 et 16 s, puis 30 s à chaque fois ; dès que la source fonctionne de nouveau, il recommence à 1 s.

Uniquement ce paquet pour la mesure des signes vitaux

Sur le stand, démarrer exclusivement ce paquet pour la mesure des signes vitaux ; l’ancienne détection des signes vitaux de ume_main n’y est pas utilisée.

Simulateur (sans caméra ; par défaut mesure par caméra uniquement, avec --mit-geraeten en plus des valeurs simulées d’oxymètre, de pression artérielle et de température ; la page affiche visiblement « Simulation – aucune mesure réelle ») :

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle simulator

Webcam USB (par défaut) :

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle webcam

Topic caméra ROS (sur la carte de perception, Bash, environnement ROS chargé). La source ne démarre que si ROS est limité à l’appareil (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ou ROS_LOCALHOST_ONLY=1) ; sinon le programme se termine avec « Nicht verfügbar: ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1 fehlt » :

cd "$HOME/ume-eyes/vitals"
ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ROS_LOCALHOST_ONLY=1 .venv/bin/python -m ume_vitals --quelle ros

La caméra doit alors publier sur le même appareil avec le même réglage, sinon aucune image n’arrive.

Affichage plein écran (deuxième PowerShell, sans droits d’administrateur). --inprivate : pas d’historique ni de cache au-delà de la fenêtre ; --disable-features=Translate : pas de proposition de traduction (une traduction enverrait le texte de la page à un service). Vérifier les options sur la version installée du navigateur avant la réception :

cd $env:USERPROFILE
Start-Process msedge.exe -ArgumentList '--kiosk http://127.0.0.1:8790/ --edge-kiosk-type=fullscreen --inprivate --disable-features=Translate --no-first-run'

Si la source choisie n’est pas disponible (par exemple ROS 2 absent), le programme se termine avec « Nicht verfügbar: … » et le code de retour 2.

6 Appairer les appareils Bluetooth LE

Pas utilisé dans le fonctionnement MEDICA

Sur le stand de la MEDICA, aucun appareil de mesure n’est utilisé ; cette section ne concerne qu’un fonctionnement ultérieur avec appareils.

Seuls les appareils dotés du profil standard Bluetooth LE sont pris en charge : oxymètre de pouls marqué CE (Pulse Oximeter Service 0x1822), tensiomètre à brassard marqué CE (Blood Pressure Service 0x1810), thermomètre frontal sans contact marqué CE (Health Thermometer Service 0x1809).

  1. Avant la première utilisation, vérifier avec une application de scan Bluetooth LE que l’appareil propose le service 0x1822, 0x1810 ou 0x1809. Un appareil sans profil standard ne peut pas être utilisé.
  2. Appairer l’appareil dans le système d’exploitation (Windows : Paramètres › Bluetooth et appareils ; Linux : les outils Bluetooth du système), selon la notice d’utilisation de l’appareil. Certains appareils n’acceptent qu’un seul récepteur appairé — l’appairage avec un autre récepteur met fin au premier.
  3. Saisir l’adresse Bluetooth de l’appareil dans vitals.json sous ble.pulsoximeter, ble.blutdruck ou ble.thermometer. Les adresses sont des données de site — ne pas les mettre dans des tickets, documents ou dépôts.
  4. Redémarrer le programme. Il se connecte uniquement aux adresses saisies, s’abonne aux caractéristiques de mesure (section 3 de la page des interfaces) et se reconnecte toutes les 5 s en cas de perte de connexion. Il n’y a pas de recherche d’autres appareils.
  5. Tester avec une mesure : la valeur doit apparaître à l’affichage une fois la mesure terminée sur l’appareil.

Salve après la connexion. De nombreux tensiomètres et thermomètres ne se connectent qu’après la mesure, envoient aussitôt (souvent d’abord des mesures anciennes enregistrées, puis la mesure actuelle, généralement avec horodatage de l’appareil) et se déconnectent. C’est pourquoi, après chaque connexion, le paquet collecte les paquets de pression artérielle et de température jusqu’à ce que ble_schwall_s (3 s) soit écoulé et que plus rien ne soit arrivé pendant 1 s (au plus 9 s), ou jusqu’à la déconnexion de l’appareil, et n’affiche que le plus récent : selon l’horodatage de l’appareil si tous les paquets en ont un, sinon le dernier reçu. Les paquets isolés reçus ensuite sont affichés immédiatement. Les horodatages ne sont plus rejetés. Limite : si la mesure actuelle échoue sur l’appareil (pas de nouvelle valeur), le paquet le plus récent est une mesure ancienne et s’affiche — vérifier lors de la réception avec l’appareil choisi si cela se produit. Si l’horloge de l’appareil est fausse, l’ordre selon l’horodatage l’est aussi. L’oxymètre de pouls n’est pas concerné (il marque lui-même les données enregistrées).

Changement de personne. La détection ne trouve que des visages de face ; une personne qui regarde son bras pendant la mesure de la pression artérielle est « sans visage » pour la caméra. Un nouveau visage ne compte donc comme une nouvelle personne (nouvelle session, toutes les valeurs vides) que si (1) aucun visage n’a été vu pendant au moins personenwechsel_s (15 s), (2) aucune valeur d’appareil valide n’est arrivée depuis la perte du visage et (3) le dernier message d’appareil (y compris « mesure en cours ») date d’au moins geraet_nachlauf_s (30 s). Les valeurs d’appareil sans visage ne sont effacées qu’après ohne_gesicht_leeren_s (20 s), et seulement si aucun message d’appareil n’est arrivé depuis 30 s. La durée maximale max_sitzung_s (120 s) reste une limite stricte. Pour un changement immédiat, il existe le bouton « Nouvelle personne ». Conséquence : si quelqu’un d’autre s’assoit dans les 30 s qui suivent une mesure d’appareil, les valeurs restent affichées jusqu’à la fin de la durée maximale ou jusqu’à ce que le personnel du stand appuie sur « Nouvelle personne » — former le personnel du stand en conséquence. Sur le stand, appuyer sur « Nouvelle personne » à chaque changement de visiteur est obligatoire ; la détection automatique n’est qu’une solution de secours.

Heure de l’appareil. Certains tensiomètres attendent que le récepteur écrive l’heure après la connexion (Date Time 0x2A08 ou Current Time Service 0x1805) et sinon ne mesurent pas ou n’envoient rien. Le paquet n’écrit volontairement rien sur les appareils (lecture seule). Le vérifier lors de la réception avec l’appareil choisi ; si l’heure est nécessaire, c’est une étape distincte soumise à validation.

7 Capture réseau pour la réception

Protection réseau dans le processus. Au démarrage du mode mesure, le programme bloque toute connexion vers des adresses autres que 127.0.0.0/8, ::1, localhost et les sockets Unix locaux (D-Bus local pour Bluetooth sous Linux), avant l’envoi d’un paquet, y compris la résolution de noms. Le journal indique alors « Verbindung nach außen abgelehnt » (sans l’adresse).

Pour la réception, deux preuves sont enregistrées pendant les mesures (une capture de tout l’ordinateur contient aussi le trafic d’autres programmes, par exemple Windows et le navigateur) :

  1. Connexions du processus de mesure (PowerShell, sans droits d’administrateur ; arrêt avec Ctrl+C). Affiche toute connexion du processus qui ne va pas vers 127.0.0.1 ou ::1 — aucune ligne n’est attendue :

    cd $env:USERPROFILE
    $ids = (Get-CimInstance Win32_Process -Filter "Name = 'python.exe'" | Where-Object { $_.CommandLine -like '*-m ume_vitals*' }).ProcessId
    while ($true) { Get-NetTCPConnection -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess -and $_.RemoteAddress -notin @('127.0.0.1', '::1', '0.0.0.0', '::') } | Format-Table -AutoSize; Get-NetUDPEndpoint -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess } | Format-Table -AutoSize; Start-Sleep -Seconds 1 }
    
  2. Capture de tout l’ordinateur avec pktmon (PowerShell en tant qu’administrateur ; vérifier la syntaxe avec pktmon help avant la réception) :

    cd $env:USERPROFILE
    pktmon filter remove
    pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etl
    

    Effectuer les mesures, puis :

    cd $env:USERPROFILE
    pktmon stop
    pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapng
    

    Ouvrir le fichier .pcapng dans un analyseur réseau et filtrer le trafic hors adresses de bouclage (!(ip.addr == 127.0.0.0/8) && !(ipv6.addr == ::1)) ; attribuer chaque connexion trouvée au processus de mesure à l’aide de la preuve 1, ou l’exclure.

Linux (carte de perception, Bash avec sudo) :

cd "$HOME"
sudo tcpdump -i any -n -w "$HOME/vitals-mitschnitt.pcap" 'not (net 127.0.0.0/8 or ip6 host ::1)'

Ensuite sudo tcpdump -n -r "$HOME/vitals-mitschnitt.pcap" et ss -tunap | grep python.

Traiter les fichiers de capture comme des données de mesure : ne pas les transmettre, les supprimer après l’évaluation.

8 Limites de cet état

  • Précision non vérifiée sur des personnes. Tous les tests utilisent des signaux synthétiques, des simulacres et le simulateur ; aucune vraie caméra, aucun vrai appareil de mesure, aucune personne.
  • Les seuils de qualité (pouls : SNR blanchi, par défaut POS 1 dB, CHROM 2,5 dB ; respiration 3 dB dans la bande respiratoire et 25 dB au-dessus du bruit de fond) ont été déduits de signaux synthétiques. Leur adéquation aux vraies caméras reste ouverte ; le seuil du pouls est réglable dans vitals.json. En cas de dérive lente, POS a fourni moins de valeurs de pouls qu’auparavant dans les tests synthétiques ; CHROM est faible en cas de dérive et déconseillé pour le stand.
  • Réseau ROS (DDS). La protection réseau n’agit qu’au niveau Python ; ROS 2 ouvre ses sockets en dehors de Python. La source ROS ne démarre donc que dans un environnement ROS limité à l’appareil (section 5). La version ROS de la carte de perception et la disponibilité locale du topic caméra sont en cours de clarification.
  • Linux, la carte de perception et ROS 2 ne sont ni installés ni testés.
  • Règle de stabilité : une valeur caméra n’apparaît que lorsque stabil_anzahl (3) estimations successives (une par seconde) sont au-dessus du seuil et à ± stabil_toleranz_bpm (5 /min ; respiration ± stabil_toleranz_atem, 3 /min) autour de leur médiane ; la médiane est affichée. Une estimation sous le seuil ou une valeur aberrante retire la valeur. Dans des tests synthétiques avec 8000 passages de bruit, POS a encore donné deux valeurs fausses et CHROM une avec cette règle.
  • Le comportement des appareils de mesure choisis lors de la connexion (salve, mesures enregistrées, horodatage, heure, mesure échouée) est à vérifier lors de la réception (section 6).
  • L’exposition et la balance des blancs automatiques de la webcam peuvent fausser la mesure ; elles ne sont pas désactivées (selon la caméra).
  • La détection ne trouve que des visages de face ; lunettes, masque, contre-jour et cabine sombre dégradent la détection.
  • Le navigateur de l’ordinateur du moniteur ne fait pas partie de ce paquet ; évaluer son propre trafic dans la capture.

9 Tests

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m pytest -v

Couvert : pouls et fréquence respiratoire avec des signaux synthétiques (POS et CHROM), aucune valeur en cas de bruit (y compris bruit en 1/f²), de fenêtre trop courte ou sans visage, analyseur Bluetooth LE avec des paquets conformes à la spécification (y compris la température corporelle), mesures enregistrées, état du capteur, plages et horodatages, aucune connexion sortante en mode mesure, affichage uniquement sur 127.0.0.1, la fin de session, la durée maximale et le changement de personne effacent tout, journal sans valeurs, source ROS uniquement si limitée à l’appareil, valeurs d’appareil à l’interface d’affichage ≤ 5 s après la fin de la mesure (simulateur). État au 04.11.2026 : 419 tests réussis (Windows, Python 3.12.10).


Manual del técnico — Medición de constantes vitales en el equipo uMe (versión preliminar)

Estado a 04.11.2026, paquete vitals/ del repositorio ume-eyes, versión 0.4.0 (versión preliminar, UME-297). Borrador — aún no publicado. El paquete está en desarrollo, aún no incorporado y no instalado en ningún equipo. No se ha probado con una cámara real, con aparatos de medición reales ni con personas.

Para TI, técnicos y socios de integración

Referencia técnica para departamentos de TI, técnicos de URG y socios formados. No es un manual de uso para usuarios finales.

Demostración – no es un producto sanitario. Sin diagnóstico.

El software muestra valores solo con fines de demostración. No valora nada. La precisión del pulso y de la frecuencia respiratoria obtenidos por la cámara aún no se ha comprobado en personas.

Funcionamiento en el stand de la MEDICA: solo cámara

En el stand de la MEDICA solo se miden el pulso y la frecuencia respiratoria con la cámara, en local en el equipo; SpO₂, presión arterial y temperatura corporal no se miden ni se muestran. Los aparatos Bluetooth LE están preparados en el código, pero desactivados por configuración (sin dirección en ble); la página no muestra entonces campos de aparatos. El personal del stand pulsa «Nueva persona» en cada cambio de visitante (obligatorio). Las imágenes y los valores permanecen en el equipo.

1 Visión general

Parte Función
Fuente de cámara webcam USB en el ordenador del monitor (por defecto), tema de cámara ROS 2 (solo lectura) o simulador
Procesamiento de señal detección de rostro, zonas de medición frente y mejillas, pulso y frecuencia respiratoria (rPPG, métodos POS o CHROM), calidad de la señal
Recepción Bluetooth LE valores de aparatos con marcado CE y perfil estándar Bluetooth LE: pulsioxímetro (0x1822), tensiómetro de brazo (0x1810), termómetro de frente sin contacto (0x1809; °C con un decimal, sin valoración de fiebre)
Pantalla página web a pantalla completa, servida solo en 127.0.0.1, seis idiomas (DE, EN, FR, ES, IT, NL)

El paquete no tiene ninguna interfaz con la salida de voz, el servicio de intermediación de uMe Eyes ni ninguna nube. No envía nada por ROS, no escribe nada en los aparatos de medición y no tiene acceso a las funciones de desplazamiento o movimiento del robot.

2 Protección de datos (G-02a)

Regla Implementación
Ninguna imagen ni ningún valor sale del equipo pantalla solo en 127.0.0.1 (sin ajuste para otra dirección); protección de red en el proceso (sección 7); sin bibliotecas de red en el código
Sin almacenamiento sin archivo, sin base de datos, sin almacenamiento del navegador; cada imagen de la cámara se reduce a tres valores medios; respuestas HTTP con Cache-Control: no-store
Sin registro de valores ni imágenes el registro contiene solo mensajes de estado fijos sin valores
Sin datos personales la detección de rostro solo devuelve un rectángulo; el ID de usuario y la marca de tiempo enviados por los aparatos se leen pero nunca se conservan
El fin de sesión lo borra todo botones o puntos de acceso «Finalizar sesión» y «Nueva persona», tiempo de espera (60 s sin rostro y sin valor de aparato válido), duración máxima (120 s, límite estricto), cambio de persona (véase «Cambio de persona» en la sección 6): campos vacíos, búferes circulares sobrescritos con ceros, pantalla vacía; las estimaciones caducadas se descartan
Ningún valor para la persona siguiente valores de aparato borrados tras 20 s sin rostro, en cuanto no ha llegado ningún mensaje de aparato durante 30 s; valores de la cámara borrados 2 s después de la última imagen; tras conectarse un aparato solo se muestra su valor más reciente (sección 6)
Sin valoración sin colores de semáforo, sin rangos normales, sin palabras valorativas; los bits de aparato «pulso irregular» y «rango de pulso» no se evalúan

Límite: Python libera los valores intermedios tras su uso (por ejemplo la respuesta JSON), pero no sobrescribe esa memoria. Los búferes de la cadena de medición se sobrescriben; los campos de la sesión se vacían. Al terminar el proceso no queda nada.

3 Instalación

Requisitos: Python 3.12, copia de trabajo de ume-eyes con la versión incorporada en %USERPROFILE%\dev\ume-eyes. Internet se necesita una sola vez para la instalación; en modo de medición todo funciona sin red. Todos los comandos: PowerShell, sin derechos de administrador.

cd $env:USERPROFILE\dev\ume-eyes\vitals
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -v

Todos los paquetes están fijados exactamente (==) en requirements.txt (funcionamiento) y requirements-dev.txt (solo pruebas); la justificación está en vitals/ABHAENGIGKEITEN.md. Ninguno carga modelos ni datos en tiempo de ejecución, ninguno envía telemetría.

Paquete Versión Función
numpy 2.5.4 procesamiento de señal
opencv-python-headless 4.14.0.94 leer la webcam, detección de rostro con el modelo incluido en el paquete (sin descarga)
bleak 3.0.2 Bluetooth LE: conexión con los aparatos configurados, recepción de mediciones
winrt-runtime, winrt-Windows.* 4.1.0 / 4!10.0.28000.2957 solo Windows: puente a la interfaz Bluetooth de Windows
dbus-fast 5.2.0 solo Linux: puente a la pila Bluetooth a través del D-Bus local
pytest 9.2.0 solo pruebas

Nota de licencia: el software no se entrega a clientes. El paquete OpenCV contiene la biblioteca FFmpeg bajo la GNU LGPL 2.1; esto consta en NOTICE y con los textos de licencia en LICENSES/ del paquete. Las obligaciones de la LGPL solo se aplican si el paquete se entrega.

Linux (placa de percepción, Bash, sin sudo): python3.12 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt. ROS 2 (rclpy) procede de la instalación de ROS, no de requirements.txt; en ese caso crear el venv con --system-site-packages. No probado en Linux.

4 Configuración vitals.json

Archivo %USERPROFILE%\.ume-vitals\vitals.json (fuera del repositorio; plantilla vitals/vitals.beispiel.json). Si falta, se aplican los valores por defecto sin aparatos de medición. Con --konfig se puede indicar otro archivo. Las entradas desconocidas y los valores fuera de los rangos de abajo se rechazan con un mensaje de error.

Entrada Por defecto Significado
quelle webcam webcam, ros o simulator (la opción de inicio --quelle tiene prioridad)
kamera_index 0 número de la webcam USB, entero 0–9
ros_thema /ume/camera/color/image_raw tema de cámara (solo lectura), empieza por /
verfahren pos pos o chrom
fenster_s 15 ventana del pulso, 10–20 s
atem_fenster_s 20 ventana de la respiración, 15–60 s
qualitaet_schwelle_db null calidad mínima de la señal (SNR blanqueado) para un valor de pulso; null = valor por defecto del método (POS 1 dB, CHROM 2,5 dB), si no 0 a 20 dB
stabil_anzahl 3 número de estimaciones seguidas por encima del umbral antes de que aparezca un valor de la cámara, 1–10
stabil_toleranz_bpm 5 todas estas estimaciones de pulso deben estar dentro de ± este valor alrededor de su mediana, 1–20 /min
stabil_toleranz_atem 3 lo mismo para la frecuencia respiratoria, 1–10 /min
sitzung_timeout_s 60 fin de sesión sin rostro y sin valor de aparato válido, 10–600 s
max_sitzung_s 120 duración máxima de una sesión desde la primera actividad, 30–900 s
ohne_gesicht_leeren_s 20 borrar los valores de aparato tras este tiempo sin rostro, 5–120 s
personenwechsel_s 15 tras este tiempo sin rostro (y sin medición de aparato, véase geraet_nachlauf_s), un rostro nuevo cuenta como persona nueva, 5–120 s
geraet_nachlauf_s 30 durante este tiempo tras el último mensaje de aparato, una medición de aparato se considera en curso: sin cambio de persona, sin borrado sin rostro, 10–300 s
port 8790 puerto de la pantalla en 127.0.0.1, 1024–65535
ble_schwall_s 3 tras la conexión, recoger durante este tiempo (y hasta 1 s de calma) los paquetes de presión arterial y temperatura y mostrar solo el más reciente, 0,5–10 s
ble.pulsoximeter, ble.blutdruck, ble.thermometer vacío dirección Bluetooth del aparato emparejado previamente (formato AA:BB:CC:DD:EE:FF); vacío = aparato no utilizado

A propósito no existe ninguna entrada para una dirección de servidor.

5 Inicio

PowerShell, sin derechos de administrador. La consola muestra la dirección de la pantalla y el ID del proceso (para la captura de red). Terminar con Ctrl+C; la sesión se vacía. Un vigilante comprueba cada segundo los tiempos de sesión y reinicia una fuente de cámara que se haya detenido.

Entre los intentos de reinicio de la fuente de cámara, el vigilante espera 1, 2, 4, 8 y 16 s y después 30 s cada vez; cuando la fuente vuelve a funcionar, empieza de nuevo en 1 s.

Solo este paquete para la medición de constantes vitales

En el stand, iniciar exclusivamente este paquete para la medición de constantes vitales; la detección de constantes vitales anterior de ume_main no se utiliza allí.

Simulador (sin cámara; por defecto solo medición por cámara, con --mit-geraeten además valores simulados de pulsioxímetro, presión arterial y temperatura; la página muestra de forma visible «Simulación – no son mediciones reales»):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle simulator

Webcam USB (por defecto):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle webcam

Tema de cámara ROS (en la placa de percepción, Bash, entorno ROS cargado). La fuente solo se inicia si ROS está limitado al equipo (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST o ROS_LOCALHOST_ONLY=1); si no, el programa termina con «Nicht verfügbar: ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1 fehlt»:

cd "$HOME/ume-eyes/vitals"
ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ROS_LOCALHOST_ONLY=1 .venv/bin/python -m ume_vitals --quelle ros

La cámara debe publicar entonces en el mismo equipo con el mismo ajuste; si no, no llegan imágenes.

Pantalla completa (segunda PowerShell, sin derechos de administrador). --inprivate: sin historial ni caché más allá de la ventana; --disable-features=Translate: sin ofertas de traducción (una traducción enviaría el texto de la página a un servicio). Comprobar las opciones en la versión instalada del navegador antes de la aceptación:

cd $env:USERPROFILE
Start-Process msedge.exe -ArgumentList '--kiosk http://127.0.0.1:8790/ --edge-kiosk-type=fullscreen --inprivate --disable-features=Translate --no-first-run'

Si la fuente elegida no está disponible (por ejemplo falta ROS 2), el programa termina con «Nicht verfügbar: …» y el código de retorno 2.

6 Emparejar los aparatos Bluetooth LE

No se utiliza en el funcionamiento en la MEDICA

En el stand de la MEDICA no se utilizan aparatos de medición; esta sección solo se aplica a un funcionamiento posterior con aparatos.

Solo se admiten aparatos con el perfil estándar Bluetooth LE: pulsioxímetro con marcado CE (Pulse Oximeter Service 0x1822), tensiómetro de brazo con marcado CE (Blood Pressure Service 0x1810), termómetro de frente sin contacto con marcado CE (Health Thermometer Service 0x1809).

  1. Antes del primer uso, comprobar con una aplicación de escaneo Bluetooth LE que el aparato ofrece el servicio 0x1822, 0x1810 o 0x1809. Un aparato sin perfil estándar no puede utilizarse.
  2. Emparejar el aparato en el sistema operativo (Windows: Configuración › Bluetooth y dispositivos; Linux: las herramientas Bluetooth del sistema), según las instrucciones de uso del aparato. Algunos aparatos aceptan solo un receptor emparejado: emparejarlo con otro receptor anula el primero.
  3. Introducir la dirección Bluetooth del aparato en vitals.json en ble.pulsoximeter, ble.blutdruck o ble.thermometer. Las direcciones son datos del emplazamiento: no ponerlas en tickets, documentos ni repositorios.
  4. Reiniciar el programa. Se conecta solo a las direcciones introducidas, se suscribe a las características de medición (sección 3 de la página de interfaces) y se vuelve a conectar cada 5 s si se pierde la conexión. No hay búsqueda de otros aparatos.
  5. Probar con una medición: el valor debe aparecer en la pantalla cuando el aparato haya terminado la medición.

Ráfaga tras la conexión. Muchos tensiómetros y termómetros solo se conectan después de la medición, envían de inmediato (a menudo primero mediciones antiguas guardadas, luego la actual, normalmente con marca de tiempo del aparato) y se desconectan. Por eso, tras cada conexión, el paquete recoge los paquetes de presión arterial y de temperatura hasta que han pasado ble_schwall_s (3 s) y no ha llegado nada durante 1 s (como máximo 9 s), o hasta que el aparato se desconecta, y muestra solo el más reciente: según la marca de tiempo del aparato si todos los paquetes la tienen; si no, el último recibido. Los paquetes sueltos que llegan después se muestran al instante. Las marcas de tiempo ya no se descartan. Límite: si la medición actual falla en el aparato (sin valor nuevo), el paquete más reciente es una medición antigua y se muestra; comprobar en la aceptación con el aparato elegido si esto ocurre. Si el reloj del aparato está mal, el orden por marca de tiempo es incorrecto. El pulsioxímetro no se ve afectado (marca él mismo los datos guardados).

Cambio de persona. La detección solo encuentra rostros de frente; quien mira su brazo durante la medición de la presión arterial es «sin rostro» para la cámara. Por eso un rostro nuevo solo cuenta como persona nueva (sesión nueva, todos los valores vacíos) si (1) no ha habido rostro durante al menos personenwechsel_s (15 s), (2) no ha llegado ningún valor de aparato válido desde la pérdida del rostro y (3) el último mensaje de aparato (incluido «midiendo») tiene al menos geraet_nachlauf_s (30 s). Los valores de aparato sin rostro solo se borran tras ohne_gesicht_leeren_s (20 s) y solo si tampoco ha llegado ningún mensaje de aparato durante 30 s. La duración máxima max_sitzung_s (120 s) sigue siendo un límite estricto. Para un cambio inmediato existe el botón «Nueva persona». Consecuencia: si otra persona se sienta en los 30 s siguientes a una medición de aparato, los valores se mantienen hasta que termina la duración máxima o el personal del stand pulsa «Nueva persona»; instruir al personal del stand en consecuencia. En el stand es obligatorio pulsar «Nueva persona» en cada cambio de visitante; la detección automática es solo un recurso de reserva.

Hora del aparato. Algunos tensiómetros esperan que el receptor escriba la hora tras la conexión (Date Time 0x2A08 o Current Time Service 0x1805) y, si no, no miden ni envían. El paquete no escribe a propósito nada en los aparatos (solo lectura). Comprobarlo en la aceptación con el aparato elegido; si necesita la hora, es un paso aparte que requiere aprobación.

7 Captura de red para la aceptación

Protección de red en el proceso. Al iniciar el modo de medición, el programa bloquea toda conexión a direcciones distintas de 127.0.0.0/8, ::1, localhost y sockets Unix locales (D-Bus local para Bluetooth en Linux) antes de enviar un paquete, incluida la resolución de nombres. El registro muestra entonces «Verbindung nach außen abgelehnt» (sin la dirección).

Para la aceptación se registran dos pruebas durante las mediciones (una captura de todo el ordenador contiene también tráfico de otros programas, por ejemplo Windows y el navegador):

  1. Conexiones del proceso de medición (PowerShell, sin derechos de administrador; terminar con Ctrl+C). Muestra toda conexión del proceso que no va a 127.0.0.1 o ::1; no se espera ninguna línea:

    cd $env:USERPROFILE
    $ids = (Get-CimInstance Win32_Process -Filter "Name = 'python.exe'" | Where-Object { $_.CommandLine -like '*-m ume_vitals*' }).ProcessId
    while ($true) { Get-NetTCPConnection -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess -and $_.RemoteAddress -notin @('127.0.0.1', '::1', '0.0.0.0', '::') } | Format-Table -AutoSize; Get-NetUDPEndpoint -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess } | Format-Table -AutoSize; Start-Sleep -Seconds 1 }
    
  2. Captura de todo el ordenador con pktmon (PowerShell como administrador; comprobar la sintaxis con pktmon help antes de la aceptación):

    cd $env:USERPROFILE
    pktmon filter remove
    pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etl
    

    Realizar las mediciones y después:

    cd $env:USERPROFILE
    pktmon stop
    pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapng
    

    Abrir el archivo .pcapng en un analizador de red y filtrar el tráfico que no va a las direcciones de bucle local (!(ip.addr == 127.0.0.0/8) && !(ipv6.addr == ::1)); asignar cada conexión encontrada al proceso de medición con la prueba 1, o descartarla.

Linux (placa de percepción, Bash con sudo):

cd "$HOME"
sudo tcpdump -i any -n -w "$HOME/vitals-mitschnitt.pcap" 'not (net 127.0.0.0/8 or ip6 host ::1)'

Después sudo tcpdump -n -r "$HOME/vitals-mitschnitt.pcap" y ss -tunap | grep python.

Tratar los archivos de captura como datos de medición: no transmitirlos, eliminarlos tras la evaluación.

8 Límites de este estado

  • Precisión no comprobada en personas. Todas las pruebas se realizan con señales sintéticas, simulaciones y el simulador; ninguna cámara real, ningún aparato de medición real, ninguna persona.
  • Los umbrales de calidad (pulso: SNR blanqueado, por defecto POS 1 dB, CHROM 2,5 dB; respiración 3 dB en la banda respiratoria y 25 dB sobre el ruido de fondo) se derivaron de señales sintéticas. Si se ajustan a cámaras reales está por ver; el umbral del pulso se puede ajustar en vitals.json. Con deriva lenta, POS dio menos valores de pulso que antes en las pruebas sintéticas; CHROM es débil con deriva y no se recomienda para el stand.
  • Red ROS (DDS). La protección de red actúa solo a nivel de Python; ROS 2 abre sus sockets fuera de Python. Por eso la fuente ROS solo se inicia en un entorno ROS limitado al equipo (sección 5). Qué versión de ROS funciona en la placa de percepción y si el tema de cámara está disponible allí de forma local está aún por aclarar.
  • Linux, la placa de percepción y ROS 2 no están instalados ni probados.
  • Regla de estabilidad: un valor de la cámara solo aparece cuando stabil_anzahl (3) estimaciones seguidas (una por segundo) están por encima del umbral y dentro de ± stabil_toleranz_bpm (5 /min; respiración ± stabil_toleranz_atem, 3 /min) alrededor de su mediana; se muestra la mediana. Una estimación por debajo del umbral o un valor atípico retira el valor. En pruebas sintéticas con 8000 pasadas de ruido, POS aún dio dos valores erróneos y CHROM uno con esta regla.
  • El comportamiento de los aparatos de medición elegidos al conectarse (ráfaga, mediciones guardadas, marca de tiempo, hora, medición fallida) debe comprobarse en la aceptación (sección 6).
  • La exposición y el balance de blancos automáticos de la webcam pueden falsear la medición; no se desactivan (depende de la cámara).
  • La detección solo encuentra rostros de frente; gafas, mascarilla, contraluz y una cabina oscura empeoran la detección.
  • El navegador del ordenador del monitor no forma parte de este paquete; evaluar su propio tráfico en la captura.

9 Pruebas

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m pytest -v

Cubierto: pulso y frecuencia respiratoria con señales sintéticas (POS y CHROM), ningún valor con ruido (también ruido 1/f²), ventana demasiado corta o sin rostro, analizador Bluetooth LE con paquetes conformes a la especificación (también temperatura corporal), mediciones guardadas, estado del sensor, rangos y marcas de tiempo, ninguna conexión saliente en modo de medición, pantalla solo en 127.0.0.1, el fin de sesión, la duración máxima y el cambio de persona lo borran todo, registro sin valores, fuente ROS solo si está limitada al equipo, valores de aparato en la interfaz de la pantalla ≤ 5 s tras el fin de la medición (simulador). Estado a 04.11.2026: 419 pruebas superadas (Windows, Python 3.12.10).


Manuale del tecnico — Misurazione dei parametri vitali sul dispositivo uMe (anteprima)

Stato al 04.11.2026, pacchetto vitals/ del repository ume-eyes, versione 0.4.0 (anteprima, UME-297). Bozza — non ancora rilasciata. Il pacchetto è in sviluppo, non ancora integrato e non installato su alcun dispositivo. Non è stato provato con una telecamera reale, con dispositivi di misura reali o con persone.

Per IT, tecnici e partner di integrazione

Riferimento tecnico per reparti IT, tecnici URG e partner formati. Non è un manuale d’uso per gli utenti finali.

Dimostrazione – non è un dispositivo medico. Nessuna diagnosi.

Il software mostra valori solo a scopo dimostrativo. Non valuta nulla. La precisione di polso e frequenza respiratoria dalla telecamera non è ancora stata verificata su persone.

Funzionamento allo stand della MEDICA: solo telecamera

Allo stand della MEDICA vengono misurati solo polso e frequenza respiratoria con la telecamera, in locale sul dispositivo; SpO₂, pressione arteriosa e temperatura corporea non vengono misurate né mostrate. I dispositivi Bluetooth LE sono predisposti nel codice ma disattivati da configurazione (nessun indirizzo in ble); la pagina non mostra quindi campi dei dispositivi. Il personale dello stand preme «Nuova persona» a ogni cambio di visitatore (obbligatorio). Immagini e valori restano sul dispositivo.

1 Panoramica

Parte Compito
Sorgente telecamera webcam USB sul computer del monitor (predefinita), topic telecamera ROS 2 (sola lettura) o simulatore
Elaborazione del segnale rilevamento del volto, aree di misura fronte e guance, polso e frequenza respiratoria (rPPG, metodi POS o CHROM), qualità del segnale
Ricezione Bluetooth LE valori di dispositivi con marcatura CE e profilo standard Bluetooth LE: pulsossimetro (0x1822), misuratore di pressione da braccio (0x1810), termometro frontale senza contatto (0x1809; °C con un decimale, nessuna valutazione della febbre)
Display pagina web a schermo intero, servita solo su 127.0.0.1, sei lingue (DE, EN, FR, ES, IT, NL)

Il pacchetto non ha alcuna interfaccia con l’uscita vocale, il servizio di inoltro di uMe Eyes o un cloud. Non invia nulla tramite ROS, non scrive nulla sui dispositivi di misura e non ha accesso alle funzioni di marcia o di movimento del robot.

2 Protezione dei dati (G-02a)

Regola Attuazione
Nessuna immagine e nessun valore lascia il dispositivo display solo su 127.0.0.1 (nessuna impostazione per un altro indirizzo); protezione di rete nel processo (sezione 7); nessuna libreria di rete nel codice
Nessuna memorizzazione nessun file, nessun database, nessuna memoria del browser; ogni immagine della telecamera è ridotta a tre valori medi; risposte HTTP con Cache-Control: no-store
Nessuna registrazione di valori o immagini il registro contiene solo messaggi di stato fissi senza valori
Nessun dato personale il rilevamento del volto restituisce solo un rettangolo; ID utente e marca temporale inviati dai dispositivi vengono letti ma mai conservati
La fine della sessione cancella tutto pulsanti o endpoint «Termina sessione» e «Nuova persona», timeout (60 s senza volto e senza valore valido da un dispositivo), durata massima (120 s, limite rigido), cambio di persona (vedere «Cambio di persona» nella sezione 6): campi vuoti, buffer circolari sovrascritti con zeri, display vuoto; le stime superate vengono scartate
Nessun valore per la persona successiva valori dei dispositivi cancellati dopo 20 s senza volto, appena non arriva alcun messaggio da un dispositivo da 30 s; valori della telecamera cancellati 2 s dopo l’ultima immagine; dopo il collegamento di un dispositivo viene mostrato solo il suo valore più recente (sezione 6)
Nessuna valutazione nessun colore a semaforo, nessun intervallo normale, nessuna parola valutativa; i bit del dispositivo «polso irregolare» e «intervallo del polso» non vengono valutati

Limite: Python rilascia i valori intermedi dopo l’uso (ad esempio la risposta JSON) ma non sovrascrive quella memoria. I buffer della catena di misura vengono sovrascritti; i campi della sessione vengono svuotati. Dopo la fine del processo non resta nulla.

3 Installazione

Requisiti: Python 3.12, copia di lavoro di ume-eyes con la versione integrata in %USERPROFILE%\dev\ume-eyes. Internet serve una sola volta per l’installazione; in modalità di misura tutto funziona senza rete. Tutti i comandi: PowerShell, senza diritti di amministratore.

cd $env:USERPROFILE\dev\ume-eyes\vitals
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -v

Tutti i pacchetti sono fissati esattamente (==) in requirements.txt (esercizio) e requirements-dev.txt (solo test); la motivazione è in vitals/ABHAENGIGKEITEN.md. Nessuno carica modelli o dati in esecuzione, nessuno invia telemetria.

Pacchetto Versione Compito
numpy 2.5.4 elaborazione del segnale
opencv-python-headless 4.14.0.94 leggere la webcam, rilevamento del volto con il modello incluso nel pacchetto (nessun download)
bleak 3.0.2 Bluetooth LE: collegamento ai dispositivi configurati, ricezione delle misure
winrt-runtime, winrt-Windows.* 4.1.0 / 4!10.0.28000.2957 solo Windows: ponte verso l’interfaccia Bluetooth di Windows
dbus-fast 5.2.0 solo Linux: ponte verso lo stack Bluetooth tramite il D-Bus locale
pytest 9.2.0 solo test

Nota sulla licenza: il software non viene ceduto ai clienti. Il pacchetto OpenCV contiene la libreria FFmpeg sotto GNU LGPL 2.1; ciò è annotato in NOTICE e con i testi delle licenze in LICENSES/ del pacchetto. Gli obblighi della LGPL valgono solo in caso di cessione.

Linux (scheda di percezione, Bash, senza sudo): python3.12 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt. ROS 2 (rclpy) proviene dall’installazione ROS, non da requirements.txt; in tal caso creare il venv con --system-site-packages. Non provato sotto Linux.

4 Configurazione vitals.json

File %USERPROFILE%\.ume-vitals\vitals.json (fuori dal repository; modello vitals/vitals.beispiel.json). Se manca, valgono i valori predefiniti senza dispositivi di misura. Con --konfig si può indicare un altro file. Voci sconosciute e valori fuori dagli intervalli sotto vengono rifiutati con un messaggio di errore.

Voce Predefinito Significato
quelle webcam webcam, ros o simulator (l’opzione di avvio --quelle ha la precedenza)
kamera_index 0 numero della webcam USB, intero 0–9
ros_thema /ume/camera/color/image_raw topic della telecamera (sola lettura), inizia con /
verfahren pos pos o chrom
fenster_s 15 finestra del polso, 10–20 s
atem_fenster_s 20 finestra della respirazione, 15–60 s
qualitaet_schwelle_db null qualità minima del segnale (SNR sbiancato) per un valore del polso; null = valore predefinito del metodo (POS 1 dB, CHROM 2,5 dB), altrimenti da 0 a 20 dB
stabil_anzahl 3 numero di stime consecutive sopra la soglia prima che compaia un valore della telecamera, 1–10
stabil_toleranz_bpm 5 tutte queste stime del polso devono stare entro ± questo valore attorno alla loro mediana, 1–20 /min
stabil_toleranz_atem 3 lo stesso per la frequenza respiratoria, 1–10 /min
sitzung_timeout_s 60 fine della sessione senza volto e senza valore valido da un dispositivo, 10–600 s
max_sitzung_s 120 durata massima di una sessione dalla prima attività, 30–900 s
ohne_gesicht_leeren_s 20 cancellare i valori dei dispositivi dopo questo tempo senza volto, 5–120 s
personenwechsel_s 15 dopo questo tempo senza volto (e senza misura da un dispositivo, vedere geraet_nachlauf_s), un volto nuovo conta come persona nuova, 5–120 s
geraet_nachlauf_s 30 per questo tempo dopo l’ultimo messaggio di un dispositivo, una misura del dispositivo è considerata in corso: nessun cambio di persona, nessuna cancellazione senza volto, 10–300 s
port 8790 porta del display su 127.0.0.1, 1024–65535
ble_schwall_s 3 dopo il collegamento raccogliere per questo tempo (e fino a 1 s di quiete) i pacchetti di pressione arteriosa e temperatura e mostrare solo il più recente, 0,5–10 s
ble.pulsoximeter, ble.blutdruck, ble.thermometer vuoto indirizzo Bluetooth del dispositivo associato in precedenza (formato AA:BB:CC:DD:EE:FF); vuoto = dispositivo non usato

Di proposito non esiste alcuna voce per l’indirizzo di un server.

5 Avvio

PowerShell, senza diritti di amministratore. La console mostra l’indirizzo del display e l’ID del processo (per la cattura di rete). Terminare con Ctrl+C; la sessione viene svuotata. Un watchdog controlla ogni secondo i tempi della sessione e riavvia una sorgente telecamera che si è fermata.

Tra i tentativi di riavvio della sorgente telecamera il watchdog attende 1, 2, 4, 8 e 16 s, poi 30 s ogni volta; quando la sorgente funziona di nuovo, ricomincia da 1 s.

Solo questo pacchetto per la misurazione dei parametri vitali

Allo stand avviare esclusivamente questo pacchetto per la misurazione dei parametri vitali; il precedente rilevamento dei parametri vitali di ume_main non viene utilizzato lì.

Simulatore (senza telecamera; per impostazione predefinita solo misurazione con la telecamera, con --mit-geraeten anche valori simulati di pulsossimetro, pressione e temperatura; la pagina mostra in modo visibile «Simulazione – nessuna misurazione reale»):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle simulator

Webcam USB (predefinita):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle webcam

Topic telecamera ROS (sulla scheda di percezione, Bash, ambiente ROS caricato). La sorgente si avvia solo se ROS è limitato al dispositivo (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST o ROS_LOCALHOST_ONLY=1); altrimenti il programma termina con «Nicht verfügbar: ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1 fehlt»:

cd "$HOME/ume-eyes/vitals"
ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ROS_LOCALHOST_ONLY=1 .venv/bin/python -m ume_vitals --quelle ros

La telecamera deve allora pubblicare sullo stesso dispositivo con la stessa impostazione, altrimenti non arrivano immagini.

Display a schermo intero (seconda PowerShell, senza diritti di amministratore). --inprivate: nessuna cronologia e nessuna cache oltre la finestra; --disable-features=Translate: nessuna proposta di traduzione (una traduzione invierebbe il testo della pagina a un servizio). Verificare le opzioni sulla versione installata del browser prima del collaudo:

cd $env:USERPROFILE
Start-Process msedge.exe -ArgumentList '--kiosk http://127.0.0.1:8790/ --edge-kiosk-type=fullscreen --inprivate --disable-features=Translate --no-first-run'

Se la sorgente scelta non è disponibile (ad esempio manca ROS 2), il programma termina con «Nicht verfügbar: …» e codice di uscita 2.

6 Associare i dispositivi Bluetooth LE

Non usato nel funzionamento alla MEDICA

Allo stand della MEDICA non si usano dispositivi di misura; questa sezione vale solo per un successivo funzionamento con dispositivi.

Sono supportati solo dispositivi con il profilo standard Bluetooth LE: pulsossimetro con marcatura CE (Pulse Oximeter Service 0x1822), misuratore di pressione da braccio con marcatura CE (Blood Pressure Service 0x1810), termometro frontale senza contatto con marcatura CE (Health Thermometer Service 0x1809).

  1. Prima del primo utilizzo, verificare con un’app di scansione Bluetooth LE che il dispositivo offra il servizio 0x1822, 0x1810 o 0x1809. Un dispositivo senza profilo standard non può essere utilizzato.
  2. Associare il dispositivo nel sistema operativo (Windows: Impostazioni › Bluetooth e dispositivi; Linux: gli strumenti Bluetooth del sistema), seguendo le istruzioni per l’uso del dispositivo. Alcuni dispositivi accettano un solo ricevitore associato: l’associazione con un altro ricevitore annulla la prima.
  3. Inserire l’indirizzo Bluetooth del dispositivo in vitals.json sotto ble.pulsoximeter, ble.blutdruck o ble.thermometer. Gli indirizzi sono dati del sito: non inserirli in ticket, documenti o repository.
  4. Riavviare il programma. Si collega solo agli indirizzi inseriti, si abbona alle caratteristiche di misura (sezione 3 della pagina delle interfacce) e si ricollega ogni 5 s se la connessione si interrompe. Non c’è ricerca di altri dispositivi.
  5. Provare con una misurazione: il valore deve comparire sul display dopo che il dispositivo ha concluso la misurazione.

Raffica dopo il collegamento. Molti misuratori di pressione e termometri si collegano solo dopo la misura, inviano subito (spesso prima misure vecchie memorizzate, poi quella attuale, di solito con marca temporale del dispositivo) e si scollegano. Per questo, dopo ogni collegamento, il pacchetto raccoglie i pacchetti di pressione arteriosa e temperatura finché non sono trascorsi ble_schwall_s (3 s) e per 1 s non è arrivato più nulla (al massimo 9 s), oppure finché il dispositivo si scollega, e mostra solo il più recente: in base alla marca temporale se tutti i pacchetti ne hanno una, altrimenti l’ultimo ricevuto. I singoli pacchetti che arrivano in seguito vengono mostrati subito. Le marche temporali non vengono più scartate. Limite: se la misura attuale fallisce sul dispositivo (nessun valore nuovo), il pacchetto più recente è una misura vecchia e viene mostrato: verificare al collaudo con il dispositivo scelto se ciò accade. Se l’orologio del dispositivo è sbagliato, l’ordine per marca temporale non è corretto. Il pulsossimetro non è interessato (contrassegna da sé i dati memorizzati).

Cambio di persona. Il rilevamento trova solo volti frontali; chi guarda il braccio durante la misura della pressione è «senza volto» per la telecamera. Un volto nuovo conta quindi come persona nuova (nuova sessione, tutti i valori vuoti) solo se (1) per almeno personenwechsel_s (15 s) non c’è stato alcun volto, (2) dalla perdita del volto non è arrivato alcun valore valido da un dispositivo e (3) l’ultimo messaggio di un dispositivo (anche «misurazione in corso») risale ad almeno geraet_nachlauf_s (30 s). I valori dei dispositivi senza volto vengono cancellati solo dopo ohne_gesicht_leeren_s (20 s) e solo se anche per 30 s non è arrivato alcun messaggio da un dispositivo. La durata massima max_sitzung_s (120 s) resta un limite rigido. Per un cambio immediato c’è il pulsante «Nuova persona». Conseguenza: se un’altra persona si siede entro 30 s da una misura del dispositivo, i valori restano finché non termina la durata massima o il personale dello stand preme «Nuova persona» — istruire di conseguenza il personale dello stand. Allo stand è obbligatorio premere «Nuova persona» a ogni cambio di visitatore; il riconoscimento automatico è solo una soluzione di riserva.

Ora del dispositivo. Alcuni misuratori di pressione si aspettano che il ricevitore scriva l’ora dopo il collegamento (Date Time 0x2A08 o Current Time Service 0x1805) e altrimenti non misurano o non inviano. Il pacchetto di proposito non scrive nulla sui dispositivi (sola lettura). Verificarlo al collaudo con il dispositivo scelto; se serve l’ora, si tratta di un passo separato da approvare.

7 Cattura di rete per il collaudo

Protezione di rete nel processo. All’avvio della modalità di misura il programma blocca ogni connessione verso indirizzi diversi da 127.0.0.0/8, ::1, localhost e socket Unix locali (D-Bus locale per il Bluetooth sotto Linux) prima che venga inviato un pacchetto, compresa la risoluzione dei nomi. Il registro mostra allora «Verbindung nach außen abgelehnt» (senza l’indirizzo).

Per il collaudo si registrano due prove durante le misurazioni (una cattura dell’intero computer contiene anche il traffico di altri programmi, ad esempio Windows e il browser):

  1. Connessioni del processo di misura (PowerShell, senza diritti di amministratore; terminare con Ctrl+C). Mostra ogni connessione del processo che non va verso 127.0.0.1 o ::1; non è attesa alcuna riga:

    cd $env:USERPROFILE
    $ids = (Get-CimInstance Win32_Process -Filter "Name = 'python.exe'" | Where-Object { $_.CommandLine -like '*-m ume_vitals*' }).ProcessId
    while ($true) { Get-NetTCPConnection -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess -and $_.RemoteAddress -notin @('127.0.0.1', '::1', '0.0.0.0', '::') } | Format-Table -AutoSize; Get-NetUDPEndpoint -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess } | Format-Table -AutoSize; Start-Sleep -Seconds 1 }
    
  2. Cattura dell’intero computer con pktmon (PowerShell come amministratore; verificare la sintassi con pktmon help prima del collaudo):

    cd $env:USERPROFILE
    pktmon filter remove
    pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etl
    

    Eseguire le misurazioni, poi:

    cd $env:USERPROFILE
    pktmon stop
    pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapng
    

    Aprire il file .pcapng in un analizzatore di rete e filtrare il traffico non diretto agli indirizzi di loopback (!(ip.addr == 127.0.0.0/8) && !(ipv6.addr == ::1)); attribuire ogni connessione trovata al processo di misura con la prova 1, oppure escluderla.

Linux (scheda di percezione, Bash con sudo):

cd "$HOME"
sudo tcpdump -i any -n -w "$HOME/vitals-mitschnitt.pcap" 'not (net 127.0.0.0/8 or ip6 host ::1)'

Poi sudo tcpdump -n -r "$HOME/vitals-mitschnitt.pcap" e ss -tunap | grep python.

Trattare i file di cattura come dati di misura: non trasmetterli, rimuoverli dopo la valutazione.

8 Limiti di questo stato

  • Precisione non verificata su persone. Tutti i test usano segnali sintetici, simulacri e il simulatore; nessuna telecamera reale, nessun dispositivo di misura reale, nessuna persona.
  • Le soglie di qualità (polso: SNR sbiancato, predefinito POS 1 dB, CHROM 2,5 dB; respirazione 3 dB nella banda respiratoria e 25 dB sopra il rumore di fondo) sono state ricavate da segnali sintetici. Se siano adatte a telecamere reali è ancora aperto; la soglia del polso è regolabile in vitals.json. Con deriva lenta POS ha fornito nei test sintetici meno valori del polso di prima; CHROM è debole con la deriva e non è consigliato per lo stand.
  • Rete ROS (DDS). La protezione di rete agisce solo a livello Python; ROS 2 apre i suoi socket al di fuori di Python. Per questo la sorgente ROS si avvia solo in un ambiente ROS limitato al dispositivo (sezione 5). Quale versione di ROS giri sulla scheda di percezione e se il topic della telecamera vi sia disponibile localmente è ancora da chiarire.
  • Linux, la scheda di percezione e ROS 2 non sono installati né provati.
  • Regola di stabilità: un valore della telecamera compare solo quando stabil_anzahl (3) stime consecutive (una al secondo) sono sopra la soglia ed entro ± stabil_toleranz_bpm (5 /min; respirazione ± stabil_toleranz_atem, 3 /min) attorno alla loro mediana; viene mostrata la mediana. Una stima sotto la soglia o un valore anomalo toglie di nuovo il valore. In test sintetici con 8000 passaggi di rumore, con questa regola POS ha dato ancora due valori errati e CHROM uno.
  • Il comportamento dei dispositivi di misura scelti al collegamento (raffica, misure memorizzate, marca temporale, ora, misura fallita) va verificato al collaudo (sezione 6).
  • Esposizione e bilanciamento del bianco automatici della webcam possono falsare la misura; non vengono disattivati (dipende dalla telecamera).
  • Il rilevamento trova solo volti frontali; occhiali, mascherina, controluce e una cabina buia peggiorano il rilevamento.
  • Il browser del computer del monitor non fa parte di questo pacchetto; valutarne il traffico nella cattura.

9 Test

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m pytest -v

Coperto: polso e frequenza respiratoria con segnali sintetici (POS e CHROM), nessun valore con rumore (anche rumore 1/f²), finestra troppo corta o senza volto, parser Bluetooth LE con pacchetti conformi alla specifica (anche temperatura corporea), misure memorizzate, stato del sensore, intervalli e marche temporali, nessuna connessione in uscita in modalità di misura, display solo su 127.0.0.1, fine della sessione, durata massima e cambio di persona cancellano tutto, registro senza valori, sorgente ROS solo se limitata al dispositivo, valori del dispositivo all’interfaccia del display ≤ 5 s dopo la fine della misurazione (simulatore). Stato al 04.11.2026: 419 test superati (Windows, Python 3.12.10).


Handboek technicus — Meting van vitale functies op het apparaat uMe (preview)

Stand 04.11.2026, pakket vitals/ in de repository ume-eyes, versie 0.4.0 (preview, UME-297). Concept — nog niet vrijgegeven. Het pakket is in ontwikkeling, nog niet overgenomen en op geen enkel apparaat geïnstalleerd. Het is niet getest met een echte camera, echte meetapparaten of personen.

Voor IT, technici en integratiepartners

Technische referentie voor IT-afdelingen, URG-technici en opgeleide partners. Geen gebruiksaanwijzing voor eindgebruikers.

Demonstratie – geen medisch hulpmiddel. Geen diagnose.

De software toont waarden alleen ter demonstratie. Ze beoordeelt niets. De nauwkeurigheid van hartslag en ademfrequentie uit de camera is nog niet bij mensen gecontroleerd.

Standbedrijf op de MEDICA: alleen camera

Op de stand op de MEDICA worden alleen hartslag en ademfrequentie met de camera gemeten, lokaal op het apparaat; SpO₂, bloeddruk en lichaamstemperatuur worden niet gemeten en niet getoond. De Bluetooth LE-apparaten zijn in de code voorbereid, maar via de configuratie uitgeschakeld (geen adres onder ble); de pagina toont dan geen apparaatvelden. Het standpersoneel drukt bij elke wisseling van bezoeker op „Nieuwe persoon” (verplicht). Beelden en waarden blijven op het apparaat.

1 Overzicht

Onderdeel Taak
Camerabron USB-webcam aan de monitorcomputer (standaard), ROS 2-cameratopic (alleen lezen) of simulator
Signaalverwerking gezichtsherkenning, meetvlakken voorhoofd en wangen, hartslag en ademfrequentie (rPPG, methoden POS of CHROM), signaalkwaliteit
Bluetooth LE-ontvangst waarden van CE-gemarkeerde apparaten met Bluetooth LE-standaardprofiel: pulsoximeter (0x1822), bovenarmbloeddrukmeter (0x1810), contactloze voorhoofdthermometer (0x1809; °C met één decimaal, geen koortsbeoordeling)
Scherm webpagina op volledig scherm, alleen aangeboden op 127.0.0.1, zes talen (DE, EN, FR, ES, IT, NL)

Het pakket heeft geen interface met de spraakuitvoer, de doorgeefdienst van uMe Eyes of een cloud. Het verstuurt niets via ROS, schrijft niets naar de meetapparaten en heeft geen toegang tot rij- of bewegingsfuncties van de robot.

2 Gegevensbescherming (G-02a)

Regel Uitvoering
Geen beeld en geen waarde verlaat het apparaat scherm alleen op 127.0.0.1 (geen instelling voor een ander adres); netwerkbeveiliging in het proces (sectie 7); geen netwerkbibliotheken in de code
Geen opslag geen bestand, geen database, geen browseropslag; elk camerabeeld wordt teruggebracht tot drie gemiddelden; HTTP-antwoorden met Cache-Control: no-store
Geen logging van waarden of beelden het logboek bevat alleen vaste statusmeldingen zonder waarden
Geen persoonsgegevens de gezichtsherkenning levert alleen een rechthoek; gebruikers-ID en tijdstempel van de apparaten worden gelezen maar nooit bewaard
Einde van de sessie wist alles knoppen of eindpunten „Sessie beëindigen” en „Nieuwe persoon”, time-out (60 s zonder gezicht en zonder geldige apparaatwaarde), maximale duur (120 s, harde grens), wisseling van persoon (zie „Wisseling van persoon” in sectie 6): velden leeg, ringbuffers met nullen overschreven, scherm leeg; verouderde schattingen worden verworpen
Geen waarde voor de volgende persoon apparaatwaarden gewist na 20 s zonder gezicht, zodra er 30 s geen apparaatmelding is gekomen; camerawaarden gewist 2 s na het laatste beeld; na het verbinden van een apparaat wordt alleen zijn nieuwste waarde getoond (sectie 6)
Geen beoordeling geen stoplichtkleuren, geen normaalwaarden, geen beoordelende woorden; de apparaatbits „onregelmatige hartslag” en „hartslagbereik” worden niet geëvalueerd

Grens: Python geeft tussenwaarden (bijvoorbeeld het JSON-antwoord) na gebruik vrij, maar overschrijft dat geheugen niet. De ringbuffers van de meetketen worden overschreven; de velden van de sessie worden leeggemaakt. Na het einde van het proces blijft niets over.

3 Installatie

Vereisten: Python 3.12, werkkopie van ume-eyes met de overgenomen stand onder %USERPROFILE%\dev\ume-eyes. Internet is eenmalig nodig voor de installatie; in meetmodus werkt alles zonder netwerk. Alle opdrachten: PowerShell, zonder beheerdersrechten.

cd $env:USERPROFILE\dev\ume-eyes\vitals
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -v

Alle pakketten zijn exact vastgezet (==) in requirements.txt (bedrijf) en requirements-dev.txt (alleen tests); de motivering staat in vitals/ABHAENGIGKEITEN.md. Geen enkel pakket laadt tijdens de uitvoering modellen of gegevens, geen enkel pakket verstuurt telemetrie.

Pakket Versie Taak
numpy 2.5.4 signaalverwerking
opencv-python-headless 4.14.0.94 webcam lezen, gezichtsherkenning met het in het pakket meegeleverde gezichtsmodel (geen download)
bleak 3.0.2 Bluetooth LE: verbinding met de ingestelde apparaten, ontvangst van metingen
winrt-runtime, winrt-Windows.* 4.1.0 / 4!10.0.28000.2957 alleen Windows: brug naar de Bluetooth-interface van Windows
dbus-fast 5.2.0 alleen Linux: brug naar de Bluetooth-stack via de lokale D-Bus
pytest 9.2.0 alleen tests

Licentieopmerking: de software wordt niet aan klanten doorgegeven. Het OpenCV-pakket bevat de bibliotheek FFmpeg onder de GNU LGPL 2.1; dit is vastgelegd in NOTICE en met de licentieteksten in LICENSES/ van het pakket. De verplichtingen van de LGPL gelden alleen bij doorgifte.

Linux (perceptiebord, Bash, zonder sudo): python3.12 -m venv .venv && .venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt. ROS 2 (rclpy) komt uit de ROS-installatie, niet uit requirements.txt; maak de venv dan aan met --system-site-packages. Niet getest onder Linux.

4 Configuratie vitals.json

Bestand %USERPROFILE%\.ume-vitals\vitals.json (buiten de repository; sjabloon vitals/vitals.beispiel.json). Ontbreekt het, dan gelden de standaardwaarden zonder meetapparaten. Met --konfig kan een ander bestand worden opgegeven. Onbekende items en waarden buiten de bereiken hieronder worden met een foutmelding geweigerd.

Item Standaard Betekenis
quelle webcam webcam, ros of simulator (de startoptie --quelle heeft voorrang)
kamera_index 0 nummer van de USB-webcam, geheel getal 0–9
ros_thema /ume/camera/color/image_raw cameratopic (alleen lezen), begint met /
verfahren pos pos of chrom
fenster_s 15 hartslagvenster, 10–20 s
atem_fenster_s 20 ademvenster, 15–60 s
qualitaet_schwelle_db null minimale signaalkwaliteit (gewitte SNR) voor een hartslagwaarde; null = standaard van de methode (POS 1 dB, CHROM 2,5 dB), anders 0 tot 20 dB
stabil_anzahl 3 aantal opeenvolgende schattingen boven de drempel voordat een camerawaarde verschijnt, 1–10
stabil_toleranz_bpm 5 al deze hartslagschattingen moeten binnen ± deze waarde rond hun mediaan liggen, 1–20 /min
stabil_toleranz_atem 3 hetzelfde voor de ademfrequentie, 1–10 /min
sitzung_timeout_s 60 einde van de sessie zonder gezicht en zonder geldige apparaatwaarde, 10–600 s
max_sitzung_s 120 maximale duur van een sessie vanaf de eerste activiteit, 30–900 s
ohne_gesicht_leeren_s 20 apparaatwaarden wissen als er zo lang geen gezicht in beeld is, 5–120 s
personenwechsel_s 15 na zo lang zonder gezicht (en zonder apparaatmeting, zie geraet_nachlauf_s) geldt een nieuw gezicht als nieuwe persoon, 5–120 s
geraet_nachlauf_s 30 zo lang na de laatste apparaatmelding geldt een apparaatmeting als lopend: geen wisseling van persoon, geen wissen zonder gezicht, 10–300 s
port 8790 poort van het scherm op 127.0.0.1, 1024–65535
ble_schwall_s 3 na het verbinden zo lang (en tot 1 s stilte) bloeddruk- en temperatuurpakketten verzamelen en alleen het nieuwste tonen, 0,5–10 s
ble.pulsoximeter, ble.blutdruck, ble.thermometer leeg Bluetooth-adres van het vooraf gekoppelde apparaat (formaat AA:BB:CC:DD:EE:FF); leeg = apparaat niet gebruiken

Er is bewust geen item voor een serveradres.

5 Starten

PowerShell, zonder beheerdersrechten. De console toont het schermadres en de proces-ID (voor de netwerkopname). Stoppen met Ctrl+C; daarbij wordt de sessie leeggemaakt. Een waakhond controleert elke seconde de sessietijden en start een uitgevallen camerabron opnieuw.

Tussen de herstartpogingen van de camerabron wacht de waakhond 1, 2, 4, 8 en 16 s, daarna telkens 30 s; draait de bron weer, dan begint het opnieuw bij 1 s.

Alleen dit pakket voor de meting van vitale functies

Start op de stand uitsluitend dit pakket voor de meting van vitale functies; de vorige vitale-functieherkenning van ume_main wordt daar niet gebruikt.

Simulator (zonder camera; standaard alleen camerameting, met --mit-geraeten ook gesimuleerde pulsoximeter-, bloeddruk- en temperatuurwaarden; de pagina toont zichtbaar „Simulatie – geen echte meetwaarden”):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle simulator

USB-webcam (standaard):

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m ume_vitals --quelle webcam

ROS-cameratopic (op het perceptiebord, Bash, ROS-omgeving geladen). De bron start alleen als ROS tot het apparaat beperkt is (ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST of ROS_LOCALHOST_ONLY=1); anders stopt het programma met „Nicht verfügbar: ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST oder ROS_LOCALHOST_ONLY=1 fehlt”:

cd "$HOME/ume-eyes/vitals"
ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST ROS_LOCALHOST_ONLY=1 .venv/bin/python -m ume_vitals --quelle ros

De camera moet dan op hetzelfde apparaat met dezelfde instelling publiceren, anders komen er geen beelden aan.

Scherm op volledig scherm (tweede PowerShell, zonder beheerdersrechten). --inprivate: geen geschiedenis en geen cache buiten het venster; --disable-features=Translate: geen vertaalaanbiedingen (een vertaling zou de paginatekst naar een dienst sturen). Controleer de schakelaars vóór de acceptatie op de geïnstalleerde browserversie:

cd $env:USERPROFILE
Start-Process msedge.exe -ArgumentList '--kiosk http://127.0.0.1:8790/ --edge-kiosk-type=fullscreen --inprivate --disable-features=Translate --no-first-run'

Is de gekozen bron niet beschikbaar (bijvoorbeeld ROS 2 ontbreekt), dan stopt het programma met „Nicht verfügbar: …” en retourcode 2.

6 Bluetooth LE-apparaten koppelen

Niet in gebruik op de MEDICA

Op de stand op de MEDICA worden geen meetapparaten gebruikt; deze sectie geldt alleen voor later gebruik met apparaten.

Alleen apparaten met het Bluetooth LE-standaardprofiel worden ondersteund: CE-gemarkeerde pulsoximeter (Pulse Oximeter Service 0x1822), CE-gemarkeerde bovenarmbloeddrukmeter (Blood Pressure Service 0x1810), CE-gemarkeerde contactloze voorhoofdthermometer (Health Thermometer Service 0x1809).

  1. Controleer vóór het eerste gebruik met een Bluetooth LE-scanner-app dat het apparaat de dienst 0x1822, 0x1810 of 0x1809 aanbiedt. Een apparaat zonder standaardprofiel kan niet worden gebruikt.
  2. Koppel het apparaat in het besturingssysteem (Windows: Instellingen › Bluetooth en apparaten; Linux: de Bluetooth-hulpmiddelen van het systeem), volgens de gebruiksaanwijzing van het apparaat. Sommige apparaten accepteren maar één gekoppelde ontvanger — koppelen met een andere ontvanger beëindigt de eerste koppeling.
  3. Vul het Bluetooth-adres van het apparaat in vitals.json in onder ble.pulsoximeter, ble.blutdruck of ble.thermometer. Adressen zijn locatiegegevens — niet in tickets, documenten of repositories.
  4. Start het programma opnieuw. Het maakt alleen verbinding met de ingevulde adressen, abonneert zich op de meetkenmerken (sectie 3 van de interfacepagina) en maakt bij verbindingsverlies elke 5 s opnieuw verbinding. Er wordt niet naar andere apparaten gezocht.
  5. Test met één meting: de waarde moet op het scherm verschijnen nadat het apparaat de meting heeft afgerond.

Salvo na het verbinden. Veel bloeddrukmeters en thermometers maken pas na de meting verbinding, versturen meteen (vaak eerst opgeslagen oude metingen, dan de actuele, meestal met tijdstempel van het apparaat) en verbreken de verbinding. Daarom verzamelt het pakket na elke verbinding bloeddruk- en temperatuurpakketten tot ble_schwall_s (3 s) verstreken is en 1 s niets meer is binnengekomen (hoogstens 9 s), of tot het apparaat de verbinding verbreekt, en toont het daarvan alleen het nieuwste: op tijdstempel van het apparaat als alle pakketten er een hebben, anders het laatst ontvangen pakket. Losse pakketten die daarna binnenkomen, verschijnen meteen. Tijdstempels worden niet meer verworpen. Grens: mislukt de actuele meting op het apparaat (geen nieuwe waarde), dan is het nieuwste pakket een oude meting en verschijnt die — controleer bij de acceptatie met het gekozen apparaat of dat voorkomt. Loopt de klok van het apparaat verkeerd, dan klopt de volgorde op tijdstempel niet. De pulsoximeter wordt niet getroffen (die markeert opgeslagen gegevens zelf).

Wisseling van persoon. De gezichtsherkenning vindt alleen frontale gezichten; wie tijdens de bloeddrukmeting naar de arm kijkt, is voor de camera „geen gezicht”. Een nieuw gezicht geldt daarom alleen als nieuwe persoon (nieuwe sessie, alle waarden leeg) als (1) er minstens personenwechsel_s (15 s) geen gezicht in beeld was, (2) sinds het verlies van het gezicht geen geldige apparaatwaarde is binnengekomen en (3) de laatste apparaatmelding (ook „meting loopt”) minstens geraet_nachlauf_s (30 s) geleden is. Apparaatwaarden zonder gezicht worden pas na ohne_gesicht_leeren_s (20 s) gewist en alleen als er ook 30 s geen apparaatmelding kwam. De maximale duur max_sitzung_s (120 s) blijft een harde grens. Voor een directe wisseling is er de knop „Nieuwe persoon”. Gevolg: gaat er binnen 30 s na een apparaatmeting iemand anders zitten, dan blijven de waarden staan tot de maximale duur afloopt of het standpersoneel op „Nieuwe persoon” drukt — instrueer het standpersoneel daarover. Op de stand is „Nieuwe persoon” bij elke wisseling van bezoeker verplicht; de automatische herkenning is alleen een terugvaloptie.

Tijd op het apparaat. Sommige bloeddrukmeters verwachten dat de ontvanger na het verbinden de tijd schrijft (Date Time 0x2A08 of Current Time Service 0x1805) en meten of verzenden anders niet. Het pakket schrijft bewust niets naar apparaten (alleen lezen). Controleer dit bij de acceptatie met het gekozen apparaat; heeft het de tijd nodig, dan is dat een aparte stap die vrijgegeven moet worden.

7 Netwerkopname voor de acceptatie

Netwerkbeveiliging in het proces. Bij de start van de meetmodus blokkeert het programma elke verbinding met andere adressen dan 127.0.0.0/8, ::1, localhost en lokale Unix-sockets (lokale D-Bus voor Bluetooth onder Linux) voordat een pakket wordt verzonden, inclusief naamomzetting. In het logboek staat dan „Verbindung nach außen abgelehnt” (zonder adres).

Voor de acceptatie worden tijdens de metingen twee bewijzen vastgelegd (een opname van de hele computer bevat ook verkeer van andere programma’s, bijvoorbeeld Windows en de browser):

  1. Verbindingen van het meetproces (PowerShell, zonder beheerdersrechten; stoppen met Ctrl+C). Toont elke verbinding van het proces die niet naar 127.0.0.1 of ::1 gaat — er wordt geen regel verwacht:

    cd $env:USERPROFILE
    $ids = (Get-CimInstance Win32_Process -Filter "Name = 'python.exe'" | Where-Object { $_.CommandLine -like '*-m ume_vitals*' }).ProcessId
    while ($true) { Get-NetTCPConnection -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess -and $_.RemoteAddress -notin @('127.0.0.1', '::1', '0.0.0.0', '::') } | Format-Table -AutoSize; Get-NetUDPEndpoint -ErrorAction SilentlyContinue | Where-Object { $ids -contains $_.OwningProcess } | Format-Table -AutoSize; Start-Sleep -Seconds 1 }
    
  2. Opname van de hele computer met pktmon (PowerShell als beheerder; controleer de syntaxis vóór de acceptatie met pktmon help):

    cd $env:USERPROFILE
    pktmon filter remove
    pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etl
    

    Voer de metingen uit, daarna:

    cd $env:USERPROFILE
    pktmon stop
    pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapng
    

    Open het .pcapng-bestand in een netwerkanalysator en filter op verkeer dat niet naar de loopback-adressen gaat (!(ip.addr == 127.0.0.0/8) && !(ipv6.addr == ::1)); wijs elke gevonden verbinding met bewijs 1 toe aan het meetproces, of sluit haar uit.

Linux (perceptiebord, Bash met sudo):

cd "$HOME"
sudo tcpdump -i any -n -w "$HOME/vitals-mitschnitt.pcap" 'not (net 127.0.0.0/8 or ip6 host ::1)'

Daarna sudo tcpdump -n -r "$HOME/vitals-mitschnitt.pcap" en ss -tunap | grep python.

Behandel opnamebestanden als meetgegevens: niet doorgeven, na de evaluatie verwijderen.

8 Grenzen van deze stand

  • Nauwkeurigheid niet bij mensen gecontroleerd. Alle tests draaien met synthetische signalen, nabootsingen en de simulator; geen echte camera, geen echt meetapparaat, geen persoon.
  • De kwaliteitsdrempels (hartslag: gewitte SNR, standaard POS 1 dB, CHROM 2,5 dB; ademhaling 3 dB in de ademband en 25 dB boven de ruisvloer) zijn afgeleid uit synthetische signalen. Of ze bij echte camera’s passen, is nog open; de hartslagdrempel is instelbaar in vitals.json. Bij langzame drift leverde POS in de synthetische tests minder hartslagwaarden dan voorheen; CHROM is zwak bij drift en wordt voor de stand niet aanbevolen.
  • ROS-netwerk (DDS). De netwerkbeveiliging werkt alleen op Python-niveau; ROS 2 opent zijn sockets buiten Python om. De ROS-bron start daarom alleen in een tot het apparaat beperkte ROS-omgeving (sectie 5). Welke ROS-versie op het perceptiebord draait en of het cameratopic daar lokaal beschikbaar is, wordt nog uitgezocht.
  • Linux, het perceptiebord en ROS 2 zijn niet geïnstalleerd en niet getest.
  • Stabiliteitsregel: een camerawaarde verschijnt pas als stabil_anzahl (3) opeenvolgende schattingen (één per seconde) boven de drempel en binnen ± stabil_toleranz_bpm (5 /min; ademhaling ± stabil_toleranz_atem, 3 /min) rond hun mediaan liggen; de mediaan wordt getoond. Een schatting onder de drempel of een uitschieter haalt de waarde weer weg. In synthetische tests met 8000 ruisdoorlopen gaf POS met deze regel nog twee en CHROM één verkeerde waarde.
  • Het gedrag van de gekozen meetapparaten bij het verbinden (salvo, opgeslagen metingen, tijdstempel, tijd, mislukte meting) moet bij de acceptatie worden gecontroleerd (sectie 6).
  • Automatische belichting en witbalans van de webcam kunnen de meting vertekenen; ze worden niet uitgeschakeld (afhankelijk van de camera).
  • De gezichtsherkenning vindt alleen frontale gezichten; bril, mondkapje, tegenlicht en een donkere cabine verslechteren de herkenning.
  • De browser op de monitorcomputer maakt geen deel uit van dit pakket; beoordeel zijn eigen verkeer in de opname.

9 Tests

cd $env:USERPROFILE\dev\ume-eyes\vitals
.\.venv\Scripts\python.exe -m pytest -v

Gedekt: hartslag en ademfrequentie met synthetische signalen (POS en CHROM), geen waarde bij ruis (ook 1/f²-ruis), te kort venster of zonder gezicht, Bluetooth LE-parser met pakketten volgens de specificatie (ook lichaamstemperatuur), opgeslagen metingen, sensorstatus, bereiken en tijdstempels, geen uitgaande verbinding in meetmodus, scherm alleen op 127.0.0.1, einde van de sessie, maximale duur en wisseling van persoon wissen alles, logboek zonder waarden, ROS-bron alleen bij beperking tot het apparaat, apparaatwaarden aan de scherminterface ≤ 5 s na het einde van de meting (simulator). Stand 04.11.2026: 419 tests geslaagd (Windows, Python 3.12.10).