Gradle plugins

Kolekcja autorskich wtyczek Gradle do tworzenia oprogramowania wbudowanego, rozwoju platform oraz automatyzacji budowania w moich projektach monorepo opartych na Gradle.

Ostatnio zaktualizowany
Utrzymywany
Liczba kontrybucji w ostatnim roku: 6
PonŚrPt
LisGruStyLutMarKwiMajCzeLipSieWrzPaźLis
Czas czytania:2min

Dostępne wtyczki

ModułID pluginuOpisDokumentacjaRepozytorium
esp-idf-pluginpl.miloszgilga.gradle.espidfWieloplatformowa nakładka Gradle dla projektów firmware ESP-IDF (Windows, Linux, macOS).JavadocReposilite

Użycie

Dodanie repozytoriów

pluginManagement {
  repositories {
    maven {
      name = "ReposiliteReleases"
      url = uri("https://m2.miloszgilga.pl/releases")
    }
    // opcjonalnie: wymagane tylko jeśli wykorzystywane są wersje snapshot
    maven {
      name = "ReposiliteSnapshots"
      url = uri("https://m2.miloszgilga.pl/snapshots")
    }
    gradlePluginPortal()
  }
}

Użycie esp-idf-plugin

Informacja

Aby korzystać z tej wtyczki, nadal trzeba mieć zainstalowane i skonfigurowane środowisko ESP-IDF w swoim systemie. Wtyczka służy jako wygodna, wieloplatformowa nakładka dla projektów monorepo korzystających z Gradle Kotlin DSL.

Konfiguracja

Wtyczkę należy zaaplikować, a rozszerzenie espIdf skonfigurować w pliku build.gradle.kts projektu firmware:

plugins {
  id("pl.miloszgilga.gradle.espidf") version "X.X.X"
}

espIdf {
  chip.set("esp32c3") // domyślnie: "esp32"
  port.set("/dev/ttyACM0") // domyślnie: port szeregowy zależny od systemu (COM3, /dev/ttyACM0, /dev/cu.usbmodem101)
  baud.set("921600") // domyślnie: "921600"
  appVersion.set("1.0.0") // domyślnie: project.version (lub "0.0.1-local-dev", jeśli nie określono)
}

Dostępne zadania (grupa firmware)

ZadanieOpis
checkEnvWeryfikuje, czy środowisko ESP-IDF oraz idf.py są poprawnie skonfigurowane.
setChipUstawia docelowy układ mikrokontrolera do kompilacji (np. esp32c3, esp32s3, esp32).
buildFirmwareBuduje pełny firmware (bootloader, tablicę partycji oraz aplikację).
buildAppOnlyBuduje wyłącznie plik binarny aplikacji (pomija obrazy bootloadera i partycji).
rebuildFirmwareWymusza rekonfigurację CMake i wykonuje pełną przebudowę firmware'u.
flashFirmwareBuduje i wgrywa pełny firmware na płytkę.
flashAppOnlyBuduje i wgrywa wyłącznie partycję aplikacji na płytkę.
monitorFirmwareOtwiera monitor portu szeregowego z dekodowaniem śladów stosu (backtrace).
runFirmwareBuduje, wgrywa pełny firmware na płytkę i natychmiast uruchamia monitor szeregowy.
eraseFlashCzyści całą pamięć flash układu (w tym NVS oraz pozostałe partycje).
cleanFirmwareCzyści pliki wyjściowe budowania (idf.py fullclean).
generateDocsGeneruje dokumentację projektu przy użyciu narzędzia Doxygen.

Wykorzystane technologie