Skip to content

Commit

Permalink
Doc update
Browse files Browse the repository at this point in the history
  • Loading branch information
@mathieucarbou
mathieucarbou committed Jul 7, 2024
1 parent f85850b commit 1a2eb1b
Showing 1 changed file with 40 additions and 43 deletions.
83 changes: 40 additions & 43 deletions docs/manual.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ description: Manual
- [Dashboard / Hardware](#dashboard--hardware)
- [Dashboard / Hardware Config](#dashboard--hardware-config)
- [Resistance Calibration](#resistance-calibration)
- [PZEM Pairing](#pzem-pairing)
- [Dashboard / PID Controller](#dashboard--pid-controller)
- [Dashboard / Statistics](#dashboard--statistics)
- [Important Hardware Information](#important-hardware-information)
Expand All @@ -34,8 +35,6 @@ description: Manual
- [JSY-MK-194T](#jsy-mk-194t)
- [Remote JSY](#remote-jsy)
- [LEDs](#leds)
- [PZEM-004T V3](#pzem-004t-v3)
- [Pairing procedure](#pairing-procedure)
- [Temperature Sensor](#temperature-sensor)
- [Zero-Cross Detection](#zero-cross-detection)
- [Compatibility with EV box like OpenEVSE](#compatibility-with-ev-box-like-openevse)
Expand Down Expand Up @@ -410,14 +409,13 @@ All these components are activated **live without the need to restart the router
- `Display Type`: the type of display used.
- `Display Speed`: the speed at which the display will refresh to the next page.
- `Display Rotation`: the rotation of the display.
- `Output 1 PZEM Pairing`: starts the pairing procedure for Output 1 PZEM-004T v3 at address 0x01.
- `Output 2 PZEM Pairing`: starts the pairing procedure for Output 2 PZEM-004T v3 at address 0x02.
- `Output 1 Bypass Relay Type`: the type of relay for Output 1 Bypass: Normally Open or Normally Closed.
- `Output 2 Bypass Relay Type`: the type of relay for Output 2 Bypass: Normally Open or Normally Closed.
- `Relay 1 Type`: the type of relay for Relay 1: Normally Open or Normally Closed.
- `Relay 2 Type`: the type of relay for Relay 2: Normally Open or Normally Closed.
- `NO / NC Relay Types`
- `Output 1 Bypass Relay Type`: the type of relay for Output 1 Bypass: Normally Open or Normally Closed.
- `Output 2 Bypass Relay Type`: the type of relay for Output 2 Bypass: Normally Open or Normally Closed.
- `Relay 1 Type`: the type of relay for Relay 1: Normally Open or Normally Closed.
- `Relay 2 Type`: the type of relay for Relay 2: Normally Open or Normally Closed.

**If you change one of these settings, please stop and restart the corresponding Hardware.**
**If you change one of these settings above, please restart the corresponding hardware or the YaSolR device.**

### Resistance Calibration

Expand All @@ -438,6 +436,39 @@ Then you just have to report it in the `Hardware Config` page.
3. **JSY-MK-194T:** If you have a JSY-MK-194T, you can activate the dimmer one by one to 100% and wait for the values to stabilize.
The router will then display the resistance value in the `Overview` page, thanks to the JSY.

### PZEM Pairing

- `Output 1 PZEM Pairing`: starts the pairing procedure for Output 1 PZEM-004T v3 at address 0x01.
- `Output 2 PZEM Pairing`: starts the pairing procedure for Output 2 PZEM-004T v3 at address 0x02.

Each output supports the addition of a PZEM-004T v3 sensor to monitor the power sent to the resistive load specifically for this output.
Thanks to the PZEM per output, it is also possible to get some more precise information like the dimmed RMS voltage, resistance value, etc.

The PZEM-004T v3 devices has a special installation mode: you can install 2 PZEM-004T v3 devices on the same Serial TX/RX.
To communicate with the right one, each output will use a different slave address.
The initial setup requires to pair each PZEM-004T v3 with the corresponding output.

1. Connect the 2 PZEM-004T v3 devices to the grid (L/N) and install the clamp around the wire at the exit of the dimmer of first output
2. Only connect the terminal wire (+5V, GND, RX, TX) of the first PZEM-004T v3 to pair to Output 1
3. Boot the ESP32 wit the router firmware
4. Press the `PZEM Pairing` button in the `Output 1` menu
5. Verify that the pairing is successful
6. Disconnect the PZEM-004T v3 from the ESP32
7. Connect the second PZEM (which has its clamp at the exit of the dimmer of the second output) to the ESP32
8. Press the `PZEM Pairing` button in the `Output 2` menu this time
9. Verify that the pairing is successful
10. Now connect the 2 PZEM-004T v3 devices to the ESP32

You can verify that the pairing is successful by trying to activate the dimmer in the overview page, and see if you get the output power.

Check also the logs in the Web Console at `http://yasolr-vwxyz.local/console` while doing the pairing procedure.

This complex pairing procedure is not specific to this router project but is common to any PZEM-004T device when using several PZEM-004T v3 devices on the same Serial TX/RX.
You can read more at:

- [mathieucarbou/MycilaPZEM004Tv3](https://github.com/mathieucarbou/MycilaPZEM004Tv3)
- [mandulaj/PZEM-004T-v30](https://github.com/mandulaj/PZEM-004T-v30)

## Dashboard / PID Controller

[![](assets/img/screenshots/pid_tuning.jpeg)](assets/img/screenshots/pid_tuning.jpeg)
Expand Down Expand Up @@ -599,40 +630,6 @@ The LEDs are used to notify the user of some events like reset, restarts, router
- `RESET`: application is restarting following a manual reset
- `OFF`: application not working (power off)

### PZEM-004T V3

Each output supports the addition of a PZEM-004T v3 sensor to monitor the power sent to the resistive load specifically for this output.
This also unlocks some additional features such as **independent outputs** and the ability to balance the excess power between outputs.

Thanks to the PZEM per output, it is also possible to get some more precise information like the dimmed RMS voltage, resistance value, etc.

#### Pairing procedure

The PZEM-004T v3 devices has a special installation mode: you can install 2 PZEM-004T v3 devices on the same Serial TX/RX.
To communicate with the right one, each output will use a different slave address.
The initial setup requires to pair each PZEM-004T v3 with the corresponding output.

1. Connect the 2 PZEM-004T v3 devices to the grid (L/N) and install the clamp around the wire at the exit of the dimmer of first output
2. Only connect the terminal wire (+5V, GND, RX, TX) of the first PZEM-004T v3 to pair to Output 1
3. Boot the ESP32 wit the router firmware
4. Press the `PZEM Pairing` button in the `Output 1` menu
5. Verify that the pairing is successful
6. Disconnect the PZEM-004T v3 from the ESP32
7. Connect the second PZEM (which has its clamp at the exit of the dimmer of the second output) to the ESP32
8. Press the `PZEM Pairing` button in the `Output 2` menu this time
9. Verify that the pairing is successful
10. Now connect the 2 PZEM-004T v3 devices to the ESP32

You can verify that the pairing is successful by trying to activate the dimmer in the overview page, and see if you get the output power.

Check also the logs in the Web Console at `http://yasolr-vwxyz.local/console` while doing the pairing procedure.

This complex pairing procedure is not specific to this router project but is common to any PZEM-004T device when using several PZEM-004T v3 devices on the same Serial TX/RX.
You can read more at:

- [mathieucarbou/MycilaPZEM004Tv3](https://github.com/mathieucarbou/MycilaPZEM004Tv3)
- [mandulaj/PZEM-004T-v30](https://github.com/mandulaj/PZEM-004T-v30)

### Temperature Sensor

The temperature sensors are used to monitor the water tank but also to trigger an automatic heating based on temperature levels (called **auto bypass**).
Expand Down

0 comments on commit 1a2eb1b

Please sign in to comment.