همین حالا Zigbee2MQTT یا ZHA روی دانگل خودت می‌چرخد؟ در چهار گام به FairGrow وصلش کن. سخت‌افزار مال خودت میماند، لازم نیست چیزی در دیوار آتش باز شود، و اندازه‌هایت روی سکویی می‌نشیند که دادههای ماهواره‌ای، هواشناسی و زراعی که یک نهالستان با آنها زندگی میکند از پیش روی آن هست.
Home Assistant داری؟ وصلش کن، چیز دیگری لازم نیست نصب کنی
نه دستگاه دوم لازم است و نه پل. دستگاه‌هایت در Home Assistant میمانند، با ZHA، Zigbee2MQTT یا هر یکپارچه‌سازی دیگری. خودت تیک می‌زنی FairGrow کدام حسگرها را ببیند و فقط همان‌ها از خانهات بیرون می‌روند.
FairGrow را به Home Assistant اضافه کن
یکپارچه‌سازی را دانلود کن و پوشه fairgrow را در config/custom_components در Home Assistant خودت از حالت فشرده خارج کن (با افزونه File editor یا Samba). بعد Home Assistant را دوباره راه‌اندازی کن. به محض اینکه FairGrow در فهرست HACS قرار بگیرد، این مرحله یک کلیک میشود.
دانلود یکپارچهسازیکد را در Home Assistant بچسبان
Settings، Devices & services، Add integration، FairGrow. کد را بچسبان و وصل شده‌ای.
افزودن FairGrow در Home Assistant منانتخاب کن چه چیزی را به اشتراک بگذاری
حسگرهایی را که FairGrow می‌تواند ببیند تیک بزن: دما، رطوبت هوا، رطوبت خاک، نور، توان و موارد دیگر. بعدا با Configure تغییرش بده. داده‌ها هر دقیقه می‌رسند؛ اگر اینترنت قطع شود، Home Assistant آنها را نگه می‌دارد و بعدا می‌فرستد.
هر وقت خواستی اشتراک‌گذاری را متوقف کن: یکپارچه‌سازی را در Home Assistant حذف کن، یا آن را زیر هماهنگ‌کننده‌های شما جدا کن. سابقه‌ات در FairGrow باقی میماند.
برای کاربران حرفه‌ای: پل جداگانه
از Zigbee2MQTT یا ZHA استفاده می‌کنی و می‌خواهی FairGrow خودش شبکه Zigbee را مدیریت کند (پنجره جفت‌سازی، قرنطینه، اسکن شبکه)؟ پس پل زیر برای توست. روی دستگاه خودت کنار هماهنگکننده اجرا میشود.
چهار گام، یک بار
پس از آن هماهنگ‌کننده‌ی شما هم مثل هر دستگاه دیگری به‌صورت یک کارت در FairGrow نمایش داده میشود.
پل را دانلود کنید
نصب‌کننده‌ای برای Windows، macOS یا Raspberry Pi شما. کمی پایین‌تر در همین صفحه و بقیه‌ی کارها را خودش انجام میدهد.کد جفت‌شدن بگیرید
یک کد هشت‌کاراکتری از صفحه‌ی نمایش دستگاهها، یک‌بارمصرف و به مدت یک ربع معتبر. پایین‌تر میبینید چطور.کد را یک بار وارد کنید
پل آن را با کلیدی عوض میکند که روی رایانه خودتان میماند. کد بلافاصله پس از آن منقضی میشود.
نخستین دستگاهتان را جفت کنید
شبکه را در هماهنگکننده خود باز کنید. آنجا باز کردن پنجره‌ی جفت‌شدن برای دستگاه جدید و پذیرش دستگاهها برای دستگاههایی که از قبل در شبکه بوده‌اند.
نصب یک دقیقه طول می‌کشد
سیستم‌عامل خود را انتخاب کنید و نصب‌کننده را اجرا کنید. همه‌چیز را آماده میکند، کد جفت‌شدن را از شما می‌پرسد و کاری میکند که پل از این به بعد خودکار اجرا شود.
پل FairGrow
با Zigbee2MQTT شما یا مستقیم با ZHA در Home Assistant کار میکند. فقط با هماهنگ‌کننده‌ی شما و FairGrow ارتباط دارد و با هیچ چیز دیگری.
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shcurl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shتوجه: پل روی خودِ Home Assistant نصب نمیشود. نه یکپارچه‌سازی است و نه افزونه، و روی Home Assistant OS نمی‌توانید Python نصب کنید. آن را روی دستگاه دیگری در همان شبکه نصب کنید که همیشه روشن است: رایانه‌تان، یک Raspberry Pi، یک NAS یا یک ماشین مجازی. پل از آنجا از طریق شبکه به ZHA در Home Assistant وصل میشود.
نصب‌کننده دقیقاً چه میکند
- بررسی میکند که Python 3 روی رایانه‌تان نصب باشد؛ اگر نباشد، می‌گوید از کجا دریافتش کنید.
- یک پوشه‌ی جداگانه با محیط Python مخصوص خودش می‌سازد، جدا از سیستم شما.
- پل را دانلود میکند و اثر انگشت آن را با مقداری که پلتفرم اعلام میکند مقایسه میکند. اگر یکی نباشند، هیچ چیز اجرا نمیشود.
- کد جفت‌سازی شما را می‌پرسد و اینکه Zigbee2MQTT یا Home Assistant روی کدام دستگاه اجرا میشود.
- یک بار جفت‌سازی را انجام میدهد و کاری میکند که پل با روشن شدن رایانه خودکار اجرا شود.
همه‌چیز در همان پوشه‌ی جداگانه میماند و به Python سیستم شما دست زده نمیشود. با fairgrow-brug.bat /verwijderen یا sh fairgrow-brug.sh --verwijderen آن را حذف میکنید؛ خود جفت‌سازی را از روی کارت هماهنگکنندهتان لغو میکنید. نصب دستی را ترجیح می‌دهید؟ فایل پل به‌تنهایی هم در دسترس است: fgzb_brug.py.
برای به‌روزرسانی به نسخه‌ای تازه‌تر از fairgrow-brug.bat /bijwerken یا sh fairgrow-brug.sh --bijwerken استفاده کنید. جفت‌سازی و تنظیمات شما سر جای خود میماند، پس به کد تازه نیازی ندارید.
این‌طور کد جفت‌شدن را می‌گیرید
سه کلیک در FairGrow. کد یک‌بارمصرف است و یک ربع اعتبار دارد.
۱. صفحه‌ی نمایش دستگاهها
۲. هماهنگ‌کننده‌ی خود را انتخاب کنید
۳. کد شما
داده‌هایتان از چه مسیری می‌گذرند
همهی اتصال‌ها از سمت شما به بیرون برقرار میشوند. هیچ اتصالی از بیرون وارد نمیشود.
هر پیکان به بیرون اشاره دارد. هماهنگکننده و دستگاههایتان در شبکه خودتان میمانند.
سه چیز
یک هماهنگکننده پشتیبانی‌شده
هر دانگلی که Zigbee2MQTT از آن پشتیبانی میکند: SONOFF ZBDongle-E یا P، SLZB-06، ConBee III.
Zigbee2MQTT در حال اجرا
نسخه‌ی 2.x با یک سرور MQTT در شبکه‌ی خودتان. تنظیمات فعلی‌تان بدون تغییر کار میکند.
رایانه‌ای که روشن میماند
پل یک برنامه کوچک Python است. یک Raspberry Pi کنار هماهنگکننده کافی است.
یک دستگاه Zigbee تازه منتظر شماست
هیچ چیز خودبه‌خود روی داشبوردتان ظاهر نمیشود.
در قرنطینه میماند
دستگاه منتظر میماند. هنوز نه اندازه‌گیری‌ای ثبت میشود، نه چیزی روی داشبورد می‌آید.
از دستگاه می‌پرسیم چیست
برند، مدل و قابلیت‌هایش. روی کارت میبینید چه چیزی را خودمان سنجیده‌ایم و چه چیزی را از منابع دیگر پیدا کرده‌ایم.
شما تصمیم می‌گیرید
افزودن یا رد کردن. با رد کردن، دستگاه حذف میشود و دیگر وارد نمیشود.
هماهنگکننده Zigbee شما اینجا چه می‌تواند
هماهنگ‌کننده‌ای از برندی دیگر کم‌ارزش‌تر نیست، فقط جور دیگری ساخته شده است.
کار میکند
- باز کردن پنجره جفت‌شدن از درون FairGrow
- خواندن برند، مدل و توانایی‌های یک دستگاه
- تشخیص اینکه آیا دستگاه می‌تواند ترافیک دستگاه‌های دیگر را عبور دهد
- برداشتن یک دستگاه و بیرون نگه داشتنش
- اجرای پویش شبکه: کدام دستگاه از طریق کدام دستگاه ارتباط دارد و با چه قدرت سیگنالی
- شناسایی آداپتور و میان‌افزار شما و هشدار درباره‌ی ترکیب‌هایی که می‌دانیم مشکل دارند
کار نمی‌کند
- Zigbee2MQTT نمی‌تواند اطلاعاتی را از دستگاه بگیرد که دستگاه آن را نمی‌دهد. در این موارد به کتابخانه‌ی دستگاه‌های خودمان تکیه میکنیم.
- همهی دستگاهها از طریق Zigbee2MQTT قابلیت «چشمک‌زدن برای پیدا شدن» را ندارند.
هر چه را خودمان نتوانستیم بسنجیم، روی کارت صریح گفته میشود. مقداری را که از جای دیگر گرفته‌ایم هرگز به‌جای اندازه‌گیری جا نمی‌زنیم.
وضعیت شبکه‌ی Zigbee خود را ببینید
Zigbee یک شبکه‌ی مِش است: دستگاههایتان از طریق یکدیگر ارتباط برقرار می‌کنند. از هماهنگکنندهتان یک پویش شبکه درخواست میکنید و میبینید هر دستگاه از طریق کدام دستگاه وصل است.
نقشه
همهی دستگاهها، همهی پیوندها و قدرت هر کدام. حلقه‌ی ضعیف را پیش از آنکه حسگری از شبکه بیفتد میبینید.
چه چیزی می‌لنگد
دستگاهی که فقط یک همسایه دارد، پیوندی که بیش از حد ضعیف است، دستگاهی که بیش از حد از هماهنگکننده دور است. همراه با قاعده‌ای که این هشدار بر آن استوار است.
روند
نتیجه‌ی هر پویش را نگه می‌داریم. به این ترتیب میبینید که پیوندی ضعیف‌تر میشود یا دستگاهی مدام همسایه‌اش را عوض میکند، و لازم نیست صبر کنید تا دستگاه خاموش شود.
پویش جدول همسایه‌های هر مسیریاب را درخواست میکند و زمان رادیویی می‌گیرد، پس هرگز خودکار شروع نمیشود. و مسیریابی را که پاسخ نمی‌دهد بی‌سروصدا «جدا‌افتاده» نمی‌نامیم: آنجا می‌نویسیم که نمی‌دانیم.
اگر نشد، می‌بینیم چرا
نصب‌کننده سیستم شما را بررسی میکند و هر اتفاقی را ثبت میکند.
اول بررسی، بعد جفت‌سازی
پورت‌ها، مجوزها، درایورها، وظیفه‌ی اجرای خودکار. تقریباً هر مشکلی بیرون از پل پیش می‌آید.
سهم خودمان را در اختیار داریم
هر تلاش یک شناسه می‌گیرد و هر چه از سمت شما رسیده، زیر همان شناسه نگه داشته میشود؛ حتی اگر جفت‌سازی هرگز موفق نشده باشد.
ارسال گزارش با یک دکمه
زیر فهرست هماهنگ‌کننده‌هایتان گزینه‌ی ارسال گزارش را پیدا میکنید. گذرواژه‌ها همان لحظه‌ی دریافت پنهان میشوند.
کدام سخت‌افزار Zigbee کار میکند. با آداپتورها و برندهای رایج بازار چه مشکلاتی پیش می‌آید و کدام را ما مهار میکنیم. ببینید چه چیزی کار میکند
هماهنگ‌کننده‌ی Zigbee شما وصل شد. مراحل بعدی این‌هاست. افزودن یک دستگاه، تأیید آن و اینکه در کجا نمایش داده میشود. و اینکه پس از آن چه چیزهایی را برایتان زیر نظر داریم. اولین دستگاه خود را اضافه کنید
اتوماسیونهای تو هم میتوانند بیایند
وصل کردن هماهنگکننده اندازه‌ها را جابه‌جا میکند. لازم نیست همانجا تمام شود.
FairGrow می‌تواند از Home Assistant تو بپرسد چه اتوماسیون‌هایی را اجرا میکند و آنها را در ویرایشگر جریان کار کپی کند، با نسخه‌های اصلی دست‌نخورده و هر کپی خاموش تا وقتی تو چیز دیگری بگویی. بحث این نیست که Home Assistant بد کار میکند. بحث این است که اینجا همان اتوماسیون می‌تواند به تصویر Sentinel-2، به عدد تبخیر FAO-56 یا به یک مدل آفت هم نگاه کند، بی‌آنکه اول خودت آن را بسازی.
پرسش‌هایی که از ما میشود
آیا باید از Home Assistant دست بکشم؟
نه، و چنین چیزی هم نمیخواهیم. شبکه Zigbee تو همانجا میماند و خانهات روی آن کار میکند. آنچه میگوییم چیز دیگری است: برای زمین، FairGrow جای بهتری برای اندازههای توست. Copernicus و NASA POWER و FAO-56 و حفاظت گیاهی با کدهای EPPO از همان ابتدا اینجا هستند، در حالی که در Home Assistant هر کدام پروژهای است که خودت نگهش میداری. اتوماسیونهای موجودت میتوانند با یک کلیک بیایند.
کدام هماهنگ‌کننده‌ها را می‌توانم وصل کنم؟
Zigbee2MQTT و Home Assistant ZHA، هر دو از امروز و هر دو را خودتان وصل میکنید: پل را دانلود کنید، هنگام نصب انتخاب کنید کدام را دارید، کد جفت‌شدن بگیرید، تمام. اگر ZHA دارید، اصلاً لازم نیست Zigbee2MQTT نصب کنید و هیچ چیزی در تنظیماتتان تغییر نمی‌کند. آزمایش هر دو روی سخت‌افزار واقعی هنوز در حال انجام است، پس اگر به مشکلی برخوردید به ما خبر دهید. پس از آن نوبت deCONZ / Phoscon است که هنوز قابل انتخاب نیست. هماهنگ‌کننده‌ی شما در فهرست نیست؟ بگویید کدام را دارید.
چه چیزی از شبکه من بیرون میرود؟
دادههای هماهنگکنندهتان و دستگاههایی که در همین نشست جفت میکنید: نشانی، برند، مدل و اندازهگیریهایشان. دستگاههایی که از قبل در Zigbee2MQTT شما هستند و آنها را جفت نمیکنید، به FairGrow فرستاده نمیشوند.
باید درگاهی باز کنم؟
نه. پل فقط اتصال به بیرون برقرار میکند. از سوی ما چیزی وارد شبکهتان نمیشود.
چطور اتصال را قطع کنم؟
اتصال هماهنگکننده را در FairGrow قطع کنید. کلید بلافاصله باطل میشود. دستگاههایتان در فهرست میمانند، فقط دیگر دادهی تازه دریافت نمیکنند.
اگر پل مدتی خاموش بماند چه میشود؟
چیزی خراب نمیشود. اندازهگیریها متوقف میشوند و به محض بازگشت پل ادامه مییابند. روی کارت میبینید که زمانِ سپریشده از آخرین پیام بیشتر میشود.
اگر ارتباط یک دستگاه قطع شود چه میشود؟
پل شما هر پنج دقیقه گزارش میدهد که هماهنگکنندهتان چه میبیند. اگر دستگاهی خاموش شود، کنار هماهنگکنندهتان نمایش داده میشود، همراه با علتش: خودِ دستگاه، یا مسیریابی که از طریق آن وصل بوده است. اگر خود پل گزارش ندهد، اول همین را اعلام میکنیم، چون در آن حالت به نظر میرسد همهی دستگاهها قطع شدهاند، در حالی که فقط پل از کار افتاده است.
هماهنگکننده خودتان را وصل کنید
بگویید چه دانگلی دارید و چه می‌خواهید اندازه بگیرید. جفت‌سازی را همراه شما انجام می‌دهیم.