i.Cee2 Manual

igus^® smart plastics i.Cee²

Sicherheitshinweise¶

Die nachfolgenden Hinweistafeln werden im Handbuch einige Male erscheinen, sie sind klassifiziert, so dass Grad und Art einer Gefährdung markiert sind.

Qualifiziertes Personal

Das i.Sense:modul II darf nur durch qualifiziertes Fachpersonal betrieben und gewartet werden.

• Das Personal muss dieses Handbuch und ggf. existierende Zusatzdokumentationen gelesen und verstanden haben.

• Das Personal muss mit allen relevanten geltenden Normen, Bestimmungen und Unfallverhütungsvorschriften vertraut sein.

• Das Personal muss durch seine Ausbildung in der Lage sein, eventuelle Gefahren, die beim Gebrauch der Steuerung auftreten können, vorherzusehen bzw. zu erkennen.

• Das Personal muss beim Einsatz der Sensoreinheit im Gesamtsystem die Sicherheit für Personen und Gegenstände sicherstellen können.

• Das Personal muss bezüglich des Handlings von ESD empfindlichen Geräten geschult sein und alle nötigen Vorkehrungen treffen.

Einhaltung von EU‑Richtlinien

Die CE‑Kennzeichnung auf dem Gerät bestätigt die Konformität mit folgenden europäischen Richtlinien:

Die jeweils gültigen Richtlinien sind in der EU‑Konformitätserklärung des entsprechenden Geräts aufgeführt.

Hinweis zum Cyber Resilience Act (CRA)

Dieses Produkt enthält digitale Komponenten. Für solche Produkte gelten die Sicherheitsanforderungen des EU Cyber Resilience Act (Verordnung (EU) 2024/2847). Der CRA legt fest, dass Software und vernetzte Geräte über den gesamten Lebenszyklus sicher betrieben und aktuell gehalten werden müssen.

Damit Sie Ihr System zuverlässig und sicher nutzen können, beachten Sie bitte:

• Installieren Sie bereitgestellte Firmware‑ und Softwareupdates regelmäßig.
• Verwenden Sie sichere Netzwerk- und Zugangseinstellungen.
• Ändern Sie Standardpasswörter sofort nach der Inbetriebnahme.
• Deaktivieren Sie nicht benötigte Schnittstellen oder Dienste.

Wenn Sie eine technische Auffälligkeit oder eine mögliche Sicherheitslücke feststellen, melden Sie diese bitte über den offiziellen igus‑Supportkanal: security@[hersteller].com oder über das Serviceportal.

Der CRA verlangt außerdem, dass Anwender Zugang zu Informationen über Sicherheitsunterstützung, bekannte Risiken und Updateprozesse erhalten. Weitere Details finden Sie in den Dokumentationen dieses Produkts oder bei Ihrer nationalen Marktaufsichtsbehörde.

Hinweis zur EU‑Dual‑Use‑Verordnung (EU) 2021/821

Einzelne elektronische Komponenten und Sensoren in diesem Produkt können je nach technischer Ausführung unter die EU‑Dual‑Use‑Verordnung (EU) 2021/821 fallen. Diese Verordnung regelt Güter, die sowohl im zivilen als auch im militärischen Bereich eingesetzt werden können.

Für den Export in Länder außerhalb der EU kann daher eine Genehmigung erforderlich sein. Ob dies zutrifft, hängt vom Zielmarkt, der Anwendung und der jeweiligen technischen Konfiguration ab.

Bitte prüfen Sie vor einer Weitergabe oder Ausfuhr des Produktes:

• ob für Ihr Zielland Exportbeschränkungen bestehen,
• ob Ihre Anwendung als sicherheitskritisch oder militärisch gilt,
• ob eine Genehmigung nach geltenden Vorschriften notwendig ist.

Weitere Informationen finden Sie bei Ihrer nationalen Exportkontrollbehörde (z. B. BAFA in Deutschland) oder in den offiziellen EU‑Unterlagen.)

Produktübersicht¶

Betriebsarten (Übersicht)¶

• Normalbetrieb: Gerät ist gestartet, Netzwerk aktiv, Dienste können betrieben werden.
• Service/Diagnose: Statusprüfung über TFT‑Screens bzw. per SSH (systemctl).
• Provisioning: Seriennummer/Hostname/Access‑Point SSID werden in Produktion gesetzt (Script oder UI‑Workflow). Hinweis: Funktionsumfang und Default‑Netzwerkeinstellungen können je nach Image/Release (z. B. iCee2‑CORE vs. i.Cee²/ATLAS) abweichen.

Tabelle der i.Cee² Reference ID / Model Number¶

Allgemeine Beschreibung¶

i.Cee² ist ein Single Board Computer, der Sensoren und Assets verbindet, Control Logic ausführt und ohne Plattformänderungen in die Produktion überführt.
Entwickelt für industrielle Teams, die einen verlässlichen Weg von Experimenten zu Operations benötigen.

Schlüsselmerkmale¶

Prozessor: * Raspberry Pi CM4 (Quad-Core Cortex-A72)

I/O: * 12 DO (Digitale Ausgänge) * 6 KI (analoge Eingänge) * 2 Staffeln

Industriebus: * RS-485 * CAN * 2× Ethernet-Port (unabhängig verwaltet)

Kommunikation: * Integriertes LTE * WLAN * BLE * USB

Schnittstelle & Dienste: * 1,47" IPS TFT-Display + Joystick für lokales Setup und Feedback. * Enthält 1 GB Daten (bis zu 500 MB LTE + 500 MB DB storage) über sensblue.cloud — keine externe SIM erforderlich. * EU-gehostete Server, TLS, wöchentliche Backups, VPN auf Anfrage. * Weitere Versionen auf Anfrage.

Hardware-Spezifikationen¶

Stromversorgung¶

Digitale Eingänge¶

Digitale Ausgänge (Relais)¶

Digitale Ausgänge (Transistor/SSR)¶

Analoge Eingänge¶

Analoge Ausgänge¶

Elektrische Spezifikationen (Kurzüberblick)¶

• Versorgung: 12–24 VDC (±5 %)
• Leistungsaufnahme: typisch < 15 W, max. 25 W (alle Peripheriegeräte aktiv)
• Digitale Eingänge: 4 Kanäle, 0–24 VDC, optional „fast inputs“ bis 100 Hz (je nach Konfiguration)
• Digitale Ausgänge: 2× Relais + 8× Transistor/SSR (PNP/Quelle)
• Analoge Eingänge: 4 Kanäle, 0–10 V oder 0/4–20 mA (pro Kanal konfigurierbar)
• Analoge Ausgänge: 2 Kanäle, 0–20 mA (optional 4–20 mA)

Umgebungsbedingungen¶

Schutzart / Montage - Schutzart: IP20
- Montage: DIN‑Schiene (EN 60715)

Kommunikationsschnittstellen¶

Ethernet¶

RS-485¶

USB¶

HDMI¶

RF-Kommunikation¶

Lokale Peripheriegeräte¶

HDMI¶

1 Anzeige¶

2 Joystick¶

Mechanisch¶

Anbindung¶

Expansion¶

Mechanische Zeichnungen¶

Frontansicht¶

Bodenansicht¶

Draufsicht¶

Systemtyp¶

Raspian Debian GNU/Linux 13 (trixie) Version 13.2 Linux atlas 6.12.47 +rpt-rpi-v8 #1 SMP PREEMPT Debian 1 :6.12.47-1 +rpt1 (2025-09-16) aarch64 GNU/Linux.

Netzwerkinformationen¶

Es gibt drei Möglichkeiten, eine Verbindung zum Gerät herzustellen. IP und Status der Verbindung können auf dem LCD Network Interface geprüft werden.

Eth1 (ethO)¶

Client dynamic IP wird vom DHCP server bezogen.

Eth2 (eth1)¶

Statische IP: 93.48.86.253

Zugangspunkt (wlanO)¶

IP: 192.168.30.1

Installation¶

Allgemeine Hinweise¶

1. Gerät auf DIN‑Schiene montieren und fachgerecht versorgen (12–24 VDC).
2. Nach dem Einschalten Boot abwarten; Netzwerkdaten können je nach Release auf dem TFT‑Network‑Screen angezeigt werden.
3. Für Erstzugriff eine der folgenden Verbindungen nutzen:
4. ETH1 (DHCP)
5. WLAN‑Access‑Point (SSID/Passwort abhängig von Seriennummer/Release)
6. ETH2 / Service‑Port (falls im Release aktiv, i. d. R. privates Subnetz)

Mechanische Installation¶

• Montage auf DIN‑Schiene (EN 60715)
• Schutzart IP20 (Einbau in geeigneten Schaltschrank/Umgebung)
• Mechanische Zeichnungen (Front/Boden/Draufsicht) siehe Kapitel „Technische Daten“

Elektrische Installation¶

• Versorgung an 12–24 VDC (±5 %) anschließen.
• Leitungen so verlegen, dass keine Zug-/Quetschbelastung entsteht.
• I/O‑Verdrahtung gemäß den technischen Spezifikationen und der projektspezifischen Auslegung ausführen. Hinweis: Detail‑Klemmen-/Pinbelegung ist in den bereitgestellten Informationen noch nicht vollständig enthalten und sollte ergänzt werden (Klemmenplan/Pinout).

Sensoren¶

Schnittstellen / Peripherie (Übersicht)¶

Ethernet / WLAN¶

• ETH1: DHCP‑Client (Standardzugang)
• WLAN‑AP: SSID typischerweise iCee2-<SERIAL_NUMBER>-AP (Passwort je Release)
• ETH2 / Service‑Port (releaseabhängig): privates Subnetz (z. B. 192.168.50.0/24 genannt)

RS‑485 (releaseabhängig)¶

• RS‑485 Serial Driver Interface verfügbar auf tty/AMA2 (iCee2‑CORE Release)

USB¶

• 2× USB‑Host (Test per SSH möglich: usb-devices)

CAN / CANopen (ATLAS)¶

• CAN‑Controller: MCP2518FD (SPI)
• Encoder‑Referenz: RM8007 (CANopen)
• Messrate (Referenz): ca. 500 Messungen/s (Abschätzung aus Bus-Zyklus)

Hinweis: Konkrete Anschlusspläne/Pinouts für RS‑485/CAN/USB sind in den gelieferten Infos nur teilweise enthalten (z. B. Softwarebeispiele), sollten aber für ein vollständiges Hardwaremanual ergänzt werden.

Software¶

Softwareinformationen¶

MQTT-Makler¶

Hafen: 1883

Adresse: AP-> 192.168.30.1

Eth1: 93.48.86.253

Benutzer: < nicht nötig>

Login

Relais gibt Akteur aus¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Zugangsdaten.

Einstellung/Zurücksetzen des digitalen Ausgangspins/Pin-Status¶

Beide Relais default Status ist offen.

Frage-Thema: relayOutputs/config/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "D01": {
        "state": "open"
      },
      "D02": {
        "state": "open"
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "D01": {
        "success": true,
        "state": "open"
      },
      "D02": {
        "success": true,
        "state": "open"
      }
    }
  }
}

Alle Relais aktivieren¶

Anforderungsthema: relayOutputs/runtime/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "READ"
  }
}

Reply-Topic: relayOutputs/runtime/out

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "D01": {
        "success": true,
        "state": "open"
      },
      "D02": {
        "success": true,
        "state": "close"
      }
    }
  }
}

Setze den Zustand aller Relais¶

Anforderungsthema: relayOutputs/runtime/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "SET",
    "taskParams": {
      "D01": {
        "state": "open"
      },
      "D02": {
        "state": "close"
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "D01": {
        "success": true,
        "state": "open"
      },
      "D02": {
        "success": true,
        "state": "close"
      }
    }
  }
}

RTC-Schauspieler¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Vertrauensbeweis.

Timer/Weckerunterbrechung stellen¶

Modus: Timer, Alarm oder nicht.

alarmSet: Datum und Uhrzeit für Alarmunterbrechung (Keine Auswirkung, ob der Modus Timer ist oder nicht).

timerSetSeconds: Periode in Sekunden für Timer-Unterbrechung (kein Effekt, ob der Modus Alarm ist oder nicht).

Wunsch-Thema: Takt/Konfiguration/Einstellung

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "CLOCK\_SET\_MODE": {
        "mode": "timer",
        "alarmSet": "\[timestamp epoch ms\]",
        "timerSetSeconds": "<INT>"
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "success": true,
      "CLOCK\_SET\_MODE": {
        "mode": "timer",
        "alarmSet": "\[timestamp epoch ms\]",
        "timerSetSeconds": "<INT>"
      }
    }
  }
}

RTC-Synchronisationslogik umschalten (unten beschrieben)¶

tcState: Zustand der Synchronisationslogik des RTC, dieser Wert ist nicht persistent, sodass bei jedem Neustart der Wert auf den Standard zurückkehrt (standardmäßig ist der Wert AN)

Wunsch-Thema: Takt/Konfiguration/Einstellung

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "TOGGLE"
  }
}

Req-Topic: clock/config/out

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "success": true,
      "rtcState": "OFF"
    }
  }
}

Read-Takt-Konfigurationen¶

Modus: Timer, Alarm oder nicht.

alarmSet: Datum und Uhrzeit für Alarmunterbrechung (Keine Auswirkung, ob der Modus Timer ist oder nicht).

timerSetSeconds: Periode in Sekunden für Timer-Unterbrechung (kein Effekt, ob der Modus Alarm ist oder nicht).

rtcState: Aktueller Zustand der Synchronisationslogik des RTC.

Wunsch-Thema: Takt/Konfiguration/Einstellung

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "READ"
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "success": true,
      "CLOCK\_CONFIGS": {
        "mode": "timer",
        "alarmSet": "\[timestamp epoch ms\]",
        "timerSetSeconds": "<INT>",
        "rtcState": "ON"
      }
    }
  }
}

Lese-Uhr¶

Bedarf-Thema: Uhr/Laufzeit/In-Phase

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "success": true,
      "timestamp": "\[timestamp epoch ms\]"
    }
  }
}

Synchronisationsschleifen-Flussdiagramm (alle 30 Sekunden)¶

RTC Actor – Überblick

Kernsystem-Gesundheitsakteur¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen.

Diese Schnittstelle ermöglicht es jeder externen App, Systemmetriken wie CPU-Last, RAM-Auslastung, Festplattenauslastung, Temperatur, Kernfrequenz, System-Drosselstatus und Verfügbarkeit zu empfangen. Für das Abonnement dieses Themas sind keine Qualifikationen erforderlich. Der System Health Actor erhält keine Befehle. Es ist vollkommen autonom und veröffentlicht seine Kennzahlen alle 1 Sekunde.

Laufzeitdaten¶

Thema: SystemHea l th/Laufzeit/ aus

Veröffentlichungsrate: 1 Hz (eine Nachricht pro Sekunde, Clock-Jump sicher)

bereitgestellte Kennzahlen¶

Beispiel Payload (systemHealth/runtime/out)

{ "id": 1736022028123, "Ursprung": "System-Gesundheit", "Aufgabe": { "taskResult": { "cpu_percent": 7,1, "cpu_tempC": 47,3, "cpu0_freq": 15000000000, "cpu1_freq": 15000000000, "cpu2_freq": 15000000000, "cpu3_freq": 1500000000, "cpu0_throttle": "0x0", "Ram_percent": 32,9, "disk_percent\": 41.2, "Uptime_sec": 5321 } } }

Gesundheit der peripheren Geräte¶

Um die Gesundheit der Peripheriegeräte zu erhalten, mussten wir in jedem Busmanager einen SystemHealth-Akteur implementieren (busi2cO, busi2c-1 usw.).

Beispiel¶

Für busi2c-0:

Antwortthema: systemHealth/busi2c-0/runtime/out

Nutzlast:

{
  "id": 1770378753024,
  "origin": "system-health-busi2c-0",
  "task": {
    "taskResult": {
      "ADC": {
        "status": "ERROR",
        "description": "IRQ Retrying",
        "last\_report": 1770378753006,
        "stats": {
          "AI1": {
            "samples": 563154,
            "retries": 760548,
            "discards": 253313
          },
          "AI2": {
            "samples": 563154,
            "retries": 760475,
            "discards": 253314
          },
          "AI3": {
            "samples": 563154,
            "retries": 760528,
            "discards": 253313
          },
          "AI4": {
            "samples": 563154,
            "retries": 760549,
            "discards": 253312
          }
        }
      },
      "DAC": {
        "status": "OK",
        "description": "Running....",
        "last\_report": 1770378752576,
        "stats": {
          "AO1": {
            "samples": 240755,
            "retries": 0,
            "discards": 0
          },
          "AO2": {
            "samples": 240755,
            "retries": 0,
            "discards": 0
          }
        }
      },
      "RTC": {
        "status": "OK",
        "description": "",
        "last\_report": 1770378752094,
        "stats": {
          "samples": 248710,
          "retries": 0,
          "discards": 0
        }
      },
      "TEMP": {
        "status": "OK",
        "description": "",
        "last\_report": 1770378752579,
        "stats": {
          "samples": 240754,
          "retries": 0,
          "discards": 0
        }
      }
    }
  }
}

Antwortthema: systemHealth/busi2c-1/runtime/out

Nutzlast:

{
  "id": 1770382405107,
  "origin": "system-health-busi2c-1",
  "task": {
    "taskResult": {
      "JOYSTICK": {
        "status": "OK",
        "description": "Running....",
        "last\_report": 1770382405050,
        "stats": {
          "read\_all": {
            "samples": 410154,
            "retries": 0,
            "discards": 0
          },
          "read\_raw": {
            "samples": 0,
            "retries": 0,
            "discards": 0
          },
          "buttons": {
            "JDOWN": {
              "reads": 410154,
              "last\_state": "pressed"
            },
            "JRIGHT": {
              "reads": 410154,
              "last\_state": "pressed"
            },
            "JUP": {
              "reads": 410154,
              "last\_state": "pressed"
            },
            "JLEFT": {
              "reads": 410154,
              "last\_state": "pressed"
            },
            "JCENTER": {
              "reads": 410154,
              "last\_state": "pressed"
            }
          }
        }
      },
      "RELAYS": {
        "status": "OK",
        "description": "Relay Output MQTT connected",
        "last\_report": 1770298859099,
        "stats": {
          "read\_all": {
            "samples": 0,
            "retries": 0,
            "discards": 0
          },
          "set": {
            "samples": 0,
            "retries": 0,
            "discards": 0
          },
          "set\_many": {
            "samples": 0,
            "retries": 0,
            "discards": 0
          },
          "raw\_read\_all": {
            "samples": 0,
            "retries": 0,
            "discards": 0
          }
        },
        "outputs": {
          "DO1": {
            "writes": 0,
            "last\_state": "unknown"
          },
          "DO2": {
            "writes": 0,
            "last\_state": "unknown"
          }
        }
      },
      "DI": {
        "status": "OK",
        "description": "Running",
        "last\_report": 1770382404832,
        "stats": {
          "read\_all": {
            "samples": 181758,
            "retries": 0,
            "discards": 0
          },
          "read\_raw": {
            "samples": 0,
            "retries": 0,
            "discards": 0
          },
          "inputs": {
            "DI1": {
              "reads": 181758,
              "last\_state": "low"
            },
            "DI2": {
              "reads": 181758,
              "last\_state": "low"
            },
            "DI3": {
              "reads": 181758,
              "last\_state": "low"
            },
            "DI4": {
              "reads": 181758,
              "last\_state": "low"
            }
          }
        }
      }
    }
  }
}

TempSensor-Akteur¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Vertrauensbeweis.

Einstellungen der Temperatursensoren¶

Erforderlich-Thema: tempSensor/config/in

ALARM:

• aktivieren: wahr(aktiv)/falsch
• Temperatur: Alarmtemperatur untere Grenze
• TemperaturHöchst: Alarmtemperatur Obergrenze

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskParams": {
        "ALERT": {
          "activate": true,
          "tempLow": 0,
          "tempHigh": 80
        }
      }
    }
  }
  

  Antwort-Thema: tempSensor/konfiguration/out

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskResult": {
        "success": true,
        "ALERT": {
          "activate": true,
          "tempLow": 0,
          "tempHigh": 80
        }
      }
    }
  }
  

Temperatursensorkonfigurationen lesen¶

Erforderlich-Thema: tempSensor/config/in

ALARM:

• aktivieren: wahr(aktiv)/falsch

GRENZEN:

• Temperatur: Alarmtemperatur untere Grenze
• TemperaturHöchst: Alarmtemperatur Obergrenze

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "action": "READ"
    }
  }
  

  Antwort-Thema: tempSensor/konfiguration/out

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskResult": {
        "success": true,
        "ALERT": {
          "activate": true,
          "tempLow": 0,
          "tempHigh": 80
        }
      }
    }
  }
  

Temperatur und Alarmstatus anzeigen¶

• Einheit: Temperaturmaßeinheit
• Warnung: wahr (ausgelöst) oder falsch

Erforderliches Thema: tempSensor/Laufzeit/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "READ"
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "success": true,
      "data": {
        "temperature": <\_FLOAT\_>,
        "unit": "C",
        "alert": true
      }
    }
  }
}

TFT-Schauspieler¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Benutzeroberfläche zur Steuerung und Interaktion mit dem TFT-Display oder dem LCD-Frontpanel. Die Verbindung zum Makler für dieses Gebiet erfordert keine Zugangsdaten.

TFT-Anzeige-Akteur¶

Der TFT-Akteur ist verantwortlich für:

• Rendering statischer und informativer Bildschirme auf der TFT-Anzeige
• Reagenz auf Joystick-Eingabe (LINKS/ RECHTS/ ZENTRIERT/ HOCH/ RUNTER)
• Verwaltung der Bildschirmnavigation und der Benutzerbestätigungsflüsse
• Feedback an die Anwendung über MQTT geben

Screen-Karussell-Konzept¶

Der TFT-Schauspieler führt eine geordnete Liste von Bildschirmen (Karussell).

• Die Bildschirme werden mit dem Joystick navigiert:

- LINKS --> Vorheriger Bildschirm

- RICHTIG --> Nächster Bildschirm

• Das Karussell wickelt sich um:

- LINKS auf dem ersten Bildschirm --> letzter Bildschirm

- GENAU auf dem letzten Bildschirm --> ersten Bildschirm

Bildschirmtypen¶

Der TFT-Akteur unterstützt folgende Bildschirmtypen:

a.) Bildbildschirm

• Zeigt ein statisches JPEG-Bild an
• Standardbildschirm wird beim Start angezeigt
• Keine Benutzerinteraktion erforderlich

b.) Netzwerkinformationsbildschirm

• Anzeige einer Schnittstelle mit Informationen über die Netzwerke des Geräts
• Aktualisiert beim Laden
• Keine Benutzerinteraktion erforderlich

Joystick-Navigationslogik¶

Karussellnavigation:

Bootverhalten¶

Beim Systemboot:

1. Der TFT-Aktor initialisiert die Anzeige
2. Das zuletzt verfügbare Karussell ist geladen
3. Der erste Bildschirm wird gerendert
4. Joystick-Abonnements werden aktiviert
5. Der Actor wartet auf Laufzeitbefehle

Designhinweise und Einschränkungen¶

• TFT-Akteur zeigt den Joystick-Zustand nicht frei
• Joystick-Schauspieler bleibt unabhängig
• TFT-Akteur konsumiert intern Joystick-Ereignisse
• Carousel State ist lokal für den TFT-Akteur
• Das Screenrendering erfolgt synchron; Die Eingangsbehandlung erfolgt asynchron
• Bestätigungsbildschirme erfordern immer expliziten CENTER-Druck

Interaktion über MQTT¶

Ermöglichung der Interaktion mit dem Karussell über das Thema tft/runtime/in . Verfügbare Aktionen sind für den Nutzer öffentlich.

Laufzeitbefehle

Geh auf den Bildschirm

Erforderliches Thema: tft/runtime/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "SET\_CAROUSEL",
    "params": {
      "index": 2
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "tft",
  "task": {
    "taskResult": {
      "success": true,
      "index": 2
    }
  }
}

{
  "id": "TIMESTAMP",
  "origin": "APP",
  "task": {
    "action": "SET\_CAROUSEL",
    "params": {
      "startIndex": 0,
      "screens": \[
        {
          "type": "image",
          "image": "default.jpg"
        },
        {
          "type": "image",
          "image": "status.jpg"
        },
        {
          "type": "confirm",
          "question": "Do you want to continue?"
        }
      \]
    }
  }
}

Antwort

Antwortthema: tft/runtime/out

{
  "id": "TIMESTAMP",
  "origin": "tft",
  "task": {
    "taskResult": {
      "success": true,
      "activeIndex": 0,
      "totalScreens": 3
    }
  }
}

Analoglnputs Actor¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Vertrauensbeweis.

Konfigurationen¶

Thema: analoglnputs/konfiguration/in – ADC-Kanalkonfigurationen einstellen

Modus

• kontinuierlich
• Single

typ

• Spannung
• aktuell

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskParams": {
        "AI1": {
          "mode": "single",
          "type": "voltage"
        },
        "AI2": {
          "mode": "single",
          "type": "voltage"
        },
        "AI3": {
          "mode": "single",
          "type": "current"
        },
        "AI4": {
          "mode": "single",
          "type": "current"
        }
      }
    }
  }
  

  Antwort-Thema: analoglnputs/config/out

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskResult": {
        "AI1": {
          "success": true
        },
        "AI2": {
          "success": true
        },
        "AI3": {
          "success": true
        },
        "AI4": {
          "success": true
        }
      }
    }
  }
  

Laufzeitdaten¶

Thema: analoge Eingaben/Laufzeit/In.

Aktion:

• LESEN
• PAUSE (nur im kontinuierlichen Modus anwendbar)
• RESUME (nur im kontinuierlichen Modus anwendbar)

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskParams": {
        "AI1": {
          "action": "READ"
        },
        "AI2": {
          "action": "READ"
        },
        "AI3": {
          "action": "READ"
        },
        "AI4": {
          "action": "READ"
        }
      }
    }
  }
  

  Antwort-Thema: analoge Einsätze/Laufzeit/Aus

  {
    "id": "<TIMESTAMP>",
    "origin": "APP",
    "task": {
      "taskResult": {
        "AI1": {
          "success": true,
          "value": <\_FLOAT\_>
        },
        "AI2": {
          "success": true,
          "value": <\_FLOAT\_>
        },
        "AI3": {
          "success": true,
          "value": <\_FLOAT\_>
        },
        "AI4": {
          "success": true,
          "value": <\_FLOAT\_>
        }
      }
    }
  }
  

Analoger Ausgangsakteur¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Vertrauensbeweis.

Analogausgangssignal einstellen¶

Wunsch-Thema: analogOutputs/config/in

Ausgang: Strom innerhalb von 0–20 mA

Modus: Ein/Aus

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "mode": "on",
      "AO1": {
        "current": <\_FLOAT\_>
      },
      "AO2": {
        "current": <\_FLOAT\_>
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "mode": "on",
      "AO1": {
        "success": true,
        "current": <\_FLOAT\_>
      },
      "AO2": {
        "success": true,
        "current": <\_FLOAT\_>
      }
    }
  }
}

Analoge Ausgänge einstellen¶

Erfordernis-Thema: analogAusgaben/Laufzeit/in

Strom: Strom innerhalb von 0-20 mA

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "AO1": {
        "action": "SET",
        "current": <\_FLOAT\_>
      },
      "AO2": {
        "action": "SET",
        "current": <\_FLOAT\_>
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "AO1": {
        "success": true,
        "current": <\_FLOAT\_>
      },
      "AO2": {
        "success": true,
        "current": <\_FLOAT\_>
      }
    }
  }
}

Analogausgänge-Einstellungen lesen¶

Erfordernis-Thema: analogAusgaben/Laufzeit/in

Strom: Strom innerhalb von 0–20 mA

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "AO1": {
        "action": "READ"
      },
      "AO2": {
        "action": "READ"
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "AO1": {
        "success": true,
        "current": <\_FLOAT\_>
      },
      "AO2": {
        "success": true,
        "current": <\_FLOAT\_>
      }
    }
  }
}

Digital Input Actor¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Zugangsdaten.

Stelle die Geschwindigkeit der digitalen Eingabepins/Pins schnell/langsam ein¶

Die schnelle Geschwindigkeitseinstellung unterstützt Kantenerkennung bis zu 100 Hz und die langsame Geschwindigkeitseinstellung bis zu 10 Hz.

Der Schnellmodus erzeugt bei jeder Änderung des I/O-Zustands eine Nachricht, was während des Betriebs zu einer hohen Nachrichtennutzlast führen kann. Der Schnellmodus sollte daher nur aktiviert werden, wenn unbedingt erforderlich ist.

Voraussetzungsthema: digitallnputs/config/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "DI1": {
        "speed": "fast"
      },
      "DI2": {
        "speed": "slow"
      },
      "DI3": {
        "speed": "fast"
      },
      "DI4": {
        "speed": "fast"
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "DI1": {
        "success": true,
        "speed": "fast"
      },
      "DI2": {
        "success": true,
        "speed": "slow"
      },
      "DI3": {
        "success": true,
        "speed": "fast"
      },
      "DI4": {
        "success": true,
        "speed": "fast"
      }
    }
  }
}

Erhalte den Zustand aller digitalen Eingabepins.¶

Wunsch-Thema: digitale Eingaben/Laufzeit/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "READ"
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "DI1": {
        "success": true,
        "state": "high"
      },
      "DI2": {
        "success": true,
        "state": "low"
      },
      "DI3": {
        "success": true,
        "state": "high"
      },
      "DI4": {
        "success": true,
        "state": "low"
      }
    }
  }
}

Digitaler Ausgangsakteur¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Glaubenserklärungen.

Erhalten Sie den Zustand aller digitalen Ausgangspins¶

Anforderungsthema: digitalOutputs/Runtime/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "READ"
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "DO1": {
        "success": true,
        "state": "low"
      },
      "DO2": {
        "success": true,
        "state": "high"
      },
      "DO3": {
        "success": true,
        "state": "high"
      },
      "DO4": {
        "success": true,
        "state": "low"
      },
      "DO5": {
        "success": true,
        "state": "low"
      },
      "DO6": {
        "success": true,
        "state": "low"
      },
      "DO7": {
        "success": true,
        "state": "low"
      },
      "DO8": {
        "success": true,
        "state": "low"
      }
    }
  }
}

Setze den Zustand aller digitalen Ausgangspins¶

Anforderungsthema: digitalOutputs/Runtime/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskParams": {
      "DO1": {
        "action": "SET",
        "state": "low"
      },
      "DO2": {
        "action": "SET",
        "state": "high"
      },
      "DO3": {
        "action": "SET",
        "state": "high"
      },
      "DO4": {
        "action": "SET",
        "state": "low"
      },
      "DO5": {
        "action": "SET",
        "state": "low"
      },
      "DO6": {
        "action": "SET",
        "state": "low"
      },
      "DO7": {
        "action": "SET",
        "state": "low"
      },
      "DO8": {
        "action": "SET",
        "state": "low"
      }
    }
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "D01": {
        "success": true,
        "state": "low"
      },
      "D02": {
        "success": true,
        "state": "high"
      },
      "D03": {
        "success": true,
        "state": "high"
      },
      "D04": {
        "success": true,
        "state": "high"
      },
      "D05": {
        "success": true,
        "state": "high"
      },
      "D06": {
        "success": true,
        "state": "low"
      },
      "D07": {
        "success": true,
        "state": "low"
      },
      "D08": {
        "success": true,
        "state": "low"
      }
    }
  }
}

Anmerkungen¶

Wenn der Busi2c-3 nicht mit Strom versorgt ist, erhalten wir Folgendes:

Thema: Ziffer a lAusgaben/Laufzeit/aus

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "DO1": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO2": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO3": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO4": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO5": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO6": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO7": {
        "success": false,
        "state": "DO\_not\_powered"
      },
      "DO8": {
        "success": false,
        "state": "DO\_not\_powered"
      }
    }
  }
}

Joystick-Schauspieler¶

App-Schnittstelle¶

Benutzer-App-Oberfläche und Funktionalitäten, die dem offenen Teil des MQTT-Brokers zur Verfügung stehen. Vereinfachte Schnittstelle zur Konfiguration und zum Erhalt von Peripheriedaten. Die Verbindung zum Makler für dieses Gebiet erfordert keine Vertrauensbeweis.

Alle Joystick-Pins in den Zustand bringen¶

Req-Topic: joystick/runtime/in

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "action": "READ"
  }
}

{
  "id": "<TIMESTAMP>",
  "origin": "APP",
  "task": {
    "taskResult": {
      "JLEFT": {
        "success": true,
        "state": "pressed"
      },
      "JRIGHT": {
        "success": true,
        "state": "released"
      },
      "JUP": {
        "success": true,
        "state": "released"
      },
      "JDOWN": {
        "success": true,
        "state": "released"
      },
      "JCENTER": {
        "success": true,
        "state": "released"
      }
    }
  }
}

Enthaltener Software-Stack¶

Hardware-Bibliotheken¶

[BILD-PLATZHALTER]

Verwandte Produkte¶

Zubehör¶

Dokumentengeschichte¶

i.Cee² im Feld¶

[BILD-PLATZHALTER]

Problembehandlung¶

Typische Probleme¶

Kein Zugriff auf Weboberflächen - Netzwerk prüfen (ETH1 DHCP / WLAN‑AP / Service‑Port) - IP‑Adresse über TFT‑Network‑Screen oder Router ermitteln

Dienste laufen nicht (Status) - Per SSH prüfen: - systemctl is-active nodered - systemctl is-active grafana-server - systemctl is-active openvpn - systemctl is-active mender-updated

USB‑Geräte werden nicht erkannt - Per SSH prüfen: usb-devices - Test an beiden USB‑Ports durchführen

FAQS¶

• Wie finde ich die IP-Adresse des Geräts?
  Über den TFT‑Network‑Screen oder über den DHCP‑Server/Router.

• Wie prüfe ich, ob die Grunddienste laufen?
  Über TFT‑Statusscreen (falls vorhanden) oder per SSH mit systemctl is-active ....

• Wie wird Seriennummer/Hostname/Access‑Point gesetzt?
  Über Produktions‑Script setup-hostname-wlan-ap.sh <SERIAL_NUMBER> oder (releaseabhängig) über eine UI‑Maske mit PIN und anschließendem Reboot.

Zubehör¶

Zubehör / Optionen (releaseabhängig)¶

• SSD‑Piggyback (NVMe) zur Speichererweiterung
• LTE‑Modem (integriert, je nach Variante/Release)
• Externe Antennen (SMA/RP‑SMA, je nach Funkvariante)

Abkürzung¶

• AP: Access Point
• DI/DO: Digitale Eingänge/Ausgänge
• AI/AO: Analoge Eingänge/Ausgänge
• RTC: Real Time Clock
• OTA: Over‑the‑Air Update

Begriffserklärung¶

• Service‑Port (ETH2): dediziertes, privates Netzwerkinterface (releaseabhängig) zur Wartung/Service.
• Piggyback: Zusatzmodul/Erweiterungsplatine (z. B. SSD oder Acquisition‑Board).

Hinweis: Schaltpläne/Klemmenpläne sind in den bereitgestellten Informationen nicht enthalten und müssen projektspezifisch ergänzt werden.

Service / Wartung¶

Für Supportfälle bitte bereithalten: - Geräte‑Seriennummer / Hostname - Release/Version (TFT‑Versionsscreen, falls vorhanden) - kurze Fehlerbeschreibung + Foto/Screenshot des Statusscreens - (falls verfügbar) Auszug relevanter systemctl‑Checks

Dokumentationslinks (intern): - Production Procedures / Production manual - HW libraries MQTT API - Image Repository (SharePoint)

Service¶

Kundenservice

de-smartplastics-service@igus.net
+49 (0) 2203 9649 9806

Technischer Support für igus^® smart plastics

Dokumentation/FW

https://www.igus.de/info/i-sense-modul-2

Download von Handbüchern, FW Updates und Zertifikaten

Webseite smart Plastics

https://www.igus.de/info/vorausschauende-wartung-smart-plastics

Bestellmöglichkeit von Sensoren, verarbeitenden Einheiten und weiterem Zubehör

Kontakt

www.igus.de

info@igus.de

+49 (0) 2203-9649-0F

Impressum

© 2026

Alle Rechte bei

igus^® SE & Co. KG

Spicher Str. 1a

51147 Köln