המקרן שלכם, ב-Home Assistant וב-Hubitat.

• היא מפרסמת מצב. המקרן מופיע כחיישן ב-Home Assistant, כמכשיר ב-Hubitat, או כמטען JSON ב-webhook שלכם, עם אותן קריאות שהאפליקציה מראה לכם.
• היא מפרסמת בקרות. כל סצנה שאתם שומרים, וכן הפעלה, כל קלט, כל מצב צבע וכל זיכרון עדשה, הופכים למשהו שאוטומציה או עוזר קולי יכולים להפעיל.
• היא רצה בלי שרת. אחרי שהסקריפטים מוגדרים, Home Assistant שולח פקודות ישירות לכתובת ה-IP של המקרן. הטלפון שלכם לא צריך להיות ברשת, ושום דבר לא עובר דרך חשבון בענן.

שלוש דרכי כניסה, מרכז אחד

הגדרות › אוטומציה ביתית הוא המרכז. בחרו את הפלטפורמה שאתם מפעילים - Home Assistant, Hubitat או Webhooks - והגדירו אותה שם. אפשר לחבר יותר מאחת בו-זמנית; הן עצמאיות.

1. פתחו הגדרות › אוטומציה ביתית › Home Assistant.
2. הקלידו את כתובת Home Assistant שלכם (למשל http://homeassistant.local:8123 או ה-IP שלו), ואז לחצו על התחברות. זו התחברות בדפדפן מול המופע שלכם - אין אסימון להדביק. השתמשו בהתחברות הרגילה שלכם ל-Home Assistant, כולל אימות דו-שלבי.
3. האפליקציה מפרסמת את המקרן כחיישן, עם ישות כמו sensor.projector_pilot_epson_qb1000b_qb1000w, שנושאת הפעלה, קלט, מצב צבע, נתוני התמונה ושעות מנורה.
4. הפעילו את שליחת מצב המקרן כדי שהקריאות יתעדכנו ב-Home Assistant בכל פעם שהן משתנות בזמן שהאפליקציה פתוחה, והפעילו את סנכרון בקרות מתקדמות כדי לפרסם סקריפטים למצבי תמונה, קלטים, זיכרונות עדשה והפעלה.
5. הדביקו את בלוק shell_command האחד (בהמשך) ל-configuration.yaml שלכם, הפעילו מחדש את Home Assistant, ואז לחצו על סנכרון עם HA.

בלוק shell_command

זה כל הטריק של העבודה בלי שרת. האפליקציה כותבת פקודה אחת ש-Home Assistant מריץ כדי לדבר עם Web Control של המקרן, וכל סקריפט שהיא מסנכרנת קורא לפקודה הזו עם פועל אחר. לחצו על העתקת בלוק באפליקציה והדביקו ל-configuration.yaml. הדוגמה שלהלן להמחשה בלבד - האפליקציה ממלאת את הכתובת ואת שם הפקודה של המקרן שלכם:

shell_command:
  projector_pilot_epson: >-
    curl -s --max-time 5 --digest -u 'EPSONWEB:'
    -H "X-Requested-With: XMLHttpRequest"
    -H "Referer: http://192.168.1.50/cgi-bin/webconf"
    "http://192.168.1.50/cgi-bin/directsend?{{ verb }}={{ value | urlencode }}"

דוגמה בלבד. האפליקציה מייצרת את שלכם עם ה-IP האמיתי של המקרן ושם שנגזר מהמספר הסידורי שלו.

בדיקת חיבור, סנכרון וניקוי

• בדיקת חיבור בודקת שהאפליקציה מגיעה ל-Home Assistant שלכם ושה-shell_command שהודבק באמת שם, כדי שתמצאו שגיאת הקלדה לפני שבונים עליו משהו.
• סנכרון עם HA כותב או מעדכן את הסקריפטים של הסצנות והבקרות שלכם, ובונה לוח בקרה מוכן של Projector Pilot ישירות ב-Home Assistant. הריצו אותו שוב בכל פעם שמוסיפים סצנה או משנים בקרה - הוא מתעדכן במקום ולא יוצר כפילויות.
• הסרת סקריפטים יתומים מוצאת סקריפטים שהאפליקציה כתבה ושאין להם יותר סצנה או בקרה תואמת - למשל אחרי שמחקתם סצנה - מציגה בדיוק אילו מהם תסיר, ושואלת קודם. שום דבר לא נמחק עד שתאשרו. היא נוגעת רק בסקריפטים ש-Projector Pilot יצרה; שום דבר אחר ב-Home Assistant שלכם לא מופרע, ואם Home Assistant לא מציג את רשימת הסקריפטים שלו, לא מוסר דבר.

• מחובר ל-Home Assistant - מחוברים ועונה. אם Home Assistant לא עונה, השורה אומרת לבדוק את הכתובת ושהטלפון באותה רשת.
• המקרן נוסף ל-Home Assistant - האם ל-Home Assistant כבר יש את המקרן הזה. אם לא, השורה שולחת אתכם להוסיף את אינטגרציית PJLink, ושלב הוספת האינטגרציה מציג את המארח והפורט של PJLink ש-Home Assistant מבקש.
• חיישן הקריאות נרשם - החיישן שנושא את הקריאות של המקרן שלכם. הוא נרשם בפעם הראשונה שהאפליקציה קוראת את המקרן, והשורה מציעה רשום עכשיו או הפעלה כשמשהו מונע זאת.
• מה יש ב-Home Assistant שלכם - HACS (חנות הקהילה), אינטגרציית Epson Projector Link, אינטגרציית PJLink, ופקודות Projector Pilot ב-configuration.yaml. כל אחד מציג נמצא, לא מותקן או לא ניתן לדעת, עם לחצני איך להתקין ופתח ב-HACS איפה שזה עוזר.

• כרטיסים מובנים קודם. אם אין לכם כרטיסי קהילה, הסנכרון בונה את לוח הבקרה עם הכרטיסים המובנים של Home Assistant ואומר זאת בסיום. זה עובד ישר מהקופסה.
• משודרג כשכרטיסי HACS מותקנים. האפליקציה בודקת אילו מכרטיסי הקהילה (Mushroom, button-card, card-mod, apexcharts-card) מותקנים ומשדרגת כל כרטיס לעשיר יותר איפה שיש לכם אותו. מדריך לוח הבקרה הבנוי ביד הולך רחוק יותר אם אתם רוצים את מראה הזכוכית הירוקה המלא.
• סצנות ובקרות צריכות את ההדבקה האחת. אם ל-Home Assistant עדיין אין פקודה לשליחה אל המקרן, לוח הבקרה עדיין נבנה עם קריאות חיות, וכרטיס סיום ההגדרה מדריך אתכם: לחצו על העתקת בלוק, הדביקו ל-configuration.yaml, הפעילו מחדש את Home Assistant, ואז לחצו שוב על סנכרון.
• שום דבר לא מותקן? הדביקו ידנית. אם שום דבר לא מותקן ב-Home Assistant אפשר עדיין להעתיק הכול מהאפליקציה ולהדביק בעצמכם.
• סיסמה מסומנת. בלוק הפקודה שאתם מדביקים אומר מתי הוא נושא סיסמת מקרן, כדי שתדעו לפני ששומרים או משתפים אותו.

• זה עוד בלוק אופציונלי: הדביקו אותו בסוף configuration.yaml (או הוסיפו רק את השורות שלו תחת מקטע template: קיים) והפעילו מחדש את Home Assistant. באפליקציה יש לחצן בדוק שהוא שם שאומר לכם אם Home Assistant מכיל אותו.
• כיבוי מגיע עכשיו ל-Home Assistant כ-off, כך שלוח הבקרה והאוטומציות שלכם רואים את המקרן כבוי כשהוא כבוי.

• אוטומציות יכולות להריץ אותם. ״בשקיעה, אם ה-TV נדלק, הפעל את ערב קולנוע״ היא אוטומציה רגילה ב-Home Assistant ברגע שהסצנה היא סקריפט.
• עוזרים קוליים יכולים להריץ אותם. חשפו סקריפט לעוזר שלכם ו״הפעל ערב קולנוע״ קובע יחד את הקלט, את מצב התמונה ואת זיכרון העדשה.
• מופיעות רק הבקרות האמיתיות שלכם. האפליקציה כותבת סקריפט לכל קלט, מצב צבע וזיכרון עדשה שהמקרן מדווח עליהם - לא רשימה כללית שניחשה.
• הסרת הסנכרון מסירה רק מה שהאפליקציה כתבה. כבו את הסנכרון, או השתמשו בהסרת סקריפטים יתומים (שמציגה אותם ושואלת קודם), ו-Projector Pilot מוחקת את הסקריפטים שיצרה ושום דבר אחר.

לוח הבקרה

הסנכרון בונה לכם את לוח הבקרה

אין צורך לבנות תצוגת Lovelace ביד, וגם לא להדביק אחת. כשלוחצים על סנכרון עם HA, האפליקציה בונה לוח בקרה שלם של Projector Pilot ישירות ב-Home Assistant דרך ה-API שלו: המצב החי של המקרן ולחצן לכל סצנה ובקרה שסונכרנו. הוא מופיע בסרגל הצד של Home Assistant בשם Projector Pilot - פותחים וזה גמור.

1. התחברו ל-Home Assistant באפליקציה.
2. הדביקו את בלוק ההעתקה של האפליקציה ל-configuration.yaml פעם אחת והפעילו מחדש את Home Assistant (הצעד הידני היחיד - Home Assistant לא מאפשר לאפליקציות להוסיף את הפקודה הזו מרחוק).
3. לחצו על סנכרון עם HA. לוח הבקרה נבנה בשבילכם ומופיע בסרגל הצד בשם Projector Pilot.

בין אם הוא נבנה בשבילכם ובין אם הדבקתם אותו, לוח הבקרה זהה - כרטיס מצב ולחצן לכל בקרה (קטע להמחשה):

views:
  - title: Projector
    cards:
      - type: entity
        entity: sensor.projector_pilot_epson_qb1000b_qb1000w
        name: Projector
      - type: button
        name: Power On
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_power_on
      - type: button
        name: Movie Night
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_scene_movie_night

דוגמה בלבד. לוח הבקרה שלכם נושא את הישות האמיתית של המקרן ואת הסצנות שלכם.

1. ב-Hubitat, הפעילו את אפליקציית Maker API, רשמו את כתובת ה-URL והאסימון שלה, ובחרו אילו מכשירים היא חושפת.
2. ב-Projector Pilot, פתחו הגדרות › אוטומציה ביתית › Hubitat והזינו את פרטי Maker API של ה-hub שלכם.
3. בחרו את המכשיר שמייצג את המקרן. האפליקציה מציעה את הסביר ביותר; בחרו בו או בחרו משלכם.
4. האפליקציה משקפת הפעלה, השתקה וקלט אל המכשיר הזה, ושולחת רק את הפקודות שהמכשיר מקבל.
5. בנו כללי Rule Machine מול המכשיר הזה כמו מול כל מכשיר אחר - מצב המקרן מפעיל אותם.

1. פתחו הגדרות › אוטומציה ביתית › Webhooks.
2. הזינו את ה-URL שאליו נשלח. webhook של Home Assistant נראה כמו http://homeassistant.local:8123/api/webhook/your-id.
3. בחרו אילו אירועים מפעילים את ה-webhook: הדלקה, כיבוי, החלפת קלט, הפעלת סצנה - ואפשר גם לסנן לקלט או לסצנה מסוימים.
4. אם רוצים, הגדירו מטען מותאם אישית אם השירות המקבל רוצה צורה מסוימת; אחרת האפליקציה שולחת את ה-JSON ברירת המחדל שלה.
5. שמרו. מעכשיו האפליקציה שולחת בכל אירוע תואם.

מטען ברירת המחדל הוא JSON פשוט - אירוע, המקרן, והערך שהשתנה:

{
  "event": "scene_recalled",
  "projector": "Epson QB1000B/QB1000W",
  "scene": "Movie Night",
  "power": "on",
  "input": "HDMI1",
  "color_mode": "Cinema",
  "timestamp": "2026-09-23T20:14:07Z"
}

מטען לדוגמה. אירוע החלפת קלט או הפעלה נושא את השדות הרלוונטיים אליו.