update doc

mathieucarbou · Jul 15, 2024 · f83988a · f83988a
1 parent 5f87f94
commit f83988a
Show file tree

Hide file tree

Showing 6 changed files with 156 additions and 83 deletions.
diff --git a/docs/blog.md b/docs/blog.md
@@ -6,7 +6,7 @@ description: Blog
 
 # Blog
 
-- [2024-07-01 - Shelly Solar Diverter](/blog/2024-07-01_shelly_solar_diverter)
+- [2024-07-01 - Shelly Solar Diverter / Router](/blog/2024-07-01_shelly_solar_diverter)
 - [2024-06-26 - Everything on le JSY](/blog/2024-06-26_everything_on_the_jsy)
 - [2024-06-25 - Remote JSY through UDP](/blog/2024-06-25_remote_jsy)
 - [2024-06-23 - Development is still in progress](/blog/2024-06-23_development_is_still_in_progress)
diff --git a/docs/blog/2024-07-01_shelly_solar_diverter.md b/docs/blog/2024-07-01_shelly_solar_diverter.md
@@ -8,9 +8,9 @@ _Date: 2024-07-01_
 
 _I've put the YaSolR project in pause for a few days to work on this very cool and awesome Shelly integration..._
 
-# Shelly Solar Diverter
+# Shelly Solar Diverter / Router
 
-| [![](../assets/img/hardware/shelly_solar_diverter_poc2.jpeg)](../assets/img/hardware/shelly_solar_diverter_poc2.jpeg) | [![](../assets/img/screenshots/shelly_solar_diverter.jpeg)](../assets/img/screenshots/shelly_solar_diverter.jpeg)  |
+| [![](../assets/img/hardware/shelly_solar_diverter_poc2.jpeg)](../assets/img/hardware/shelly_solar_diverter_poc2.jpeg) | [![](../assets/img/screenshots/shelly_solar_diverter.jpeg)](../assets/img/screenshots/shelly_solar_diverter.jpeg) |
 
 - [What is a Solar Router / Diverter ?](#what-is-a-solar-router--diverter-)
 - [Shelly Solar Diverter](#shelly-solar-diverter-1)
@@ -46,7 +46,7 @@ A solar router can also do more things, like controlling (on/off) the activation
 
 A router can also schedule some forced heating of the water tank to ensure the water reaches a safe temperature, and consequently bypass the dimmed voltage. This is called a bypass relay.
 
-## Shelly Solar Diverter
+## Shelly Solar Diverter Features
 
 - **Unlimited dimmers (output)**
 - **PID Controller**

diff --git a/docs/build.md b/docs/build.md
@@ -6,8 +6,12 @@ description: Build
 
 # How to build your router
 
-- [Build Types](#build-types)
-  - [Examples of Shopping Lists](#examples-of-shopping-lists)
+- [Build Examples](#build-examples)
+  - [The Minimalist](#the-minimalist)
+  - [The Adventurer](#the-adventurer)
+  - [The Elite](#the-elite)
+  - [The Professional (🚧)](#the-professional-%F0%9F%9A%A7)
+  - [Possible Upgrades](#possible-upgrades)
 - [Default GPIO pinout per board](#default-gpio-pinout-per-board)
 - [Selecting your Hardware](#selecting-your-hardware)
   - [ESP32 Boards](#esp32-boards)
@@ -25,65 +29,87 @@ description: Build
   - [Mounting Accessories](#mounting-accessories)
 - [Pictures of some routers](#pictures-of-some-routers)
 
-## Build Types
+## Build Examples
 
 YaSolR supports many builds and routing algorithms.
-Before building your router, you need to decide which type of technology you want to use to dim the voltage (_Burst Mode_ or _Phase Control_).
-Here is a compatibility matrix for the main pieces of hardware depending on the router type you want to build.
+Before building your router, you need to decide which type of hardware you want to use.
 
-Once you have picked up your build type, you can look at the Wiring Schema to know how to wire it and see the [Compatible Hardware](#compatible-hardware) section to know what you need to buy.
+### The Minimalist
 
-| Hardware                        | Phase Control _(\*3)_ | Burst Mode |     Nominal Load _(\*1)_      | Wiring Schemas             |
-| :------------------------------ | :-------------------: | :--------: | :---------------------------: | :------------------------- |
-| Robodyn 24A<br>_(alone)_        |          ✅           |     ✅     |           < 2000 W            | // TODO: add wiring schema |
-| Robodyn 40A<br>_(alone)_        |          ✅           |     ✅     |           < 3000 W            | // TODO: add wiring schema |
-| Random SSR<br>+ ZCD Circuit     |          ✅           |     ✅     | 1/3 of SSR rated load _(\*2)_ | // TODO: add wiring schema |
-| Zero-Cross SSR<br>+ ZCD Circuit |          ❌           |     ✅     | 1/3 of SSR rated load _(\*2)_ | // TODO: add wiring schema |
+The _Minimalist_ build uses inexpensive and easy to use components to start a router.
 
-- **(\*1)**: In example, a 24A Triac would support a maximum peak of 24A but it is advised to not go over 1/3 - 1/2 for the nominal load. Some people also replace the TRIAC with a better one (see [Compatible Hardware](#compatible-hardware) below)\_
-- **(\*2)**: _Max Load for SSR depends on the supported SSR load. Use 1/3 rule for safety_
-- **(\*3)**: Generate _harmonics_, an effect of phase control system. This is not wrong if properly maintained at an acceptable level as per the regulations.\_
+|                              ESP32-DevKitC                               |                       Robodyn AC Dimmer 40A/800V                       |                     JSY-MK-194T with 2 remote clamps                     |
+| :----------------------------------------------------------------------: | :--------------------------------------------------------------------: | :----------------------------------------------------------------------: |
+| <img src="./assets/img/hardware/ESP32_NodeMCU.jpeg" style="width:150px"> | <img src="./assets/img/hardware/Robodyn_40A.jpeg" style="width:150px"> | <img src="./assets/img/hardware/JSY-MK-194T_2.jpeg" style="width:150px"> |
 
-**Hint:** Remember that according to regulations about harmonic, the maximum power should be at around 750W.
-More than that, you are supposed to put in place filtering systems to reduce the harmonics.
-So if you want to build a router that is compliant with the regulations, any build type will be fine as long as you pay attention to the generated harmonic level.
+Notes:
 
-**Bypass:** Whatever the solution you pick, you can always add an optional bypass relay to send the full power to the load instead of dimming it, free of harmonics.
-If no bypass relay is added, the dimmer will be used instead at 100% when pressing the bypass.
+- Robodyn includes Zero-Cross Detection circuit
+- Supports **Phase Control** and **Burst mode**
+- Advised load not more than 2000W
+- Robodyn has poor quality heat sink, soldering and Zero-Cross pulse
+- Bypass mode will use the Robodyn dimmer at 100% power
 
-### Examples of Shopping Lists
+### The Adventurer
 
-For each example below, you can add:
+The _Adventurer_ build is for people who are able to mitigate the flaws of the Robodyn 24A to improve it.
+The TRIAC can be changed to a BTA40-800B RD91 fixed directly on the heat sink, and the heat sink can be upgraded.
+See the [Robodyn](#robodyn) section for more information.
 
-- ESP32 NodeMCU Dev Kit C
-- DIN Rail Mount for ESP32 NodeMCU Dev Kit C
-- HDR-15-5 (to power the ESP)
-- 1x or 2x 2-Channel 5V DC / 30A Dual Electromagnetic Relays on DIN Rail (for bypass relay + external relay)
-- JSY (to measure the grid power and total routed power)
-- 1x or 2x PZEM-004T (to measure each output individually and more precisely)
-- Cables, LEDs, etc
+|                              ESP32-DevKitC                               |                       Robodyn AC Dimmer 24A/600V                       |                              Heat Sink                               |                         Triac BTA40-800B RD91                         | JSY-MK-194T with 2 remote clamps                                         |
+| :----------------------------------------------------------------------: | :--------------------------------------------------------------------: | :------------------------------------------------------------------: | :-------------------------------------------------------------------: | ------------------------------------------------------------------------ |
+| <img src="./assets/img/hardware/ESP32_NodeMCU.jpeg" style="width:150px"> | <img src="./assets/img/hardware/Robodyn_24A.jpeg" style="width:150px"> | <img src="./assets/img/hardware/Heat_Sink.jpeg" style="width:150px"> | <img src="./assets/img/hardware/BTA40-800B.jpeg" style="width:150px"> | <img src="./assets/img/hardware/JSY-MK-194T_2.jpeg" style="width:150px"> |
 
-**Example 1: For loads up to 2000 W**
+Notes:
 
-- Robodyn 40A/800V (placed vertically)
+- Robodyn includes Zero-Cross Detection circuit
+- Supports **Phase Control** and **Burst mode**
+- Advised load not more than 2000-3000W if correctly wired and dimensioned
+- Robodyn has poor quality heat sink, soldering and Zero-Cross pulse
+- Bypass mode will use the Robodyn dimmer at 100% power
+- Requires to unsolder the heat sink and triac and put a new triac on a new heat sink
 
-**Example 2: For loads up to 2000 W**
+### The Elite
 
-- Vertical Heat Sink
-- Robodyn 24A/600V (but we move the Triac on the Heat Sink above)
+The _Elite_ build is for people who want to use a Random SSR instead of a Robodyn to safely dim more power and have a better Zero-Cross Detection circuit more more precising routing.
 
-**Example 3: For loads up to 3000 W**
+|                              ESP32-DevKitC                               |                       Random Solid State Relay                        |                              Heat Sink                               |                  Zero-Cross Detection Module                   | JSY-MK-194T with 2 remote clamps                                         |
+| :----------------------------------------------------------------------: | :-------------------------------------------------------------------: | :------------------------------------------------------------------: | :------------------------------------------------------------: | ------------------------------------------------------------------------ |
+| <img src="./assets/img/hardware/ESP32_NodeMCU.jpeg" style="width:150px"> | <img src="./assets/img/hardware/Random_SSR.jpeg" style="width:150px"> | <img src="./assets/img/hardware/Heat_Sink.jpeg" style="width:150px"> | <img src="./assets/img/hardware/ZCD.jpeg" style="width:150px"> | <img src="./assets/img/hardware/JSY-MK-194T_2.jpeg" style="width:150px"> |
 
-- Vertical Heat Sink
-- Triac BTA40-800B RD91 (mounted on the heat sink)
-- Robodyn 24A/600V (but we replace the Triac with the one above)
+- Dedicated ZCD circuit with a good pulse
+- Dedicated Random SSR (models up to 100A)
+- Supports **Phase Control** and **Burst mode**
+- Other types of Heat Sink are available: the image above is just an example.
+  Pick one according to your load.
 
-**Example 4: For any load - SSR based**
+### The Professional (🚧)
 
-- Random Solid State Relay: rated 3x your load (i.e. 40DA for max 3000W)
-- Heat Sink for SSR (matching your load, vertical ideally)
-- DIN Rail clip for SSR
-- ZCD module + DIN Rail mount
+The _Professional_ build uses a Voltage Regulator to control the power routing.
+This is probably the best reliable and efficient solution, but it is more complex to setup and wire.
+It requires an additional 12V power supply.
+
+|                              ESP32-DevKitC                               |                           Voltage Regulator                            |                                Heat Sink                                 |                        PWM to Analog Converter                         | JSY-MK-194T with 2 remote clamps                                         |
+| :----------------------------------------------------------------------: | :--------------------------------------------------------------------: | :----------------------------------------------------------------------: | :--------------------------------------------------------------------: | ------------------------------------------------------------------------ |
+| <img src="./assets/img/hardware/ESP32_NodeMCU.jpeg" style="width:150px"> | <img src="./assets/img/hardware/LSA-H3P50YB.jpeg" style="width:150px"> | <img src="./assets/img/hardware/lsa_heat_sink.jpeg" style="width:150px"> | <img src="./assets/img/hardware/PWM_33_0-10.jpeg" style="width:150px"> | <img src="./assets/img/hardware/JSY-MK-194T_2.jpeg" style="width:150px"> |
+
+- Supports **Phase Control** and **Burst mode**
+- Voltage Regulators are available for big loads
+- Heat sink are bigger and better quality: bigger models are also available
+- Requires an additional 12V power supply (i.e. Mean Well HDR-15-15 12V DC)
+
+### Possible Upgrades
+
+Here are below what you can add to upgrade your router:
+
+|                                Hardware                                | Description                                                                                                               |
+| :--------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------ |
+| <img src="./assets/img/hardware/DIN_2_Relay.jpeg" style="width:150px"> | A bypass relay to avoid using the dimmer when auto bypass is enabled, and an additional relay to control an external load |
+|   <img src="./assets/img/hardware/DS18B20.jpeg" style="width:150px">   | A temperature sensor to measure the water tank temperature to automatically stop or start the water heating               |
+| <img src="./assets/img/hardware/PushButton.jpeg" style="width:150px">  | A push button to restart the router easily                                                                                |
+|    <img src="./assets/img/hardware/LEDs.jpeg" style="width:150px">     | LEDs to display the system status                                                                                         |
+|   <img src="./assets/img/hardware/SH1106.jpeg" style="width:150px">    | A display to show the router information                                                                                  |
+|  <img src="./assets/img/hardware/PZEM-004T.jpeg" style="width:150px">  | A PZEM to precisely measure the routed power for each output. Only useful if you have more than one output.               |
 
 ## Default GPIO pinout per board