Last Updated on 7. Januar 2021 by sfambach
Hier beschreibe ich wie ein neues IDF Projekt angelegt wird.
Wie die IDF, auch in Verbindung mit VS-Code, genutzt und installiert wird, habe ich unter folgenden Links schon beschrieben und ist nicht Gegenstand dieses Beitrags.
Ein guter Start ist das IDF-Beispiel examples/get-started/sample_project aus dem esp-idf Ordner zu kopieren.
Dieser Ordner enthält fast alles, was für ein neues Projekt benötigt wird.
Den Unterordner components habe ich der Vollständigkeit halber hinzugefügt. Dieser enthält gekapselte Projekte wie zum Beispiel Bibliotheken.
Die CMakeList.txt enthält einen Verweis auf die standard Make-Datei und den Projekt Namen.
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(main)Ein änlicher Inhalt ist im Makefile zu finden.
Die Readme.md beschreibt das Beispielprojekt, kann später aber zur Dokumentation des eigenen Projektes dienen.
Der Ordner main ist die Spielwiese des neuen Projektes. Hier finden wir unser Hauptprogramm (main.c), eine weitere CMakeLists.txt Datei und die component.mk. Hier werden auch alle Unterprogramm-Dateien abgelegt. Für das Hauprogramm ist die component.mk nur ein Dummy, sie wird später für die „richtigen“ Komponenten im Componets Ordner benötigt.
Die CMakeLists.txt Datei enthält die Komponentenbeschreibung für unser Hauptprogramm. Sie setzt sich aus den verwendeten Quellcode-Dateien
SRCS="main.c" "datei1.c" "datei2.c" "..." den Include-Pfaden
INCLUDE_DIRS "." "pfad2" "pfad ..."und optional aus den benötigten Komponenten zusammen.
COMPONENTS "Comp1" "Comp2"Unsere intiale Version sieht wie folgt aus
idf_component_register(SRCS "main.c"
INCLUDE_DIRS "." )Die main.c Datei enthält nur eine Funktione die main_app. Diese wird vom Controller aufgerufen und ist der Startpunkt für unser Programm. Die Standard IO wird auch schon referenziert.
Fazit
Das Projekt ist schnell kopiert und man hat fast alles was man braucht. Je nachdem welche Applikation erstellt werden soll, bietet es sich an eines der anderen Projekte im Beispielordner zu kopieren.