ממשק REST/HTTP
מערכת ההפעלה Limelight כוללת שרת REST/HTTP הפועל בכתובת (כתובת-IP):5807
LimelightLib Python היא ספריית קוד פתוח המשתמשת בממשק ה-HTTP/REST של Limelight.
הערה: לדוגמה http://(כתובת-IP-של-limelight):5807/results
כללי
| שיטה | נתיב | תיאור |
|---|
| GET | /results | קבלת פלט JSON מלא של תוצאות המיקוד הנוכחיות |
| GET | /status | קבלת אובייקט סטטוס JSON עם טמפרטורה, fps, שם המכשיר, אינדקס צינור, שימוש ב-CPU, שימוש ב-RAM |
| GET | /hwreport | מחזיר מערך JSON של דוחות חומרה מלאים. דוח חומרה מכיל מידע קריא לאדם כגון שדה ראייה, היסט עיקרי וכו' |
ניהול צינורות
| שיטה | נתיב | תיאור |
|---|
| GET | /pipeline-default | קבלת צינור ברירת המחדל (JSON) |
| GET | /pipeline-atindex | קבלת צינור[n] מהמצלמה (JSON). טוען צינור מהדיסק. יש לכלול פרמטר 'index' בבקשה. |
| POST | /pipeline-switch | מעבר לצינור אחר. יש לכלול פרמטר 'index' בבקשה. |
| POST | /reload-pipeline | אילוץ המצלמה לטעון מחדש את הצינור הנוכחי וכל משאבי הצינור |
| POST | /update-pipeline | מקבל JSON עם עדכון אחד או יותר להגדרות. הגדר פרמטר "flush" ל-1 כדי לשמור הגדרות אלה בדיסק. |
| POST | /upload-pipeline | העלאת צינור. שלח נתוני JSON בגוף הבקשה. ניתן לכלול פרמטר 'index' אופציונלי. דורס את הצינור בדיסק |
ניהול משאבים
| שיטה | נתיב | תיאור |
|---|
| POST | /upload-fieldmap | העלאת מפת שדה. שלח נתוני JSON בגוף הבקשה. ניתן לכלול פרמטר 'index' אופציונלי. |
| POST | /upload-python | העלאת קוד Python. שלח את הקוד כטקסט רגיל בגוף הבקשה. ניתן לכלול פרמטר 'index' אופציונלי. |
| POST | /upload-nn | העלאת רשת נוירונים. כלול פרמטר 'type' ("detector" או "classifier"), את תוכן הקובץ בגוף הבקשה, וניתן לכלול פרמטר 'index' אופציונלי. |
| POST | /upload-nnlabels | העלאת תוויות רשת נוירונים. כלול פרמטר 'type' ("detector" או "classifier"), את הקובץ בגוף הבקשה, וניתן לכלול פרמטר 'index' אופציונלי. |
| GET | /getsnapscriptnames | רשימה של שמות snapscriptpro |
Python וכיוון הרובוט
| שיטה | נתיב | תיאור |
|---|
| POST | /update-pythoninputs | עדכון קלטי Python עבור צינורות SnapScript. שלח נתוני JSON (מערך) בגוף הבקשה. |
| POST | /update-robotorientation | עדכון כיוון הרובוט. שלח נתוני JSON (מערך) בגוף הבקשה. לדוגמה "[45,0,0,0,0,0]". שימוש בשיטה זו מבטל עדכוני כיוון מבוססי NetworkTables עד להפעלה מחדש/אתחול |
כיול
| שיטה | נתיב | תיאור |
|---|
| GET | /cal-default | מחזיר תוצאת כיול ברירת מחדל |
| GET | /cal-file | מחזיר תוצאת כיול מותאמת אישית (מערכת קבצים) |
| GET | /cal-eeprom | מחזיר תוצאת כיול מותאמת אישית (eeprom) |
| GET | /cal-latest | מחזיר את תוצאת הכיול המותאמת האחרונה. תוצאה זו אינה בשימוש אלא אם היא נשמרת במערכת הקבצים או ב-eeprom |
| POST | /cal-eeprom | עדכון תוצאת הכיול ב-eeprom. שלח נתוני כיול בגוף הבקשה. |
| POST | /cal-file | עדכון תוצאת הכיול במערכת הקבצים. שלח נתוני כיול בגוף הבקשה. |
| DELETE | /cal-latest | מחיקת תוצאת הכיול האחרונה |
| DELETE | /cal-eeprom | מחיקת תוצאת הכיול מה-eeprom |
| DELETE | /cal-file | מחיקת תוצאת הכיול ממערכת הקבצים |
תמונות מצב
| שיטה | נתיב | תיאור |
|---|
| POST | /capture-snapshot | לכידת תמונת מצב. כלול פרמטר 'snapname' בבקשה כדי לתת שם לתמונת המצב. |
| POST | /upload-snapshot | העלאת תמונת מצב בעלת שם. כלול פרמטר 'snapname' בבקשה וקובץ תמונה בגוף הבקשה. |
| GET | /snapshotmanifest | מחזיר רשימה של שמות קבצי תמונות מצב |
| DELETE | /delete-snapshots | מוחק את כל תמונות המצב |
| DELETE | /delete-snapshot | מחיקת תמונת מצב ספציפית. כלול פרמטר 'snapname' בבקשה. |