Flashing af ESP32-enheder
Brug af Meshtastic Web Flasher
Flash enhed
-
Tilslut din enhed
-
Besøg flasher.meshtastic.org *kræver Chrome eller Edge browser
-
Følg instruktionerne

Tilslut og opsæt enhed
Flashing af firmware via CLI
Forbindelsesverifikation
-
Brug firmware-tbeam0.7-X.X.X.xxxxxxx.bin til T-Beam 0.7.
-
firmware-tbeam-X.X.X.xxxxxxx.bin er inkompatibel.
Kommandolinjeinstruktioner
Installer nødvendige software
Linux
python3 --version pip3 --version
|
sudo apt-get update sudo apt-get install python3
|
sudo apt-get install python3-pip
|
pip3 install --upgrade esptool
|
MacOS
brew -v
|
python3 --version pip3 --version
|
brew install python3
|
pip3 -v
|
pip3 install --upgrade esptool
|
Windows
-
Download og installer Python. Under installationsprocessen skal du sikre dig, at du vælger muligheden for at Tilføj Python X.Y til PATH.
-
Download og installer Git Bash (eller en anden passende shell), og udfør alle efterfølgende kommandoer fra den shell.
py --version pip --version
|
pip3 install --upgrade esptool
|
Kontroller forbindelsen med chippen
-
På Linux og macOS kan det være nødvendigt eksplicit at erklære esptool som en .py script. Brug kommandoen esptool.py chip_id for at gøre dette, afhængigt af dit miljø.
-
På Windows skal du eksplicit erklære esptool som en .py script ved at bruge kommandoen esptool.py chip_id for at sikre korrekt funktionalitet.
Kommando
esptool chip_id
|
Forventet output
# Du bør se et resultat lignende dette: mydir$ esptool chip_id esptool.py v2.6 Fundet 2 serielle porte Seriel port /dev/ttyUSB0 Forbinder.... Registrerer chip type... ESP32 Chip er ESP32D0WDQ6 (revision 1) Funktioner: WiFi, BT, Dual Core, 240MHz, VRef kalibrering i efuse, Coding Scheme None MAC: 24:6f:28:b5:36:71 Uploader stub... Kører stub... Stub kører... Advarsel: ESP32 har ingen Chip ID. Læser MAC i stedet. MAC: 24:6f:28:b5:36:71 Hard reset via RTS-pin...
|
Download firmware
-
Naviger til Meshtastic Downloads Page for at hente den nyeste firmware.
-
Rul ned til Firmware-sektionen og vælg en af følgende muligheder baseret på dine præferencer:
-
Download Stable: For stabile, veltestede udgivelser.
-
Download Alpha: For nyere, eksperimentelle udgivelser, der inkluderer de nyeste funktioner.
-
Når du bliver omdirigeret til GitHub release-siden, rul ned til sektionen Assets og udvid den.
-
Identificer den passende firmware til din enhed i henhold til dens arkitektur (f.eks. firmware-esp32s3 for ESP32-S3-baserede enheder som Heltec V3).
-
Download filen og noter dens placering på dit system, som typisk er i din ~/Downloads mappe.
Få adgang til firmwaremappen
cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/
|
Installer eller opdater firmware
Bemærk venligst før du begynder:
Linux & macOS
./device-install.sh -f firmware-BOARD-VERSION.bin
|
./device-update.sh -f firmware-BOARD-VERSION-update.bin
|
Windows
device-install.bat -f firmware-BOARD-VERSION.bin
|
device-update.bat -f firmware-BOARD-VERSION-update.bin
|
Tilslut og opsæt enhed
Flashing med en ekstern seriel adapter
Flashing proces
-
På grund af den igangværende chipmangel kan nyligt erhvervede enheder som TTGO T-Beam være udstyret med ældre eller ikke-standard USB til Serial adapter chips, som kan være upålidelige i visse situationer.
-
Nogle enheder kan have defekte USB til Serial chips, hvilket kan føre til kommunikationsproblemer.
-
Specifikke enheder, såsom Hydra (Meshtastic-DIY mål)
USB Serial Adapters

Forbindelse af adapter til enheden
-
Forbind RX-pinden på adapteren til TX-pinden på enheden.
-
Forbind TX-pinden på adapteren til RX-pinden på enheden.
-
Forbind en GND-pin på adapteren til GND-pinden på enheden.
-
Forbind enten 5V-pinden på adapteren til 5V-pinden på enheden (som vist) eller 3,3V-pinden på adapteren til 3,3V-pinden på enheden.
-
Forbind GPIO 0 til GND på enheden med en jumper. (Dette sætter enheden i flash-tilstand ved opstart.) Eksempel på ledningsføring med en T-Beam.

-
Tilslut enheden til en USB-port på computeren.
-
Fjern jumperen, der forbinder GPIO 0 til GND.

Flashing af enheden

Fejlfinding af flashing-processen
Tilslut og opsæt enhed
Flashing af nRF52 & RP2040-enheder
-
Firmwareopgraderingsproces for nRF52 og RP2040-enheder: Enheder baseret på nRF52 og RP2040 arkitekturer tilbyder en enkel firmwareopgraderingsproces, som ikke kræver nogen driver- eller softwareinstallation på nogen platform.
-
Træk & slip: Disse enheder bruger træk & slip installationsmetoden til at installere firmwareudgivelser. Træk blot firmwarefilen over på enheden i din filudforsker.
-
Over-The-Air (OTA) opdateringer: nRF52-enheder kan modtage OTA firmwareopdateringer fra en mobil enhed via Bluetooth, hvilket muliggør problemfri opdateringer uden behov for fysiske forbindelser.
-
Fabrikssletning: Før du installerer ny firmware, kan du overveje at udføre en Fabrikssletning for at rydde eksisterende data, som kan ændre format eller placering mellem versioner.
-
Konvertering af RAK4631-R til RAK4631: Hvis din enhed ikke leveres med Arduino bootloader, skal du udføre en konvertering for at sikre kompatibilitet.
-
Brug af Raspberry Pi som SWDIO Flash-værktøj: Hvis din enhed ikke kan flashes via USB eller Bluetooth, er en alternativ mulighed at bruge en direkte SWDIO-forbindelse med en Raspberry Pi som flashing-værktøj.
Træk-og-slip firmwareopdateringer til nRF52 & RP2040
Flash enhed
-
Du kan nu benytte Meshtastic Web Flasher til at downloade og overføre firmware til dine nRF52 eller RP2040-baserede enheder. Alternativt kan du følge instruktionerne nedenfor for at downloade og installere firmwaren.
-
Hvis du for nylig har gennemført en Factory Erase, kan din enhed automatisk starte op i bootloader-tilstand. Du kan derefter gå direkte til "Kopier den passende firmware..." for din specifikke enhed nedenfor:
nRF52
-
Download og pak den nyeste firmware ud fra Meshtastic Downloads.
-
Tilslut din enhed til din computer med et USB-datakabel.
-
Tryk på reset-knappen på din enhed to gange (dette vil gå ind i bootloader-tilstand).
-
Et nyt drev vil blive monteret på din computer (kompatibelt med Windows, Mac, Linux eller Android).
-
Åbn dette drev, hvor du bør finde tre filer: CURRENT.UF2, INDEX.HTM, og INFO_UF2.TXT.
-
Kopier den passende firmwarefil (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) fra release-mappen til dette drev.
-
Efter filen er færdig med at kopiere, vil enheden genstarte og installere Meshtastic firmwaren.
RP2040
-
Download og pak den nyeste firmware ud fra Meshtastic Downloads.
-
Tryk og hold BOOTSEL-knappen nede, og tilslut derefter enheden til din computer med et USB-kabel.
-
Et nyt drev vil blive monteret på din computer (kompatibelt med Windows, Mac, Linux eller Android).
-
Åbn dette drev, hvor du bør finde to filer: INDEX.HTM og INFO_UF2.TXT.
-
Kopier den passende firmwarefil (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) fra release-mappen til dette drev.
-
Efter filen er færdig med at kopiere, vil enheden genstarte og installere Meshtastic firmwaren.
Mulige flashing edge cases
-
Ældre versioner af Meshtastic firmware kan indeholde forældede data, hvilket kan få enheder til at sidde fast i en nedbrudsloop under opstart. Hvis du oplever problemer med at opgradere din nRF52-enhed fra en tidligere version af Meshtastic, kan det være nødvendigt at udføre en komplet fabriksnulstilling af den interne flashhukommelse. Følg venligst guiden til at fabriksrydde din nRF52 enhed, før du fortsætter med at flash firmware.
Tilslut og opsæt enhed
Over-the-Air (OTA) firmwareopdateringer for nRF52
Android
-
Download den firmwareudgivelse, du ønsker at installere, fra Meshtastic Download Page eller Meshtastic GitHub.
-
Udpak firmwaremappen.
-
Åbn nRF Connect App og vælg CONNECT på din enhed fra SCANNER-fanen.
-
Hvis grænsefladen viser DISCONNECT i øverste højre hjørne, fortsæt til trin 5. Hvis den siger CONNECT, vælg CONNECT.
-
Tryk på DFU-ikonet i øverste højre hjørne af skærmen.
-
Bekræft, at "Distribution Packet (ZIP)" er valgt, og vælg derefter OK.
-
Vælg den passende enheds firmwarefil (som vil ende med -ota.zip).
-
Opdateringen starter automatisk (bemærk, at denne proces kan være langsom).
-
Når opdateringen er fuldført, genstarter enheden automatisk.
Apple
-
Download den firmwareudgivelse, du ønsker at installere, fra Meshtastic Download Page, Meshtastic GitHub, eller direkte gennem iOS/iPadOS appen.
-
Udpak firmwaremappen.
-
Åbn nRF DFU App og vælg den korrekte enheds firmwarefil (som ender med -ota.zip).
-
Forbind til din enhed.
-
Upload firmwaren.
-
Gå til indstillinger og aktiver "Packets Receipt Notification."
-
Skift "Number of Packets" til en lavere værdi; nogle brugere har haft succes med indstillingen "5".
Fabriksnulstilling for nRF52/RP2040-enheder
-
Meshtastic bruger littlefs-biblioteket til at gemme konfiguration, logs og andre data i den interne flashhukommelse på nRF52 og RP2040 enheder. Det er vigtigt at bemærke, at opdatering af firmwaren ikke sletter disse ekstra data, hvilket kan føre til problemer, hvis formatet og placeringen af data ændres mellem versioner.
-
Du kan nu bruge Meshtastic Web Flasher til at fabriksformatere dine nRF52 eller RP2040-baserede enheder. Besøg flasheren, vælg dit board, og klik på skraldespandsikonet til højre for Flash-knappen. Dette åbner en dialog for at starte sletteproceduren. Alternativt kan du følge instruktionerne nedenfor.
nRF52
-
Download og pak den nyeste firmware ud fra Meshtastic Downloads page.
-
Tilslut din enhed til din computer med et USB-datakabel.
-
Dobbeltklik på reset-knappen på din enhed for at gå i bootloader-tilstand.
-
Et nyt drev vil blive monteret på din computer (dette gælder for Windows, Mac eller Linux).
-
Åbn dette drev, og du bør se tre filer: CURRENT.UF2, INDEX.HTM, og INFO_UF2.TXT.
-
Åbn INFO_UF2.TXT fil i en teksteditor og bemærk SoftDevice værdi.
-
Find filen inkluderet i den downloadede firmware, som matcher din SoftDevice hovedversionsnummer (enten 7.x.x eller 6.x.x). Brug enten Meshtastic_nRF52_factory_erase_v3_S140_7.3.0.uf2 eller Meshtastic_nRF52_factory_erase_v3_S140_6.1.0.uf2, og kopier den over på det nye drev. Enheden skulle derefter genstarte.
-
Med Meshtastic CLI installeret, åbn din Terminal eller Konsol og indtast kommandoen: meshtastic --noproto.
-
Du bør se beskeden: Formatering... Færdig.
RP2040
-
Download flash_nuke.uf2 fil til din computer.
-
Tryk og hold BOOTSEL-knappen nede, og tilslut derefter boardet til din computer med et USB-kabel.
-
Boardet skulle nu vises som en masselagerenhed på din computer, mærket som RPI-RP2.
-
Kopier flash_nuke.uf2-filen til denne enhed.
-
Boardet genstarter automatisk, og flashhukommelsen bliver slettet.
Konvertering af RAK4631-R til RAK4631
USB Device Firmware Update (DFU)
-
Installer Python
-
Installer adafruit-nrfutil
pip3 install adafruit-nrfutil
|
-
Download den nødvendige bootloader: WisCore_RAK4631_Board_Bootloader.zip.
-
Tilslut din RAK-enhed til din computer via USB.
-
Flash bootloaderen.
adafruit-nrfutil --verbose dfu serial --package ./WisCore_RAK4631_Board_Bootloader.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
|
-
Efter det, fortsæt med de almindelige flash instruktioner.
Yderligere RUI3 trin
Berørte seriel port COM11 Åbnede seriel port COM11 Starter DFU opgradering af type 2, SoftDevice størrelse: 0, bootloader størrelse: 39000, applikationsstørrelse: 0 Sender DFU startpakke Timeout ved venten på bekræftelse fra enheden. Opgradering af mål mislykkedes. Fejlen er: Ingen data modtaget på seriel port. Kan ikke fortsætte.
|
Debugger
pip3 install pyocd
|
-
Download den nødvendige bootloader: WisCore_RAK4631_Board_Bootloader.hex.
-
Tilslut RAKDAP som angivet nedenfor:

-
Flash bootloaderen
pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex |
-
Fortsæt med de standard flashing-instruktioner.
Opdatering eller gendannelse af bootloaderen på nRF52-enheder
Metode 1: Opdatering med UF2-filen (Anbefalet)
-
Download den korrekte UF2 Bootloader-fil.
-
Tilslut din enhed til din computer med et USB-kabel.
-
Aktivér bootloader-tilstand ved hurtigt at dobbelttrykke på RESET-knappen på din enhed. For Seeed Tracker 1000-E, tryk og hold brugerknappen nede, og tilslut derefter hurtigt USB-kablet til MagSafe-porten to gange. Enheden skulle dukke op som et flytbart drev på din computer.
-
Træk og slip den UF2-fil, du har downloadet, ind i det flytbare drev. Enheden opdaterer automatisk bootloaderen og nulstiller.
-
Når enheden nulstilles, er opdateringen fuldført. Din enhed kører nu på den nyeste bootloader-version, og du kan fortsætte med at flashe firmwaren.
Metode 2: Brug af adafruit-nrfutil
-
Lilygo T-Echo SHA256: 85d8a334bbf82802d712e183f29ec5215f06786ca88914687c437aceab75d9cf
-
RAK4631 SHA256: 4a216ad2be8be23b80371a11753677c850c5711d3b85129390a416fc47ea0910
-
Seeed Tracker 1000-E SHA256: 8c69f0d43a7aac925055451d7262682d6926d4cfb7ea8240b466dc8f16a692ba
-
Generic Meshtastic 6.1.1 for DIY SHA256: ecebecea849ab79d09517dd4f6ff98de5647fe275b0b4d525501e6c29cb5a586
-
Generic Meshtastic 7.3.0 for DIY SHA256: 9a38edf4e974a6f705c41b296499a4fc57682ec9bb686eecd9f3d8d02fc6ffcf
-
Åbn en terminal eller kommandoprompt og installer adafruit-nrfutil ved at køre følgende kommando:
pip install adafruit-nrfutil |
-
Hent den korrekte ZIP-pakke.
-
Tilslut din enhed til din computer med et USB-kabel.
-
I terminalen eller kommandoprompten skal du navigere til den mappe, hvor du har downloadet bootloader ZIP-pakken, og køre følgende kommando. Sørg for at erstatte /dev/ttyACM0 med den korrekte port til din enhed (Windows-brugere kan bruge COMx):
adafruit-nrfutil --singlebank --touch 1200 --verbose dfu serial --package
|
-
Når processen er fuldført, er opdateringen færdig. Din enhed kører nu med den nyeste bootloader-version, hvilket giver dig mulighed for at fortsætte med at flashe firmwaren.
Metode 3: Brug af en Debugger
Brug af SWDIO til flashing med en Raspberry Pi
Ledningsopsætning
Installer OpenOCD-software
$ sudo apt update $ sudo apt install libtool autoconf automake texinfo telnet gdb-multiarch git $ git clone git://repo.or.cz/openocd.git $ cd openocd/ $ ./bootstrap $ ./configure --enable-bcm2835gpio $ make -j4 $ sudo make install
|
Bekræft forbindelse
$ openocd -f ./openocd/tcl/interface/raspberrypi-native.cfg -c "transport select swd" -f openocd/tcl/target/nrf52.cfg -s tcl
|
Open On-Chip Debugger 0.12.0+dev-00633-gad87fbd1c Licensed under GNU GPL v2 For fejlrapporter, læs http://openocd.org/doc/doxygen/bugs.html srst_only separate srst_gates_jtag srst_push_pull connect_deassert_srst swd Info : Listening on port 6666 for tcl connections Info : Listening on port 4444 for telnet connections Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : clock speed 100 kHz Info : SWD DPIDR 0x2ba01477 Info : [nrf52.cpu] Cortex-M4 r0p1 processor detected Info : [nrf52.cpu] target has 6 breakpoints, 4 watchpoints Info : [nrf52.cpu] Examination succeed Info : [nrf52.cpu] starting gdb server on 3333 Info : Listening on port 3333 for gdb connections Info : accepting 'telnet' connection on tcp/4444
|
Download firmware
Flash firmware
$ telnet 127.0.0.1 4444 Forsøger 127.0.0.1... Forbundet til 127.0.0.1. Escape-tegn er '^]'. Åbn On-Chip Debugger > init > reset init > halt > nrf5 mass_erase > program firmware.hex verify > reset > exit 0
|
Etabler forbindelse