Stel PlatformIO in VS Code in om OSSM-firmware betrouwbaar te compileren en te uploaden
OSSM wordt met PlatformIO in VS Code gebouwd. Als u van de Arduino IDE komt, kan de overgang er in eerste instantie onbekend uitzien, maar u krijgt wel snellere builds, beter afhankelijkheidsbeheer en een consistente opzet voor alle bijdragers.
PlatformIO beheert bibliotheken, toolchains en bouwomgevingen voor u. Eerdere OSSM-releases konden worden aangepast aan Arduino, maar het project is die aanpak ontgroeid. PlatformIO leren kost minder tijd dan OSSM voor Arduino opnieuw aanpassen bij elke release.
Waarom PlatformIO?
- Meer tijd voor functies – minder tijd voor het worstelen met afhankelijkheden
- Gemakkelijkere samenwerking – consistente ontwikkelomgeving voor alle bijdragers
- Automatische afhankelijkheidsresolutie: bibliotheken worden opgehaald en vastgezet voor reproduceerbare builds
- Code-intelligentie: automatisch aanvullen, linting en inline foutdetectie
Vereisten
- VS Code geïnstalleerd
- USB-datakabel voor uw board (kabels die alleen kunnen opladen werken niet voor uploads)
- Boarddrivers geïnstalleerd indien vereist door uw besturingssysteem (bijv. CP210x of CH340)
Het referentie-OSSM-board maakt gebruik van een ingebouwde Espressif ESP32 Dev Module.
Installatie
Installeer VS Code en PlatformIO
Installeer VS Code en voeg vervolgens de extensie "PlatformIO IDE" toe vanuit de VS Code Marketplace. Start na de installatie VS Code opnieuw op om PlatformIO te activeren.
U zou het PlatformIO-pictogram met een alienhoofd in de Activity Bar aan de linkerkant moeten zien.
Open PlatformIO Home
Klik op het PlatformIO-pictogram om PlatformIO Home te openen.
Open het OSSM-project
Selecteer vanuit PlatformIO Home "Open Project" en kies de OSSM-map die platformio.ini (kleine letters) bevat.
De Explorer zou platformio.ini, een src/-map en een lib/-map moeten tonen.
Selecteer de juiste omgeving (indien van toepassing)
Als het project meerdere omgevingen in platformio.ini definieert (bijvoorbeeld verschillende boards of buildopties), gebruik dan de omgevingskiezer in de VS Code Status Bar (meestal gelabeld met de actieve omgeving) om de omgeving te kiezen die bij uw board past.
Als er maar één omgeving is, selecteert PlatformIO deze automatisch.
Open het firmware-ingangspunt
Open src/main.cpp om de firmwarebron te bekijken.
Bouw en upload de firmware
Gebruik het pictogram ✓ (Build) om te compileren en het pictogram → (Upload) om de firmware naar het board te flashen. Deze bedieningselementen bevinden zich in de Status Bar onderaan VS Code.
- Voer eerst een build uit om fouten lokaal op te sporen, of upload direct om in één stap te compileren en te flashen.
- Zorg ervoor dat uw board is aangesloten en dat de juiste seriële poort is geselecteerd.
Een succesvolle build eindigt met SUCCESS in de terminal. Bij een succesvolle upload wordt Hash of data verified of een soortgelijke bevestiging van de ESP32-uploader weergegeven.
Veelvoorkomende taken
- Seriële poort selecteren: PlatformIO → Quick Access → "Select Serial Port".
- Seriële uitvoer bewaken: klik op het stekkerpictogram (Monitor) in de Status Bar of voer
PlatformIO: Monitoruit vanuit de Command Palette. - Build opschonen: voer
PlatformIO: Cleanuit om gecompileerde artefacten te verwijderen voordat u opnieuw bouwt.
Problemen oplossen
De meest voorkomende oorzaken zijn een onjuiste configuratie van de seriële poort of het board.
Controleer uw seriële poort
In Windows verschijnt het board als COMx. Op macOS/Linux verschijnt het onder /dev/tty.* of /dev/cu.*.
Stel de poort in PlatformIO in:
Als u geen poort ziet, probeer dan een andere USB-kabel, een andere USB-poort of installeer het juiste USB-naar-UART-stuurprogramma voor uw board.
Voor het OSSM-referentiebord is het boarddoel Espressif ESP32 Dev Module. Zorg ervoor dat uw platformio.ini-omgeving de juiste board-instelling voor ESP32 gebruikt.
Een update van een platform of bibliotheek kan incompatibele wijzigingen introduceren. Zet versies in platformio.ini vast om een bekende goede configuratie te herstellen.
; Example: pin the Espressif32 platform
platform = espressif32@3.5.0Controleer altijd de releaseopmerkingen van het project voor de aanbevolen platform- en bibliotheekversies.
Dit duidt meestal op een verschil in baudrate.
- Controleer
monitor_speedinplatformio.ini(bijvoorbeeld115200) - Zorg ervoor dat de firmware en de seriële monitor dezelfde baudsnelheid gebruiken
- Houd de BOOT/EN-knoppen van het board ingedrukt of tik erop, zoals vereist door uw ESP32-module
- Druk op reset nadat het uploaden is voltooid als het board niet automatisch opnieuw opstart
- Ontkoppel andere apps die mogelijk dezelfde seriële poort gebruiken
Als u problemen tegenkomt die hier niet worden behandeld, leg dan het volledige PlatformIO-build-/uploadlogboek van de VS Code Terminal vast en voeg dit toe wanneer u om hulp vraagt. Het logboek bevat de geselecteerde omgeving, platformversies en exacte foutmeldingen.