2023-02-23 02:31:59 +01:00
|
|
|
Kuntze pool monitor
|
|
|
|
|
===================
|
|
|
|
|
|
|
|
|
|
.. seo::
|
|
|
|
|
:description: Instructions for setting up Kuntze pool monitor in ESPHome.
|
|
|
|
|
:image: kuntze.jpg
|
|
|
|
|
|
2023-05-31 15:31:55 +02:00
|
|
|
The ``kuntze`` component allows you to integrate the Kuntze water measurement
|
2023-02-23 02:31:59 +01:00
|
|
|
instrument in ESPHome. It uses :ref:`UART <uart>` (ModBUS) for communication.
|
|
|
|
|
|
|
|
|
|
Once configured you can use sensors as described below for your projects.
|
|
|
|
|
|
|
|
|
|
|
2023-03-08 21:45:56 +01:00
|
|
|
.. figure:: ../../images/kuntze.jpg
|
2023-02-23 02:31:59 +01:00
|
|
|
:align: center
|
|
|
|
|
|
|
|
|
|
Kuntze Neon® Multi instrument
|
|
|
|
|
|
|
|
|
|
Overview
|
|
|
|
|
--------
|
|
|
|
|
|
2023-05-31 15:31:55 +02:00
|
|
|
Kuntze devices have an RS485 (ModBUS RTU) communication port. Please see the
|
2023-02-23 02:31:59 +01:00
|
|
|
Kuntze papers for the pinout of the RS485 connector on your unit. ModBUS line
|
|
|
|
|
has to be terminated properly (with a ``120Ω`` resistor), and since this is likely
|
|
|
|
|
your only unit connected to ESPHome, you should activate bus termination in the
|
2023-05-31 15:31:55 +02:00
|
|
|
Network menu (this component doesn't support multiple Kuntze devices on the same
|
2023-02-23 02:31:59 +01:00
|
|
|
bus). ModBUS address should remain at factory default value.
|
|
|
|
|
|
2023-05-31 15:31:55 +02:00
|
|
|
The device communicates at ``19200`` baud ``8E1``. To connect to ESPHome, an RS485
|
|
|
|
|
transceiver is needed. Choose a type which does not need a trigger to send and
|
2023-02-23 02:31:59 +01:00
|
|
|
receive data, for example:
|
|
|
|
|
|
2023-03-08 21:45:56 +01:00
|
|
|
.. figure:: ../../images/rs485.jpg
|
2023-02-23 02:31:59 +01:00
|
|
|
|
2023-05-31 15:31:55 +02:00
|
|
|
The controller connects to the UART of the MCU. For ESP32 GPIO `16` to `TXD` and `17`
|
2023-02-23 02:31:59 +01:00
|
|
|
to RXD are the default ones but any other pins can be used as well. 3.3V to VCC and GND to GND.
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
|
2023-05-31 15:31:55 +02:00
|
|
|
If you are using the :ref:`logger` make sure you are not using the same pins for it or otherwise disable the UART
|
2023-02-23 02:31:59 +01:00
|
|
|
logging with the ``baud_rate: 0`` option.
|
|
|
|
|
|
|
|
|
|
Component
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
A configured modbus component is optional. It will be automatically created.
|
|
|
|
|
|
|
|
|
|
.. code-block:: yaml
|
|
|
|
|
|
|
|
|
|
# Example configuration entry
|
|
|
|
|
uart:
|
|
|
|
|
- id: uart_bus
|
|
|
|
|
tx_pin: GPIO16
|
|
|
|
|
rx_pin: GPIO17
|
2023-03-08 21:45:56 +01:00
|
|
|
baud_rate: 19200
|
2023-02-23 02:31:59 +01:00
|
|
|
parity: EVEN
|
|
|
|
|
|
|
|
|
|
sensor:
|
|
|
|
|
- platform: kuntze
|
|
|
|
|
id: my_kuntze
|
|
|
|
|
ph:
|
|
|
|
|
id: ph
|
|
|
|
|
temperature:
|
|
|
|
|
id: temperature
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Configuration variables:
|
|
|
|
|
|
2023-05-31 15:31:55 +02:00
|
|
|
- **ph** (*Optional*): Measured pH value.
|
|
|
|
|
- **temperature** (*Optional*): Measured temperature value.
|
|
|
|
|
- **dis1** (*Optional*): Measured DIS 1 value.
|
|
|
|
|
- **dis2** (*Optional*): Measured DIS 2 value.
|
|
|
|
|
- **redox** (*Optional*): Measured Redox value.
|
|
|
|
|
- **ec** (*Optional*): Measured EC value.
|
|
|
|
|
- **oci** (*Optional*): Measured OCI value.
|
2023-02-23 02:31:59 +01:00
|
|
|
|
|
|
|
|
All sensors are *Optional* and support all other options from :ref:`Sensor <config-sensor>`.
|
|
|
|
|
|
|
|
|
|
See Also
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
- :ref:`uart`
|
2023-03-08 21:45:56 +01:00
|
|
|
- :ref:`logger`
|
2023-02-23 02:31:59 +01:00
|
|
|
- :ref:`Sensor <config-sensor>`
|
|
|
|
|
- `Kuntze manuals <https://www.kuntze.com/en/downloads-2/>`__
|
|
|
|
|
- `Communication protocol <https://www.kuntze.com/wp-content/uploads/2021/05/2019_Manual_Modbus-RTU_ENG.pdf>`__
|
|
|
|
|
- :ghedit:`Edit`
|
