מכשירים וירטואליים

מכשיר וירטואלי הוא מכשיר בפלטפורמת HAM בלי חומרה. המדידות שלו מגיעות מהמערכת שלכם דרך ה-API, לא מחיישן של HAM.

אחרי זה, המכשיר הווירטואלי עובד כמו כל המכשירים האחרים: גרפים, היסטוריה, כללים, דוחות ושיתוף.

מתי להשתמש בו

יש לכם חיישן או מערכת של יצרן אחר ואתם רוצים את הערכים שלהם באפליקציית HAM.
אתם רוצים כללים והתראות לערכים שהתוכנה שלכם מחשבת.

יסודות

פריט	ערך
משפחה	`v` ‏(Virtual HAM). המספר הסידורי הוא, לדוגמה, `v:123`.
מדידות	עד 6, עם הקודים `u0`,‏ `u1`,‏ `u2`,‏ `u3`,‏ `u4`,‏ `u5`
פלטים	אין
Keep-alive	אין. המכשיר משתנה רק כאשר אתם שולחים ערכים.

באפליקציה אין מסך ליצירת מכשיר וירטואלי. למכשיר וירטואלי חדש, פנו לתמיכה.

שליחת ערכים

שלחו POST אל virtual_device_update.php. אתם צריכים הרשאת מנהל על המכשיר.

curl -X POST https://api.hamsystems.eu/virtual_device_update.php \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serialno": "v:123", "R": {"u0": 2150, "u1": 48}}'

שדה	תוכן
`serialno`	המספר הסידורי של המכשיר הווירטואלי
`R`	המדידות, לפי קוד (`u0` עד `u5`)
`untime`	לא חובה. זמן המדידה בשניות unix. בלעדיו, השרת משתמש בזמן הנוכחי.

השרת שומר רק את השדות serialno,‏ R ו-untime. הוא מתעלם מכל שאר השדות.

התגובה היא JSON עם messages ו-response.

הודעת שגיאה	סיבה
`Invalid arguments`	`serialno` חסר.
`Invalid login`	המפתח או האסימון לא נכונים.
`Access denied to device`	אין לכם הרשאת מנהל על המכשיר.

קריאה

אתם קוראים את הערכים באותן דרכים כמו בכל המכשירים:

REST API למצב הנוכחי.
הורדת נתונים היסטוריים להיסטוריה.
WebSocket לשינויים חיים.

צ'אט עם התמיכה