This repository contains a collection of my custom components for ESPHome.

coffe or coffe

Use latest ESPHome with external components and add this to your .yaml definition:

external_components:
  - source: github://SzczepanLeon/esphome-components@main

Component to receive wMBus frame (via CC1101) and send it via TCP or UDP to wmbusmeters (as HEX or rtl-wmbus format).

time:
  - platform: sntp
    id: time_sntp

external_components:
  - source: github://SzczepanLeon/esphome-components@main
    components: [ wmbusgw ]

wmbusgw:
  mosi_pin: GPIO13
  miso_pin: GPIO5
  clk_pin:  GPIO2
  cs_pin:   GPIO14
  gdo0_pin: GPIO15
  gdo2_pin: GPIO16
  clients:
    - name: "wmbusmeters"
      ip_address: "10.0.0.1"
      port: 7227
      format: rtlwMBus
    - name: "tests"
      ip_address: "10.1.2.3"
      port: 6116
    - name: "tests"
      ip_address: "10.4.5.6"
      port: 7337
      transport: UDP

On client side you can use netcat to receive packets:

nc -lk 7227

or

nc -lku 7337

or add to wmbusmeters.conf:

device=rtlwmbus:CMD(nc -lk 7227)

• mosi_pin (Required): CC1101 MOSI pin connection.
• miso_pin (Required): CC1101 MISO pin connection.
• clk_pin (Required): CC1101 CLK pin connection.
• cs_pin (Required): CC1101 CS pin connection.
• gdo0_pin (Required): CC1101 GDO0 pin connection.
• gdo2_pin (Required): CC1101 GDO2 pin connection.
• reboot_timeout (Optional): The amount of time to wait before rebooting when no data from CC1101 is received or no packets are transmited over TCP to clients. Can be disabled by setting this to 0s. Defaults to 3min.
• clients (Optional):
  • name (Required): The name for this client.
  • ip_address (Required): IP address.
  • port (Required): Port number.
  • format (Optional): Telegram format to send. HEX or RTLWMBUS. Defaults to HEX.
  • transport (Optional): TCP or UDP. Defaults to TCP.

You can also use this component with wmbusmeters HA addon: https://github.com/SzczepanLeon/esphome-components/blob/main/docs/wmbusgw.md

Component to receive wMBus frame (via CC1101), create HA sensor and send decoded value.

external_components:
  - source: github://SzczepanLeon/esphome-components@main
    components: [ wmbus ]

wmbus:
  mosi_pin: GPIO13
  miso_pin: GPIO5
  clk_pin:  GPIO2
  cs_pin:   GPIO14
  gdo0_pin: GPIO15
  gdo2_pin: GPIO16

sensor:
  - platform: wmbus
    name: "My water from Apator"
    meter_id: 0x24202020
    type: apator162
    key: "00000000000000000000000000000000"
  - platform: wmbus
    name: "My Water from Izar"
    meter_id: 306029916
    type: izar
    accuracy_decimals: 5

In wmbus platform:

• mosi_pin (Optional): CC1101 MOSI pin connection. Defaults to GPIO13.
• miso_pin (Optional): CC1101 MISO pin connection. Defaults to GPIO12.
• clk_pin (Optional): CC1101 CLK pin connection. Defaults to GPIO14.
• cs_pin (Optional): CC1101 CS pin connection. Defaults to GPIO2.
• gdo0_pin (Optional): CC1101 GDO0 pin connection. Defaults to GPIO5.
• gdo2_pin (Optional): CC1101 GDO2 pin connection. Defaults to GPIO4.

Sensor

• meter_id (Required, int): Meter ID (usually from sticker). Can be specified as decimal or hex.
• type (Required, string): Meter type. Currently izar, unismart, apator08, apator162 are supported.
• key (Optional): Key for meter, used in payload decoding process. Defaults to "".
• All other options from Sensor.

Szczepan, GPL, 2022-2023