129 lines
4.7 KiB
Markdown
129 lines
4.7 KiB
Markdown
# sps_skel
|
|
|
|
> Das Programm erhält ein mechanisches Layout von der Projektierung oder dem
|
|
> Angebotswesen zusammen mit dem elektrischen Layout (Liste aller Sensoren,
|
|
> Stopper, Weichen, etc.). Daraus soll es ein Skelett für die SPS-Programmierung
|
|
> (Siemens SCL, TIA Portal) erzeugen — aufgebaut aus **TRO**-Bausteinen
|
|
> (Transfer Route Object), den wiederkehrenden Steuerungseinheiten einer
|
|
> Fördertechnik-Anlage.
|
|
|
|
## Stand des Projekts
|
|
|
|
Der eigentliche SCL-Generator (JSON-Layout → TIA-Portal-Code) ist **noch nicht
|
|
geschrieben**. Was bereits funktioniert, ist die Ableitung der Vorstufen dazu:
|
|
aus einem CSV-Export der mechanischen Planung (ILS 2.0) werden automatisch
|
|
|
|
- der **Materialfluss-Graph** der mechanischen Objekte (Strecken, Gefällestrecken,
|
|
Kreisel),
|
|
- die daraus abgeleitete **TRO-Liste** samt eigenem Flussdiagramm, und
|
|
- eine **annotierte Kopie der BricsCAD-Zeichnung** mit einem Marker-Symbol pro
|
|
TRO
|
|
|
|
erzeugt. Diese drei Werkzeuge liegen als CLI-Tools in `lib/` und sind über
|
|
`bin/`-Wrapper aufrufbar (siehe unten). Details, Domänenmodell und die
|
|
Roadmap zum Generator stehen in `doc/`, allen voran `doc/Python_Scripts.md`.
|
|
|
|
## Projektstruktur
|
|
|
|
sps_skel/
|
|
bin/ Umgebungsskripte + ein .bat/.sh-Wrapper-Paar je CLI-Tool
|
|
setenv.bat/.sh Umgebungsvariablen setzen
|
|
install_py.bat/.sh venv erstellen + pip install
|
|
activate_venv.bat/.sh venv aktivieren
|
|
get_cmd.bat/.sh Shell mit Umgebung oeffnen
|
|
material_flow.bat/.sh Wrapper fuer lib/material_flow.py
|
|
tro_flow.bat/.sh Wrapper fuer lib/tro_flow.py
|
|
tro_annotate.bat/.sh Wrapper fuer lib/tro_annotate.py
|
|
cad/ generiertes BricsCAD-LISP (tro_types.lsp) fuer den TROEDIT-Dialog
|
|
cfg/ Konfigurationsdateien (INI/JSON); dxf_registration.json
|
|
data/ Eingabedaten - CSV-Exporte, DXF (nicht im Git)
|
|
doc/ Dokumentation, siehe doc/Python_Scripts.md
|
|
examples/ Beispieldateien
|
|
lib/ Python-Quellcode (CLI-Tools + Bibliotheken)
|
|
log/ Log-Dateien (nicht im Git)
|
|
results/ Ergebnisse der CLI-Tools (.dot/.svg/.md/.dxf, nicht im Git)
|
|
tests/ Unit Tests
|
|
.gitignore
|
|
LICENSE
|
|
README.md
|
|
requirements.txt
|
|
|
|
## Umgebungsvariablen
|
|
|
|
| Variable | Beschreibung |
|
|
|----------------|---------------------------|
|
|
| `SPS_SKEL` | Wurzelverzeichnis |
|
|
| `SKEL_BIN` | Skriptverzeichnis |
|
|
| `SKEL_LIB` | Python-Quellcode |
|
|
| `SKEL_CFG` | Konfigurationsdateien |
|
|
| `SKEL_DATA` | Eingabedaten |
|
|
| `SKEL_DOC` | Dokumentation |
|
|
| `SKEL_LOG` | Log-Dateien |
|
|
| `SKEL_RESULTS` | Ergebnisse |
|
|
| `SKEL_EXAMPLES` | Beispieldateien |
|
|
| `SKEL_TESTS` | Unit Tests |
|
|
| `PYTHONPATH` | Erweitert um `SKEL_LIB` |
|
|
|
|
## Installation
|
|
|
|
### Voraussetzungen
|
|
|
|
- Python 3.10 oder hoeher
|
|
- Graphviz (`dot`) auf `PATH` fuer `--tosvg`, optional aber empfohlen
|
|
- fuer `tro_annotate.py`: `ezdxf` (wird per `requirements.txt` installiert)
|
|
|
|
### Setup (Windows)
|
|
|
|
bin\install_py.bat
|
|
|
|
### Setup (Linux / macOS)
|
|
|
|
bash bin/install_py.sh
|
|
|
|
## Nutzung
|
|
|
|
### Umgebung setzen
|
|
|
|
bin\setenv.bat # Windows
|
|
source bin/setenv.sh # Linux / macOS
|
|
|
|
### Shell mit gesetzten Variablen oeffnen
|
|
|
|
bin\get_cmd.bat # Windows
|
|
source bin/get_cmd.sh # Linux / macOS
|
|
|
|
### venv aktivieren
|
|
|
|
bin\activate_venv.bat # Windows
|
|
source bin/activate_venv.sh # Linux / macOS
|
|
|
|
### CLI-Tools ausführen
|
|
|
|
Jedes Tool wird über seinen `bin/<name>.bat`/`.sh`-Wrapper aufgerufen; dieser
|
|
setzt die Umgebung, aktiviert `.venv` und ruft dann das Python-Modul auf.
|
|
`--file`/`--dxf` akzeptieren entweder einen Dateinamen (wird gegen
|
|
`%SKEL_DATA%` aufgelöst) oder einen vollen Pfad; Ausgaben landen in
|
|
`%SKEL_RESULTS%`.
|
|
|
|
REM 1) Materialfluss der mechanischen Objekte
|
|
bin\material_flow.bat --file mubea.csv --tosvg --doc
|
|
|
|
REM 2) TRO-Liste + eigenes Flussdiagramm ableiten
|
|
bin\tro_flow.bat --file mubea.csv --tosvg --doc
|
|
|
|
REM 3) TROs als Marker-Symbole in eine Kopie der CAD-Zeichnung einbrennen
|
|
bin\tro_annotate.bat --file mubea.csv --dxf 500573_60_1.dxf --flow --fb --legend
|
|
|
|
Alle Switches, Ausgabedateien und Exit-Codes der drei Tools sind in
|
|
[`doc/Python_Scripts.md`](doc/Python_Scripts.md) dokumentiert; das
|
|
Domänenmodell (TRO-Typen, geplantes JSON-Layout, I/O-Listen-Analyse) findet
|
|
sich in den übrigen Dokumenten unter `doc/`.
|
|
|
|
## Lizenz
|
|
|
|
MIT License - siehe LICENSE
|
|
|
|
## Autor
|
|
|
|
Michael Stangl (GitHub: mistamichael)
|