1 – MICROEJ SDK herunterladen

MICROEJ SDK ist eine auf Eclipse basierende IDE zur Erstellung funktionsreicher Anwendungen für Plattformen, die auf MicroEJ Virtual Execution Environment (VEE) basieren.

---

Unterstützte Betriebssysteme

MICROEJ SDK ist kompatibel mit den folgenden Betriebssystemen: Windows (7, 8, 8.1, 10), Linux, macOS.

Zum Ausführen von MICROEJ SDK ist ein Java™ Runtime Environment 8 auf Ihrem Host-Computer erforderlich. Java™ Runtime Environments herunterladen.

---

MICROEJ SDK Herunterladen

Laden Sie das zu Ihrem Betriebssystem passende Installationspaket herunter (über MICROEJ SDK-Download).

2 – MICROEJ SDK installieren

• Entpacken Sie das heruntergeladene Installationspaket, falls erforderlich.
• Führen Sie die entpackte ausführbare Datei aus.
• Unter Windows akzeptieren Sie die Erhöhung der Administratorrechte.
• Folgen Sie den Schritten des Installationsprogramms.

• Nach der Installation von MicroEJ SDK müssen Sie nach eventuellen Updates suchen und diese gegebenenfalls installieren.
  • Starten Sie MicroEJ SDK
  • Wählen Sie im horizontalen Menü des Hauptfensters Help, dann Check for Updates

  

  • Folgen Sie den Update-Schritten.

3 – Herunterladen und Verwenden des ESP32WROVER Virtual Device, basierend auf dem Black VEE-Beispiel

MicroEJ bietet verschiedene VEE-Beispiele, die alle nach unterschiedlichen Farben benannt sind, um die verschiedenen APIs zu unterscheiden, die diese VEE den Anwendungen zur Verfügung stellt.

• Starten Sie MICROEJ SDK.
• Wählen Sie den Workspace, in dem Sie Ihre Anwendungen speichern möchten. Wenn Sie mit den Eclipse- Workspace nicht vertraut sind, wählen Sie den Standard- Workspace aus und drücken Sie auf Launch.
• Wählen Sie das MicroEJ-Repository, in dem die verschiedenen virtuellen Geräte gespeichert werden sollen. Wenn Sie mit MicroEJ-Repositories nicht vertraut sind, wählen Sie die Standardeinstellung und drücken Sie OK.
• Wählen Sie das Menü Window > Preferences > MicroEJ > Virtual Device menu.
• Laden Sie das ESP32WROVER Virtual Device herunter (siehe Versionshinweise)
• Drücken Sie die Schaltfläche Import... und wählen Sie die zuvor heruntergeladene ESP32WROVER Virtual Device-Datei aus (alle virtuellen Geräte haben die Dateiendung .vde).
• Akzeptieren Sie die Lizenzbedingungen und klicken Sie Finish. Das ESP32WROVER Virtual Device ist erfolgreich installiert.
• Holen Sie sich eine Reihe von Beispielanwendungen. Laden Sie die Anwendungsbeispiele herunter
• Wählen Sie File > Import... > General > Existing Projects into Workspace > Select archive file und wählen Sie das heruntergeladene Archiv aus.
• Importieren Sie alles in Ihren Workspace.

• Öffnen Sie das Projekt-Explorer-Ansichtsfenster  Window > Show View > Project Explorer. Ihre ersten Anwendungen sind geladen und bereit zum Ausführen:
  • Hello World Anwendung: com.microej.demo.hello
  • Hello Bluetooth Anwendung: com.microej.example.bluetooth.hello
  • Hello REST Anwendung: com.microej.example.iot.ssl.rest.headless

4 – Dynamisches Herunterladen und Ausführen von Anwendungsbeispielen auf dem virtuellen ESP32WROVER-Gerät

Herunterladen und Ausführen des Hello World-Beispiels auf dem virtuellen ESP32WROVER-Gerät

• Klicken Sie mit der rechten Maustaste auf das MicroEJ-Projekt com.microej.demo.hello.

• Dann Run As > MicroEJ Application.
• Wenn Sie dazu aufgefordert werden, wählen Sie das ESP32WROVER Virtual Device: VDE-BLACK-ESP32WROVER-RQQAW.
• Das ESP32WROVER Virtual Device läuft und zeigt eine einfache Benutzeroberfläche auf seinem Display an.

 

---

5 – Dynamisches Herunterladen und Ausführen von Anwendungsbeispielen auf dem ESP32WROVER Real Device, basierend auf dem Black VEE-Beispiel

Hardware-Konfiguration

• Alle Tests dieser ersten Schritte wurden auf dem ESP32 WROVER Kit v4.1 durchgeführt (bitte kontaktieren Sie den MicroEJ-Support für andere ESP32-Demoboards).

• Entfernen Sie den Widerstand R167: Er ermöglicht es, dass das Display in Verbindung mit der SD-Kartenunterstützung funktioniert (das Entfernen des Widerstands R167 behebt dauerhaft die Funktion zur Erkennung von SD-Kartenstörungen).

• Stecken Sie die microSD-Karte in das ESP32-WROVER-KIT Entwicklungsboard.
• Standard Ausgaben können über eine UART-Verbindung ausgelesen werden, wenn Sie den USB-Anschluss JP5 mit Ihrem Computer verbinden. Die Konfiguration des UARTs ist: 115200 bps, 8N1, no handshake

---

On Boarding BLACK VEE auf dem echten ESP32WROVER Gerät: Flashen der Firmware

Der BLACK VEE bettet einen dynamischen APP-Loader ein. Einmal geflasht, ist der ESP32WROVER in der Lage, die Anwendung dynamisch zu laden (verlinken und ausführen). Sie müssen das Gerät nicht neu starten.

• Verbinden Sie das Entwicklerboard (Stecker J5) mit einem USB-Kabel an den PC, achten Sie darauf, dass der JumperJP7 auf USB_5V steht.
• Das Python-Skriptesptool aus dem ESP-IDF wird benötigt.
• Sie können das ESP-IDF 3.1.1 von GitHub. herunterladen. Entpacken Sie es in ein Verzeichnis Ihrer Wahl.
• Aus dem Stammverzeichnis des ESP-IDF: das Tool befindet sich in /components/esptool_py/esptool/esptool.py
• Möglicherweise müssen Sie Python und seine Abhängigkeiten mit pip installieren, damit das Tool funktioniert: (Ausführen in einer DOS-Konsole) python -m pip install serial pyserial
• Holen Sie sich das BLACK VEE für das ESP32-WROVER-Board hier: Laden Sie alle .bin-Dateien herunter (siehe Versionshinweise) und legen Sie sie in ein eigenes “binaries” Verzeichnis.
• Als nächstes der auszuführende Befehl, um den ESP32-WROVER zu flashen. Der Befehl geht davon aus, dass er aus dem Ordner “binaries” ausgeführt wird
  • Ersetzen Sie ESPTOOLSXXX durch das Verzeichnis, in dem Sie die Espressif-Toolchain installiert haben
  • Ersetzen Sie COMXXX durch den COM-Port Ihres Entwicklerboards (das ESP32 Wrover Kit v4.1 verfügt über 2 COM-Ports und beide sollten getestet werden, schauen Sie hier für weitere Informationen.)

python.exe ESPTOOLSXXX/components/esptool_py/esptool/esptool.py --chip esp32 --port COMXXX --baud 921600 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size detect 0x1000 bootloader_1.1.1.bin 0x8000 partitions_microej_multiapp_1.1.1.bin 0x10000 BLACK-ESP32WROVER-RQQAW-1.1.1.bin

• Starten Sie den ESP32-WROVER mit dem MicroEJ BLACK VEE. Es wird eine Dateivorlage für die WiFi-Konfiguration auf der microSD-Karte erstellt (wenn keine solche Datei vorhanden ist).
• halten Sie das ESP32-WROVER-Entwicklerboard aus und ziehen Sie die microSD-Karte heraus.
• Verbinden Sie die microSD-Karte mit einem Computer.
• Bearbeiten Sie die Datei /usr/storage/features/EspressifLauncher/wifi.properties.list, und tragen Sie die Informationen zu Ihrem WiFi-Zugangspunkt ein (Sicherheitseinstellungen müssen nicht hinzugefügt werden).
  
  Stellen Sie sicher, dass Sie das # am Anfang der beiden Zeilen entfernen.
• Setzen Sie die microSD-Karte wieder in das ESP32-WROVER-Entwicklerboard ein und schalten Sie es ein.
• Das ESP32-WROVER-Entwicklerboard verbindet sich mit dem von Ihnen angegebenen WiFi-Zugangspunkt, auf dem Bildschirm wird die IP des ESP32-WROVER angezeigt, wenn er verbunden ist. Logs sind über eine UART-Verbindung zugänglich (siehe Hardware-Konfiguration oben für Parameterwerte). Beachten Sie, dass bei schlechtem WiFi-Signal das BLACK VEE endlos versucht, sich zu verbinden, bis es eine Verbindung herstellen kann.
• 

---

Dynamisches herunterladen und ausführen des Hello World Beispiels

Es gibt viele Möglichkeiten, eine Anwendung auf ein Powered by MicroEJ-Gerät herunterzuladen: aus einem APP-Store, Push-/Pull-Modus, usw. Für diese erste Anwendung verwenden wir einen einfachen Ein-Schritt-Prozess:
MICROEJ SDK verwendet das Konzept eines Runners, um die Ausführung von Befehlen zu starten (alle Runners sind über Windows > Show views > Others...General > Runnersoder einfach durch Anklicken des Symbols zugänglich. Wir werden einen Runner erstellen, um den Download zu starten. Sie sollten die Anwendung com.microej.demo.hello bereits einmal gestartet haben, falls nicht, tun Sie es jetzt, wir werden den bereits erstellten Runner wieder verwenden.

• Gehen Sie zu Run > Run Configurations..., wählen Sie com.microej.demo.hello HelloEntryPoint und duplizieren Sie es mit Hilfe der Symbolleiste.

• Das Ergebnis sollte ein Runner namens com.microej.demo.hello HelloEntryPoint (1).
• Wählen Sie es aus und benennen Sie es um zu Deploy com.microej.demo.hello HelloEntryPoint.
• Ändern Sie die Execution auf Execute on Device und die Settings auf Local Deployment to Local Deployment (Socket)

• Wählen Sie die Registerkarte Configuration um dem Runner die Entwicklerboard-IP (die auf dem Bildschirm angezeigt wird) mitzuteilen.

• Klicken Sie auf die Schaltfläche Run: Die Anwendung wird schrittweise OTA auf das Gerät heruntergeladen.
• Wenn eine Anwendung zum ersten Mal heruntergeladen wird, bietet das BLACK VEE einen Autostart der Anwendung: die Hello World Anwendung startet und zeigt ihre Meldungen an.
• Die BLACK VEE bietet einen Anwendungs-Fernverwaltungsdienst über eine Webanwendung, die über den Entwicklerboard-Port 4001 zugänglich ist. Es ist eine eingebaute Anwendung, die von BLACK VEE bereitgestellt wird: Forge Connect. Öffnen Sie einen Webbrowser und geben Sie die IP_OF_THE_BOARD:4001 an. Sie können die Hello World-Anwendung starten und stoppen. Die Anwendung wird auf dem Dateisystem installiert, so dass Sie sie bei einem Neustart über die Forge Connect Anwendung (On-Board-Remote-Service) erneut starten können.

• BLACK VEE ist eine ziemlich vollständige, sichere embedded Plattform, mit einem kompletten Satz an bereits enthaltenen APIs: UI/UX, Dateisystem, Netzwerk, Sicherheit, OSGi-ähnliches Komponenten-Framework, und vieles mehr …

---

(Optional) Verpacken einer WPK-Datei, dynamisches Herunterladen und Ausführen des Hello World-Beispiels

Dies ist ein optionaler Schritt und eine weitere Möglichkeit, eine Anwendung auf einem echten Gerät einzusetzen. WPK-Dateien sind Pakete, die alle Ressourcen Ihrer Anwendung enthalten, um ein WPK zu erhalte.

• Wählen Sie das Projekt com.microej.demo.hello aus und klicken Sie mit der rechten Maustaste, um Build Module.

• Die Anwendung wird erstellt und in Ihrem Projekt gespeichert C:\Users\YOUR_USER_NAME\.microej\workspaces\MicroEJ-SDK-19.05\com.microej.demo.hello\target~\artifacts\hello.wpk
• Wenn das Projekt com.microej.demo.hello ausgewählt ist, klicken Sie mit der rechten Maustaste und wählen Sie Run As > Run Configuration....

• Wählen Sie MicroEJ Tools, und klicken Sie dann mit der rechten Maustaste auf New. Dadurch wird ein neuer Runner erstellt. Geben Sie ihm einen Namen, z. B. Download Hello APP, und wählen Sie dann den Kommunikationsweg mit dem Entwicklerboard: WPK Local deployment over Socket.

• Wählen Sie die Registerkarte Configuration um dem Runner die Entwicklerboard-IP (die auf dem Bildschirm angezeigt wird) und die Datei “hello.wpk” über die Schaltfläche hello.wpk bereitzustellen.
• Klicken Sie auf die Schaltfläche Ausführen: Die Anwendung wird schrittweise OTA auf das Gerät heruntergeladen.
• Wie zuvor, wenn eine Anwendung zum ersten Mal heruntergeladen wird, bietet das BLACK VEE einen Autostart der Anwendung: die Hello World-Anwendung startet und zeigt ihre Meldungen an.

EIN SCHRITT WEITER

Testen Sie maßgeschneiderte IoT-Beispiele

Erweitern Sie Ihre Anwendung mit Kommunikation, in dieser Suite von Beispielen, die die folgenden Themen untersucht:

• Erkennung der Konnektivität.
• JSON-Verarbeitung.
• REST-Server-Einrichtung.
• Verwendung des REST-Clients.
• Interaktion mit einem MQTT-Server.
• SSL-Sicherheit.
• WebSocket-Client-Verwendung.