easee_hass

สำคัญ!

โปรดอัปเกรดเป็นเวอร์ชัน v0.9.64 หรือใหม่กว่าโดยเร็วที่สุดหากคุณใช้เวอร์ชันระหว่าง v0.9.58 ถึง v0.9.62! การรวมทุกเวอร์ชันระหว่าง v0.9.58 และ v0.9.62 มีปัญหากับการจัดการข้อผิดพลาดในการเชื่อมต่อตัวส่งสัญญาณอีกครั้ง ซึ่งทำให้การเข้าถึงเซิร์ฟเวอร์ Easee signalr ล้มเหลวจำนวนมาก การติดตั้งเวอร์ชันที่ใหม่กว่าจะช่วยปรับปรุงความเสถียรของเซิร์ฟเวอร์ Easeee และเพิ่มทรัพยากรเพื่อการตอบสนองที่รวดเร็วยิ่งขึ้น คุณอาจไม่พบปัญหาใด ๆ ในการติดตั้งของคุณ แต่มีปัญหามากมายภายใต้ประทุน ดูรายละเอียดเพิ่มเติมในบันทึกประจำรุ่นของ v0.9.64

ส่วนประกอบเครื่องชาร์จ Easee EV สำหรับ Home Assistant

ส่วนประกอบที่กำหนดเองเพื่อรองรับเครื่องชาร์จและอีควอไลเซอร์ Easee EV

เซ็นเซอร์สถานะเป็นเซ็นเซอร์เริ่มต้นและมีค่าต่อไปนี้

 disconnected
awaiting_start
charging
ready_to_charge
completed
error

เซ็นเซอร์ที่ไม่ธรรมดาอื่นๆ บางตัว เช่น กระแสและแรงดัน ถูกปิดใช้งานตามค่าเริ่มต้น (แสดงเป็น "ไม่พร้อมใช้งาน") สามารถเปิดใช้งานได้ใน HA GUI ผ่านการบูรณาการ -> [ชื่อ Easee] -> อุปกรณ์ -> [ชื่อ Easee Equilizer] และภายใต้การวินิจฉัย ให้คลิกที่ Current/Voltage->gear_icon จากนั้นเปิดใช้งาน เซ็นเซอร์แต่ละตัวเหล่านี้ยังมีคุณลักษณะซึ่งประกอบด้วยค่าต่างๆ เช่น กระแสและแรงดันไฟฟ้าต่อเฟส ดู #271 เกี่ยวกับวิธีใช้คุณลักษณะเหล่านี้

การติดตั้ง

มี 2 ​​วิธีในการติดตั้งส่วนประกอบที่กำหนดเอง

การติดตั้ง HACS

1. เพิ่มที่เก็บนี้จาก HACS->Integrations
2. รีสตาร์ทผู้ช่วยที่บ้าน
3. ติดตั้งส่วนประกอบจากการตั้งค่า -> การรวมระบบ คุณอาจต้องล้างแคชของเบราว์เซอร์เพื่อให้การรวม Easee ปรากฏในรายการ

การติดตั้งคอมไพล์

1. ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้ง git บนเครื่องของคุณแล้ว
2. นำทางไปยังโฟลเดอร์การกำหนดค่าผู้ช่วยในบ้านของคุณ
3. สร้างโฟลเดอร์ custom_components ที่ไม่มีอยู่ จากนั้นไปที่โฟลเดอร์นั้นหลังจากสร้างแล้ว
4. ดำเนินการคำสั่งต่อไปนี้: git clone https://github.com/nordicopen/easee_hass.git easee
5. เรียกใช้ bash links.sh

เครื่องชาร์จ/อีควอไลเซอร์ที่ได้รับการตรวจสอบ

ตั้งแต่เวอร์ชัน 0.9.47 การผสานรวมจะรวมเฉพาะที่ชาร์จและอีควอไลเซอร์ที่เพิ่มลงในแอปอย่างเป็นทางการของ Easee เท่านั้น แทนที่จะแสดงทั้งหมดที่มีให้กับผู้ใช้ที่เข้าสู่ระบบ การเปลี่ยนแปลงนี้เกิดขึ้นเนื่องจากในการติดตั้งขนาดใหญ่อาจมีที่ชาร์จ 10 หรือ 100 อันอยู่ในรายการ ซึ่งโดยส่วนใหญ่แล้วไม่สมเหตุสมผลนัก ดังนั้นหากคุณไม่เห็นผลิตภัณฑ์ทั้งหมดของคุณในการผสานรวม ให้เปิดแอปอย่างเป็นทางการและตรวจสอบให้แน่ใจว่าผลิตภัณฑ์เหล่านั้นแสดงอยู่ในนั้นก่อน โปรดทราบว่าหากไม่มีการเพิ่มที่ชาร์จลงในแอปเลย ข้อความแสดงข้อผิดพลาด "ไม่พบไซต์ในบัญชีนี้" จะแสดงขึ้นขณะติดตั้ง

การกำหนดค่า

การกำหนดค่าเสร็จสิ้นในการกำหนดค่า > การรวมระบบ โดยที่คุณกำหนดค่าก่อน จากนั้นจึงตั้งค่าตัวเลือกสำหรับสิ่งที่คุณต้องการตรวจสอบ

ใช้

การใช้งานพื้นฐานของการผสานรวมจาก UI ควรอธิบายได้ในตัว การผสานรวมจะกำหนดบริการจำนวนหนึ่งที่สามารถนำมาใช้จากระบบอัตโนมัติและสคริปต์เพื่อควบคุมเครื่องชาร์จและกระบวนการชาร์จ บริการที่มีให้สามารถพบได้ใน Home Assistant ที่เครื่องมือสำหรับนักพัฒนา -> บริการ

วิธีที่ง่ายที่สุดในการตั้งค่าบริการและพารามิเตอร์คือการใช้ตัวแก้ไขอัตโนมัติหรือเครื่องมือสำหรับนักพัฒนา อย่างไรก็ตาม คุณยังสามารถเขียนโค้ดในรูปแบบ yaml ธรรมดาได้ UI จะใช้ device_id เป็นเป้าหมายสำหรับบริการ นี่เป็นสตริงสุ่มที่สร้างขึ้นภายในโดย HA และไม่เป็นมิตรกับผู้ใช้มากนัก เพื่อให้ง่ายขึ้นสำหรับผู้เขียนโค้ดแบบฮาร์ดคอร์และเพื่อให้เข้ากันได้กับเวอร์ชันก่อนหน้าของการผสานรวมนี้ คุณยังสามารถใช้ charger_id หรือ circuit_id เป็นเป้าหมายได้ สามตัวอย่างที่จะทำสิ่งเดียวกัน:

 service : easee.set_circuit_dynamic_limit
data :
  device_id : b40f1f45d28b0891
  current_p1 : 10 

 service : easee.set_circuit_dynamic_limit
data :
  charger_id : EVK1234
  current_p1 : 10 

 service : easee.set_circuit_dynamic_limit
data :
  circuit_id : 30456
  current_p1 : 10

สำหรับรายละเอียดเกี่ยวกับ Easee API โปรดดูที่ https://developer.easee.cloud/reference

การบันทึกการแก้ไขข้อบกพร่อง

คุณสามารถเปิดใช้งานบันทึกการแก้ไขข้อบกพร่องแบบเต็มได้โดยป้อนสิ่งต่อไปนี้ใน configuration.yaml แล้วรีสตาร์ท Home Assistant

 logger :
  default : info
  logs :
    pyeasee : debug
    custom_components.easee : debug 

คอนเทนเนอร์การพัฒนา

ทางเลือกหนึ่งสำหรับการพัฒนาคือการใช้ VS Code Dev Container คุณต้องติดตั้ง Docker

1. เปิด vscode เปล่าใหม่
2. เลือก Command Palette->Dev Containers: Clone repository ในชื่อคอนเทนเนอร์วอลุ่ม
3. ปฏิบัติตามคำแนะนำ
4. รอให้สร้างคอนเทนเนอร์
5. กด Ctrl + Shift + P และเลือก Tasks: Run Task > Run Home Assistant on port 9125
6. รอให้ Home Assistant เริ่มต้นและไปที่ http://localhost:9125/
7. เดินผ่าน UI การเปิดตัวครั้งแรกของ Home Assistant
8. ไปที่ http://localhost:9125/config/integrations คลิก Add Integration และเพิ่มการรวม Easee
9. หากต้องการแก้ไขข้อบกพร่อง ให้กด F5 เพื่อเชื่อมต่อกับ Home Assistant ที่ทำงานอยู่ในคอนเทนเนอร์

วิ่งอยู่เสมอ

$ make lint

ก่อนที่จะผลักดันการเปลี่ยนแปลงของคุณ

การแปล

เรากำลังใช้ Lokalise เพื่อจัดการการส่งคำแปล พวกเขามอบแพลตฟอร์มที่น่าทึ่งซึ่งใช้งานและบำรุงรักษาง่ายแก่เรา

เพื่อช่วยในการแปลการบูรณาการ Easee คลิกที่นี่ หากคุณถูกขอให้เข้าสู่ระบบ โดยปกติจะใช้ "เข้าสู่ระบบด้วย GitHub" ได้ง่ายที่สุด

หากคุณต้องการเพิ่มภาษาใหม่ โปรดเปิดปัญหาที่นี่ในที่เก็บนี้

คำแปลจะถูกดึงออกมาเมื่อมีการเตรียมการผสานรวมรุ่นใหม่ ดังนั้นคุณต้องรอจนกว่าจะมีรุ่นใหม่จนกว่าคุณจะมองหาการอัปเดตของคุณ

หากคุณต้องการเพิ่มองค์ประกอบใหม่ที่ต้องการการแปล คุณควรป้อนองค์ประกอบเหล่านั้นใน /translations/en.json และส่ง PR คีย์ใหม่จะปรากฏเป็นภาษา Lokalise เมื่อมีการรวม PR

การแสดงที่มา การสนับสนุน และความร่วมมือ

โครงการนี้เริ่มต้นโดย Niklas Fondberg, @fondberg ผู้ล่วงลับไปแล้ว พื้นที่เก็บข้อมูลนี้สืบทอดมาจากผู้ทำงานร่วมกันของเขา

สนับสนุนโครงการโดย