From 8e2e690f38ae19b8e8bae27415905e625fd8cfce Mon Sep 17 00:00:00 2001 From: lumapu Date: Mon, 31 Oct 2022 02:48:25 +0100 Subject: [PATCH] heavily improved website added install firmware using ESP Web Tools --- .gitignore | 1 + README.md | 32 ++ content/flash/index.md | 11 + content/getting_started/index.md | 7 + layouts/_default/baseof.html | 7 +- layouts/_default/list.html | 38 +- layouts/_default/single.html | 6 +- layouts/flash/flash.html | 68 +++ layouts/index.html | 56 ++- layouts/partials/nav.html | 2 +- static/css/style.css | 8 + .../221030_ahoy_0.5.28_esp32_2e08ee0.bin | Bin 0 -> 918320 bytes .../221030_ahoy_0.5.28_esp8266_2e08ee0.bin | Bin 0 -> 434864 bytes static/firmware/bootloader.bin | Bin 0 -> 17440 bytes static/firmware/manifest.json | 23 + static/firmware/ota.bin | Bin 0 -> 8192 bytes static/firmware/partitions.bin | Bin 0 -> 3072 bytes static/img/comp/connect.png | Bin 0 -> 36539 bytes static/img/comp/wemosNrf24.png | Bin 0 -> 33864 bytes static/img/comp/wemosNrf24.svg | 439 ++++++++++++++++++ static/img/logo1_small.png | Bin 0 -> 10562 bytes static/img/screenshot/live.png | Bin 0 -> 101540 bytes 22 files changed, 670 insertions(+), 28 deletions(-) create mode 100644 README.md create mode 100644 content/flash/index.md create mode 100644 layouts/flash/flash.html create mode 100644 static/firmware/221030_ahoy_0.5.28_esp32_2e08ee0.bin create mode 100644 static/firmware/221030_ahoy_0.5.28_esp8266_2e08ee0.bin create mode 100644 static/firmware/bootloader.bin create mode 100644 static/firmware/manifest.json create mode 100644 static/firmware/ota.bin create mode 100644 static/firmware/partitions.bin create mode 100644 static/img/comp/connect.png create mode 100644 static/img/comp/wemosNrf24.png create mode 100644 static/img/comp/wemosNrf24.svg create mode 100644 static/img/logo1_small.png create mode 100644 static/img/screenshot/live.png diff --git a/.gitignore b/.gitignore index 1f1befdc..3f5c950f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ /public /.hugo_build.lock +/resources diff --git a/README.md b/README.md new file mode 100644 index 00000000..59904b2f --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +# Information + +This repository contains the sources for [AhoyDTU](http://ahoydtu.de). The sources are converted by a *static site generator* [Hugo](https://gohugo.io/). +The main Repository URL is: [](https://github.com/lumapu/ahoy) + + +# Contribute + +Feel free to modify / add contents of the website which helps other users to understand better how to start or use AhoyDTU. + +## Quick Howto + +* edit files inside the directory `content` most of them are Markdown files (\*.md). +* once you're finish commit your changes (as Pull-Request) +* wait until a collaborator merges your changes + +## Design / CSS + +* this site uses [Bootstrap 5](https://getbootstrap.com/docs/5.2/getting-started/introduction/) + +## Offline convertion of sources to website + +### Docker + +* you can use a local docker container which runs Hugo to convert the sources to a static site: + `docker run --rm -it -v ${pwd}\:/src -p 80:1313 klakegg/hugo:0.101.0-ext-alpine shell` +* from the shell start hugo server by typing `hugo server` +* point your browser to http://localhost + +### Hokus + +Hokus is a WYSIWYG Hugo Editor [](https://www.hokuscms.com/) diff --git a/content/flash/index.md b/content/flash/index.md new file mode 100644 index 00000000..3960ff3f --- /dev/null +++ b/content/flash/index.md @@ -0,0 +1,11 @@ +--- +title: "Install Firmware" +date: 2022-10-26T22:49:15Z +tags: [] +draft: false +type: flash +layout: flash +--- + + +You can easily upload the latest firmware to your ESP. diff --git a/content/getting_started/index.md b/content/getting_started/index.md index c6c12ac7..4e36ad82 100644 --- a/content/getting_started/index.md +++ b/content/getting_started/index.md @@ -27,6 +27,13 @@ The hardware insists only in two modules: ## Software / Firmware +### Guided Installation +Switch to our [Online Installer](/flash) + +### manual Installation The firmware can be found on [Github](https://github.com/lumapu/ahoy). Point to the releases section on the right part of the page and download the zip-file. It contains binaries for both ESP models. +### Compile firmware from sources +n/a + ### Flash diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html index 4a5d4120..15ef0d29 100644 --- a/layouts/_default/baseof.html +++ b/layouts/_default/baseof.html @@ -3,10 +3,9 @@ {{ partial "head.html" . }} {{ partial "nav.html" . }} -
-
- {{ block "main" . }}{{ end }} -
+
+ {{ block "main" . }} + {{ end }}
{{ partial "footer.html" . }} diff --git a/layouts/_default/list.html b/layouts/_default/list.html index e024b4e1..71403f95 100644 --- a/layouts/_default/list.html +++ b/layouts/_default/list.html @@ -1,26 +1,28 @@ {{ define "main" }} -

{{ .Title }}

- {{ range $grp := $.Site.Data.faq.groups }} -
-

{{.name}}

-
- {{ $counter := 0 }} - {{ range .items }} -
- {{ $counter = add $counter 1 }} -

- -

-
-
- {{.answer}} +
+

{{ .Title }}

+ {{ range $grp := $.Site.Data.faq.groups }} +
+

{{.name}}

+
+ {{ $counter := 0 }} + {{ range .items }} +
+ {{ $counter = add $counter 1 }} +

+ +

+
+
+ {{.answer}} +
+ {{ end }}
- {{ end }}
{{ end }} {{ end }} diff --git a/layouts/_default/single.html b/layouts/_default/single.html index 3fca1777..e4878560 100644 --- a/layouts/_default/single.html +++ b/layouts/_default/single.html @@ -1,6 +1,8 @@ {{ define "main" }} -

{{ .Title }}

-{{ .Content }} +
+

{{ .Title }}

+ {{ .Content }} +
{{ end }} diff --git a/layouts/flash/flash.html b/layouts/flash/flash.html new file mode 100644 index 00000000..31a43824 --- /dev/null +++ b/layouts/flash/flash.html @@ -0,0 +1,68 @@ + + + {{ partial "head.html" . }} + + + {{ partial "nav.html" . }} +
+
+

{{ .Title }}

+

{{ .Content }}

+
+

1 Install firmware

+ + + + + + + + +
+

2 Connect to ESP

+
+
+
    +
  • a Your ESP opens an WiFi access point (AP) with SSID AHOY-DTU
    • +
  • b Connect to this WiFi with some client (Laptop, Smartphone)
    • +
  • c The default password is esp_8266
    • +
  • d Navigate to the Settings page
    • +
  • e Open the section WiFi and press Scan
    • +
  • f Select your home network and type your password
    • +
  • g Scroll down, check Reboot device after successful save and press save
    • +
+
+
+
+

3 Find device in home LAN / Wifi

+
+
+
+ option a +
+
+ Check a serial console during boot of ESP. It will print the IP which it got from DHCP server. +
+
+
+
+ option b +
+
+ Check devices listed in your WiFi router (eg. Fritz!Box). You should be able to find an IP-address like 192.168.x.x +
+
+
+
+

4 Settings

+ Point to Settings again and configure the device on your needs. + +
+
+ {{ partial "footer.html" . }} + + diff --git a/layouts/index.html b/layouts/index.html index f80513a0..ef175ebe 100644 --- a/layouts/index.html +++ b/layouts/index.html @@ -1,8 +1,58 @@ {{ define "main" }} -
-

{{ .Site.Title }}

-

{{ .Site.Params.homeText | markdownify }}

+
+ ahoyDTU logo +

{{ .Site.Title }}

+
+

{{ .Site.Params.homeText | markdownify }}

+
+
+ +
+ +
+
+
+

Visualization

+

Read all the values of your Hoymiles® inverter without cloud.
+ Dig deeper into your inverter. All the AC parameters (green area) are read from your inverter. You'll get an extra information field (blue) for each DC input. You're able to monitor your individual panels for shadows or damage.

+
+
+ +
+
+
+ +
+ +
+
+
+ +
+
+

Hardware

+

The hardware consists only of two components: ESP8266 and NRF2401L+ module.
+ As a total hardware cost of 10 - 15€ (depends on distributor) it will be the cheapest part of your photovoltaic system. + The components can be easily soldered together and flashed using our online flash tool

+
+
+
+ +
+ +
+
+
+

Connectivity

+

The Firmware supports MQTT and has an API. All measured values will be published with an individual topic.
+ With MQTT you can use AhoyDTU nearly in all home automatisation systems.
+ The API is based on JSON objects.

+
+
+ +
+
{{ end }} diff --git a/layouts/partials/nav.html b/layouts/partials/nav.html index 8615e535..4dad1a8a 100644 --- a/layouts/partials/nav.html +++ b/layouts/partials/nav.html @@ -7,7 +7,7 @@