# Hilfe und Support

Hier findest du schnelle Hilfe. Klicke einfach auf den entsprechenden grünen Block, um direkt zum Handbuch oder zu den Tutorials zu springen.

🌐 PROGRAMM START: Support aufrufen
WENN Thema = Handbuch Arduino machen:
➔ Öffne Handbuch Arduino
SONST WENN Thema = Handbuch Processing machen:
➔ Öffne Handbuch Processing
SONST Suche = Tutorials machen:
➔ Öffne die Tutorials
ENDE

## Benötigte Libraries (Bibliotheken)

Eine Library ist ein Paket aus vorgefertigtem Code, das deinem Arduino beibringt, wie er mit komplexen Bauteilen (wie Displays, Sensoren oder speziellen Shields) sprechen kann. Lade hier die benötigten Pakete für deine LogicKiste herunter.

### 📥 Library Downloads:

- GEngine (Spiele-Engine) – GEngine.zip
- Encoder (Drehgeber) – K4_ENC-main.zip
- Analog Manager (Glätter, Tasten, Joystick) – KK_Analog.zip
- Profi Taster (Entprellt & Zähler) – KK_ButtonHandler.zip
- TCA9555 (Port-Erweiterung) – LogicKiste_TCA9555.zip
- YX5300 (MP3 Player) – YX5300_Player.zip
- TTP229 (TTP 229 touch) – TTP229_T9.zip
- FUP (FUP Bibliothek) – LogiLadder.zip
- SIM (Simulation Bibliothek) – Simulation.zip

Hinweis zu den Shields: Um die Lade- und Kompilierzeiten zu optimieren, hat jedes Shield nun seine eigene, schlanke Bibliothek. Lade dir einfach genau die ZIP-Datei herunter, die du für dein aktuelles Projekt benötigst, und binde sie in deine Arduino IDE ein.
Wichtig: Wenn beim Kompilieren ein Fehler wie z. B. "dht.h fehlt" (fatal error: dht.h: No such file or directory) auftaucht, ist das kein Fehler im Code! Es bedeutet lediglich, dass eine externe Abhängigkeit fehlt. Installiere in diesem Fall einfach die passende Library (in diesem Beispiel die DHT-Bibliothek) über den Bibliotheksverwalter der Arduino IDE nach.

- Multi Shield – Shield_MultiFunction.zip
- Rich Shield 1 – Shield_RichShield1.zip
- Rich Shield 2 – Shield_RichShield2.zip
- Keyestudio V1 – Shield_Keyestudio.zip
- Keyestudio V2 – Shield_MultiFunctionV2.zip

### 🛠️ So installierst du eine Library in der Arduino IDE:

- 👉 Weg 1 (Der einfache): Gehe in der Arduino IDE auf Sketch ➔ Bibliothek einbinden ➔ .ZIP-Bibliothek hinzufügen und wähle die geladene Datei aus.
- 👉 Weg 2 (Der manuelle): Entpacke die `.zip`-Datei und schiebe den gesamten Ordner in dein Verzeichnis unter Dokumente/Arduino/libraries.

## Arduino Live Simulation

Mit der Arduino Live-Simulation kannst du deine programmierte Steuerungslogik direkt an digitalen Zwillingen echter Industriemodelle testen. Dein Arduino bleibt dabei per USB mit dem PC verbunden, führt deinen echten Code aus und tauscht in Echtzeit die Ein- und Ausgangssignale mit der PC-Simulation aus. Lade dir hier die fertigen Blockly Dateien!

### 📥 Simulations Downloads:

- Ampel (Dunkel-Ampel) – ampel.zip
- Rolltor (Industrie-Rolltor) – industrietor.zip

### 💻 LogicKiste Offline nutzen

Du möchtest deine Projekte coden, hast aber in der Werkstatt kein Internet? Kein Problem! Lade dir hier die komplette LogicKiste als ZIP-Datei herunter. Einfach entpacken, die `index.html` per Doppelklick in deinem Browser öffnen und komplett offline programmieren.

- ➔ logickiste.zip herunterladen

## 📦 Versionsverlauf (Changelog) – LogicKiste

Hier erfährst du alles über die Entwicklung und die neuen Funktionen von LogicKiste, deiner komplett werbefreien und DSGVO-freundlichen Programmierumgebung für den Arduino R4!

### 🚀 Version 1.10.0 Das "Mapping & Shield"-Update

Datum: 21.08.2026

Ein weiteres starkes Update für deine LogicKiste! Entdecke das brandneue Mapping-Tool zur visuellen Strukturierung deiner Ideen, nutze neue Shields und profitiere von wichtigen Bugfixes.

#### 🗺️ NEU: Concept Mapping Tool

- Visuelle Planung: Mit dem neuen Concept Mapping Tool kannst du Projektideen, Programmabläufe oder Hardware-Strukturen grafisch planen, bevor du den ersten Code-Block setzt.
- Der Gedanke dahinter: Komplexe Zusammenhänge lassen sich oft viel einfacher verstehen und vermitteln, wenn man sie als Mindmap oder Ablaufdiagramm visualisiert. Verbinde einfach Konzepte und Bausteine miteinander, um dir einen klaren Überblick über das fertige Projekt zu verschaffen!

#### 🧩 Bugfixes & Arduino-Erweiterungen

- NeoPixel Bugfix: Der lästige Kompilierfehler bei der Verwendung von NeoPixeln wurde erfolgreich beseitigt. Deine LED-Projekte lassen sich nun wieder reibungslos kompilieren.
- Echter Analog-Ausgang: Es wurde ein neuer Block für den Arduino A0 Pin hinzugefügt, der dir ab sofort einen echten 0-5 Volt Ausgang (DAC) ermöglicht.

#### 🛡️ Neue Shields unterstützt

Ich habe drei weitere Erweiterungsboards in die Bibliothek aufgenommen, um deine Hardware-Projekte noch komfortabler zu machen:

- Servo Shield
- NFC (PN532)
- KS Motor/Servo

### 🚀 Version 1.9.0 Das "Touch & Schaltplan-Profi"-Update

Datum: 16.08.2026

Ein weiteres starkes Update für deine LogicKiste! Mit der Integration des 16-Tasten Touch-Moduls, professionellen Bézierkurven im Schaltplan und optimierten Zustandsautomaten.

#### ⚡ Schaltplan-Editor Update

- Bézier-Werkzeug: Integriertes Bézierwerkzeug für präzise, geschwungene Leitungs- und Verbindungskurven im Schaltplan-Editor.
- Import-Fehler behoben: Fehler beim Importieren von Daten und Plänen wurden erfolgreich behoben.
- Editor-Optimierungen: Kleinere Fehler im Editor wurden behoben, um die Stabilität und Bedienbarkeit weiter zu verbessern.

#### 🧩 Blockly-Update & Erweiterungen

- Touch-Unterstützung hinzugefügt: Volle Integration für das TTP229 16-Tasten Touch-Modul inklusive einfachem Auslesen, Zahlenreihen-Eingabe und T9-Textmodus.
- Tabellen optimiert: Leistungsstarke und verbesserte Array-Funktionen für den professionellen Einsatz.
- Zustandsautomaten ergänzt: Zwei neue Enumerations-Zustandsautomaten (Zeiger- und SPS-basiert) für noch flexiblere Ablaufsteuerungen.

#### 🛑 Hinweis zur FUP-Kiste

- Entwicklung pausiert: Die FUP-Kiste wird vorerst nicht weiterentwickelt, da die zeitliche Priorität aktuell vollständig auf Blockly und dem Schaltplan-Editor liegt.

### 🚀 Version 1.8.0 Das "Schaltplan & Sim-Boost"-Update

Datum: 03.08.2026

Der nächste große Schritt für deine LogicKiste! Mit diesem Update bringe ich einen vollwertigen CAD-Editor direkt zu dir. Außerdem habe ich den Einstieg in die Simulationen massiv vereinfacht und lästige Bugs beim Speichern ausgemerzt.

#### ⚡ NEU: Integrierter Schaltplan-Editor

Plane und dokumentiere deine Hardware-Aufbauten und Verdrahtungen direkt im Browser.

- Vollwertige Zeichenumgebung: Ein kompletter Editor mit DIN-A4 Export-Funktion, Inhaltsverzeichnis und intelligenter Raster-Ausrichtung.
- Riesige Bauteil-Bibliothek: Ziehe normgerechte Kontakte, Sicherungen, Verbraucher (wie Motoren und Heizwiderstände) und Elektronik-Komponenten (Arduino Boards, ICs, Netzteile) einfach per Drag-and-Drop auf dein Blatt.
- Eigene Bauteile: Fehlt etwas? Zeichne im Editor einfach deine eigenen Bauteile und speichere sie dauerhaft in deiner persönlichen Bibliothek.

#### 🎓 UPDATE: Simulationen & Handbuch

Der Start in die digitalen Zwillinge ist jetzt noch zugänglicher und lehrreicher.

- Neues Handbuch verfügbar: Ab sofort gibt es eine detaillierte Dokumentation, die dir genau zeigt, wie die interaktiven Desktop-Umgebungen funktionieren.
- Interaktive Tutorials: Jede Simulation bringt jetzt ein eigenes Tutorial mit.
- Vorgefertigte .json Beispiele: Lade fertige Blockly-Beispielcodes für Ampeln, Tore oder Förderbänder direkt in den Editor, um sie sofort zu testen oder als Basis für eigene Ideen zu nutzen.

#### 🐛 BUGFIX: Unterprogramme

- Speicher-Fehler behoben: Beim Laden von Unterprogrammen kam es bisher zu einem Fehler, bei dem vergebene Namen nicht korrekt gespeichert wurden. Das System merkt sich deine Benennungen jetzt wieder fehlerfrei!

### 🚀 Version 1.7.0 Das "Echtzeit-Hardware-Simulation"-Update

Datum: 24.07.2026

Mit diesem Update wird die Brücke zwischen visueller Code-Erstellung und physischer Automatisierungstechnik geschlagen! Ab sofort kannst du deine geschriebenen Programme in einer interaktiven Desktop-Umgebung testen komplett mit virtueller Mechanik, Sensorik und HMI-Bedienpulten.

#### ⚙️ NEU: Interaktive Python-Echtzeit-Simulation

Testen ohne Risiko: Steuere digitale Zwillinge echter Industriemodelle direkt über deinen Arduino R4 an.

- Digitale Zwillinge für den Unterricht: Interaktive Modelle wie Fußgängerampel, Automatiktor, Industriepresse und Förderband bringen sofort sichtbare Lernerfolge.
- Virtuelles HMI-Display (LCD): Systemzustände, Texte und Positionen werden live auf dem vergrößerten Schaltschrank-Display ausgegeben.
- Hardware & Simulation vereint: Kombiniere echte Taster auf dem Steckbrett nahtlos mit der virtuellen Modellwelt am PC.
- Intelligenter delay()-Bypass: Ein integrierter Makro-Hack verhindert das Einfrieren der seriellen USB-Kommunikation die Animation läuft auch bei Wartezeiten flüssig weiter.
- Kollisionsfreie Architektur: Isolierte Modul-Funktionen garantieren den reibungslosen Wechsel zwischen verschiedenen Blockly-Simulationen.

### 🚀 Version 1.6.0 Das "FUP-Editor (Beta)"-Update

Datum: 22.07.2026

Mit diesem Update bekommst du ein mächtiges neues Werkzeug an die Hand, das speziell für produktive und praxisnahe Engineering-Lösungen entwickelt wurde: Der visuelle FUP-Editor (Funktionsbaustein-Sprache) startet in die Beta!

#### ⚙️ NEU: FUPkiste Der grafische FUP-Editor

Programmiere deinen Arduino ab sofort im klassischen SPS-Stil. Verbinde Logikbausteine per Drag-and-Drop und lass dir daraus vollautomatisch hochperformanten C++ Code generieren.

- Integrierte Live-Simulation: Teste deine Steuerungslogik direkt im Browser. Per Klick startet ein 100-ms-SPS-Zyklus. Signale lassen sich per Schalter setzen und aktive Datenpfade leuchten live grün oder orange auf.
- Umfangreiche Baustein-Bibliothek: Greife auf professionelle Logikelemente wie TON/TOF-Timer, RS/SR-FlipFlops, Flankenauswertung (R_TRIG/F_TRIG), Zähler und Analog-Vergleicher zu.
- Intelligentes LCD-Management: Gib Meldetexte flackerfrei und priorisiert über I2C-Displays aus. Der integrierte `LogiLCDManager` kümmert sich automatisch um die Rotation der wichtigsten Meldungen im Hintergrund.
- 100% Offline & Autark: Der komplette Editor läuft dank lokaler Einbindung aller Skripte (wie Drawflow) direkt in deinem Browser ganz ohne Internetverbindung in deiner Werkstatt.

### 🚀 Version 1.5.0 Das "Starter-Shields & Pro-Control"-Update

Datum: 16.07.2026

Dieses riesige Update bringt die ultimative Unterstützung für beliebte Erweiterungsboards (Starter-Shields) direkt in die LogicKiste und gibt dir noch mehr Werkzeuge für professionelle Code-Strukturen an die Hand!

#### 🛡️ NEU: Volle Unterstützung für Starter-Shields

In der brandneuen Kategorie "Starter-Shields" findest du ab sofort maßgeschneiderte Blöcke für die beliebtesten Lehr- und Entwicklungsboards. Kein mühsames Suchen nach Pin-Belegungen mehr!

- Multi-Function Shield: Steuere das 4-fach 7-Segment-Display, die Taster (inkl. Event- und Zähler-Abfrage), LEDs, den Buzzer sowie Potis und externe Servos direkt an.
- Rich Shield 1: Nutze Blöcke für die Digital- und PWM-LEDs, Töne, Sensoren (Spannung, DHT) sowie die integrierte Infrarot-Fernbedienungsabfrage.
- Rich Shield 2: Fragerichtung des Joysticks abfragen, den PIR-Bewegungssensor auslesen, den Drehgeber (Encoder) nutzen oder die 16x8 LED-Matrix und den RGB-Batteriestatus steuern.
- Keyestudio Shield 1: Volle Kontrolle über integrierte Taster, LEDs, den RGB-Lichtblock, Buzzer sowie DHT- und Infrarot-Sensoren.

#### 💻 Erweiterte Logik, Infrarot & Systemfunktionen

- Infrarot-Schnittstelle (IR Transceiver): Baue eigene Fernbedienungen oder Empfänger! Sende und empfange Standard- oder Raw-Infrarotsignale und verarbeite sie direkt in Arrays.
- DS18B20 OneWire-Sensoren: Temperaturmessung für Profis. Du kannst die präzisen Sensoren jetzt direkt per Index oder Hardware-Adresse auslesen und eine integrierte Diagnose nutzen.
- State Machine 2.0: Komplexe Abläufe und Schrittketten werden noch mächtiger mit den neuen zeitabhängigen Zuständen (`ard_state_time`).
- Multi-Logik: Verknüpfe Bedingungen noch kompakter mit neuen Blöcken für 3-fach und 4-fach UND/ODER-Verknüpfungen.
- Lokale Merker (`static`): Deklariere Variablen, die ihren Wert behalten, aber nur lokal gültig sind.
- Hardware-Reset & Schleifensteuerung: Starte das System per Block neu (`System Reset`) oder nutze `break` und `return` für die professionelle Steuerung deiner Schleifen und Unterprogramme.
- Intervall-Zähler: Die Timer-Kategorie wurde um flexible Takt-Zähler erweitert (`Set/Reset/Get Counter`).

### 🔄 Version 1.4.0 Das Industrie- & Multimedia-Update

Datum: 11.06.2026

Fokus auf Profi-Schnittstellen und die Welt der Spiele-Programmierung!

- Game-Engine (G-Engine): Erschaffe eigene Mini-Games! Erstelle Akteure (Sprites), bewege sie und frage Kollisionen oder Game-Over-Bedingungen ab.
- Processing-Anbindung (HMI): Koppele deinen Arduino R4 mit interaktiven Programmen auf deinem PC, um Daten hin und her zu senden.
- CAN-Bus & DMX-Lichtsteuerung: Nutze den CAN-Bus (bekannt aus der Fahrzeugtechnik) oder steuere professionelles Bühnenlicht über DMX (direkt, gepuffert oder im vereinfachten Modus).
- MP3-Audio (YX5300) & E-Paper-Displays: Bring deine Projekte zum Sprechen oder nutze extrem stromsparende E-Paper-Anzeigen.
- Komfort im Editor: Neue Schnell-Einfüge-Buttons für Zahlen und Variablen im Kopfmenü sowie praktische Farb-Container zur visuellen Ordnung deiner Blöcke.

### 🔄 Version 1.3.0 Das Internet-Meilenstein-Update

Datum: 14.05.2026

Dieses Update bringt deinen Arduino R4 WiFi ins Netz!

- WLAN & Webserver: Verbinde dein Board mit dem WiFi, frage die IP ab und baue einen eigenen Webserver, um Daten direkt über eine Webseite zu senden oder zu empfangen.
- OLED-Displays (SSD1306): Der beliebte Display-Klassiker wird jetzt nativ unterstützt.
- Interne Echtzeit-Uhr (RTC): Nutze die eingebaute Uhr des R4-Chips, um zeitgesteuerte Projekte sekundengenau umzusetzen.
- C++ Kommentare: Mit dem neuen Kommentar-Block kannst du Notizen im Editor hinterlassen, die als echter `// C++` Kommentar exportiert werden.
- Flüssigeres Arbeiten: Die Code-Generierung im Hintergrund wartet nun intelligent ab (Debounce), bis du einen Block fertig gezogen hast, damit der Editor absolut ruckelfrei läuft.

### 🔄 Version 1.2.0 Das R4-Profi-Mathe & Sensor-Update

Datum: 16.04.2026

Mehr Rechenpower und die ersten maßgeschneiderten R4-Komponenten.

- R4 Onboard LED-Matrix: Steuere die rote LED-Matrix direkt auf deinem R4 WiFi-Board an (Symbole, Lauftexte, Pixelsteuerung).
- Gyro-Sensor (MPU6050) & RFID (RC522): Volle Unterstützung für Beschleunigungssensoren und Chipkarten-Leser.
- Erweiterte Mathematik: Komplexe Berechnungen mit Trigonometrie, Wurzeln, Potenzen und der Kreiszahl π.
- Tabellen (Arrays): Verwalte Datenlisten spielend leicht mit den neuen Array-Blöcken.
- C++ Notausgang: Füge über spezielle Blöcke eigenen C++ Code inline oder global ein.

### 🔄 Version 1.1.0 Das Komfort- & Struktur-Update

Datum: 26.03.2026

Mehr Übersicht und ein deutlich besseres Programmiergefühl.

- Rückgängig & Wiederherstellen: Mit den neuen Buttons für Undo/Redo im Kopfmenü verzeiht der Editor ab sofort jeden Fehler.
- Mehr Übersicht: Das Hintergrund-Raster und das C++ Code-Fenster lassen sich jetzt ganz einfach per Button ein- und ausblenden.
- Blinker-Funktion & HC-SR04: Lass LEDs ohne blockierendes `delay` im Hintergrund blinken und miss Abstände mit dem Ultraschall-Sensor direkt in Zentimetern.

### 🌱 Version 1.0.0 Die Geburtsstunde von LogicKiste

Datum: 05.03.2026

Unsere Vision & Der Startschuss:

ArduBlock ist in die Jahre gekommen es ist alt, unflexibel und es ist extrem schwer, neue Blöcke für moderne Hardware zu erstellen. Die LogicKiste wurde geboren, um genau das zu ändern!

Das Ziel: Eine grafische Programmierumgebung, mit der man wirklich produktiv arbeiten kann. Schlank, flexibel, komplett werbefrei und mit einem sauberen, performanten C++ Code am Ende, der alle wichtigen Funktionen unterstützt.

Hier entsteht kein Spielzeug, sondern ein Werkzeug, mit dem jeder richtige, echte Programme für den Arduino schreiben kann, die im Alltag zuverlässig eingesetzt werden können. Mit einer riesigen Auswahl an Blöcken (von einfachen Pins bis hin zu TFT-Displays und WLAN) mache ich den Arduino R4 zum neuen Standard!

- Die erste Weboberfläche: Start des browserbasierten Editors mit Echtzeit-C++ Export.
- Basis-Ausstattung: Unterstützung für digitale/analoge Pins, Servos, Schrittmotoren, LCDs und DHT-Temperatursensoren.
- Lokales Speichern: Sichere deine Projekte als `.json`-Datei auf deinem PC und lade sie jederzeit wieder hoch.