|
|
@@ -1,113 +0,0 @@
|
|
|
-# Migration From `xJARiD/MeshCore`
|
|
|
-
|
|
|
-This page covers migrating from the previous firmware published at:
|
|
|
-
|
|
|
-- `https://github.com/xJARiD/MeshCore`
|
|
|
-
|
|
|
-to the MeshCoreTel-firmware published at:
|
|
|
-
|
|
|
-- `https://github.com/VBart/MeshCoreTel-firmware`
|
|
|
-
|
|
|
-These steps are intended for existing repeater users moving to the new `*_repeater_mqtt` MeshCoreTel-firmware.
|
|
|
-
|
|
|
-Start by downloading the correct MeshCoreTel-firmware release for your board from:
|
|
|
-
|
|
|
-- [Download and Flash Releases](./releases.md)
|
|
|
-
|
|
|
-## Before You Start
|
|
|
-
|
|
|
-- you can flash the new firmware without erasing first
|
|
|
-- after flashing, you will need to reapply your Wi-Fi and some MQTT settings
|
|
|
-- you can do this either from the serial CLI or from the companion app
|
|
|
-
|
|
|
-## Required Setup After Flashing
|
|
|
-
|
|
|
-Once the new firmware is flashed, set:
|
|
|
-
|
|
|
-- `set wifi.ssid <your-ssid>`
|
|
|
-- `set wifi.pwd <your-password>`
|
|
|
-- `set mqtt.iata <code>`
|
|
|
-- `set mqtt.status on`
|
|
|
-
|
|
|
-## Optional Settings
|
|
|
-
|
|
|
-If you were previously using owner metadata, also set:
|
|
|
-
|
|
|
-- `set mqtt.owner <64-hex-char-public-key>`
|
|
|
-- `set mqtt.email <email>`
|
|
|
-
|
|
|
-If you had previously disabled TX publishing, also set:
|
|
|
-
|
|
|
-- `set mqtt.tx off`
|
|
|
-
|
|
|
-## Final Step
|
|
|
-
|
|
|
-Once the settings are applied:
|
|
|
-
|
|
|
-- `reboot`
|
|
|
-
|
|
|
-After reboot, the repeater should be operational.
|
|
|
-
|
|
|
-## Verify Operation
|
|
|
-
|
|
|
-Confirm the repeater is up and connected with:
|
|
|
-
|
|
|
-- `get wifi.status`
|
|
|
-- `get mqtt.status`
|
|
|
-
|
|
|
-## Validate In The Web Console
|
|
|
-
|
|
|
-If the web panel is enabled on your board, you can also verify through the local HTTPS admin page.
|
|
|
-
|
|
|
-Enable and check it with:
|
|
|
-
|
|
|
-- `set web on`
|
|
|
-- `get web.status`
|
|
|
-
|
|
|
-Then open:
|
|
|
-
|
|
|
-- `https://<IP_ADDRESS>/`
|
|
|
-
|
|
|
-Notes:
|
|
|
-
|
|
|
-- ignore the browser warning for the self-signed certificate
|
|
|
-- log in with the admin password
|
|
|
-- this is the same admin password used for admin access via the companion app
|
|
|
-
|
|
|
-## Legacy MQTT Commands
|
|
|
-
|
|
|
-Some MQTT CLI commands from the previous firmware do not apply in MeshCoreTel-firmware and should not be migrated.
|
|
|
-
|
|
|
-MeshCoreTel-firmware stores its current Wi-Fi and MQTT uplink settings separately from the older firmware, so older broker and analyzer settings do not carry forward in a useful way. After flashing, re-enter the settings you still use now, rather than expecting the old MQTT bridge configuration to map across.
|
|
|
-
|
|
|
-These previous MQTT CLI commands no longer apply in MeshCoreTel-firmware:
|
|
|
-
|
|
|
-- `get mqtt.server`
|
|
|
-- `get mqtt.port`
|
|
|
-- `get mqtt.password`
|
|
|
-- `get mqtt.analyzer.us`
|
|
|
-- `get mqtt.analyzer.eu`
|
|
|
-- `get mqtt.config.valid`
|
|
|
-
|
|
|
-If you flash without erase first, some old values may still remain in flash in the background. The important point is that MeshCoreTel-firmware does not use those old MQTT bridge values for its current uplink configuration, so users should not expect them to carry forward or have any effect.
|
|
|
-
|
|
|
-## Recommended Migration Flow
|
|
|
-
|
|
|
-1. Flash the new MeshCoreTel-firmware without erasing.
|
|
|
-2. Open the serial CLI or companion app.
|
|
|
-3. Set `wifi.ssid`, `wifi.pwd`, `mqtt.iata`, and `mqtt.status on`.
|
|
|
-4. Optionally set `mqtt.owner` and `mqtt.email`.
|
|
|
-5. If you previously had TX publishing disabled, set `mqtt.tx off`.
|
|
|
-6. Reboot the repeater.
|
|
|
-7. Verify with `get wifi.status` and `get mqtt.status`.
|
|
|
-8. Optionally confirm local web access with `set web on`, `get web.status`, and `https://<IP_ADDRESS>/`.
|
|
|
-
|
|
|
-## Related Docs
|
|
|
-
|
|
|
-- [Repeater Web Panel](./web-panel.md)
|
|
|
-- [Custom CLI Commands](./custom-cli.md)
|
|
|
-- [Download and Flash Releases](./releases.md)
|
|
|
-
|
|
|
-## Last Resort
|
|
|
-
|
|
|
-If the repeater still does not come up cleanly after reflashing, reapplying settings, and rebooting, the last resort is to perform a full erase-flash and then configure it again from scratch.
|