# Smart Home

# Hardware

Smart home hardware.

# OSRAM Smart+ Classic E27 Tunable White

[![osram_smart_bulb.png](https://bookstack.greinet.com/uploads/images/gallery/2021-11/scaled-1680-/osram-smart-bulb.png)](https://bookstack.greinet.com/uploads/images/gallery/2021-11/osram-smart-bulb.png)**Specs**

- Communication: ZigBee
- Socket: E27
- Power consumption: 8.5W
- Color temperature range: 2700K - 6500K
- Lifespan: 15.000h
- Operation temperature: -20°C - 40°C

---

**Available parameters**

```
{
   "Device":"0xEC24",
   "Name":"osram2",
   "Hue":0,
   "Sat":0,
   "X":24939,
   "Y":24701,
   "CT":370,
   "ColorMode":2,
   "RGB":"FFFFFF",
   "RGBb":"FFFFFF",
   "Endpoint":3,
   "LinkQuality":97
}
```

<table border="1" id="bkmrk-parameter-descriptio" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 25%;">**Parameter**</td><td style="width: 25%;">**Description**</td><td style="width: 50%;">**Possible values**</td></tr><tr><td style="width: 25%;">CT</td><td style="width: 25%;">Color temperature</td><td style="width: 50%;">153 - 500 (Warm: 500, Normal: 370, Cold: 153)</td></tr></tbody></table>

# ESP32

### ESP-WROOM-32 (38pin)

[![ESP32-38 PIN-DEVBOARD.png](https://bookstack.greinet.com/uploads/images/gallery/2022-09/scaled-1680-/esp32-38-pin-devboard.png)](https://bookstack.greinet.com/uploads/images/gallery/2022-09/esp32-38-pin-devboard.png)

[![doc-esp32-pinout-reference-wroom-devkit.png](https://bookstack.greinet.com/uploads/images/gallery/2022-09/scaled-1680-/doc-esp32-pinout-reference-wroom-devkit.png)](https://bookstack.greinet.com/uploads/images/gallery/2022-09/doc-esp32-pinout-reference-wroom-devkit.png)

# ESP8266

#### FTDI Programmer

[![esp8266-ftdi-programmer-connection.jpg](https://bookstack.greinet.com/uploads/images/gallery/2022-10/scaled-1680-/esp8266-ftdi-programmer-connection.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2022-10/esp8266-ftdi-programmer-connection.jpg)

# Sonoff ZBridge

Sonoff Zigbee to Wifi bridge

# Sonoff ZbBridge Rules

```
Rule1 
	on ZbReceived#osram1#Power  do publish stat/andreas/zigbee/osram1/power  %value% endon  	
	on ZbReceived#osram1#Dimmer do publish stat/andreas/zigbee/osram1/dimmer %value% endon 	
	on ZbReceived#osram2#Power  do publish stat/andreas/zigbee/osram2/power  %value% endon  	
	on ZbReceived#osram2#Dimmer do publish stat/andreas/zigbee/osram2/dimmer %value% endon 	
	on ZbReceived#osram3#Power  do publish stat/andreas/zigbee/osram3/power  %value% endon  	
	on ZbReceived#osram3#Dimmer do publish stat/andreas/zigbee/osram3/dimmer %value% endon 	
	on ZbReceived#osram4#Power  do publish stat/andreas/zigbee/osram4/power  %value% endon  	
	on ZbReceived#osram4#Dimmer do publish stat/andreas/zigbee/osram4/dimmer %value% endon
```

```
Rule2 
	on ZbReceived#sonoff_door_sensor#Contact do publish stat/andreas/zigbee/sonoff_door_sensor/open %value% endon  	 	 	
	on ZbReceived#light_sensor#Illuminance do publish stat/andreas/zigbee/light_sensor/illuminance %value% endon  	 	 	
	on ZbReceived#temp_sensor_outdoor#Temperature do publish stat/andreas/zigbee/temp_sensor_outdoor/temperature %value% endon  	 	 	
	on ZbReceived#temp_sensor_outdoor#Humidity do publish stat/andreas/zigbee/temp_sensor_outdoor/humidity %value% endon  	 	 	
	on ZbReceived#temp_sensor_outdoor#Pressure do publish stat/andreas/zigbee/temp_sensor_outdoor/pressure %value% endon  	 	
	on ZbReceived#temp_sensor_indoor#Temperature do publish stat/andreas/zigbee/temp_sensor_indoor/temperature %value% endon  	 	 	
	on ZbReceived#temp_sensor_indoor#Humidity do publish stat/andreas/zigbee/temp_sensor_indoor/humidity %value% endon   	 	 	
	on ZbReceived#temp_sensor_indoor#Humidity do publish stat/andreas/zigbee/temp_sensor_indoor/humidity %value% endon   
```

```
Rule3
	on ZbReceived#sonoff_small_button_1#Power do publish stat/andreas/zigbee/sonoff_small_button_1/click %value% endon
	on ZbReceived#aqara_big_button_1#Click do publish stat/andreas/zigbee/aqara_big_button_1/click %value% endon
	on ZbReceived#aqara_button_1#Click do publish stat/andreas/zigbee/aqara_button_1/click %value% endon
	on ZbReceived#aqara_button_2#Click do publish stat/andreas/zigbee/aqara_button_2/click %value% endon
	on ZbReceived#aqara_button_3#Click do publish stat/andreas/zigbee/aqara_button_3/click %value% endon
	on ZbReceived#aqara_button_4#Click do publish stat/andreas/zigbee/aqara_button_4/click %value% endon
```

# Sonoff ZbBridge Commands

**ZbName**

This command can be used to give nicknames to the zigbee devices to be used instead of their HEX-value names.

Example:

```
ZbName 0x8C19,osram_bulb
```

This gives the nickname *osram\_bulb* to the devices identified by *0x8C19*.

**ZbSend**

With this command you can send information in JSON format to a zigbee device.

Example:

```
ZbSend {"device":"osram_bulb","Send":{"AddGroup":100}}
```

By using this command the zigbee device identified by *osram\_bulb* is added to the zigbee group 100. You can also use the HEX-value device ID instead of the nickname.

# Sensor

#### **Packaging**

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">[![sonoff-zbridge-pack-front.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sonoff-zbridge-pack-front.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sonoff-zbridge-pack-front.png)</td><td style="width: 50%;">[![sonoff-zbridge-pack-back.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sonoff-zbridge-pack-back.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sonoff-zbridge-pack-back.png)</td></tr><tr><td style="width: 50%;">[![sonoff-zbridge-pack-left.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sonoff-zbridge-pack-left.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sonoff-zbridge-pack-left.png)</td><td style="width: 50%;">[![sonoff-zbridge-pack-right.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sonoff-zbridge-pack-right.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sonoff-zbridge-pack-right.png)</td></tr></tbody></table>

#### **Documentation**

- Product Specification: [sonoff-zbbridge-product-specification.pdf](https://bookstack.greinet.com/attachments/375)
- User Manual: [sonoff-zbbridge-user-manual.pdf](https://bookstack.greinet.com/attachments/376)
- Quick Start Guide: [sonoff-zbbridge-quick-user-guide.pdf](https://bookstack.greinet.com/attachments/377)

# Sonoff ZBridge Pro



# Hardware & Manuals

#### **Packaging**

[![top.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/top.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/top.jpg)[![bottom.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/bottom.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/bottom.jpg)

[![left.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/left.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/left.jpg)

[![right.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/right.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/right.jpg)

#### **Content**

[![overview.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/overview.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/overview.jpg)

1x Quickstart Guide ([quick\_start\_guide\_zigbee\_bridge\_pro.pdf](https://bookstack.greinet.com/attachments/357))

1x Reset Pin

1x MicroUSB Cable

1x Sonoff ZigBee Bridge Pro

#### **Manuals**

- [product\_spezification\_zigbee\_bridge\_pro.pdf](https://bookstack.greinet.com/attachments/360)
- [user\_manual\_zigbee\_bridge\_pro.pdf](https://bookstack.greinet.com/attachments/361)

# Flash Tasmota

#### **Step 1: Open ZbBrige Pro**

[![zbridge bottom.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/zbridge-bottom.jpg)c](https://bookstack.greinet.com/uploads/images/gallery/2023-07/zbridge-bottom.jpg)

Remove the rubber feets by using e.g. a scalpel at the bottom and unscrew the 4 small phillips screws beneath.

#### **Step 2: Prepare board**

[![zbridge_board_top.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/zbridge-board-top.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/zbridge-board-top.png)

Solder 5 pins to the GND, GPIO0, RX,TX and 3V pinholes.

#### **Step 3: Connect USB-to-TTL adapter**

[![zbridge_ttl_adapter_connect.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/zbridge-ttl-adapter-connect.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/zbridge-ttl-adapter-connect.png)

Connect using the following layout:

<table border="1" id="bkmrk-zbbridge-usb-to-ttl-" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">**ZbBridge**</td><td style="width: 50%;">**USB-to-TTL adapter**</td></tr><tr><td style="width: 50%;">3V3</td><td style="width: 50%;">3V3

</td></tr><tr><td style="width: 50%;">TX</td><td style="width: 50%;">RX</td></tr><tr><td style="width: 50%;">RX</td><td style="width: 50%;">RX</td></tr><tr><td style="width: 50%;">GPIO0</td><td style="width: 50%;">GND</td></tr><tr><td style="width: 50%;">GND</td><td style="width: 50%;">GND</td></tr></tbody></table>

#### **Step 4: Flash Tasmota**

**<span style="text-decoration: underline;">Option 1: Webinterface</span>**

[![tasmota-web-install.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/tasmota-web-install.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/tasmota-web-install.png)

Go to the [Tasmota install website](https://tasmota.github.io/install/) and select the options T**asmota32 Sonoff-ZigbeeBridgePro** and **All**, press connect and flash the firmware.

<span style="text-decoration: underline;">**Option 2: Manual install via Tasmotizer (not verified)**</span>

<span style="text-decoration: underline;">[![tasmotizer.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/tasmotizer.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/tasmotizer.png)</span>

Download the newest version of the Tasmota firmware for Zigbee Bridge Pro and flash using the Tasmotizer application ([tasmotizer-1.2.exe](https://bookstack.greinet.com/attachments/359)).

(Used version at date of creation: [tasmota32-zbbrdgpro.bin](https://bookstack.greinet.com/attachments/358))

#### **Step 5: Flash ZigBee Coordinator**

Plug in the device and head over to the Tasmota web interface. Then continue to **Consoles** &gt; **Berry Scripting console** and input the following to very the flash files for the ZigBee Coordinator chip:

```JavaScript
import sonoff_zb_pro_flasher as cc
cc.load("SonoffZBPro_coord_20220219.hex")
cc.check()
```

After getting a positive verification response contine to flash with the following command:

```JavaScript
cc.flash()
```

Now the Tasmota will become unresponsive for approximately 5 minutes, after that yet again a positive response should appear in the console (you might need to reload the website). Then restart the Tasmota device and head into the normal console, there should be messages regarding the ZigBee device now.

#### **Step 6: Configure template**

As a last step go to **Configuration** &gt; **Auto configuration** and select and apply the **Sonoff ZBPro** configuration.

##### **Credits**

I followed [Julian Decker's installation guid](https://atlane.de/sonoff-zigbee-bridge-pro-tasmota-flashing-und-homeassistant-integration/)e closely for the most parts, so have a look there if you need more detailed information.

# Using Tasmota

#### **Pair and name devices**

Using the Tasmota web interface, press **Zigbee Permit Join** to allow new devices to be paired. Now you can pair your new device and it will show up in the list with a name like **0x8C19**<span title="0x6CAD lumi.remote.b186acn01 - LUMI">. To more easily identify the devices later on, copy the name and head to the Tasmota console. Their use the following command to set a friendly name for the device.</span>

```HTML
ZbName 0x8C19,osram_bulb
```

#### **Group devices**

You can assign a group ID (default: 0) for each device to control multiple devices simulaneously.

```
ZbSend {"device":"osram_bulb","Send":{"AddGroup":100}}
```

#### **Send values to devices**

With the console you can also control your devices by sending values manually.

```
zbsend {"device":"0x96A2","send":{"power":true}}
```

Or control a whole group of devices.

```
zbsend {"group":"100","send":{"power":true}}
```

<table border="1" id="bkmrk-device-id-name-group" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 28.7654%;">Device ID</td><td style="width: 27.4692%;">Name</td><td style="width: 18.7962%;">Group</td><td style="width: 24.9692%;">Label</td></tr><tr class="ztd htr"><td style="width: 28.7654%;"><span title="0x6CAD lumi.remote.b186acn01 - LUMI">0x6CAD</span></td><td style="width: 27.4692%;">aqara-rocker-switch-1-ZB</td><td style="width: 18.7962%;">0</td><td style="width: 24.9692%;">Aqara\_Rocker\_Switch\_Zigbee</td></tr><tr><td style="width: 28.7654%;">0x9685</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_1\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">1</td></tr><tr><td style="width: 28.7654%;">0x452B</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_2\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">2</td></tr><tr><td style="width: 28.7654%;">0x3679</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_3\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">3</td></tr><tr><td style="width: 28.7654%;">0xC5E5</td><td style="width: 27.4692%;">osram\_smartplus\_bulb\_4\_ZB</td><td style="width: 18.7962%;">100</td><td style="width: 24.9692%;">4</td></tr></tbody></table>

```C++
Rule1
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Power do Publish stat/zbridge_pro/%var1%/power "%value%" endon
on ZbReceived#?#Dimmer do Publish stat/zbridge_pro/%var1%/dimmer "%value%" endon


Rule3
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Click do publish stat/zbridge_pro/%var1%/click %value% endon
```

# Current Setup

**Device list**

<table border="1" id="bkmrk-device-id-name-group" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 28.7654%;">Device ID</td><td style="width: 27.4692%;">Name</td><td style="width: 18.7962%;">Group</td><td style="width: 24.9692%;">Label</td></tr><tr class="ztd htr"><td style="width: 28.7654%;"><span title="0x6CAD lumi.remote.b186acn01 - LUMI">0x6CAD</span></td><td style="width: 27.4692%;">aqara-rocker-switch-1-ZB</td><td style="width: 18.7962%;">0</td><td style="width: 24.9692%;">Aqara\_Rocker\_Switch\_Zigbee</td></tr></tbody></table>

**Tasmota Rules**

```C++
Rule1
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Power do Publish stat/zbridge_pro/%var1%/power "%value%" endon
on ZbReceived#?#Dimmer do Publish stat/zbridge_pro/%var1%/dimmer "%value%" endon


Rule3
on ZbReceived#?#Name do var1 %value% endon
on ZbReceived#?#Click do publish stat/zbridge_pro/%var1%/click %value% endon
```

# Sonoff ZigBee Sensors



# SNZB-01 - Wireless Switch

#### **Packaging**

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 84.6914%; height: 29px;"><tbody><tr style="height: 29px;"><td style="width: 42.7161%; height: 29px;">[![SNZB-01-packaging-front.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-01-packaging-front.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-01-packaging-front.png)</td><td style="width: 41.9753%; height: 29px;">[![SNZB-01-packaging-back.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-01-packaging-back.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-01-packaging-back.png)</td></tr></tbody></table>

#### **Sensor**

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 93.7037%;"><tbody><tr><td style="width: 32.4738%;">[![SNZB-01.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-01.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-01.png)</td><td style="width: 30.6362%;">[![SNZB-01-front.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-01-front.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-01-front.png)</td><td style="width: 30.4596%;">[![SNZB-01-back.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-01-back.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-01-back.png)</td></tr></tbody></table>

#### **Documentation**

- Product Specification: [SNZB-01-specification.pdf](https://bookstack.greinet.com/attachments/366)
- User Manual: [SNZB-01-user-manual.pdf](https://bookstack.greinet.com/attachments/367)
- Quick Start Guide: [SNZB-01-quick-guide.pdf](https://bookstack.greinet.com/attachments/368)

# SNZB-02 - Sonoff Temperature and Humidity Sensor

#### **Packaging**

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; height: 29px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">[![snzb-02-packaging-front.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-02-packaging-front.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-02-packaging-front.png)</td><td style="width: 50%; height: 29px;">[![snzb-02-packaging-back.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-02-packaging-back.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-02-packaging-back.png)</td></tr></tbody></table>

#### **Sensor**

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 96.2963%;"><tbody><tr><td style="width: 35.6789%;">[![sznb-02-sensor.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sznb-02-sensor.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sznb-02-sensor.png)</td><td style="width: 30.1234%;">[![sznb-02-sensor-front.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sznb-02-sensor-front.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sznb-02-sensor-front.png)</td><td style="width: 30.4596%;">[![sznb-02-sensor-back.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/sznb-02-sensor-back.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/sznb-02-sensor-back.png)</td></tr></tbody></table>

#### **Documentation**

- Product Specification: [SNZB-product-specification.pdf](https://bookstack.greinet.com/attachments/364)
- User Manual: [SNZB-02-user-manual.pdf](https://bookstack.greinet.com/attachments/363)
- Quick Start Guide: [SNZB-02-quick-start-guide.pdf](https://bookstack.greinet.com/attachments/365)

# SNZB-04 - Wireless Door/Window Switch

#### **Packaging**

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 84.6914%; height: 29px;"><tbody><tr style="height: 29px;"><td style="width: 42.7161%; height: 29px;">[![snzb-04-packaging-front.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-04-packaging-front.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-04-packaging-front.png)</td><td style="width: 41.9753%; height: 29px;">[![snzb-04-packaging-back.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-04-packaging-back.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-04-packaging-back.png)</td></tr></tbody></table>

#### **Sensor**

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 93.7037%; height: 29px;"><tbody><tr style="height: 29px;"><td style="width: 33.2644%; height: 29px;">[![snzb-04.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-04.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-04.png)</td><td style="width: 29.8456%; height: 29px;">[![snzb-04-side.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-04-side.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-04-side.png)</td></tr><tr><td style="width: 33.2644%;">[![snzb-04-top.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-04-top.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-04-top.png)</td><td style="width: 29.8456%;">[![snzb-04-bottom.png](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/snzb-04-bottom.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/snzb-04-bottom.png)</td></tr></tbody></table>

#### **Documentation**

- Product Specification: [SNZB-04-product-specification.pdf](https://bookstack.greinet.com/attachments/369)
- User Manual: [SNZB-04-user-manual.pdf](https://bookstack.greinet.com/attachments/370)
- Quick Start Guide: [SNZB-04-quick-start-guide.pdf](https://bookstack.greinet.com/attachments/371)

# Aqara ZigBee Sensors



# WSDCGQ11LM - Temperature and Humidity Sensor

#### **Sensor**

#### [![aqara-Temperature-and-Humidity-Sensor.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/aqara-temperature-and-humidity-sensor.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/aqara-temperature-and-humidity-sensor.jpg)

<span style="text-decoration: underline;">Model</span>  
WSDCGQ11LM

<span style="text-decoration: underline;">Battery</span>  
CR2032

<span style="text-decoration: underline;">Wireless Protocol</span>  
Zigbee

<span style="text-decoration: underline;">Dimensions</span>  
36 × 36 × 9 mm (1.42 × 1.42 × 0.35 in.)

<span style="text-decoration: underline;">Temperature Range and Precision</span>  
-20℃~+50°C, ±0.3℃ (-4℉~+122℉, ±0.5°F）

<span style="text-decoration: underline;">Humidity Range and Precision</span>  
0 – 100% RH (non-condensing), ±3%

<span style="text-decoration: underline;">Atmospheric Pressure Range and Precision</span>  
30 kPa – 110 kPa, ±0.12 kPa

#### **Documentation**

- User Manual: [Aqara Temperature and Humidity Sensor.pdf](https://bookstack.greinet.com/attachments/372)

# WSDCGQ11LM - Wireless Mini Switch

#### **Sensor**

#### [![aqara-wireless-mini-switch.jpg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/aqara-wireless-mini-switch.jpg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/aqara-wireless-mini-switch.jpg)

<span style="text-decoration: underline;">Model</span>  
WXKG11LM

<span style="text-decoration: underline;">Battery</span>  
CR2032

<span style="text-decoration: underline;">Wireless Protocol</span>  
Zigbee

<span style="text-decoration: underline;">Dimensions</span>  
45 × 45 × 12 mm (1.77 × 1.77 × 0.47 in.)

<span style="text-decoration: underline;">Operating Temperature</span>  
-10℃~+50°C

<span style="text-decoration: underline;">Operating Humidity</span>  
0 – 95% RH (non-condensing)

#### **Documentation**

- User Manual: [Aqara Wireless Mini Switch Quick Start Guide.pdf](https://bookstack.greinet.com/attachments/373)

# WXKG03LM - Wireless Remote Switch (Single Rocker)

#### **Sensor**

#### [![aqara-wireless-remote-switch-single-rocker.jpeg](https://bookstack.greinet.com/uploads/images/gallery/2023-07/scaled-1680-/aqara-wireless-remote-switch-single-rocker.jpeg)](https://bookstack.greinet.com/uploads/images/gallery/2023-07/aqara-wireless-remote-switch-single-rocker.jpeg)

<span style="text-decoration: underline;">Model</span>  
WXKG03LM

<span style="text-decoration: underline;">Battery</span>  
CR2032

<span style="text-decoration: underline;">Wireless Protocol</span>  
Zigbee

<span style="text-decoration: underline;">Dimensions</span>  
86 × 86 × 15.2 mm (3.39 × 3.39 × 0.60 in.)

<span style="text-decoration: underline;">Operating Temperature</span>  
-5℃~+50°C

<span style="text-decoration: underline;">Operating Humidity</span>  
5 – 95% RH (non-condensing)

#### **Documentation**

- User Manual: [Wireless Remote Switch (Single Rocker) Quick Start Guide.pdf](https://bookstack.greinet.com/attachments/374)

# Smart Meter

#### Socat Commands

```shell
socat PTY,raw,echo=0,link=/root/ttyVUSB0 tcp:192.168.178.46:4000
socat pty,link=$HOME/dev/ttyV0,waitslave tcp:192.168.178.46:4000
socat pty,link=/config/ttyVUSB0,nonblock,ignoreof,keepalive tcp:192.168.178.46:4000&

```

#### Nodered install dependencies

```shell
apk add --update alpine-sdk libxml2-dev libxslt-dev libffi-dev zlib-dev py-pip
```

#### Debug commands

```
stty -F /dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_0e5d3a4c7abfeb11b5ec053a65476099-if00-port0 
stty -F /dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_0e5d3a4c7abfeb11b5ec053a65476099-if00-port0 9600 -parodd cs7 -cstopb parenb -ixoff -crtscts -hupcl -ixon -opost -onlcr -isig -icanon -iexten -echo -echoe -echoctl -echoke

```

#### OBIS Kennzahlen

- [https://de.wikipedia.org/wiki/OBIS-Kennzahlen](https://de.wikipedia.org/wiki/OBIS-Kennzahlen)
- [https://www.promotic.eu/en/pmdoc/Subsystems/Comm/PmDrivers/IEC62056\_OBIS.htm](https://www.promotic.eu/en/pmdoc/Subsystems/Comm/PmDrivers/IEC62056_OBIS.htm)
- [https://onemeter.com/docs/device/obis/](https://onemeter.com/docs/device/obis/)

#### Resources

- PDFs 
    - [Gebrauchsanleitung\_LK13BE8030x9.pdf](https://bookstack.greinet.com/attachments/386)
    - [Bedienungsanleitung Logarex Zähler.pdf](https://bookstack.greinet.com/attachments/387)
- Websites 
    - [Logarex LK13B Information](https://wiki.volkszaehler.org/hardware/channels/meters/power/logarex_lk13b)
    - [Tasmota Smart Meter Interface](https://tasmota.github.io/docs/Smart-Meter-Interface/)
    - [Logarex LK13B auslesen](https://knx-user-forum.de/forum/%C3%B6ffentlicher-bereich/geb%C3%A4udetechnik-ohne-knx-eib/42090-digitale-stromz%C3%A4hler-auslesen-logarex-lk13b)
    - [Logarex LK13BE auslesen](https://www.photovoltaikforum.com/wissen/entry/52-auslesen-von-stromverbrauch-stromproduktion-strombezug-von-stromz%C3%A4hler-logarex-l/)
    - [IR Lesekopf und Raspberry PI](https://shop.weidmann-elektronik.de/media/files_public/9d73b590bf0752a5beff32d229d4497d/HowToRaspberryPi.pdf)
- Videos 
    - [https://www.youtube.com/watch?v=ZZkQDy53GcM](https://www.youtube.com/watch?v=ZZkQDy53GcM)

# Watermeter

### Wmbusmeter

##### Installation with docker

Create the *folder*/**file** structure in the data folder:

- *etc*
    - *wmbusmeter.d*
        - **Water**
    - **wmbusmeter.conf**
- *logs*

**Water**

```
name=Water
id=57740424
driver=izar
key=NOKEY
```

**wmbusmeter.conf**

```
loglevel=debug
device=rtlwmbus
listento=t1
logtelegrams=true
format=json
shell=/usr/bin/mosquitto_pub -h HOSTIP -i wmbusmeter -u USER -P PASSWORD -t wmbusmeters/$METER_ID -m "$METER_JSON"
meterfiles=/wmbusmeters_data/logs/meter_readings
meterfilesaction=overwrite
logfile=/wmbusmeters_data/logs/wmbusmeters.log
```

**docker-compose.yml**

```
version: "3.7"
services:
  wmbusmeters:
    image: weetmuts/wmbusmeters
    restart: always
    volumes:
      - /PATH/TO/FILE/data:/wmbusmeters_data
      - /etc/localtime:/etc/localtime:ro
      - /dev/:/dev/
    privileged: true
```

**Node-RED**

The extraction of the date from the single mqtt message that wmbusmeter produces is done in a Node-RED flow.

[flows.json](https://bookstack.greinet.com/attachments/53)

**Additional information**

[498133-FR-EN-IZAR-RC-868-i-W-R4.pdf](https://bookstack.greinet.com/attachments/56)

[elvjournal\_01\_2015\_komplett.pdf](https://bookstack.greinet.com/attachments/57)

# Kostal photovoltaic system

**Overview**

The Kostal photovoltaic system supports multiple API's for data extraction. For one, it offers a website with detailed statistics about the energy production. On this website you can also enable the two services Modbus and Sunspec. It seems like Sunspec is quite new and doesn't support too many data yet. Modbus on the other hand offers (nearly) all the date the system produces. The default port for the service is 1502.

Node-RED offers nodes to read modbus data and also has nodes to parse the buffer data. The information can then be inserted into for example MQTT or InfluxDB. Example-flow: [flows.json](https://bookstack.greinet.com/attachments/55).

This is the datasheet with the data addresses to be accessed in the buffer: [datasheet.pdf](https://bookstack.greinet.com/attachments/54).

**Status codes**

<table border="1" id="bkmrk-0-off" style="border-collapse: collapse; width: 100%; height: 735px;"><tbody><tr style="height: 35px;"><td style="width: 50%; height: 35px;">0</td><td style="width: 50%; height: 35px;">Off

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">1</td><td style="width: 50%; height: 35px;">Init

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">2</td><td style="width: 50%; height: 35px;">IsoMeas

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">3</td><td style="width: 50%; height: 35px;">GridCheck

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">4</td><td style="width: 50%; height: 35px;">StartUp

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">5</td><td style="width: 50%; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">6</td><td style="width: 50%; height: 35px;">FeedIn

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">7</td><td style="width: 50%; height: 35px;">Throttled

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">8</td><td style="width: 50%; height: 35px;">ExtSwitchOff

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">9</td><td style="width: 50%; height: 35px;">Update

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">10</td><td style="width: 50%; height: 35px;">Standby

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">11</td><td style="width: 50%; height: 35px;">GridSync

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">12</td><td style="width: 50%; height: 35px;">GridPreCheck

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">13</td><td style="width: 50%; height: 35px;">GridSwitchOff

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">14</td><td style="width: 50%; height: 35px;">Overheating

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">15</td><td style="width: 50%; height: 35px;">Shutdown

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">16</td><td style="width: 50%; height: 35px;">ImproperDcVoltage

</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">17</td><td style="width: 50%; height: 35px;">ESB

</td></tr><tr><td style="width: 50%;">18</td><td style="width: 50%;">Unknown

</td></tr></tbody></table>

# Sunways NT4000

The Sunways NT4000 is a solar inverter. It stores data locally, which can be retrieved via eighter a RS485 or a RS232 interface. When using multiple Sunways inverters, you can connect them to each other via the RS485 interface, so that one acts as master and handles the communication.

### RS485 Interface

This serial interface is used for communication with the inverters. With the help of for example the [HALJIA USB zu RS485 Konverter](https://www.amazon.de/RS485-Konverter-Converter-Adapter-Unterst%C2%A8%C2%B9tzung/dp/B06Y1JTGZX/ref=sr_1_5?__mk_de_DE=%C3%85M%C3%85%C5%BD%C3%95%C3%91&crid=3D1KW5V0ERBP4&keywords=usb+rs+485&qid=1644772202&s=ce-de&sprefix=usb+rs+485%2Celectronics%2C106&sr=1-5) you can connect the inverters to your computer or Raspberry Pi. For me I could only communicate via RS485 when the inverters where actually receiving solar power.

[![USB_to_RS485.png](https://bookstack.greinet.com/uploads/images/gallery/2022-02/scaled-1680-/usb-to-rs485.png)](https://bookstack.greinet.com/uploads/images/gallery/2022-02/usb-to-rs485.png)

### Settings for the Interface

<table border="1" id="bkmrk-baud-rate-9600-data-" style="border-collapse: collapse; width: 100%; height: 209px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Baud rate</td><td style="width: 50%; height: 29px;">9600</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Data bits</td><td style="width: 50%; height: 29px;">8</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">Parity</td><td style="width: 50%; height: 35px;">None

</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Stop bits</td><td style="width: 50%; height: 29px;">1</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Handshake</td><td style="width: 50%; height: 29px;">none</td></tr></tbody></table>

### Software

There are multiple different software solutions to read and write data via software. The software from the manufacturer is called *Sunways Monitor 2.0*, but it is not available for download anymore.

#### FHEM

Another software to communicate with the inverters is the house automation software **FHEM***.* It support many different modules and Prof. Dr. Peter A. Henning created a module for Sunways NT inverters called [NT5000](https://github.com/mhop/fhem-mirror/blob/master/fhem/contrib/70_NT5000.pm) (seems to be moved to [70\_SolarView](https://github.com/mhop/fhem-mirror/blob/master/fhem/contrib/70_SolarView.pm)). Targeted actually at the NT5000, the inverters NT1800, NT2600, NT4000 and NT6000 have the same protocol. Further information can be found in the [wiki](https://wiki.fhem.de/wiki/NT5000). To use the module you firstly need to get your FHEM installation up and running, for example as docker container. There you need to mount a volume for the configuration to be persistent and also pass the USB device to the container.

```
docker run -d -p 8083:8083 --device=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0:/dev/ttyUSB0 -v /home/pi/fhem:/opt/fhem fhem/fhem
```

After that you need to copy the 70\_NT5000.pm ([fhem.txt](https://bookstack.greinet.com/attachments/244)) file from contrib to the FHEM folder so that the module can be loaded. Test if the module can be loaded by running the command **reload NT5000** on the FHEM web interface. If it succeeds, you can then create the solar module object by running **define solar NT5000 /dev/ttyUSB0**. Then you should see the values of the inverter on the website. Sadly I could not find any option to get support for multiple inverters. So the only way to use this software with multiple inverters would be to wire each inverter to the computer on its own. Publishing the received data can be done for example via MQTT.

```
define mosquitto MQTT <IP>:<PORT>
define mqttGeneric MQTT_GENERIC_BRIDGE
attr mqttGeneric IODev mosquitto
attr mqttGeneric globalPublish *:topic={"<MQTTTOPIC>/$device/$reading"}
```

Example config: [config.txt](https://bookstack.greinet.com/attachments/247)

#### SolarView aka SolarMax-Proxy

Another software to read and write the data is [SolarView](https://www.solarview.info/default.aspx), a data logger for various solar inverters. While it doesn't support Sunways support out of the gate, a community member of [this forum](https://www.photovoltaikforum.com/) created a proxy for the inverters. The software proxies the Sunways inverter to act like a SolarMax inverter, which the software supports. The solarmax-proxy is available on [SourceForge](https://sourceforge.net/projects/solarmax-proxy/), but no longer maintained by the the original creator. In [this thread](https://www.photovoltaikforum.com/thread/38605-sunways-wechselrichter-mit-solarview-betreiben-smp/) the evolution and usage of the proxy is discussed and also multiple different binary files where shared. Here are multiple files saved for preservation:

- [solarmax-proxy-code.zip](https://bookstack.greinet.com/attachments/114)
- [ssl\_7-patch.zip](https://bookstack.greinet.com/attachments/115)
- [smp\_rpi single always log message only with parameter debug.zip](https://bookstack.greinet.com/attachments/116)
- [smp-0.21-mipsel.zip](https://bookstack.greinet.com/attachments/117)
- [smp\_v0.23 code and binary rpi and 7390.zip](https://bookstack.greinet.com/attachments/118)
- [smp 0.22 all binaries 7170 7270 73xx 7272 7490 x86 rpi.zip](https://bookstack.greinet.com/attachments/120)
- [smp 0.22 all binaries 7170 7270 73xx 7272 7490 x86 rpi NEW.zip](https://bookstack.greinet.com/attachments/119)
- [smp 0.22.zip](https://bookstack.greinet.com/attachments/121)
- [smp compiled to raspberry pi changed for clear code.zip](https://bookstack.greinet.com/attachments/122)
- [smp compiled for raspberry pi.zip](https://bookstack.greinet.com/attachments/123)
- [useful\_infos.txt](https://bookstack.greinet.com/attachments/124)

The requirement for smp to work are:

- RS485 from the inverter connected to a serial to network adapter (or connected to the raspberry pi and forwarded via ser2net software via network)
- SMP connected to the adapter
- SolarView configured to use SMP as SolarMax inverter

Example calls:

- ./smp -c 1 -l 11200 -f /var/log/smp.log
- ./smp -c 2 -l 11200
- ./smp -t 5 -c 1 -f smp.log -l 5000
- ./smp.rpi -h 192.168.178.74 -p 6000 -d 2 -c 3 -f smp.log

As all these step dont seem like a stable solution for me, I did not try this route, but the source code gained from this proxy was more than helpful.

#### Python Script

Which leads to the last software, a little python script written by myself. As it still is a work in progress, here is the current version of the software.

[test-2.py](https://bookstack.greinet.com/attachments/125)

Backup: [SMP.zip](https://bookstack.greinet.com/attachments/245) and [SUNWAYS.zip](https://bookstack.greinet.com/attachments/246)

Example output:

[![stats.png](https://bookstack.greinet.com/uploads/images/gallery/2022-07/scaled-1680-/stats.png)](https://bookstack.greinet.com/uploads/images/gallery/2022-07/stats.png)

### Working Software

- [sunways.zip](https://bookstack.greinet.com/attachments/396)

File collection backup: [Multiusb.zip](https://bookstack.greinet.com/attachments/248)

# WLED - LED controller

[https://github.com/atuline/WLED/wiki/Digital-Microphone-Hookup](https://github.com/atuline/WLED/wiki/Digital-Microphone-Hookup)

[https://www.reddit.com/r/FastLED/comments/iir78j/need\_help\_connecting\_max9814\_to\_esp32/](https://www.reddit.com/r/FastLED/comments/iir78j/need_help_connecting_max9814_to_esp32/)

[https://github.com/atuline/WLED/wiki/](https://github.com/atuline/WLED/wiki/)

[https://github.com/atuline/WLED](https://github.com/atuline/WLED)

[https://github.com/atuline/WLED/wiki/Analog-Audio-Input-Options](https://github.com/atuline/WLED/wiki/Analog-Audio-Input-Options)

[https://www.az-delivery.de/products/max9814-mikrofon](https://www.az-delivery.de/products/max9814-mikrofon)

[https://install.wled.me/](https://install.wled.me/)

[https://www.google.com/search?q=INMP441&amp;sourceid=chrome&amp;ie=UTF-8](https://www.google.com/search?q=INMP441&sourceid=chrome&ie=UTF-8)

# Tasmota

### **Smart Plugs**

**Energy Reset**

- `EnergyReset1 <value>` to change today
- `EnergyReset2 <value>` to change yesterday
- `EnergyReset3 <value>` to change total

**Power Calibration**

- [https://tasmota.github.io/docs/Power-Monitoring-Calibration/](https://tasmota.github.io/docs/Power-Monitoring-Calibration/)

### **Flash Tasmota**

[Tasmotizer](https://github.com/tasmota/tasmotizer)

### **Tasmota Settings**

#### **NTP Server**

Set the NTP reference server for the Tasmota instance. Might need a restart to take affect.

Tasmota &gt; Console

- List servers

```
$ ntpServer
>> {"NtpServer1":"192.168.178.1","NtpServer2":"time.cloudflare.com","NtpServer3":"pool.ntp.org"}
```

- Set servers

```
$ ntpServer<X> <IP>
e.g.
ntpServer1 192.168.178.1
ntpServer2 time.cloudflare.com
ntpServer3 pool.ntp.org
```

# Tuya

## Tuya conversion

Cloudcutter

[https://github.com/openshwprojects/OpenBK7231T\_App9kw.eu](https://github.com/openshwprojects/OpenBK7231T_App9kw.eu)

# IR Receiver

#### Resources

- [https://tasmota.github.io/docs/devices/YTF-IR-Bridge/](https://tasmota.github.io/docs/devices/YTF-IR-Bridge/)
- [https://tasmota.github.io/docs/devices/TYWE3S/](https://tasmota.github.io/docs/devices/TYWE3S/)
- [https://github.com/arendst/Tasmota/issues/8829](https://github.com/arendst/Tasmota/issues/8829)
- [https://templates.blakadder.com/ZN281402.html](https://templates.blakadder.com/ZN281402.html)
- [https://templates.blakadder.com/ytf\_ir\_bridge.html](https://templates.blakadder.com/ytf_ir_bridge.html)
- [https://blog.castnet.club/en/blog/flashing-tasmota-on-tuya-ir-bridge/](https://blog.castnet.club/en/blog/flashing-tasmota-on-tuya-ir-bridge/)
- [https://daniel-spitzer.de/blog/2019/12/27/universelle-infrarot-fernbedienung-mit-tasmota-steuert-appletv-mit-alexa-integration/](https://daniel-spitzer.de/blog/2019/12/27/universelle-infrarot-fernbedienung-mit-tasmota-steuert-appletv-mit-alexa-integration/)
- [https://tasmota.github.io/docs/Codes-for-IR-Remotes/](https://tasmota.github.io/docs/Codes-for-IR-Remotes/)

# Onestyle SD-WL-02 Smart Plugs

[https://templates.blakadder.com/onestyle\_SD-WL-02.html](https://templates.blakadder.com/onestyle_SD-WL-02.html)

# ZigBee2Mqtt

<table border="1" id="bkmrk-device-id-name-group" style="height: 203px; width: 755px;" width="900"><tbody><tr style="height: 29px;"><td style="width: 196px; height: 29px;">Device ID</td><td style="width: 386px; height: 29px;">Name</td><td style="width: 173px; height: 29px;">Label</td></tr><tr style="height: 29px;"><td style="width: 196px; height: 29px;">0x7cb03eaa00af5ce4</td><td style="width: 386px; height: 29px;">andreas\_osram\_smartplus\_bulb\_1\_ZB</td><td style="width: 173px; height: 29px;">1</td></tr><tr style="height: 29px;"><td style="width: 196px; height: 29px;">0x84182600000f4040</td><td style="width: 386px; height: 29px;">andreas\_osram\_smartplus\_bulb\_2\_ZB</td><td style="width: 173px; height: 29px;">2</td></tr><tr style="height: 29px;"><td style="width: 196px; height: 29px;">0x84182600000f4729</td><td style="width: 386px; height: 29px;">andreas\_osram\_smartplus\_bulb\_3\_ZB</td><td style="width: 173px; height: 29px;">3</td></tr><tr style="height: 29px;"><td style="width: 196px; height: 29px;">0x84182600000f5310</td><td style="width: 386px; height: 29px;">andreas\_osram\_smartplus\_bulb\_4\_ZB</td><td style="width: 173px; height: 29px;">4</td></tr><tr style="height: 29px;"><td style="width: 196px; height: 29px;"> </td><td style="width: 386px; height: 29px;"> </td><td style="width: 173px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 196px; height: 29px;">0x4c5bb3fffe2e8890</td><td style="width: 386px; height: 29px;">smart\_knob\_1</td><td style="width: 173px; height: 29px;">sk1</td></tr></tbody></table>

# ESPHome



# Watermeter

#### **Hardware**

- CC1101 868 MHz Wireless Funk Modul Transciever (z.B. [Amazon](https://www.amazon.de/-/en/CC1101-Wireless-Transmission-Antenna-Transceiver-Green/dp/B09NR5MDQH))
- Wemos D1 mini (z.B. [Amazon](https://www.amazon.de/-/en/NodeMcu-Wireless-Internet-Development-Compatible/dp/B0BWRMHY98))
- Diehl IZAR RC 868 I R4 PL Watermeter

#### **Hardware Setup**

[![cc1101_board_pins.png](https://bookstack.greinet.com/uploads/images/gallery/2023-08/scaled-1680-/cc1101-board-pins.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-08/cc1101-board-pins.png)

[![image-1691608099873.png](https://bookstack.greinet.com/uploads/images/gallery/2023-08/scaled-1680-/image-1691608099873.png)](https://bookstack.greinet.com/uploads/images/gallery/2023-08/image-1691608099873.png)

#### **Configuration**

[esphome-watermeter.yaml](https://bookstack.greinet.com/attachments/378)

together with secrets:

- wifi\_ssid
- wifi\_password
- fallback\_hotspot\_password
- watermeter\_id

#### **Sources**

- Image 1: [https://randomnerdtutorials.com/esp8266-pinout-reference-gpios/](https://randomnerdtutorials.com/esp8266-pinout-reference-gpios/)
- Image 2 and Code: [https://github.com/zibous/ha-watermeter](https://github.com/zibous/ha-watermeter)

# Grafana



# TODO list

[https://grafana-ha.greiner.live/dashboards](https://grafana-ha.greiner.live/dashboards)

### <span style="text-decoration: underline;">**General**</span>

General purpose dashboards.

#### <span style="text-decoration: underline;">**Watermeter ([link](https://grafana-ha.greiner.live/d/l0NA8w17z/watermeter))**</span>

- Evaluate costs and redo algorithm

# Smartmeter - SGM-D4

- [https://github.com/ZERYCON-GmbH/trudi-koala](https://github.com/ZERYCON-GmbH/trudi-koala)
- [https://www.ptb.de/cms/ptb/fachabteilungen/abt2/fb-23/ag-234/info-center-234/trudi/trudi1510.html](https://www.ptb.de/cms/ptb/fachabteilungen/abt2/fb-23/ag-234/info-center-234/trudi/trudi1510.html)
- [https://community.home-assistant.io/t/reading-energy-data-from-han-port/512452/8](https://community.home-assistant.io/t/reading-energy-data-from-han-port/512452/8)
- [https://www.nek.no/wp-content/uploads/2018/11/Aidon-HAN-Interface-Description-v10A-ID-34331.pdf](https://www.nek.no/wp-content/uploads/2018/11/Aidon-HAN-Interface-Description-v10A-ID-34331.pdf)
- [https://community.home-assistant.io/t/reading-energy-data-from-han-port/512452/8](https://community.home-assistant.io/t/reading-energy-data-from-han-port/512452/8)
- [https://github.com/duswie/node-red-contrib-smgw](https://github.com/duswie/node-red-contrib-smgw)
- [https://www.ptb.de/cms/de/ptb/fachabteilungen/abt2/fb-23/ag-234/info-center-234/trudi.html](https://www.ptb.de/cms/de/ptb/fachabteilungen/abt2/fb-23/ag-234/info-center-234/trudi.html)
- [https://www.ppc-ag.de/en/produkte/smart-meter-gateways/ethernet-smart-meter-gateway/](https://www.ppc-ag.de/en/produkte/smart-meter-gateways/ethernet-smart-meter-gateway/)
- [https://www.efr.de/products/smart-energy-geraete/elektronische-stromzaehler/basiszaehler/sgm-d4/](https://www.efr.de/products/smart-energy-geraete/elektronische-stromzaehler/basiszaehler/sgm-d4/)
- [https://github.com/glfp/SolarEnergyMonitorInfluxGrafanaDocker](https://github.com/glfp/SolarEnergyMonitorInfluxGrafanaDocker)
- [https://grafana.com/grafana/dashboards/13295-solar-pv-system/?tab=revisions](https://grafana.com/grafana/dashboards/13295-solar-pv-system/?tab=revisions)

# Smart Thermostat

- [https://github.com/fashberg/WThermostatBeca](https://github.com/fashberg/WThermostatBeca)
- [https://github.com/klausahrenberg/WThermostatBeca/issues?q=is%3Aissue+bac-002](https://github.com/klausahrenberg/WThermostatBeca/issues?q=is%3Aissue+bac-002)
- [https://github.com/klausahrenberg/WThermostatBeca/issues/304](https://github.com/klausahrenberg/WThermostatBeca/issues/304)
- [https://github.com/klausahrenberg/WThermostatBeca/issues/252](https://github.com/klausahrenberg/WThermostatBeca/issues/252)
- [https://flows.nodered.org/flow/6e4649bc6d6529078cbb731610242eac](https://flows.nodered.org/flow/6e4649bc6d6529078cbb731610242eac)
- [https://flows.nodered.org/flow/9ca3a19e0e2ff606bd64f1e73a2191eb](https://flows.nodered.org/flow/9ca3a19e0e2ff606bd64f1e73a2191eb)
- [https://gist.github.com/ghostmaster75/9ca3a19e0e2ff606bd64f1e73a2191eb](https://gist.github.com/ghostmaster75/9ca3a19e0e2ff606bd64f1e73a2191eb)
- [https://discourse.nodered.org/t/need-help-with-ghost-thermostat/61671/55](https://discourse.nodered.org/t/need-help-with-ghost-thermostat/61671/55)
- [https://www.becaenergy.com/product/beca-bac-002-two-pipe-four-pipe-modulating-fan-coil-programmable-room-thermosta-support-online-shopping/](https://www.becaenergy.com/product/beca-bac-002-two-pipe-four-pipe-modulating-fan-coil-programmable-room-thermosta-support-online-shopping/)
- [https://www.amazon.de/Touchscreen-Raumthermostat-Klimaanlage-Gebl%C3%A4sekonvektor-Wifi-Anschluss-Unterst%C3%BCtzung/dp/B07KWMVCXV?th=1](https://www.amazon.de/Touchscreen-Raumthermostat-Klimaanlage-Gebl%C3%A4sekonvektor-Wifi-Anschluss-Unterst%C3%BCtzung/dp/B07KWMVCXV?th=1)
- [https://www.aliexpress.us/item/4001223280876.html?gatewayAdapt=4itemAdapt](https://www.aliexpress.us/item/4001223280876.html?gatewayAdapt=4itemAdapt)
- [https://de.aliexpress.com/i/4000299782398.html](https://de.aliexpress.com/i/4000299782398.html)
- [https://templates.blakadder.com/wireless\_tag\_WT32C3-S5.html](https://templates.blakadder.com/wireless_tag_WT32C3-S5.html)
- [https://blakadder.com/replace-tuya-esp12/](https://blakadder.com/replace-tuya-esp12/)
- [https://chinese.alibaba.com/product-detail/BAC-002ELW-4-tubes-thermostato-for-300019469235.html](https://chinese.alibaba.com/product-detail/BAC-002ELW-4-tubes-thermostato-for-300019469235.html)
- [https://de.aliexpress.com/item/4000419898987.html](https://de.aliexpress.com/item/4000419898987.html)
- [https://de.aliexpress.com/item/4000547837148.html](https://de.aliexpress.com/item/4000547837148.html)
- [https://german.alibaba.com/product-detail/4-Pipe-Air-Conditioner-Parts-weekly-1600365490038.html](https://german.alibaba.com/product-detail/4-Pipe-Air-Conditioner-Parts-weekly-1600365490038.html)
- [https://www.alibaba.com/product-detail/Beca-BAC-002-Smart-Air-Conditioner\_1600502429752.html](https://www.alibaba.com/product-detail/Beca-BAC-002-Smart-Air-Conditioner_1600502429752.html)
- [https://www.alibaba.com/trade/search?spm=a2700.galleryofferlist.pageModule\_fy23\_pc\_search\_bar.keydown\_\_Enter&amp;tab=all&amp;searchText=%E2%80%8EBAC-002](https://www.alibaba.com/trade/search?spm=a2700.galleryofferlist.pageModule_fy23_pc_search_bar.keydown__Enter&tab=all&searchText=%E2%80%8EBAC-002)
- [https://www.expert4house.com/de/intelligente-thermostate/intelligente-wlan-thermostate/fan-coil-thermostate/wifi-thermostat-beca-bac-002elw-fan-coil](https://www.expert4house.com/de/intelligente-thermostate/intelligente-wlan-thermostate/fan-coil-thermostate/wifi-thermostat-beca-bac-002elw-fan-coil)
- [https://de.aliexpress.com/i/4000299782398.html](https://de.aliexpress.com/i/4000299782398.html)
- [https://github.com/AlbertWeterings/WThermostatBeca](https://github.com/AlbertWeterings/WThermostatBeca)
- [https://github.com/klausahrenberg/WThermostatBeca](https://github.com/klausahrenberg/WThermostatBeca)
- [https://de.aliexpress.com/i/4000299782398.html](https://de.aliexpress.com/i/4000299782398.html)

#### **Hardware**

ME81H

- [https://templates.blakadder.com/ME81H.html](https://templates.blakadder.com/ME81H.html)

ME88H.16

- [https://forum.iobroker.net/topic/47322/raumthermostat-me81h-31-wifi-tuya-tasmota-flashen](https://forum.iobroker.net/topic/47322/raumthermostat-me81h-31-wifi-tuya-tasmota-flashen)
- [https://de.aliexpress.com/item/1005005983008342.html](https://de.aliexpress.com/item/1005005983008342.html)

ME81H.16

- [https://forum.iobroker.net/topic/47322/raumthermostat-me81h-31-wifi-tuya-tasmota-flashen](https://forum.iobroker.net/topic/47322/raumthermostat-me81h-31-wifi-tuya-tasmota-flashen)

BAC-002

- [https://de.aliexpress.com/item/4000547837148.html](https://de.aliexpress.com/item/4000547837148.html)

BHT-002

- [https://de.aliexpress.com/i/4000299782398.html](https://de.aliexpress.com/i/4000299782398.html)

Moes

- [https://de.aliexpress.com/item/32905181466.html](https://de.aliexpress.com/item/32905181466.html)

Minco Heat MK70GB-H

# eBUS



# Documentation

### **Datenaufbau**

<table border="1" id="bkmrk-byte-richtung-abk%C3%BCrz" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 22.4074%;">Byte</td><td style="width: 8.82716%;">Richtung</td><td style="width: 10.4321%;">Abkürzung</td><td style="width: 58.3333%;">Beschreibung</td></tr><tr><td style="width: 22.4074%;">1</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">QQ</td><td style="width: 58.3333%;">Quelladresse</td></tr><tr><td style="width: 22.4074%;">2</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">ZZ</td><td style="width: 58.3333%;">Zieladresse</td></tr><tr><td style="width: 22.4074%;">3</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">PB</td><td style="width: 58.3333%;">Primärbefehl</td></tr><tr><td style="width: 22.4074%;">4</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">SB</td><td style="width: 58.3333%;">Sekundärbefehl</td></tr><tr><td style="width: 22.4074%;">5</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">NN</td><td style="width: 58.3333%;">Zahl der folgenden Bytes</td></tr><tr><td style="width: 22.4074%;">6 bis 5 + NN</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">Data</td><td style="width: 58.3333%;">Datenbytes</td></tr><tr><td style="width: 22.4074%;">6 + NN</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">CRC</td><td style="width: 58.3333%;">Prüfziffer</td></tr><tr><td style="width: 22.4074%;">7 + NN</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">ACK</td><td style="width: 58.3333%;">Positive Bestätigung des Empfängers (ab hier nicht bei Broadcast-Nachrichten)</td></tr><tr><td style="width: 22.4074%;">8 + NN</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">NN2</td><td style="width: 58.3333%;">Datenlänge der Antwort</td></tr><tr><td style="width: 22.4074%;">9 + NN bis 8 + NN + NN2</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">Data</td><td style="width: 58.3333%;">Daten vom Slave an den Master</td></tr><tr><td style="width: 22.4074%;">9 + NN + NN2</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">CRC</td><td style="width: 58.3333%;">Prüfziffer</td></tr><tr><td style="width: 22.4074%;">10 + NN + NN2</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">ACK

</td><td style="width: 58.3333%;"> </td></tr><tr><td style="width: 22.4074%;">11 + NN + NN2</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">SYN</td><td style="width: 58.3333%;">Kennung, dass Bus wieder bereit ist für andere Teilnehmer</td></tr></tbody></table>

Service/Befehl =&gt; Kombination von Pimär und Sekundärbefehl =&gt; Darstellung als HEX-Wert

z.B. Primärbefehl 07 (Systemdatenbefehle) + Sekundärbefehl 00 (Datum/Zeit Meldung eines Masters) = Service 0700

Primärbefehle b5 sind von Vaillant, also nicht per Standard definiert

### **Kommunikation**

Master-Slave Telegramme und Broadcast Telegramme

Jeder Master hat auch eine Slave Adresse (Slave = Master + 5)

Broadcast-Adresse ist FE

### **CRC**

Muss mit expandiertem Datenstring erfolgen ([https://ebus-wiki.org/doku.php/ebus/ebuscrc](https://ebus-wiki.org/doku.php/ebus/ebuscrc))

```C++
    //////////////////////////////////////////////////////////////////////////
    //
    // CRC-Berechnung  aus http://www.mikrocontroller.net/topic/75698
    //
    //////////////////////////////////////////////////////////////////////////
     
    #ifdef USE_CRC_TAB
    const UCHAR CRC_Tab8Value[256] ''/********************************************************************************************************/
    /** Function for CRC-calculation with tab operations  */
    /********************************************************************************************************/
    UCHAR crc8(UCHAR data, UCHAR crc_init)
    {
       UCHAR crc;
     
       crc '' (UCHAR) (CRC_Tab8Value[crc_init] ^ data);
       return (crc);
    }
     
    #else
     
    /********************************************************************************************************/
    /** slower, but less memory                        */
    /********************************************************************************************************/
    unsigned char crc8(unsigned char data, unsigned char crc_init)
    {
       unsigned char crc;
       unsigned char polynom;
       int i;
     
       crc '' crc_init;
       for (i '' 0; i < 8; i++)
       {
          if (crc & 0x80)
          {
             polynom '' (unsigned char) 0x9B;
          }
          else
          {
             polynom '' (unsigned char) 0;
          }
          crc '' (unsigned char)((crc & ~0x80) << 1);
          if (data & 0x80)
          {
             crc '' (unsigned char)(crc | 1) ;
          }
          crc '' (unsigned char)(crc ^ polynom);
          data '' (unsigned char)(data << 1);
       }
       return (crc);
    }
    #endif
     
    UCHAR CalculateCRC( UCHAR**Data, int DataLen )
    {
       UCHAR Crc '' 0;
       for( int i '' 0 ; i < DataLen ; ++i, ++Data )
       {
          Crc '' crc8(**Data, Crc );
       }
       return Crc;
    }
```

# Vaillant

### **Datenaufbau**

<table border="1" id="bkmrk-byte-richtung-abk%C3%BCrz" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 22.4074%;">Byte</td><td style="width: 8.82716%;">Richtung</td><td style="width: 10.4321%;">Abkürzung</td><td style="width: 58.3333%;">Beschreibung</td></tr><tr><td style="width: 22.4074%;">1</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">QQ</td><td style="width: 58.3333%;">Quelladresse</td></tr><tr><td style="width: 22.4074%;">2</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">ZZ</td><td style="width: 58.3333%;">Zieladresse</td></tr><tr><td style="width: 22.4074%;">3</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">PB</td><td style="width: 58.3333%;">Primärbefehl</td></tr><tr><td style="width: 22.4074%;">4</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">SB</td><td style="width: 58.3333%;">Sekundärbefehl</td></tr><tr><td style="width: 22.4074%;">5</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">NN</td><td style="width: 58.3333%;">Zahl der folgenden Bytes</td></tr><tr><td style="width: 22.4074%;">6 bis 5 + NN</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">Data</td><td style="width: 58.3333%;">Datenbytes</td></tr><tr><td style="width: 22.4074%;">6 + NN</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">CRC</td><td style="width: 58.3333%;">Prüfziffer</td></tr><tr><td style="width: 22.4074%;">7 + NN</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">ACK</td><td style="width: 58.3333%;">Positive Bestätigung des Empfängers (ab hier nicht bei Broadcast-Nachrichten)</td></tr><tr><td style="width: 22.4074%;">8 + NN</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">NN2</td><td style="width: 58.3333%;">Datenlänge der Antwort</td></tr><tr><td style="width: 22.4074%;">9 + NN bis 8 + NN + NN2</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">Data</td><td style="width: 58.3333%;">Daten vom Slave an den Master</td></tr><tr><td style="width: 22.4074%;">9 + NN + NN2</td><td style="width: 8.82716%;">&lt;-</td><td style="width: 10.4321%;">CRC</td><td style="width: 58.3333%;">Prüfziffer</td></tr><tr><td style="width: 22.4074%;">10 + NN + NN2</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">ACK

</td><td style="width: 58.3333%;"> </td></tr><tr><td style="width: 22.4074%;">11 + NN + NN2</td><td style="width: 8.82716%;">-&gt;</td><td style="width: 10.4321%;">SYN</td><td style="width: 58.3333%;">Kennung, dass Bus wieder bereit ist für andere Teilnehmer</td></tr></tbody></table>

Service/Befehl =&gt; Kombination von Pimär und Sekundärbefehl =&gt; Darstellung als HEX-Wert

z.B. Primärbefehl 07 (Systemdatenbefehle) + Sekundärbefehl 00 (Datum/Zeit Meldung eines Masters) = Service 0700

### **Vaillant Addresses**

**Master**

<table border="1" id="bkmrk-adress-description-1" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">**Adress**</td><td style="width: 50%;">**Description**</td></tr><tr><td style="width: 50%;">10h</td><td style="width: 50%;">Main Control Unit:  
\* VRS620 (auroMATIC 620)</td></tr><tr><td style="width: 50%;">3F</td><td style="width: 50%;">Burner</td></tr></tbody></table>

Slave

<table border="1" id="bkmrk-adress-description-2" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">**Adress**</td><td style="width: 50%;">**Description**</td></tr><tr><td style="width: 50%;">23h</td><td style="width: 50%;"> </td></tr><tr><td style="width: 50%;">25h</td><td style="width: 50%;"> </td></tr><tr><td style="width: 50%;">26h</td><td style="width: 50%;">Outside temperature sensor (including DCF77 clock)</td></tr><tr><td style="width: 50%;">50h</td><td style="width: 50%;"> </td></tr><tr><td style="width: 50%;">ECh</td><td style="width: 50%;"> </td></tr></tbody></table>

# Commands

### **1. Service 03h**

- Name: Service Data Commands Burner Automats
- Data: information regarding operating time, start counts and fuel consumption

#### **1.1 Service 03h 04h**

- Name: Complete Reading of Start Counts
- Data: number of starts of a burner control unit

#### **1.2 Service 03h 05h**

- Name: Complete Operating Time, Reading Level 1
- Data: operating time counter (in case of multiple level burners, level 1) of a burner control unit

#### **1.3 Service 03h 06h**

- Name: Complete Operating Time, Reading Level 2
- Data: operating time counter level 2 of a burner control unit

#### **1.4 Service 03h 07h**

- Name: Complete Operating Time, Reading Level 3
- Data: operating time counter level 3 of a burner control unit

#### **1.5 Service 03h 08h**

- Name: Complete Reading Fuel Quantity Counter
- Data: fuel quantity counter of a burner control unit

#### **1.5 Service 03h 10h**

- Name: Read Meter Reading
- Data: chosen meter reading
- Parameters: Type of meter, Type of fuel (oil/gas)

### **2. Service 05h**

- Name: Burner Control Commands
- Data: communication between control unit, room sensor or control components

#### **2.1 Service 05h 00h**

- Name: Operational Requirements between Burner Control Unit and  
    Room Controller
- Data: Start/Stop data requirement from room controller
- Parameters: Start or Stop transmission

#### **2.2 Service 05h 01h**

- Name: Operational Data of Room Controller to Burner Control Unit
- Data: one-time/cyclic room controller operation data

#### **2.3 Service 05h 02h**

- Name: Operational Data of Room Controller to Burner Control Unit
- Data: one-time/cyclic room controller operation data

# System Overview

#### **Scan.08 HMU00**

Display in basement

#### **Scan.15 CTLV3**

VR720/3?Main controller in kitchen

#### **Scan.76 VWZIO**

VWL 75/6? aka arotherm plus heat pump

#### **Scan.f6 NETX3**

myVaillant connect (white box)