From b25c7221541b88cf3f5835beeedbd9594cf2ac4f Mon Sep 17 00:00:00 2001
From: Ricardo Lanziano <ricardo.lanziano@erlang-solutions.com>
Date: Sat, 4 May 2024 23:35:10 -0500
Subject: [PATCH] Initial stab at the web installer

Signed-off-by: Ricardo Lanziano <ricardo.lanziano@erlang-solutions.com>
---
 .github/workflows/docs.yaml          | 11 +++--
 .github/workflows/esp32-mkimage.yaml |  2 +-
 installer/manifest.json              | 12 +++++
 markdown/installer.md                | 67 ++++++++++++++++++++++++++++
 workshop.md => markdown/workshop.md  |  0
 rebar.config                         |  2 +-
 6 files changed, 89 insertions(+), 5 deletions(-)
 create mode 100644 installer/manifest.json
 create mode 100644 markdown/installer.md
 rename workshop.md => markdown/workshop.md (100%)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index a46c1a1..bf2f7e6 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -27,21 +27,26 @@ jobs:
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     env:
       imageOS: ubuntu22
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-tags: true
+          fetch-depth: 0
       - name: Setup Erlang
         uses: erlef/setup-beam@v1
         with:
           otp-version: '26.2'
-          rebar3-version: '3.22.1'
+          rebar3-version: '3.23.0'
       - name: Setup Pages
         uses: actions/configure-pages@v4
       - name: Generate documentation
-        run: rebar3 ex_doc
+        run: |
+          rebar3 ex_doc
+          cp installer/manifest.json doc/
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
diff --git a/.github/workflows/esp32-mkimage.yaml b/.github/workflows/esp32-mkimage.yaml
index 0815573..b098877 100644
--- a/.github/workflows/esp32-mkimage.yaml
+++ b/.github/workflows/esp32-mkimage.yaml
@@ -53,7 +53,7 @@ jobs:
       with:
         otp-version: ${{ matrix.otp }}
         elixir-version: ${{ matrix.elixir_version }}
-        rebar3-version: '3.22.1'
+        rebar3-version: '3.23.0'
 
     - name: "APT update"
       run: apt update -y
diff --git a/installer/manifest.json b/installer/manifest.json
new file mode 100644
index 0000000..24b152d
--- /dev/null
+++ b/installer/manifest.json
@@ -0,0 +1,12 @@
+{
+  "name": "C3card",
+  "version": "v0.2.0",
+  "builds": [
+    {
+      "chipFamily": "ESP32-C3",
+      "parts": [
+        { "path": "https://github.com/esl/c3card/releases/download/v0.2.0/AtomVM-c3card-esp32c3-master.img", "offset": 0 }
+      ]
+    }
+  ]
+}
diff --git a/markdown/installer.md b/markdown/installer.md
new file mode 100644
index 0000000..5ed34e4
--- /dev/null
+++ b/markdown/installer.md
@@ -0,0 +1,67 @@
+# Installer
+
+## Installation instructions
+
+### Requirements
+
+- Compatible Browsers: Chrome or Edge on Desktop. Android support is
+  currently not available.
+
+- Required Drivers: Ensure your computer has the necessary drivers
+  installed for ESP devices.
+
+### Step-by-Step Guide
+
+#### Initial checklist
+
+- Use Google Chrome or Microsoft Edge on a desktop computer to access
+  the installation tools.
+
+- Confirm that your `c3card` is connected to your computer. If the
+  device is not recognized, you may need to install additional
+  drivers.
+
+#### Install drivers if needed
+
+- If your `c3card` is not detected, it's likely due to missing
+  drivers. Below are links to download drivers for the most common USB
+  serial chips used in ESP devices:
+
+	- **CP2102 Drivers:** [Download for Windows & Mac](https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers)
+    - **CH342, CH343, CH9102 Drivers:**
+	  - [Download for Windows](https://www.wch.cn/downloads/CH343SER_ZIP.html)
+      - [Download for Mac](https://www.wch.cn/downloads/CH34XSER_MAC_ZIP.html)
+    - **CH340, CH341 Drivers:**
+      - [Download for Windows](https://www.wch.cn/downloads/CH341SER_ZIP.html)
+      - [Download for Mac](https://www.wch.cn/downloads/CH341SER_MAC_ZIP.html)
+
+#### Install the c3card firmware
+
+- Follow the on-screen instructions to load the `c3card` firmware onto
+  your device.
+
+#### Initial provisioning
+
+- Check the display, which should indicate successful initialization
+  and WiFi details for further configuration.
+
+#### Troubleshooting
+
+- **Device Not Recognized:** Ensure that the correct drivers are
+  installed and your browser supports the ESP Web Tools.
+
+- **Serial Port Issues:** If the serial port is not visible, this
+  typically indicates missing USB serial drivers. Refer to the driver
+  installation links provided above.
+
+## Web installer
+
+<div>
+  <script type="module"
+          src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module">
+  </script>
+
+  <esp-web-install-button manifest="manifest.json">
+    <button slot="activate">Latest version</button>
+  </esp-web-install-button>
+</div>
diff --git a/workshop.md b/markdown/workshop.md
similarity index 100%
rename from workshop.md
rename to markdown/workshop.md
diff --git a/rebar.config b/rebar.config
index 3d1fd6b..ff3d745 100644
--- a/rebar.config
+++ b/rebar.config
@@ -45,7 +45,7 @@
 ]}.
 
 {ex_doc, [
-    {extras, ["README.md", "LICENSE", "workshop.md"]},
+    {extras, ["README.md", "LICENSE", "markdown/workshop.md", "markdown/installer.md"]},
     {main, "README.md"},
     {source_url, "https://github.com/esl/c3card"},
     {homepage_url, "https://github.com/esl/c3card"},