ESP-IDF est le cadre de développement officiel de la puce ESP32.
Consultez les guides de configuration pour obtenir des instructions détaillées sur la configuration de l'ESP-IDF :
En plus du projet esp-idf-template mentionné dans le guide de configuration, ESP-IDF est livré avec quelques exemples de projets dans le répertoire des exemples.
Une fois que vous avez trouvé le projet avec lequel vous souhaitez travailler, accédez à son répertoire et vous pourrez le configurer et le construire.
make menuconfig
? pour voir un écran d’aide. La touche Entrée permet de quitter l'écran d'aide.Y et N pour activer (Oui) et désactiver (Non) les éléments de configuration avec les cases à cocher " [*] "? lors de la mise en surbrillance d'un élément de configuration, l'aide sur cet élément s'affiche./ pour rechercher les éléments de configuration.Une fois la configuration terminée, appuyez plusieurs fois sur Échap pour quitter et dites « Oui » pour enregistrer la nouvelle configuration lorsque vous y êtes invité.
make all
... compilera l'application, le chargeur de démarrage et générera une table de partition basée sur la configuration.
Une fois make all terminées, il imprimera une ligne de commande pour utiliser esptool.py pour flasher la puce. Cependant, vous pouvez également le faire depuis make en exécutant :
make flash
Cela flashera l'intégralité du projet (application, chargeur de démarrage et table de partition) sur une nouvelle puce. Les paramètres de clignotement du port série peuvent être configurés avec make menuconfig .
Vous n'avez pas besoin d'exécuter make all avant d'exécuter make flash , make flash reconstruira automatiquement tout ce qui en a besoin.
La cible make monitor utilisera le miniterm déjà installé (une partie de pyserial) pour afficher la sortie série de l'ESP32 sur la console du terminal.
Quittez miniterm en tapant Ctrl-].
Pour flasher et surveiller la sortie en un seul passage, vous pouvez exécuter :
make flash monitor
Après le flash initial, vous souhaiterez peut-être simplement créer et flasher uniquement votre application, pas le chargeur de démarrage et la table de partition :
make app - créez uniquement l'application.make app-flash - flashez uniquement l'application. make app-flash reconstruira automatiquement l'application si elle en a besoin.
(Dans un développement normal, il n'y a aucun inconvénient à reflasher le chargeur de démarrage et la table de partition à chaque fois, s'ils n'ont pas changé.)
ESP-IDF prend en charge la compilation de plusieurs fichiers en parallèle, de sorte que toutes les commandes ci-dessus peuvent être exécutées sous la forme make -jN où N est le nombre de processus de création parallèles à exécuter (généralement, N doit être égal ou supérieur au nombre de cœurs de processeur). dans votre système.)
Plusieurs fonctions de marque peuvent être combinées en une seule. Par exemple : pour créer l'application et le chargeur de démarrage en utilisant 5 tâches en parallèle, puis tout flasher, puis afficher la sortie série de l'exécution ESP32 :
make -j5 flash monitor
Une fois que vous avez compilé votre projet, le répertoire "build" contiendra un fichier binaire avec un nom comme "my_app.bin". Il s'agit d'une image binaire ESP32 qui peut être chargée par le chargeur de démarrage.
Le flash d'un seul ESP32 peut contenir plusieurs applications, ainsi que de nombreux types de données différents (données d'étalonnage, systèmes de fichiers, stockage des paramètres, etc.). Pour cette raison, une table de partition est flashée pour décaler 0x4000 dans le flash.
Chaque entrée de la table de partition a un nom (étiquette), un type (application, données ou autre), un sous-type et le décalage en flash où la partition est chargée.
La façon la plus simple d'utiliser la table de partition est de make menuconfig et de choisir l'une des tables de partition simples prédéfinies :
Dans les deux cas, l'application d'usine est flashée au décalage 0x10000. Si vous make partition_table , il imprimera un résumé de la table de partition.
Pour plus de détails sur les tables de partition et sur la façon de créer des variantes personnalisées, consultez le fichier docs/partition-tables.rst .
La cible make flash n'efface pas tout le contenu du flash. Cependant, il est parfois utile de remettre l'appareil dans un état totalement effacé, notamment lors de modifications de la table de partition ou de mises à jour de l'application OTA. Pour effacer l'intégralité du flash, exécutez make erase_flash .
Cela peut être combiné avec d'autres cibles, c'est-à-dire que make erase_flash flash effacera tout, puis reflashera la nouvelle application, le chargeur de démarrage et la table de partition.
Documentation pour la dernière version : http://esp-idf.readthedocs.io/. Cette documentation est construite à partir du répertoire docs de ce référentiel.
Le forum esp32.com est un endroit pour poser des questions et trouver des ressources communautaires.
Consultez la section Problèmes sur github si vous trouvez un bug ou si vous avez une demande de fonctionnalité. Veuillez vérifier les problèmes existants avant d'en ouvrir un nouveau.
Si vous souhaitez contribuer à l'ESP-IDF, veuillez consulter le Guide des contributions.
