lehrkraefte:blc:informatik:ffprg2-2021:twatch:start

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
lehrkraefte:blc:informatik:ffprg2-2021:twatch:start [2021/07/01 08:29] – [TTGO TWatch 2020] Ivo Blöchligerlehrkraefte:blc:informatik:ffprg2-2021:twatch:start [2021/08/21 19:20] (current) – [Status- und Werkzeugleiste von PlatformIO (ganz unten)] Ivo Blöchliger
Line 1: Line 1:
 +====== 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:
 +  * 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).