# 2.3 FIRST STM32 Project - Hello World As any other programming languages, our first STM32 Project is also "Hello World", without hardware wiring. Using GNU MCU Eclipse to develop STM32 follows the same way to develop any other projects under Eclipse. ## 2.3.1 Steps to Build Our First Empty Project ### A. Create an Empty Project **File**->**New**->**C/C++ Project**, then click on **C++ Managed Build**: ![Eclipse A New Project](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCWKKCpC6ZroDJb0x95%2F-LCWKL4uJRjgTWZ5AALY%2FEclipse_01_New_Project.jpg?generation=1526346379629360\&alt=media) Then, click **Next**. ### B. Select STM32F7XX C/C++ Project In the dialog **C++ Project**, * under **Project type:**->**Executable**, select **STM32F7XX C/C++ Project** * under **Project name:**, input **Hello World** ![Eclipse Create A STM32F7XX Project](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCWKKCpC6ZroDJb0x95%2F-LCWKL6yWNXSVMinOt9U%2FEclipse_02_New_Project_STM32F7XX.jpg?generation=1526346379711695\&alt=media) Then, click **Next**. ### C. Target Processor Settings In the dialog **Target Processor Settings**， * under **Chip family**, select **STM32F767xx** * under **Flash size (kB):**, make sure it's **2048** * under **External clock (Hz):"**, make sure it's **8000000** * under **Content:**, select **Empty (add your own content)** * under **Use system calls:**, select **Freestanding (no POSIX system calls)** ![Eclipse Target Processor Settings](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCpwHpYkJa0k4gFyQn3%2F-LCVFW8RysVVQZG2pPVW%2FEclipse_03_Target_Processor_Settings.jpg?generation=1526692162576868\&alt=media) Then, click **Next**. ### D. Folder settings ![Eclipse Folders Settings](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCVFVQ5B8EZ79E8dWio%2F-LCVFW8yGLORQ2iOMSTy%2FEclipse_04_Folders_Settings.jpg?generation=1526328336339310\&alt=media) Just click **Next**. ### E. Select Configurations ![Eclipse Select Configurations](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCVFVQ5B8EZ79E8dWio%2F-LCVFW9ZIwlzW7uWqdkz%2FEclipse_05_Select_Configurations.jpg?generation=1526328334387060\&alt=media) Just click **Next**. ### F. GNU ARM Cross Toolchain In the dialog **GNU ARM Cross Toolchain**, * under **Toolchain name:**, select **GNU MCU Eclipse ARM Embedded GCC (arm-none-eabi-gcc)** * under **Toolchain path:**, make sure you put the correct **toolchain directory**. In our case: ``` $ ls /opt/GCCToolChains/gnu-mcu-eclipse/arm-none-eabi-gcc/7/bin arm-none-eabi-addr2line arm-none-eabi-elfedit arm-none-eabi-gcc-ranlib arm-none-eabi-gprof arm-none-eabi-ranlib arm-none-eabi-ar arm-none-eabi-g++ arm-none-eabi-gcov arm-none-eabi-ld arm-none-eabi-readelf arm-none-eabi-as arm-none-eabi-gcc arm-none-eabi-gcov-dump arm-none-eabi-ld.bfd arm-none-eabi-size arm-none-eabi-c++ arm-none-eabi-gcc-7.2.1 arm-none-eabi-gcov-tool arm-none-eabi-nm arm-none-eabi-strings arm-none-eabi-c++filt arm-none-eabi-gcc-ar arm-none-eabi-gdb arm-none-eabi-objcopy arm-none-eabi-strip arm-none-eabi-cpp arm-none-eabi-gcc-nm arm-none-eabi-gdb-py arm-none-eabi-objdump ``` ![Eclipse GNU ARM Cross Toolchain](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCpwHpYkJa0k4gFyQn3%2F-LCVFWABooMZqlZ0d5hO%2FEclipse_06_GNU_ARM_Cross_Toolchain.jpg?generation=1526692143868783\&alt=media) Finally, click **Finish**. ### G. Build the Empty Project Now, let's have a look at the empty project's code: ``` #include #include #include "diag/Trace.h" // ---------------------------------------------------------------------------- // // Standalone STM32F7 empty sample (trace via DEBUG). // // Trace support is enabled by adding the TRACE macro definition. // By default the trace messages are forwarded to the DEBUG output, // but can be rerouted to any device or completely suppressed, by // changing the definitions required in system/src/diag/trace_impl.c // (currently OS_USE_TRACE_ITM, OS_USE_TRACE_SEMIHOSTING_DEBUG/_STDOUT). // // ----- main() --------------------------------------------------------------- // Sample pragmas to cope with warnings. Please note the related line at // the end of this function, used to pop the compiler diagnostics status. #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wunused-parameter" #pragma GCC diagnostic ignored "-Wmissing-declarations" #pragma GCC diagnostic ignored "-Wreturn-type" int main(int argc, char* argv[]) { // At this stage the system clock should have already been configured // at high speed. // Infinite loop while (1) { // Add your code here. } } #pragma GCC diagnostic pop // ---------------------------------------------------------------------------- ``` Then, we **Build Project**, ![Eclipse Built Empty Project](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCWX3kOFeyCUKO69jmI%2F-LCWX58hBHq7ZUjfFnX-%2FEclipse_07_Built_Empty_Project.jpg?generation=1526349721778688\&alt=media) ## 2.3.2 Steps to Build "Hello World" ### A. Code Modification In file **main.cpp**, add one line **printf("Hello World!\n");** under **Add your code here.** as: ``` // Add your code here. printf("Hello World!\n"); ``` ### B. Build Project - Failure ![Eclipse Built Failure](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCWfmnadoU_MQ2vyGyj%2F-LCWfoTjzXPgnNH6sAkI%2FEclipse_08_Built_Failure.jpg?generation=1526352270614523\&alt=media) Why? In the next step, we are going to solve the problem. ### C. --specs=nosys.specs To build the project successfully, we need to set **--specs=nosys.specs**. But, how to? **HelloWorld**->**Properties**->**C/C++ Build**->**Settings**->**Tool Settings**->**GNU ARM Cross C++ Linker**->**Miscellaneous**, and tick **Do not use syscalls(-specs=nosys.specs)**. ![--specs=nosys.specs](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LD0Wx85oTtfYwbd9xUA%2F-LCWfoaJTlwL4Sa1wcSs%2FEclipse_09_Project_Properties_C%2B%2BBuild_Settings_ToolSettings_Linker_Miscellaneous.jpg?generation=1526886555644278\&alt=media) Then, we **Apply**. ### D. Devices STM32F767ZI Then, we move to **Devices** tab, and we found **STM32F767ZI**. ![Devices STM32F767ZI](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCjVmaOEb-DtW_VesGH%2F-LCjVo3ctU1GN5s0TPig%2FSettings_Devices_STM32F767ZI.jpg?generation=1526584267179933\&alt=media) Then, we **Apply and Close**. ### E. Build Project Again - Successful ![Eclipse Successfully Built](https://2173079646-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBY-O3HDo-2Fw4hRMUa%2F-LCWfmnadoU_MQ2vyGyj%2F-LCWfogOqf8pD6Q5bk1P%2FEclipse_10_Successfully_Built.jpg?generation=1526352270516092\&alt=media)