PlatformIO mit VSCode

Installation VSCode

Installieren Sie zunächst VSCode:

Installation von PlatformIO

Starten Sie hierfür VSCode.

PlatformIO IDE Installation
  1. Öffnen Sie den VSCode Extension Manager
  2. Suchen Sie Platform IO IDE
  3. Installieren Sie PlatformIO IDE
  4. Lesen Sie den quick start guide

Erzeugen Sie Ihr Projekt

Um Ihr Modell zu programmieren benötigen Sie nun ein neues PlatformIO-Projekt. Ab Version 0.7.0 benutzt die ftSwarm-Umgebung auf Boarddefinitionen. Die Boarddefinitionen sind noch nicht in PlatformIO online verfügbar. Sie müssen diese übergangsweise lokal in Ihrem Projektverzeichnis mit eintragen. Um dabei Fehler zu vermeiden, ist es am einfachsten eine ZIP-Datei mit einem Starter-Projekt zu verwenden:

Neues Projekt
  1. Downloaden Sie pio-starter-0.7.1.zip
  2. Entpacken Sie die zip-Datei in ein Verzeichnis Ihrer Wahl.
  3. Wechseln Sie zu VSCode und clicken auf das PlatformIO-Icon
  4. Wählen Sie bei "Pick a folder" Ihr gerade Verzeichnis aus.

Als letzten Schritt müssen sie Ihren Controlltertyp auswählen. Am unteren Bildschirmrand finden Sie die PIO-Statusbar. Clicken Sie auf das Project Environment und wählen Sie Ihren Controllertyp aus:

Home

Jeder Controllerttyp wird doppelt angezeigt, z.B. ftSwarmRS und ftSwarmRS-DE. Mit der ersten Varianten compilieren Sie eine englischsprachige Firmware, mit der zweiten Variante sind die Ausgaben auf der seriellen Console in Deutsch.

Ein Testprogramm flashen

Die ZIP-Datei enthält auch ein fertiges Hauptprogramm src/main.cpp. Dieses hat nur wenige Zeilen und startet die Firmware. Diese soll nun testweise geflashed werden:

Home

  1. Schließen Sie den Controller über ein USB-Kabel an den PC an und wählen Sie die entsprechende USB-Schnittstelle in der Statusbar aus.
  2. Clicken Sie auf den Upload-Button. Die Software wird compiliert und auf den Controller geflashed.
  3. Starten Sie die serielle Console und drücken Sie den Reset-Taster des Controllers. Es meldet sich die Firmware.

Wenn Sie die Fehlermeldung “A fatal error occurred: This chip is ESP32-S3, not ESP32. Wrong –chip argument?” beim flashen Ihres Programms erhalten oder die Firmware dem Fehler “FATAL: Incompatible firmware hardware settings.” nach dem Starten/Reset des Controllers in der seriellen Console ausgibt, so müssen Sie den richtigen Controller im Project Environment auswählen.

In der Statusbar stehen Ihnen die folgenden Buttons zur Verfügung:

  • build oder Strg + Alt + B compiliert Ihr Programm.
  • upload oder Strg + Alt + U flashed Ihr Programm auf den Controller.
  • serial oder Strg + Alt + S startet den seriellen Monitor.