منصوبے کے بارے میں

python-miio ایک کمیونٹی سے چلنے والی Python لائبریری اور اس کے ساتھ کمانڈ لائن ٹول، miiocli ہے، جو miIO اور MIoT پروٹوکول بولنے والے Xiaomi اسمارٹ آلات کو کنٹرول کرنے کے لیے ہے۔ یہ Xiaomi یا کسی بھی وینڈر سے وابستہ نہیں ہے جس کے ڈیوائسز کو یہ سپورٹ کرتا ہے۔ انسٹالیشن pip (python-miio) کے ذریعے ہے، یا ڈیولپمنٹ ورژن کے لیے GitHub ریپوزٹری سے۔ README میں جاری ری فیکٹرنگ کی کوشش کا ذکر ہے اور جدید MIoT ڈیوائسز کو کنٹرول کرنے کے لیے git ورژن یا پری ریلیز استعمال کرنے کی سفارش کی گئی ہے جب تک ورژن 0.6.0 ریلیز نہیں ہو جاتا۔ شروع کرنا: miiocli سپورٹڈ ڈیوائسز کو ان کے IP ایڈریس اور ٹوکن کے ذریعے کنٹرول کر سکتا ہے۔ ٹوکنز Xiaomi کلاؤڈ اکاؤنٹ سے miiocli cloud کمانڈ (micloud لائبریری استعمال کرتے ہوئے) کے ذریعے حاصل کیے جا سکتے ہیں، یا دیگر دستاویزی طریقوں سے حاصل کیے جا سکتے ہیں۔ ایک عمومی info کمانڈ ماڈل، ہارڈویئر اور فرم ویئر ورژن، سپورٹڈ انٹیگریشن کلاس، اور کنٹرول کے لیے استعمال ہونے والی درست کمانڈ کی اطلاع دیتی ہے۔ جدید MIoT ڈیوائسز کو genericmiot انٹیگریشن کے ذریعے ہینڈل کیا جاتا ہے جو سینسرز، سیٹنگز اور ایکشنز دریافت کرنے کے لیے ڈیوائس ماڈل اسپیسفیکیشن فائلیں ڈاؤن لوڈ اور کیش کرتی ہے۔ عام کمانڈز میں status (اسٹیٹ اور ریڈ رائٹ سیٹنگز کے لیے قابل قبول اقدار دکھانا)، set (نام سے سیٹنگ تبدیل کرنا)، actions (دستیاب ایکشنز کی فہرست) اور call (ایکشن چلانا) شامل ہیں۔ پرانی miIO ڈیوائسز کو فی ڈیوائس ماڈیولز جیسے roborockvacuum یا fan کے ذریعے سپورٹ کیا جاتا ہے، ہر ماڈیول اپنی ذیلی کمانڈز پیش کرتا ہے۔ ماڈل کا پتہ خودکار ہے لیکن جب کلاؤڈ کنیکٹیویٹی دستیاب نہ ہو تو --model فلیگ سے اوور رائیڈ کیا جا سکتا ہے۔ ٹربل شوٹنگ سپورٹ میں لاگ کی تفصیل بڑھانے کے لیے دہرائے جانے والے --debug/-d فلیگز، ٹربل شوٹنگ دستاویزات کا سیکشن، GitHub ایشوز اور مباحثے، اور ایک Matrix چیٹ روم شامل ہیں۔ API استعمال: miio ماڈیول تمام فعالیت کو ظاہر کرتا ہے۔ DeviceFactory.create(ip, token) ماڈل کا پتہ لگانے کے لیے info استفسار کرتا ہے اور مماثل ڈیوائس کلاس بناتا ہے۔ ڈیوائس کلاسز کو sensors()، settings() اور actions() کے ذریعے جانچا جا سکتا ہے، جو دستیاب خصوصیات کو بیان کرنے والے ڈسکرپٹر آبجیکٹ واپس کرتے ہیں؛ ابھی تمام انٹیگریشنز ڈسکرپٹرز کی وضاحت نہیں کرتیں۔ بگ فکسز، فیچرز اور دستاویزات کے تعاون کا خیر مقدم کیا جاتا ہے، ایک مختصر تعاون گائیڈ فراہم کی گئی ہے۔ ہارڈویئر کے بغیر ڈیولپرز کے لیے، پروجیکٹ کوڈ کی جانچ کے لیے سادہ miIO اور MIoT سمیولیٹرز فراہم کرتا ہے۔ README میں سپورٹڈ ڈیوائسز کی ایک وسیع فہرست درج ہے، جس میں Xiaomi روبوٹ ویکیومز (Mi Robot Vacuum V1, S4, S4 MAX, S5, S5 MAX, S6 Pure, M1S, S7، اور مختلف Dreame اور Viomi ماڈلز)، ایئر پیوریفائرز، ہیومیڈیفائرز، ایئر کنڈیشنرز، کیمرے، گیٹ ویز، پلگ، پاور سٹرپس، لیمپ اور بلب، IR ریموٹ کنٹرولرز، پیڈسٹل پنکھے، واٹر پیوریفائرز، ایئر کوالٹی مانیٹرز، اسپیکرز، وائی فائی ریپیٹرز، رائس ککرز، فریش ایئر سسٹمز، Yeelight لائٹس، ہیٹرز، ایک پردہ کنٹرولر، ایک ڈش واشر، ایک کافی میکر، ایک پالتو واٹر ڈسپنسر اور مزید شامل ہیں۔ کہا جاتا ہے کہ تمام MIoT ڈیوائسز genericmiot کے ذریعے سپورٹڈ ہیں۔ Home Assistant اس لائبریری کو کئی پلیٹ فارمز (vacuum, light, fan, switch, remote, sensor, alarm control panel, device tracker) کے لیے سرکاری طور پر استعمال کرتا ہے، اور مختلف کسٹم Home Assistant اجزاء بھی اس پر بنائے گئے ہیں۔ ذکر کردہ متعلقہ پروجیکٹس میں dustcloud، Valetudo، micloud، micloudfaker اور Xiaomi Cloud Tokens Extractor شامل ہیں۔