diff options
Diffstat (limited to 'Projects/NUCLEO-WB15CC/Templates_LL/readme.txt')
-rw-r--r-- | Projects/NUCLEO-WB15CC/Templates_LL/readme.txt | 88 |
1 files changed, 88 insertions, 0 deletions
diff --git a/Projects/NUCLEO-WB15CC/Templates_LL/readme.txt b/Projects/NUCLEO-WB15CC/Templates_LL/readme.txt new file mode 100644 index 000000000..989fff4ef --- /dev/null +++ b/Projects/NUCLEO-WB15CC/Templates_LL/readme.txt @@ -0,0 +1,88 @@ +/** + @page Templates_LL Description of the Templates_LL example + + @verbatim + ****************************************************************************** + * @file Templates_LL/readme.txt + * @author MCD Application Team + * @brief Description of the Templates_LL example. + ****************************************************************************** + * @attention + * + * Copyright (c) 2019 STMicroelectronics. + * All rights reserved. + * + * This software is licensed under terms that can be found in the LICENSE file + * in the root directory of this software component. + * If no LICENSE file comes with this software, it is provided AS-IS. + * + ****************************************************************************** + @endverbatim + +@par Example Description + +This projects provides a reference template through the LL API that can be used to build any firmware application. + +This project LL template provides: + - Inclusion of all LL drivers (include files in "main.h" and LL sources files in IDE environment, with option "USE_FULL_LL_DRIVER" in IDE environment) + Note: If optimization is needed afterwards, user can perform a cleanup by removing unused drivers. + - Definition of LEDs and user button (file: main.h) + Note: User button name printed on board may differ from naming "user button" in code: "key button", ... + - Clock configuration (file: main.c) + +This project LL template does not provide: + - Functions to initialize and control LED and user button + - Functions to manage IRQ handler of user button + +To port a LL example to the targeted board: +1. Select the LL example to port. + To find the board on which LL examples are deployed, refer to LL examples list in "STM32CubeProjectsList.html", table section "Examples_LL" + or AN : STM32Cube firmware examples for stm32wbxx Series + +2. Replace source files of the LL template by the ones of the LL example, except code specific to board. + Note: Code specific to board is specified between tags: + /* ============== BOARD SPECIFIC CONFIGURATION CODE BEGIN ============== */ + /* ============== BOARD SPECIFIC CONFIGURATION CODE END ============== */ + + - Replace file main.h, with updates: + - Keep LED and user button definition of the LL template under tags + + - Replace file main.c, with updates: + - Keep clock configuration of the LL template: function "SystemClock_Config()" + - Depending of LED availability, replace LEDx_PIN by another LEDx (number) available in file main.h + + - Replace file stm32wbxx_it.h + - Replace file stm32wbxx_it.c + + +@par Keywords + +Template LL, + +@par Directory contents + + - Templates_LL/Inc/stm32wbxx_it.h Interrupt handlers header file + - Templates_LL/Inc/main.h Header for main.c module + - Templates_LL/Inc/stm32_assert.h Template file to include assert_failed function + - Templates_LL/Src/stm32wbxx_it.c Interrupt handlers + - Templates_LL/Src/main.c Main program + - Templates_LL/Src/system_stm32wbxx.c STM32WBxx system source file + + +@par Hardware and Software environment + + - This example runs on STM32WB15xx devices. + + - This example has been tested with NUCLEO-WB15CC board and can be + easily tailored to any other supported device and development board. + + +@par How to use it ? + +In order to make the program work, you must do the following : + - Open your preferred toolchain + - Rebuild all files and load your image into target memory + - Run the example + + * <h3><center>© COPYRIGHT STMicroelectronics</center></h3> + */ |