ha duke energy gateway

สำคัญ - เลิกใช้แล้ว

Duke Energy ปิดโครงการนำร่องเกตเวย์เมื่อปลายเดือนมิถุนายน 2566 การรวมนี้หยุดทำงานและเลิกใช้แล้ว

Duke Energy Gateway

นี่คือการรวมที่กำหนดเองสำหรับผู้ช่วยบ้าน มันดึงการใช้พลังงานแบบเรียลไทม์จาก Duke Energy ผ่านโครงการนำร่อง Duke Energy Gateway

การรวมนี้ใช้ประโยชน์จากห้องสมุด pyduke-energy ซึ่งเขียนโดยฉันเพื่อดึงข้อมูล API นี้ไม่เป็นทางการ มาก และอาจหยุดทำงานได้ตลอดเวลา (ดูข้อจำกัดความรับผิดชอบ)

สิ่งที่จำเป็นก่อน! (โปรดอ่าน)

คุณจะต้องมีเกตเวย์พลังงาน Duke เชื่อมต่อกับสมาร์ทมิเตอร์ของคุณเพื่อให้ทำงานได้ นี่เป็นอุปกรณ์ แยกต่างหาก นอกเหนือจากเครื่องวัดอัจฉริยะของคุณและจัดทำโดยโปรแกรมคำเชิญเท่านั้นในขณะนี้ ถ้าคุณไม่รู้ว่านี่คืออะไรคุณอาจไม่มีมัน การรวมนี้ไม่สนับสนุนวิธีการอื่นในการดึงข้อมูล (ดูความต้องการเกตเวย์)

เซ็นเซอร์

ส่วนประกอบนี้จะตั้งค่าเอนทิตีต่อไปนี้:

sensor.duke_energy_current_usage_w

• แสดงถึงการใช้ พลังงาน แบบเรียลไทม์ในวัตต์
• ข้อมูลนี้ถูกผลักออกจากอุปกรณ์เกตเวย์ทุก ๆ 1-3 วินาที หมายเหตุ: สิ่งนี้สร้างข้อมูลจำนวนมาก หากช่วงเวลาการอัปเดตนี้บ่อยเกินไปสำหรับคุณคุณสามารถกำหนดค่าช่วงเวลาการควบคุมปริมาณในไม่กี่วินาที (ดูการกำหนดค่าด้านล่าง)
• โปรดทราบว่าเนื่องจากนี่คือการใช้พลังงานจึงไม่สามารถใช้งานได้สำหรับแผงควบคุมพลังงานผู้ช่วยในบ้าน แต่คุณสามารถใช้ sensor.duke_energy_usage_today_kwh เซ็นเซอร์เซ็นเซอร์ duke_energy_usage_today_kwh หรือคุณจำเป็นต้องป้อนเซ็นเซอร์แบบเรียลไทม์นี้ผ่านการรวม Riemann Sum Integral
• มีแอตทริบิวต์เพิ่มเติมที่มี ID มิเตอร์และรหัสเกตเวย์

sensor.duke_energy_usage_today_kwh

• แสดงถึงการใช้ พลังงาน ของวันนี้ในกิโลวัตต์ชั่วโมง (ตั้งแต่เวลา 0:00 น. ถึง 23:59 เวลาท้องถิ่นจากนั้นรีเซ็ต)
• ข้อมูลนี้ถูกสำรวจทุก ๆ 60 วินาที แต่ข้อมูลอาจล่าช้าไปถึง 15 นาทีเนื่องจากความล่าช้าใน Duke Energy รายงาน (ดูข้อ จำกัด ใน Repo pyduke-energy )
• สามารถใช้งานได้ตามที่เป็นอยู่สำหรับแดชบอร์ดการใช้พลังงานของผู้ช่วยในบ้าน
• มีแอตทริบิวต์เพิ่มเติมที่มี ID มิเตอร์รหัสเกตเวย์และการประทับเวลาของการวัดครั้งสุดท้าย

การติดตั้ง

การติดตั้ง HACS

1. เพิ่มเป็นที่เก็บที่กำหนดเองภายใต้การตั้งค่าใน HACs: mjmeli/ha-duke-energy-gateway และเลือก Integration เป็นหมวดหมู่
2. ค้นหา "Duke Energy Gateway" ใน HACs และการรวมควรกลับมาเป็นผลการค้นหา คลิกที่มันคลิกปุ่ม "ดาวน์โหลด" แล้วเดินผ่านพรอมต์เพื่อดาวน์โหลด
3. รีสตาร์ทผู้ช่วยที่บ้าน
4. ใน HA UI ไปที่ "การตั้งค่า" -> "อุปกรณ์และบริการ" ตรวจสอบให้แน่ใจว่าคุณอยู่ในแท็บการรวมจากนั้นคลิก "+" และค้นหา "Duke Energy Gateway" สิ่งนี้จะช่วยให้คุณตั้งค่าได้

การติดตั้งด้วยตนเอง

1. การใช้เครื่องมือที่เลือกเปิดไดเรกทอรี (โฟลเดอร์) สำหรับการกำหนดค่า HA ของคุณ (ที่คุณพบ configuration.yaml )
2. หากคุณไม่มีไดเรกทอรี custom_components (โฟลเดอร์) ที่นั่นคุณต้องสร้างมันขึ้นมา
3. ในไดเรกทอรี custom_components (โฟลเดอร์) สร้างโฟลเดอร์ใหม่ที่เรียกว่า duke_energy_gateway
4. ดาวน์โหลดไฟล์ ทั้งหมด จาก custom_components/duke_energy_gateway/ ไดเรกทอรี (โฟลเดอร์) ในที่เก็บนี้
5. วางไฟล์ที่คุณดาวน์โหลดในไดเรกทอรีใหม่ (โฟลเดอร์) ที่คุณสร้างขึ้น
6. รีสตาร์ทผู้ช่วยที่บ้าน
7. ใน HA UI ไปที่ "การตั้งค่า" -> "อุปกรณ์และบริการ" ตรวจสอบให้แน่ใจว่าคุณอยู่ในแท็บการรวมจากนั้นคลิก "+" และค้นหา "Duke Energy Gateway" สิ่งนี้จะช่วยให้คุณตั้งค่าได้

การกำหนดค่า

การกำหนดค่าจะทำใน UI เริ่มแรกคุณจะต้องให้ข้อมูลต่อไปนี้:

ข้อมูล	คำอธิบาย
email	อีเมลเข้าสู่ระบบของคุณไปยัง Duke Energy
password	รหัสผ่านเข้าสู่ระบบของคุณไปยัง Duke Energy

หลังจากการตั้งค่าการรวมคุณจะสามารถกำหนดค่าเพิ่มเติมได้โดยคลิก "กำหนดค่า" ในหน้าการรวม สิ่งนี้จะช่วยให้คุณสามารถแก้ไขตัวเลือกต่อไปนี้:

ข้อมูล	คำอธิบาย
Real-time Usage Update Interval (sec)	โดยค่าเริ่มต้นเซ็นเซอร์การใช้งานแบบเรียลไทม์จะได้รับการอัปเดตเมื่อใดก็ตามที่การอ่านเข้ามาหากข้อมูลนี้บ่อยเกินไปคุณสามารถกำหนดค่านี้เพื่อให้ข้อมูล เมื่อตั้งค่าเป็นจำนวนเต็มบวก X เซ็นเซอร์จะได้รับการอัปเดตเพียงทุกครั้ง X วินาที กล่าวอีกนัยหนึ่งถ้าตั้งค่าเป็น 30 คุณจะได้รับการใช้งานแบบเรียลไทม์ใหม่ทุก ๆ ~ 30 วินาที

การเลือกเมตร

โฟลว์การกำหนดค่าจะพยายามระบุเกตเวย์และ SmartMeter ของคุณโดยอัตโนมัติ ตอนนี้มีเพียงหนึ่งเดียวที่ได้รับการสนับสนุนต่อบัญชี คนแรกที่ระบุจะถูกใช้ หากไม่พบหนึ่งกระบวนการกำหนดค่าควรล้มเหลว

หากการเลือกมิเตอร์ของคุณล้มเหลวขั้นตอนแรกควรเปิดใช้งานการบันทึกสำหรับส่วนประกอบ (ดูการบันทึก) หากสิ่งนี้ไม่ได้ให้ข้อมูลเชิงลึกเกี่ยวกับปัญหาโปรดเปิดปัญหา GitHub

การตัดไม้

หากคุณพบปัญหาใด ๆ และต้องการดูบันทึกการรวมนี้จะให้การบันทึก verbose ในระดับการดีบัก ที่สามารถเปิดใช้งานได้โดยเพิ่มไฟล์ต่อไปนี้ลงใน configuration.yaml ของคุณ

 logger :
  default : info
  logs :
    custom_components.duke_energy_gateway : debug
    pyduke_energy.client : debug
    pyduke_energy.realtime : debug 

การพัฒนา

ฉันขอแนะนำให้ใช้คอนเทนเนอร์ dev เพื่อการพัฒนาโดยการเปิดใน Visual Studio Code ด้วย code . และคลิกที่ตัวเลือกเพื่อเปิดอีกครั้งกับ dev container ในรหัส VS คุณสามารถเรียกใช้งาน "Run Home Assistant บนพอร์ต 9123" จากนั้นเข้าถึงผ่าน http: // localhost: 9123

หากคุณต้องการติดตั้งด้วยตนเองคุณสามารถติดตั้ง Dev Dependencies ด้วย pip install -r requirements_dev.txt

ก่อนที่จะมุ่งมั่นให้ pre-commit run --all-files

การทำงานกับในการพัฒนาเวอร์ชัน pyduke-energy

หากคุณกำลังดำเนินการในการใช้การเปลี่ยนแปลงใหม่จาก pyduke-energy แต่ไม่ต้องการปล่อยไลบรารีเวอร์ชันนั้นคุณสามารถตั้งค่าสภาพแวดล้อมการพัฒนาของคุณเพื่อติดตั้งจากสาขาการทำงานระยะไกล

1. อัพเดท requirements_dev.txt เพื่อแทนที่ main ใน git+https://github.com/mjmeli/pyduke-energy@main กับสาขาการทำงานของคุณและอัปเดตชื่อผู้ใช้หากคุณมีส้อม (eg git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch
2. ถอนการติดตั้ง pyduke-energy เวอร์ชันแคช: pip uninstall -y pyduke-energy
3. การติดตั้งข้อกำหนดอีกครั้ง: pip install -r requirements_dev.txt

ยินดีต้อนรับ!

หากคุณต้องการมีส่วนร่วมในเรื่องนี้โปรดอ่านแนวทางการบริจาค

การให้เครดิต

โครงการนี้สร้างขึ้นจากแม่แบบ CookieCutter ส่วนประกอบที่กำหนดเองของ @oncleben31

เทมเพลตรหัสส่วนใหญ่นำมาจากเทมเพลต integration_blueprint ของ @ludeeus

---