gPlugM integration in Home Assistant

Manufacter
https://gplug.ch/produkte/gplugm/

Flash to ESPHome

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv esphome --python 3.12
uv venv esphome
source esphome/bin/activate
uv pip install tornado esptool esphome

# backup
esptool.py --chip esp32c3 --port /dev/ttyACM0 --baud 460800 read_flash 0 ALL gplugm_full_backup.bin

# flash over tty
esphome run --device /dev/ttyACM0 gPlugM.yml 

# flash over ota
esphome run gPlugM.yml --device 192.168.178.x
<code>

<strong>Installation</strong>
https://gplug.ch/installationsanleitung/gplugmt/

<strong>configuration.yaml</strong>
https://gplug.ch/blog/integration-gplugm-in-home-assistant/
https://gplug.ch/blog/integration-gplug-in-home-assistent/
<code>
homeassistant:
  customize_glob:
    sensor.gplugm_z_ei:
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing
      last_reset: 1970-01-01T00:00:00+00:00
    sensor.gplugm_z_ei1:
      unit_of_measurement: "kWh"
    sensor.gplugm_z_ei2:
      unit_of_measurement: "kWh"
    sensor.gplugm_z_eo:
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing
      last_reset: 1970-01-01T00:00:00+00:00
    sensor.gplugm_z_eo1:
      unit_of_measurement: "kWh"
    sensor.gplugm_z_eo2:
      unit_of_measurement: "kWh" 
    sensor.gplugm_z_i1:
      unit_of_measurement: "A"
    sensor.gplugm_z_i2:
      unit_of_measurement: "A"
    sensor.gplugm_z_i3:
      unit_of_measurement: "A"
    sensor.gplugm_z_v1:
      unit_of_measurement: "V"
    sensor.gplugm_z_v2:
      unit_of_measurement: "V"
    sensor.gplugm_z_v3:
      unit_of_measurement: "V"
    sensor.gplugm_z_pi:
      unit_of_measurement: "kW"
    sensor.gplugm_z_po:
      unit_of_measurement: "kW"

utility_meter:
  energy_in_daily:
    source: sensor.gplugm_z_ei
    cycle: daily
  energy_in_weekly:
    source: sensor.gplugm_z_ei
    cycle: weekly
  energy_in_monthly:
    source: sensor.gplugm_z_ei
    cycle: monthly
  energy_in_yearly:
    source: sensor.gplugm_z_ei
    cycle: yearly

Tasmota Smart Meter Interface

ESP8266 / ESP32 Tasmota images and decumentation
https://ottelo.jimdofree.com/stromz%C3%A4hler-auslesen-tasmota/#Downloads
https://www.wispr-shop.de/produkt/wifi-ir-schreib-lesekopf-diy-set/

Smart Meter Interface configruation scripts
https://tasmota.github.io/docs/Smart-Meter-Interface/#emh-ehz-generation-k-sml

>D
>B

=>sensor53 r
>M 1
+1,3,s,0,9600,
1,77070100010800ff@1000,Total consumption,kWh,total_in,2
1,77070100020800ff@1000,Total feed-in,kWh,total_out,2
1,77070100100700ff@1,Power,W,power_curr,0
#

Tasmota Diagramme
https://github.com/ottelo9/tasmota-sml-script/

Tasmota Script Language Support
https://marketplace.visualstudio.com/items?itemName=StefanoBertini.tasmota-script-support#Automatic-script-upload

Firmware
https://github.com/ottelo9/tasmota-sml-images/releases

Install Home Assistant on Raspberry Pi

Install Home Assistant on Raspberry Pi
https://www.home-assistant.io/installation/raspberrypi/

# Install rpi-imager
sudo apt install rpi-imager

rpi-imager

# Create Homeassistant SD-Card
# Other specific-purpose OS > Home assistants and home Automation > Home Assistant OS

# Connect to HA
http://YOUR_HOME_ASSISTANT_IP:8123/

# Create Home Assistant account

# Install SSH plugin in Add-on-Store
http://YOUR_HOME_ASSISTANT_IP:8123/hassio/addon/core_ssh/info

# Open SSH Web CLI
http://YOUR_HOME_ASSISTANT_IP:8123/hassio/ingress/core_ssh

# get wifi data from workstation
WIFI_SSID="$(nmcli dev wifi show-password | grep SSID | cut -d' ' -f2-)" 
WIFI_PASS="$(nmcli dev wifi show-password | grep Pass | cut -d' ' -f2-)"
echo ha network update wlan0 \
  --ipv4-method auto \
  --wifi-auth wpa-psk \
  --wifi-mode infrastructure \
  --wifi-ssid \'${WIFI_SSID}\' \
  --wifi-psk \'${WIFI_PASS}\'

# paste output to SSH online console 

# debug
ha network info

Enable SSH key to hypervisor (Raspberry Pi)
https://community.home-assistant.io/t/howto-how-to-access-the-home-assistant-os-host-itself-over-ssh/263352/6

#@homeassistant online console
curl https://github.com/foo.keys >> /root/authorized_keys 
systemctl enable --now dropbear
ssh root@YOUR_HOME_ASSISTANT_IP -p 22222

Backup
https://www.home-assistant.io/common-tasks/general/#backups

ls -l /mnt/data/supervisor/backup/

ha backups new

# copy files over SSH
ssh root@homeassistant.local 'for f in /mnt/data/supervisor/backup/*.tar; do printf "%s\n" "$f"; done' | while read -r f; do
   ssh -n root@homeassistant.local "cat \"$f\"" > "$(basename "$f")"; 
done

Home Assistant MQTT

Install MQTT broker (server) on Anroid
https://apkpure.com/mqtt-broker-app/server.com.mqtt/download

Create MQTT sensor
https://www.home-assistant.io/integrations/sensor.mqtt/

~/.homeassistant/configuration.yaml
/mnt/data/supervisor/homeassistant/configuration.yaml (on Raspery PI)

...
mqtt: !include inverter.yaml

~/.homeassistant/inverter.yaml

sensor:
sensor:
  - name: "All inverter AC power"       
    unique_id: "inverter_total_ac_power"
    state_topic: "inverter/total/P_AC"
    unit_of_measurement: "W"
  - name: "All inverter yield day"        
    unique_id: "inverter_total_yield_day"    
    state_topic: "inverter/total/YieldDay"
    unit_of_measurement: "Wh"

  - name: "Inverter AC Power"
    unique_id: "inverter_ac"
    state_topic: "inverter/HM/ch0/P_AC"
    unit_of_measurement: "Wh"
    device_class: "energy"
    state_class: "measurement"
  - name: "Inverter DC Power"
    unique_id: "inverter_dc"
    state_topic: "inverter/HM/ch0/P_DC"
    unit_of_measurement: "W"
    state_class: "measurement"
  - name: "Inverter DC Volt CH1"
    unique_id: "inverter_dc_volt_ch1"
    state_topic: "inverter/HM/ch1/U_DC"
    unit_of_measurement: "V"
    state_class: "measurement"
  - name: "Inverter DC Current CH1"
    unique_id: "inverter_dc_current_ch1"
    state_topic: "inverter/HM/ch1/I_DC"
    unit_of_measurement: "A"
    state_class: "measurement"
  - name: "Inverter DC Power CH1"
    unique_id: "inverter_dc_ch1"
    state_topic: "inverter/HM/ch1/P_DC"
    unit_of_measurement: "W"
    state_class: "measurement"

  - name: "Inverter DC Volt CH2" 
    unique_id: "inverter_dc_volt_ch2"
    state_topic: "inverter/HM/ch2/U_DC"  
    unit_of_measurement: "V"            
    state_class: "measurement"
  - name: "Inverter DC Current CH2"
    unique_id: "inverter_dc_current_ch2"
    state_topic: "inverter/HM/ch2/I_DC"      
    unit_of_measurement: "A"           
    state_class: "measurement"  
  - name: "Inverter DC Power CH2"
    unique_id: "inverter_dc_ch2"
    state_topic: "inverter/HM/ch2/P_DC"
    unit_of_measurement: "W"
    state_class: "measurement"
  - name: "Inverter Yield Day"
    unique_id: "inverter_yield_day"
    state_topic: "inverter/HM/ch0/YieldDay"
    unit_of_measurement: "Wh"
  - name: "Inverter Yield Total"
    unique_id: "inverter_yield_total"
    state_topic: "inverter/HM/ch0/YieldTotal"
    unit_of_measurement: "kWh"
    device_class: "energy"
    state_class: "measurement"
  - name: "Inverter Temperature"
    unique_id: "inverter_temperature"
    state_topic: "inverter/HM/ch0/Temp"
    unit_of_measurement: "°C"
    icon: "mdi:thermometer"

Install mosquitto (MQTT broker) on Raspery PI OS as docker container

Node-RED

https://nodered.org/

Termux (run Node-RED on Android)
https://nodered.org/docs/getting-started/android
https://github.com/termux/termux-app

# Install termux
https://github.com/termux/termux-app/releases/download/v0.118.0/termux-app_v0.118.0+github-debug_armeabi-v7a.apk

pkg upgrade
pkg install openssh
whoami
passwd

ssh u0_a114@192.168.178.222 -p 8022
~ $ echo  "ssh-rsa xxxxx" >> ~/.ssh/authorized_keys 

apt update
apt dist-upgrade
apt install -y vim
apt install -y coreutils
#apt install -y nodejs
#apt install -y termux-api
npm install -g node-red

node-red &

npm i node-red-node-ui-table node-red-dashboard

http://192.168.178.222:1880/

Links
https://nodered.org/docs/getting-started/android

Home Assistant

Install Home Assistant as Docker container
https://www.home-assistant.io/installation/linux#platform-installation

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Europe/Berlin \
  -v homeassistant:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

# volume path
# /var/lib/docker/volumes/homeassistant

Configure
http://127.0.0.1:8123

Install HACS

sudo docker exec -it homeassistant bash
wget -O - https://get.hacs.xyz | bash -

HACS addons
https://github.com/thomasloven/lovelace-auto-entities - auto-entities (Automatically populate lovelace cards with entities matching certain criteria)
https://github.com/siku2/hass-srf-weather - SRF Weather Home Assistant Integration

Addons / Plugins
LocaTuya: https://github.com/rospogrigio/localtuya/

custom_zha_quirks
https://smarthomescene.com/reviews/tuya-zigbee-single-clamp-energy-meter-review/

sudo docker exec -it homeassistant bash
mkdir /config/custom_zha_quirks
cd /config/custom_zha_quirks
#wget https://raw.githubusercontent.com/zigpy/zha-device-handlers/dev/zhaquirks/tuya/ts0601_din_power.py
wget https://github.com/zigpy/zha-device-handlers/files/11401270/ts0601_din_power.zip
unzip ts0601_din_power.zip 
rm -r __pycache__ ts0601_din_power.zip

cat<>/config/configuration.yaml
zha:
  enable_quirks: true
  custom_quirks_path: /config/custom_zha_quirks
EOF

# Restart Home Assistant
Developer Tools > Restart > Restart Home Assistant

Docker update

sudo docker pull ghcr.io/home-assistant/home-assistant:stable
sudo docker stop homeassistant
sudo docker rename homeassistant homeassistant.$(date -I)
sudo docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=MY_TIME_ZONE \
  -v /PATH_TO_YOUR_CONFIG:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

Dashboard
https://www.home-assistant.io/dashboards/

API

Zigbee / SmartHome

Devices
https://zigbee.blakadder.com/search.html

ZHA (Zigbee Home Automation)
https://www.home-assistant.io/integrations/zha/#known-working-zigbee-radio-modules
https://www.home-assistant.io/integrations/zha/

Aubess Power Monitor Switch 16A Switch Module BK7231N (BL0942)
https://www.elektroda.com/rtvforum/topic3912748.html
https://templates.blakadder.com/aubess_power_monitor_switch.html
https://www.elektroda.com/rtvforum/topic3951016.html
https://openbekeniot.github.io/webapp/devicesList.html
https://www.elektroda.com/rtvforum/topic3895572.html#20033093
https://www.elektroda.com/rtvforum/topic3912748.html
https://www.elektroda.com/rtvforum/topic3887748.html#20266899
https://github.com/openshwprojects/OpenBK7231T_App
https://github.com/tuya-cloudcutter/tuya-cloudcutter
https://www.youtube.com/@elektrodatv
https://www.elektroda.com/rtvforum/topic3887748-90.html
https://newreleases.io/project/github/openshwprojects/OpenBK7231T_App/release/1.14.119
https://github.com/openshwprojects/BK7231GUIFlashTool

Tuya
Login: https://iot.tuya.com/
API Explorer: https://eu.iot.tuya.com/cloud/explorer
Service / License: https://www.tuya.com/vas/commodity/IOT_CORE_V2
www.tuya.com/vas/user/service

custom ZHA quirks
https://smarthomescene.com/reviews/tuya-zigbee-single-clamp-energy-meter-review/?unapproved=4798&moderation-hash=ece87e207d73a3452151608ea851834d#comment-4798
https://github.com/zigpy/zha-device-handlers/issues/1973#issuecomment-1668617636

ZG-204ZV HOBEIAN
https://gist.github.com/vinzent/2cd645b848fd3b6a0c3e5762956ec89f#file-zg-204zm-py

homebridge 

cat < docker-compose.yml 
version: '2'
services:
  homebridge:
    image: oznu/homebridge:latest
    restart: always
    network_mode: host
    volumes:
      - ./volumes/homebridge:/homebridge
    logging:
      driver: json-file
      options:
        max-size: "10mb"
        max-file: "1"
EOF

sudo docker-compose up -d

Setup
http://localhost:8581

Tuya
https://github.com/0x5e/homebridge-tuya-platform

npm install @0x5e/homebridge-tuya-platform

Yamaha
https://github.com/cgierke/homebridge-musiccast

Links
https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Docker

smarthome