mirror of
https://github.com/mikecarper/MeshCore.git
synced 2026-10-31 19:22:28 +00:00
deploy: 0a24279a3c
This commit is contained in:
1 parent
5ef1ed5c05
commit
3a368f243b
4 files changed
+26
-6
No files matched your search
@@ -2820,10 +2820,20 @@ power-loss-proof on a device whose USB/serial flash port is inaccessible.</p>
|
||||
legacy-slot application image; its Full image keeps the old repeater's exact
|
||||
LoRa OTA target ID. Upload <code>wifi-bridge.bin</code> from the ZIP through the legacy
|
||||
node's existing Wi-Fi browser updater.
|
||||
Then join <code>MeshCore-Migrate</code> (password <code>meshcore-migrate</code>) and wait for
|
||||
<strong>Expanded layout ready</strong>. Upload <code>full-application.bin</code> at <code>/update</code>.
|
||||
Then join <code>MeshCore-Migrate</code> and wait for <strong>Expanded layout ready</strong>. Its Wi-Fi
|
||||
password is the admin password saved on the old node, so only someone who can
|
||||
already administer the node can join and upload firmware. Upload
|
||||
<code>full-application.bin</code> at <code>/update</code>.
|
||||
Do not upload an <code>-merged.bin</code>: merged images include
|
||||
bootloader and table offsets for cable flashing, not browser OTA.</p>
|
||||
<p>WPA2 needs a password of at least 8 printable ASCII characters. If the saved
|
||||
admin password is shorter, uses other characters, or was never saved (the node
|
||||
still runs on its built-in default), the bridge falls back to
|
||||
<code>meshcore-migrate</code>. That password is published here, so anyone nearby could
|
||||
then join and upload firmware. Before uploading the bridge, set an admin
|
||||
password of 8 to 15 characters with <code>password <new password></code>. A LoRa
|
||||
first-stage bridge does not carry saved settings into the expanded layout, so
|
||||
its Wi-Fi recovery page after the table change normally uses the fallback.</p>
|
||||
<p><code>xiao_s3_partition_legacy_seed</code> is a disposable-hardware test image only. It
|
||||
models the legacy table and an identity file; it is not a deployable repeater.</p>
|
||||
<h2 id="lora-only-migration-of-a-listed-role">LoRa-only migration of a listed role</h2>
|
||||
|
||||
@@ -2311,9 +2311,10 @@ to <code>default_16MB.csv</code>, with two 6.25 MiB OTA slots.</p>
|
||||
</code></pre>
|
||||
<p>The ZIP contains the Wi-Fi bridge, LoRa bridge, and exact-target Full image.
|
||||
Upload its <code>wifi-bridge.bin</code> through the
|
||||
legacy browser Wi-Fi updater. Rejoin <code>MeshCore-Migrate</code> with password
|
||||
<code>meshcore-migrate</code>; when it reports <strong>Expanded layout ready</strong>, upload the
|
||||
ZIP's <code>full-application.bin</code> at <code>/update</code>.</p>
|
||||
legacy browser Wi-Fi updater. Rejoin <code>MeshCore-Migrate</code> using the node's saved
|
||||
admin password as the Wi-Fi password (see the shared guide for the published
|
||||
fallback); when it reports <strong>Expanded layout ready</strong>, upload the ZIP's
|
||||
<code>full-application.bin</code> at <code>/update</code>.</p>
|
||||
<p>Do not use an <code>-merged.bin</code> in either browser uploader. Merged images contain
|
||||
bootloader and table offsets for cable flashing. The bridge preserves the
|
||||
private identity; other SPIFFS-backed settings may be recreated after the
|
||||
|
||||
@@ -2947,6 +2947,15 @@ from automatic room-client eviction. Assigned read-only and read/write users
|
||||
appear in Access Control alongside administrators. Automatic guest-password
|
||||
read/write sessions remain transient; password-created administrators remain
|
||||
retained. The existing permission byte is unchanged.</p>
|
||||
<p>Guest-password logins do not allocate new durable login replay records, so
|
||||
guest churn cannot fill the bounded replay store. Any existing record from a
|
||||
previous privileged role still applies and is advanced. After reboot or
|
||||
transient client eviction, an identity without such a record can have captured
|
||||
guest login and message traffic accepted again. Assign an explicit read/write
|
||||
role with <code>setperm <key> 2</code> when durable login replay protection is required.
|
||||
Room-post deduplication and per-sender post replay timestamps remain in RAM:
|
||||
captured old posts can also be accepted after a legitimate newer login restores
|
||||
a lost session.</p>
|
||||
<p>ACL updates use the existing delayed settings save. Allow at least five seconds
|
||||
after <code>setperm</code> before removing power so the assignment reaches storage.</p>
|
||||
<pre><code class="language-text">setperm <complete-64-hex-public-key> 1
|
||||
|
||||
@@ -1 +1 @@
|
||||
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"Home","text":"<p>View this page on MeshCore Docs.</p>"},{"location":"#meshcore-documentation","title":"MeshCore documentation","text":"<p>Choose firmware with the firmware picker. For help with a device already in service, start with the FAQ.</p>"},{"location":"#current-release","title":"Current release","text":"<ul> <li>1.17.1.8 USA Cascade release notes</li> <li>Test Results \u2014 validation archive and 1.17.1.8 Preview 1 qualification evidence</li> </ul>"},{"location":"#documentation","title":"Documentation","text":"<ul> <li>Feature switches by role and Full Companion features</li> <li>Firmware update guide, easy LoRa OTA, and scripted LoRa OTA</li> <li>CLI commands, availability by build, and radio profiles</li> <li>Private fleet management: signed filtering and secondary-radio commands for a fleet or one node</li> <li>Room history, moderation, and information board: optional persistent chat and local Wi-Fi room access</li> <li>Companion protocol, packet format, and QR codes</li> </ul> <p>The navigation groups the remaining guides under Documentation, including board-specific updates, networking, power, and protocol references.</p>"},{"location":"#tools","title":"Tools","text":"<ul> <li>Firmware picker and USB web console</li> <li>Notification builder and temporary radio test builder</li> <li>Filter policy playground, telemetry decoder, and management report decoder</li> </ul>"},{"location":"#engineering-records","title":"Engineering records","text":"<ul> <li>Research \u2014 design notes, diagnostics, and historical update-chain studies</li> <li>Old Releases \u2014 historical release notes and supporting files</li> </ul> <p>Found a mistake or missing information? Edit the documentation.</p>"},{"location":"WiFi/","title":"WiFi","text":"<p>View this page on MeshCore Docs.</p>"},{"location":"WiFi/#wifi-and-mqtt-by-firmware-type","title":"WiFi and MQTT by Firmware Type","text":"<p>MeshCore itself does not require WiFi or the internet. LoRa packet exchange, repeating, room servers, companions, and sensors can all operate without either. WiFi is added by particular ESP32 firmware targets for one or more of these purposes:</p> <ul> <li>a TCP connection between a WiFi companion and a phone or computer;</li> <li>the WebConfig browser interface;</li> <li>MQTT uplinking from the radio to internet or LAN brokers;</li> <li>WiFi-assisted OTA services on builds that include them;</li> <li>ESP-NOW bridging, which uses the ESP32's 2.4 GHz radio but is not a connection to a WiFi access point.</li> </ul> <p>The firmware role and the build profile are separate choices. USB logging does not itself provide MQTT. MQTT-capable Full Companions include that feature without <code>mqtt</code> in their filename; check the artifact capability manifest. See feature switches by role for the different Companion and infrastructure controls and the USB web console.</p>"},{"location":"WiFi/#quick-reference","title":"Quick reference","text":"Firmware target or role Infrastructure WiFi MQTT What WiFi does <code>*_repeater</code> Build-dependent on ESP32 No FULL builds provide WebConfig, browser OTA, and the TCP 5001 LoRa-OTA seeder while WiFi is active <code>*_repeater_observer_mqtt</code> Yes Yes Uplinks heard and selected transmitted LoRa packets; repeating remains enabled by default <code>*_room_server</code> Build-dependent on ESP32 No FULL builds provide WebConfig, browser OTA, and the TCP 5001 LoRa-OTA seeder while WiFi is active <code>*_room_server_observer_mqtt</code> Yes Yes Runs the room server and uplinks radio traffic <code>*_companion_radio_wifi</code> Yes No Exposes the MeshCore companion protocol on TCP port 5000 <code>*_companion_radio_wifi_mqtt</code> Yes Yes Runs both the TCP companion interface and the MQTT uplink <code>*_companion_radio_full*</code> ESP32, subject to board/transport selection Where compiled on ESP32 Includes supported USB/wireless transports; configure MQTT through WebConfig Dedicated USB, BLE, or serial companion (not Full) No No Uses the transport named by the target instead <code>*_repeater_bridge_espnow</code> Build-dependent on ESP32 No Uses ESP-NOW for its bridge; <code>bridge.format wrapped|raw</code> selects legacy bridge framing or primary-ESP-NOW compatibility; a FULL build also exposes the TCP 5001 LoRa-OTA seeder whenever WiFi is usable RS232 bridge No No Bridges through a serial interface Ethernet repeater/room server No WiFi No Uses wired Ethernet for its role-specific network interface <code>*_sensor</code> Build-dependent on ESP32 No A FULL ESP32 sensor can expose the TCP 5001 LoRa-OTA seeder through its browser-OTA setup AP Terminal-chat or KISS modem No in current targets No Uses LoRa and its role-specific local interface <code>*_lora_ota_no_external_sensors</code> On demand on ESP32 No LeaLine truncated
|
||||
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"Home","text":"<p>View this page on MeshCore Docs.</p>"},{"location":"#meshcore-documentation","title":"MeshCore documentation","text":"<p>Choose firmware with the firmware picker. For help with a device already in service, start with the FAQ.</p>"},{"location":"#current-release","title":"Current release","text":"<ul> <li>1.17.1.8 USA Cascade release notes</li> <li>Test Results \u2014 validation archive and 1.17.1.8 Preview 1 qualification evidence</li> </ul>"},{"location":"#documentation","title":"Documentation","text":"<ul> <li>Feature switches by role and Full Companion features</li> <li>Firmware update guide, easy LoRa OTA, and scripted LoRa OTA</li> <li>CLI commands, availability by build, and radio profiles</li> <li>Private fleet management: signed filtering and secondary-radio commands for a fleet or one node</li> <li>Room history, moderation, and information board: optional persistent chat and local Wi-Fi room access</li> <li>Companion protocol, packet format, and QR codes</li> </ul> <p>The navigation groups the remaining guides under Documentation, including board-specific updates, networking, power, and protocol references.</p>"},{"location":"#tools","title":"Tools","text":"<ul> <li>Firmware picker and USB web console</li> <li>Notification builder and temporary radio test builder</li> <li>Filter policy playground, telemetry decoder, and management report decoder</li> </ul>"},{"location":"#engineering-records","title":"Engineering records","text":"<ul> <li>Research \u2014 design notes, diagnostics, and historical update-chain studies</li> <li>Old Releases \u2014 historical release notes and supporting files</li> </ul> <p>Found a mistake or missing information? Edit the documentation.</p>"},{"location":"WiFi/","title":"WiFi","text":"<p>View this page on MeshCore Docs.</p>"},{"location":"WiFi/#wifi-and-mqtt-by-firmware-type","title":"WiFi and MQTT by Firmware Type","text":"<p>MeshCore itself does not require WiFi or the internet. LoRa packet exchange, repeating, room servers, companions, and sensors can all operate without either. WiFi is added by particular ESP32 firmware targets for one or more of these purposes:</p> <ul> <li>a TCP connection between a WiFi companion and a phone or computer;</li> <li>the WebConfig browser interface;</li> <li>MQTT uplinking from the radio to internet or LAN brokers;</li> <li>WiFi-assisted OTA services on builds that include them;</li> <li>ESP-NOW bridging, which uses the ESP32's 2.4 GHz radio but is not a connection to a WiFi access point.</li> </ul> <p>The firmware role and the build profile are separate choices. USB logging does not itself provide MQTT. MQTT-capable Full Companions include that feature without <code>mqtt</code> in their filename; check the artifact capability manifest. See feature switches by role for the different Companion and infrastructure controls and the USB web console.</p>"},{"location":"WiFi/#quick-reference","title":"Quick reference","text":"Firmware target or role Infrastructure WiFi MQTT What WiFi does <code>*_repeater</code> Build-dependent on ESP32 No FULL builds provide WebConfig, browser OTA, and the TCP 5001 LoRa-OTA seeder while WiFi is active <code>*_repeater_observer_mqtt</code> Yes Yes Uplinks heard and selected transmitted LoRa packets; repeating remains enabled by default <code>*_room_server</code> Build-dependent on ESP32 No FULL builds provide WebConfig, browser OTA, and the TCP 5001 LoRa-OTA seeder while WiFi is active <code>*_room_server_observer_mqtt</code> Yes Yes Runs the room server and uplinks radio traffic <code>*_companion_radio_wifi</code> Yes No Exposes the MeshCore companion protocol on TCP port 5000 <code>*_companion_radio_wifi_mqtt</code> Yes Yes Runs both the TCP companion interface and the MQTT uplink <code>*_companion_radio_full*</code> ESP32, subject to board/transport selection Where compiled on ESP32 Includes supported USB/wireless transports; configure MQTT through WebConfig Dedicated USB, BLE, or serial companion (not Full) No No Uses the transport named by the target instead <code>*_repeater_bridge_espnow</code> Build-dependent on ESP32 No Uses ESP-NOW for its bridge; <code>bridge.format wrapped|raw</code> selects legacy bridge framing or primary-ESP-NOW compatibility; a FULL build also exposes the TCP 5001 LoRa-OTA seeder whenever WiFi is usable RS232 bridge No No Bridges through a serial interface Ethernet repeater/room server No WiFi No Uses wired Ethernet for its role-specific network interface <code>*_sensor</code> Build-dependent on ESP32 No A FULL ESP32 sensor can expose the TCP 5001 LoRa-OTA seeder through its browser-OTA setup AP Terminal-chat or KISS modem No in current targets No Uses LoRa and its role-specific local interface <code>*_lora_ota_no_external_sensors</code> On demand on ESP32 No LeaLine truncated
|
||||
Reference in new issue
Block a user