REST/HTTP API

מערכת Limelight OS כוללת שרת REST/HTTP שפועל בכתובת (ipaddress):5807

LimelightLib Python היא ספרייה בקוד פתוח שמשתמשת ב-API של Limelight HTTP/REST.

הערה: לדוגמה http://(limelight-ip-address):5807/results

כללי

שיטה	נתיב	תיאור
GET	/results	קבלת dump מלא של JSON של תוצאות הכיוון הנוכחיות
GET	/status	קבלת אובייקט JSON של סטטוס עם טמפרטורה, fps, שם מכשיר, אינדקס pipeline, שימוש במעבד, שימוש בזיכרון
GET	/hwreport	מחזיר מערך JSON של דוחות חומרה מלאים. דוח חומרה מכיל מידע קריא לאדם כמו FOV, principal offset וכו'.

ניהול Pipeline

שיטה	נתיב	תיאור
GET	/pipeline-default	קבלת pipeline ברירת מחדל (JSON)
GET	/pipeline-atindex	קבלת pipeline[n] מהמצלמה (JSON). טוען pipeline מהדיסק. יש לכלול פרמטר 'index' בכתובת הבקשה.
POST	/pipeline-switch	מעבר ל-pipeline אחר. יש לכלול פרמטר 'index' בכתובת הבקשה.
POST	/reload-pipeline	אילוץ המצלמה לטעון מחדש את ה-pipeline הנוכחי ואת כל משאבי ה-pipeline
POST	/update-pipeline	מקבל JSON עם עדכון הגדרות אחד או יותר. הגדר פרמטר url "flush" ל-1 כדי לשמור הגדרות אלה לדיסק.
POST	/upload-pipeline	העלאת pipeline. שלח נתוני JSON בגוף הבקשה. ניתן לכלול פרמטר 'index'. דורס pipeline בדיסק

ניהול מצלמה

שיטה	נתיב	תיאור
POST	/set-imumode	הגדרת מצב IMU (JSON)
POST	/set-throttle	הגדרת מספר הפריימים לדלג ביניהם בין פריימים מעובדים לניהול תרמי
POST	/set-imuassistalpha	הגדרת אלפא של פילטר משלים למצב IMU Assist (ברירת מחדל 0.001)

ניהול משאבים

שיטה	נתיב	תיאור
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 עבור pipelines של 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	לכידת תמונת מצב. כלול פרמטר url 'snapname' כדי לתת שם לתמונת המצב.
POST	/upload-snapshot	העלאת תמונת מצב עם שם. כלול פרמטר url 'snapname' וקובץ תמונה בגוף הבקשה.
GET	/snapshotmanifest	מחזיר רשימת שמות קבצי תמונות מצב
DELETE	/delete-snapshots	מוחק את כל תמונות המצב
DELETE	/delete-snapshot	מחיקת תמונת מצב ספציפית. כלול פרמטר 'snapname' בבקשה.