f5b33104ef
Getting started: - New 15-minute Getting Started guide featuring the two most popular tracks (BLE on esp32dev-ble, RF on lilygo-rtl_433), with broker setup and a verification step - Sidebar restructured around the new-user journey; upload options numbered by ease; Gitpod upload method removed Home page: - VitePress hero with clear actions, larger hero image - How-it-works pipeline diagram shared as a component (responsive via container queries), use-case grid, bigger video tiles without the image lightbox, refreshed press coverage list, functions pills - Support section pointing to Theengs Bridge and github.com/sponsors/1technophile Upload flow: - Decision-oriented upload landing page (journey strip, method cards, comparison table) - Pre-flight checklist and driver troubleshooting on the web installer - Guided environment picker (bridge + hardware wizard) replacing the filter chips, with manifest-verified recommendations - Post-flash next-steps card linking to the portal and verification Board images: - custom_img key in environments.ini and board photos for all web-flashable environments (licenses recorded); private prod_env.ini environments excluded from boards-info.json Corrections: - RF frequency coverage stated as 433/315/868/915MHz - Removed references to the retired compatible.openmqttgateway.com site (BLE list is decoder.theengs.io), the discontinued Theengs Plug, and the private sponsor forum Claude-Session: https://claude.ai/code/session_01TYysQW8tpmt1dWWuzKhTLi Co-authored-by: Florian <1technophile@users.noreply.github.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2.6 KiB
aside
| aside |
|---|
| false |
(Option 1) Upload from the web
This is the easiest way to install OpenMQTTGateway: no software to download, no development environment.
Before you flash
- Use a data USB cable — many cables are charge-only and the board won't show up with one.
- Use Chrome, Edge or Opera — Firefox and Safari don't support web flashing.
- Most boards need a USB serial driver. Recent operating systems often include it; if your board doesn't appear in the port list, see below.
::: details My board doesn't show up in the port list
- Try another USB cable (data, not charge-only) and another USB port.
- Install the driver matching your board's USB chip (check the board's product page if unsure):
- CP210x (Silicon Labs): driver download
- CH340 / CH341 (WCH): driver download
- CH9102 (WCH): macOS driver, Windows driver
- On macOS, complete the driver installation by confirming it in the Security section of System Preferences, then restart. For a LilyGo LoRa32 V2.1 board, the correct port to select is
/dev/cu.wchusbserialXXXXXXXXXXX. - Some boards need the BOOT button held down while plugging in the cable to enter flash mode.
- On Linux, add your user to the
dialoutgroup (sudo usermod -a -G dialout $USER) and log in again. :::
Select your firmware
To upload firmware to your ESP device directly from this page, first connect your ESP device to a USB port on your computer. Then, choose the appropriate firmware from the available options. Next, click the Connect button and select the USB port where your ESP is plugged in. Wait for the upload process to finish. After the upload completes, you can set up your WiFi and MQTT credentials.
Board photos courtesy of their manufacturers. ESP32 Feather photo © Adafruit Industries, CC BY-SA.
::: tip Running on a tablet or phone If you want to use the BLE decoding capabilities of OpenMQTTGateway with a tablet or smartphone you can use Theengs App. :::
Next step
Once the upload is complete, connect the gateway to your WiFi network and MQTT broker through the configuration portal.