Back to Release page

Release Notes for STM32F4-Discovery Board Drivers

Copyright © 2017 STMicroelectronics

 

The BSP (Board Specific Package) drivers are parts of the STM32Cube package based on the HAL drivers and provide a set of high level APIs relative to the hardware components and features in the evaluation boards, discovery kits and nucleo boards coming with the STM32Cube package for a given STM32 serie.

The BSP drivers allow a quick access to the boards’ services using high level APIs and without any specific configuration as the link with the HAL and the external components is done in intrinsic within the drivers.

From project settings points of view, user has only to add the necessary driver’s files in the workspace and call the needed functions from examples. However some low level configuration functions are weak and can be overridden by the applications if user wants to change some BSP drivers default behavior.

Update History

V2.1.3 / 21-September-2017

Main Changes

  • Remove date & version
  • Add general description of BSP drivers
  • stm32f4_discovery_audio.c/.h:
    • Aligned with PDM library v3.0.0 
  • Notes:
    • This version must be used with v3.0.0 of PDM library

V2.1.2 / 27-January-2017

Main Changes

  • Replace __PPP_CLK_ENABLE/DISABLE with __HAL_RCC_PPP_ENABLE/DISABLE
  • Add BSP_AUDIO_OUT_ClockConfig, BSP_AUDIO_OUT_MspInit and BSP_AUDIO_OUT_MspDeInit as weak functions
  • Add BSP_AUDIO_IN_ClockConfig, BSP_AUDIO_IN_MspInit and BSP_AUDIO_IN_MspDeInit as weak functions

V2.1.1 / 12-January-2016

Main Changes

  • General updates to fix doxygen errors
  • Add STM32F4-Discovery_BSP_User_Manual.chm file

V2.1.0 / 14-August-2015

Main Changes

  • stm32f4_discovery.c
    • Add AUDIO_IO_DeInit() function to align with BSP Components Common drivers V4.0.0

V2.0.4 / 02-March-2015

Main Changes

  • stm32f4_discovery.c/.h
    • Align to STM32F4xx HAL Driver V1.3.0 for __HAL_RCC_PPP_CLK_ENABLE() .

V2.0.3 / 10-December-2014

Main Changes

  • stm32f4_discovery_accelerometer.h
    • Change "\" by "/" in the include path to fix compilation issue under Linux
  • stm32f4_discovery_audio.c/.h
    • BSP_AUDIO_OUT_Init(): Fix limitation on the I2S clock configuration
    • Change "\" by "/" in the include path to fix compilation issue under Linux
  • stm32f4_discovery.c/.h
    • Change I2C_SPEED used define by BSP_I2C_SPEED
  • Miscellaneous comments update

V2.0.2 / 26-June-2014

Main Changes

  • stm32f4_discovery_audio.c/.h
    • BSP_AUDIO_OUT_Play(): uses the buffer size in byte instead of half-word
    • BSP_AUDIO_IN_PDMToPCM(): duplicates samples to make stereo audio stream (since a single microphone in mounted on STM32F4-Discovery)
    • I2S2_Init(): configures the I2S to clock the microphone at 1.024 MHz as required instead of 2.048MHz

V2.0.1 / 19-June-2014

Main Changes

  • stm32f4_discovery.c/.h
    • Enhance BSP_PB_Init() function by removing the call of __SYSCFG_CLK_ENABLE() already enabled in the HAL_GPIO_Init()
  • stm32f4_discovery_audio.c/.h
    • Add note that only the audio stereo format is supported
  • Comments clean up and typo corrections

V2.0.0 / 18-February-2014

Main Changes

  • Major update based on STM32Cube specification: drivers architecture and APIs modified vs. V1.1.2, and thus the 2 versions are not compatible.
  • This version has to be used only with STM32CubeF4 based development

V1.1.2 / 17-April-2012

Main Changes

  • All source files: license disclaimer text update and add link to the License file on ST Internet.

V1.1.1 / 30-December-2011

Main Changes

  • PDM Library moved from Utilities\STM32F4-Discovery to Utilities\STM32_Audio\Addons\PDM folder
  • All source files: update disclaimer to add reference to the new license agreement
  • stm32f4_discovery_audio_codec.c 
    • Audio_MAL_Init() function: DMA configuration changed as below
      • DMA_FIFOMode_Disable changed to DMA_FIFOMode_Enable
      • DMA_FIFOThreshold_1QuarterFull changed to DMA_FIFOThreshold_HalfFull

V1.1.0 / 28-October-2011

Main Changes

  • Add PDM audio software decoding Library drivers, used to decode and reconstruct the audio signal produced by MP45DT02 MEMS microphone from STMicroelectronics. For more details about this Library, please refer to document "PDM audio software decoding on STM32 microcontrollers (AN3998)".
  • stm32f4_discovery_audio_codec.c/.h: update to use DMA instead of Interrupt in I2S communication with the external codec.

V1.0.0 / 19-September-2011

Main Changes

  • First official version of the STM32F4-Discovery Board Drivers

License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  3. Neither the name of STMicroelectronics nor the names of its contributors may be used to endorse or promote products derived
       from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
For complete documentation on STM32 Microcontrollers visit www.st.com/STM32