From 923271aa24ffb7441d973703ed45b6241b947a61 Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Thu, 24 Feb 2022 20:28:49 -0700 Subject: [PATCH] directed instructions to wifi settings page --- docs/software/web/config.md | 49 ++++--------------------------------- 1 file changed, 5 insertions(+), 44 deletions(-) diff --git a/docs/software/web/config.md b/docs/software/web/config.md index e8935e3d..1f321813 100644 --- a/docs/software/web/config.md +++ b/docs/software/web/config.md @@ -10,29 +10,7 @@ Pre-requisite: You have Meshtastic Device firmware between version 1.0.32 - 1.1. 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. - -### Connect to device Wifi - -The easiest way to turn on the device Wifi is to do the following after the device has been powered on: - -* Hold down the user button -* Press and release the reset button -* Count to 2 -* Let go of the user button - -:::note -Some devices call this the “prog” button. On devices with two buttons where one is a reset button — it’s usually the other one. On T-beam devices it is the middle button. -::: - -The device will now go into WiFi SoftAP Admin Mode. In this mode, your device will broadcast the following credentials on a built in Access Point: - -* SSID: meshtasticAdmin -* Password: 12345678 - -:::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. -::: +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 @@ -40,27 +18,10 @@ The first time your device restarts after enabling WiFi, it will take an additio ### Wifi configuration -To enable WiFi to access the web interface, you must at minimum set two preferences: - -`wifi_ssid` -`wifi_password` - -For the Wifi features to be enabled, those two properties must be set. - -To turn it off, either preference must be set as an empty string, that is a pair of double quotes each: - -`wifi_ssid ""` -`wifi_password ""` - -Alternatively, you can enable the internal Soft Access Point: - -`wifi_ap_mode true` - -With that enabled, we will broadcast a new Wifi network with the SSID and password you set. In AP mode, your device will act as a Captive Portal with a built in DNS server that resolves all name requests back to the device. Additionally, Apple Captive Portal Assistant is implemented -- if you're on an Apple device, the web interface will pop up automagically. - -To turn it off, simply reboot the device. - -Right now, the only way to set those preference is through the Meshtastic-python command line tool. At some point, we will be able to configure this from your mobile phone over Bluetooth. +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.