From 4e2e096fdf4a5d7923398f35570b230729e67fef Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Fri, 25 Feb 2022 10:19:19 -0700 Subject: [PATCH] consolidated configuration to web-app --- docs/software/web/config.md | 32 ----------------------- docs/software/web/web-app.md | 49 ++++++++++++++++++++++++++++++++++++ sidebars.js | 1 - 3 files changed, 49 insertions(+), 33 deletions(-) delete mode 100644 docs/software/web/config.md diff --git a/docs/software/web/config.md b/docs/software/web/config.md deleted file mode 100644 index ca0be255..00000000 --- a/docs/software/web/config.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -id: web-config-software -title: Initial configuration -sidebar_label: Configuration ---- - -## Manual Installation - -Pre-requisite: You have Meshtastic Device firmware between version 1.0.32 - 1.1.50. A client for version 1.2.x will be released shortly and the documentation will be updated accordingly. - -We do realize this installation method is not "easy" and are exploring ways to simplify this in the future, ideally rolling it out as part of the device firmware. - -Once you have your device loaded with the Meshtastic Device firmware you need to connect to it's Wifi and then manually upload the web interface files. - -### Upload web interface files - -* Updated (Nov 20, 2021) - The process to use the web interface will soon be included in the default builds downloaded from the usual places. This document will be updated soon. Hang tight :) - -### Wifi configuration - -:::info -Enabling WiFi will disable bluetooth. Only one method will work at a time. -::: - -WiFi configuration is required to use the web interface. Any method of set up will work: -- [Device as a client](/docs/settings/wifi#enable-wifi-as-client) -- [Device as an access point](/docs/settings/wifi#enable-wifi-as-softap) -- [Force SoftAP (admin)](/docs/settings/wifi#force-softap) - -:::note -The first time your device restarts after enabling WiFi, it will take an additional 20-30 seconds to boot. This is to generate self-signed SSL keys. The keys will be saved for future reuse. -::: diff --git a/docs/software/web/web-app.md b/docs/software/web/web-app.md index 242c17a8..90270014 100644 --- a/docs/software/web/web-app.md +++ b/docs/software/web/web-app.md @@ -9,3 +9,52 @@ The Meshtastic firmware incorporates an embedded web server using the [ESP32 HTT :::caution Please note that this is under active development and liable to change. ::: + +:::caution +It has been reported that some of this information is out of date. + +FIXME - Investigate and rewrite document to reflect the current web usage solution. +::: + +## Configuration + +The web interface is now included in firmware releases. There is active development ongoing to fix some issues with updating the web interface from the web interface directly. Please be patient with us as we work on this. Use [Meshtastic-flasher](/docs/getting-started/meshtastic-flasher) to update your device to the current stable build which includes the web interface. + +### Wifi configuration + +WiFi configuration is required to use the web interface. Any method of set up will work: +- [Device as a client](/docs/settings/wifi#enable-wifi-as-client) +- [Device as an access point](/docs/settings/wifi#enable-wifi-as-softap) +- [Force SoftAP (admin)](/docs/settings/wifi#force-softap) + +If you have just one Meshtastic device on your network, the easiest thing to do is to go to http://meshtastic.local printed on your device screen. That URL should work provided that mDNS (aka ZeroConf) is not blocked on your local network. If you have more than one device or there's a problem with mDNS name resolution, you will have to refer to the device's IP address. The IP address will also be available on the screen. It can also be found by reading the serial logs when the device boots up. + +:::note +The first time your device restarts after enabling WiFi, it will take an additional 20-30 seconds to boot. This is to generate self-signed SSL keys. The keys will be saved for future reuse. +::: + +## Common Problems + +### Problem: File not found: /static/index.html + +:::note +This issue is likely found on old versions of the web interface. Device firmware now includes the web interface and the file system has been changed. Flashing the device with [Meshtastic-flasher](/docs/getting-started/meshtastic-flasher) will update you to the current web interface. Access to the files in the filesystem is actively being developed, but is not currently available. +::: + +Cause: This most likely means that the file system for the web server has not been loaded. You probably used esphome-flasher or some other GUI tool to flash the firmware. + +Solutions: + +Option 1) Flash the device with the `device-install.sh` script that comes packaged with the firmware zip file (you'll lose previous settings). Then follow the instructions under configuration to upload the web interface. + +Option 2) Flash the device with the OTA update from within the Android application. + +Option 3) Flash the device with the SPIFFS instructions in platform.io. + +### Insufficient space to upload new files + +:::note +This issue is likely found on old versions of the web interface. Device firmware now includes the web interface and the file system has been changed. Flashing the device with [Meshtastic-flasher](/docs/getting-started/meshtastic-flasher) will update you to the current web interface. Access to the files in the filesystem is actively being developed, but is not currently available. +::: + +Cause: Typically a small partition has been set aside from previous firmware installed on the module. Instructions for how to fix this can be found on the [ESP32-Partitions](/docs/software/web/web-partitions-software) page. diff --git a/sidebars.js b/sidebars.js index dedf4241..168d6fbe 100644 --- a/sidebars.js +++ b/sidebars.js @@ -64,7 +64,6 @@ module.exports = { { "Web interface": [ "software/web/web-app-software", - "software/web/web-config-software", "software/web/web-usage-software", "software/web/web-partitions-software", "software/web/web-development-software",