Beta V 0.5 published 26 Aug 2024
This is a solution to locally integrate Emporia Vue V2 and V3 power monitoring into Hubitat. It is currently an early Alpha version of the files. The existing files only support Vue2 devices right now. V3 support will come later.
If you have wandered here on your own, be aware integrating Emporia Vue devices locally to Hubitat is an extremely non-trivial process. This requires reprogramming the Vues you want to integrate. OPENING AND REPROGRAMMING YOUR VUE COULD VOID YOUR EMPORIA WARRANTY!!!
The use of these files and process is at your own risk. There is no warranty either expressed or implied.
To perform this process you will need the following items:
-
Python installed python on your computer. Use the latest version that is in bugfix Maintenance status, 3.12.5 as I write this. Python Downloads
-
ESPHome installed on the same computer. -> Installing ESPHome Manually
-
USB Serial adapter to connect your PC and your Vue-> DSD TECH SH-U09B3 USB Type C to TTL Serial Adapter with CP2102N Chip
(There are others you can get, but if you intend to use a V3 Vue you will need a Serial adapter that outputs 3.3V.) -
Female-Female dupont jumper wires. You will use these to connect the USB serial adapter to your Vue. 40 PCS 20 CM (8 inch) Breadboard Jumper Wires Wire Length Optional Dupont Cable Assorted Kit Female to Female Multicolored Ribbon Cables
-
Jonathan Bradshaw's ESPHome-API-Library saved in the Library Code page of the Hubitat hub you will use. Create a new file in Library Code. Import the code using following link and save it -> https://raw.githubusercontent.com/bradsjm/hubitat-drivers/main/ESPHome/ESPHome-API-Library.groovy
Here is a detailed description of how to reprogram your Vue V2. Setting up Emporia Vue 2 with ESPHome
Here are the jumper connection to make. They are a little different than digiblurDIY shows, however he does list these as options if your adapter has the connections available.
USB Serial Adapter <--> Vue
TXD <--> TXD
RXD <--> RXD
GND <--> GND
DTR <--> IO0
DSR <--> EN
3V3 <--> VCC 3V3
digiblurDIY created his process to support Home Assistant and MQTT. Ignore those references for this Hubitat implementation. There are changes I made to the yaml file that may/will break its ability to support HA and MQTT. It is not my intent to support those.
The driver files have been coded expecting the yaml to be fundamentally unchanged with the exception of the "substitutions" section. Naming of the individual circuits MUST be performed in the Hubitat devices that are created by this process. Changing the circuit names in the yaml file will break the solution.
Panelboards typically have more circuits that one Vue can monitor, so I devleoped this with the panelboard as the device that is directly installed by the user. Within the Panelboard the individual Vue devices and thier branch circuits can be created. Installing the Vue directly may or may not work. I haven't tested this use, and I do not intend to suport that.
This is a portion of the substitutions section of the yaml file that will need to be checked and updated.
The installation of Vues for a panelboard begins with the installation of the panelboard device.
The next step is adding the Vues to the panelboard. This will automatically add sixteen branch circuit devices as child devices of the Vue.
This is how the various devices will look when installed.
