Forth-eV Wiki

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.

Unterstützte Forth-Systeme:

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

Die aktuelle Version ist

• Bugfix Release, da mit Linux Kernel 6. und glibc 2.4. die Initialisierung der seriellen Schnittstelle mit e4thcom-0.8.5 (und 0.8.4) fehlschlägt. stty* der GNU Core Utilities wird nun für die Initialisierung der seriellen Schnittstelle verwendet. info-0.9.0.pdf e4thcom-0.9.0-stty.tar.gz md5sum:357a09d61d5d74eb2420652dd8b66089 e4thcom-0.9.0-stty-260502.tar.gz ==== e4thcom-0.8.5.2 ==== * Erstes Release mit Support für OSX im Status TESTING. * 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 ==== e4thcom-0.8.5.1 ==== 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 ==== e4thcom-0.8.4 ==== * 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 ==== e4thcom-0.8.2 ==== * 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-0.8.0 ==== 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 ==== e4thcom-0.6.3.1 ==== 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 ==== e4thcom-0.6.3 ==== 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 —- ==== e4thcom-0.6.2 ==== 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 —- ==== e4thcom-0.6.1 ==== 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 —- ==== e4thcom-0.5.3 ==== * 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 ==== Installationshinweis ==== === Kurze Einführung === 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. === Praktisches Vorgehen === 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.„ === Falls du kein Admin bist === 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