Mercurial > public > ostc4
annotate wiki/Detailed CPU1-Discovery Project.md @ 787:aeb72882f30a
Dev Bugfx Empty buffer indication and stability improvments:
The mux prototype used ASCII coding for channel selection while the current realization used real number (0...4) for addressing the mux. The UART read function uses the '0' to indicate an empty buffer element. The mux now loops back '0' used by channel selection causing the read function to process the data. As result data interrups are visible at the display. To avoid this another character has been defined indicate empty buffer locations.
Beside this the functionality has been improved with regard to access speed and better recovery in case of transition failure.
| author | Ideenmodellierer |
|---|---|
| date | Sun, 04 Jun 2023 21:59:26 +0200 |
| parents | 8d95bab5bf6a |
| children |
| rev | line source |
|---|---|
| 489 | 1 # How to Create From Scratch a Project for _CPU1-Discovery_ Code # |
| 2 | |
| 3 The OpenSTM32 wiki have a [page](http://www.openstm32.org/Getting%2Bstarted%2Bwith%2BSystem%2BWorkbench%2Bfor%2BSTM32) to start a project from scratch. With the latest version of every support libraries and sources from ST. But here I prefer to have a project with the support files validated (and compatible) with the _OSTC4_ code. | |
| 4 | |
| 5 ## Start with an Empty Project ## | |
| 6 | |
| 7 **Special Notes**: | |
| 8 | |
| 9 - _Linux_ users should read about this **well known _Eclipse_ bug** : http://www.openstm32.org/faq1#q22 | |
| 10 - We do have a _STM32F427IIT6_ chip as CPU1. But the support file provided by _ST_ lake for _LCD TFT Display Controller_ (aka LTDC), even in the latest available version 1.7.2 from 2017-11-06... So we use the STM32F429IITx support file instead, that seems to be similar enough. | |
| 11 | |
| 12 In the following description, I suppose you used _mercurial_ to clone the sources into a **D:\Dev\OSTC4** directory. Make the changes for your own settings... | |
| 13 | |
| 14 0. Start the IDE. On most machine it will be the `eclipse` in the _Ac6_ folder you installed. | |
| 15 1. Create an empty project: `File` > `New` > `C Project` | |
| 16 2. Choose `AC6 STM32 MCU Project` and `AC6 STM32 MCU GCC`. Click `Next` | |
| 17 Note: **make sure NOT TO CLICK FINISH... as it will skip all the rest of the configuration wizard !** | |
| 18 3. Keep `Debug` and `Release` configurations. Click `Next` | |
| 19 4. Create a new board, that you can name **OSTC4-CPU1-F429**, by choosing: | |
| 20 > Series: `STM32F4` | |
| 21 > Mcu: `STM32F429IITx` | |
| 22 > Debug: `JTAG` | |
| 23 Click `Next`. | |
| 24 5. Keep `No firmware` and select `Don't generate startup files`. Then click `Finish` | |
| 25 | |
| 26 ## Configure Various Settings ## | |
| 27 | |
| 28 1. In the _C/C++ Projects_ explorer, select your project top-level folder | |
| 29 2. Right on it, select `Properties`, `Resource` and set `Text file encoding` to **UTF-8** | |
| 30 3. Right on it, select `Properties`, `Resource` then `Linked Resources` and click on `New...` to define a new variable **OSTC4** that points to your source folder **D:\Dev\OSTC4** (or whatever path you used on your system). | |
| 31 This should allow to change the project's origin with a single variable change. | |
| 32 | |
| 33 # Add Sources Folders # | |
| 34 | |
| 35 1. In the _C/C++ Projects_ explorer, select your project top-level folder | |
| 36 2. Right-click to add a `New` > `Folder`. In `Advanced settings >` click `Link to alternate location` and then the `Variables...` button. Click on the **OSTC4** variable, then click `Extend...` and select the **Common\\** sub-directory. Click `Finish` | |
| 37 3. Do the same to import the linked folder **OSTC4\Discovery** | |
| 38 | |
| 39 ## Make _Eclipse_ aware you just added sources, not junk ## | |
| 40 | |
| 41 (_Note: this step is only useful on specific versions of Eclipse. And already done by default on others..._) | |
| 42 | |
| 43 1. In the _C/C++ Projects_ explorer, open your project top-level project. | |
| 44 2. Right click on the `Common` folder, select `Resource Configurations...`, and `Exclude from build`. Make sure to UNCHECK both `Debug` and `Release` check-boxes. | |
| 45 3. Do the same for the `Discovery` folder. | |
| 46 | |
| 47 ## Make _Eclipse_ aware not to compile templates ## | |
| 48 | |
| 49 Some sources or directories in the _ST_ distribution contains source you shall not compile. So you should tell _OSE_. | |
| 50 | |
| 51 1. In the _Project Explorer_, open item `Common/Drivers/STM32F4xx_HAL_DRIVER_v120/Src`. Right click on `stm32f4xx_hal_msp_template.c`source file, select `Resource Configurations...`, and `Exclude from build`. Make sure both `Debug` and `Release` check-boxes are CHECKED. | |
| 52 2. Do the same on the `Common/Drivers/STM32F4xx_v220/Source/Templates` directory. | |
| 53 | |
| 54 # Compile # | |
| 55 | |
| 56 1. Select your top-level project, right-click to edit `properties`. In `C/C++ Build` choose `Settings`, then `MCU GCC Compiler` and `Optimization`. Choose `Optimization Level`: -Os (To reduce flash time) | |
| 57 | |
| 58 Ok, sources are there. You can read them. But you need a few more efforts to let the IDE find everything he requires to compile _CPU1 Discovery_ firmware. | |
| 59 | |
| 60 ## Add include paths ## | |
| 61 | |
|
568
1eee6fb108cb
Minor: Update the documentation for building the code
heinrichsweikamp
parents:
489
diff
changeset
|
62 1. Select your top-level project, right-click to edit `properties`. In `C/C++ Build` choose `Settings`, then `MCU GCC Compiler` and `Includes`. **Make sure to select `Configuration: [All Configurations]` **. Click `Add...` choose `Workspace...` and select the `Common/Drivers/CMIS/Include` directory. |
|
1eee6fb108cb
Minor: Update the documentation for building the code
heinrichsweikamp
parents:
489
diff
changeset
|
63 2. Do the same for `Common/Drivers/STM32F4xx/Include` directory. |
|
1eee6fb108cb
Minor: Update the documentation for building the code
heinrichsweikamp
parents:
489
diff
changeset
|
64 3. Do the same for `Common/Drivers/STM32F4xx_HAL_DRIVER/Inc` directory. |
| 489 | 65 4. Do the same for `Common/Inc` directory. |
| 66 5. Do the same for `Discovery/Inc` directory. | |
| 67 6. Use the _Move Up_ icon to make sure `Discovery/Inc` is first. | |
| 68 7. Use the `Configuration:` pop-up to check you have all the includes in both `Debug` and `Release` configuration. | |
| 69 | |
| 70 Once done, If you go to the _C/C++ Projects explorer_, open your top-level project, and open the `Includes` item, you should see: | |
| 71 | |
| 72 - a few lines added by the system `.../Ac6/Workbench/plugins/.../compiler/...` with include paths required by the GCC compiler. | |
| 73 - then your 5 include directories (shown in alphabetic order, not priority order... too bad). Make sure to open each of them and to double-click on a .h file to check it opens correctly in the IDE. | |
| 74 | |
| 75 ## Add Link Options ## | |
| 76 | |
| 77 1. Select your top-level project, right-click to edit `properties`. In `C/C++ Build` choose `Settings`, then `MCU G++ Linker` and `General`. | |
| 78 And select _linker Script_: `OSTC4/Common/CPU1-F429.ld` | |
| 79 2. In `C/C++ Build` choose `Settings`, then `MCU GCC Linker` and `Miscellaneous`. Add option -u _printf_float in Linker flags. This is necessary to prevent IDE warning "The float formatting support (-u _printf_float) is not enabled from linker flags". | |
| 80 | |
| 81 ## Prepare generation of bin file ## | |
| 82 1. Select your top-level project, right-click to edit `properties`. In `C/C++ Build` choose `Settings`, then tab `Build Steps` and `Post build step command`. | |
|
589
8d95bab5bf6a
Minor: Update the documentation for building the code
heinrichsweikamp
parents:
568
diff
changeset
|
83 2. Add option -R .upper\* and -R.font_firmware_data to the command to removed the upper memory section, which is provided by the font library =>arm-none-eabi-objcopy -R .upper\* -R.font_firmware_data -O binary "${BuildArtifactFileBaseName}.elf" "${BuildArtifactFileBaseName}.bin"; arm-none-eabi-size "${BuildArtifactFileName}" |
| 489 | 84 |
| 85 ## Build ELF firmware ## | |
| 86 | |
| 87 1. Click the `Build` button (hammer icon) on the top bar. |