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).
- 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.
- 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.
- Enter the Bluetooth address of the device in
vitals.jsonunderble.pulsoximeter,ble.blutdruckorble.thermometer. Addresses are site data — do not put them in tickets, documents or repositories. - 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.
- 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):
-
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.1or::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 } -
Capture of the whole computer with pktmon (PowerShell as administrator; check the syntax with
pktmon helpbefore the acceptance):cd $env:USERPROFILE pktmon filter remove pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etlCarry out the measurements, then:
cd $env:USERPROFILE pktmon stop pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapngOpen the
.pcapngfile 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).
- 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.
- 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.
- Die Bluetooth-Adresse des Geräts in
vitals.jsonunterble.pulsoximeter,ble.blutdruckbzw.ble.thermometereintragen. Adressen sind Standortdaten — nicht in Tickets, Dokumente oder Repositorys. - 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.
- 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):
-
Verbindungen des Vitalprozesses (PowerShell, ohne Administratorrechte; Ende mit Strg+C). Zeigt jede Verbindung des Prozesses, die nicht zu
127.0.0.1oder::1geht — 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 } -
Mitschnitt des ganzen Rechners mit pktmon (PowerShell als Administrator; Syntax vor der Abnahme mit
pktmon helpgegenprüfen):cd $env:USERPROFILE pktmon filter remove pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etlMessungen durchführen, danach:
cd $env:USERPROFILE pktmon stop pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapngDie
.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.jsoneinstellbar. 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).
- 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é.
- 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.
- Saisir l’adresse Bluetooth de l’appareil dans
vitals.jsonsousble.pulsoximeter,ble.blutdruckouble.thermometer. Les adresses sont des données de site — ne pas les mettre dans des tickets, documents ou dépôts. - 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.
- 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) :
-
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.1ou::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 } -
Capture de tout l’ordinateur avec pktmon (PowerShell en tant qu’administrateur ; vérifier la syntaxe avec
pktmon helpavant la réception) :cd $env:USERPROFILE pktmon filter remove pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etlEffectuer les mesures, puis :
cd $env:USERPROFILE pktmon stop pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapngOuvrir le fichier
.pcapngdans 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).
- 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.
- 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.
- Introducir la dirección Bluetooth del aparato en
vitals.jsonenble.pulsoximeter,ble.blutdruckoble.thermometer. Las direcciones son datos del emplazamiento: no ponerlas en tickets, documentos ni repositorios. - 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.
- 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):
-
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.1o::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 } -
Captura de todo el ordenador con pktmon (PowerShell como administrador; comprobar la sintaxis con
pktmon helpantes de la aceptación):cd $env:USERPROFILE pktmon filter remove pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etlRealizar las mediciones y después:
cd $env:USERPROFILE pktmon stop pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapngAbrir el archivo
.pcapngen 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).
- 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.
- 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.
- Inserire l’indirizzo Bluetooth del dispositivo in
vitals.jsonsottoble.pulsoximeter,ble.blutdruckoble.thermometer. Gli indirizzi sono dati del sito: non inserirli in ticket, documenti o repository. - 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.
- 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):
-
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.1o::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 } -
Cattura dell’intero computer con pktmon (PowerShell come amministratore; verificare la sintassi con
pktmon helpprima del collaudo):cd $env:USERPROFILE pktmon filter remove pktmon start --capture --pkt-size 0 --file-name $env:USERPROFILE\vitals-mitschnitt.etlEseguire le misurazioni, poi:
cd $env:USERPROFILE pktmon stop pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapngAprire il file
.pcapngin 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).
- 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.
- 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.
- Vul het Bluetooth-adres van het apparaat in
vitals.jsonin onderble.pulsoximeter,ble.blutdruckofble.thermometer. Adressen zijn locatiegegevens — niet in tickets, documenten of repositories. - 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.
- 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):
-
Verbindingen van het meetproces (PowerShell, zonder beheerdersrechten; stoppen met Ctrl+C). Toont elke verbinding van het proces die niet naar
127.0.0.1of::1gaat — 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 } -
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.etlVoer de metingen uit, daarna:
cd $env:USERPROFILE pktmon stop pktmon etl2pcap $env:USERPROFILE\vitals-mitschnitt.etl --out $env:USERPROFILE\vitals-mitschnitt.pcapngOpen 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).