Add basic ESP32 Firmware support (#302)

* WIP add esp web tools dep

* basic demo

* wording

* create initial fw manifest

* Add test fw

config/_default/config.toml

@@ -87,3 +87,6 @@ rel  = "sitemap"
   [[module.mounts]]
     source = "node_modules/clipboard"
     target = "assets/js/vendor/clipboard"
+  [[module.mounts]]
+    source = "node_modules/esptool-js"
+    target = "assets/js/vendor/esptool-js"

content/configurators/esp32.html

@@ -0,0 +1,30 @@
+---
+title: "OpenPPG ESP32 Configurator"
+description: "Upgrade firmware on your OpenPPG device via USB"
+helplink: "/docs/controllers/esp32/"
+date: 2022-02-28T15:34:28-06:00\
+configurator: "esp32"
+draft: false
+---
+
+
+<div class="row">
+  <div class="col-md-8 my-4">
+    <div class="card card-body bg-light">
+      <h4 class="card-title mt-0">Upgrades </h4>
+      <small class="text-muted">New firmware can add features and improve functionality.</small>
+      <h5>Latest ESP32 firmware </h5>
+      <span><a href="https://github.com/openppg/eppg-controller/releases/" target="_blank">Release notes <i class="fas fa-info-circle"></i></a></span>
+      <div class="row mb-4">
+        <div class="col-md-5 mb-2">
+          <esp-web-install-button
+            manifest="/esp32-manifest.json">
+            <button slot="activate" class="btn btn-primary btn-lg">Install</button>
+            <span slot="unsupported">Ah snap, your browser doesn't work! Please use Chrome.</span>
+            <span slot="not-allowed">Ah snap, you are not allowed to use this on HTTP!</span>
+          </esp-web-install-button>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>

layouts/partials/head/script-header.html

@@ -19,7 +19,14 @@
   {{ $configPath := (printf "js/configurator/%s.js" (.Param "configurator") )}}
   <script src="/js/vendor/serial.js"></script>
   <script src="/js/vendor/weather.js"></script>
-
+  <!-- ESP Web Tools lives at node_modules/esptool-js/bundle.js
+  {{ $espWebTools := resources.Get "js/vendor/esptool-js/bundle.js" -}}
+  <script src="{{ $espWebTools.Permalink }}" crossorigin="anonymous"></script>
+  -->
+  <script
+    type="module"
+    src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module"
+  ></script>
   {{ if eq (hugo.Environment) "development" -}}
     {{ $configuratorJs := resources.Get $configPath }}
     <script src="{{ $configuratorJs.Permalink }}"></script>

package.json

@@ -62,5 +62,8 @@
   },
   "overrides": {
     "semver": "^7.5.4"
+  },
+  "dependencies": {
+    "esp-web-tools": "^10.0.1"
   }
 }

static/esp32-manifest.json

@@ -0,0 +1,21 @@
+{
+  "name": "OpenPPG  Firmware",
+  "version": "7.0.0",
+  "new_install_prompt_erase": true,
+  "builds": [
+    {
+      "chipFamily": "ESP32-S3",
+      "ota": {
+        "path": "24.11.1/esp-web-tools-example-esp32s3.ota.bin",
+        "summary": "## What's Changed\r\n* Updates for OpenPPG 7.0.0 testing in https://github.com/openppg/eppg-controller/pull/\r\n",
+        "release_url": "https://github.com/openppg/eppg-controller/releases/tag/7.0.0"
+      },
+      "parts": [
+        {
+          "path": "firmware/test-firmware-merged.bin",
+          "offset": 0
+        }
+      ]
+    }
+  ]
+}