Roboception rc visard Bedienungsanleitung Seite 172

Bemerkung: Statuswerte werden nur gemeldet, wenn sich das jeweilige Modul im Zustand
befindet.
Parameter: Die meisten Module stellen Parameter über die REST-API des rc_visard zur Verfügung, damit ihr
Laufzeitverhalten an den Anwendungskontext oder die Anforderungen angepasst werden kann. Die REST-
API ermöglicht es, den Wert eines Parameters zu setzen und abzufragen. Darüber hinaus stellt sie weitere
Angaben, wie z.B. den jeweiligen Standardwert und zulässige Minimal- bzw. Maximalwerte von Parame-
tern, zur Verfügung.
rc _ stereomatching
Die
curl -X GET http://<host>/api/v1/nodes/rc _ stereomatching/parameters
Der -Parameter dieses Moduls könnte wie folgt auf den Wert 3 gesetzt werden:
median
curl -X PUT --header
v1/nodes/rc _ stereomatching/parameters/median
Bemerkung: Laufzeitparameter sind modulspezifisch und werden in dem jeweiligen
(Abschnitt 6) dokumentiert.
Bemerkung: Die meisten Parameter, die die Module über die REST-API anbieten, lassen sich auch über
die benutzerfreundliche
Bemerkung: Einige der Parameter, die über die REST-API des rc_visard bereitgestellt werden, sind
auch über die GigE Vision 2.0/GenICam-Schnittstelle
Parameter über die REST-API und die Web GUI ist verboten, solange ein GenICam-Client verbunden
ist.
Zudem bietet jedes Modul, das Laufzeitparameter bereitstellt, auch Services, um die aktuellen Parameter-
einstellungen zu speichern oder um die Werkseinstellungen aller Parameter wiederherzustellen.
Services: Einige Module bieten auch Services, die sich über die REST-API aufrufen lassen. Hierzu gehört bei-
spielsweise das oben bereits genannte Speichern und Wiederherstellen von Parametern oder auch das Starten
und Stoppen von Modulen. Die
sich beispielsweise wie folgt aufrufen:
curl -X GET http://<host>/api/v1/nodes/rc _ hand _ eye _ calibration/services
Um einen Service eines Moduls aufzurufen, wird eine
für die jeweilige Ressource gestellt (siehe das
Beispielsweise lässt sich folgendermaßen eine Bildaufnahme mit dem Stereo-Matching-Modul auslösen:
curl -X PUT --header
api/v1/nodes/rc _ stereomatching/services/acquisition _ trigger
Bemerkung: Die Services und zugehörigen Argumente sind modulspezifisch und werden im jeweiligen
Softwaremodul (Abschnitt 6) dokumentiert.
Die folgende Liste enthält alle REST-API-Anfragen zum Status des Moduls und seinen Parametern und Services:
GET /nodes
Abruf einer Liste aller verfügbaren Module.
Musteranfrage
GET /api/v1/nodes
Musterantwort
8.2. REST-API-Schnittstelle
-Parameter lassen sich beispielsweise wie folgt abrufen:
'Content-Type: application/json'
Web GUI (Abschnitt 4.6) des rc_visard erkunden und austesten.
Services des Moduls zur Hand-Auge-Kalibrierung
'Content-Type: application/json'
HTTP/1.1
-d '{ "value": 3 }'
(Abschnitt 8.1) zugänglich. Die Einstellung dieser
PUT -Anfrage mit servicespezifischen Argumenten
"args" -Feld des Service-Datenmodells, Abschnitt 8.2.3).
-d '{ "args": {}
running
http://<host>/api/
Softwaremodul
(Abschnitt 6.7.5) lassen
}' http://<host>/
169