From db78540213e56c9971de07bb062f1356dd5bf19e Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 14 Nov 2021 21:42:33 -0800 Subject: [PATCH] More website tweaks --- index.html | 156 ++++++++++++------ .../dashboard.png} | Bin static/screenshots/logs.png | Bin 0 -> 15247 bytes 3 files changed, 102 insertions(+), 54 deletions(-) rename static/{screenshot-dialog.png => screenshots/dashboard.png} (100%) create mode 100644 static/screenshots/logs.png diff --git a/index.html b/index.html index bbe0b78..b6626ed 100644 --- a/index.html +++ b/index.html @@ -81,6 +81,15 @@ width: 100%; height: 100%; } + .hidden { + display: none; + } + .supported-info { + display: none; + } + esp-web-install-button[install-supported] + .supported-info { + display: block; + } .content pre { max-width: 100%; overflow-y: scroll; @@ -148,33 +157,37 @@ href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Serial_API" >Web Serial, Improv Wi-Fi (optional), - and a manifest which describes the firmware. It will automatically - detect the chipset of the connected ESP device and find the right - firmware files in the manifest. + and a manifest which describes the firmware. It will automatically find + the supported firmware files from the manifest by detecting the chipset + of the connected ESP device. +

+

+ Web Serial is available in Google Chrome and Microsoft Edge + browsers. Android support should be possible but has not been implemented yet.

+

Try a live demo

- To try it out and install - ESPHome on an ESP, connect it to your - computer and hit the button: + This demo will install + ESPHome. To get started, connect an ESP + device to your computer and hit the button:

- -

- - Note, this only works in desktop Chrome and Edge. Android support - should be possible but has not been implemented yet. If you don't see - your ESP device, you might miss drivers. + + + The demo is not available because your browser does not support Web + Serial. Open this page in Google Chrome or Microsoft Edge instead. -

- -

- Screenshot showing ESP Web Tools dialog offering visting the device, adding it to Home Assistant, change Wi-Fi, show logs and console and reset data. - Screenshot showing the ESP Web Tools interface + +

+ If you don't see your ESP device in the list of devices to choose, you + might need to install + the drivers.

Products using ESP Web Tools

@@ -252,12 +265,12 @@

Adding ESP Web Tools to your website

- To add this to your own website, create a manifest and add the button to - your website. Make sure you update the manifest attribute to point at - your manifest. + To add this to your own website, you need to include the ESP Web Tools + JavaScript files on your website, create a manifest file and render the + ESP Web Tools button.

- You can import ESP Web Tools directly from the unpkg CDN or + You can import the JavaScript files directly from the unpkg CDN or download the files @@ -267,20 +280,30 @@ <script type="module" src="https://unpkg.com/esp-web-tools@5.1.0/dist/web/install-button.js?module" -></script> - +></script> +

+ Find a place on your page where you want the button to appear and + include the following bit of HTML. Update the + manifest attribute to point at your manifest file. +

+
 <esp-web-install-button
-  manifest="static/firmware_build/manifest.json"
+  manifest="/static/firmware_build/manifest.json"
 ></esp-web-install-button>

- Your website needs to be served over https://. If your - manifest is hosted on another server, make sure you configure + ESP Web Tools requires that your website is served over + https:// to work. This is a Web Serial security limitation. +

+

+ If your manifest or the firmware files are hosted on another server, + make sure you configure the CORS-headers - for your manifest and firmware files such that your website is allowed - to fetch those files by adding the header + such that your website is allowed to fetch those files by adding the + header Access-Control-Allow-Origin: https://domain-of-your-website.com. @@ -288,17 +311,16 @@

ESP Web Tools can also be integrated in your projects by installing it - via NPM:
- npm install --save esp-web-tools + via NPM.

Creating your manifest

- ESP Web Tools manifest describe the firmware that you want to install. - It allows specifying different builds for the different types of ESP - devices. Current supported chip families are ESP8266, - ESP32, ESP32C3 and ESP32S2. The - correct build will be automatically selected based on the type of the - ESP device we detect via the serial port. + Manifests describe the firmware that you want to offer the user to + install. It allows specifying different builds for the different types + of ESP devices. Current supported chip families are + ESP8266, ESP32, ESP32C3 and + ESP32S2. The correct build will be automatically selected + based on the type of the ESP device we detect via the serial port.

 {
@@ -340,30 +362,38 @@
         By default a new installation will erase the entire flash. If you want
         to skip this step, set the optional key
         new_install_skip_erase to true. ESP Web Tools
-        considers it a new installation if it is unable to detect the current
+        offers users a new installation if it is unable to detect the current
         firmware of the device (via Improv Serial) or if the detected firmware
         does not match the name specififed in the manifest.
       

-

Wi-Fi provisioning

+

Wi-Fi provisioning

- ESP Web Tools has support for the + ESP Web Tools supports the Improv Wi-Fi serial standard. This is an open standard to allow configuring Wi-Fi via the serial port.

- If Improv is supported, a user will be guided to connect the device to - the network after installation. It also allows the user to connect - already installed devices and re-configure the wireless network - settings. + If the firmware supports Improv, a user will be guided to connect the + device to the network after installation. Once connected, the device can + sent a URL to the user to finish configuration. This can for example be + a link to the device's IP address where it serves a local UI. +

+

+ At any time in the future a user can use ESP Web Tools to find the + device link or to reconfigure the Wi-Fi settings without doing a + reinstall. +

+

+ Screenshot showing ESP Web Tools dialog offering visting the device, adding it to Home Assistant, change Wi-Fi, show logs and console and reset data. + Screenshot showing the ESP Web Tools interface

Customizing the look and feel

-

- There are multiple options to change the look and feel of the button. -

-

Change colors

You can change the colors of the default UI elements with CSS custom properties (variables), the following variables are available: @@ -394,7 +424,7 @@

 <esp-web-install-button
-  manifest="static/firmware_build/manifest.json"
+  manifest="/static/firmware_build/manifest.json"
 >
   <button slot="activate">Custom install button</button>
   <span slot="unsupported">Ah snap, your browser doesn't work!</span>
@@ -402,7 +432,20 @@
 </esp-web-install-button>
     
-

USB Serial Drivers

+

Viewing logs & sending commands

+

+ ESP Web Tools allows users to open a serial console to see the logs and + send commands. +

+

+ Screenshot showing ESP Web Tools dialog with a console showing ESPHome logs and a terminal prompt to sent commands. + Screenshot showing the ESP Web Tools logs & console +

+ +

USB Serial Drivers

If the serial port is not showing up, your computer might be missing the drivers for the USB serial chip used in your ESP device. These drivers @@ -437,5 +480,10 @@ + diff --git a/static/screenshot-dialog.png b/static/screenshots/dashboard.png similarity index 100% rename from static/screenshot-dialog.png rename to static/screenshots/dashboard.png diff --git a/static/screenshots/logs.png b/static/screenshots/logs.png new file mode 100644 index 0000000000000000000000000000000000000000..89a86deacca7085bc49fa8fafc03e44e9e4f371c GIT binary patch literal 15247 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 Q+QKQxslBavV;=H<0Iaeo*Z=?k literal 0 HcmV?d00001