Skip to content

feat: wifi companion configuration via cli rescue#2720

Open
NickDunklee wants to merge 1 commit into
meshcore-dev:devfrom
NickDunklee:wifi-improvement-v3-pt-2-cli
Open

feat: wifi companion configuration via cli rescue#2720
NickDunklee wants to merge 1 commit into
meshcore-dev:devfrom
NickDunklee:wifi-improvement-v3-pt-2-cli

Conversation

@NickDunklee

@NickDunklee NickDunklee commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

The idea with this was allowing users to use WiFi companions, without having to compile a build. This change enables CLI Rescue commands to companion wifi builds so they
can be provisioned via USB cable. (The CLI is limited in number of characters, so some longer SSIDs would still have to be compiled in, for now.)

This would also allow a wifi companion firmware to be available for download from the MeshCore site and while the user is setting up, they could provision their SSID/password on the web-CLI or a local terminal via USB without having to compile a build.

Longer-term, other solutions could be devised to make this more flexible, like the mobile app could add in the wifi provisioning step with a Bluetooth bootstrap stage, leveraging this code as the mechanism to store/configure.

CLI Rescue commands added:

Command Syntax Description
Set WiFi SSID wifi_ssid <ssid> Set the network name
Set WiFi Password wifi_pwd <pwd> Set the network password
Commit WiFi Settings wifi_commit Apply, save settings, reboot
Clear WiFi Settings wifi_clear Reset all WiFi settings

This is dependent on PR 2706.

Tested on Heltec v3

The idea with this was allowing users to use WiFi companions,
without having to compile a build. This change enables CLI
Rescue commands to companion wifi builds so they
can be provisioned via USB cable. (The CLI is limited
in number of characters, so some longer SSIDs would still have
to be compiled in, for now.)

This would also allow a wifi companion firmware to be available
for download from the MeshCore site and while the user is setting
up, they could provision their SSID/password on the web-CLI or
a local terminal via USB without having to compile a build.

Longer-term, other solutions could be devised to make this more
flexible, like the mobile app could add in the wifi provisioning
step with a Bluetooth bootstrap stage, leveraging this code as
the mechanism to store/configure.

CLI Rescue commands added:

| Command | Syntax | Description |
|---|---|---|
| Set WiFi SSID | `wifi_ssid <ssid>` | Set the network name |
| Set WiFi Password | `wifi_pwd <pwd>` | Set the network password |
| Commit WiFi Settings | `wifi_commit` | Apply and save settings |
| Clear WiFi Settings | `wifi_clear` | Reset all WiFi settings |

This is dependent on [PR 2706](meshcore-dev#2706).

Tested on Heltec v3
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant