Technician manual — uMe commissioning, sharing the camera¶
Status as of 13.11.2026. Not yet checked on a device. Applies from uMe Gateway 2.9
(API 1.5); unchanged up to the current version 2.11 (API 1.7). Basis: installation guide of the
uMe Gateway (gateway/INSTALL.md, section „Livebild und Kamera“) and the helper
gateway/ume_camera_helper.py, source state d0e791d. Written for commissioning uMe 2; the same
applies to every uMe. Audience: service technicians of United Robotics Group and appointed
partners. The page follows in German, French, Spanish, Italian and Dutch below:
Deutsch · Français · Español ·
Italiano · Nederlands. Related pages:
uMe connection and pairing,
Gateway API (WebSocket),
Acceptance.
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.
1 One camera, one owner¶
- The depth camera of the uMe can be opened by only one process at a time. Whoever opens it first keeps it.
- Only the camera service of the robot opens it:
camera.pyfromume_main, started with the speech serviceume_brain. - The Gateway never opens the camera. An old switch
UME_CAMERAin the service file is only named in the Gateway log and otherwise ignored. - This is why the greeting on approach (camera service) and the live image in the app work at the same time.
Where other pages of this portal still mention UME_CAMERA, they describe Gateway versions before
2.9.
2 Live image in the app¶
| Item | Behaviour |
|---|---|
| Process | helper ~/ume_camera_helper.py, started and supervised by the Gateway |
| ROS domain | 26 (like ume_main); the Gateway itself stays in domain 0 |
| Source | colour image of the camera service, topic /ume/camera/color/image_raw (bgr8, 1280 × 720, 30 images/s); subscription best effort, depth 1 — the helper never slows down the camera service |
| When | only while a paired app has the camera page open |
| Rate and size | at most 10 images/s, reduced to at most 640 × 480 with the same aspect ratio (16:9 → 640 × 360), JPEG |
| Where to | only to this app in the local network; nothing is stored, no language model sees the image |
In the app: if no image arrives for 3 s, the camera page shows „Kamera vom Roboter gerade nicht verfügbar“. „Foto“ holds the current image as a still on the tablet; „Live“ shows the live image again. Older apps do not request the image and therefore show no live image — update the tablets first.
Switches in ~/.config/systemd/user/ume-gateway.service:
| Variable | Meaning | Default |
|---|---|---|
UME_CAMERA_LIVE |
live image through ume_camera_helper.py; 0 = off |
1 (on) |
UME_CAMERA_DOMAIN |
ROS domain of the helper (0 to 232) | 26 |
3 Older Gateway (before 2.9)¶
Before version 2.9 the Gateway could open the camera itself (UME_CAMERA=<depth camera mode>).
Gateway and camera service then compete for the camera: whoever starts first keeps it. If the
Gateway holds it, the camera service and the greeting on approach get no image.
Remedy: install Gateway 2.9 or later as described in gateway/INSTALL.md (steps 1 to 5, see
also uMe connection and pairing). Do not set UME_CAMERA again.
Check the installed state — Bash on the Perception Board over the service access, service user, no admin:
cd ~
grep -n '^API_VERSION' gateway_v2.py
ls -l ume_camera_helper.py
grep -n 'UME_CAMERA' .config/systemd/user/ume-gateway.service
Expected: API_VERSION is "1.5" or higher; ume_camera_helper.py exists; in the service file
there is no line UME_CAMERA= (only UME_CAMERA_LIVE and UME_CAMERA_DOMAIN). If a version
2.9 or later still finds an old line UME_CAMERA=, it only names it in the log and ignores it.
4 Checks at commissioning (K-1 to K-4)¶
Preconditions: Gateway 2.9 or later installed, tablet paired, speech service running. Bash on the Perception Board, service user, no admin:
cd ~
systemctl --user is-active ume_brain.service
Expected: active.
| No. | Check | Expected result |
|---|---|---|
| K-1 | Open the camera page in the paired app while ume_brain is running |
live image within 3 s, no „Kamera vom Roboter gerade nicht verfügbar“ |
| K-2 | Camera page open, a person walks up to the uMe | greeting on approach and live image at the same time; also after a cold start, whatever the order in which the services start |
| K-3 | Who holds the camera (commands below) | only processes of ume_brain; no process of gateway_v2.py or ume_camera_helper.py |
| K-4 | CPU load of the Perception Board with the camera page open and ume_brain running (commands below) |
below 80 % in all five readings |
K-3 — Bash on the Perception Board, admin (sudo); the technician types the sudo password personally:
cd ~
sudo fuser -v /dev/video*
Then, service user, no admin:
cd ~
systemctl --user status ume_brain.service --no-pager
pgrep -af 'gateway_v2.py|ume_camera_helper.py'
Every PID that fuser lists must appear in the CGroup list of ume_brain; none of the PIDs from
pgrep may appear in the fuser list.
K-4 — Bash on the Perception Board, service user, no admin:
cd ~
top -b -n 5 -d 2 | grep 'Cpu(s)'
top -b -n 5 -d 2 -p "$(pgrep -f ume_camera_helper.py)"
Load = 100 minus the value id of each Cpu(s) line. The second command shows the share of the
helper alone. There are no measured values for the load yet; this check records them.
Record the results of K-1 to K-4 in the acceptance record.
5 If a check fails¶
- K-1: no image. Check that
UME_CAMERA_LIVEis not0and thatume_brainisactive; watch the Gateway log withjournalctl --user -u ume-gateway -fwhile opening the camera page; update an older app. - K-3: a process of the Gateway holds the camera. Older Gateway — section 3.
- K-4: load 80 % or more. Close the camera page and repeat the readings. If the load stays high without the camera page, the live image is not the cause. Send the readings to support@unitedrobotics.group.
United Robotics Group GmbH, An der Riede 2, 28816 Stuhr, Deutschland, HRB 209124 Amtsgericht Walsrode.
Inbetriebnahme uMe 2 – Kamera gemeinsam nutzen¶
Stand 13.11.2026. Nicht am Gerät geprüft. Gilt ab uMe Gateway 2.9 (API 1.5);
unverändert bis zur aktuellen Fassung 2.11 (API 1.7). Grundlage: Installationsanleitung des uMe
Gateway (gateway/INSTALL.md, Abschnitt „Livebild und Kamera“) und der Hilfsprozess
gateway/ume_camera_helper.py, Quellstand d0e791d. Geschrieben für die Inbetriebnahme von uMe 2;
dasselbe gilt für jeden uMe. Zielgruppe: Servicetechniker der United Robotics Group und beauftragte
Partner.
Für IT, Techniker und Integrationspartner
Technische Referenz für IT-Abteilungen, URG-Techniker und geschulte Partner. Keine Bedienungsanleitung für Endanwender.
1 Eine Kamera, ein Besitzer¶
- Die Tiefenkamera des uMe kann immer nur ein Prozess öffnen. Wer sie zuerst öffnet, behält sie.
- Nur der Kameradienst des Roboters öffnet sie:
camera.pyausume_main, gestartet mit dem Sprachdienstume_brain. - Das Gateway öffnet die Kamera nie. Ein alter Schalter
UME_CAMERAin der Dienstdatei wird nur im Gateway-Log genannt und sonst übergangen. - Deshalb funktionieren die Begrüßung bei Annäherung (Kameradienst) und das Livebild in der App gleichzeitig.
Wo andere Seiten dieses Portals noch UME_CAMERA nennen, beschreiben sie Gateway-Fassungen vor
2.9.
2 Livebild in der App¶
| Punkt | Verhalten |
|---|---|
| Prozess | Hilfsprozess ~/ume_camera_helper.py, vom Gateway gestartet und überwacht |
| ROS-Domäne | 26 (wie ume_main); das Gateway selbst bleibt in Domäne 0 |
| Quelle | Farbbild des Kameradienstes, Topic /ume/camera/color/image_raw (bgr8, 1280 × 720, 30 Bilder/s); Abonnement best effort, Tiefe 1 — der Hilfsprozess bremst den Kameradienst nie aus |
| Wann | nur solange eine gekoppelte App die Kameraseite offen hat |
| Rate und Größe | höchstens 10 Bilder/s, verkleinert auf höchstens 640 × 480 bei gleichem Seitenverhältnis (16:9 → 640 × 360), JPEG |
| Wohin | nur an diese App im lokalen Netz; nichts wird gespeichert, kein Sprachmodell sieht das Bild |
In der App: Kommt 3 s kein Bild, zeigt die Kameraseite „Kamera vom Roboter gerade nicht verfügbar“. „Foto“ hält das aktuelle Bild als Standbild auf dem Tablet fest; „Live“ zeigt wieder das Livebild. Ältere Apps fragen das Bild nicht an und zeigen deshalb kein Livebild — zuerst die Tablets aktualisieren.
Schalter in ~/.config/systemd/user/ume-gateway.service:
| Variable | Bedeutung | Vorgabe |
|---|---|---|
UME_CAMERA_LIVE |
Livebild über ume_camera_helper.py; 0 = aus |
1 (an) |
UME_CAMERA_DOMAIN |
ROS-Domäne des Hilfsprozesses (0 bis 232) | 26 |
3 Älteres Gateway (vor 2.9)¶
Vor Fassung 2.9 konnte das Gateway die Kamera selbst öffnen (UME_CAMERA=<Tiefenkamera-Modus>).
Gateway und Kameradienst konkurrieren dann um die Kamera: Wer zuerst startet, behält sie. Hält
das Gateway sie, bekommen der Kameradienst und die Begrüßung bei Annäherung kein Bild.
Abhilfe: Gateway 2.9 oder neuer nach gateway/INSTALL.md einspielen (Schritte 1 bis 5, siehe
auch uMe-Verbindung und Kopplung). UME_CAMERA nicht wieder setzen.
Stand prüfen — Bash auf dem Perception Board über den Servicezugang, Servicebenutzer, kein Admin:
cd ~
grep -n '^API_VERSION' gateway_v2.py
ls -l ume_camera_helper.py
grep -n 'UME_CAMERA' .config/systemd/user/ume-gateway.service
Erwartet: API_VERSION ist "1.5" oder höher; ume_camera_helper.py ist vorhanden; in der
Dienstdatei steht keine Zeile UME_CAMERA= (nur UME_CAMERA_LIVE und UME_CAMERA_DOMAIN). Findet
eine Fassung ab 2.9 noch eine alte Zeile UME_CAMERA=, nennt sie diese nur im Log und übergeht sie.
4 Prüfschritte bei der Inbetriebnahme (K-1 bis K-4)¶
Voraussetzungen: Gateway 2.9 oder neuer eingespielt, Tablet gekoppelt, Sprachdienst läuft. Bash auf dem Perception Board, Servicebenutzer, kein Admin:
cd ~
systemctl --user is-active ume_brain.service
Erwartet: active.
| Nr. | Prüfung | Erwartetes Ergebnis |
|---|---|---|
| K-1 | Kameraseite in der gekoppelten App öffnen, während ume_brain läuft |
Livebild innerhalb von 3 s, kein „Kamera vom Roboter gerade nicht verfügbar“ |
| K-2 | Kameraseite offen, eine Person geht auf den uMe zu | Begrüßung bei Annäherung und Livebild gleichzeitig; auch nach Kaltstart, egal in welcher Reihenfolge die Dienste starten |
| K-3 | Wer hält die Kamera (Befehle unten) | nur Prozesse von ume_brain; kein Prozess von gateway_v2.py oder ume_camera_helper.py |
| K-4 | CPU-Last des Perception Board bei offener Kameraseite und laufendem ume_brain (Befehle unten) |
unter 80 % in allen fünf Ablesungen |
K-3 — Bash auf dem Perception Board, Admin (sudo); das sudo-Kennwort tippt der Techniker selbst:
cd ~
sudo fuser -v /dev/video*
Danach Servicebenutzer, kein Admin:
cd ~
systemctl --user status ume_brain.service --no-pager
pgrep -af 'gateway_v2.py|ume_camera_helper.py'
Jede PID, die fuser auflistet, muss in der CGroup-Liste von ume_brain stehen; keine PID aus
pgrep darf in der fuser-Liste stehen.
K-4 — Bash auf dem Perception Board, Servicebenutzer, kein Admin:
cd ~
top -b -n 5 -d 2 | grep 'Cpu(s)'
top -b -n 5 -d 2 -p "$(pgrep -f ume_camera_helper.py)"
Last = 100 minus den Wert id jeder Cpu(s)-Zeile. Der zweite Befehl zeigt den Anteil des
Hilfsprozesses allein. Messwerte zur Last gibt es noch nicht; diese Prüfung erhebt sie.
Die Ergebnisse von K-1 bis K-4 im Abnahme-Protokoll festhalten.
5 Wenn eine Prüfung scheitert¶
- K-1: kein Bild. Prüfen, dass
UME_CAMERA_LIVEnicht0ist undume_brainactiveist; beim Öffnen der Kameraseite das Gateway-Log mitjournalctl --user -u ume-gateway -fmitlesen; ältere App aktualisieren. - K-3: ein Prozess des Gateway hält die Kamera. Älteres Gateway — Abschnitt 3.
- K-4: Last 80 % oder mehr. Kameraseite schließen und die Ablesung wiederholen. Bleibt die Last ohne Kameraseite hoch, ist das Livebild nicht die Ursache. Ablesungen an support@unitedrobotics.group senden.
United Robotics Group GmbH, An der Riede 2, 28816 Stuhr, Deutschland, HRB 209124 Amtsgericht Walsrode.
Mise en service uMe 2 – partager la caméra¶
État au 13.11.2026. Non vérifié sur l’appareil. S’applique à partir du Gateway uMe 2.9
(API 1.5) ; inchangé jusqu’à la version actuelle 2.11 (API 1.7). Base : guide d’installation du
Gateway uMe (gateway/INSTALL.md, section « Livebild und Kamera ») et le processus auxiliaire
gateway/ume_camera_helper.py, état des sources d0e791d. Rédigé pour la mise en service d’uMe 2 ;
il en va de même pour chaque uMe. Public : techniciens de service de United Robotics Group et
partenaires mandatés.
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 un mode d’emploi pour les utilisateurs finaux.
1 Une caméra, un propriétaire¶
- La caméra de profondeur de l’uMe ne peut être ouverte que par un seul processus à la fois. Celui qui l’ouvre en premier la garde.
- Seul le service caméra du robot l’ouvre :
camera.pydeume_main, lancé avec le service vocalume_brain. - Le Gateway n’ouvre jamais la caméra. Un ancien commutateur
UME_CAMERAdans le fichier de service est seulement mentionné dans le journal du Gateway et sinon ignoré. - C’est pourquoi l’accueil à l’approche (service caméra) et l’image en direct dans l’application fonctionnent en même temps.
Lorsque d’autres pages de ce portail mentionnent encore UME_CAMERA, elles décrivent des versions
du Gateway antérieures à 2.9.
2 Image en direct dans l’application¶
| Point | Comportement |
|---|---|
| Processus | processus auxiliaire ~/ume_camera_helper.py, lancé et surveillé par le Gateway |
| Domaine ROS | 26 (comme ume_main) ; le Gateway lui-même reste dans le domaine 0 |
| Source | image couleur du service caméra, topic /ume/camera/color/image_raw (bgr8, 1280 × 720, 30 images/s) ; abonnement best effort, profondeur 1 — le processus auxiliaire ne ralentit jamais le service caméra |
| Quand | uniquement tant qu’une application appairée a la page caméra ouverte |
| Cadence et taille | au plus 10 images/s, réduites à au plus 640 × 480 avec le même rapport d’aspect (16:9 → 640 × 360), JPEG |
| Destination | uniquement cette application dans le réseau local ; rien n’est enregistré, aucun modèle de langage ne voit l’image |
Dans l’application : si aucune image n’arrive pendant 3 s, la page caméra affiche « Kamera vom Roboter gerade nicht verfügbar ». « Foto » fige l’image actuelle sur la tablette ; « Live » affiche à nouveau l’image en direct. Les applications plus anciennes ne demandent pas l’image et n’affichent donc pas d’image en direct — mettre d’abord les tablettes à jour.
Commutateurs dans ~/.config/systemd/user/ume-gateway.service :
| Variable | Signification | Valeur par défaut |
|---|---|---|
UME_CAMERA_LIVE |
image en direct via ume_camera_helper.py ; 0 = désactivée |
1 (activée) |
UME_CAMERA_DOMAIN |
domaine ROS du processus auxiliaire (0 à 232) | 26 |
3 Gateway plus ancien (avant 2.9)¶
Avant la version 2.9, le Gateway pouvait ouvrir lui-même la caméra
(UME_CAMERA=<mode caméra de profondeur>). Gateway et service caméra se disputent alors la
caméra : celui qui démarre en premier la garde. Si le Gateway la tient, le service caméra et
l’accueil à l’approche ne reçoivent aucune image.
Remède : installer le Gateway 2.9 ou plus récent selon gateway/INSTALL.md (étapes 1 à 5, voir
aussi uMe : connexion et appairage). Ne pas redéfinir UME_CAMERA.
Vérifier l’état — Bash sur le Perception Board via l’accès de service, utilisateur de service, sans droits administrateur :
cd ~
grep -n '^API_VERSION' gateway_v2.py
ls -l ume_camera_helper.py
grep -n 'UME_CAMERA' .config/systemd/user/ume-gateway.service
Attendu : API_VERSION vaut "1.5" ou plus ; ume_camera_helper.py existe ; le fichier de service
ne contient aucune ligne UME_CAMERA= (seulement UME_CAMERA_LIVE et UME_CAMERA_DOMAIN). Si une
version 2.9 ou ultérieure trouve encore une ancienne ligne UME_CAMERA=, elle la mentionne
seulement dans le journal et l’ignore.
4 Contrôles à la mise en service (K-1 à K-4)¶
Conditions : Gateway 2.9 ou plus récent installé, tablette appairée, service vocal en marche. Bash sur le Perception Board, utilisateur de service, sans droits administrateur :
cd ~
systemctl --user is-active ume_brain.service
Attendu : active.
| N° | Contrôle | Résultat attendu |
|---|---|---|
| K-1 | Ouvrir la page caméra dans l’application appairée pendant que ume_brain tourne |
image en direct en moins de 3 s, pas de « Kamera vom Roboter gerade nicht verfügbar » |
| K-2 | Page caméra ouverte, une personne s’approche de l’uMe | accueil à l’approche et image en direct en même temps ; aussi après un démarrage à froid, quel que soit l’ordre de démarrage des services |
| K-3 | Qui tient la caméra (commandes ci-dessous) | uniquement des processus de ume_brain ; aucun processus de gateway_v2.py ni de ume_camera_helper.py |
| K-4 | Charge CPU du Perception Board, page caméra ouverte et ume_brain en marche (commandes ci-dessous) |
inférieure à 80 % dans les cinq relevés |
K-3 — Bash sur le Perception Board, administrateur (sudo) ; le technicien saisit lui-même le mot de passe sudo :
cd ~
sudo fuser -v /dev/video*
Ensuite, utilisateur de service, sans droits administrateur :
cd ~
systemctl --user status ume_brain.service --no-pager
pgrep -af 'gateway_v2.py|ume_camera_helper.py'
Chaque PID listé par fuser doit figurer dans la liste CGroup de ume_brain ; aucun PID de pgrep
ne doit figurer dans la liste de fuser.
K-4 — Bash sur le Perception Board, utilisateur de service, sans droits administrateur :
cd ~
top -b -n 5 -d 2 | grep 'Cpu(s)'
top -b -n 5 -d 2 -p "$(pgrep -f ume_camera_helper.py)"
Charge = 100 moins la valeur id de chaque ligne Cpu(s). La deuxième commande montre la part du
seul processus auxiliaire. Il n’existe pas encore de valeurs mesurées de la charge ; ce contrôle
les relève.
Consigner les résultats de K-1 à K-4 dans le procès-verbal de réception.
5 Si un contrôle échoue¶
- K-1 : pas d’image. Vérifier que
UME_CAMERA_LIVEne vaut pas0et queume_brainestactive; suivre le journal du Gateway avecjournalctl --user -u ume-gateway -fen ouvrant la page caméra ; mettre à jour une application plus ancienne. - K-3 : un processus du Gateway tient la caméra. Gateway plus ancien — section 3.
- K-4 : charge de 80 % ou plus. Fermer la page caméra et répéter les relevés. Si la charge reste élevée sans la page caméra, l’image en direct n’en est pas la cause. Envoyer les relevés à support@unitedrobotics.group.
United Robotics Group GmbH, An der Riede 2, 28816 Stuhr, Deutschland, HRB 209124 Amtsgericht Walsrode.
Puesta en marcha uMe 2 – compartir la cámara¶
Estado a 13.11.2026. No comprobado en el equipo. Válido a partir del Gateway uMe 2.9
(API 1.5); sin cambios hasta la versión actual 2.11 (API 1.7). Base: guía de instalación del
Gateway uMe (gateway/INSTALL.md, apartado «Livebild und Kamera») y el proceso auxiliar
gateway/ume_camera_helper.py, estado de las fuentes d0e791d. Redactado para la puesta en marcha
de uMe 2; lo mismo se aplica a cada uMe. Destinatarios: técnicos de servicio de United Robotics
Group y socios autorizados.
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.
1 Una cámara, un propietario¶
- La cámara de profundidad del uMe solo puede abrirla un único proceso a la vez. Quien la abre primero, la conserva.
- Solo el servicio de cámara del robot la abre:
camera.pydeume_main, iniciado con el servicio de vozume_brain. - El Gateway nunca abre la cámara. Un antiguo conmutador
UME_CAMERAen el archivo de servicio solo se menciona en el registro del Gateway y, por lo demás, se ignora. - Por eso el saludo al acercarse alguien (servicio de cámara) y la imagen en directo en la app funcionan a la vez.
Cuando otras páginas de este portal aún mencionan UME_CAMERA, describen versiones del Gateway
anteriores a 2.9.
2 Imagen en directo en la app¶
| Punto | Comportamiento |
|---|---|
| Proceso | proceso auxiliar ~/ume_camera_helper.py, iniciado y supervisado por el Gateway |
| Dominio ROS | 26 (como ume_main); el propio Gateway permanece en el dominio 0 |
| Fuente | imagen en color del servicio de cámara, topic /ume/camera/color/image_raw (bgr8, 1280 × 720, 30 imágenes/s); suscripción best effort, profundidad 1 — el proceso auxiliar nunca frena el servicio de cámara |
| Cuándo | solo mientras una app emparejada tiene abierta la página de cámara |
| Frecuencia y tamaño | como máximo 10 imágenes/s, reducidas a como máximo 640 × 480 con la misma relación de aspecto (16:9 → 640 × 360), JPEG |
| Destino | solo esta app en la red local; no se guarda nada, ningún modelo de lenguaje ve la imagen |
En la app: si durante 3 s no llega ninguna imagen, la página de cámara muestra «Kamera vom Roboter gerade nicht verfügbar». «Foto» congela la imagen actual en la tableta; «Live» vuelve a mostrar la imagen en directo. Las apps más antiguas no solicitan la imagen y, por tanto, no muestran imagen en directo — actualizar primero las tabletas.
Conmutadores en ~/.config/systemd/user/ume-gateway.service:
| Variable | Significado | Valor por defecto |
|---|---|---|
UME_CAMERA_LIVE |
imagen en directo mediante ume_camera_helper.py; 0 = desactivada |
1 (activada) |
UME_CAMERA_DOMAIN |
dominio ROS del proceso auxiliar (0 a 232) | 26 |
3 Gateway más antiguo (antes de 2.9)¶
Antes de la versión 2.9 el Gateway podía abrir la cámara él mismo
(UME_CAMERA=<modo de cámara de profundidad>). Gateway y servicio de cámara compiten entonces por
la cámara: quien arranca primero, la conserva. Si la tiene el Gateway, el servicio de cámara y el
saludo al acercarse alguien no reciben imagen.
Solución: instalar el Gateway 2.9 o posterior según gateway/INSTALL.md (pasos 1 a 5, véase
también uMe: conexión y emparejamiento). No volver a definir
UME_CAMERA.
Comprobar el estado — Bash en el Perception Board a través del acceso de servicio, usuario de servicio, sin administrador:
cd ~
grep -n '^API_VERSION' gateway_v2.py
ls -l ume_camera_helper.py
grep -n 'UME_CAMERA' .config/systemd/user/ume-gateway.service
Esperado: API_VERSION es "1.5" o superior; ume_camera_helper.py existe; en el archivo de
servicio no hay ninguna línea UME_CAMERA= (solo UME_CAMERA_LIVE y UME_CAMERA_DOMAIN). Si una
versión 2.9 o posterior encuentra todavía una línea antigua UME_CAMERA=, solo la menciona en el
registro y la ignora.
4 Comprobaciones en la puesta en marcha (K-1 a K-4)¶
Requisitos: Gateway 2.9 o posterior instalado, tableta emparejada, servicio de voz en marcha. Bash en el Perception Board, usuario de servicio, sin administrador:
cd ~
systemctl --user is-active ume_brain.service
Esperado: active.
| N.º | Comprobación | Resultado esperado |
|---|---|---|
| K-1 | Abrir la página de cámara en la app emparejada mientras ume_brain está en marcha |
imagen en directo en menos de 3 s, sin «Kamera vom Roboter gerade nicht verfügbar» |
| K-2 | Página de cámara abierta, una persona se acerca al uMe | saludo al acercarse e imagen en directo a la vez; también tras un arranque en frío, sea cual sea el orden de arranque de los servicios |
| K-3 | Quién tiene la cámara (comandos abajo) | solo procesos de ume_brain; ningún proceso de gateway_v2.py ni de ume_camera_helper.py |
| K-4 | Carga de CPU del Perception Board con la página de cámara abierta y ume_brain en marcha (comandos abajo) |
por debajo del 80 % en las cinco lecturas |
K-3 — Bash en el Perception Board, administrador (sudo); el técnico teclea él mismo la contraseña de sudo:
cd ~
sudo fuser -v /dev/video*
Después, usuario de servicio, sin administrador:
cd ~
systemctl --user status ume_brain.service --no-pager
pgrep -af 'gateway_v2.py|ume_camera_helper.py'
Cada PID que lista fuser debe aparecer en la lista CGroup de ume_brain; ningún PID de pgrep
puede aparecer en la lista de fuser.
K-4 — Bash en el Perception Board, usuario de servicio, sin administrador:
cd ~
top -b -n 5 -d 2 | grep 'Cpu(s)'
top -b -n 5 -d 2 -p "$(pgrep -f ume_camera_helper.py)"
Carga = 100 menos el valor id de cada línea Cpu(s). El segundo comando muestra la parte del
proceso auxiliar solo. Todavía no hay valores medidos de la carga; esta comprobación los registra.
Anotar los resultados de K-1 a K-4 en el acta de aceptación.
5 Si una comprobación falla¶
- K-1: no hay imagen. Comprobar que
UME_CAMERA_LIVEno es0y queume_brainestáactive; seguir el registro del Gateway conjournalctl --user -u ume-gateway -fal abrir la página de cámara; actualizar una app más antigua. - K-3: un proceso del Gateway tiene la cámara. Gateway más antiguo — apartado 3.
- K-4: carga del 80 % o más. Cerrar la página de cámara y repetir las lecturas. Si la carga sigue alta sin la página de cámara, la imagen en directo no es la causa. Enviar las lecturas a support@unitedrobotics.group.
United Robotics Group GmbH, An der Riede 2, 28816 Stuhr, Deutschland, HRB 209124 Amtsgericht Walsrode.
Messa in servizio uMe 2 – condividere la telecamera¶
Stato al 13.11.2026. Non verificato sul dispositivo. Vale a partire dal Gateway uMe 2.9
(API 1.5); invariato fino alla versione attuale 2.11 (API 1.7). Base: guida di installazione del
Gateway uMe (gateway/INSTALL.md, sezione «Livebild und Kamera») e il processo ausiliario
gateway/ume_camera_helper.py, stato dei sorgenti d0e791d. Scritto per la messa in servizio di
uMe 2; lo stesso vale per ogni robot uMe. Destinatari: tecnici dell’assistenza di United Robotics Group e
partner incaricati.
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.
1 Una telecamera, un proprietario¶
- La telecamera di profondità di uMe può essere aperta da un solo processo alla volta. Chi la apre per primo la tiene.
- Solo il servizio telecamera del robot la apre:
camera.pydiume_main, avviato con il servizio vocaleume_brain. - Il Gateway non apre mai la telecamera. Un vecchio interruttore
UME_CAMERAnel file di servizio viene solo nominato nel log del Gateway e per il resto ignorato. - Per questo il saluto all’avvicinarsi (servizio telecamera) e l’immagine dal vivo nell’app funzionano contemporaneamente.
Dove altre pagine di questo portale nominano ancora UME_CAMERA, descrivono versioni del Gateway
precedenti alla 2.9.
2 Immagine dal vivo nell’app¶
| Punto | Comportamento |
|---|---|
| Processo | processo ausiliario ~/ume_camera_helper.py, avviato e sorvegliato dal Gateway |
| Dominio ROS | 26 (come ume_main); il Gateway stesso resta nel dominio 0 |
| Sorgente | immagine a colori del servizio telecamera, topic /ume/camera/color/image_raw (bgr8, 1280 × 720, 30 immagini/s); abbonamento best effort, profondità 1 — il processo ausiliario non rallenta mai il servizio telecamera |
| Quando | solo finché un’app associata ha aperta la pagina telecamera |
| Frequenza e dimensione | al massimo 10 immagini/s, ridotte al massimo a 640 × 480 con lo stesso rapporto d’aspetto (16:9 → 640 × 360), JPEG |
| Destinazione | solo questa app nella rete locale; nulla viene salvato, nessun modello linguistico vede l’immagine |
Nell’app: se per 3 s non arriva alcuna immagine, la pagina telecamera mostra «Kamera vom Roboter gerade nicht verfügbar». «Foto» blocca l’immagine attuale sul tablet; «Live» mostra di nuovo l’immagine dal vivo. Le app più vecchie non richiedono l’immagine e quindi non mostrano l’immagine dal vivo — aggiornare prima i tablet.
Interruttori in ~/.config/systemd/user/ume-gateway.service:
| Variabile | Significato | Predefinito |
|---|---|---|
UME_CAMERA_LIVE |
immagine dal vivo tramite ume_camera_helper.py; 0 = spenta |
1 (accesa) |
UME_CAMERA_DOMAIN |
dominio ROS del processo ausiliario (da 0 a 232) | 26 |
3 Gateway più vecchio (prima della 2.9)¶
Prima della versione 2.9 il Gateway poteva aprire la telecamera da sé
(UME_CAMERA=<modalità telecamera di profondità>). Gateway e servizio telecamera si contendono
allora la telecamera: chi parte per primo la tiene. Se la tiene il Gateway, il servizio
telecamera e il saluto all’avvicinarsi non ricevono immagini.
Rimedio: installare il Gateway 2.9 o successivo secondo gateway/INSTALL.md (passi da 1 a 5,
vedi anche uMe: connessione e associazione). Non reimpostare
UME_CAMERA.
Verificare lo stato — Bash sul Perception Board tramite l’accesso di servizio, utente di servizio, senza amministratore:
cd ~
grep -n '^API_VERSION' gateway_v2.py
ls -l ume_camera_helper.py
grep -n 'UME_CAMERA' .config/systemd/user/ume-gateway.service
Atteso: API_VERSION è "1.5" o superiore; ume_camera_helper.py esiste; nel file di servizio
non c’è alcuna riga UME_CAMERA= (solo UME_CAMERA_LIVE e UME_CAMERA_DOMAIN). Se una versione
2.9 o successiva trova ancora una vecchia riga UME_CAMERA=, la nomina solo nel log e la ignora.
4 Verifiche alla messa in servizio (da K-1 a K-4)¶
Presupposti: Gateway 2.9 o successivo installato, tablet associato, servizio vocale in funzione. Bash sul Perception Board, utente di servizio, senza amministratore:
cd ~
systemctl --user is-active ume_brain.service
Atteso: active.
| N. | Verifica | Risultato atteso |
|---|---|---|
| K-1 | Aprire la pagina telecamera nell’app associata mentre ume_brain è in funzione |
immagine dal vivo entro 3 s, nessun «Kamera vom Roboter gerade nicht verfügbar» |
| K-2 | Pagina telecamera aperta, una persona si avvicina a uMe | saluto all’avvicinarsi e immagine dal vivo contemporaneamente; anche dopo un avvio a freddo, in qualunque ordine partano i servizi |
| K-3 | Chi tiene la telecamera (comandi sotto) | solo processi di ume_brain; nessun processo di gateway_v2.py o di ume_camera_helper.py |
| K-4 | Carico CPU del Perception Board con pagina telecamera aperta e ume_brain in funzione (comandi sotto) |
sotto l’80 % in tutte e cinque le letture |
K-3 — Bash sul Perception Board, amministratore (sudo); il tecnico digita personalmente la password di sudo:
cd ~
sudo fuser -v /dev/video*
Poi, utente di servizio, senza amministratore:
cd ~
systemctl --user status ume_brain.service --no-pager
pgrep -af 'gateway_v2.py|ume_camera_helper.py'
Ogni PID elencato da fuser deve comparire nell’elenco CGroup di ume_brain; nessun PID di pgrep
può comparire nell’elenco di fuser.
K-4 — Bash sul Perception Board, utente di servizio, senza amministratore:
cd ~
top -b -n 5 -d 2 | grep 'Cpu(s)'
top -b -n 5 -d 2 -p "$(pgrep -f ume_camera_helper.py)"
Carico = 100 meno il valore id di ogni riga Cpu(s). Il secondo comando mostra la quota del solo
processo ausiliario. Non esistono ancora valori misurati del carico; questa verifica li rileva.
Registrare i risultati da K-1 a K-4 nel verbale di collaudo.
5 Se una verifica non riesce¶
- K-1: nessuna immagine. Verificare che
UME_CAMERA_LIVEnon sia0e cheume_brainsiaactive; seguire il log del Gateway conjournalctl --user -u ume-gateway -fmentre si apre la pagina telecamera; aggiornare un’app più vecchia. - K-3: un processo del Gateway tiene la telecamera. Gateway più vecchio — sezione 3.
- K-4: carico dell’80 % o più. Chiudere la pagina telecamera e ripetere le letture. Se il carico resta alto senza la pagina telecamera, la causa non è l’immagine dal vivo. Inviare le letture a support@unitedrobotics.group.
United Robotics Group GmbH, An der Riede 2, 28816 Stuhr, Deutschland, HRB 209124 Amtsgericht Walsrode.
Inbedrijfstelling uMe 2 – camera samen gebruiken¶
Stand per 13.11.2026. Niet op het apparaat gecontroleerd. Geldt vanaf uMe Gateway 2.9
(API 1.5); ongewijzigd tot de huidige versie 2.11 (API 1.7). Basis: installatiehandleiding van de
uMe Gateway (gateway/INSTALL.md, paragraaf „Livebild und Kamera”) en het hulpproces
gateway/ume_camera_helper.py, bronstand d0e791d. Geschreven voor de inbedrijfstelling van
uMe 2; hetzelfde geldt voor elke uMe. Doelgroep: servicetechnici van United Robotics Group en
aangewezen partners.
Voor IT, technici en integratiepartners
Technische referentie voor IT-afdelingen, URG-technici en getrainde partners. Geen gebruiksaanwijzing voor eindgebruikers.
1 Eén camera, één eigenaar¶
- De dieptecamera van de uMe kan steeds maar door één proces tegelijk worden geopend. Wie hem als eerste opent, houdt hem.
- Alleen de cameradienst van de robot opent hem:
camera.pyuitume_main, gestart met de spraakdienstume_brain. - De Gateway opent de camera nooit. Een oude schakelaar
UME_CAMERAin het dienstbestand wordt alleen in het Gateway-logboek genoemd en verder genegeerd. - Daarom werken de begroeting bij nadering (cameradienst) en het livebeeld in de app tegelijk.
Waar andere pagina’s van dit portaal nog UME_CAMERA noemen, beschrijven ze Gateway-versies van
vóór 2.9.
2 Livebeeld in de app¶
| Punt | Gedrag |
|---|---|
| Proces | hulpproces ~/ume_camera_helper.py, door de Gateway gestart en bewaakt |
| ROS-domein | 26 (zoals ume_main); de Gateway zelf blijft in domein 0 |
| Bron | kleurenbeeld van de cameradienst, topic /ume/camera/color/image_raw (bgr8, 1280 × 720, 30 beelden/s); abonnement best effort, diepte 1 — het hulpproces remt de cameradienst nooit af |
| Wanneer | alleen zolang een gekoppelde app de camerapagina open heeft |
| Snelheid en grootte | hoogstens 10 beelden/s, verkleind tot hoogstens 640 × 480 met dezelfde beeldverhouding (16:9 → 640 × 360), JPEG |
| Waarheen | alleen naar deze app in het lokale netwerk; niets wordt opgeslagen, geen taalmodel ziet het beeld |
In de app: komt er 3 s geen beeld, dan toont de camerapagina „Kamera vom Roboter gerade nicht verfügbar”. „Foto” houdt het huidige beeld als stilstaand beeld op de tablet vast; „Live” toont weer het livebeeld. Oudere apps vragen het beeld niet op en tonen daarom geen livebeeld — eerst de tablets bijwerken.
Schakelaars in ~/.config/systemd/user/ume-gateway.service:
| Variabele | Betekenis | Standaard |
|---|---|---|
UME_CAMERA_LIVE |
livebeeld via ume_camera_helper.py; 0 = uit |
1 (aan) |
UME_CAMERA_DOMAIN |
ROS-domein van het hulpproces (0 tot 232) | 26 |
3 Oudere Gateway (vóór 2.9)¶
Vóór versie 2.9 kon de Gateway de camera zelf openen (UME_CAMERA=<dieptecamera-modus>). Gateway
en cameradienst concurreren dan om de camera: wie als eerste start, houdt hem. Houdt de Gateway
hem vast, dan krijgen de cameradienst en de begroeting bij nadering geen beeld.
Oplossing: Gateway 2.9 of nieuwer installeren volgens gateway/INSTALL.md (stappen 1 tot 5, zie
ook uMe: verbinding en koppeling). UME_CAMERA niet opnieuw
instellen.
Stand controleren — Bash op het Perception Board via de servicetoegang, servicegebruiker, geen beheerder:
cd ~
grep -n '^API_VERSION' gateway_v2.py
ls -l ume_camera_helper.py
grep -n 'UME_CAMERA' .config/systemd/user/ume-gateway.service
Verwacht: API_VERSION is "1.5" of hoger; ume_camera_helper.py bestaat; in het dienstbestand
staat geen regel UME_CAMERA= (alleen UME_CAMERA_LIVE en UME_CAMERA_DOMAIN). Vindt een versie
vanaf 2.9 nog een oude regel UME_CAMERA=, dan noemt ze die alleen in het logboek en negeert ze.
4 Controles bij de inbedrijfstelling (K-1 tot K-4)¶
Voorwaarden: Gateway 2.9 of nieuwer geïnstalleerd, tablet gekoppeld, spraakdienst actief. Bash op het Perception Board, servicegebruiker, geen beheerder:
cd ~
systemctl --user is-active ume_brain.service
Verwacht: active.
| Nr. | Controle | Verwacht resultaat |
|---|---|---|
| K-1 | Camerapagina in de gekoppelde app openen terwijl ume_brain draait |
livebeeld binnen 3 s, geen „Kamera vom Roboter gerade nicht verfügbar” |
| K-2 | Camerapagina open, een persoon loopt naar de uMe toe | begroeting bij nadering en livebeeld tegelijk; ook na een koude start, in welke volgorde de diensten ook starten |
| K-3 | Wie houdt de camera vast (opdrachten hieronder) | alleen processen van ume_brain; geen proces van gateway_v2.py of ume_camera_helper.py |
| K-4 | CPU-belasting van het Perception Board met open camerapagina en draaiende ume_brain (opdrachten hieronder) |
onder 80 % bij alle vijf aflezingen |
K-3 — Bash op het Perception Board, beheerder (sudo); de technicus typt het sudo-wachtwoord zelf:
cd ~
sudo fuser -v /dev/video*
Daarna servicegebruiker, geen beheerder:
cd ~
systemctl --user status ume_brain.service --no-pager
pgrep -af 'gateway_v2.py|ume_camera_helper.py'
Elke PID die fuser toont, moet in de CGroup-lijst van ume_brain staan; geen PID uit pgrep mag
in de fuser-lijst staan.
K-4 — Bash op het Perception Board, servicegebruiker, geen beheerder:
cd ~
top -b -n 5 -d 2 | grep 'Cpu(s)'
top -b -n 5 -d 2 -p "$(pgrep -f ume_camera_helper.py)"
Belasting = 100 min de waarde id van elke Cpu(s)-regel. De tweede opdracht toont het aandeel van
het hulpproces alleen. Er zijn nog geen gemeten waarden voor de belasting; deze controle legt ze
vast.
De resultaten van K-1 tot K-4 vastleggen in het acceptatie-protocol.
5 Als een controle mislukt¶
- K-1: geen beeld. Controleren dat
UME_CAMERA_LIVEniet0is en datume_brainactiveis; bij het openen van de camerapagina het Gateway-logboek volgen metjournalctl --user -u ume-gateway -f; een oudere app bijwerken. - K-3: een proces van de Gateway houdt de camera vast. Oudere Gateway — paragraaf 3.
- K-4: belasting van 80 % of meer. Camerapagina sluiten en de aflezingen herhalen. Blijft de belasting zonder camerapagina hoog, dan is het livebeeld niet de oorzaak. Aflezingen sturen naar support@unitedrobotics.group.
United Robotics Group GmbH, An der Riede 2, 28816 Stuhr, Deutschland, HRB 209124 Amtsgericht Walsrode.