www

www/docs/.vitepress/cache/deps/_metadata.json

 {
-  "hash": "d3ab6274",
-  "browserHash": "79a0a541",
+  "hash": "d11bbcee",
+  "browserHash": "dd850f88",
   "optimized": {
     "vue": {
       "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
       "file": "vue.js",
-      "fileHash": "21135a86",
+      "fileHash": "1313eaeb",
       "needsInterop": false
     },
     "vue3-json-viewer": {
       "src": "../../../../node_modules/vue3-json-viewer/dist/bundle.esm.js",
       "file": "vue3-json-viewer.js",
-      "fileHash": "f3d91a1d",
+      "fileHash": "b8b43e0c",
       "needsInterop": false
     }
   },

www/docs/.vitepress/config.ts

@@ -66,8 +66,8 @@ export default defineConfig({
         text: "Guide",
         items: [
           {
-            text: "Introduction",
-            link: "/guide/intro",
+            text: "Overview",
+            link: "/guide/overview",
             items: [
               {
                 text: "Tested Inverters",
@@ -102,8 +102,12 @@ export default defineConfig({
         text: "Examples",
         items: [
           { text: "Overview", link: "/examples/overview" },
-          { text: "Lovelace", link: "/examples/lovelace" },
-          { text: "Settings", link: "/examples/lovelace-settings" },
+          { text: "Lovelace",
+            link: "/examples/lovelace",
+            items: [
+              { text: "Settings", link: "/examples/lovelace-settings" },
+            ],
+          },
           { text: "Automations", link: "/examples/a-mode" },
           { text: "Templates", link: "/examples/templates" },
         ],
@@ -130,4 +134,9 @@ export default defineConfig({
       indexName: "sunsynk",
     },
   },
+  markdown: {
+    config: md => {
+      md.use(require('markdown-it-imsize'))
+    },
+  },
 });

www/docs/.vitepress/theme/custom.css

@@ -4,4 +4,14 @@
     --vp-c-brand-light: #4e60c7;
     --vp-home-hero-name-color:
   }
-*/
\ No newline at end of file
+*/
+:root {
+--vp-c-green: #0d6efd;
+--vp-c-green-light: #6cb2eb;
+--vp-c-green-lighter: #aed2f1;
+--vp-c-green-dark: #0c4b9b;
+--vp-c-green-darker: #03254c;
+--vp-c-green-dimm-1: rgba(13, 110, 253, 0.05);
+--vp-c-green-dimm-2: rgba(13, 110, 253, 0.2);
+--vp-c-green-dimm-3: rgba(13, 110, 253, 0.5);
+}
\ No newline at end of file

www/docs/examples/a-mode.md

@@ -92,6 +92,7 @@ SENSORS:
 ```
 
 ::: details Automations
+Automation 1
 ```yaml
 alias: SS Load Limit Essentials
 trigger:
@@ -107,6 +108,7 @@ action:
 mode: single
 ```
 
+Automation 2
 ```yaml
 alias: SS Load Limit Zero Export
 trigger:
@@ -122,3 +124,41 @@ action:
 mode: single
 ```
 :::
+
+
+## Detecting power failures / Load shedding
+
+This can be achieved with any of the following sensors
+
+- `Grid connected status`
+- `Grid frequency` drops below a certain value
+- `Grid voltage` drops below a certain value
+
+The example automation below creates a binary_sensor from the grid frequency and sends out notification on power failure and the duration of the failure (with some sane back-offs). It serves as a reminder that load shadding is a reality.
+
+:: details Configuration package (yaml)
+Place this file in `/config/packages/alert.yaml` and enable configuration for the `packages` folder (refer to the HA docs [here](https://www.home-assistant.io/docs/configuration/packages/#create-a-packages-folder))
+
+```yaml
+template:
+  binary_sensor:
+    - name: Load shedding
+      state: "{{ states('sensor.ss_grid_frequency') | default (50) | int(0) < 40  }}"
+
+alert:
+  load_shed:
+    name: "Load shedding"
+    message: "The power is off for - {{ relative_time(states.binary_sensor.load_shedding.last_changed) }}"
+    done_message: "The power is back on"
+    entity_id: binary_sensor.load_shedding
+    repeat:
+      - 2
+      - 30
+      - 60
+      - 120
+    can_acknowledge: true  # Optional, default is true
+    skip_first: true  # Optional, false is the default
+    notifiers:
+      - mobile_app_johann_iphone
+```
+:::

www/docs/guide/deployment-options.md

@@ -41,15 +41,15 @@ If the RJ-45 connector on the inverter side is crimped according to [T568A/T568B
 
    This is my preferred adaptor. It includes a GND and lightning/ESD protection, TVS diodes and a resettable fuse.
 
-   Wave also has a RS485-to-Ethernet module. (which does not work!)
+   ![Wave](../images/usb-wave-rs485.webp =360x360)
 
-   <img src="https://github.com/kellerza/sunsynk/raw/main/images/usb-wave-rs485.jpg" width="55%">
+   Wave also has a RS485-to-Ethernet module. (which does not work!)
 
 2. USB-to-RS485 adaptor with cable [example](https://www.robotics.org.za/index.php?route=product/product&product_id=5947)
 
    Includes a GND and TVS diode and USB self recovery options.
 
-   <img src="https://github.com/kellerza/sunsynk/raw/main/images/usb-rs485-cable.jpg" width="55%">
+   ![Cable](../images/usb-rs485-cable.webp =360x360)
 
 Other tested adaptors
 - USB-to-RS485 3 Pin adaptor [example](https://www.robotics.org.za/RS485-3P)
@@ -60,8 +60,7 @@ Other tested adaptors
 - 2-Wire USB-to-RS485 [example](https://www.robotics.org.za/RS485-MINI)
 
   This is the adaptor I started with. It works, but does not include a GND, so your success might vary.
-
-  <img src="https://github.com/kellerza/sunsynk/raw/main/images/usb-rs485-rj45.png" width="35%">
+  ![2-wire](../images/usb-rs485-rj45.webp =250x250)
 
 ## RS485 gateways
 
@@ -73,8 +72,8 @@ Other tested adaptors
 
 2. HF5142B  Modbus/serial to ethernet (4x RS232/485/422 to 4x E-Ports)
 
-   ![settings](https://github.com/kellerza/sunsynk/raw/main/images/eth-hf5142.png)
+   ![gateway](../images/eth-hf5142.webp)
 
    This gateway was tested with the Deye 8k EU Hybrid inverter. The following serial settings were used:
 
-   <img src="https://github.com/kellerza/sunsynk/raw/main/images/eth-hf5142-settings.png" width="80%" alt="settings">
+   ![settings](../images/eth-hf5142-settings.webp =400x400)

www/docs/index.md

@@ -9,7 +9,10 @@ hero:
     alt: sunsynk
   actions:
     - theme: brand
-      text: Getting Started
+      text: Overview
+      link: /guide/overview
+    - theme: alt
+      text: Installation
       link: /guide/getting-started
     - theme: alt
       text: Addon Options

www/package-lock.json

@@ -13,7 +13,9 @@
       },
       "devDependencies": {
         "js-yaml": "^4.1.0",
-        "sitemap-ts": "^1.1.0",
+        "markdown-it-deflist": "^2.1.0",
+        "markdown-it-imsize": "^2.0.1",
+        "sitemap-ts": "^1.2.2",
         "vitepress": "^1.0.0-alpha.60",
         "vue": "^3.2.40",
         "vue3-json-viewer": "^2.2.2"
@@ -1148,6 +1150,18 @@
         "sourcemap-codec": "^1.4.8"
       }
     },
+    "node_modules/markdown-it-deflist": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/markdown-it-deflist/-/markdown-it-deflist-2.1.0.tgz",
+      "integrity": "sha512-3OuqoRUlSxJiuQYu0cWTLHNhhq2xtoSFqsZK8plANg91+RJQU1ziQ6lA2LzmFAEes18uPBsHZpcX6We5l76Nzg==",
+      "dev": true
+    },
+    "node_modules/markdown-it-imsize": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/markdown-it-imsize/-/markdown-it-imsize-2.0.1.tgz",
+      "integrity": "sha512-5SH90ademqcR8ifQCBXRCfIR4HGfZZOh5pO0j2TglulfSQH+SBXM4Iw/QlTUbSoUwVZArCYgECoMvktDS2kP3w==",
+      "dev": true
+    },
     "node_modules/merge2": {
       "version": "1.4.1",
       "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
@@ -2360,6 +2374,18 @@
         "sourcemap-codec": "^1.4.8"
       }
     },
+    "markdown-it-deflist": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/markdown-it-deflist/-/markdown-it-deflist-2.1.0.tgz",
+      "integrity": "sha512-3OuqoRUlSxJiuQYu0cWTLHNhhq2xtoSFqsZK8plANg91+RJQU1ziQ6lA2LzmFAEes18uPBsHZpcX6We5l76Nzg==",
+      "dev": true
+    },
+    "markdown-it-imsize": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/markdown-it-imsize/-/markdown-it-imsize-2.0.1.tgz",
+      "integrity": "sha512-5SH90ademqcR8ifQCBXRCfIR4HGfZZOh5pO0j2TglulfSQH+SBXM4Iw/QlTUbSoUwVZArCYgECoMvktDS2kP3w==",
+      "dev": true
+    },
     "merge2": {
       "version": "1.4.1",
       "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",