इस प्रोजेक्ट के बारे में

python-miio एक सामुदायिक-संचालित पायथन लाइब्रेरी और साथ में कमांड-लाइन टूल, miiocli है, जो Xiaomi स्मार्ट उपकरणों को नियंत्रित करने के लिए है जो miIO और MIoT प्रोटोकॉल बोलते हैं। यह 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 शामिल हैं।