---
title: "Snímač hladiny kapaliny"
description: "Monitorování hladiny vody přes Modbus RTU po RS-485. Konfigurovatelné jednotky (m, cm) a desetinná přesnost. TapHome šablona pro snímače hladiny."
url: "https://taphome.com/cs/compatibility/liquid-level-sensor/"
language: cs
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["modbus-rtu","sensor","rs485","liquid-level","hydrostatic","water-tank"]
  questions: ["Jak integrovat Modbus RTU snímač hladiny kapaliny s TapHome?","Jaké jednotky podporuje TapHome šablona pro snímač hladiny?","Jak připojit ponorný snímač hladiny přes RS-485 k TapHome?","Proč snímač hladiny zobrazuje NaN v TapHome?","Jak změnit slave adresu na Modbus snímači hladiny?","Jak nastavit desetinná místa na Modbus snímači hladiny?","Jak měřit výšku hladiny vody v nádrži nebo vrtané studni pomocí senzorového převodníku tlaku G1/4 30MPa?","Jak se zapojuje snímač na výšku hladiny vody v nádrži?","Jak pomocí zaplavového senzoru ovládat povolení pro frekvenční měnič čerpadla?"]
---

# Snímač hladiny kapaliny

Komunikace: Modbus RTU

## Návod na integraci

Generický ponorný hydrostatický snímač hladiny kapaliny s Modbus RTU pro monitorování hladiny vody v nádržích, studnách nebo retenčních nádržích. Snímač komunikuje přes RS-485 half-duplex a naměřenou hladinu poskytuje přes holding registr H:4. TapHome šablona čte naměřenou hodnotu s automatickým přepočtem desetinné čárky a podporuje metry (m) a centimetry (cm) jako zobrazovací jednotky.

Tato šablona je navržena pro generické čínské tlakové/hladinové snímače, které používají stejnou Modbus registrovou mapu. Snímač je obvykle napájen 12–36 V DC a používá 2-vodičové RS-485 připojení k převodníku Modbus na LAN (RS-485 na Ethernet).

## Hardwarové připojení

Snímač používá RS-485 half-duplex rozhraní pro Modbus RTU komunikaci. Připojte snímač k převodníku Modbus na LAN:

- **A+** (RS-485 Data+) na snímači k **A+** na převodníku Modbus na LAN
- **B-** (RS-485 Data-) na snímači k **B-** na převodníku Modbus na LAN
- **GND** na společnou referenční zem

Snímač vyžaduje také samostatný DC zdroj napájení (obvykle 12–36 V DC, podle modelu). Napájecí vodiče jsou odděleny od datových vodičů RS-485.

> [!WARNING]
> Zajistěte společnou referenční zem mezi snímačem a převodníkem Modbus na LAN. Bez správného uzemnění může být Modbus komunikace nespolehlivá nebo zcela selhat.

## Konfigurace

### Výchozí komunikační parametry

Snímač se dodává s následujícím výchozím sériovým nastavením:

| Parametr | Výchozí hodnota |
|----------|-----------------|
| Přenosová rychlost | 9600 bps |
| Datové bity | 8 |
| Parita | Žádná |
| Stop bity | 1 |
| Slave adresa | 1 |

Přenosovou rychlost lze změnit přes registr H:1 (podporované hodnoty: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200). Po změně přenosové rychlosti zapište 0 do registru H:15 pro uložení nastavení do uživatelské oblasti.

### Výběr jednotky

Měřicí jednotka se nastavuje přes registr H:2. TapHome šablona podporuje pouze dvě jednotky:

| Hodnota H:2 | Jednotka | Chování |
|--------------|----------|---------|
| 16 | **m** (metry) | Vrací surovou hodnotu přímo (s přepočtem desetinné čárky) |
| 17 | **cm** (centimetry) | Vrací hodnotu dělenou 100 |
| Ostatní | MPa, KPa, bar, atd. | **Vrací NaN** — šablona nepodporuje |

> [!WARNING]
> Pokud je snímač nastaven na jinou jednotku než m (16) nebo cm (17), TapHome šablona zobrazí NaN. Před importem šablony ověřte nastavení jednotky.

### Přesnost desetinných míst

Registr H:3 určuje, kolik desetinných míst používá surová naměřená hodnota:

| Hodnota H:3 | Formát | Dělitel |
|--------------|--------|---------|
| 0 | #### | 1 |
| 1 | ###.# | 10 |
| 2 | ##.## | 100 |
| 3 | #.### | 1000 |
| 4 | .#### | 10000 |

TapHome šablona automaticky dělí surovou hodnotu H:4 hodnotou 10^(H:3) pro získání správného údaje. Například pokud H:3 = 1 (jedno desetinné místo) a H:4 = 2500, zobrazená hodnota je 250,0.

### Importové parametry

Při importu šablony v TapHome jsou potřeba dva parametry:

| Parametr | Popis | Příklad |
|----------|-------|---------|
| **Slave Id** | Modbus slave adresa snímače (platný rozsah Modbus 1–247) | `1` |
| **IP address** | IP adresa převodníku Modbus na LAN | `192.168.1.100` |

## Schopnosti zařízení

### Měření hladiny vody

Šablona poskytuje jedno zařízení typu senzor (pouze pro čtení) — **Water Level** — které čte holding registr H:4 (Int16). ReadState skript aplikuje dynamický přepočet:

1. Přečte surovou celočíselnou hodnotu z H:4
2. Vydělí hodnotou 10^(H:3) pro aplikaci nastavení desetinných míst
3. Podle H:2 (jednotka): pokud jednotka = 16 (m), vrátí hodnotu přímo; pokud jednotka = 17 (cm), vydělí 100; jinak vrátí NaN

Snímač se dotazuje každých 15 sekund.

### Servisní diagnostika

Modul poskytuje čtyři servisní atributy pro monitorování konfigurace snímače:

- **Slave Address** — aktuální Modbus slave adresa (H:0)
- **Baud Rate** — aktuální komunikační rychlost, zobrazená jako skutečná hodnota přenosové rychlosti (např. 9600, nikoli enum registru)
- **Unit** — aktuálně nastavená měřicí jednotka (např. „m", „cm", „MPa")
- **Decimal Points** — aktuální formát desetinných míst (např. „###.#")

Servisní akce **Rewrite Slave Address** umožňuje změnit Modbus adresu snímače (platný rozsah Modbus 1–247) přímo z TapHome bez externích nástrojů. Akce zapíše novou adresu a automaticky ji uloží do uživatelské oblasti snímače.

### Další schopnosti

Snímač také poskytuje registry pro nulový bod rozsahu (H:5) a plný rozsah (H:6) jako kalibrační reference, registr offsetu nulového bitu (H:12) pro doladění měřicího výstupu, 4-bajtový IEEE 754 výstup měření v plovoucí řádové čárce (H:22-23) a konfiguraci sériové parity (H:37). Příkaz pro obnovení továrního nastavení (H:16) může obnovit všechny parametry na tovární hodnoty. Tyto lze doplnit v budoucí aktualizaci šablony.

> [!TIP]
> Pokud je potřeba vyšší přesnost, měření v plovoucí řádové čárce na registrech H:22-23 poskytuje stejný údaj ve formátu IEEE 754 (big-endian ABCD pořadí bajtů) bez celočíselného zaokrouhlování H:4.

## Řešení problémů

### Snímač vrací NaN

1. Zkontrolujte registr H:2 (Unit) — šablona podporuje pouze jednotku 16 (m) a 17 (cm). Všechny ostatní jednotky vrátí NaN
2. Použijte servisní atribut **Unit** v TapHome pro ověření aktuálního nastavení
3. Pokud je jednotka nesprávná, použijte Modbus nástroj pro zápis správné hodnoty do H:2, poté zapište 0 do H:15 pro uložení

### Žádná komunikace

1. Ověřte zapojení RS-485: A+ k A+, B- k B- a společná zem
2. Zkontrolujte, zda přenosová rychlost souhlasí mezi snímačem a TapHome (výchozí: 9600, N, 8, 1)
3. Potvrďte, že bylo zadáno správné Slave ID při importu šablony
4. Ověřte, že IP adresa ukazuje na správný převodník Modbus na LAN
5. Pokud jsou vodiče prohozeny (A+/B-), otočte je — některé snímače označují piny odlišně

### Nesprávné hodnoty

1. Ověřte, zda nastavení desetinných míst (H:3) odpovídá tovární konfiguraci snímače
2. Zkontrolujte nastavení jednotky (H:2) — režim cm (17) dělí dodatečným faktorem 100
3. U ponorných snímačů se ujistěte, že sonda je zcela ponořena a kabel není zalomený

## Dostupná zařízení 1

Tato zařízení se po importu zobrazí v TapHome.

Snímač hladiny kapaliny Modul

Servisní atributy

|                    |
|--------------------|
| Slave adresa       |
| Přenosová rychlost |
| Jednotka           |
| Desetinná místa    |

Servisní akce

|                      |
|----------------------|
| Přepsat slave adresu |

Servisní atributy

Slave Address

```taphome
modbusr(H, 0, int16);
```

Baud Rate

```taphome
SWITCH(modbusr(H, 1, int16),
	0, 1200,
	1, 2400,
	2, 4800,
	3, 9600,
	4, 19200,
	5, 38400,
	6, 57600,
	7, 115200,
      NaN
);
```

Unit

```taphome
switch(modbusr(H, 2, int16),
	0, "MPa",
	1, "KPa",
	2, "Pa",
	3, "bar",
	4, "mbar",
	5, "Kgcm2",
	6, "PSI",
	7, "mH2O",
	8, "mmH2O",
	9, "inH2O",
	10, "H2O",
	11, "mHg",
	12, "mmHg",
	13, "inHg",
	14, "atm",
	15, "Torr",
	16, "m",
	17, "cm",
	18, "mm",
	19, "Kg",
	20, "°C",
	21, "PH",
	22, "°F",
	NaN
);
```

Decimal points

```taphome
SWITCH(modbusr(H, 3, int16),
	0, "####",
	1, "###.#",
	2, "##.##",
	3, "#.###",	
	4, "#.###",
	NaN
);
```

Servisní akce

Rewrite the Slave Address

Parametry: Slave Address (1–255 SlaveAddr)

```taphome
modbusw(SH, 0, int16, SlaveAddr);
modbusw(SH, 15, int16, 0);  # Save to user area
```

Hladina vody Proměnná Pouze ke čtení

Měření hladiny kapaliny v metrech nebo centimetrech — čte výstup hydrostatického tlakového snímače s konfigurovatelnou přesností desetinných míst

Registr: H:4 Int16 Jednotka: dynamic numeric

Čtení

```taphome
VAR val := MODBUSR(H, 4, Int16)/power(10, modbusr(H, 3, int16));

switch(modbusr(H, 2, int16),
	16, val,
	17, val / 100, 
	NaN
);
```

**Připojení:** Modbus RTU • 9600 baud• 8N1 • Slave ID: $\[SlaveId]

Možná vylepšení (6)

- H:5 Range Zero Point — Int16, transmitter range zero point — factory calibration reference
- H:6 Range Full Point — Int16, transmitter range full scale point — factory calibration reference
- H:12 Zero Bit Offset — Int16 (R/W via 0x06), zero-bit offset value — pressure output = calibration + offset. Factory default 0
- H:22 Floating Point Measurement — 4-byte float (IEEE 754, big-endian ABCD), 2 registers starting at 0x0016 — same measurement as H:4 but in float format
- H:37 Serial Check Bit — Int16 (R/W via 0x06); enum: 0=None, 1=Odd, 2=Even — serial parity configuration
- H:16 Restore Factory Parameters — Write 1 to 0x0010 to restore factory defaults — resets address, baud rate, and calibration. Requires re-searching for transmitter

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| Slave Id          | `1`           |
| IP address        | `192.168.1.0` |

## Zdroje

- Modbus RTU communication protocol documentation for pressure and level transmitter

## Související dokumentace

- [Modbus Integration](https://taphome.com/cs/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/cs/docs/integration/modbus/)
- [Jednoduché nastavení pomocí šablon](https://taphome.com/cs/docs/integration/modbus/templates/)
- [Skripty Modbus a prefetch](https://taphome.com/cs/docs/script/modbus-scripts/)
- [Funkce Modbus](https://taphome.com/cs/docs/script/modbus/)
- [Datové typy Modbus](https://taphome.com/cs/docs/script/modbus-data-types/)

