Le but de ce projet est d'adapter le fichier stm8ef.asm.org pour la carte NUCLEO_8S208RB et l'assembleur SDASSTM8.
- NUCLEO-8S207K8
- NUCLEO_8S208RB
- STM8S-DISCOVERY
Les sources du projet sont disponibles sur https://github.com/Picatout/stm8_eforth.
Le projet est distribué sous license GPL V3.
- make
sudo apt install make
- sdcc
sudo apt install sdcc
- stm8flash. Il faut le construire et l'installer à partir des sources du projet.
- Sélectionnez la carte et les options dans le fichier inc/config.inc. Pour sélectionner la carte ou le type de CPU mettre à 1 la variable indiquant la cible désirée et toutes les autres à 0.
NUCLEO_8S207K8=1
NUCLEO_8S208RB=0
DISCOVERY=0
DOORBELL=0
-
Pour les options commançant par WANT_ il s'agit de mettre la valeur à 1 pour include le fichier dans la construction du binaire.
-
Chaque cible a un fichier "*.mk" qui ressemble à ceci.
####################################
# Make file for NUCLEO_8S207K8 board
####################################
BOARD=stm8s207k8
PROGRAMMER=stlinkv21
FLASH_SIZE=65536
include Makefile
- Les fichiers résulants de la construction du projet se retrouve dans un sous-dossier de build qui porte le nom de la variable BOARD
~/github/stm8_eforth$ ls build
stm8s105c6 stm8s105k6 stm8s207k8 stm8s208rb
- pour construire et flasher le binaire sur la carte il suffit de lancer la commande
make -fnucleo_8s207.mk
Ici nucleo_8s207.mk est le nom du fichier make spécifique à la cible choisie.
- Pour construire le projet sans flasher la binaire il faut lancer la commande
make -fnucleo_8s207.mk compile
Eforth utilise un port sériel UART pour communiquer avec l'utilisateur. Les paramètres du port série sont les suivants:
- 115200 BAUD
- 8 BITS
- 1 STOP
- Pas de partité
Lorsqu'une carte NUCLEO est connectée au PC un port série virtuel est créé et sert à la communication avec la carte.
example avec GTKterm sur Ubuntu/Linux
example avec Tera Term sur Windows
Dans le ficher inc/config.inc Il y a un option pour choisir le caractère de fin de ligne à utiliser.
- EOL_CR Qui est communément utilisé sur les systèmes Linux.
- EOL_LF Qui est utilisé sur OSX d'Apple.
La valeur par défaut est EOL_CR et peut-être laissée tel quel puisque les logiciels émulateur de terminal permette habituellement de configuré ce paramètre pour s'accorder avec la périphérique connecté au port série.
Les fichiers PDF suivants se retrouvent dans le dossier docs.
Eforth est un Forth développé à l'origine par Bill Muench dans le but d'avoir un système Forth qui soit rapidement adaptable d'un système à l'autre. C'était dans les années 80, les années glorieuses du Forth. À cette époque chaque PC 8 bits avait son Forth: Apple II, TRS-80, ZX-SPECTRUM, etc. Il y avait aussi un Forth pour le système d'exploitation CP/M.
Par la suite C.H. Ting a repris le travail de Bill Muench et a porté eForth sur de nombreuses architectures 8,16 et 32 bits. stm8ef est une de ses dernières adaptations et a été écris pour la carte stm8s-discovery en 2011.
Le moderne circuit intégré multi-ordinateurs GA144 de GreenArrays a même une version de eForth incris dans la ROM d'un de ses 144 ordinateurs.
M. Ting est un nom connu dans l'univers du Forth pour ses adaptations de eForth mais aussi pour ses publications concernant eForth. eForth overview ainsi que d'autres documents sur eForth sont téléchargeables gratuitement en format pdf.
M. Ting a aussi travaillé sur le développement de processeurs adapté au langage Forth. Il a un site web mais celui-ci semble à l'abandon.
Comme il s'agit de 2 MCU STM8 l'adaptation vers le stm8s208 ne devrait pas nécessité beaucoup de travail. Le plus gros du travail sera l'adaptation pour SDAS. J'ignore pour quel assembleur le fichier a été créé mais ma tentative d'assemblage avec SDAS a échouée. Le fichier a moins de 4000 lignes, ce n'est pas la mer à boire.
Débuté travail sur la librairie float24.asm qui implémente le traitement en virgule flottante sur nombre codés sur 24 bits au lieu de 32 bits. Ceci va accéllérer les opérations arithmétique au prix d'une réduction de la précision. La mantisse est codé sur 16 bits incluant le signe et l'exposant est codé sur 8 bits incluant le signe. Sur la pile les float24 sont stocké sur 4 octets mais sur 3 octets pour les littéraux, variables et constantes.
Poursuite du travail d'optimisation sur le système de base stm8ef.asm et les librairies double.asm ainsi que float.asm.
Pour envoyer un fichier source forth à la carte il faut utiliser l'outil tools/SendFile dans le dossier tools. Par exemple ma carte nucleo créé le port ttyACM0.
- Pour tester la librairie double.asm il faut utiliser le fichier double-test.f
tools/SendFile -s/dev/ttyACM0 double-test.f
Envoie le fichier à la carte NUCLEO qui le compile. le mot ALL-TEST exécute tous les tests du fichier.
- Pour tester la librairie float.asm il faut utiliser le fichier float-test.f
tools/SendFile -s/dev/ttyACM0 float-test.f
Le mot ALL-TEST encore un fois exécute tous les test.
Je travaille sur la version 4.0 qui ajoute quelques mots au fichier de base stm8ef.asm et 2 librairies. double.asm pour les entiers 32 bits ainsi que float.asm qui est une librairie arithmétique en virgule flottante 32 bits.
- ajout d'un compteur de millisecondes en utilisant TIMER4. Le mot msec empile ce compteur.
- mis en commentaire la commande SEE pas très utile.
- Adaptation complétée.
-
Suite aux nombreuses modification faite au logiciel j'ai fait passé le numéoro de version à 3.0
-
Maintenant les mots sont compilés en mémoire FLASH.
-
Support pour les interruptions avec création de routines d'interruptions en utilisant les mots I: et I;. La priorité des interruptions peut-être modifiée avec le mot SET-ISP
-
Ajout de nombreux mots d'usage général comme LSHFIT, RSHIFT, FORGET, REBOOT et BYE.
- Started working on reference manual.
- Débuter la rédaction d'un Tutoriel.
Le système pour construire et flasher la cible a changer car maintenant il y a 2 cibles.
- NUCLEO-8S208RB
- STM8S-DISCOVERY
La première chose à faire est de modifier les constantes NUCLEO et DISCOVERY dans le fichier config.inc pour sélectionner la carte désirée.
Comme il faut spécifier le MCU et la version du programmeur j'ai crééer un makefile pour chaque carte. nucleo.mk et dicso.mk le nom du fichier cible est aussi différent. Donc maintenant il faut spécifier le makefile qui doit-être utilisé.
Les règles qui sont les même.
-
La règle par défaut consiste à créer le fichier *.ihx sans programmer la carte.
-
La règle flash sert à programmer la carte avec le fichier *.ihx déjà compilé.
-
La règle eforth créée et flash la carte.
-
la règle clean_eevars remet à zéro les variables persistantes dans l'eeprom.
-
la règle read_eevars lit la valeur des variables persistantes dans l'eeprom et affiche leur valeurs en utilisant la commande hexdump.
-
La règle erase efface toute la mémoire FLASH.
>make -fnucleo.mk erase
>make -fnucleo.mk eforth
Erase n'est requis que s'il y a déjà une version de eforth dans la mémoire flash.