API REST/HTTP
Limelight OS dispose d'un serveur REST/HTTP fonctionnant sur (ipaddress):5807
LimelightLib Python est une bibliothèque open-source qui utilise l'API HTTP/REST de Limelight.
Note : 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 température, fps, nom de l'appareil, index du pipeline, utilisation CPU, utilisation RAM |
| GET | /hwreport | Renvoie un tableau JSON des rapports matériels complets. Un rapport matériel contient des informations lisibles comme le FOV, 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 'index' dans la requête. |
| POST | /pipeline-switch | Basculer vers un pipeline différent. Inclure un paramètre '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 "flush" à 1 pour sauvegarder ces paramètres sur le disque. |
| POST | /upload-pipeline | Téléverser un pipeline. Envoyer les données JSON dans le corps de la requête. Inclure optionnellement un paramètre 'index'. Écrase le pipeline sur le disque |
Gestion des Ressources
| Méthode | Route | Description |
|---|---|---|
| POST | /upload-fieldmap | Téléverser une carte de terrain. Envoyer les données JSON dans le corps de la requête. Inclure optionnellement un paramètre 'index'. |
| POST | /upload-python | Téléverser du code Python. Envoyer le code en texte brut dans le corps de la requête. Inclure optionnellement un paramètre 'index'. |
| POST | /upload-nn | Téléverser un réseau neuronal. Inclure un paramètre 'type' ("detector" ou "classifier"), le contenu du fichier dans le corps de la requête, et optionnellement un paramètre 'index'. |
| POST | /upload-nnlabels | Téléverser les étiquettes du réseau neuronal. Inclure un paramètre 'type' ("detector" ou "classifier"), le fichier dans le corps de la requête, et optionnellement un paramètre 'index'. |
| GET | /getsnapscriptnames | Liste des noms 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. Ex : "[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 |
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 sauvegardé 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 'snapname' pour nommer l'instantané. |
| POST | /upload-snapshot | Téléverser un instantané nommé. Inclure un paramètre '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. |