Mecrisp-Stellaris Forth for the STM32 Cube ecosystem. The STM32WB Nucleo Board is working out of the box yet. See also Mecrisp Cube.
These instructions will get you a copy of the project up and running on your local machine (STM32 Nucleo board) for development and testing purposes.
- One of these boards
- STM32WB Nucleo Board - The highly affordable STM32 Nucleo boards allow anyone to try out new ideas and to quickly create prototypes with any STM32 MCU. The STM32 Nucleo boards integrate an ST-Link debugger/programmer, so there is no need for a separate probe.
- STM32F405 Adafruit Feather Express Board - ST takes flight in this Feather board. The new STM32F405 Feather that we (Adafruit) designed runs CircuitPython (and Forth) at a blistering 168MHz – our fastest CircuitPython board ever! We put a STEMMA QT / Qwiic port on the end, so you can really easily plug and play I2C sensors.
- STM32WB Feather Development Board - This Adafruit Feather compatible development board is from Reclaimer Labs. You can find more information about this excellent board on the Reclaimer Labs Site.
- Terminal emulator application for PC, e.g.:
Flash the Mecrisp-Cube binary to the Nucleo Board.
- Connect the Nucleo Board USB ST-LINK to the PC
- Copy binary (
MecrispCube.bin) to the USB mass storage NODE_WB55RG. Or even better the binary with tools and drive.
Start the terminal emulator application on the PC.
Check for the serial communication port (e.g. for Linux /dev/ttyACM0)
and set the speed to 115200 baud.
I set the putty terminal configuration to
- Implicit CR in every LF
- Local echo: Auto
- Local line editing: Auto
Mecrisp-Stellaris RA 2.5.4 by Matthias Koch.
Mecrisp-Cube 1.4.4 for STM32WB Feather, 63/384 KiB RAM/FLASH dictionary (C) 2021 [email protected]
* Firmware Package STM32Cube FW_WB V1.11.0, USB-CDC, BLE Stack 5.0 (C) 2021 STMicroelectronics
* CMSIS-RTOS V2 FreeRTOS wrapper, FreeRTOS Kernel V10.3.1 (C) 2020 Amazon.com
* FatFs for internal flash and microSD - Generic FAT fs module R0.12c (C) 2017 ChaN
* tiny vi - part of BusyBox (C) 2000, 2001 Sterling Huxley
include 0:/etc/rc.local
23 5 / .[CR] 4 ok.
: hello ." World" ;[CR] ok.
hello[CR] World ok.
A step by step series of examples that tell you how to get a development env running
Install the IDE STM32CubeIDE, it is Eclipse and GCC based. STM32CubeMX is included in the IDE, you need a stand alone installation only if you do not want to use the STM32CubeIDE.
Get the sources from github:
psi@homer:~> git clone https://github.com/spyren/Mecrisp-Cube
Klone nach 'Mecrisp-Cube' ...
remote: Enumerating objects: 106, done.
remote: Counting objects: 100% (106/106), done.
remote: Compressing objects: 100% (71/71), done.
remote: Total 106 (delta 33), reused 106 (delta 33), pack-reused 0
Empfange Objekte: 100% (106/106), 938.96 KiB | 2.39 MiB/s, Fertig.
Löse Unterschiede auf: 100% (33/33), Fertig.
Import the project into the IDE:
File -> Import -> General -> Existing Projects into Workspace -> Select root directory
Copy project into workspace
Browse to Mecrisp-Cube directory
Generate code from the STM32CubeMX MecrispCube.ioc file:
Project -> Generate Code
Restore changed source files
$ git status
{list of changed files}
$ git restore {files to restore}
Select the Build Configuration (Debug if you want to debug the project) and Build the project:
Project -> Build Configurations -> Set Active -> Debug/Release
Project -> Build Project
- STM32CubeIDE - STM32CubeIDE is an all-in-one multi-OS development tool, which is part of the STM32Cube software ecosystem. The IDE is used for development, GCC tools are included.
- STM32CubeMX - STM32CubeMX is a graphical tool that allows a very easy configuration of STM32 microcontrollers and microprocessors, as well as the generation of the corresponding initialization C code for the Arm® Cortex®-M core or a partial Linux® Device Tree for Arm® Cortex®-A core), through a step-by-step process.
- STM32CubeProg - STM32CubeProgrammer (STM32CubeProg) is an all-in-one multi-OS software tool for programming STM32 products.
The STM tools work on Linux, Windows, and Mac.
Tab size is 4 for C and assembler source files. Append ?ts=4 to the URL to change the tab-size.
We use SemVer for versioning. For the versions available, see the tags on this repository.
- USART0 default terminal console, 115200 Baud, 20 KiB Rx buffer
- USB-CDC secondary terminal console, type
cdcto change console, back withuart. - 512 KiB Flash dictionary, 60 KiB RAM dictionary
- CMSIS-RTOS, FreeRTOS Kernel V10.2.1
- FatFs R0.12c, some Unix like command line tools
- BLE Cable Replacement Service.
- CMSIS-RTOS, FreeRTOS Kernel V10.2.1
- FatFs R0.12c, some Unix like command line tools
- BLE Cable Replacement Service.
- tiny vi - part of BusyBox
- Mecrisp-Stellaris RA
- Flash Drive
- OLED driver, I2C, timer, RTC
- Markdown docs
- Own Tags for F405 and WB55 chips
0:/etc/rc.localstartup script- 2 MiB flash drive for F405
- 16 MiB flash drive for WB Feather
- New memory layout (WB Feather): 384 KiB for the firmware, 384 KiB for the FLASH dictionary
- Peter Schmid - Initial work - Mecrisp Cube
- Matthias Koch - Forth on ARM Cortex M0/M4 - Mecrisp Stellaris
See also the list of contributors who participated in this project.
This project Mecrsip-Cube is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Mecrsip-Cube is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Mecrsip-Cube. If not, see http://www.gnu.org/licenses/.
- http://mecrisp.sourceforge.net/ Original Mecrisp project, Matthias Koch
- https://mecrisp-stellaris-folkdoc.sourceforge.io/ Mecrisp Stellaris Unofficial UserDoc, Terry Porter
- https://jeelabs.org/article/1612b/ Forth in 7 easy steps, Jean-Claude Wippler
- https://forth-ev.de/ Forth-Gesellschaft e.V.
- https://forth-ev.de/wiki/res/lib/exe/fetch.php/vd-archiv:4d2015-arm.pdf ARM-Sonderheft