Copyright (C) 2013-2023 Manfred Mahlow de|en

e4thcom für Linux und OSX ist ein Terminalprogramm für die Kommunikation mit eingebetteten Forth-Systemen. Es unterstützt bedingtes und unbedingtes Hochladen von Quelltextdateien sowie das Einbinden von Cross-Assemblern und Cross-Disassemblern. 32 und 64 Bit Linux (X86 und Raspberry/Raspbian) und 64 Bit OSX werden unterstützt.

Die OSX Version ist neu und noch im Status TESTING. Rückmeldungen im Fall von Problemen sind deshalb sehr willkommen.

Unterstützte Forth-Systeme:

328eForth , 430CamelForth , 430eForth , 4e4th, AmForth, anyForth , Mecrisp , Mecrisp-Quintus , Mecrisp-Stellaris , noForth , STM8, eForth , SwapForth

Die aktuelle Version ist

• Erstes Release mit Support für OSX.
• Erstes Release mit kompletten Quelltexten für e4thcom and MINFORTH Plus 1.5.
• Plug-in für 328eForth (-t 328eforth and -t 328eforth-xas) hinzugefügt.

e4thcom-0.8.5.2--230503.tar.gz

md5sum: 854c1e5423d12ec9c2e8e19483da4af8 e4thcom-0.8.5.2.tar.gz

0.8.5.1 - Pretty printing bug fix

0.8.5.0 - #ifdef und #ifndef hinzugefügt, für die bedingte Ausführung von Terminal Direktiven oder Forth Code ( siehe Feature List in doc/e4thcom-0.8.5.pdf ).

e4thcom-0.8.5.1.tar.gz

md5sum: c11fc33f263b7858b2715064b94d7cd8 e4thcom-0.8.5.tar.gz

• Baudraten bis 1000000 Baud werden nun unterstützt( siehe Feature List und Starting e4thcom in doc/e4thcom-0.8.4.pdf )
• #include unterstützt nun längere Dateinamen ( max. 128 Zeichen )
• Plug-in für Mecrisp-Quintus hinzugefügt, Option -t mecrisp-qs

e4thcom-0.8.4.tar.gz

md5sum: 72e563af2bf8a7fbef6f2f901fa0c22c e4thcom-0.8.4.tar.gz

• Kommandozeileneditierung auf Basis der Readline Bibliothek, Option –rln ( siehe Starting e4thcom und Buffered Command Line in doc/e4thcom-0.8.2.pdf )
• Die Pufferung der Kommandozeile kann mit der Terminal Direktive \^ aus- und eingeschaltet werden ( siehe Buffered Command Line in doc/e4thcom-0.8.2.pdf )
• Plug-in für SwapForth hinzugefügt, Option -t swapforth-j1sc ( siehe https://github.com/SteffenReith/J1Sc )

e4thcom-0.8.2-64.tar.gz

md5sum: 6792957a4deb6404588dbb98ea25fd3e e4thcom-0.8.2-64.tar.gz

e4thcom ist nun eine native X86_64 Bit Linux Anwendung, die sehr einfach für 32 Bit Systeme (X86 und Raspberry/Raspbian) neu compiliert werden kann. Wie das geht, ist in der Datei e4thcom-0.8.0/src/README beschrieben.

e4thcom-0.8.0.1-64.tar.gz (Eigentümer und Zugriffsrechte von Dateien im Verzeichnis e4thcom-0.8.0/src geändert; erforderlich für die Installation ins Verzeichnis /opt.)

md5sum: e9bbe3d21b411fe4531488db0a0abe88 e4thcom-0.8.0.1-64.tar.gz

e4thcom-0.8.0-64.tar.gz

md5sum: c840d69e19ee0eb994d4e7d019749787 e4thcom-0.8.0-64.tar.gz

Fehlerkorrektur für 0.6.3 : Fehler in \res export (nur Mecrisp-Stellaris Targets).

e4thcom-0.6.3.1.tar.gz

md5sum: b4d3985bf5d0e9410cb46465235b0c9f e4thcom-0.6.3.1.tar.gz

Neu: Option -p dir1:dir2:dir3 zum Überschreiben der Standardeinstellung für den Zugriff auf Quelltext- und Ressourcen-Dateien.

Weitere Informationen siehe Uploading of Source Code Files und Using Resource Files in der Datei doc/e4thcom.pdf im e4thcon-0.6.2.tar.gz Archiv.

e4thcom-0.6.3.tar.gz

md5sum: 5690adec7c17be4969798978b93dbcfb e4thcom-0.6.3.tar.gz

Hinzugefügt:

• Zweiter Anzeige-Modus
  • invers (schwarze/farbige Schrift vor weißem Hintergund), Option: –idm
  • normal (weiße/farbige Schrift vor schwarzem Hintergrund), Vorgabe
• Unterstützung für die [Home]- u. [End]-Tasten beim Editieren der Eingabezeile
• [Shift]+[TAB] löscht den Inhalt der Eingabezeile
• Plug-In für das stm8eForth ab Version 2.2.15, Option: -t stm8ef

Unterstützte Target-Forth-Systeme:

430CamelForth , 430eForth , 4e4th, AmForth, anyForth , Mecrisp , Mecrisp-Stellaris , noForth , stm8eForth

Weitere Informationen siehe Datei e4thcom.pdf im Verzeichnis doc im e4thcon-0.6.2.tar.gz Archiv.

e4thcom-0.6.2.tar.gz

md5sum: 3c7936dfa08186578846d8d4d181ed31 e4thcom-0.6.2.tar.gz

Hinzugefügt:

• Eingabezeile mit Historie mit TAB-Auswahl
• Editor-Schnittstelle
• Hochladen von Quelltext in Halb- oder Vollduplex
• Plug-Ins für 430CamelForth, 430eForth, 4e4th, AmForth, anyForth, Mecrisp, Mecrisp-Stellaris, noForth

Entfernt:

• Datenübertragung über UDP Netzwerkverbindung
• ForthBox GUI

Weitere Informationen siehe Datei e4thcom.pdf im Verzeichnis doc im e4thcon-0.6.1.tar.gz Archiv.

e4thcom-0.6.1.tar.gz

md5sum: 11c5cb8ce917e331da060fcccfeca9f0 e4thcom-0.6.1.tar.gz

Zusätzliche Plug-Ins:

e4thcom-0-6-1-stm8ef-v2.2.15-plug-in.tar.gz

md5sum: 0e8db0e60f75b21e19a131cc3dc44b55 e4thcom-0-6-1-stm8ef-v2.2.15-plug-in.tar.gz

e4thcom-0-6-1-stm8ef-plug-in.tar.gz

md5sum: 65e298a01a96d6f25c8fcf8f5f72e2fb e4thcom-0-6-1-stm8ef-plug-in.tar.gz

• Datenübertragung über serielle Schnittstelle oder UDP Netzwerkverbindung
• Bidirektionale Cross-Assembler Schnittstelle (erlaubt den Zugriff auf das Target Wörterbuch)
• Cross-Disassembler Schnittstelle
• MSP430 Cross-Assembler für noForth und 4e4th
• MSP430 Cross-Disassembler für noForth
• ATmega Cross-Assembler für AmForth
• PlugIns für 4e4th, Am Forth, Mecrisp, Mecrisp-Stellaris und noForth
• ForthBox mit verbesserter Tastaturschnittstelle

e4thcom-0.5.3.tar.gz

md5sum: 559cc0a5112eee79c3b83bafa0388f7b e4thcom-0.5.3.tar.gz

In Linux-Systemen dient das Verzeichnis /opt gemäß dem Filesystem Hierarchy Standard (FHS) zur Installation von optionalen Anwendungssoftwarepaketen¹⁾

In /opt wird typischerweise Software gespeichert, die nicht über die Standard-Paketverwaltung des Systems installiert wurde (z.B. bestimmte IDEs, Datenbanken oder spezielle Tools). e4thcom gehört in diese Kategorie.

Für das Softwarepaket wird ein eigenes Unterverzeichnis unter /opt erstellt. Dieses Unterverzeichnis trägt den Namen des Pakets. Innerhalb dieses Unterverzeichnisses befinden sich dann die zugehörigen Dateien und Verzeichnisse der Software.

Der Vorteil dieser Struktur nach FHS ist:

• Isolation: Jedes Softwarepaket ist in seinem eigenen Verzeichnis gekapselt, wodurch Konflikte mit anderen Programmen oder Systemdateien vermieden werden.
• Einfache Verwaltung: Das Hinzufügen, Aktualisieren oder Entfernen von Software in /opt ist in der Regel unkompliziert, da alle zugehörigen Dateien an einem Ort liegen.
• Systemintegrität: Da Software in /opt nicht Teil der Standardinstallation ist, beeinträchtigt sie die Stabilität und Integrität des Basissystems nicht.

Es ist wichtig zu beachten, dass die Verwendung von /opt eine Konvention ist. Einige Distributionen oder Administratoren handhaben die Installation zusätzlicher Software möglicherweise anders und verwenden stattdessen beispielsweise /usr/local. Die Empfehlung des FHS ist jedoch, /opt für die beschriebenen Zwecke zu nutzen.

Das unterste Verzeichnis in der Linux-Dateisystemhierarchie, das alle anderen Dateien und Verzeichnisse enthält, nennt man das Root-Verzeichnis. Es wird durch ein einzelnes / (Slash) symbolisiert. Dort ist /opt bereits angelegt.

So habe ich es auf meinem Laptop denn auch gemacht.

Speicher das e4thcom-Paket dort ab:

/opt/e4thcom-0.8.0 

Damit e4thcom von der Konsole aus gefunden werden kann, muss noch ein Link dorthin im Suchpfad PATH sein. Für gewöhnlich sind solche Links alle in /usr/local/bin angelegt, welches bereis im PATH ist. Du kannst das mit echo $PATH überprüfen.

In meinem LinuxMint ist es ein Rechtsklick auf die Datei e4thcom und in dem Menü dann „create link“, dann noch diesen Link nach /usr/local/bin verschieben, fertig - fast jedenfalls. Bei mir hier wurde dadurch ein Link to e4thcom erzeugt. Im /usr/local/bin muss natürlich nur schlicht e4thcom stehen. Also noch umbenennen von Link to e4thcom nach einfach e4thcom. :)

Nun sollte von jeder Konsole aus das Kommando e4thcom funktionieren, auch mit Optionen wie -t <target>

Das ging, weil ich User mit Admin-Rechten auf meinem eigenen LinuxMint-Laptop bin. Da klicke ich im Thunar-Fenster²⁾ auf die Option „Als Root öffnen“ und ab da läst sich alles einfach so machen.„

Sofern absehbar ist, dass e4thcom auf dem Linux-System von nur einem User verwendet wird, von dir, ist es einfacher und sicherer, e4thcom ins Verzeichnis /home/user-name/bin auszupacken und dort auch den Link zum e4thcom Binary zu erzeugen. Existiert dieses Verzeichnis noch nicht, muss es angelegt werden. Und das alles geht hier ohne root-Rechte - also ohne SUDO - und /home/user-name/bin wird dem Pfad automatisch hinzugefügt. Auch kann man dann bei Bedarf e4thcom ohne root-Rechte neu compilieren, siehe ~/bin/e4thcom-x.y.z/src/README.

Übrigens ist im e4thcom-Paket auch ein /doc/e4thcom-*.pdf dabei. Dort wird dieses Vorgehen auch empfohlen - S.4 oder so. Aber nur sehr knapp und für Linux-Neulinge wie mich nicht gleich klar warum das so ist. Drum hier meine Notizen dazu. Möge es hilfreich sein. mk 20250430