rasmus/MTGcompanion
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases 1 Wiki Activity

Document OTA Wi-Fi credential switching and hotspot tips in README
All checks were successful
ESP32 Build & Release / build (push) Successful in 6m36s
Details

Browse Source
This commit is contained in:
Rasmus
2026-09-12 12:25:22 +02:00
parent 9f3d5cb146
commit 80eab1752c
1 changed files with 26 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@@ -101,6 +101,32 @@ When you scan a new card tag that hasn't been programmed yet:
---
### 💡 Pro-Tip: Changing Wi-Fi Networks on the Go (Home Wi-Fi ↔ Phone Hotspot)
When heading to your Local Game Store (LGS), a friend's house, or a tournament, you may want your companion connected to your phone's mobile hotspot so it can fetch fresh card data from Scryfall on the fly.
Because your Companion supports Over-The-Air updates through Gitea, **you never need a USB cable or computer to change Wi-Fi credentials!**
#### Switching from Home Wi-Fi to Phone Hotspot (Before heading out):
1. **Update Wi-Fi in Gitea:** Open your Gitea repository in your browser (even on your phone) and edit `sdkconfig.defaults`:
```ini
CONFIG_MTG_WIFI_SSID="MyPhoneHotspot"
CONFIG_MTG_WIFI_PASS="MyHotspotPassword"
```
2. **Commit to `main`:** Gitea Actions will automatically compile your new firmware in ~1–2 minutes.
3. **Trigger OTA Update:** While still on your home Wi-Fi, select **8. CHECK FIRMWARE OTA** on your device and click to install.
4. **Ready for the Game Store!** The device reboots with your hotspot credentials saved. When you turn on your phone's personal hotspot at the store, the companion connects automatically.
#### Switching Back to Home Wi-Fi:
Simply revert or update `sdkconfig.defaults` in Gitea back to your home Wi-Fi name, trigger the OTA update over your phone hotspot, and you're back on your home network.
> 🛟 **Forgot to update before leaving home?**
> No problem:
> - **The "Mirror" Hotspot Trick:** Set your phone's personal hotspot name and password to match your home Wi-Fi network. The companion will connect to your phone immediately, thinking it's at home!
> - **Offline Play Always Works:** All previously scanned cards and art are stored safely in local flash memory, and the device's built-in `MTG-Companion` pairing page works offline with zero internet required.
---
## 🛠️ Part 2: Technical Specifications & Build Guide
### Hardware Architecture