BE-IIS Installer-Repository

Das BE-IIS Installer-Repository enthält Skripte, Overlays, Werkzeuge, Tests und Beispiele zur Einrichtung von BE-IIS HAT++ Boards auf Raspberry-Pi-Systemen.

Das Ziel ist einfach:

Manuelle Einrichtung zum Verstehen.
Installer-basierte Einrichtung für den Einsatz.

Das Repository ist offen und nachvollziehbar. Es enthält keine Marketingmedien, Bilder oder binäre Präsentationsdateien.

Es besteht hauptsächlich aus:

ASCII-Dateien
Markdown-Dokumentation
Shell-Skripten
Python-Testskripten
Device-Tree-Overlays
Build-Dateien
Konfigurationsdateien

1. Wozu dient dieses Repository?

Das Repository dient zur Einrichtung unterstützter BE-IIS HAT++ Boards unter Raspberry Pi OS.

Es unterstützt bei:

• Installation erforderlicher Kernel-Module
• Installation von Device-Tree-Overlays
• Einrichtung von udev-Regeln
• Vorbereitung eindeutiger Namen für serielle Geräte
• Konfiguration unterstützter industrieller Schnittstellen
• Test der installierten Hardware
• Bereitstellung beispielhafter Aufbauten

Der Installer soll den manuellen Einrichtungsaufwand reduzieren.

2. Repository-Struktur

Das Repository ist in klar getrennte Bereiche gegliedert:

common/
docs/
examples/
platform/
products/
scripts/
tools/

Jeder Bereich erfüllt eine eigene Aufgabe.

3. common

Das Verzeichnis common enthält gemeinsam genutzte Hilfsfunktionen.

common/lib.sh

Diese Datei wird von Installer-Skripten verwendet, um doppelten Shell-Code zu vermeiden.

4. docs

Das Verzeichnis docs enthält allgemeine Dokumentation.

Beispiel:

docs/be-iis_raspberry-pi-os-flashing-guide.md

Dieser Bereich enthält grundlegende Einrichtungsinformationen, etwa zur Vorbereitung von Raspberry Pi OS.

5. examples

Das Verzeichnis examples enthält praxisnahe Beispielaufbauten.

Ein Beispiel ist:

examples/beiis_field_switch/

Dieses Beispiel zeigt, wie sich mit BE-IIS Boards ein Feld-Switch oder Gateway aufbauen lässt.

Es enthält Hinweise für verschiedene Raspberry-Pi-Systeme und Bridge-Konfigurationen.

6. platform

Das Verzeichnis platform enthält plattformspezifische Integrationsdateien.

Für Raspberry Pi OS befindet sich darin:

platform/raspberry-pi-os/

Dieser Bereich enthält:

• Overlay-Verwaltung
• systemd-Service-Dateien
• udev-Regeln
• Hilfsskripte

Ziel ist die saubere Integration der BE-IIS HAT++ Boards in das Betriebssystem.

7. products

Das Verzeichnis products enthält die produktspezifischen Dateien.

Beispiele:

BE-IIS-HPP-T1L-REVB
BE-IIS-HPP-T1S-REVB
BE-IIS-HPP-CAN-FD-SIC-REVB
BE-IIS-HPP-MODBUS-REVB
BE-IIS-HPP-UART-REVB
BE-IIS-HPP-LAN-REVB
BE-IIS-PoSPE

Jedes Produktverzeichnis kann enthalten:

• Dokumentation
• Beispiele
• Dateien
• Overlays
• Skripte
• Tests
• udev-Informationen

Damit bleibt jedes Board klar getrennt und übersichtlich organisiert.

8. Device-Tree-Overlays

Viele BE-IIS Boards benötigen ein Raspberry-Pi-Device-Tree-Overlay.

Das Repository enthält sowohl die Quelldateien als auch die kompilierten Overlay-Dateien.

Beispielstruktur:

overlays/src/rpi/
overlays/build/rpi/

Die Quelldateien werden gespeichert als:

*.dts

Die kompilierten Overlay-Dateien werden gespeichert als:

*.dtbo

Für das HAT++-Stacking stehen mehrere Overlay-Varianten zur Verfügung.

Beispiel:

BE-IIS-HPP-T1S-I.dtbo
BE-IIS-HPP-T1S-II.dtbo
BE-IIS-HPP-T1S-III.dtbo

Dadurch können mehrere Boards an definierten Positionen eingesetzt werden.

9. scripts

Das Verzeichnis scripts enthält die zentrale Installer-Logik.

Wichtige Installer-Skripte liegen unter:

scripts/install/

Der zentrale Einstiegspunkt ist:

scripts/install/install-all.sh

Die Installationsschritte umfassen:

01_install_eepdump.sh
02_install-mods.sh
03_install-overlays.sh
04_install_hatpp_service.sh
05_install-udev-rules.sh
06_I2C_VC_ena.sh

Dadurch bleibt der Installationsablauf lesbar und gut zu analysieren.

10. tools

Das Verzeichnis tools enthält Hilfswerkzeuge für Entwicklung und Inbetriebnahme.

Dazu gehören Werkzeuge für:

• EEPROM-Verarbeitung
• Bau von ethtool
• Bau von Kernel-Modulen
• Overlay-Verwaltung

Beispiel:

tools/kernel/

Dieses Verzeichnis enthält Skripte zum Bauen benötigter Kernel-Module, beispielsweise:

adin1110_mod_build.sh
lan865x_mod_build.sh
mcp251xfd_mod_build.sh
sc16is7xx_mod_build.sh

11. Testskripte

Mehrere Produkte enthalten eigene Testskripte.

Beispiele:

test.sh
test_target1.sh
test_target2.sh
test_uart.py
beiis_uart_test.py
canperf.py

Mit diesen Skripten lässt sich prüfen, ob die installierte Hardware und die Treiber erwartungsgemäß funktionieren.

Die Tests sind nicht in einem binären Werkzeug verborgen.

Es handelt sich um einfache Skripte, die gelesen, verändert und manuell ausgeführt werden können.

12. Warum keine Bilder oder Medien?

Das Repository ist bewusst technisch ausgerichtet.

Es soll keine Produktbroschüre sein.

Es enthält hauptsächlich:

ASCII
Markdown
Shell
Python
Device-Tree-Quelltext
Makefiles
udev-Regeln
systemd-Dateien

Dadurch lässt sich das Repository mit normalen Linux-Werkzeugen einfach untersuchen.

Beispiel:

tree
grep
cat
vim
git diff

Alles soll sichtbar und nachvollziehbar bleiben.

13. Zusammenfassung

Das BE-IIS Installer-Repository bildet die technische Grundlage für die Einrichtung unterstützter BE-IIS HAT++ Boards auf Raspberry-Pi-Systemen.

Es enthält:

• Installer-Skripte
• Produktspezifische Overlays
• Hilfswerkzeuge zum Bau von Kernel-Modulen
• udev-Regeln
• systemd-Integration
• Tests
• Beispiele
• Dokumentation

Das Ziel besteht nicht darin, den Einrichtungsprozess zu verstecken.

Das Ziel ist ein reproduzierbarer Ablauf.

Für den normalen Einsatz richtet der Installer das System automatisch ein. Für Entwicklung und Fehlersuche kann jeder einzelne Schritt weiterhin manuell nachvollzogen werden.

Offen.
Nachvollziehbar.
Skriptbasiert.
Linux-freundlich.

Repository

https://github.com/be-iis/be-iis-installer