Homebridge را روی Raspberry Pi و Windows نصب کنید: 9 مرحله

2024 نویسنده: John Day | [email protected]. آخرین اصلاح شده: 2024-01-30 08:54

این آموزش برای افرادی است که می خواهند Homebridge را روی رزبری پای و ویندوز نصب کنند.

در ابتدا ، این آموزش به زبان پرتغالی در برزیل نوشته شد. من تمام تلاشم را کردم که آن را به انگلیسی بنویسم. بنابراین من را برای برخی اشتباهات که ممکن است در نوشتن وجود داشته باشد ببخشید.

این دستورالعمل به شرح زیر تقسیم شد:

مرحله 1: Homekit چیست؟

مرحله 2: Homebridge چیست؟

مرحله 3: نصب Homebridge بر روی Raspberry Pi

مرحله 4: راه اندازی Homebridge با Raspbian Boot

مرحله 5: نصب افزونه Homebridge Config UI X (Raspberry Pi)

مرحله 6: نصب Homebridge بر روی ویندوز

مرحله 7: نصب افزونه Homebridge Config UI X (Windows)

مرحله 8: راه اندازی Homebridge با ویندوز

مرحله 9: اتصال Homebridge به برنامه Home

مرحله 1: Homekit چیست؟

Homekit یک بسته توسعه ای است که توسط اپل برای توسعه دهندگان برای ایجاد راه حل های اینترنت اشیا (IoT) ارائه شده است. این بسته توسعه دستگاه های ساخته شده توسط اپل (به عنوان مثال iPhone و iPad) را قادر می سازد تا دستگاه های دیگر مانند لامپ یا اطلاعات حسگر را کنترل کنند. از iOS 9 و Watch OS Homekit به یک ابزار بومی تبدیل شد و با توجه به تمام فناوری پیاده سازی شده توسط اپل ، امکان ایجاد سیستم های اتوماسیون به سادگی با این کیت وجود دارد.

برای شناسایی دستگاه های سازگار با Homekit که در شبکه فعال هستند و برای پیکربندی و کنترل این دستگاه ها ، باید برنامه Home را روی هر دستگاه Apple (iPhone ، iPad ، iPod touch ، Apple Watch ، Apple TV ، HomePod یا Mac) نصب کرده باشید. به دستگاه های ادغام شده با برنامه Home می توانند دارای کد QR باشند که امکان جفت شدن با برنامه Home را در دستگاه Apple شما فراهم می کند.

پس از پیکربندی دستگاه در برنامه Home ، کاربر می تواند دستگاه را از طریق میانبری که در صفحه اصلی برنامه ایجاد می شود کنترل کند یا از Siri (دستیار صوتی ارائه شده توسط اپل) استفاده کرده و دستورات صوتی را برای فعال شدن دستگاه ارسال کند.

سخت افزار و نرم افزار مورد نیاز اپل برای استفاده از Homekit عبارتند از:

- iPhone ، iPad یا iPod touch (دارای iOS 10 یا بالاتر) ؛

- Apple Watch (در حال اجرا WatchOS 3 یا بالاتر) ؛

- Apple TV (نسل 4) ؛

- Apple HomePod ؛

- مک (در حال اجرا macOS 10.14 Mojave یا بالاتر) ؛

وقتی صحبت از اتوماسیون خانه و اینترنت اشیا می شود ، تعدادی راه حل مقرون به صرفه در بازار وجود دارد ، با این حال ، اکثریت قریب به اتفاق گواهینامه اپل را ندارند و بنابراین بومی با Homekit سازگار نیستند. اگر از انتظار برای تایید اپل برای راه حل های مورد استفاده برای Homekit خسته شده اید ، باید از Homebridge استفاده کنید.

مرحله 2: Homebridge چیست؟

Homebridge که توسط نیک فارینا توسعه یافته است ، یک سرور NodeJS است که از API Homekit تقلید می کند و امکان استفاده از دستگاه های دارای مجوز غیر اپل با برنامه Home و Siri را ممکن می سازد. سرور سبک وزن است ، می تواند در شبکه خانگی اجرا شود و ماژولار است ، به این معنی که از چندین افزونه که توسط یک جامعه فوق العاده فعال در تقویت ابزار ایجاد و در دسترس قرار گرفته است ، پشتیبانی می کند.

افزونه ها بر روی Homebridge نصب شده اند و اکثر آنها به منظور ایجاد سازگاری با Homekit با هر دستگاهی که دارای گواهینامه Apple نیست ، هستند. افزونه هایی برای استفاده با Homebridge مستقیماً از وب سایت NPM نصب می شوند.

نصب Homebridge را می توان در سیستم های مختلف انجام داد ، با این حال ، برای این دستورالعمل از Raspberry Pi 3 Model B + با سیستم عامل Raspbian استفاده می شود ، و همچنین نحوه نصب بر روی ویندوز را نیز توضیح خواهم داد.

مرحله 3: نصب Homebridge بر روی Raspberry Pi

در حالت ایده آل ، Homebridge باید در هر زمان که به آن نیاز دارید در دسترس باشد ، بنابراین باید سرور را به صورت 24 ساعته و 24 ساعته کار کنید. برای این کار می توانید سرور را روی رزبری پای نصب کنید و به طور مداوم در شبکه خانگی خود کار کنید.

اگر Raspbian را روی کارت حافظه نصب و پیکربندی نکرده اید ، توصیه می کنم که Installable Install and Configure Raspbian را در Raspberry Pi بخوانید ، مراحل زیر را دنبال کنید و سپس برای ادامه کار برگردید.

با Raspberry Pi خود که Raspbian را اجرا می کند ، در صفحه اصلی سیستم ترمینال را باز کنید:

در ترمینال ، اولین دستور زیر را تایپ کنید ، enter را فشار دهید ، و در صورت درخواست تایپ نوع عمل Y و دکمه enter را فشار دهید. این نوع تأیید اغلب هنگام حذف یا نصب بسته ها ظاهر می شود. سپس فرمان دوم را تایپ کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید. این دستورات در صورت لزوم سیستم را بررسی و به روز می کنند:

sudo apt-get update

sudo apt-get upgrade

دستور زیر را در ترمینال تایپ کرده و enter را بزنید:

ifconfig

برخی از اطلاعات عودت داده می شود. اگر از کابل شبکه برای ایجاد اتصال شبکه به رزبری پای خود استفاده می کنید ، بعد از "eth0:" به قسمت اطلاعات بروید و آدرس MAC کارت شبکه هشت رقمی را جستجو کنید و بعد از کلمه "ether" خواهد بود. برای اتصال شبکه به کارت خود از اتصال WiFi استفاده می کنید ، پس از "wlan0:" به قسمت اطلاعات بروید و آدرس MAC کارت شبکه هشت رقمی را که پس از کلمه "ether" نیز وجود دارد ، جستجو کنید:

آدرس MAC هشت رقمی کارت شبکه خود را کپی کرده و در Notepad ذخیره کنید ، زیرا بعداً این آدرس مورد نیاز است.

همانطور که قبلاً گزارش دادم ، Homebridge یک سرور NodeJS است و افزونه های آن مستقیماً از سایت NPM نصب می شوند. Raspbian معمولاً بسته های NodeJS و NPM را نصب می کند ، اما ممکن است بین نسخه های هر دو بسته ناسازگاری وجود داشته باشد ، بنابراین بهتر است هر دو نصب را حذف کرده و سپس دوباره نصب کنید.

برای حذف NPM ، دستور زیر را در ترمینال تایپ کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید تا حذف بسته کامل شود:

sudo apt-خودکار حذف npm پاکسازی

برای حذف NodeJS ، دستور زیر را در ترمینال تایپ کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید تا حذف بسته کامل شود:

sudo apt-حذف خودکار nodejs

پس از حذف NodeJS و NPM ، می توانیم بسته های به روز شده را نصب کنیم. برای نصب NodeJS ، دستور زیر را در ترمینال تایپ کنید ، وارد کنید ، در صورت درخواست فرمان را تأیید کنید و منتظر بمانید تا نصب بسته کامل شود:

sudo apt install nodejs

برای نصب NPM ، دستور زیر را در ترمینال تایپ کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید تا نصب بسته کامل شود:

curl -L https://www.npmjs.com/install.sh | sudo sh

هر یک از دستورات زیر را تایپ کرده و بعد از هر کدام Enter را فشار دهید تا تأیید شود که نصب بسته موفقیت آمیز است. این دستورات نسخه هر بسته ای را که به تازگی نصب شده است ، برمی گرداند:

گره -v

npm -v

Avahi و وابستگی های آن را نصب کنید. دستور زیر را وارد کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید تا نصب کامل شود:

sudo apt-get install libavahi-compat-libdnssd-dev

پس از اتمام این مراحل می توانیم Homebridge را نصب کنیم. دستور زیر را وارد کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید تا نصب کامل شود:

sudo npm install -g --unsafe -perm homebridge

سپس دستور زیر را تایپ کرده و enter را فشار دهید تا Homebridge بوت شود:

پل خانگی

Homebridge برخی از اطلاعات را برمی گرداند:

1) فایل config.json توسط Homebridge پیدا نشد. این فایل تنظیمات اولیه برای اجرای Homebridge و هر افزونه نصب شده را ارائه می دهد. بعداً فایل config.json و تنظیمات آن را ایجاد می کنیم.

2) افزونه ای نصب نشده است. Homebridge بدون افزونه نصب شده کاملاً بی فایده است.

3) برای پیوند دستگاه ها به برنامه Home می توانید کد QR را بخوانید که اطلاعات مورد نیاز برای جفت شدن را در اختیار شما قرار می دهد. از آنجا که فایل config.json ایجاد و پیکربندی نشده است و افزونه ای نصب نشده است ، این کد QR در حال حاضر خوب نیست ، اگرچه در برنامه Home شما قبلاً قادر خواهید بود Homebridge را برای پیوند یافتن پیدا کنید ، اما این کار را نکنید.

4) راه دیگری برای پیوند دستگاه ها به برنامه Home ، گزینه "افزودن لوازم جانبی" ، "من کد ندارم یا نمی توانم اسکن کنم" است ، و در قسمت "لوازم جانبی نزدیک" دستگاه انتخاب شده و سپس از شما خواسته می شود کد راه اندازی توجه داشته باشید که پایانه کد هشت رقمی را نشان می دهد و باید برای مطابقت با برنامه وارد شود.

بعداً می توانید از کد QR یا کد هشت رقمی برای پیوند Homebridge به برنامه Home در دستگاه Apple خود استفاده کنید.

کلیدهای CTRL + C را در ترمینال فشار دهید تا Homebridge خاموش شود و پیغام "Got SIGINT، تعطیل Homebridge …" بازگردانده می شود.

برای ایجاد فایل config.json دستور زیر را در ترمینال تایپ کرده و enter را فشار دهید. فایل خالی باز می شود:

sudo nano ~/.homebridge/config.json

فایل زیر را بارگیری کنید. این فایل را باز کنید ، محتویات را کپی کرده و در فایلی که در ترمینال باز است بچسبانید:

فایل 01

1) در "نام کاربری" دنباله XX: XX: XX: XX: XX: XX را حذف کرده و آدرس MAC هشت رقمی کارت شبکه ای را که قبلاً ذکر کرده بودید وارد کنید. حروف آدرسی که وارد می کنید باید همه بزرگ باشد.

2) در "پین" می توانید هشت رقم عددی را نگه دارید یا می توانید به دنباله ای که می خواهید تغییر دهید ، به یاد داشته باشید که همان فرمت جداسازی را با خط تیره حفظ کنید. این کدی است که باید هنگام اتصال Homebridge به برنامه Home وارد کنید.

سایر اطلاعات فایل را می توانید نگه دارید ، همانطور که افزونه ها و لوازم جانبی را اضافه می کنید ، می توانید اطلاعات مورد نیاز را وارد کنید.

برای ذخیره ویرایش های فایل CTRL + O را فشار دهید ، Enter را فشار دهید و سپس CTRL + X را فشار دهید تا فایل بسته شود.

مرحله 4: راه اندازی Homebridge با Raspbian Boot

راه اندازی Homebridge به صورت دستی هر بار که Raspberry Pi خود را روشن می کنید چندان عملی نیست ، بنابراین بهتر است بلافاصله پس از شروع Raspbian سرور اجرا شود.

دستور زیر را در ترمینال تایپ کرده و enter را بزنید. فایل خالی باز می شود:

sudo nano/etc/default/homebridge

فایل زیر را بارگیری کنید. این فایل را باز کنید ، محتویات را کپی کرده و در فایلی که در ترمینال باز است بچسبانید:

فایل 02

برای ذخیره ویرایش های فایل CTRL + O را فشار دهید ، Enter را فشار دهید و سپس CTRL + X را فشار دهید تا فایل بسته شود.

دستور زیر را در ترمینال تایپ کرده و enter را بزنید. فایل خالی باز می شود:

sudo nano /etc/systemd/system/homebridge.service

فایل زیر را بارگیری کنید. این فایل را باز کنید ، محتویات را کپی کرده و در فایلی که در ترمینال باز است بچسبانید:

فایل 03

برای ذخیره ویرایش های فایل CTRL + O را فشار دهید ، Enter را فشار دهید و سپس CTRL + X را فشار دهید تا فایل بسته شود.

برای ایجاد کاربری که سرویس را هنگام راه اندازی به طور خودکار اجرا می کند و مجوزهای مناسب را به آنها می دهد ، هر یک از دستورات زیر را تایپ کرده و بعد از هر کدام enter را فشار دهید:

sudo useradd --system homebridge

sudo mkdir /var /homebridge

sudo cp ~/.homebridge/config.json/var/homebridge/

sudo cp -r ~/.homebridge/persist/var/homebridge

sudo chmod -R 0777 /var /homebridge

sudo systemctl daemon-reload

sudo systemctl homebridge را فعال کنید

sudo systemctl start homebridge

برای راه اندازی مجدد سیستم دستور زیر را تایپ کرده و enter را فشار دهید:

راه اندازی مجدد sudo

پس از راه اندازی مجدد سیستم ، ترمینال را دوباره باز کنید ، دستور زیر را تایپ کنید و Enter را فشار دهید تا بررسی کنید که آیا سرویس در حال حاضر در حال اجرا است:

وضعیت systemctl پل خانگی

اگر همه چیز خوب است ، سرویس اجرا می شود و می توانید "فعال (در حال اجرا)" و زیر کد هشت رقمی که قبلاً در config.json وارد شده بود را مشاهده کنید.

کلیدهای CTRL + C را در ترمینال فشار دهید. دستور زیر را تایپ کرده و enter را فشار دهید تا گزارش اطلاعات وارد شده را بررسی کنید:

journalctl -f -u پل خانگی

کلیدهای CTRL + C را در ترمینال فشار دهید.

مرحله 5: نصب افزونه Homebridge Config UI X (Raspberry Pi)

برای نشان دادن نصب افزونه در Homebridge ، من از Homebridge Config UI X استفاده کردم. این افزونه از طریق مرورگر امکان پیکربندی ، نظارت ، پشتیبان گیری و راه اندازی مجدد Homebridge را می دهد.

برای نصب افزونه ، دستور زیر را در ترمینال وارد کنید ، وارد کنید ، در صورت درخواست دستور را تأیید کنید و منتظر بمانید تا نصب کامل شود:

sudo npm install -g --unsafe-perm homebridge-config-ui-x

دستور زیر را در ترمینال تایپ کرده و enter را بزنید. یک فایل باز می شود:

sudo nano /etc /sudoers

با استفاده از پیکان رو به پایین یا چرخاندن موس ، به انتهای فایل بروید و خط زیر را اضافه کنید:

homebridge ALL = (ALL) NOPASSWD: ALL

برای ذخیره فایل CTRL + O و سپس CTRL + X را فشار دهید تا فایل بسته شود.

دستور زیر را در ترمینال تایپ کرده و enter را بزنید. یک فایل باز می شود:

sudo nano/etc/default/homebridge

با استفاده از کلیدهای جهت دار ، به انتهای خط بروید HOMEBRIDGE_OPTS = -U /var /homebridge ، یک فاصله بدهید و درج کنید:

-من

برای ذخیره فایل CTRL + O و سپس CTRL + X را فشار دهید تا فایل بسته شود.

اکنون باید config.json را ویرایش کرده و اطلاعات افزونه اضافه شده به Homebridge را اضافه کنید.

اگر مرحله 4 را برای راه اندازی Homebridge بلافاصله پس از شروع Raspbian انجام داده اید ، دستور زیر را تایپ کرده و enter را بزنید:

sudo nano /var/homebridge/config.json

اگر Homebridge را با Raspbian شروع نکرده اید ، دستور زیر را تایپ کرده و enter را بزنید:

sudo nano ~/.homebridge/config.json

config.json باز می شود:

در ساختار "پلت فرم" ، همه افزونه هایی که در Homebridge نصب می شوند باید مطلع شوند.

برای Homebridge Config UI X ، باید قطعه کد زیر را در فایل زیر اضافه کنید. آن را بارگیری کنید ، باز کنید ، محتوا را کپی کرده و در فایلی که در ترمینال باز است بچسبانید:

file04

با استفاده از کلیدهای جهت دار ، به "platforms" بروید و قطعه کد را که از فایل کپی کرده اید وارد کنید. در تصویر زیر می توانید ساختار "پلتفرم ها" را پس از افزودن اطلاعات مشاهده کنید:

اگر می خواهید ساختار کد خود را پس از ویرایش اعتبار دهید ، کافی است به سایت JSONLint بروید ، تمام کد config.json را بچسبانید ، روی "Validate JSON" کلیک کنید و اگر همه چیز خوب بود پیام "Valid JSON" عودت داده می شود. اگر کد شما خطایی دارد به خط خطا نشان داده می شود و پیامی در مورد خطا نشان می دهد:

jsonlint.com/

برای ذخیره فایل CTRL + O و سپس CTRL + X را فشار دهید تا فایل بسته شود.

سیستم را با تایپ دستور زیر راه اندازی مجدد کنید ، enter را بزنید و منتظر راه اندازی مجدد باشید:

راه اندازی مجدد sudo

برای باز کردن Homebridge Config UI X از طریق مرورگر مستقیم در رزبری پای باید به آدرس زیر دسترسی داشته باشید:

localhost: 8080/

اگر می خواهید Homebridge Config UI X را در مرورگری از رایانه دیگری که در همان شبکه با برد متصل است باز کنید ، کافی است کلمه localhost را از آدرس بالا با IP رزبری پای خود جایگزین کنید. برای تأیید IP اختصاص داده شده به رزبری پای خود ، کافی است به ترمینال دسترسی پیدا کرده ، دستور زیر را وارد کرده و وارد کنید:

ifconfig

احتمالاً IP اختصاص داده شده به رزبری پای شما با "192.168 …" شروع می شود.

در مورد من ، برد IP 192.168.2.129 است ، بنابراین فقط به URL زیر هر رایانه ای در شبکه من دسترسی داشته باشید:

192.168.2.129:8080/

صفحه ای مشابه تصویر زیر باز می شود و از شما درخواست ورود و رمز عبور می شود. برای ورود و رمز عبور ، admin را تایپ کرده و برای دسترسی وارد کنید:

لطفاً توجه داشته باشید که در صفحه اصلی کد QR و در زیر آن پین 8 رقمی نشان داده شده است که می تواند برای پیوند Homebridge به برنامه Home استفاده شود. در گزینه "پیکربندی" ابزار ، می توانید به config.json دسترسی پیدا کنید ، در صورت نیاز ویرایش کنید و سپس ذخیره کنید.

ویژگی های موجود در Homebridge Config UI X را مرور کرده و با ابزار آشنا شوید.

برای توقف اجرای Homebridge می توانید از دستور زیر در ترمینال استفاده کنید:

سرویس sudo توقف پل خانگی

برای راه اندازی مجدد Homebridge می توانید از دستور زیر استفاده کنید:

سرویس sudo راه اندازی مجدد homebridge

برای شروع اجرای Homebridge می توانید از دستور زیر استفاده کنید:

سرویس sudo start homebridge

با سرور در حال اجرا به مرحله 9 بروید تا پیوند Homebridge را با برنامه Home در دستگاه Apple خود ادامه دهید.

مرحله 6: نصب Homebridge بر روی ویندوز

اگر رزبری پای یا پلتفرم تعبیه شده دیگری ندارید که بتواند Homebridge را اجرا کند ، می توانید سرور خود را بر روی ویندوز اجرا کنید.

شما باید NodeJS و ویرایشگر متن جایگزین Windows Notepad را نصب کنید.

NodeJS را از یکی از پیوندهای زیر بارگیری کرده و سپس نصب کنید:

nodejs.org/fa/download/

در حین نصب کادر تأیید را علامت بزنید که به شما امکان می دهد ابزارهای لازم را به طور خودکار نصب کنید:

NodeJS یک برنامه رابط گرافیکی نیست ، بنابراین همه اقدامات بر روی آن از طریق خط فرمان انجام می شود.

Notepad ++ را از یکی از پیوندهای زیر بارگیری کرده و سپس نصب کنید:

notepad-plus-plus.org/downloads/

در منوی گزینه های ویندوز ، با کلیک راست روی هر فایلی ، گزینه "Edit with Notepad ++" ظاهر می شود و هر زمان که نیاز به ویرایش برخی از فایل های متنی یا فایل Homebridge دارید ، می توانید این گزینه را انتخاب کنید.

به منوی Windows "Start" بروید ، "Settings" را تایپ کرده و جستجو کنید و در صورت یافتن به گزینه دسترسی پیدا کنید. روی "Network & Internet" و سپس روی "Network and Sharing Center" کلیک کنید. در قسمت "Access Type" روی اتصال فعال خود کلیک کنید ، روی "Details" کلیک کنید و آدرس MAC هشت رقمی کارت شبکه خود را کپی کرده و آن را در دفترچه یادداشت ذخیره کنید ، زیرا بعداً این آدرس مورد نیاز است:

در منوی Windows "Start" ، عبارت "cmd" (Command Prompt) را تایپ کرده و جستجو کنید و وقتی آن را پیدا کردید ، روی آن راست کلیک کرده و "Run as administrator" را انتخاب کنید:

با باز شدن ترمینال ، هر یک از دستورات زیر را تایپ کرده و بعد از هر کدام Enter را فشار دهید تا تأیید شود که نصب NodeJS / NPM با موفقیت انجام شده است. این دستورات نسخه هر یک از بسته های نصب شده را برمی گرداند:

گره -v

npm -v

پس از اتمام این مراحل می توانیم Homebridge را نصب کنیم. دستور زیر را وارد کنید ، وارد کنید و منتظر بمانید تا نصب کامل شود:

npm install -g --unsafe -perm homebridge

سپس دستور زیر را تایپ کرده و enter را فشار دهید تا Homebridge بوت شود:

پل خانگی

Homebridge برخی از اطلاعات را برمی گرداند:

1) فایل config.json توسط Homebridge پیدا نشد. این فایل تنظیمات اولیه برای اجرای Homebridge و هر افزونه نصب شده را ارائه می دهد. بعداً فایل config.json و تنظیمات آن را ایجاد می کنیم.

2) افزونه ای نصب نشده است. Homebridge بدون افزونه نصب شده کاملاً بی فایده است.

3) برای پیوند دستگاه ها به برنامه Home می توانید کد QR را بخوانید که اطلاعات مورد نیاز برای جفت شدن را در اختیار شما قرار می دهد. از آنجا که فایل config.json ایجاد و پیکربندی نشده است و افزونه ای نصب نشده است ، این کد QR در حال حاضر خوب نیست ، اگرچه در برنامه Home شما قبلاً قادر خواهید بود Homebridge را برای پیوند یافتن پیدا کنید ، اما این کار را نکنید.

4) راه دیگری برای پیوند دستگاه ها به برنامه Home ، گزینه "افزودن لوازم جانبی" ، "من کد ندارم یا نمی توانم اسکن کنم" است ، و در قسمت "لوازم جانبی نزدیک" دستگاه انتخاب شده و سپس از شما خواسته می شود کد راه اندازی توجه داشته باشید که پایانه کد هشت رقمی را نشان می دهد و باید برای مطابقت با برنامه وارد شود.

کلیدهای CTRL + C را در ترمینال فشار دهید تا Homebridge بسته شود. پیغام "دریافت SIGINT ، بستن Homebridge …" عودت داده می شود و از شما درخواست تأیید می شود ، در آنجا باید حرف Y را تایپ کرده و enter را فشار دهید.

برای ایجاد فایل config.json Notepad ++ را باز کنید ، روی منوی "File" ، "New" کلیک کنید و پنجره جدیدی باز می شود. روی منوی "Language" کلیک کنید ، به حرف J در لیست بروید و "JSON" را انتخاب کنید.

فایل زیر را بارگیری کنید. این فایل را باز کنید ، محتوا را کپی کرده و در فایلی که در Notepad ++ باز است بچسبانید:

file05

1) در "نام کاربری" دنباله XX: XX: XX: XX: XX: XX را حذف کرده و آدرس MAC هشت رقمی کارت شبکه ای را که قبلاً ذکر کرده بودید وارد کنید. حروف آدرسی که وارد می کنید باید همه بزرگ باشد.

2) در "پین" می توانید هشت رقم عددی را نگه دارید یا می توانید به دنباله ای که می خواهید تغییر دهید ، به یاد داشته باشید که همان فرمت جداسازی را با خط تیره حفظ کنید. این کدی است که باید هنگام اتصال Homebridge به برنامه Home وارد کنید.

سایر اطلاعات فایل را می توانید نگه دارید ، همانطور که افزونه ها و لوازم جانبی را اضافه می کنید ، می توانید اطلاعات مورد نیاز را وارد کنید.

روی منوی "File" ، "Save" کلیک کنید ، نام فایل را config.json بگذارید و آن را در مسیر "C: / Users / YOUR OR Name یا Document \.homebridge" ذخیره کنید:

بستن دفترچه یادداشت ++.

مرحله 7: نصب افزونه Homebridge Config UI X (Windows)

برای نشان دادن نصب افزونه در Homebridge ، من از Homebridge Config UI X استفاده کردم. این افزونه از طریق مرورگر امکان پیکربندی ، نظارت ، پشتیبان گیری و راه اندازی مجدد Homebridge را می دهد.

برای نصب افزونه دستور زیر را در ترمینال تایپ کنید ، enter را بزنید و منتظر بمانید تا نصب به پایان برسد:

npm install -g --unsafe-perm homebridge-config-ui-x

توجه: اگر هنگام نصب افزونه خطایی حاوی اصطلاحات MSBUILD / VCBuild.exe مشاهده کردید ، کافی است هر یک از دستورات زیر را به طور مستقل اجرا کرده و سپس مجدداً از دستور بالا نصب کنید:

npm install -g node -gyp

npm install --global --production windows-build-tools

npm install --global --production windows-build-tools --vs2015

اکنون باید config.json را ویرایش کرده و اطلاعات افزونه اضافه شده به Homebridge را وارد کنید. به مسیر “C: / Users / YOUR OR DOCUMENTS \.homebridge” بروید و از طریق Notepad ++ config.json را باز کنید که قبلاً ایجاد شده بود:

در ساختار "پلت فرم" ، همه افزونه هایی که در Homebridge نصب می شوند باید مطلع شوند.

برای Homebridge Config UI X ، باید قطعه کد زیر را در فایل زیر اضافه کنید. بارگیری ، باز کردن ، کپی محتوا و چسباندن آن در فایلی که در Notepad ++ باز است:

فایل 06

به "platforms" بروید و قطعه کد را که از فایل کپی کرده اید وارد کنید. در تصویر زیر می توانید ساختار "پلتفرم ها" را پس از افزودن اطلاعات مشاهده کنید:

اگر می خواهید ساختار کد خود را پس از ویرایش اعتبار دهید ، کافی است به سایت JSONLint بروید ، تمام کد config.json را بچسبانید ، روی "Validate JSON" کلیک کنید و اگر همه چیز خوب بود پیام "Valid JSON" عودت داده می شود. اگر کد شما خطایی دارد به خط خطا نشان داده می شود و پیامی در مورد خطا نشان می دهد:

jsonlint.com/

فایل را ذخیره کنید ، Notepad ++ را ببندید ، ویندوز را راه اندازی مجدد کنید.

برای باز کردن Homebridge Config UI X از طریق مرورگر به آدرس زیر بروید:

localhost: 8080/

صفحه ای مشابه تصویر زیر باز می شود و از شما درخواست ورود و رمز عبور می شود. برای ورود و رمز عبور ، admin را تایپ کرده و برای دسترسی وارد کنید:

لطفاً توجه داشته باشید که در صفحه اصلی کد QR و در زیر آن پین 8 رقمی نشان داده شده است که می تواند برای پیوند Homebridge به برنامه Home استفاده شود. در گزینه "پیکربندی" ابزار ، می توانید به config.json دسترسی پیدا کنید ، در صورت نیاز ویرایش کنید و سپس ذخیره کنید.

ویژگی های موجود در Homebridge Config UI X را مرور کرده و با ابزار آشنا شوید.

مرحله 8: راه اندازی Homebridge با ویندوز

Homebridge Config UI X فرمانی را ارائه می دهد که می توان از آن برای پیکربندی Homebridge به عنوان یک سرویس استفاده کرد تا سرور همراه با ویندوز بوت شود. در قسمت اعلان دستور زیر را وارد کنید ، وارد شوید و منتظر بمانید تا نصب کامل شود:

نصب سرویس hb

توجه: اگر فایروال ویندوز شما مجوز دسترسی به شبکه خصوصی را درخواست می کند ، به آن اعطا کنید

پس از اتمام نصب ، خط فرمان را ببندید و ویندوز را راه اندازی مجدد کنید.

پس از بوت شدن سیستم ، CTRL + ALT + DEL را فشار دهید تا Windows Task Manager باز شود. به برگه "خدمات" بروید ، Homebridge را در لیست جستجو کنید و ببینید آیا "Status" در حال اجرا است:

با کلیک راست بر روی سرویس Homebridge گزینه هایی باز می شود که می توانید سرویس را متوقف کرده ، راه اندازی مجدد کنید و در صورت قطع سرویس می توانید شروع کنید:

اگر می خواهید Homebridge را از راه اندازی ویندوز حذف کنید ، کافی است دستور زیر را وارد کرده ، وارد کنید و منتظر بمانید تا حذف نصب کامل شود:

hb-service را حذف کنید

توجه: بسته به اینکه از کدام آنتی ویروس استفاده می کنید ، ممکن است در پیدا کردن Homebridge از دستگاه تلفن همراه خود مشکل داشته باشید. برای آزمایش ، زمانی که زمان اتصال Homebridge به برنامه Home فرا رسیده است ، اگر سرور در عرض دو دقیقه پیدا نشد ، آنتی ویروس خود را غیرفعال کنید ، Windows Defender را غیرفعال کنید ، سرویس Homebridge را از طریق Windows Task Manager راه اندازی مجدد کنید و دوباره سعی کنید سرور را پیدا کنید. از برنامه Home

مرحله 9: اتصال Homebridge به برنامه Home

دستورالعمل های زیر برای هر دو Homebridge که بر روی Raspberry Pi و Windows اجرا می شوند معتبر است. اطمینان حاصل کنید که سرور در حال اجرا است زیرا برنامه Home فقط در صورت آنلاین بودن Homebridge را پیدا می کند.

من برای این پست از iPhone 8 Plus استفاده کردم ، بنابراین از اینجا مراحل بر اساس iOS خواهد بود. برای سایر دستگاه های سازگار با Apple Homekit ، پیشنهاد می کنم منوها را برای گزینه های زیر بررسی کنید.

به صفحه اصلی iPhone خود بروید و از برنامه ها به دنبال برنامه Home باشید. اگر نمی توانید آن را پیدا کنید ، به App Store بروید و برنامه را نصب کنید:

با باز کردن برنامه Home روی "افزودن لوازم جانبی" کلیک کنید:

در صفحه باز شده روی "من کد ندارم یا نمی توانم اسکن کنم؟" کلیک کنید:

در "لوازم جانبی نزدیک" ، پل خانگی را مشاهده خواهید کرد. روی آن کلیک کنید تا صفحه جفت شدن باز شود:

پیامی باز می شود و باید روی "Add Anyway" کلیک کنید:

"کد راه اندازی Homebridge" از شما خواسته می شود. کد (PIN) را که در config.json تنظیم کرده اید پر کنید و منتظر بمانید:

اگر همه چیز خوب پیش رفت ، صفحه ای را مشاهده خواهید کرد که نشان می دهد Homebridge اضافه شده است و آماده استفاده است:

توجه: اگر پیامی مبنی بر پذیرفته نشدن یا عدم امکان افزودن کد دریافت کردید ، برنامه Home را ببندید ، Homebridge را راه اندازی مجدد کنید و مراحل را دوباره امتحان کنید

در صفحه بعدی پیغام "Additional Setup Required" را می بینید زیرا هنوز دستگاه Homebridge وجود ندارد. روی DONE کلیک کنید و برنامه به صفحه اصلی باز می گردد:

در صفحه اصلی روی نماد خانه کلیک کنید ، در صفحه بعدی روی "Hubs & Bridges" ، روی Homebridge تازه اضافه شده کلیک کنید و برخی اطلاعات را مشاهده خواهید کرد ، و اگر بعداً نیاز به حذف پیوند Homebridge دارید ، فقط روی "کلیک کنید" حذف پل از خانه ":

اگر Homebridge را از برنامه Home حذف کرده اید و می خواهید دوباره آن را اضافه کنید ، باید پوشه های "لوازم جانبی" و "persistent" را از سرور حذف کنید.

در رزبری پای:

با تایپ کردن دستور زیر در ترمینال و فشار دادن enter ، Homebridge را خاتمه دهید:

سرویس sudo توقف پل خانگی

اگر مرحله 4 را برای راه اندازی Homebridge بلافاصله پس از شروع Raspbian انجام داده اید ، دستور زیر را تایپ کرده و enter را بزنید:

cd /var /homebridge

اگر Homebridge را با Raspbian شروع نکرده اید ، دستور زیر را تایپ کرده و enter را بزنید:

cd.homebridge/

هر یک از دستورات زیر را تایپ کرده و بعد از هر کدام Enter را فشار دهید تا پوشه های "accessories" و "persist" حذف شوند:

sudo rm -r persist/

sudo rm -r لوازم جانبی/

Digite o comando abaixo no terminal e dê enter para iniciar o Homebridge:

سرویس sudo start homebridge

دوباره مراحل را برای پیوند Homebridge به برنامه Home انجام دهید.

روی ویندوز:

سرویس Homebridge را از طریق Task Manager ویندوز متوقف کنید ، به مسیر “C: / Users / YOUR OR یا DOCUMENTS \.homebridge” بروید ، و پوشه های “لوازم جانبی” و “persistent” را حذف کنید. سرویس Homebridge را از طریق Windows Task Manager شروع کنید.

دوباره مراحل را برای پیوند Homebridge به برنامه Home انجام دهید.

توجه به این نکته ضروری است که هر دستگاهی که در برنامه Home تعبیه شده است به صورت محلی کار می کند. برای اینکه بتوانید دستگاه های برنامه Home را از طریق یک شبکه خارجی (برای مثال اتصال 3G / 4G) کنترل کنید ، باید یک هاب اتوماسیون را از یکی از دستگاه های زیر Apple تنظیم کنید: iPad (با iOS 10 یا بالاتر) ، Apple TV (نسل 4) یا HomePod. به این ترتیب ، حتی در خارج از خانه می توانید از راه دور اتوماسیون و دستگاه های اینترنت اشیا خود را که از طریق Homebridge یا Homekit با برنامه Home ادغام شده اند کنترل کنید.

با پیوند دادن Homebridge به برنامه Home Completed می توانید عملکردهای این ابزار عالی را کشف کنید. در پیوند زیر می توانید لیستی از افزونه های موجود برای استفاده با Homebridge را مشاهده کنید و با کلیک بر روی هر کدام می توانید اطلاعات آنها و نحوه نصب را مشاهده کنید:

www.npmjs.com/search؟q=homebridge-plugin

اگر IoT یا دستگاه اتوماسیون خانگی دارید و می خواهید آن را با Homebridge ادغام کنید ، کافی است افزونه ای ایجاد کنید که به شما امکان می دهد از این دستگاه در برنامه Home استفاده کنید.

از آنجا که کاربر اصلی در Raspbian فعال نیست ، برای نصب افزونه همیشه به یاد داشته باشید که از کلمه sudo قبل از دستور نصب ترمینال استفاده کنید. اگر از sudo استفاده نمی کنید ، سیستم همیشه از شما می خواهد رمز عبور سیستم را برای انجام عمل وارد کنید یا ممکن است پیامی مبنی بر عدم مجوز خود بازگردانید.

در ویندوز ، خط فرمان باید به عنوان administrator اجرا شود تا بتواند خطوط فرمان را اجرا کند و نباید از کلمه sudo استفاده کنید زیرا توسط سیستم تشخیص داده نمی شود.

هر زمان که افزونه ای را نصب می کنید ، مطمئن شوید که اطلاعات آن را در config.json اضافه کرده و Homebridge را راه اندازی مجدد کنید تا برنامه Home با اطلاعات افزونه های اضافه شده به روز شود. به همین ترتیب ، هر زمان که افزونه Homebridge را حذف نصب می کنید ، حتماً اطلاعات config.json افزونه را حذف کنید ، زیرا اگر سرور را حذف نکنید ، ممکن است با مشکلات راه اندازی مواجه شوید.

در زیر پیوندهایی وجود دارد که ممکن است برای یافتن اطلاعات بیشتر در مورد Homebridge و Homekit مفید باشد:

homebridge.io/

github.com/nfarina/homebridge

support.apple.com/pt-br/HT204893

اگر دستگاه های Sonoff دارید و مایل هستید از آنها با برنامه Home و Siri استفاده کنید ، توصیه می کنم دستورالعمل آموزشی Integrate Sonoff With Home (Apple iPhone iPhone IOS) را بخوانید.