Merge branch 'master' of https://github.com/mean00/arduino-cmake-stm32

Author: mean

ArduinoToolchain.cmake

@@ -28,7 +28,7 @@ set(CMAKE_SYSTEM_NAME Arduino)
 IF(NOT DEFINED ARDUINO_CMAKE_TOP_FOLDER)
 
 if (EXISTS ${CMAKE_CURRENT_LIST_DIR}/Platform/Arduino.cmake)
-    set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} ${CMAKE_CURRENT_LIST_DIR})
+    set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} ${CMAKE_CURRENT_LIST_DIR} CACHE INTERNAL "")
 endif ()
     SET(ARDUINO_CMAKE_TOP_FOLDER ${CMAKE_CURRENT_LIST_DIR} CACHE INTERNAL "")
 ENDIF(NOT DEFINED ARDUINO_CMAKE_TOP_FOLDER)
@@ -95,7 +95,7 @@ elseif ((NOT ARDUINO_SDK_PATH) AND (DEFINED ENV{_ARDUINO_CMAKE_WORKAROUND_ARDUIN
     set(ARDUINO_SDK_PATH "$ENV{_ARDUINO_CMAKE_WORKAROUND_ARDUINO_SDK_PATH}")
 endif ()
 
-MESSAGE(STATUS "Architecture is ${PLATFORM_ARCHITECTURE}")
+MESSAGE(STATUS "Architecture is ${PLATFORM_ARCHITECTURE}, System is ${CMAKE_SYSTEM_NAME}")
 STRING(TOUPPER "${PLATFORM_ARCHITECTURE}" upper_arch)
 IF("${upper_arch}" MATCHES "STM32.*" )
     SET(PLATFORM_ARCHITECTURE_POSTFIX "Stm32")

ArduinoToolchainEsp32.cmake

@@ -15,7 +15,7 @@ ENDIF(NOT PLATFORM_TOOLCHAIN_PATH)
 
 
 LIST(APPEND CMAKE_SYSTEM_PREFIX_PATH "${PLATFORM_TOOLCHAIN_PATH}")
-SET(ESP32_TOOLCHAIN_PREFIX xtensa-esp32-elf-)
+SET(ESP32_TOOLCHAIN_PREFIX xtensa-esp32-elf-  CACHE INTERNAL "")
 
 FUNCTION(FATAL_BANNER msg)
     MESSAGE(STATUS "@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@")
@@ -31,6 +31,7 @@ IF(NOT EXISTS "${PLATFORM_TOOLCHAIN_PATH}/${ESP32_TOOLCHAIN_PREFIX}gcc")
    FATAL_BANNER( "!! PLATFORM_TOOLCHAIN_PATH does not point to a valid toolchain (arm-none-eabi-gcc....)!! (${PLATFORM_TOOLCHAIN_PATH})")
 ENDIF()
 #
+dump_all()
 #
 SET(CMAKE_C_COMPILER_ID   "GNU" CACHE INTERNAL "")
 SET(CMAKE_CXX_COMPILER_ID "GNU" CACHE INTERNAL "")

ArduinoToolchainStm32.cmake

@@ -24,10 +24,13 @@ FUNCTION(FATAL_BANNER msg)
     MESSAGE(FATAL_ERROR "${msg}")
 ENDFUNCTION(FATAL_BANNER msg)
 
+IF(WIN32)
+	SET(TOOLCHAIN_SUFFIX ".exe")
+ENDIF(WIN32)
 #
 # Sanity check
 #
-IF(NOT EXISTS "${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}gcc")
+IF(NOT EXISTS "${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}gcc${TOOLCHAIN_SUFFIX}")
    FATAL_BANNER( "!! PLATFORM_TOOLCHAIN_PATH does not point to a valid toolchain (arm-none-eabi-gcc....)!! (${PLATFORM_TOOLCHAIN_PATH})")
 ENDIF()
 #
@@ -41,9 +44,9 @@ ENDIF()
 SET(CMAKE_C_COMPILER_ID   "GNU" CACHE INTERNAL "")
 SET(CMAKE_CXX_COMPILER_ID "GNU" CACHE INTERNAL "")
 #
-set(CMAKE_C_COMPILER   ${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}gcc CACHE PATH "" FORCE)
-set(CMAKE_ASM_COMPILER ${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}gcc CACHE PATH "" FORCE)
-set(CMAKE_CXX_COMPILER ${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}g++ CACHE PATH "" FORCE)
+set(CMAKE_C_COMPILER   ${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}gcc${TOOLCHAIN_SUFFIX} CACHE PATH "" FORCE)
+set(CMAKE_ASM_COMPILER ${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}gcc${TOOLCHAIN_SUFFIX} CACHE PATH "" FORCE)
+set(CMAKE_CXX_COMPILER ${PLATFORM_TOOLCHAIN_PATH}/${STM32_TOOLCHAIN_PREFIX}g++${TOOLCHAIN_SUFFIX} CACHE PATH "" FORCE)
  #set(CMAKE_CXX_LINK_EXECUTABLE    "<CMAKE_CXX_COMPILER>  <FLAGS> <CMAKE_CXX_LINK_FLAGS>  <LINK_FLAGS> <OBJECTS>  -o <TARGET> <LINK_LIBRARIES>")
 # There is probably a cleaner way to do this....
  set(CMAKE_CXX_LINK_EXECUTABLE    "<CMAKE_CXX_COMPILER>   <CMAKE_CXX_LINK_FLAGS>  <LINK_FLAGS> -lgcc -mthumb -Wl,--start-group  <OBJECTS> <LINK_LIBRARIES> -Wl,--end-group   -o <TARGET> ")

Platform/Core/BoardFlags/CompilerFlagsSetterEsp32.cmake

@@ -45,14 +45,20 @@ MACRO(ADD_TO_COMPILE_FLAGS key prefix)
     endif( DEFINED ${BOARD_ID}.${key})
 ENDMACRO(ADD_TO_COMPILE_FLAGS key prefix)
 #
-SET(ESP32_SYSTEM_ROOT "/home/fx/Arduino/hardware/espressif/esp32/")
+SET(ESP32_SYSTEM_ROOT "${PLATFORM_PATH}")
 #
 #
+MACRO(ADD_RELATIVE_IPATH ipath)
+    set(COMPILE_FLAGS "${COMPILE_FLAGS} -I${ESP32_SYSTEM_ROOT}/${ipath}") # Hack, there is a better way to get the system path
+ENDMACRO(ADD_RELATIVE_IPATH ipath)
 MACRO(ADD_IPATH path)
-    set(COMPILE_FLAGS "${COMPILE_FLAGS} -I${ESP32_SYSTEM_ROOT}/tools/sdk/include/${path}") # Hack, there is a better way to get the system path
+    ADD_RELATIVE_IPATH(tools/sdk/include/${path})
 ENDMACRO(ADD_IPATH path)
 #
 #
+ADD_RELATIVE_IPATH(libraries/SPI/src/)
+ADD_RELATIVE_IPATH(libraries/FS/src/)
+ADD_RELATIVE_IPATH(libraries/SPIFFS/src/)
 ADD_IPATH(config)
 ADD_IPATH(app_trace)
 ADD_IPATH(app_update)

Platform/Core/BoardFlags/CompilerFlagsSetterStm32.cmake

@@ -8,7 +8,9 @@ ELSE(TRY_CPU_FLAGS)
     _get_board_property(${BOARD_ID} build.cpu_flags CPU_FLAGS)
 ENDIF(TRY_CPU_FLAGS)
 
-set(COMPILE_FLAGS "-DF_CPU=${FCPU} ${CPU_FLAGS} -DARDUINO=${NORMALIZED_SDK_VERSION} ")
+# dont set the mcu speed, it is done elsewhere
+# set(COMPILE_FLAGS "-DF_CPU=${FCPU} ${CPU_FLAGS} -DARDUINO=${NORMALIZED_SDK_VERSION} ")
+ set(COMPILE_FLAGS " ${CPU_FLAGS} -DARDUINO=${NORMALIZED_SDK_VERSION} ")
 # This should be derived from the arduino config files
 # hardcode them for the moment
 
@@ -51,7 +53,8 @@ set(COMPILE_FLAGS "${COMPILE_FLAGS} ${STM32_SYSTEM_ROOT}/libmaple/include/libmap
 set(COMPILE_FLAGS "${COMPILE_FLAGS} ${STM32_SYSTEM_ROOT}/libmaple/usb/usb_lib/\" ") # Hack
 set(COMPILE_FLAGS "${COMPILE_FLAGS} ${STM32_SYSTEM_ROOT}/libmaple/usb/stm32f1/\" ") # Hack
 set(COMPILE_FLAGS "${COMPILE_FLAGS} ${STM32_SYSTEM_ROOT}/libmaple/stm32f1/include/\" ")
-
+set(COMPILE_FLAGS "${COMPILE_FLAGS} ${STM32_SYSTEM_ROOT}/../libraries/SPI/src/\" ")
+ 
 ADD_TO_COMPILE_FLAGS(build.vect   "")
 ADD_TO_COMPILE_FLAGS(menu.cpu.${ARDUINO_UPLOAD_METHOD}Method.build.vect  "")
 

Platform/Core/BoardFlags/LinkerFlagsSetterStm32.cmake

@@ -1,10 +1,13 @@
 # ToDo: Comment
 function(set_board_linker_flags LINKER_FLAGS BOARD_ID IS_MANUAL)
 
-    set(LINK_FLAGS "${LINK_FLAGS} -Os  -Wl,--gc-sections -mcpu=cortex-m3")
+    set(LINK_FLAGS "${LINK_FLAGS} -Os  -Wl,--gc-sections -mcpu=cortex-m3  -Xlinker -print-memory-usage ")
     set(LINK_FLAGS "${LINK_FLAGS} -Wl,--unresolved-symbols=report-all -Wl,--warn-common -Wl,--warn-section-align -lstdc++")
 IF(ARDUINO_USE_NEWLIB) # smaller
-    set(LINK_FLAGS "${LINK_FLAGS} --specs=nano.specs -u _printf_float")
+    set(LINK_FLAGS "${LINK_FLAGS} --specs=nano.specs") # -u _printf_float")
+IF(ARDUINO_USE_FLOAT_PRINTF)
+    set(LINK_FLAGS "${LINK_FLAGS}  -u _printf_float")
+ENDIF(ARDUINO_USE_FLOAT_PRINTF)
 ENDIF(ARDUINO_USE_NEWLIB) # smaller
 
 #-Wl,--warn-unresolved-symbols -lstdc++")

Platform/Core/Targets/ArduinoBootloaderUploadTargetCreatorEsp32.cmake

@@ -17,29 +17,9 @@
 #
 #=============================================================================#
 function(create_arduino_bootloader_upload_target TARGET_NAME BOARD_ID PORT AVRDUDE_FLAGS)
-    IF(FALSE)
     set(UPLOAD_TARGET ${TARGET_NAME}-upload)
-    set(AVRDUDE_ARGS)
-
-    build_arduino_bootloader_arguments(${BOARD_ID} ${TARGET_NAME} ${PORT} "${AVRDUDE_FLAGS}" AVRDUDE_ARGS)
-    if (NOT EXECUTABLE_OUTPUT_PATH)
-        set(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_BINARY_DIR})
-    endif ()
-    set(TARGET_PATH ${EXECUTABLE_OUTPUT_PATH}/${TARGET_NAME})
-
-    IF(ARDUINO_USB_PID)
-        SET(USB_PID "${ARDUINO_USB_PID}")
-    ELSE(ARDUINO_USB_PID)
-        SET(USB_PID "0004") # Default value
-    ENDIF(ARDUINO_USB_PID)
-    IF(NOT DEFINED(MAPLE_UPLOAD))
-        SET(MAPLE_UPLOAD ${ORIGINAL_PLATFORM_PATH}/tools/linux/maple_upload CACHE INTERNAL "")
-    ENDIF(NOT DEFINED(MAPLE_UPLOAD))
-
     add_custom_target(${UPLOAD_TARGET}
-            ${MAPLE_UPLOAD}
-            ${PORT} 2 1EAF:${USB_PID} 
-            ${TARGET_PATH}.bin
+            ${PLATFORM_PATH}/tools/esptool/esptool.py --chip esp32 --port "/dev/${ARDUINO_DEFAULT_PORT}" --baud ${ESP32_USB_UPLOAD_SPEED}  --before default_reset --after hard_reset write_flash -z --flash_mode ${ESP32_FLASH_MODE} --flash_freq ${ESP32_FLASH_SPEED} --flash_size detect 0xe000 "${PLATFORM_PATH}/tools/partitions/boot_app0.bin" 0x1000 "${PLATFORM_PATH}/tools/sdk/bin/bootloader_${ESP32_FLASH_MODE_BOOTLOADER}_${ESP32_FLASH_SPEED}.bin"  0x10000 ${TARGET_NAME}.img.bin 0x8000 "${TARGET_NAME}.partitions.bin"
             DEPENDS ${TARGET_NAME})
 
     # Global upload target
@@ -48,5 +28,4 @@ function(create_arduino_bootloader_upload_target TARGET_NAME BOARD_ID PORT AVRDU
     endif ()
 
     add_dependencies(upload ${UPLOAD_TARGET})
-    ENDIF(FALSE)
 endfunction()

Platform/Core/Targets/ArduinoFirmwareTargetCreatorEsp32.cmake

@@ -47,14 +47,29 @@ function(create_arduino_firmware_target TARGET_NAME BOARD_ID ALL_SRCS ALL_LIBS
         set(EXECUTABLE_OUTPUT_PATH ${CMAKE_CURRENT_BINARY_DIR})
     endif ()
 
-    dump_all() 
+    #dump_all() 
 
       # Display target size
 #    add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
             #COMMAND ${PLATFORM_TOOLCHAIN_PATH}/${ESP32_TOOLCHAIN_PREFIX}size
             #ARGS -A=${TARGET_NAME}.elf
             #COMMENT "Calculating image size"
             #VERBATIM)
+  add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
+            COMMAND cp ${PLATFORM_PATH}//tools/partitions/default.csv partitions.csv
+            COMMENT "Copying partitions bin scheme"
+            VERBATIM)
 
+
+
+    add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
+            COMMAND python ${PLATFORM_PATH}/tools/gen_esp32part.py --flash-size ${ESP32_FLASH_SIZE}MB -q partitions.csv ${TARGET_NAME}.partitions.bin
+            COMMENT "Generating partitions bin image"
+            VERBATIM)
+
+     add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
+            COMMAND python ${PLATFORM_PATH}/tools/esptool/esptool.py --chip esp32 elf2image --flash_mode ${ESP32_FLASH_MODE} --flash_freq ${ESP32_FLASH_SPEED} --flash_size ${ESP32_FLASH_SIZE}MB -o ${TARGET_NAME}.img.bin ${TARGET_NAME}.elf
+            COMMENT "Generating bin image"
+            VERBATIM)
 
 endfunction()

Platform/Core/Targets/ArduinoFirmwareTargetCreatorStm32.cmake

@@ -54,11 +54,21 @@ function(create_arduino_firmware_target TARGET_NAME BOARD_ID ALL_SRCS ALL_LIBS
 
     # depending on the upload method we use different ld script
     # let's hardcode to bootloader for now 
-    if( DEFINED ${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript  )
-        SET(BOOTLOADER_LINK_OPT  "-T${RUNTIME_FILES_PATH}/${${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript} ") # Hack
-    else( DEFINED ${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript  )
-        SET(BOOTLOADER_LINK_OPT  "-T${RUNTIME_FILES_PATH}/${${BOARD_ID}.menu.cpu.bootloader20.build.ldscript} ") # Hack
-    endif( DEFINED ${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript  )
+    #dump_all()
+    # Check for blackMagic
+    IF(ARDUINO_UPLOAD_METHOD MATCHES "BMP")
+            IF(NOT DEFINED ARDUINO_LD_FILE)
+                SET(BOOTLOADER_LINK_OPT  "-T${RUNTIME_FILES_PATH}/ld/jtag_c8.ld ") # Hack
+            ELSE(NOT DEFINED ARDUINO_LD_FILE)
+                SET(BOOTLOADER_LINK_OPT  "-T${RUNTIME_FILES_PATH}/ld/${ARDUINO_LD_FILE}.ld ") # Hack
+            ENDIF(NOT DEFINED ARDUINO_LD_FILE)
+    ELSE()
+        if( DEFINED ${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript  )
+            SET(BOOTLOADER_LINK_OPT  "-T${RUNTIME_FILES_PATH}/${${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript} ") # Hack
+        else( DEFINED ${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript  )
+            SET(BOOTLOADER_LINK_OPT  "-T${RUNTIME_FILES_PATH}/${${BOARD_ID}.menu.cpu.bootloader20.build.ldscript} ") # Hack
+        endif( DEFINED ${BOARD_ID}.menu.cpu.DFUUploadMethod.build.ldscript  )
+    ENDIF()
 
     SET(BOOTLOADER_LINK_OPT  "${BOOTLOADER_LINK_OPT} -L${RUNTIME_FILES_PATH}/ld") # Hack
     MESSAGE(STATUS "Bootloader : <${BOOTLOADER_LINK_OPT}>")
@@ -124,14 +134,14 @@ function(create_arduino_firmware_target TARGET_NAME BOARD_ID ALL_SRCS ALL_LIBS
             VERBATIM)
 #_get_board_property(${BOARD_ID} build.mcu MCU)
     # Display target size
-    add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
-            COMMAND ${CMAKE_COMMAND}
-            ARGS -DFIRMWARE_IMAGE=${TARGET_NAME}.elf
-            -DMCU=atmega1280
+    #add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
+            #COMMAND ${CMAKE_COMMAND}
+            #ARGS -DFIRMWARE_IMAGE=${TARGET_NAME}.elf
+            #-DMCU=atmega1280
             #-DEEPROM_IMAGE=${TARGET_PATH}.eep
-            -P ${ARDUINO_SIZE_SCRIPT}
-            COMMENT "Calculating image size"
-            VERBATIM)
+            #-P ${ARDUINO_SIZE_SCRIPT}
+            #COMMENT "Calculating image size"
+            #VERBATIM)
 
 
 endfunction()

Platform/Generation/ArduinoLibraryGenerator.cmake

@@ -4,7 +4,7 @@
 # see documentation at README
 #=============================================================================#
 function(generate_arduino_library INPUT_NAME)
-    message(STATUS "Generating ${INPUT_NAME}")
+    message(STATUS "Generating Library ${INPUT_NAME}")
     parse_generator_arguments(${INPUT_NAME} INPUT
             "NO_AUTOLIBS;MANUAL"                  # Options
             "BOARD;BOARD_CPU"                     # One Value Keywords
@@ -27,29 +27,21 @@ function(generate_arduino_library INPUT_NAME)
     set(ALL_LIBS)
     set(ALL_SRCS ${INPUT_SRCS} ${INPUT_HDRS})
 
-    if (NOT INPUT_MANUAL)
-        make_core_library(CORE_LIB ${BOARD_ID})
-    endif ()
 
     find_arduino_libraries(TARGET_LIBS "${ALL_SRCS}" "")
     set(LIB_DEP_INCLUDES)
     foreach (LIB_DEP ${TARGET_LIBS})
-        set(LIB_DEP_INCLUDES "${LIB_DEP_INCLUDES} -I\"${LIB_DEP}\"")
+        LIST(APPEND LIB_DEP_INCLUDES ${LIB_DEP})
     endforeach ()
 
-    if (NOT ${INPUT_NO_AUTOLIBS})
-        make_arduino_libraries(ALL_LIBS ${BOARD_ID} "" "${LIB_DEP_INCLUDES}" "")
-    endif ()
-
     list(APPEND ALL_LIBS ${CORE_LIB} ${INPUT_LIBS})
 
     add_library(${INPUT_NAME} ${ALL_SRCS})
 
     set_board_flags(ARDUINO_COMPILE_FLAGS ARDUINO_LINK_FLAGS ${BOARD_ID} ${INPUT_MANUAL})
 
-    set_target_properties(${INPUT_NAME} PROPERTIES
-            COMPILE_FLAGS "${ARDUINO_COMPILE_FLAGS} ${COMPILE_FLAGS} ${LIB_DEP_INCLUDES}"
-            LINK_FLAGS "${ARDUINO_LINK_FLAGS} ${LINK_FLAGS}")
-
-    target_link_libraries(${INPUT_NAME} ${ALL_LIBS} "-lc -lm")
+    separate_arguments(my_ARDUINO_COMPILE_FLAGS UNIX_COMMAND "${ARDUINO_COMPILE_FLAGS}")
+    target_compile_options( ${INPUT_NAME} PRIVATE ${my_ARDUINO_COMPILE_FLAGS} )
+    target_compile_options( ${INPUT_NAME} PRIVATE  ${COMPILE_FLAGS} )
+    target_include_directories(${INPUT_NAME} PUBLIC ${LIB_DEP_INCLUDES})
 endfunction()

Platform/Initialization/DefaultCFlagsStm32.cmake

@@ -7,8 +7,12 @@ ENDIF(NOT DEFINED ARDUINO_UPLOAD_METHOD)
 
 IF(NOT DEFINED ARDUINO_CFLAGS_SET)
     SET(DEFINED ARDUINO_CFLAGS_SET 1)
+    IF(NOT DEFINED MCU_SPEED )
+        SET(MCU_SPEED 72000000L)
+    ENDIF(NOT DEFINED MCU_SPEED )
+    
     SET(ARDUINO_DEFAULT_CFLAGS " -ffunction-sections -fdata-sections -nostdlib --param max-inline-insns-single=500  -w   -mcpu=cortex-m3  -mthumb   -g ")
-    SET(ARDUINO_DEFAULT_CFLAGS " ${ARDUINO_DEFAULT_CFLAGS}  -DF_CPU=72000000L  -DARDUINO_ARCH_STM32F1 -DCONFIG_MAPLE_MINI_NO_DISABLE_DEBUG    ")
+    SET(ARDUINO_DEFAULT_CFLAGS " ${ARDUINO_DEFAULT_CFLAGS}  -DGENERIC_BOOTLOADER -DF_CPU=${MCU_SPEED}L  -DARDUINO_ARCH_STM32F1 -DCONFIG_MAPLE_MINI_NO_DISABLE_DEBUG    ")
     #SET(ARDUINO_DEFAULT_CFLAGS " ${ARDUINO_DEFAULT_CFLAGS}  -DF_CPU=72000000L  -DARDUINO_ARCH_STM32F1 ")
 
     SET(ARDUINO_DEFAULT_CXXFLAGS "${ARDUINO_DEFAULT_CFLAGS} -fno-rtti  -fno-exceptions -std=gnu++11   -Werror=return-type")

README.rst

@@ -1,33 +1,33 @@
+This is a fork of the original arduino-cmake project, but targetted at STM32duino and ESP32duino (WIP for ESP32)
 
 
-(it's easy to extend to others)
+**STM32 Installation :** 
 
-Installation : 
-
-- Install a toolchain. Simplest is to use the arduino ide and install either SAM Board (32 bits ARM Cortex M3) or or STM32 cores by ST
-. The ST one is significantly more recent. Write down the path to the arm-none-eabi-gcc and friends
+- Install a toolchain.  I'd recommand using the arduino-stm32 toolchain available here https://github.com/stm32duino/arm-none-eabi-gcc . The code is about 50% smaller.
 
 - Install the Arduino STM32 files from here (https://github.com/rogerclarkmelbourne/Arduino_STM32). Either put the files in ARDUINO_SDK/harwdare/arduino or anywhere else you want.
-That last folder *must* be  named arduino (i.e. /foo/bar/arduino/STM32F1 /foo/bar/arduino/drivers...)
-
-- Be sure you have a STLINKv2 clone and that you know how to reflash the bootloader
-(i.e. cd /opt/arduino-1.8.5/hardware/STM32/arduino/tools/linux64/stlink && ./st-flash  write ~/Arduino_stm32/STM32duino-bootloader/binaries/generic_boot20_pc13.bin 0x8000000)
-
-- Copy the example/stm32 content somewhere so that you have
- Cmakelists.txt
- Hello.ino
- cmake/   (symlink to the cmake subfolder of arduino-cmake, or just copy it)
-
-- Change the cmakelists.txt and use paths you noted before (toolchain &  arduino STM32 file in the  example)
-
+Note down the full path to the STM32 F1 folder
+- Be sure you have a STLINKv2 clone and that you know how to reflash the bootloader. (i.e. cd /opt/arduino-1.8.5/hardware/STM32/arduino/tools/linux64/stlink && ./st-flash  write ~/Arduino_stm32/STM32duino-bootloader/binaries/generic_boot20_pc13.bin 0x8000000)
+
+    - Copy the example/stm32 content somewhere so that you have a structure like 
+|    Cmakelists.txt 
+|    Hello.ino 
+|    cmake/   (symlink to the cmake subfolder of arduino-cmake-stm32, or just copy it) 
+
+    - Change the cmakelists.txt and use paths you noted before (toolchain &  arduino STM32 file in the  example)
+   e.g. 
+|    # TOOLCHAIN |
+|    SET(PLATFORM_TOOLCHAIN_PATH "/home/fx/Arduino_stm32/arm-none-eabi-gcc/download/gcc-arm-none-eabi-8.2.1-1.7/bin") |
+|    # STM32Duino, point to the STM32F1 subfolder |
+|    SET(PLATFORM_PATH "/home/fx/Arduino/hardware/stm32/STM32F1") 
+    
 - cmake .. && make
 
 You now have the elf & bin files that you can upload manually
 
- /opt/arduino-1.8.5/hardware/Arduino_STM32-master/tools/linux/maple_upload ttyACM0 2 1EAF:0003 the_file.bin
+  /opt/arduino-1.8.5/hardware/Arduino_STM32-master/tools/linux/maple_upload ttyACM0 2 1EAF:0003 the_file.bin
 
 1EAF:0003 is the usb id, it can change a bit, mine is 1eaf:0004, lsusb will tell you what you have
 
 Important: 
-  - Normally, the compatibility is kept for avr boards too. So you can use the same cmake setup for both AVR and STM32 boards.
   - Tested only on linux, might not work well on OsX and Windows

example/esp32/Blink.ino

@@ -0,0 +1,37 @@
+/*
+  Blink
+
+  Turns an LED on for one second, then off for one second, repeatedly.
+
+  Most Arduinos have an on-board LED you can control. On the UNO, MEGA and ZERO
+  it is attached to digital pin 13, on MKR1000 on pin 6. LED_BUILTIN is set to
+  the correct LED pin independent of which board is used.
+  If you want to know what pin the on-board LED is connected to on your Arduino
+  model, check the Technical Specs of your board at:
+  https://www.arduino.cc/en/Main/Products
+
+  modified 8 May 2014
+  by Scott Fitzgerald
+  modified 2 Sep 2016 
+  by Arturo Guadalupi
+  modified 8 Sep 2016
+  by Colby Newman
+
+  This example code is in the public domain.
+
+  http://www.arduino.cc/en/Tutorial/Blink
+*/
+#define LED_BUILTIN 2
+// the setup function runs once when you press reset or power the board
+void setup() {
+  // initialize digital pin LED_BUILTIN as an output.
+  pinMode(LED_BUILTIN, OUTPUT);
+}
+
+// the loop function runs over and over again forever
+void loop() {
+  digitalWrite(LED_BUILTIN, HIGH);   // turn the LED on (HIGH is the voltage level)
+  delay(1000);                       // wait for a second
+  digitalWrite(LED_BUILTIN, LOW);    // turn the LED off by making the voltage LOW
+  delay(1000);                       // wait for a second
+}