Installation

this instruction guide through the manual installation process:

Prerequisites

install Arduino IDE, Arduino_Core_STM32, and Umfeld for Arduino by following the instructions provided on the projects’ websites:

install Arduino IDE (v2.3.6) by following instructions at Arduino IDE and/or install arduino-cli (v1.3.1)
install Arduino_Core_STM32 (v2.11.0) by following instructions at STM32duino / Arduino_Core_STM32
install Umfeld (v2.4.2) by following instructions at Umfeld
install Umfeld for Arduino (v2.4.2) by following instructions at Umfeld for Arduino

Installation Klangstrom Boards + Emulator

note, the installation below assumes that the paths to the Arduino Sketchbook folder and the Arduino15 Data folder are known. in a default installation the folders are in the following locations:

# macOS
ARDUINO_SKETCHBOOK_PATH=~/Documents/Arduino/
ARDUINO15_DATA_PATH=~/Library/Arduino15/
# Linux
ARDUINO_SKETCHBOOK_PATH=~/Arduino/
ARDUINO15_DATA_PATH=~/.arduino15/
# Windows
ARDUINO_SKETCHBOOK_PATH=C:\Users\<username>\Documents\Arduino\
ARDUINO15_DATA_PATH=C:\Users\<username>\AppData\Local\Arduino15\

download latest release of Klangstrom for Arduino (v1.0.0) as .zip and unpack:

  klangstrom-arduino
  ├── libraries
  │   ├── CODING-STYLE.md
  │   ├── Klangstrom
  │   ├── Klangstrom_Emulator
  │   ├── Klangstrom_KLST_EMU
  │   ├── Klangstrom_KLST_PANDA_STM32
  │   ├── Klangstrom_KLST_PANDA_STM32_CubeMX
  │   ├── LICENSE
  │   ├── README.md
  │   ├── USBDevices
  │   └── USBHost
  ├── variants
  │   ├── KLST_CATERPILLAR
  │   └── KLST_PANDA
  └── ...

copy all subfolders of klangstrom-arduino/libraries/ into ARDUINO_SKETCHBOOK_PATH/libraries/:

  ARDUINO_SKETCHBOOK_PATH
  ├── hardware
  │   ├── ...
  │   └── umfeld-arduino
  └── libraries
      ├── ...
      ├── Klangstrom
      ├── Klangstrom_Emulator
      ├── Klangstrom_KLST_EMU
      ├── Klangstrom_KLST_PANDA_STM32
      └── Klangstrom_KLST_PANDA_STM32_CubeMX

now add board definitions to STM32duino

open variants folder:

  klangstrom-arduino/variants
  ├── KLST_CATERPILLAR
  │   ├── KLST_CATERPILLAR-boards.txt
  │   └── variant
  │       ├── PeripheralPins_KLST_CATERPILLAR.c
  │       ├── variant_KLST_CATERPILLAR.cpp
  │       ├── variant_KLST_CATERPILLAR.h
  │       └── variant_KLST_CATERPILLAR.ld
  └── KLST_PANDA
      ├── KLST_PANDA-boards.txt
      └── variant
          ├── PeripheralPins_KLST_PANDA.c
          ├── variant_KLST_PANDA.cpp
          ├── variant_KLST_PANDA.h
          └── variant_KLST_PANDA.ld

find STM32H723ZGT folder in STM32duino in Arduino library folder at: ARDUINO15_DATA_PATH/packages/STMicroelectronics/hardware/stm32/2.11.0/variants/STM32H7xx/H723Z\(E-G\)T_H730ZBT_H733ZGT/
copy all files from klangstrom-arduino/variants/KLST_PANDA/variant/ + klangstrom-arduino/variants/KLST_CATERPILLAR/variant/ to STM32H723ZGT folder:
next open boards.txt file in ARDUINO15_DATA_PATH/packages/STMicroelectronics/hardware/stm32/2.11.0/
append content of KLST_CATERPILLAR-boards.txt and KLST_PANDA-boards.txt to board.txt file and save
now either restart Arduino IDE and look under Tools > Board > STM32 MCU based boards for Klangstrom KLST_... boards

or test with arduino-cli in console with arduino-cli board listall | grep KLST if boards are present:

  Klangstrom Emulator                        umfeld-arduino:umfeld:KLST_EMU
  Klangstrom KLST_CATERPILLAR (STM32H723ZGT) STMicroelectronics:stm32:KLST_CATERPILLAR
  Klangstrom KLST_PANDA (STM32H723ZGT)       STMicroelectronics:stm32:KLST_PANDA