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

یہ ریپوزٹری Hoval Connect IoT کلاؤڈ API کی غیر سرکاری، ریورس انجینئرڈ دستاویزات کے ساتھ HACS کے ذریعے نصب ہونے والا Home Assistant کسٹم انٹیگریشن فراہم کرتی ہے۔ یہ Hoval سے وابستہ نہیں ہے اور اسے پہلے کے CAN-bus/MQTT گیٹ وے پروجیکٹ کے جانشین کے طور پر پیش کیا گیا ہے؛ کلاؤڈ طریقہ کار کے لیے کسی اضافی ہارڈ ویئر کی ضرورت نہیں، صرف Hoval Connect اکاؤنٹ کی اسناد درکار ہیں۔ انٹیگریشن کی صلاحیتیں تنصیب ریپوزٹری کو کسٹم HACS انٹیگریشن کے طور پر شامل کر کے، Home Assistant کو دوبارہ شروع کر کے، اور Hoval Connect ای میل اور پاس ورڈ درج کر کے کی جاتی ہے۔ پلانٹس اور سرکٹس خودکار طور پر دریافت ہو جاتے ہیں۔ README اس بات پر زور دیتا ہے کہ ورژن 1.0.8 یا اس سے نیا درکار ہے، کیونکہ Hoval کا Azure Application Gateway ان درخواستوں کو مسترد کرتا ہے جن کے User-Agent میں "homeassistant" شامل ہو؛ انٹیگریشن اس کے بجائے اپنا شناخت کنندہ بھیجتی ہے۔ پرانے ورژنز مبینہ طور پر HTTP 403 کے ساتھ ناکام ہوتے ہیں جو اسناد یا نیٹ ورک کے مسئلے سے مشابہ ہوتا ہے۔ دستیاب Entities میں شامل ہیں: - فی HV وینٹیلیشن سرکٹ کے لیے Fan entity: مسلسل 0-100% رفتار سلائیڈر ڈیباؤنسڈ ان پٹ کے ساتھ، آن/آف ٹوگل، قابل ترتیب turn-on موڈ (آخری مشاہدہ شدہ ہفتہ پروگرام دوبارہ شروع کریں، یا واضح طور پر week1/week2)۔ - فی HK حرارت سرکٹ کے لیے Climate entity: ہدف درجہ حرارت، موجودہ کمرے کا درجہ حرارت، HVAC موڈز Heat/Auto/Off، اور HVAC ایکشن جو سرکٹ کی حیثیت ظاہر کرتا ہے۔ - فی WW گرم پانی کے سرکٹ کے لیے Water heater entity: ہدف درجہ حرارت 10-65 C 0.5 C کے مراحل میں عارضی بوسٹ کے طور پر جو آدھی رات کو ختم ہو جاتا ہے، نیز ہیٹ پمپ اور آف آپریشن موڈز۔ - فی HV/HK/WW سرکٹ کے لیے Program select: week1، week2، eco موڈ، اسٹینڈ بائی، کانسٹنٹ، صارف کے متعین کردہ پروگرام نام دکھاتا ہے اور ڈپلیکیٹس میں فرق کرتا ہے۔ - سرکٹ کی قسم کے مطابق فلٹر کیے گئے Sensor entities، جن میں باہر، ایگزاسٹ، فلو، کمرہ، ٹینک اور بفر درجہ حرارت، ہوا کا حجم، نمی، CO2/VOC، کنٹرول اسٹیٹس، آپریٹنگ اوقات، سوئچنگ سائیکلز، پیدا شدہ حرارت، استعمال شدہ توانائی، ماڈیولیشن اور متعلقہ اقدار شامل ہیں۔ - پلانٹ سطح کے sensors برائے موسم کی حالت، پیشن گوئی درجہ حرارت، تازہ ترین ایونٹ کی قسم/پیغام/ٹائم اسٹیمپ اور فعال ایونٹ کی تعداد۔ - فی سرکٹ آن لائن/آف لائن، ایرر اسٹیٹس، اور عارضی تبدیلی کی حالت کے لیے Binary sensors۔ - Diagnostics ایکسپورٹ جس میں ٹوکنز، اسناد اور پلانٹ IDs کی خودکار ریڈیکشن ہوتی ہے۔ اختیارات میں turn-on موڈ، عارضی اوور رائیڈ کی مدت، اور پولنگ انٹرول (ڈیفالٹ 60 سیکنڈ) شامل ہیں۔ ایک سروس، hoval_connect.reset_temporary_change، fan، climate یا water-heater entity پر فعال اوور رائیڈ کو منسوخ کرتی ہے۔ اندرونی طور پر انٹیگریشن دو مرحلوں والا ٹوکن مینجمنٹ (ID ٹوکن کے ساتھ Plant Access Token) TTL کیشنگ، آٹو ریفریش اور سنگل فلائٹ لاکنگ کے ساتھ استعمال کرتی ہے، جب پلانٹ آف لائن ہو تو کالز چھوڑ دیتی ہے، محدود تعداد میں ان فلائٹ سرکٹ درخواستوں کے ساتھ متوازی فیچز کرتی ہے، فی پلانٹ اور سرکٹ کنٹرول کمانڈز کو سیریلائز کرتی ہے، اور پروگرامز، ایونٹس اور موسم کے لیے درجہ بند کیشنگ لاگو کرتی ہے۔ یہ دوبارہ شروع کیے بغیر نئے سرکٹس کی متحرک دریافت کی حمایت کرتی ہے اور پیجینیٹڈ جوابات کو نارملائز کرتی ہے۔ ایک بنڈل شدہ Home Assistant Blueprint اختیاری سمر بوسٹ نافذ کرتا ہے جو گرم دوپہروں میں HomeVent کو 90% تک بڑھاتا ہے جب کوئی غیر دفتری کمرہ آرام کی حد سے تجاوز کرے اور باہر کی ہوا معتدل اور اندر سے ٹھنڈی ہو، اور قابل ترتیب شرائط پر ختم ہوتا ہے۔ لائیو اقدار، موسم اور ایونٹس پڑھنے کے لیے اسٹینڈalone Python اور Bash/curl مثالیں شامل ہیں۔ دستاویز شدہ حدود میں صرف HV، HK، BL، WW اور PS سرکٹس کی حمایت شامل ہے (سولر یا فریش واٹر نہیں)، ٹائم پروگرام ایڈیٹنگ نہیں، توانائی یا درجہ حرارت کی تاریخ نہیں، ہالیڈے موڈ کنٹرول نہیں، اور فی Hoval اکاؤنٹ ایک config entry۔ تقاضے ایک Hoval Connect اکاؤنٹ اور Home Assistant 2024.11.0 یا اس سے نیا ہیں۔ API دستاویزات README کلاؤڈ آرکیٹیکچر (ڈیوائس سے IoT گیٹ وے سے Azure IoT Hub سے کور API سے ایپ/انٹیگریشن)، انفراسٹرکچر URLs، اور دو مرحلوں والا تصدیق کا بہاؤ دستاویز کرتا ہے: SAP Cloud Identity Services کے خلاف OAuth2 پاس ورڈ گرانٹ جو ID ٹوکن (تقریباً 30 منٹ) حاصل کرتا ہے جو Bearer ٹوکن کے طور پر استعمال ہوتا ہے، اس کے بعد پلانٹ سیٹنگز کال جو Plant Access Token (تقریباً 15 منٹ) واپس کرتی ہے جو X-Plant-Access-Token کے طور پر بھیجا جاتا ہے۔ یہ bootstrap، صارف کی سیٹنگز، پلانٹس، کنٹریکٹس، پلانٹ سیٹنگز، سرکٹس، پروگرامز، سیٹنگز، عارضی تبدیلیاں، ہالیڈے موڈ اور پارٹنر endpoints کی فہرست دیتا ہے، مثال JSON payloads اور سرکٹ اقسام (HK، BL، WW، FRIWA، HV، SOL، SOLB، PS، GW) پر نوٹس کے ساتھ۔ یہ اپریل 2026 کی API تبدیلی ریکارڈ کرتا ہے جو v1 سرکٹ endpoints کو ہٹا کر v3 (اور عارضی تبدیلیوں کے لیے v4) کے حق میں کرتی ہے، کنٹرول endpoints کو بیان کرتا ہے جو HTTP 204 واپس کرتے ہیں، اور نوٹ کرتا ہے کہ کون سے endpoints دستاویز شدہ لیکن غیر آزمودہ ہیں۔