Home-Assistant – A way to configure

Home Assistant מאחסן את התצורה שלו בקובץ בשם configuration.yaml. ברירת המחדל נוצרת כאשר ה – Home Assistant מופעל בפעם הראשונה. חלק מהדברים בקובץ התצורה ניתן לערוך באמצעות ממשק המשתמש, חלקים אחרים דורשים ממך לערוך את קובץ התצורה ישירות.

במדריך זה אפרט על שתי השיטות העקריות לעריכת קבצי הקונפיגורציה:

• שיתוף קבצים ועריכה באמצעות תוכנות כמו Notepad++.
• שימוש ב configurator ועריכה בדפדפן.

 

חלק א' – עריכה על ידי שיתוף קבצים – SMB

על מנת שנוכל לערוך את קבצי ההגדרה מרחוק יש "להחצין" את הקבצים ולחשוף אותם על ישי שימוש בשיתוף רשת (SMB). לצורך כך נתקין שרות שנקרא samba על גבי מערכת ההפעלה על ישי הפקודות הבאות:

sudo apt-get update
sudo apt-get install samba

כעת, לאחר ההתקנה נערוך את קובץ הקונפיגורציה של השרות ונוסיף את התיקיות אותן נרצה לשתף. לצורך כך פתחו לעריכה את קובץ ההגדרות על ידי הפקודה הבאה:

sudo nano /etc/samba/smb.conf

מחקו את כל תוכנו והחליפו אותו בתוכן הבא:

[global]
netbios name = RP2
server string = The Pi File Center
workgroup = WORKGROUP
hosts allow =
socket options = TCP_NODELAY IPTOS_LOWDELAY SO_RCVBUF=65536 SO_SNDBUF=65536
remote announce =
remote browse sync =


[HOME ASSISTANT]
path = /home/homeassistant/.homeassistant
comment = No comment
browsable = yes
read only = no
valid users =
writable = yes
guest ok = yes
public = yes
create mask = 0777
directory mask = 0777
force user = root
force create mode = 0777
force directory mode = 0777
hosts allow =

כעת, לחצו כל ctrl+x על מנת לסגור את הקובץ ואז על y לשמירה.

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

sudo smbpasswd -a pi

כעת תתבקשו להקיש סיסמה עבור המשתמש וכן אימות סיסמה.

כעת נבצע אתחול לשרות ה SMB על מנת להכניס את השינויים לתוקף, לצורך כך הקישו את הפקודה הבאה:

sudo service smbd restart

תוכלו כעת לגשת לקבצי ההגדרה של המערכת על ידי לחיצה על התחל > הפעלה וכתיבת הפקודה

\\[Pi IP Address]

במידה והכל הוגדר כראאוי, אתם אמורים לראות מסך שנראה כך:

הקלידו את שם המשתמש והסיסמה שבחרתם ולחצו על OK, ותוכלו לראות את התיקיה של קבצי הקונפיגורציה:

כעת תוכלו לערוך את קבצי ההגדרות בכל עורך טקסט שתחפצו (ממולץ שימוש ב notepas++ או Visual Studio בעל תוסף לעריכה בשפת yaml).

*** טיפ עורך *** – כברירת מחדל בעת שיתוף קבצים התיקיה תהיה חשופה לעיני כל, כלומר כל מכשיר ברשת יוכל לגשת אליה (במידה והסיסמה שהוגדרה היא ברירת המחדל וידועה), על מנת להקשיח קלות את הגישה ניתן להשתמש בדבר שנקרא "שיתוף נסתר" או "שיתוף מנהלי" וזאת שינוי הערך של broswable מ yes ל- no.

במצב זה, מי שירצה להגיע לקבצים ידרש להקליד את הכתובת המלאה, קרי:

\\[Pi IP Address]\Home Assistant

 

חלק ב' – שימוש ב Configurator ודפדפן

configurator למי שאינו מכיר הוא שרות (service) אשר מותקן על גבי המערכת במקביל ל Home Assistant ומאפשר את עריכת קבצי התצורה של המערכת באמצעות דפדפן אינטרנט.
על מנת להתקין את השרות יש לפעול על פי השלבים הבאים (המדריך מתאים למשתמשים אשר משתמשים ב Hassbian Image וגם לאלה שהתקינו Virtual Env על פי המדריך הבא):

תחילה יש להתקין git על ידי הפקודה הבאה:

sudo apt-get install git

כעת הקישו את הפקודה הבאה בטרמינל:

cd /home/homeassistant/.homeassistant

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

sudo git clone https://github.com/danielperna84/hass-configurator.git

כעת הקישו את הפקודה הבאה על מנת להכנס לתיקיה שזה עתה נוצרה:

cd hass-configurator

וערכו את קובץ ההגדות:

sudo nano settings.conf

וודאו שהוא נראה כך:

{
"LISTENIP": "0.0.0.0",
"LISTENPORT": 3218,
"BASEPATH": "/home/homeassistant/.homeassistant",
"SSL_CERTIFICATE": null,
"SSL_KEY": null,
"HASS_API": "http://127.0.0.1:8123/api/",
"HASS_API_PASSWORD": "iAmPassword!!!",
"CREDENTIALS": null,
"ALLOWED_NETWORKS": [],
"BANNED_IPS": [],
"BANLIMIT": 0,
"IGNORE_PATTERN": []
}

*** הערה *** – לרוב, לא צריך לשנות כלום. במידה והגדרתם סיסמה עבור ה Home Assistant יש להגדירה בקובץ בשורה: "HASS_API_PASSWORD": "iAmPassword!!!".

כעת הקישו ctrl+x ו-y לשמירה ולחצו על אנטר לאישור.

בשלב הבא נגדיר ל Configurator לעלות עם מערכת ההפעלה (על מנת למנוע את הצורך בהפעלה ידנית בכל פעם מחדש), לצורך כך כתבו את הפקודה הבאה:

sudo nano /lib/systemd/system/configurator.service

והעתיקו פנימה את הטקסט הבא:

[Unit]
Description=Hassio configurator
After=network.target
 
[Service]
Type=simple
User=homeassistant
ExecStart=/usr/bin/python3 /home/homeassistant/.homeassistant/hass-configurator/configurator.py /home/homeassistant/.homeassistant/hass-configurator/configurator.conf
Restart=on-abort
 
[Install]
WantedBy=multi-user.target

סגרו את העורך באמצעות לחיצה על ctrl+x ואז y  ואנטר לאישור.

כעת ניתן לקבוץ שיצרנו הרשאות ריצה על ידי הפקודה הבאה:

sudo chmod 644 /lib/systemd/system/configurator.service

כעת נפעיל את השרות על ידי הפקודות הבאות:

sudo systemctl daemon-reload
sudo systemctl enable configurator.service
sudo systemctl start configurator.service

כעת פתחו את הדפדפן והקישו את כתובת השרת בתוספת פורט 3218, לדוגמה: http://192.168.0.1/3218. במידה והכל הוגדר כראוי אתם אמורים לקבל מסך שנראה כך: