English | Tiếng Việt
Từ việc sử dụng các phương thức có sẵn của module AIOHTTP thông qua những giao thức HTTP(S) cơ bản, công cụ cho phép theo dõi dữ liệu điện năng tiêu thụ từ EVN trực tiếp trên UI Home Assistant, hiện tại đã hỗ trợ cho tất cả vùng miền tại Việt Nam cùng với chi nhánh EVN tương ứng (xem tại danh sách phía dưới).
- Thiết lập và theo dõi nhiều mã khách hàng cùng một lúc, trên cùng một máy chủ HA.
- Cài đặt và chỉnh sửa trực tiếp bằng UI (thông qua HACS), quản lí các thông số điện năng thông qua các thiết bị theo dõi tập trung.
- Hỗ trợ cho tất cả chi nhánh EVN toàn quốc (bao gồm 5 tổng công ty và hơn 400 chi nhánh lớn nhỏ).
- Tự động xác định máy chủ EVN.
- Tương thích với tất cả platform HA: Core, Supervisors, Hass OS.
- Chưa hoàn toàn hỗ trợ thêm sensor vào Energy.
- Chưa hỗ trợ đối tượng khác ngoài các hộ sinh hoạt tiêu thụ điện 2 pha thông thường.
- Sensors về tiền điện ngày / tháng chỉ mang tính chất tham khảo, được tính một cách thủ công theo giá bán lẻ bên dưới, vì vậy khả năng sai số là rất cao.
- Các thông tin không được cập nhật tức thì từ dữ liệu mới nhất của EVN, mà luôn được cập nhật theo chu kì cố định.
-
Sản lượng ngày mới nhất và ngày trước đó, cùng với sản lượng tháng hiện tại (tạm chốt).
-
Số tiền được (tạm) tính từ 3 sản lượng phía trên.
-
Tình trạng hóa đơn nợ và số tiền nợ (nếu có).
-
Chỉ số mới nhất và chỉ số cũ từ ngày đầu kì (ngày bắt đầu hóa đơn tháng).
-
Ngày cập nhật dữ liệu mới nhất cùng với ngày đầu kì.
Xem thêm Ý nghĩa của các sensors phía dưới để hiểu rõ chức năng / hạn chế của từng thông số trên.
Công cụ chỉ hỗ trợ cho loại công tơ điện tử đo xa ghi theo ngày:
-
Không phải tất cả công tơ điện tử đều hỗ trợ đọc chỉ số từ xa (đo xa).
-
Không phải tất cả công tơ điện tử đo xa đều hỗ trợ ghi theo ngày.
Để đảm bảo công tơ nhà bạn đủ điều kiện để sử dụng công cụ, xin hãy truy cập vào link Đăng nhập phía dưới (xin chọn tương ứng với khu vực EVN của bạn).
Nếu như bạn có thể theo dõi được sản lượng theo ngày trên website hoặc app chính thức của EVN, thì công tơ nhà bạn thích hợp để sử dụng công cụ này.
Hiện tại tất cả chi nhánh, vùng miền đều cần phải có tài khoản EVN tương ứng với mã khách hàng để sử dụng công cụ.
Tài khoản EVN hợp lệ sẽ bao gồm:
- Tên tài khoản / Username (thông thường sẽ là mã khách hàng hoặc số điện thoại)
- Mật khẩu / Password.
Mã khách hàng của bạn phải thỏa những điều kiện sau:
- Chứa từ 11 tới 13 kí tự.
- Bắt đầu bằng chữ 'P'.
Chú ý: Kiểm tra ở bảng phía dưới, liên hệ với TTCSKH (Trung tâm Chăm sóc Khách Hàng) để xin thông tin đăng nhập nếu chưa có:
| Chi nhánh EVN | Khu vực | Đang được hỗ trợ | Đăng nhập | TTCSKH |
|---|---|---|---|---|
| EVNHANOI | Thủ đô Hà Nội | ☑️ | Link | Link |
| EVNHCMC | Thành phố Hồ Chí Minh | ☑️ | Link | Link |
| EVNNPC | Khu vực miền Bắc | ☑️ | Link | Link |
| EVNCPC | Khu vực miền Trung | ☑️ | Link | Link |
| EVNSPC | Khu vực miền Nam | ☑️ | Link | Link |
Cách 1: Cài đặt thông qua HACS (khuyến nghị).
- Tải repository package về máy chủ HA.
HACS > Integrations > ➕ Explore & download repositories >
EVN Data Fetcher>Chọn phiên bản mới nhất> Download this repository
- Khởi động lại HomeAssistant.
- Cài đặt thành công, tiếp theo đến bước Config để hoàn thành.
-
Tải phiên bản mới nhất của công cụ thông qua Github.
-
Giải nén thư mục
custom_components/nestup_evnvào thư mụccustom_componentstrong HomeAssistant của bạn.-
Thư mục
custom_componentsphụ thuộc vào thư mục cài đặt HomeAssistant của bạn. -
Thông thường, thư mục cài đặt HomeAssistant sẽ là
~/homeassistant/. -
Nói cách khác, thư mục cài đặt HomeAssistant là thư mục chứa file
configuration.yaml. -
Sau khi cài đặt đúng, đường dẫn sẽ có dạng:
└── ... └── configuration.yaml └── secrets.yaml └── custom_components └── nestup_evn └── __init__.py └── sensor.py └── nestup_evn.py └── ...
Chú ý: nếu thư mục
custom_componentskhông tồn tại, bạn phải tự tạo nó. -
Settings > Devices and Services > Integrations > Add Integrations > Tìm
EVN Data Fetcher
Yêu cầu: Mã khách hàng của bạn phải thỏa những điều kiện sau:
- Chứa từ 11 tới 13 kí tự.
- Bắt đầu bằng chữ 'P'.
Chú ý: ngày bắt đầu hóa đơn là ngày đầu tiên trong hóa đơn điện hàng tháng (xem hóa đơn các kì trước để chắc chắn).
Lưu ý: thay thế tên thiết bị của bạn (unique_id) vào 5 phần ten_device_cua_ban ở phía dưới.
alias: Thông báo điện năng tiêu thụ mỗi ngày
mode: single
trigger:
# Tùy chỉnh thời gian cố định mỗi ngày để thông báo (ví dụ 8:00 sáng mỗi ngày)
- platform: time
at: "08:00:00"
condition:
- condition: template
value_template: >-
# Thông thường dữ liệu điện tiêu thụ mới nhất sẽ là của ngày trước đó,
# ví dụ hôm nay ngày 09/09/2022 thì dữ liệu mới nhất là của ngày 08/09/2022
{{ states('sensor.ten_device_cua_ban_to_date') == (now() - timedelta(days=1)).strftime('%d/%m/%Y')}}
# Nếu như ở khu vực của bạn, dữ liệu điện tiêu thụ từ EVN luôn cập nhật trễ hơn,
# xin hãy thay bằng template phía dưới, với X là số ngày trễ hơn:
# Ví dụ hôm nay là ngày 09/09/2022, dữ liệu mới nhất là của ngày 06/09/2022,
# luôn trễ hơn 3 ngày, thì X = 3.
# {{ states('sensor.ten_device_cua_ban_to_date') == (now() - timedelta(days=X)).strftime('%d/%m/%Y')}}
action:
# Tùy chình bằng service notify của bạn
- service: notify.notify
data:
title: Điện tiêu thụ @ Saigon Home
message: >
Dữ liệu ngày
{{states('sensor.ten_device_cua_ban_to_date')}}:{{'\n'}} -
Sản lượng:
{{states('sensor.ten_device_cua_ban_econ_daily_new')}}
kWh{{'\n'}} - Thành tiền:
{{'{0:_.0f}'.format(states('sensor.ten_device_cua_ban_ecost_daily_new')|int).replace('_','.')}} VNĐHiện tại, sau khi đã thiết lập, các thông số của công cụ chưa thể chỉnh sửa, có thể tính năng này sẽ được cập nhật trong tương lai, hoặc có thể không.
Tuy nhiên, những thông số này "có vẻ như" sẽ không cần phải chỉnh sửa, hiện tại đã được gán mặc định như bên dưới.
Do thiếu sự đồng bộ về các khái niệm chỉ số điện năng giữa các chi nhánh và tổng công ty EVN, các sensors sẽ được thống nhất như bên dưới:
-
Ngày tạm chốt: là ngày đã có đầy đủ các thông tin về điện năng tiêu thụ - (theo lý thuyết) được tính từ 00:00 đến 23:59 của ngày đó (khác đối với EVNCPC).
-
Ngày đầu kì: là ngày đầu tiên trong hóa đơn điện tiêu thụ hàng tháng (xem hóa đơn của các kì trước để biết).
-
Chỉ số tạm chốt: là chỉ số được lấy khi kết thúc ngày tạm chốt.
-
Chỉ số đầu kì: là chỉ số được lấy khi bắt đầu ngày đầu kì.
-
2 sensors Sản lượng ngày: tích hợp tính năng Dynamic Name*, là sản lượng điện tiêu thụ được tính (theo lý thuyết) từ 00:00 đến 23:59 của ngày hôm đó (khác đối với EVNCPC).
Dynamic Name*: entities sẽ tự động thay đổi tên trên giao diện UI dựa trên thời điểm của dữ liệu đó, ví dụ dữ liệu tạm chốt được lấy ngày hôm qua thì sensor ngày tạm chốt sẽ có tên được thể hiện trên UI là Sản lượng hôm qua
-
Sản lượng tháng: là sản lượng điện tiêu thụ được tính (theo lý thuyết) từ 00:00 của ngày đầu kì đến 23:59 của ngày tạm chốt (khác đối với EVNCPC).
Để thuận tiện hơn trong việc theo dõi điện tiêu thụ hàng ngày (ví dụ ước lượng số tiền điện mình sử dụng trong ngày). 2 sensors bên dưới chỉ mang tính chất tham khảo, không được lấy trực tiếp từ dữ liệu EVN, mà được tính theo giá bán lẻ bên dưới nên khả năng sai số là rất cao*
-
Các sensors tiền điện ngày: được tính từ các sensors sản lượng ngày.
-
Tiền điện tháng: được tính từ sản lượng tháng.
Mặc dù có nhiều loại biểu giá tùy vào mục đích sử dụng điện, nhưng dự án này sẽ mặc định tính giá tiền điện theo biểu giá bán lẻ của nhóm đối tượng Sinh Hoạt.
Truy cập link này để xem biểu giá bán lẻ tiền điện của EVN.
6 tiếng là chu kì mặc định giữa các lần cập nhật dữ liệu điện năng tiêu thụ từ EVN.
Việc cập nhật dữ liệu theo chu kì, không cố định 1 mốc thời gian cụ thể, lí do là:
- Để các sensors luôn cập nhật được dữ liệu mới nhất từ EVN.
- Thời điểm cập nhật dữ liệu điện năng của hơn 400 chi nhánh EVN toàn quốc là không cố định.
-
Anh Pham Dinh Hai, anh Huynh Nhat và anh Dương Thanh Bắc, vì đã tin tưởng, cung cấp thông tin tài khoản EVNHANOI, EVNNPC và EVNCPC, nhờ vậy tác giả đã có đủ điều kiện cần thiết để hỗ trợ cho khu vực Hà Nội, miền Bắc và miền Trung Việt Nam.
-
Anh Hoang Tung V, vì những đóng góp và hỗ trợ cực kì nhiệt tình.
Không có những người kể trên, repo
nestup_evnsẽ không ở đây, trở thành một dự án open-source tới cộng đồng HA Việt Nam.
Lời cuối, tác giả cũng muốn tự cảm ơn bản thân vì đã tạo ra integration này dành cho tất cả mọi người.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent