Kết Nối Xe Điện VinFast với Home Assistant: Hướng Dẫn Từ A-Z

Tại Sao Cần Kết Nối Xe VinFast Với Home Assistant?

Nếu bạn đang sở hữu một chiếc xe điện VinFast (VF e34, VF 3, VF 5, VF 6, VF 7, VF 8, hoặc VF 9) và đồng thời là một tín đồ của home automation, bạn có thể đã từng mong muốn:

• Theo dõi trạng thái xe trong thời gian thực ngay trên dashboard nhà thông minh
• Nhận cảnh báo tự động khi áp suất lốp thấp hoặc pin sắp hết
• Xem các thông số bị ẩn bởi ứng dụng VinFast chính thức (đặc biệt với xe đời cũ)
• Tích hợp với các automation khác (ví dụ: bật điều hòa xe trước khi ra khỏi nhà)

Bài viết này sẽ hướng dẫn bạn từng bước để biến giấc mơ đó thành hiện thực.

Những Gì Bạn Sẽ Đạt Được

Sau khi hoàn thành hướng dẫn này, bạn sẽ có:

✅ Dashboard theo dõi xe hiển thị:
- Mức pin và quãng đường còn lại
- Trạng thái sạc
- Số ODO (tổng quãng đường đã đi)
- Áp suất lốp 4 bánh
- Nhiệt độ trong xe
- Trạng thái cửa/khóa/cốp/nắp capo

✅ Các automation thông minh:
- Cảnh báo khi áp suất lốp < 30 PSI
- Thông báo khi pin dưới 20%
- Tự động bật điều hòa xe trước khi đi làm

✅ Truy cập các thông số ẩn mà ứng dụng VinFast không hiển thị

Yêu Cầu Trước Khi Bắt Đầu

Phần Cứng

• Home Assistant đã cài đặt và hoạt động (Raspberry Pi, Mini PC, hoặc VM)
• Xe điện VinFast thuộc các dòng được hỗ trợ
• Tài khoản VinFast đã kích hoạt và có thể đăng nhập ứng dụng

Kiến Thức Cơ Bản

• Biết cách truy cập Home Assistant qua web browser
• Có thể copy/paste lệnh vào terminal (sẽ hướng dẫn chi tiết)

Không cần biết code - mọi thứ đều có script tự động!

Phần 1: Cài Đặt Plugin VinFast

Bước 1.1: Cài Đặt HACS (Home Assistant Community Store)

HACS là "kho ứng dụng" cho Home Assistant, giúp bạn cài đặt các plugin cộng đồng dễ dàng.

Nếu Bạn Chưa Có HACS:

1. Cài Terminal & SSH add-on:
2. Vào Settings → Add-ons → Add-on Store
3. Tìm "Terminal & SSH", nhấn Install → Start
4. (Mẹo: Bật "Show in sidebar" để dễ truy cập)
5. Tạo tài khoản GitHub (nếu chưa có):
6. Truy cập github.com/join và đăng ký miễn phí
7. Cài HACS:
8. Mở Terminal vừa cài ở bước 1
9. Copy và paste lệnh sau:
   bash wget -O - https://get.hacs.xyz | bash
10. Đợi chạy xong (khoảng 1-2 phút)
11. Khởi động lại Home Assistant: Settings → System → Restart
12. Kích hoạt HACS:
13. Sau khi khởi động lại, vào Settings → Devices & Services → Add Integration
14. Tìm "HACS" và nhấn vào
15. Tích chọn tất cả các ô xác nhận → Submit
16. Copy mã code hiển thị
17. Nhấn vào link GitHub → Đăng nhập → Authorize cho HACS
18. Xong! (Nếu chưa thấy HACS ở sidebar, thử xóa cache trình duyệt)

Bước 1.2: Cài VinFast Plugin Qua HACS

1. Mở HACS từ sidebar
2. Chọn tab Integrations
3. Nhấn vào icon 3 chấm (góc trên phải) → Custom repositories
4. Trong cửa sổ popup:
- Repository: Dán link https://github.com/leolionart/vinfast
- Category: Chọn Integration
- Nhấn Add
5. Bây giờ tìm "VinFast Connected Car" trong danh sách HACS
6. Nhấn Download → Download lần nữa để xác nhận
7. Khởi động lại Home Assistant một lần nữa

Bước 1.3: Cấu Hình Tích Hợp VinFast

1. Vào Settings → Devices & Services
2. Nhấn + Add Integration (góc dưới phải)
3. Tìm kiếm "VinFast"
4. Nhập thông tin:
5. Email: Email tài khoản VinFast của bạn
6. Password: Mật khẩu
7. Region: Chọn khu vực (thường là Vietnam)
8. Nhấn Submit

Lưu ý khi đăng nhập ở đây sẽ đá tài khoản của bạn ra khỏi ứng dụng Vinfast trên điện thoại, nên sử dụng tài khoản của lái phụ để tránh phiền phức nhé

Nếu thông tin đúng, xe của bạn sẽ xuất hiện như một thiết bị mới!

Phần 2: Xây Dựng Dashboard Giám Sát Xe

Bây giờ đến phần thú vị - tạo giao diện trực quan để theo dõi xe.

Bước 2.1: Cài Custom Cards (Bắt Buộc)

Dashboard đẹp cần 3 custom cards này:

1. Mở HACS → tab Frontend
2. Nhấn + Explore & Download Repositories
3. Tìm và cài đặt lần lượt:
4. button-card
5. layout-card
6. card-mod
7. Khởi động lại Home Assistant

Bước 2.2: Chạy Trình Tạo Dashboard Tự Động

Plugin VinFast đi kèm một script thông minh để tự động tạo dashboard cho bạn.

1. Mở Terminal (từ sidebar)
2. Di chuyển đến thư mục plugin:
bash cd /config/custom_components/vinfast
3. Chạy script:
bash python3 setup_dashboard.py
4. Trả lời các câu hỏi:
- Entity Prefix: Nhập tiền tố entity của xe (ví dụ: nếu bạn thấy sensor.vf8_battery, gõ vf8)
- Choice:
- Gõ 1 cho Full Wall Panel (dashboard toàn màn hình, phong cách glassmorphism đẹp mắt)
- Gõ 2 cho Simple Card (thẻ nhỏ gọn để thêm vào dashboard hiện có)

1. Script sẽ tạo file YAML (ví dụ: my_vinfast_dashboard.yaml)

Bước 2.3: Thêm Vào Home Assistant

Với Simple Card:

1. Cài add-on File Editor (từ Add-on Store) để dễ mở file
2. Mở file YAML vừa tạo, copy toàn bộ nội dung
3. Vào Dashboard → Edit Dashboard → Add Card
4. Kéo xuống chọn Manual
5. Paste nội dung vào → Save

Với Full Wall Panel:

1. Vào Dashboard → Edit Dashboard → icon 3 chấm → Raw Configuration Editor
2. Paste nội dung file YAML vào (hoặc tạo View mới kiểu "Panel")

Kết quả: Bạn sẽ thấy một dashboard hiển thị đầy đủ:
- Mức pin và % còn lại
- Quãng đường có thể đi (km)
- Trạng thái sạc (đang sạc/không sạc)
- ODO tổng
- Áp suất 4 lốp
- Nhiệt độ trong xe
- Icon cửa/khóa/cốp/nắp capo (mở/đóng)

Phần 3: Thiết Lập Automation Thông Minh

Bây giờ chúng ta sẽ tạo các automation để xe "tự động báo cáo" khi có vấn đề.

Automation 1: Cảnh Báo Áp Suất Lốp Yếu

Áp suất lốp thấp là nguyên nhân hàng đầu gây nguy hiểm và tốn điện. Hãy để Home Assistant theo dõi giúp bạn.

1. Vào Settings → Automations & Scenes → Create Automation
2. Chọn Start with an empty automation
3. Cấu hình như sau:

Trigger (Điều kiện kích hoạt):
- Nhấn Add Trigger → Numeric state
- Entity: sensor.vf8_tire_pressure_front_left (thay vf8 bằng tiền tố của bạn)
- Below: 30 (PSI)
- For: 5 minutes (tránh cảnh báo nhầm do dao động tạm thời)

Action (Hành động):
- Nhấn Add Action → Notify
- Chọn dịch vụ notify (ví dụ: notify.mobile_app_iphone)
- Message:
⚠️ Cảnh báo: Lốp trước trái xe {{ state_attr('sensor.vf8_device_name', 'friendly_name') }} có áp suất thấp ({{ states('sensor.vf8_tire_pressure_front_left') }} PSI). Vui lòng kiểm tra!

1. Lặp lại cho 3 lốp còn lại (front_right, rear_left, rear_right)

Automation 2: Nhắc Sạc Pin Khi Về Nhà

Tự động nhắc bạn cắm sạc nếu pin dưới 30% khi về đến nhà.

Trigger:
- Device: Điện thoại của bạn enters zone Home

Condition (Điều kiện):
- Entity: sensor.vf8_battery
- State: below 30

Action:
- Notify:
🔋 Pin xe chỉ còn {{ states('sensor.vf8_battery') }}%. Nhớ cắm sạc nhé!

Automation 3: Bật Điều Hòa Trước Khi Đi Làm

(Yêu cầu đã pairing xe với Home Assistant - xem mục Troubleshooting)

Trigger:
- Time: 7:00 AM (Thứ 2 - Thứ 6)

Condition:
- Nhiệt độ ngoài trời > 28°C (tùy chọn)

Action:
- Service: switch.turn_on
- Target: switch.vf8_air_conditioning

Bạn có câu hỏi hoặc gặp khó khăn? Để lại comment bên dưới, mình sẽ hỗ trợ! 💬

Bài viết hữu ích? Chia sẻ cho anh em chủ xe VinFast khác nhé! 🚗⚡