Skip to content

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.py from ume_main, started with the speech service ume_brain.
  • The Gateway never opens the camera. An old switch UME_CAMERA in 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_LIVE is not 0 and that ume_brain is active; watch the Gateway log with journalctl --user -u ume-gateway -f while 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.py aus ume_main, gestartet mit dem Sprachdienst ume_brain.
  • Das Gateway öffnet die Kamera nie. Ein alter Schalter UME_CAMERA in 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_LIVE nicht 0 ist und ume_brain active ist; beim Öffnen der Kameraseite das Gateway-Log mit journalctl --user -u ume-gateway -f mitlesen; ä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.py de ume_main, lancé avec le service vocal ume_brain.
  • Le Gateway n’ouvre jamais la caméra. Un ancien commutateur UME_CAMERA dans 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_LIVE ne vaut pas 0 et que ume_brain est active ; suivre le journal du Gateway avec journalctl --user -u ume-gateway -f en 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.py de ume_main, iniciado con el servicio de voz ume_brain.
  • El Gateway nunca abre la cámara. Un antiguo conmutador UME_CAMERA en 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_LIVE no es 0 y que ume_brain está active; seguir el registro del Gateway con journalctl --user -u ume-gateway -f al 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.py di ume_main, avviato con il servizio vocale ume_brain.
  • Il Gateway non apre mai la telecamera. Un vecchio interruttore UME_CAMERA nel 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_LIVE non sia 0 e che ume_brain sia active; seguire il log del Gateway con journalctl --user -u ume-gateway -f mentre 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.py uit ume_main, gestart met de spraakdienst ume_brain.
  • De Gateway opent de camera nooit. Een oude schakelaar UME_CAMERA in 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_LIVE niet 0 is en dat ume_brain active is; bij het openen van de camerapagina het Gateway-logboek volgen met journalctl --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.