Skip to content

Commit f283c7f

Browse files
author
Xavier Berger
committed
doc: Add JSY-MK-194T power meter and energy counter documentation
1 parent 611e962 commit f283c7f

7 files changed

Lines changed: 372 additions & 2 deletions

‎docs/en/energy_counter_jsy-mk-194t.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# JSY-MK-194T Energy Counter
2+
3+
The JSY-MK-194T energy counter shares common code with the
4+
[JSY-MK-194T power meter](powermeter_jsy-mk-194t.md) to communicate with the module.
5+
The rest of this documentation explains how to configure this common part
6+
and how to configure a JSY-MK-194T energy counter.
7+
8+
![jsy-mk-194t](../images/jsy-mk-194t.png)
9+
10+
## 1 – Common Part: Communication with the JSY-MK-194T
11+
12+
This file manages communication with the board. If you wish, you can expose
13+
JSY-MK-194T measurements in Home Assistant; see the example below.
14+
15+
```yaml
16+
packages:
17+
solar_router:
18+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
19+
refresh: 1s
20+
files:
21+
# JSY-MK-194T management
22+
- path: solar_router/jsy-mk-194t_common.yaml
23+
vars:
24+
uart_tx_pin: GPIO26
25+
uart_rx_pin: GPIO27
26+
uart_baud_rate: 4800
27+
AP_Ch2_internal: "false" # optional, allows displaying one of the JSY-MK-194T sensors
28+
```
29+
30+
List of available JSY-MK-194T sensors:
31+
32+
```yaml
33+
U_Ch1_internal: "true" # Voltage on Channel 1
34+
I_Ch1_internal: "true" # Current on Channel 1
35+
AP_Ch1_internal: "true" # Active Power on Channel 1
36+
PAE_Ch1_internal: "true" # Positive Active Energy on Channel 1
37+
PF_Ch1_internal: "true" # Power Factor on Channel 1
38+
NAE_Ch1_internal: "true" # Negative Active Energy on Channel 1
39+
PD_Ch1_internal: "true" # Power Direction on Channel 1
40+
PD_Ch2_internal: "true" # Power Direction on Channel 2
41+
frequency_internal: "true" # Frequency
42+
# Voltage on Channel 2 not implemented => same as Voltage on Channel 1
43+
I_Ch2_internal: "true" # Current on Channel 2
44+
AP_Ch2_internal: "true" # Active Power on Channel 2
45+
PAE_Ch2_internal: "true" # Positive Active Energy on Channel 2
46+
PF_Ch2_internal: "true" # Power Factor on Channel 2
47+
NAE_Ch2_internal: "true" # Negative Active Energy on Channel 2
48+
```
49+
50+
## 2 – Enabling the Energy Counter
51+
52+
To enable the energy counter, simply add it to your configuration as shown
53+
in the example below:
54+
55+
```yaml
56+
packages:
57+
solar_router:
58+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
59+
refresh: 1s
60+
files:
61+
- path: solar_router/energy_counter_jsy-mk-194t.yaml
62+
```
63+
64+
For a complete implementation example, refer to the
65+
[JSY-MK-194T example](jsy-mk-194t.md).

‎docs/en/jsy-mk-194t.md‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
# Details on Using a JSY-MK-194T Power Sensor
2+
3+
Two configurations are possible when using this sensor:
4+
5+
- **standalone**: both sensors of the JSY-MK-194T are used (Ch1: sensor on the load, Ch2: household power sensor at the utility meter)
6+
- **hybrid** (example: Home Assistant for real_power measurement + JSY-MK-194T for derived energy): useful if the router is far from the measurement point, or if the contract is zero-injection (you will need to create a virtual sensor in Home Assistant to simulate injection by estimating the potential energy not produced; see for example the project https://github.com/M3c4tr0x/ESP-PowerSunSensor)
7+
8+
## 1 – Common Part: Communication with the JSY-MK-194T
9+
10+
This file manages communication with the board. If you wish, you can expose the JSY-MK-194T measurements in Home Assistant; see the example below.
11+
12+
```yaml
13+
packages:
14+
solar_router:
15+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
16+
refresh: 1s
17+
files:
18+
# JSY-MK-194T management
19+
- path: solar_router/jsy-mk-194t_common.yaml
20+
vars:
21+
uart_tx_pin: GPIO26
22+
uart_rx_pin: GPIO27
23+
uart_baud_rate: 4800
24+
AP_Ch2_internal: "false" # optional, allows displaying one of the JSY-MK-194T sensors
25+
```
26+
27+
List of available JSY-MK-194T sensors:
28+
29+
```yaml
30+
U_Ch1_internal: "true" # Voltage on Channel 1
31+
I_Ch1_internal: "true" # Current on Channel 1
32+
AP_Ch1_internal: "true" # Active Power on Channel 1
33+
PAE_Ch1_internal: "true" # Positive Active Energy on Channel 1
34+
PF_Ch1_internal: "true" # Power Factor on Channel 1
35+
NAE_Ch1_internal: "true" # Negative Active Energy on Channel 1
36+
PD_Ch1_internal: "true" # Power Direction on Channel 1
37+
PD_Ch2_internal: "true" # Power Direction on Channel 2
38+
frequency_internal: "true" # Frequency
39+
# Voltage on Channel 2 not implemented => same as Voltage on Channel 1
40+
I_Ch2_internal: "true" # Current on Channel 2
41+
AP_Ch2_internal: "true" # Active Power on Channel 2
42+
PAE_Ch2_internal: "true" # Positive Active Energy on Channel 2
43+
PF_Ch2_internal: "true" # Power Factor on Channel 2
44+
NAE_Ch2_internal: "true" # Negative Active Energy on Channel 2
45+
```
46+
47+
## 2 – Standalone Mode
48+
49+
This mode allows the router to be 100% autonomous regarding power sensors. Regulation is therefore more precise and faster than when using Home Assistant entities.
50+
Note that this only works if your system injects surplus power into the grid. Otherwise, see the next section.
51+
52+
```yaml
53+
packages:
54+
solar_router:
55+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
56+
refresh: 1s
57+
files:
58+
# JSY-MK-194T management (as seen previously)
59+
- path: solar_router/jsy-mk-194t_common.yaml
60+
vars:
61+
uart_tx_pin: GPIO26
62+
uart_rx_pin: GPIO27
63+
uart_baud_rate: 4800
64+
AP_Ch2_internal: "false"
65+
66+
# derived energy measurement via JSY-MK-194T
67+
- path: solar_router/energy_counter_jsy-mk-194t.yaml
68+
69+
# in automatic mode, power exchanged with the grid via JSY-MK-194T
70+
- path: solar_router/power_meter_jsy-mk-194t.yaml
71+
```
72+
73+
## 3 – Hybrid Mode
74+
75+
This mode allows the JSY-MK-194T to be used to measure energy on the load only. Grid-level measurement must be done via Home Assistant, using a virtual sensor that reports an estimated injection power.
76+
It is useful in systems with no real grid injection, or where the measurement point is inaccessible or too far away.
77+
78+
```yaml
79+
packages:
80+
solar_router:
81+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
82+
refresh: 1s
83+
files:
84+
- path: solar_router/common.yaml
85+
86+
# JSY-MK-194T management
87+
- path: solar_router/jsy-mk-194t_common.yaml
88+
vars:
89+
uart_tx_pin: GPIO26
90+
uart_rx_pin: GPIO27
91+
uart_baud_rate: 4800
92+
AP_Ch2_internal: "false"
93+
94+
# derived energy measurement via JSY-MK-194T
95+
- path: solar_router/energy_counter_jsy-mk-194t.yaml
96+
97+
# in automatic mode, using JSY-MK-194T for derived energy calculation,
98+
# grid power measurement via Home Assistant (case where JSY has no access
99+
# to the measurement, or in zero-injection mode)
100+
- path: solar_router/power_meter_home_assistant_with_energy_counter_jsy-mk-194t.yaml
101+
vars:
102+
main_power_sensor: sensor.puissance_soutiree_reseau_simulee_prevision_filtree_2
103+
consumption_sensor: sensor.inverter_activepower_load_sys
104+
```
105+
106+
This package needs to know which sensors to use to obtain the energy exchanged with the grid and the energy consumed by the house.
107+
The grid exchange sensor must be defined by `main_power_sensor`, and the consumption sensor by `consumption_sensor`, in the substitutions section of your configuration, as shown above.
108+
109+
- `main_power_sensor` represents the energy exchanged with the grid. It is expected to be in watts (W), positive (>0) when electricity is drawn from the grid and negative (<0) when electricity is fed back into the grid.
110+
111+
- `consumption_sensor` represents the energy consumed by your home. This information allows, for example, calculation of the theoretical rerouted energy.
112+
113+
!!! Warning "Data availability and refresh rate"
114+
This power meter relies on Home Assistant to collect the value of the energy exchanged with the grid. It also depends on the sensor update frequency. If a sensor updates too slowly, regulation may not work as expected.
115+
116+
Unlike Home Assistant power meters, native power meters are autonomous and can continue to regulate even if Home Assistant is offline. Some power meters may have direct access to measurements and can even be independent of the network.

‎docs/en/power_meter_jsy-mk-194t.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# JSY-MK-194T Power Meter
2+
3+
The JSY-MK-194T power meter shares common code with the
4+
[JSY-MK-194T energy counter](energy_counter_jsy-mk-194t.md) to communicate with the module.
5+
The rest of this documentation explains how to configure this common part
6+
and how to configure a JSY-MK-194T power meter.
7+
8+
![jsy-mk-194t](../images/jsy-mk-194t.png)
9+
10+
## 1 – Common Part: Communication with the JSY-MK-194T
11+
12+
This file manages communication with the board. Add `jsy-mk-194t_common.yaml`
13+
and configure the GPIOs according to your hardware as shown in the example below:
14+
15+
```yaml
16+
packages:
17+
solar_router:
18+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
19+
refresh: 1s
20+
files:
21+
# JSY-MK-194T management
22+
- path: solar_router/jsy-mk-194t_common.yaml
23+
vars:
24+
uart_tx_pin: GPIO26
25+
uart_rx_pin: GPIO27
26+
uart_baud_rate: 4800
27+
AP_Ch2_internal: "false" # optional, allows displaying one of the JSY-MK-194T sensors
28+
```
29+
30+
List of available JSY-MK-194T sensors:
31+
32+
```yaml
33+
U_Ch1_internal: "true" # Voltage on Channel 1
34+
I_Ch1_internal: "true" # Current on Channel 1
35+
AP_Ch1_internal: "true" # Active Power on Channel 1
36+
PAE_Ch1_internal: "true" # Positive Active Energy on Channel 1
37+
PF_Ch1_internal: "true" # Power Factor on Channel 1
38+
NAE_Ch1_internal: "true" # Negative Active Energy on Channel 1
39+
PD_Ch1_internal: "true" # Power Direction on Channel 1
40+
PD_Ch2_internal: "true" # Power Direction on Channel 2
41+
frequency_internal: "true" # Frequency
42+
# Voltage on Channel 2 not implemented => same as Voltage on Channel 1
43+
I_Ch2_internal: "true" # Current on Channel 2
44+
AP_Ch2_internal: "true" # Active Power on Channel 2
45+
PAE_Ch2_internal: "true" # Positive Active Energy on Channel 2
46+
PF_Ch2_internal: "true" # Power Factor on Channel 2
47+
NAE_Ch2_internal: "true" # Negative Active Energy on Channel 2
48+
```
49+
50+
## 2 – Enabling the Power Meter
51+
52+
To enable the power meter, simply add it to your configuration as shown
53+
in the example below:
54+
55+
```yaml
56+
packages:
57+
solar_router:
58+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
59+
refresh: 1s
60+
files:
61+
- path: solar_router/power_meter_jsy-mk-194t.yaml
62+
```
63+
64+
For a complete implementation example, refer to the
65+
[JSY-MK-194T example](jsy-mk-194t.md).

‎docs/fr/energy_counter_jsy-mk-194t.md‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Compteur d'énergie JSY-MK-194T
2+
3+
Le compteur d'énergie JSY-MK-194T partage avec le [power meter jsy-mk-194t](powermeter_jsy-mk-194t.md) un code
4+
commun permettant de communique avec le module. La suite de cette documentation explique comment configurer cette partie
5+
commune et comment configurer un compteur d'énergie JSY-MK-194T.
6+
7+
![jsy-mk-194t](../images/jsy-mk-194t.png)
8+
9+
10+
## 1 - Partie Commune, la communication avec le JSY-MK-194T :
11+
12+
Ce fichier gère la communication avec la carte. Vous pouvez, si vous le souhaitez, remonter les mesures du JSY-MK-194T dans Home Assistant, voir l'exemple ci-dessous.
13+
```yaml linenums="1"
14+
packages:
15+
solar_router:
16+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
17+
refresh: 1s
18+
files:
19+
# gestion du JSY-MK-194T
20+
- path: solar_router/jsy-mk-194t_common.yaml
21+
vars:
22+
uart_tx_pin: GPIO26
23+
uart_rx_pin: GPIO27
24+
uart_baud_rate: 4800
25+
AP_Ch2_internal: "false" # optionnel, permet d'afficher un des sensors du JSY-MK-194T
26+
```
27+
Liste des capteurs du JSY-MK-194T accessibles :
28+
```yaml linenums="1"
29+
U_Ch1_internal: "true" # Voltage on Channel 1
30+
I_Ch1_internal: "true" # Current on Channel 1
31+
AP_Ch1_internal: "true" # Active Power of Channel 1
32+
PAE_Ch1_internal: "true" # Positive Active Energy of Channel 1
33+
PF_Ch1_internal: "true" # Power Factor on Channel 1
34+
NAE_Ch1_internal: "true" # Negative Active Energy of Channel 1
35+
PD_Ch1_internal: "true" # Power Direction on Channel 1
36+
PD_Ch2_internal: "true" # Power Direction on Channel 2
37+
frequency_internal: "true" # Frequency
38+
# Voltage on Channel 2 not implemented => same as Voltage on Channel 1
39+
I_Ch2_internal: "true" # Current on Channel 2
40+
AP_Ch2_internal: "true" # Active Power of Channel 2
41+
PAE_Ch2_internal: "true" # Positive Active Energy of Channel 2
42+
PF_Ch2_internal: "true" # Power Factor on Channel 2
43+
NAE_Ch2_internal: "true" # Negative Active Energy of Channel 2
44+
```
45+
46+
## 2 - Activation du compteur d'énergie
47+
48+
Pour activer le compteur d'énergie, il suffit de l'ajouter à votre configuration comme dans l'exemple ci-dessous:
49+
50+
51+
```yaml linenums="1"
52+
packages:
53+
solar_router:
54+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
55+
refresh: 1s
56+
files:
57+
- path: solar_router/energy_counter_jsy-mk-194t.yaml
58+
```
59+
60+
Pour un exemple de mise en oeuvre, reporter vous à l'[exemple JSY-MK-149T](jsy-mk-194t.md).
61+

‎docs/fr/power_meter_jsy-mk-194t.md‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# Power Meter JSY-MK-194T
2+
3+
Le power meter JSY-MK-194T partage avec le [compteur d'énergie jsy-mk-194t](energy_counter_jsy-mk-194t.md) un code
4+
commun permettant de communique avec le module. La suite de cette documentation explique comment configurer cette partie
5+
commune et comment configurer un power meter JSY-MK-194T.
6+
7+
8+
![jsy-mk-194t](../images/jsy-mk-194t.png)
9+
10+
11+
## 1 - Partie Commune, la communication avec le JSY-MK-194T :
12+
13+
Ce fichier gère la communication avec la carte. Ajoutez `jsy-mk-194t_common.yaml` et configurez les GPIO selon votre matériel commen dans l'exemple ci-dessous:
14+
15+
```yaml linenums="1"
16+
packages:
17+
solar_router:
18+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
19+
refresh: 1s
20+
files:
21+
# gestion du JSY-MK-194T
22+
- path: solar_router/jsy-mk-194t_common.yaml
23+
vars:
24+
uart_tx_pin: GPIO26
25+
uart_rx_pin: GPIO27
26+
uart_baud_rate: 4800
27+
AP_Ch2_internal: "false" # optionnel, permet d'afficher un des sensors du JSY-MK-194T
28+
```
29+
30+
Liste des capteurs du JSY-MK-194T accessibles :
31+
```yaml linenums="1"
32+
U_Ch1_internal: "true" # Voltage on Channel 1
33+
I_Ch1_internal: "true" # Current on Channel 1
34+
AP_Ch1_internal: "true" # Active Power of Channel 1
35+
PAE_Ch1_internal: "true" # Positive Active Energy of Channel 1
36+
PF_Ch1_internal: "true" # Power Factor on Channel 1
37+
NAE_Ch1_internal: "true" # Negative Active Energy of Channel 1
38+
PD_Ch1_internal: "true" # Power Direction on Channel 1
39+
PD_Ch2_internal: "true" # Power Direction on Channel 2
40+
frequency_internal: "true" # Frequency
41+
# Voltage on Channel 2 not implemented => same as Voltage on Channel 1
42+
I_Ch2_internal: "true" # Current on Channel 2
43+
AP_Ch2_internal: "true" # Active Power of Channel 2
44+
PAE_Ch2_internal: "true" # Positive Active Energy of Channel 2
45+
PF_Ch2_internal: "true" # Power Factor on Channel 2
46+
NAE_Ch2_internal: "true" # Negative Active Energy of Channel 2
47+
```
48+
49+
## 2 - Activation du power meter
50+
51+
Pour activer le power meter, il suffit de l'ajouter à votre configuration comme dans l'exemple ci-dessous:
52+
53+
```yaml linenums="1"
54+
packages:
55+
solar_router:
56+
url: https://github.com/XavierBerger/Solar-Router-for-ESPHome/
57+
refresh: 1s
58+
files:
59+
- path: solar_router/power_meter_jsy-mk-194t.yaml
60+
```
61+
62+
Pour un exemple de mise en oeuvre, reporter vous à l'[exemple JSY-MK-149T](jsy-mk-194t.md).
63+

‎docs/images/jsy-mk-194t.png‎

137 KB
Loading

‎mkdocs.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ nav:
2020
- Overview: power_meter.md
2121
- Fronius: power_meter_fronius.md
2222
- Home Assistant: power_meter_home_assistant.md
23-
- jsy-mk-194t: power_meter_jsy-mk-194t.md
23+
- JSY-MK-194T : power_meter_jsy-mk-194t.md
2424
- Proxy client: power_meter_proxy_client.md
2525
- Shelly EM: power_meter_shelly_em.md
2626
- Regulator:
@@ -36,7 +36,7 @@ nav:
3636
- 1 x switch: engine_1switch.md
3737
- Energy Counter:
3838
- Theorical: energy_counter_theorical.md
39-
- jsy-mk-194t: power_meter_jsy-mk-194t.md
39+
- JSY-MK-194T : energy_counter_jsy-mk-194t.md
4040
- Temperature limiter:
4141
- Overview: temperature_limiter.md
4242
- Home Assistant: temperature_limiter_home_assistant.md

0 commit comments

Comments
 (0)