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.
- STM32WB5MM-DK Discovery Kit - complete demonstration and development platform for the STMicroelectronics STM32W5MMG module.
- STM32WB Feather Development Board - The STM32WB Feather Board is a development board based on the Adafruit Feather standard with the STM32WB Bluetooth SoC at its core. This board specifically uses the STM32WBCGU6. It includes all the basic functionality you need to get up and running quickly.
- 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.
- 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.
For other boards see https://github.com/spyren/Mecrisp-Cube/branches
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 STM32WB55, 63/128 KiB RAM/FLASH dictionary (C) 2021 peter@spyr.ch
* 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
- 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