Differences

This shows you the differences between two versions of the page.

--- lehrkraefte:blc:informatik:ffprg2-2021:twatch:start [2021/06/06 10:59]
Ivo Blöchliger
+++ lehrkraefte:blc:informatik:ffprg2-2021:twatch:start [2021/08/21 21:20] (current)
Ivo Blöchliger [Status- und Werkzeugleiste von PlatformIO (ganz unten)]
@@ Line 1: / Line 1: @@
-====== TTGO TWatch 2020 ======
+====== TTGO TWatch 2020 V3 ======
+===== Setup VSCode =====
+  * [[e24laptops|Setup auf den Linux-Laptops aus dem E24]]
+  * [[eigenegeraete|Setup auf eigenen Geräten]]
+  * [[schulcomputer|Setup auf den Schulcomptern]]
+==== Status- und Werkzeugleiste von PlatformIO (ganz unten) ====
+{{lehrkraefte:blc:informatik:ffprg2-2021:twatch:platformio_status_und_werkzeugleiste.png}}
+  * main (aktueller git-Branch)
+  * ✓ Kompilieren (Source-Code übersetzen). Dazu muss ein Editor-Fenster mit C++-Code vom Projekt aktiv sein?
+  * -> Kompilieren und auf die Uhr laden
+  * 🔌 Ausgabe vom Seriellen Port anzeigen (damit können auch Daten an die Uhr gesendet werden, z.B. zur Eingabe vom WLAN-Passwort).
+  * Wählen Sie beim letzten Punkt die Version für Ihr System (sonst wird das Projekt 4x kompiliert...)
+===== Abläufe zum Beitragen einer App =====
+  * Arbeiten Sie auf einem eigenen Branch, dessen Name mit Ihren Initialen endet, z.B. coolWatch_IB.
+  * Sie sollten Ihren Code mit der GPL lizenzieren (oder eine andere Open-Source Lizenz Ihrer Wahl).
+  * Die Informationen zu Bildern muss in einer Datei ''abouticon.txt'' vermerkt sein (Autoren, Lizenz, eventuell URLs).
+  * Wenn Sie einen GitHub-Account haben:
+    * pushen Sie Ihren Branch und machen Sie einen Pull-Request.
+    * Ich werde den Branch testen und in den main-Branch einbinden. Die weitere Entwicklung kann dort erfolgen.
+  * Wenn Sie keinen GitHub-Account haben:
+    * Schicken Sie mir eine Zip-Datei des Ordners, der Ihre App enthält. Ich werde die App einbauen, testen und dann in den main-Branch einbauen.
+    * Für die Weiterentwicklung wäre es praktisch, Sie hätten einen GitHub Account.
+===== Links und Resourcen =====
 Links:
-  * https://github.com/Xinyuan-LilyGO/TTGO_TWatch_Library
+  * Library, die wir verwenden: https://github.com/Xinyuan-LilyGO/TTGO_TWatch_Library (naja, eigentlich ein Klon davon, mit aktuellerer lvgl-Library).
+Weitere nennenswerte Projekte und Resourcen
   * https://github.com/SpectralCascade/FancyWatchOS
   * https://github.com/sharandac/My-TTGO-Watch
   * https://twatchbuilder.com/
   * https://www.freertos.org/index.html
+Weitere TWatch kaufen, z.B. direkt beim Hersteller LilyGo auf [[https://www.aliexpress.com/item/1005002053650442.html|AliExpress]].
+===== Minimales T-Watch Projekt =====
+Am einfachsten importieren Sie folgendes git-Repository: https://github.com/techlabksbg/minimal_twatch.git
+Dieses enthält auch weitere Branches mit Beispielen.
+==== Manuelles Setup ====
+  * Neues PIO-Projekt
+  * Board: TTGO T-WATCH
+  * Framework: Arduino
+  * Ändern Sie die Datei platformio.ini wie folgt ab:
+<hidden platformio.ini>
+<code txt>
+[env]
+platform = espressif32
+board = ttgo-t-watch
+framework = arduino
+monitor_speed = 115200
+[env:ttgo-t-watch-linux]
+upload_port = /dev/ttyUSB0
+[env:ttgo-t-watch-windows]
+upload_port = COM4
+[env:ttgo-t-watch-macos]
+; On the Mac, set the environment variable PLATFORMIO_UPLOAD_PORT
+; to your device port, for example as follows:
+;
+;          launchctl setenv PLATFORMIO_UPLOAD_PORT /dev/tty.usbserial-0233D4FC
+</code>
+</hidden>
+  * Und das main.cpp:
+<hidden main.cpp>
+<code c++>
+#include <Arduino.h>
+void setup() {
+  Serial.begin(115000);
+}
+/**
+ * Open the serial monitor to see the output
+ */
+void loop() {
+  Serial.println("Hello world!");
+  delay(1000);
+}
+</code>
+</hidden>
+===== Neue App =====
+  * Neuen git-branch anlegen (z.B. motorapp).
+  * Im Ordner src/app einen neuen Ordner anlegen (z.B. motorapp), dort drin zwei neue Dateien, motorapp.h und motorapp.cpp
+  * Icon erstellen: 72x72 Pixel, mit Alpha-Channel, konvertieren auf https://lvgl.io/tools/imageconverter
+  * Text-Datei abouticon.txt erstellen, mit Informationen zu den Urhebern der Icons
+  * App Programmieren. Dazu den Code einer einfachen App kopieren und Anpassen (z.B. die motorApp oder die poweroff app).
+  * App in launcher.h eintragen.
+  * Testen
+  * Committen
+  * Wiederholen. Pullrequest an mich (mündlich oder auf GitHub).