API REST/HTTP
Limelight OS dispose d'un serveur REST/HTTP fonctionnant sur (adresse_ip):5807
LimelightLib Python est une bibliothèque open-source qui utilise l'API HTTP/REST de Limelight.
Remarque : par exemple http://(adresse-ip-limelight):5807/results
Général
| Méthode | Route | Description |
|---|---|---|
| GET | /results | Récupérer le dump JSON complet des résultats de ciblage actuels |
| GET | /status | Récupérer l'objet JSON de statut avec la température, les fps, le nom de l'appareil, l'index du pipeline, l'utilisation du CPU, l'utilisation de la RAM |
| GET | /hwreport | Renvoie un tableau JSON des rapports matériels complets. Un rapport matériel contient des informations lisibles par l'homme telles que le champ de vision, le décalage principal, etc. |
Gestion des pipelines
| Méthode | Route | Description |
|---|---|---|
| GET | /pipeline-default | Obtenir le pipeline par défaut (JSON) |
| GET | /pipeline-atindex | Obtenir le pipeline[n] de la caméra (JSON). Charge le pipeline depuis le disque. Inclure un paramètre d'URL 'index' dans la requête. |
| POST | /pipeline-switch | Passer à un pipeline différent. Inclure un paramètre d'URL 'index' dans la requête. |
| POST | /reload-pipeline | Forcer la caméra à recharger le pipeline actuel et toutes les ressources du pipeline |
| POST | /update-pipeline | Accepte du JSON avec une ou plusieurs mises à jour de paramètres. Définir le paramètre d'URL "flush" à 1 pour enregistrer ces paramètres sur le disque. |
| POST | /upload-pipeline | Télécharger un pipeline. Envoyer les données JSON dans le corps de la requête. Inclure éventuellement un paramètre 'index'. Écrase le pipeline sur le disque |
Gestion des ressources
| Méthode | Route | Description |
|---|---|---|
| POST | /upload-fieldmap | Télécharger une carte de terrain. Envoyer les données JSON dans le corps de la requête. Inclure éventuellement un paramètre 'index'. |
| POST | /upload-python | Télécharger du code Python. Envoyer le code en texte brut dans le corps de la requête. Inclure éventuellement un paramètre 'index'. |
| POST | /upload-nn | Télécharger un réseau neuronal. Inclure un paramètre 'type' ("detector" ou "classifier"), le contenu du fichier dans le corps de la requête, et éventuellement inclure un paramètre 'index'. |
| POST | /upload-nnlabels | Télécharger des étiquettes de réseau neuronal. Inclure un paramètre 'type' ("detector" ou "classifier"), le fichier dans le corps de la requête, et éventuellement inclure un paramètre 'index'. |
| GET | /getsnapscriptnames | Liste des noms de snapscriptpro |
Python et orientation du robot
| Méthode | Route | Description |
|---|---|---|
| POST | /update-pythoninputs | Mettre à jour les entrées Python pour les pipelines SnapScript. Envoyer les données JSON (tableau) dans le corps de la requête. |
| POST | /update-robotorientation | Mettre à jour l'orientation du robot. Envoyer les données JSON (tableau) dans le corps de la requête. Par exemple "[45,0,0,0,0,0]". L'utilisation de cette méthode désactive les mises à jour d'orientation basées sur NetworkTables jusqu'au redémarrage/réinitialisation |
Calibration
| Méthode | Route | Description |
|---|---|---|
| GET | /cal-default | Renvoie le résultat de calibration par défaut |
| GET | /cal-file | Renvoie le résultat de calibration personnalisé (système de fichiers) |
| GET | /cal-eeprom | Renvoie le résultat de calibration personnalisé (eeprom) |
| GET | /cal-latest | Renvoie le dernier résultat de calibration personnalisé. Ce résultat n'est pas utilisé sauf s'il est enregistré dans le système de fichiers ou l'eeprom |
| POST | /cal-eeprom | Mettre à jour le résultat de calibration eeprom. Envoyer les données de calibration dans le corps de la requête. |
| POST | /cal-file | Mettre à jour le résultat de calibration du système de fichiers. Envoyer les données de calibration dans le corps de la requête. |
| DELETE | /cal-latest | Supprimer le dernier résultat de calibration |
| DELETE | /cal-eeprom | Supprimer le résultat de calibration eeprom |
| DELETE | /cal-file | Supprimer le résultat de calibration du système de fichiers |
Instantanés
| Méthode | Route | Description |
|---|---|---|
| POST | /capture-snapshot | Capturer un instantané. Inclure un paramètre d'URL 'snapname' pour nommer l'instantané. |
| POST | /upload-snapshot | Télécharger un instantané nommé. Inclure un paramètre d'URL 'snapname' et un fichier image dans le corps de la requête. |
| GET | /snapshotmanifest | Renvoie une liste des noms de fichiers d'instantanés |
| DELETE | /delete-snapshots | Supprime tous les instantanés |
| DELETE | /delete-snapshot | Supprimer un instantané spécifique. Inclure un paramètre 'snapname' dans la requête. |