Lyra T getting started
Einführung
Libraries
Espressif stellt zur Entwicklung ihrer Dev Boards verschiedene Frameworks zur Verfügung.
ESP-IDF ist das offizielle Framework zur Entwicklung für alle ESP32 basierten Boards und bietet allerlei Tools und Bibliotheken. Es bietet Commandline Tools zur kompilierung und konfigurierung von ESP32 Projekten, zum flashen und monitoren der Boards an.
ESP IDF bietet eine umfangreiche API und dazugehörige Beispielprojekte.
ESP-ADF das Audio Development Framework von Espressif, dient zur Entwicklung von Audioanwendungen mit Boards wie dem LyraT. Es bietet zahlreiche möglichkeiten Audiostreams zu verarbeiten und unterschiedliche Codecs zu verwenden. Außerdem bietet es möglichkeiten zur Verarbeitung von Audiodaten und eine Bibliothek zur Spracherkennung. Docs ESP-ADF hier findest du die Dokumentation zu ESP-ADF.
Einführung
Google Chrome übersetzt die Seiten aus dem Chinesischen direkt in die gewünschte Zielsprache.
Getting Started Die Getting Started Seite von Espressif bietet einen guten Einblick in den Aufbau und Verwendung des LyraT. Dort findet man alle Anleitungen und allgemeine Informationen.
Installation
Folge dem Installation Guide und installiere, bevor es los geht ESP-IDF und ESP-ADF. Zur Entwicklung von Audioanwendungen mit den LyraT-Boards benötigen wir beides.
Installiere ESP-IDF
Windows
Nutze den Installer der von Espressif zur Verfügung gestellt wird. Ich empfehle den Universal Online installer mit standard Einstellungen des Installers, es reicht in der Regel dem Wizard zu folgen und dort nichts zu verstellen. Der Installer installiert alles was wir zur Entwicklung benötigen wie cmake, python, ninja etc.
Außerdem wird auch eine Kommandozeile installiert, die wir in den folgenden Schritten verwenden werden, sie ist als ESP-IDF 5.2 CMD in der Sucheleiste (Win-Taste) zu finden. Dort wurden alle benötigten PATH Variablen für uns gesetzt und wir können auf die installierten Tools direkt zugreifen.
Der Standartinstallationspfad lautet C:\Espressif
Linux
Folgende Eingabe installiert alle für die Kompilation von ESP-IDF Projekten notwendigen Pakete.
sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
Mac OSX
Mac OSX Installations Guide Homebrew
Installiere falls noch nicht geschen Homebrew auf deinem Mac. Hombrew ist ein Opensource Paketmanager für Mac. Mit einem Paketmanager kann man Softwarepakete installieren und verwalten. Wir benötigen Homebrew zur Installation von ESP-IDF.
Öffne die Kommandozeile. Du öffnest deine Kommandozeile indem du CMD+Space drückst und Terminal eingibst. Bestätige mit Enter. Es sollte ein schwarzes Fenster aufpoppen, in dem ein blinkender Cursor anzeigt, dass die Kommandozeile für die Eingabe bereit ist. Kopiere folgende Eingabeaufforderung in deine Kommandozeile und folgende den Anweisungen de Skripts.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Wenn du Hombrew hast kannst du folgende mit folgender Eingabe alle nötigen Pakte installieren um erfoglreich mit ESP-IDF zu kompilieren.
brew install cmake ninja dfu-util
Installiere ESP-ADF
Navigiere mit der Kommandozeile deiner Wahl in den Espressif Installationsordner. Bist du dieser Anleitung gefolgt findest du ihn unter Windows in
C:\Espressif
Nutze git um dir das ESP-ADF Repository zu klonen.
git clone --recursive https://github.com/espressif/esp-adf.git
ESP-ADF sollte in ./esp-adf heruntergeladen worden sein.
Führe das Installationsskript aus.
Windows:
./install.bat
Linux/Mac:
./install.sh
Windows
Nach der Installation kannst du unter Windows entweder die ESP-IDF Shell nutzen. Drücke die Windows-Taste und gib ESPD-IDF 5.2 CMD in die Suche eine und starte die Shell. Navigiere mit der Shell in den ESP IDF installations Ordner. Er Befindet unter C:/Espressif Um mit der Entwicklung zu starten müssen wir folgendes Skript ausführen.
%userprofile%\esp\esp-adf\export.bat
So werden die nötigen Umgebungsvariabeln gesetzt.
Unter Mac und Linux erledigt das folgende Shellskript für dich.
. $HOME/esp/esp-adf/export.sh
Als nächstes testen wir die Entwicklungstools an einem Beispielprojekt, kopiere dir dafür ein Example aus dem ADF Ordner. Schließe den LyraT mit an deinen Rechner an, nutze dabei beide USB Ports des Boards, ein Port dient der Stromversorgung der anderen, der Datenübertragung und Kommunikation.
In der Kopie des Beispielprojekts setzen wir mit
idf.py set-target esp32
oder
idf.py menuconfig
das Zielboard. Das Menuconfig Tool ist dabei sehr praktisch, hier können nicht nur das Zielboard gesetzt sondern allerlei Einstellungen, wie zum Beispiel WiFi Passwörter setzen, vorgenomen werden.
als nächstes komplieren wir das Projekt. Dafür nutzen wir das Build Tool das IDF Frameworks.
idf.py build
als nächstes flashen wir das Projekt auf das Board. Ersetze PORT mit dem Port, den das Board auf deinem Rechner nutzt. Wenn du dir nicht sicher bist verrät dir der DeviceManager unter Windows welche Comports verwendet werden. Find Comport
idf.py -p PORT -b 115200 flash
Drücke während das Tool ein Board kurz die Reset- und Boot-Taster. Jetzt sollte das Board geflasht werden.
Nutzen wir das Monitoringtool und schauen uns die Kommunikation zwischen dem Board und unserem Rechner an. Dabei ist es wichtig , die richtige Baudrate anzugeben.
`idf.py monitor -b 115200