راه‌اندازی با اتصال محلی توصیه نمی‌شود

این روش باید برای برقراری اتصال مستقیم محلی به ربات جاروبرقی بدون وابستگی به اتصال مداوم ابری استفاده شود. برای استفاده از این روش، دستگاه باید حداقل یک بار به‌طور موفقیت‌آمیز به برنامه رسمی Xiaomi Home (در دسترس برای iOS و Android) اضافه شده باشد تا توکن معتبر ایجاد شود. علاوه بر این، دستگاه باید در طول این مرحله از راه‌اندازی به حساب متصل بماند تا یکپارچه‌سازی بتواند آدرس IP و توکن مورد نیاز را از ابر دریافت کند.

سازگاری دستگاه

این روش اتصال به‌طور انحصاری برای دستگاه‌های تولید شده قبل از سال 2022 که توسط برنامه Xiaomi Home پشتیبانی می‌شوند، حمایت می‌شود. اگر دستگاهی نتواند به برنامه Xiaomi Home اضافه شود، تحت هیچ شرایطی با هیچ توکنی API محلی ارائه نخواهد داد.

بدون پشتیبانی از نقشه توصیه نمی‌شود

به طور فنی امکان بازیابی داده‌های نقشه از طریق API محلی وجود ندارد. در نتیجه، روش اتصال محلی هیچ پشتیبانی از نقشه ندارد که به طور کامل چندین ویژگی اصلی که به داده‌های نقشه وابسته هستند را غیرفعال می‌کند، مانند تاریخچه تمیزکاری، بازیابی نقشه، و موجودیت‌های اتاق پویا. از آنجا که نقشه و ویژگی‌های وابسته به آن مرکزی برای عملکرد اصلی یکپارچه‌سازی هستند، این روش اتصال به شدت توصیه نمی‌شود. برای تجربه‌ای کامل و کاملاً عملکردی، به شدت توصیه می‌شود از یکی از روش‌های اتصال ابری استفاده کنید.

بازیابی IP و توکن

برای پیکربندی اتصال محلی، شما باید به صورت دستی آدرس IP و توکن دستگاه را فراهم کنید.

نیاز به زیرشبکه

به دلایل امنیتی، دستگاه تنها به درخواست‌هایی که از زیرشبکه خود ایجاد شده‌اند پاسخ می‌دهد. بنابراین، برای اینکه ارتباط محلی کار کند، جاروبرقی ربات و Home Assistant باید دقیقاً در همان زیرشبکه باشند. برای مشکلات مربوط به زیرشبکه‌های مختلف به این مقاله python-miio مراجعه کنید.

روش ۱: استخراج‌کننده توکن‌های Xiaomi Cloud توصیه شده

این روش قابل اعتمادترین است. روی ویندوز، مک‌اواس یا لینوکس اجرا می‌شود و مستقیماً به سرورهای ابری شیائومی متصل می‌شود تا آدرس‌های IP و توکن‌های تمام دستگاه‌های مرتبط با حساب را به‌صورت همزمان دریافت کند.

1. دانلود ابزار: نسخه مناسب (مثلاً .exe برای ویندوز) از استخراج‌کننده توکن‌های Xiaomi Cloud را از گیت‌هاب دانلود کنید.
2. اجرای برنامه: فایل دانلود شده را اجرا کنید تا رابط ترمینال باز شود.
3. وارد کردن اطلاعات کاربری: نام کاربری دقیق (ایمیل یا Xiaomi ID) و رمز عبوری که برای برنامه Xiaomi Home استفاده می‌شود، وارد کنید.
4. انتخاب منطقه سرور: منطقه سروری که با برنامه Xiaomi Home مطابقت دارد را مشخص کنید (مثلاً de برای اروپا). اگر منطقه را نمی‌دانید، پیام را خالی بگذارید و Enter را بزنید تا همه سرورهای موجود اسکن شوند.
5. دریافت توکن: این ابزار لیستی از تمام دستگاه‌های متصل به حساب را نمایش می‌دهد. جاروبرقی مورد نظر را در لیست پیدا کنید و توکن ۳۲ کاراکتری مربوط به آن را کپی کنید.

روش ۲: برنامه دسکتاپ با رابط گرافیکی (Get_MiHome_devices_token)

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

1. دانلود برنامه: برنامه Get_MiHome_devices_token را از گیت‌هاب دانلود و نصب کنید.
2. ورود به حساب: برنامه را باز کنید، اطلاعات حساب شیائومی را وارد کرده و منطقه سرور مناسب را انتخاب کنید.
3. دریافت توکن: پس از احراز هویت، تمام دستگاه‌های متصل همراه با آدرس‌های IP و توکن‌های مربوطه به صورت جدول نمایش داده خواهند شد.

روش ۳: نسخه مود شده برنامه Mi Home برای اندروید توصیه نمی‌شود

کاربران اندروید می‌توانند از نسخه‌ای اصلاح شده از برنامه Mi Home برای مشاهده توکن‌ها به طور مستقیم در رابط برنامه روی دستگاه موبایل خود استفاده کنند.

1. حذف نصب برنامه اصلی: برنامه رسمی Mi Home را به طور کامل از دستگاه اندرویدی حذف کنید. (توجه: دستگاه‌ها به‌طور ایمن به حساب ابری متصل خواهند ماند).
2. نصب برنامه مود شده: به‌صورت آنلاین به دنبال فایل APK مود شده "MiHome by Vevs" بگردید، آخرین نسخه را دانلود کرده و روی دستگاه نصب کنید.
3. ورود: برنامه مود شده را باز کنید و با اطلاعات حساب کاربری شیائومی خود وارد شوید.
4. بازیابی توکن: جاروبرقی هدف را انتخاب کنید تا رابط کنترل آن باز شود. روی سه نقطه در گوشه بالا سمت راست ضربه بزنید تا به تنظیمات دسترسی پیدا کنید، سپس به بخش اطلاعات شبکه یا تنظیمات عمومی بروید. آدرس IP و توکن دستگاه مستقیماً روی این صفحه قابل مشاهده خواهند بود.