У артыкуле я прадстаўляю працэс дадання неафіцыйнай інтэграцыі (карыстацкі кампанент) у хатні памочнік на прыкладзе інтэграцыі з выкарыстаннем хмарных сэрвісаў eWeLink і ў выніку дазваляе нам кантраляваць прылады Sonoff без змены іх прашыўкі.
Нядаўна мы паказалі, як выкарыстоўваць убудаваную IKEA Tradfri Integration. Сёння мы пакажам вам, як усталяваць неафіцыйную інтэграцыю.
Хатні памочнік - інтэграцыя з сістэмай IKEA Tradfri
У Home Assistant ёсць шмат афіцыйных інтэграцый, якія пастаўляюцца разам з ім, гатовыя да выкарыстання. Яны не патрабуюць ад нас дадатковай устаноўкі і абнаўлення - яны абнаўляюцца разам з сістэмай. Спіс усіх даступных на гэты момант афіцыйных інтэграцый можна знайсці па адрасе:
https://www.home-assistant.io/integrations/
Нягледзячы на такую вялікую калекцыю (у цяперашні час 1540 пашырэнняў), у сувязі з тэмпамі развіцця свету IoT існуе неабходнасць у далейшай інтэграцыі ў рамках Home Assistant не толькі для падтрымкі наступных прылад, але і звязана з выкарыстаннем розных інтэрнэт-сэрвісаў, алгарытмаў, аўтаматызацыі і г.д. новыя, неафіцыйныя інтэграцыі, напісаныя суполкай «Дамашні памочнік». Яны называюцца прыстасаваныя кампаненты, Часцей за ўсё іх сховішчы і інструкцыі знаходзяцца на партале GitHub.
У каталог змешчаны неафіцыйныя інтэграцыі:
\\ Local \ Config \ custom_components
дзе мясцовы, гэта хатні каталог хатняга памочніка. Мы павінны клапаціцца аб нашых абнаўленнях карыстацкага кампанента.
Ніжэй я прывяду працэс дадання неафіцыйнай інтэграцыі да Home Assistant на прыкладзе інтэграцыі з выкарыстаннем хмарных сэрвісаў eWeLink і ў выніку дазваляе нам кантраляваць прылады Sonoff без змены іх прашыўкі. Я дадала пераключальнік Sonoff T4EU1C (без нейтральнага кабеля) у дадатак eWeLink.
На здымку: Banggood
Канфігурацыя тэсту:
- Хатні памочнік 0.103.6,
- Сістэма Hass.io (Raspberry Pi 2 B),
- Дадатак Samba 9.0 або канфігуратар 4.2
Патрабуецца абсталяванне:
- У залежнасці ад канкрэтнага карыстацкага кампанента, у нашым выпадку гэта будзе адзін з перамыкачоў Sonoff (мадэль TX T4EU1C), дададзены ў зыходнае прыкладанне eWeLink.
Узровень прасоўвання:
- Неабходныя асноўныя веды хатняга памочніка.
Іногражная інтэграцыя
Інтэграцыйную старонку, якую мы будзем выкарыстоўваць, можна знайсці тут:
https://github.com/peterbuga/HASS-sonoff-ewelink
Мы загрузім з яго неабходныя файлы і знойдзем інструкцыі па ўстаноўцы, а таксама спіс падтрымліваемых прылад Sonoff.
Паколькі гэта інтэграцыя з паслугай eWeLink, для яе сэнсу неабходна спачатку стварыць уліковы запіс у дадатку eWeLink і дадаць у яго прыладу.

1. Загрузіце ўласны кампанент "HASS-sonoff-ewelink"
Пераходзім на сайт:
https://github.com/peterbuga/HASS-sonoff-ewelink
і загрузіць .zip архіў з неабходнымі файламі. Затым распакуйце архіў на дыск.

2. Капіяванне файлаў
Мы ўпэўненыя, што мы ўсталявалі і наладзілі надбудову Доля Самба.
Мы ўводзім File Explorer па наступным адрасе:
HASSIO \\ \ Config \
HASSIO гэта назва сеткавага месцазнаходжання "Home Assistant", якую мы ўсталявалі ў канфігурацыі Доля Самба (па змаўчанні ёсць HASSIO). Мы ствараем там новую папку карыстацкія_кампанентыі ўнутры яго яшчэ адзін - заносіць.
У гэтую тэчку:
HASSIO \\ \ Config \ custom_components \ sonoff \
скапіруйце файлы з распакаванага раней архіва "HASS-sonoff-ewelink-master.zip".


3. Дадаткова - Праверка лакальнага IP-адраса прылады
Карыстацкі кампанент Sonoff працуе на прынцыпе выкарыстання інтэрнэт-паслуг, якія прадстаўляюцца воблакам. У гэтым выпадку гэты момант не патрэбны.
Аднак бывае, што інтэграцыя (афіцыйная ці не) падключаецца непасрэдна праз WiFi да прылады ў нашай лакальнай сетцы. Пасля гэтага неабходна ведаць IP-адрас гэтай прылады, і рэкамендуецца пастаянна прызначаць гэты адрас у нашым маршрутызатары. У гэтым выпадку прачытайце гэты пункт.
Мы правяраем лакальны IP-адрас абранай прылады, які падтрымлівае Home Assistant у маршрутызатары. Звычайна сайт маршрутызатара знаходзіцца па адрасе:
192.168.0.1
Вы можаце часта ўбачыць радок прылады па імені.
нататкі:
- У маршрутызатары UPC "Connect Box" спачатку папытаеце гарачую лінію загрузіць пратакол IPv4 выдалена замест IPv6 па змаўчанні. Без гэтага вы не знойдзеце патрэбнага пункта ў меню маршрутызатара.


4. Мадыфікацыя config.yaml
Часцей за ўсё на сайце GitHub з абранай інтэграцыяй ёсць кіраўніцтва, у якім аўтар падрабязна апісвае раздзел, які трэба дадаць у файл канфігурацыі. У гэты раздзел трэба дадаць, каб актываваць раней загружаную інтэграцыю.
файл configuration.yaml можа быць зменены сярод іншых з дапамогай надбудовы Доля Самба Ораз Канфігуратар. W Доля Самба У нас ёсць непасрэдна даступны файл, знаходзячыся ў канфігуратар, файлы рэдагуюцца ўскосна праз інтэрфейс карыстальніка Home Assistant. Я звычайна выкарыстоўваю для гэтай мэты канфігуратар.
Варыянт 1 - доля самбы

Пасля ўстаноўкі убудовы файл "configuration.yaml" павінен знаходзіцца ў тэчцы:
HASSIO \\ \ Config \

Варыянт 2 - канфігуратар

Пасля ўстаноўкі дапаўненні дастаткова выбраць у яго наладах "Паказаць на бакавой панэлі", каб зручна атрымаць доступ да яго з меню Галоўная памочнік, Акрамя таго, мы выбіраем файл канфігурацыі, мяняем яго ў адпаведнасці з астатнімі інструкцыямі і захоўваем.

Каб актываваць інтэграцыю Sonoff, дадайце ў канфігурацыйны файл наступны раздзел:
sonoff: імя карыстальніка: [Імя карыстальніка з прыкладання eWeLink] пароль: [Пароль ад прыкладання eWeLink] scan_interval: 60 grace_period: 600 api_region: 'eu' entit_prefix: Праўда адладка: False
Не ўсе радкі гэтага раздзела абавязковыя, падрабязнае апісанне можна знайсці на старонцы інтэграцыі. Цяпер захавайце файл і перазапусціце хатні памочнік.
5. Папярэдні прагляд дададзеных прылад Sonoff
Пасля перазапуску Home Assistant сумяшчальныя прылады Sonoff павінны быць даступныя ў Entities:
Калі ласка, увядзіце:
Інструменты для распрацоўшчыкаў -> СТАНЫ
Прылады, дададзеныя ў гэтай інтэграцыі Home Assistant, па змаўчанні будуць мець "sonoff_" (калі іншае не пазначана ў configuration.yaml). Таму для іх папярэдняга прагляду дастаткова ў полі аб'ект пачніце набіраць "sonoff".

6. Даданне карты ў хатні памочнік
У галоўным меню "Агляд", з дапамогай убудаванага майстра альбо шляхам рэдагавання файла ўручную, мы можам дадаць карту пераключэння Sonoff.
Каб атрымаць картку, як паказана на малюнку, у файл у раздзеле "віды:" дадайце раздзел:

праглядаў: - назва: панэль салона: праўдзівы шлях: карты_салон прагляду: - тып: назва сутнасцей: перамыкачы show_header_toggle: ілжывыя асобы: - сутнасць: перамыкач.


фота: inDomus.it