Flashning av ESP32-enheter
Använda Meshtastic Web Flasher
Flash-enhet
-
Anslut din enhet
-
Besök flasher.meshtastic.org *kräver Chrome eller Edge-webbläsare
-
Följ instruktionerna

Anslut och konfigurera enheten
Flashning av firmware via CLI
Verifiering av anslutning
-
Använd firmware-tbeam0.7-X.X.X.xxxxxxx.bin för T-Beam 0.7.
-
firmware-tbeam-X.X.X.xxxxxxx.bin är inkompatibel.
Instruktioner för kommandoradsgränssnitt
Installera nödvändig programvara
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
-
Ladda ner och installera Python. Under installationsprocessen, se till att du väljer alternativet att Lägg till Python X.Y i PATH.
-
Ladda ner och installera Git Bash (eller ett annat lämpligt skal), och kör alla efterföljande kommandon från det skalet.
py --version pip --version
|
pip3 install --upgrade esptool
|
Kontrollera anslutning med Chip
-
På Linux och macOS kan du behöva uttryckligen deklarera esptool som en .py skript. Använd kommandot esptool.py chip_id för att göra detta, beroende på din miljö.
-
På Windows måste du uttryckligen deklarera esptool som en .py skript genom att använda kommandot esptool.py chip_id för att säkerställa korrekt funktion.
Kommando
esptool chip_id
|
Förväntad utdata
# Du bör se ett resultat liknande detta: mydir$ esptool chip_id esptool.py v2.6 Hittade 2 seriella portar Seriell port /dev/ttyUSB0 Ansluter.... Upptäcker chiptyp... ESP32 Chip är ESP32D0WDQ6 (revision 1) Funktioner: WiFi, BT, Dual Core, 240MHz, VRef-kalibrering i efuse, Kodningsschema None MAC: 24:6f:28:b5:36:71 Laddar upp stub... Kör stub... Stub körs... Varning: ESP32 har inget Chip ID. Läser MAC istället. MAC: 24:6f:28:b5:36:71 Hårdåterställer via RTS-stift...
|
Ladda ner firmware
-
Navigera till Meshtastic Downloads Page för att hämta den senaste firmwaren.
-
Scrolla ner till avsnittet Firmware och välj ett av följande alternativ baserat på dina preferenser:
-
Download Stable: För stabila, vältestade versioner.
-
Download Alpha: För nyare, experimentella versioner som inkluderar de senaste funktionerna.
-
När du omdirigeras till GitHub release page, scrolla ner till avsnittet Assets och expandera det.
-
Identifiera lämplig firmware för din enhet enligt dess arkitektur (t.ex., firmware-esp32s3 för ESP32-S3-baserade enheter som Heltec V3).
-
Ladda ner filen och notera dess plats på ditt system, vilket vanligtvis är i din ~/Downloads mapp.
Gå till firmwarekatalogen
cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/
|
Installera eller uppdatera firmware
Observera innan du börjar:
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
|
Anslut och konfigurera enheten
Flashning med en extern seriell adapter
Flashningsprocess
-
På grund av den pågående chipbristen kan nyligen inköpta enheter som TTGO T-Beam vara utrustade med äldre eller icke-standard USB till Serial adapter-chip, vilka kan vara opålitliga i vissa situationer.
-
Vissa enheter kan ha defekta USB till Serial-chip, vilket leder till kommunikationsproblem.
-
Specifika enheter, såsom Hydra (Meshtastic-DIY mål)
USB Serial Adaptrar

Ansluta adaptern till enheten
-
Anslut RX-pinnen på adaptern till TX-pinnen på enheten.
-
Anslut TX-pinnen på adaptern till RX-pinnen på enheten.
-
Anslut en GND-pin på adaptern till en GND-pin på enheten.
-
Anslut antingen 5V-pinnen på adaptern till 5V-pinnen på enheten (som illustrerat) eller 3,3V-pinnen på adaptern till 3,3V-pinnen på enheten.
-
Förbind GPIO 0 till GND på enheten med en jumper. (Detta sätter enheten i flashläge när den startas.) Exempel på koppling med en T-Beam.

-
Anslut enheten till en USB-port på datorn.
-
Ta bort jumpen som förbinder GPIO 0 med GND.

Flashning av enheten

Felsökning av flashningsprocessen
Anslut och konfigurera enheten
Flashning av nRF52 & RP2040-enheter
-
Firmwareuppgraderingsprocess för nRF52 och RP2040-enheter: Enheter baserade på nRF52 och RP2040 arkitekturer erbjuder en enkel firmwareuppgraderingsprocess som inte kräver någon drivrutin eller programvaruinstallation på någon plattform.
-
Dra & Släpp: Dessa enheter använder dra-och-släpp installationsmetoden för att installera firmwareversioner. Dra helt enkelt firmwarefilen till enheten i din filutforskare.
-
Överluftsuppdateringar (OTA): nRF52-enheter kan ta emot OTA firmwareuppdateringar från en mobil enhet via Bluetooth, vilket möjliggör smidiga uppdateringar utan behov av fysiska anslutningar.
-
Fabriksåterställning: Innan du installerar ny firmware kan du överväga att utföra en Fabriksåterställning för att rensa eventuell befintlig data som kan ändra format eller plats mellan versioner.
-
Konvertera RAK4631-R till RAK4631: Om din enhet inte levereras med Arduino bootloader måste du utföra en konvertering för att säkerställa kompatibilitet.
-
Använda Raspberry Pi som ett SWDIO Flash-verktyg: Om din enhet inte kan flashas via USB eller Bluetooth, är ett alternativ att använda en direkt SWDIO-anslutning med en Raspberry Pi som flash-verktyg.
Dra-och-släpp firmwareuppdateringar för nRF52 & RP2040
Flash-enhet
-
Du kan nu använda Meshtastic Web Flasher för att ladda ner och överföra firmware till dina nRF52 eller RP2040-baserade enheter. Alternativt kan du följa instruktionerna nedan för att ladda ner och installera firmwaren.
-
Om du nyligen har genomfört en Factory Erase kan din enhet automatiskt starta i bootloader-läge. Du kan då gå direkt till "Kopiera lämplig firmware..." för din specifika enhet nedan:
nRF52
-
Ladda ner och packa upp den senaste firmwaren från Meshtastic Downloads.
-
Anslut din enhet till din dator med en USB-datakabel.
-
Tryck på återställningsknappen på din enhet två gånger (detta går in i bootloader-läge).
-
En ny enhet kommer att monteras på din dator (kompatibel med Windows, Mac, Linux eller Android).
-
Öppna denna enhet, där du bör hitta tre filer: CURRENT.UF2, INDEX.HTM, och INFO_UF2.TXT.
-
Kopiera lämplig firmwarefil (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) från release-mappen till denna enhet.
-
Efter att filen har kopierats klart kommer enheten att starta om och installera Meshtastic-firmware.
RP2040
-
Ladda ner och packa upp den senaste firmwaren från Meshtastic Downloads.
-
Tryck och håll ned BOOTSEL-knappen, anslut sedan enheten till din dator med en USB-kabel.
-
En ny enhet kommer att monteras på din dator (kompatibel med Windows, Mac, Linux eller Android).
-
Öppna denna enhet, där du bör hitta två filer: INDEX.HTM och INFO_UF2.TXT.
-
Kopiera lämplig firmwarefil (firmware-DEVICE_NAME-X.X.X-xxxxxxx.uf2) från release-mappen till denna enhet.
-
Efter att filen har kopierats klart kommer enheten att starta om och installera Meshtastic-firmware.
Möjliga flashningssärskilda fall
-
Äldre versioner av Meshtastic firmware kan behålla föråldrad data, vilket kan leda till att enheter fastnar i en kraschloop vid uppstart. Om du stöter på problem när du uppgraderar din nRF52-enhet från en tidigare version av Meshtastic kan du behöva göra en fullständig fabriksåterställning av det interna flashminnet. Följ guiden för att fabriksåterställa din nRF52 innan du fortsätter med att flasha firmwaren.
Anslut och konfigurera enheten
Trådlösa (OTA) firmware-uppdateringar för nRF52
Android
-
Ladda ner firmwareversionen du vill installera från Meshtastic Download Page eller Meshtastic GitHub.
-
Packa upp firmwaremappen.
-
Öppna nRF Connect App och välj CONNECT på din enhet från SCANNER-fliken.
-
Om gränssnittet visar DISCONNECT uppe till höger, gå vidare till steg 5. Om det står CONNECT, välj CONNECT.
-
Tryck på DFU-ikonen uppe till höger på skärmen.
-
Verifiera att "Distribution Packet (ZIP)" är valt, och välj sedan OK.
-
Välj lämplig enhetsfirmwarefil (som slutar med -ota.zip).
-
Uppdateringen startar automatiskt (observera att denna process kan vara långsam).
-
När uppdateringen är klar startar enheten om automatiskt.
Apple
-
Ladda ner firmwareversionen du vill installera från Meshtastic Download Page, Meshtastic GitHub eller direkt via iOS/iPadOS-appen.
-
Packa upp firmwaremappen.
-
Öppna nRF DFU App och välj rätt enhetsfirmwarefil (som slutar med -ota.zip).
-
Anslut till din enhet.
-
Ladda upp firmwaren.
-
Gå till inställningarna och aktivera "Packets Receipt Notification."
-
Ändra "Antal paket" till ett lägre värde; vissa användare har haft framgång med inställningen "5".
Fabriksåterställning för nRF52/RP2040-enheter
-
Meshtastic använder littlefs-biblioteket för att lagra konfiguration, loggar och annan data i intern flashminne på nRF52- och RP2040-enheter. Det är viktigt att notera att uppdatering av firmware inte raderar denna extra data, vilket kan leda till problem om formatet och platsen för datan ändras mellan versioner.
-
Du kan nu använda Meshtastic Web Flasher för att fabriksåterställa dina nRF52- eller RP2040-baserade enheter. Besök flasharen, välj ditt kort och klicka på papperskorgsikonen till höger om Flash-knappen. Detta öppnar en dialog för att initiera raderingsproceduren. Alternativt kan du följa instruktionerna nedan.
nRF52
-
Ladda ner och packa upp den senaste firmwaren från Meshtastic Downloads page.
-
Anslut din enhet till din dator med en USB-datakabel.
-
Dubbelklicka på återställningsknappen på din enhet för att gå in i bootloader-läge.
-
En ny enhet kommer att monteras på din dator (detta gäller Windows, Mac eller Linux).
-
Öppna denna enhet, och du bör se tre filer: CURRENT.UF2, INDEX.HTM, och INFO_UF2.TXT.
-
Öppna INFO_UF2.TXT fil i en textredigerare och notera SoftDevice värde.
-
Leta reda på filen som ingår i den nedladdade firmware som matchar din SoftDevice huvudversionsnummer (antingen 7.x.x eller 6.x.x). Använd antingen Meshtastic_nRF52_factory_erase_v3_S140_7.3.0.uf2 eller Meshtastic_nRF52_factory_erase_v3_S140_6.1.0.uf2, och kopiera det till den nya enheten. Enheten bör sedan starta om.
-
Med Meshtastic CLI installerat, öppna din Terminal eller Konsol och skriv kommandot: meshtastic --noproto.
-
Du bör se meddelandet: Formaterar... Klart.
RP2040
-
Ladda ner flash_nuke.uf2 fil till din dator.
-
Tryck och håll ned BOOTSEL-knappen, anslut sedan kortet till din dator med en USB-kabel.
-
Kortet bör nu visas som en masslagringsenhet på din dator, märkt som RPI-RP2.
-
Kopiera flash_nuke.uf2-filen till denna enhet.
-
Kortet startar automatiskt om och flashminnet raderas.
Konvertera RAK4631-R till RAK4631
USB Device Firmware Update (DFU)
-
Installera Python
-
Installera adafruit-nrfutil
pip3 install adafruit-nrfutil
|
-
Ladda ner nödvändig bootloader: WisCore_RAK4631_Board_Bootloader.zip.
-
Anslut din RAK-enhet till din dator via USB.
-
Flasha bootloadern.
adafruit-nrfutil --verbose dfu serial --package ./WisCore_RAK4631_Board_Bootloader.zip -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
|
-
Efter det, fortsätt med de vanliga flashing instructions.
Ytterligare RUI3-steg
Rörde vid seriell port COM11 Öppnade seriell port COM11 Startar DFU-uppgradering av typ 2, SoftDevice-storlek: 0, bootloader-storlek: 39000, applikationsstorlek: 0 Skickar DFU startpaket Tidsgräns överskriden vid väntan på bekräftelse från enheten. Misslyckades med att uppgradera mål. Fel är: Ingen data mottagen på seriell port. Kan inte fortsätta.
|
Debugger
pip3 install pyocd
|
-
Ladda ner nödvändig bootloader: WisCore_RAK4631_Board_Bootloader.hex.
-
Anslut RAKDAP enligt instruktionerna nedan:

-
Flasha bootloadern
pyocd flash -t nrf52840 .\WisCore_RAK4631_Board_Bootloader.hex |
-
Fortsätt med de standard flashningsinstruktionerna.
Uppdatera eller återställ bootloadern på nRF52-enheter
Metod 1: Uppdatering med UF2-filen (Rekommenderas)
-
Ladda ner rätt UF2 Bootloader-fil.
-
Anslut din enhet till din dator med en USB-kabel.
-
Aktivera bootloader-läge genom att snabbt dubbeltrycka på RESET-knappen på din enhet. För Seeed Tracker 1000-E, håll in användarknappen och anslut sedan snabbt USB-kabeln till MagSafe-porten två gånger. Enheten ska visas som en flyttbar enhet på din dator.
-
Dra och släpp den UF2-fil du laddade ner till den flyttbara enheten. Enheten uppdaterar automatiskt bootloadern och startar om.
-
När enheten startar om är uppdateringen klar. Din enhet kör nu den senaste bootloader-versionen, och du kan fortsätta med att flasha firmware.
Metod 2: Använda 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
-
Öppna en terminal eller kommandoprompt och installera adafruit-nrfutil genom att köra följande kommando:
pip install adafruit-nrfutil |
-
Skaffa rätt ZIP-paket.
-
Anslut din enhet till din dator med en USB-kabel.
-
I terminalen eller kommandoprompten, navigera till katalogen där du laddade ner bootloader ZIP-paketet och kör följande kommando. Se till att byta ut /dev/ttyACM0 mot rätt port för din enhet (Windows-användare kan använda COMx):
adafruit-nrfutil --singlebank --touch 1200 --verbose dfu serial --package
|
-
När processen är klar är uppdateringen slutförd. Din enhet kör nu den senaste bootloader-versionen, vilket gör att du kan fortsätta med flashning av firmware.
Metod 3: Använda en Debugger
Använda SWDIO för flashing med en Raspberry Pi
Kopplingsschema
Installera OpenOCD-programvara
$ 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
|
Verifiera anslutning
$ 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 Licensierad under GNU GPL v2 För bugg-rapporter, läs http://openocd.org/doc/doxygen/bugs.html srst_only separate srst_gates_jtag srst_push_pull connect_deassert_srst swd Info : Lyssnar på port 6666 för tcl-anslutningar Info : Lyssnar på port 4444 för telnet-anslutningar Info : BCM2835 GPIO JTAG/SWD bitbang-drivrutin Info : klockfrekvens 100 kHz Info : SWD DPIDR 0x2ba01477 Info : [nrf52.cpu] Cortex-M4 r0p1 processor upptäckt Info : [nrf52.cpu] målet har 6 brytpunkter, 4 bevakningspunkter Info : [nrf52.cpu] Undersökning lyckades Info : [nrf52.cpu] starting gdb server on 3333 Info : Lyssnar på port 3333 för gdb-anslutningar Info : accepting 'telnet' connection on tcp/4444
|
Ladda ner firmware
Programmera firmware
$ telnet 127.0.0.1 4444 Försöker 127.0.0.1... Ansluten till 127.0.0.1. Escape-tecken är '^]'. Öppna On-Chip Debugger > init > reset init > halt > nrf5 mass_erase > program firmware.hex verify > reset > exit 0
|
Etablera anslutning