בניית לוח בקרה למקרן ב-Home Assistant תוך כשעה

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

שני דברים מזינים את לוח הבקרה הזה, וההבדל ביניהם חשוב בכל שלב להלן.

כולם נמצאים בחנות ברירת המחדל של HACS. ב-Home Assistant: HACS › Frontend › Explore & Download Repositories, חפשו את השם, לחצו Download, ואז רעננו את הדפדפן.

כל קטע קוד בעמוד הזה משתמש בשני מציינים. מוצאים את שלכם פעם אחת, והשאר זה העתק-הדבק.

• sensor.YOUR_PROJECTOR → כלי פיתוח › מצבים ב-Home Assistant, וסננו לפי projector_pilot. משהו כמו sensor.projector_pilot_epson_qb1000b_qb1000w.
• YOURSERIAL → פתחו את האפליקציה, הגדרות › אוטומציה ביתית › Home Assistant. המזהה הנגזר מהמספר הסידורי מוצג שם, והוא האמצע של כל שם סקריפט מסונכרן: script.projpilot_YOURSERIAL_power_on, script.projpilot_YOURSERIAL_input_hdmi1, וכן הלאה.

אפשר גם לסנן את כלי פיתוח › מצבים לפי projpilot כדי לראות את כל רשימת הבקרות המסונכרנת בבת אחת, אחרי שבלוק ההעתקה והסנכרון של צעד 1 הושלמו.

1. הגדרות › לוחות בקרה › הוספת לוח בקרה › לוח בקרה חדש מאפס. קראו לו Projector Pilot.
2. פתחו אותו, ואז לחצו על סמל העיפרון בפינה הימנית העליונה כדי לערוך.
3. הוסיפו תצוגה. שתי הפריסות מתאימות; הלוח האמיתי משתמש בערימת הכרטיסים ברירת המחדל, אחד מתחת לשני, שהיא הקלה ביותר להדבקה.
4. כדי להדביק YAML, השתמשו בתפריט שלוש הנקודות בכרטיס ובחרו עריכה ב-YAML, או בתפריט שלוש הנקודות בלוח הבקרה עבור עורך תצורה גולמי כדי להדביק תצוגה שלמה בבת אחת.

ההגדרות של התצוגה עצמה, אם אתם מעדיפים להקליד אותן:

title: Projector Pilot
views:
- title: Projector Pilot
  path: projector-pilot
  icon: mdi:projector
  cards: []

התחילו במשהו שרק קורא, כדי לדעת שה-ID של הישות נכון לפני שנוגעים במשהו ששולח פקודה. זה חי ברגע שחיישן המקרן קיים, בלי בלוק העתקה, בלי סנכרון. הוסיפו כרטיס, עריכה ב-YAML, הדביקו:

type: custom:mushroom-template-card
primary: Brightness
secondary: '{{ state_attr(''sensor.YOUR_PROJECTOR'',''brightness'') }}'
icon: mdi:brightness-6
icon_color: green
layout: vertical
fill_container: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px);
    min-height: 104px; }'

אותה צורה קוראת כל אחד מכ-80 המאפיינים שהחיישן נושא: החליפו את brightness ב-contrast, gamma, color_temp, hdr_pq, lamp_hours, כל מה שתרצו באריח.

שמרו. אם מופיע מספר או מילה אמיתיים, ה-ID של הישות נכון והכול בהמשך יעבוד. אם מופיע ריק, חזרו לצעד 2.

כותרת פשוטה היא שטח מת. זה כרטיס markdown עם רקע גרדיאנט מ-card-mod, והוא מה שהופך ערימת אריחים למקטעים עם שמות. כל מקטע בלוח נפתח באחד כאלה, רק עם תווית ואימוג'י אחרים.

type: markdown
content: '🔌    **POWER & SOURCE**'
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.30), rgba(16,120,60,0.30));
    border: 1px solid rgba(61,220,107,0.45); border-radius: 14px; box-shadow: 0 6px 20px rgba(0,0,0,0.3); }
    ha-markdown { padding: 12px 20px !important; } ha-markdown p { margin: 0 !important;
    letter-spacing: 3px; color: #eafff0; font-size: 14px; font-weight: 700; }'

שנו את קוד האימוג'י ואת טקסט התווית; בלוק card-mod זהה בכל מקטע.

זה שולח פקודה במקום רק לקרוא ערך, ולכן הסקריפטים צריכים להתקיים קודם. הוא קורא ל-script.projpilot_YOURSERIAL_power_on, שהאפליקציה כותבת רק אחרי שמדביקים את בלוק ההעתקה שלה ל-configuration.yaml, מפעילים מחדש את Home Assistant ולוחצים על סנכרון עם HA.

type: custom:mushroom-template-card
primary: Power On
icon: mdi:power
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_power_on
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

אותו כרטיס עבור כיבוי, השחרת מסך, HDMI 1, HDMI 2, השתקת A/V, מצב צבע או זיכרון עדשה: רק התווית, הסמל ו-service משתנים.

הגיבור בראש הלוח הוא button-card: מצב הפעלה גדול, סיכום בשורה אחת הבנוי ממספר מאפיינים בבת אחת, וטיפול הזכוכית הירוקה על הכרטיס כולו ולא רק על המסגרת.

type: custom:button-card
entity: sensor.YOUR_PROJECTOR
name: Epson QB1000
show_state: true
show_label: true
size: 48px
state_display: '[[[ return entity.state==''on'' ? ''Powered on'' : ''Standby''; ]]]'
label: '[[[ var a=entity.attributes; return (a.input||''-'')+''  •  ''+(a.color_mode||''-'')+
  ''  •  ''+(a.video_range||''-'')+''  •  ''+(a.lamp_hours||0)+''  h''; ]]]'
styles:
  card:
  - height: 176px
  - background: linear-gradient(135deg, rgba(61,220,107,0.32), rgba(11,64,34,0.6))
  - border: 1px solid rgba(61,220,107,0.5)
  - border-radius: 22px
  - box-shadow: 0 12px 36px rgba(0,0,0,0.42)
  - padding: 20px
  state:
  - color: '[[[ return entity.state==''on'' ? ''#3ddc6b'' : ''#8a9'' ]]]'

מקוצר לחלקים שמשתנים בכל התקנה. הכרטיס המלא קובע גם את מיקומי הסמל, השם והתווית ברשת; ראו את ההורדה בצעד 10 לכל הפרטים.

מעדיפים פס דק יותר? mushroom-chips-card עושה את אותה עבודה בשורה אחת של שבבים קטנים: מצב הפעלה, קלט, מצב צבע, טווח וידאו ושעות מנורה, כל אחד תבנית שקוראת state_attr('sensor.YOUR_PROJECTOR', ...). השתמשו באחד או בשני, לא בשניהם, בראש הלוח.

כל סצנה שאתם שומרים באפליקציה נהפכת לסקריפט בשם script.projpilot_YOURSERIAL_scene_<id> אחרי הסנכרון, ואריח לסצנה הוא אותו כרטיס לחצן בקרה מצעד 6 עם שם סצנה וסמל.

type: custom:mushroom-template-card
primary: Movie Night
icon: mdi:movie-open
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_scene_YOURSCENE1
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

החליפו את YOURSCENE1 במזהה שמוצג לאותה סצנה ברשימת הבקרות המסונכרנת של האפליקציה. אריח אחד לכל סצנה, בתוך horizontal-stack.

חיישן המקרן מתועד על ידי Home Assistant כמו כל חיישן אחר, ולכן ל-lamp_hours יש היסטוריה בחינם. בלי חיישנים נוספים, בלי עוזרים, בלי שום דבר להגדיר קודם, תחת מקטע התחזוקה.

type: custom:mini-graph-card
entities:
- entity: sensor.YOUR_PROJECTOR
  attribute: lamp_hours
  name: Laser hours
name: Laser hours
icon: mdi:lightbulb-on-outline
line_color: '#3ddc6b'
line_width: 4
hours_to_show: 336
points_per_hour: 0.5
height: 96
animate: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px); }'

336 שעות הן שבועיים. שעות לייזר ומנורה עולות בהתמדה ולא קופצות, ולכן חלון של שבועיים בדרך כלל מספיק כדי לראות את המגמה בלי שהגרף ייראה שטוח.

התצוגה השלמה, כל מקטע וכל כרטיס מצילום המסך בראש העמוד הזה, עם מציינים במקום ID-ים של ישויות.

1. הורידו את ה-YAML של התצוגה.
2. פתחו אותו בכל עורך טקסט והחליפו, בכל מקום שהם מופיעים: את YOUR_PROJECTOR במזהה הישות של חיישן המקרן שלכם מצעד 2, ואת YOURSERIAL במזהה הנגזר מהמספר הסידורי שלכם מצעד 2.
3. במקטע הסצנות ליד התחתית, החליפו את YOURSCENE1, YOURSCENE2 ו-YOURSCENE3 בשלושת מזהי הסצנות שלכם, או הוסיפו והסירו אריחים כך שיתאימו למספר הסצנות שיש לכם בפועל.
4. ב-Home Assistant, פתחו את לוח הבקרה שלכם, סמל עיפרון, תפריט שלוש נקודות, עורך תצורה גולמי, והדביקו אותו כתצוגה.