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.
Note : ex. http://(adresse-ip-limelight):5807/results
Général
| Méthode | Route | Description |
|---|---|---|
| GET | /results | Récupère le dump JSON complet des résultats de ciblage actuels |
| GET | /status | Récupère l'objet JSON de statut avec température, fps, nom de l'appareil, index du pipeline, utilisation CPU, utilisation RAM |
| GET | /hwreport | Retourne un tableau JSON de rapports matériels complets. Un rapport matériel contient des informations lisibles telles que 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 URL 'index' dans la requête. |
| POST | /pipeline-switch | Basculer vers un pipeline différent. Inclure un paramètre 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 URL "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. Optionnellement inclure un paramètre 'index'. Écrase le pipeline sur le disque |
Gestion de la Caméra
| Méthode | Route | Description |
|---|---|---|
| POST | /set-imumode | Définir le mode IMU (JSON) |
| POST | /set-throttle | Définir le nombre d'images à ignorer entre les images traitées pour la gestion thermique |
| POST | /set-imuassistalpha | Définir l'alpha du filtre complémentaire du mode d'assistance IMU (par défaut 0.001) |
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. Optionnellement inclure 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. Optionnellement inclure un paramètre 'index'. |
| POST | /upload-nn | Téléverser un réseau de neurones. Inclure un paramètre 'type' ("detector" ou "classifier"), le contenu du fichier dans le corps de la requête, et optionnellement inclure un paramètre 'index'. |
| POST | /upload-nnlabels | Téléverser les étiquettes du réseau de neurones. Inclure un paramètre 'type' ("detector" ou "classifier"), le fichier dans le corps de la requête, et optionnellement inclure 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 | Retourne le résultat de calibration par défaut |
| GET | /cal-file | Retourne le résultat de calibration personnalisé (système de fichiers) |
| GET | /cal-eeprom | Retourne le résultat de calibration personnalisé (eeprom) |
| GET | /cal-latest | Retourne 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 |
Captures d'écran
| Méthode | Route | Description |
|---|---|---|
| POST | /capture-snapshot | Capturer une capture d'écran. Inclure un paramètre URL 'snapname' pour nommer la capture. |
| POST | /upload-snapshot | Téléverser une capture d'écran nommée. Inclure un paramètre URL 'snapname' et un fichier image dans le corps de la requête. |
| GET | /snapshotmanifest | Retourne une liste des noms de fichiers de captures d'écran |
| DELETE | /delete-snapshots | Supprime toutes les captures d'écran |
| DELETE | /delete-snapshot | Supprimer une capture d'écran spécifique. Inclure un paramètre 'snapname' dans la requête. |