mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-14 01:24:14 -08:00
72 lines
2.9 KiB
Markdown
72 lines
2.9 KiB
Markdown
---
|
||
id: wifi
|
||
title: WiFi Settings
|
||
sidebar_label: WiFi
|
||
---
|
||
|
||
## Overview
|
||
|
||
WiFi support can be configured as either a WiFi Client or a Software Access Point (SoftAP). The WiFi client will connect to your existing WiFi network, as opposed to the SoftAP which will broadcast a new SSID and Password. See below for more details.
|
||
|
||
:::note
|
||
The device can be either a WiFi client or a software access point. It **cannot** operate as both at the same time.
|
||
:::
|
||
|
||
## Settings
|
||
|
||
| Setting | Acceptable Values | Default | Description |
|
||
| :-----: | :---------------: | :-----: | :--------- |
|
||
| wifi_ap_mode | `true`, `false` | `false` | Toggles the [Software Access Point](#software-access-point) |
|
||
| wifi_password | string | `""` | Your WiFi password |
|
||
| wifi_ssid | string | `""` | Your WiFi SSID (aka network name) |
|
||
|
||
:::note
|
||
If your `wifi_ssid` or `wifi_password` contain spaces, be sure to put quotation marks around the whole thing:
|
||
```bash title="Example with spaces"
|
||
meshtastic --set wifi_ssid "my wifi ssid" --set wifi_password "my wifi password"
|
||
```
|
||
:::
|
||
|
||
## Details
|
||
|
||
### Software Access Point
|
||
|
||
With the SoftAP enabled, a DNS server will run on the device. The DNS server will respond to all DNS requests with the IP address of your device. This will simplify device discovery because you will not have to remember the device's IP – any unencrypted HTTP request will direct you to the right location.
|
||
|
||
#### CLI Example
|
||
|
||
```bash title="Example"
|
||
meshtastic --set wifi_ap_mode true --set wifi_ssid mywifissid --set wifi_password mywifipassword
|
||
```
|
||
|
||
In the above example, the device will broadcast a network with the SSID `mywifissid` and the password `mywifipassword`.
|
||
|
||
#### Force SoftAP
|
||
|
||
You can also enable the SoftAP by following these directions:
|
||
|
||
* Hold down the user button
|
||
* Press and release the reset button
|
||
* Count to two
|
||
* Let go of the user button
|
||
|
||
This will reboot the device with the SSID set to `meshtasticAdmin` and the password set to `12345678`. Using the Force SoftAP method, once you reboot, the SoftAP will be turned off.
|
||
|
||
### WiFi Client
|
||
|
||
With `wifi_ssid` & `wifi_password` populated, the device will now to connect to your network. Make sure you are in range of your WiFi. If you have a single device on your local network it's easy to connect to your device `http://meshtastic.local`. If you have multiple devices you will need to connect using thier respective IP addresses.
|
||
|
||
To disable WiFi completely, set `wifi_ap_mode` to `false`, and both `wifi_ssid` & `wifi_password` to an empty string `""`.
|
||
|
||
#### CLI Examples
|
||
```bash title="Example - Enabling WiFi"
|
||
meshtastic --set wifi_ap_mode false --set wifi_ssid mywifissid --set wifi_password mywifipassword
|
||
```
|
||
|
||
In the above example, the device will join a network with the SSID `mywifissid` and the password `mywifipassword`.
|
||
|
||
```bash title="Example - Disabling WiFi"
|
||
meshtastic --set wifi_ap_mode false --set wifi_ssid "" --set wifi_password ""
|
||
```
|
||
In the above example, the device will disable WiFi.
|