Installation {#mainpage}

1. Overall description

This library provides C++ functionallity which is used to communicate with different types of memories to test them according to PUF behavior. There exists wrappers for all device specific functions like initialization functions for interfaces like UART or SPI. It is also possible to dynamically add memory modules to the library.

2. Installation

2.1 Compile on Command Line

1. Run ./compile_fw_STM32F4.sh to build for a STM32F4 board
2. The

2.1 Run in CLion

1. Check this official post about STM32CubeMX projects in CLion (Do not need the OpenOCD + STM32CubeMX plugin).
2. Git clone this project.
3. Open(file --> Open...) this project in CLion
4. Add ocd debug
   1. Go to Run/Debug Configuration
   2. Add New OpenOCD Download & Run
   3. Select Target memory_control_fw.elf
   4. Select Executable memory_control_fw.elf
   5. Select Board Config File (stm32f429disc1.cfg in this project)
   6. Select Download Always
   7. Select Reset Halt
5. Change Cmake options
   1. Go to File → Settings → Build, Execution, Deployment → Cmake
   2. Add
      -DBoardName="stm32f429" -DBoardClass=STM32F4 -DCPU=cortex-m4 -DFPUType=hard -DFPUSpecification=fpv4-sp-d16 -Dspecs=rdimon.specs
      to Cmake options → click Apply and Ok
6. Build & Debug (test with flash_leds function in gpio.c file).

3. Use CXX_implementation as dependency library

1. add git submoudle, run

git submodule add git@git.fim.uni-passau.de:frankfl/stm_measurement_firmware.git 

2. change submodule branch to CXX_implementation, edit .gitmodules file

[submodule "stm_measurement_firmware"]
	path = stm_measurement_firmware
	url = git@git.fim.uni-passau.de:frankfl/stm_measurement_firmware.git
	branch = CXX_implementation

3. update git submodule, run

git submodule update --remote

4. add the following part to your CMakeLists.txt

cmake_minimum_required(VERSION 3.1)

# IMPORTANT: set DEP_ROOT_DIR to access cmake files
set(DEP_ROOT_DIR  ${CMAKE_CURRENT_SOURCE_DIR}/stm_measurement_firmware)

include(${DEP_ROOT_DIR}/settings.cmake)
include(${DEP_ROOT_DIR}/cmake/device_specific_defines.cmake)
include(${DEP_ROOT_DIR}/cmake/file_list.cmake)

# IMPORTANT: project must be after includes
project(you_project CXX C ASM)

add_executable(you_project.elf main.cpp ${ProjectFiles} ${MiddlewareFiles} ${DriverFiles} ${StartUpFile})
target_include_directories(you_project.elf PUBLIC ${include_dirs})

5. set board config file, edit OpenOCD(run/debug) configurations The red part is set to /yourproject/stm_measurement_firmware/OpenOCDConfig/stm32f429disc1.cfg