Skip to content

Commit

Permalink
Release of X-CUBE-AZRTOS-H7 v2.1.0
Browse files Browse the repository at this point in the history
  • Loading branch information
ALABSTM committed Apr 15, 2022
1 parent 84ed811 commit 91525b1
Show file tree
Hide file tree
Showing 4,921 changed files with 1,188,367 additions and 121,266 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
12 changes: 10 additions & 2 deletions Drivers/BSP/STM32H735G-DK/License.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,11 @@
# Copyright (c) 2019 STMicroelectronics
Copyright 2019 STMicroelectronics. All rights reserved.

This software component is licensed by STMicroelectronics under the **BSD-3-Clause** license. You may not use this software except in compliance with this license. You may obtain a copy of the license [here](https://opensource.org/licenses/BSD-3-Clause).
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 the copyright holder 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.
41 changes: 41 additions & 0 deletions Drivers/BSP/STM32H735G-DK/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# BSP STM32H735G-DK Component

![latest tag](https://img.shields.io/github/v/tag/STMicroelectronics/stm32h735g-dk.svg?color=brightgreen)

## Overview

**STM32Cube** is an STMicroelectronics original initiative to ease developers' life by reducing efforts, time and cost.

**STM32Cube** covers the overall STM32 products portfolio. It includes a comprehensive embedded software platform delivered for each STM32 series.
* The CMSIS modules (core and device) corresponding to the ARM(tm) core implemented in this STM32 product.
* The STM32 HAL-LL drivers, an abstraction layer offering a set of APIs ensuring maximized portability across the STM32 portfolio.
* The BSP drivers of each evaluation, demonstration or nucleo board provided for this STM32 series.
* A consistent set of middleware libraries such as RTOS, USB, FatFS, graphics, touch sensing library...
* A full set of software projects (basic examples, applications, and demonstrations) for each board provided for this STM32 series.

Two models of publication are proposed for the STM32Cube embedded software:
* The monolithic **MCU Package**: all STM32Cube software modules of one STM32 series are present (Drivers, Middleware, Projects, Utilities) in the repository (usual name **STM32Cubexx**, xx corresponding to the STM32 series).
* The **MCU component**: each STM32Cube software module being part of the STM32Cube MCU Package, is delivered as an individual repository, allowing the user to select and get only the required software functions.

## Description

This **stm32h735g-dk** MCU component repository is one element of the **STM32CubeH7** MCU embedded software package, providing the **STM32H735G-DK** BSP BOARD component part.

## Release note

Details about the content of this release are available in the release note [here](https://htmlpreview.github.io/?https://github.com/STMicroelectronics/stm32h735g-dk/blob/main/Release_Notes.html).

## Compatibility information

Below is the list of the BSP *component* drivers to be used with this BSP *board* driver. It is **crucial** that you use a consistent set of CMSIS - HAL - BSP versions, as mentioned in [this](https://htmlpreview.github.io/?https://github.com/STMicroelectronics/STM32CubeH7/blob/master/Release_Notes.html) release note.

* [stm32-bsp-common](https://github.com/STMicroelectronics/stm32-bsp-common)
* [stm32-ft5336](https://github.com/STMicroelectronics/stm32-ft5336)
* [stm32-mx25lm51245g](https://github.com/STMicroelectronics/stm32-mx25lm51245g)
* [stm32-rk043fn48h](https://github.com/STMicroelectronics/stm32-rk043fn48h)
* [stm32-s70kl1281](https://github.com/STMicroelectronics/stm32-s70kl1281)
* [stm32-wm8994](https://github.com/STMicroelectronics/stm32-wm8994)

## Troubleshooting

Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) guide.
47 changes: 28 additions & 19 deletions Drivers/BSP/STM32H735G-DK/Release_Notes.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,14 @@
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>Release Notes for STM32H735G-DK BSP Drivers</title>
<style type="text/css">
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
</style>
<link rel="stylesheet" href="_htmresc/mini-st.css" />
<!--[if lt IE 9]>
Expand All @@ -29,23 +32,31 @@ <h1 id="release-notes-for-stm32h735g-dk-bsp-drivers"><strong>Release Notes for S
</center>
</div>
</div>
<h1 id="license">License</h1>
This software component is licensed by ST under BSD 3-Clause license, the “License”; You may not use this component except in compliance with the License. You may obtain a copy of the License at:
<center>
<a href="https://opensource.org/licenses/BSD-3-Clause">https://opensource.org/licenses/BSD-3-Clause</a>
</center>
<h1 id="purpose">Purpose</h1>
<p>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 series.</p>
<p>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.</p>
<p>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.</p>
</div>
<div class="col-sm-12 col-lg-8">
<h1 id="update-history">Update History</h1>
<section id="update-history" class="col-sm-12 col-lg-8">
<h1>Update History</h1>
<div class="collapse">
<input type="checkbox" id="collapse-section3" checked aria-hidden="true"> <label for="collapse-section3" aria-hidden="true"><strong>V1.2.0 / 29-January-2021</strong></label>
<div>
<input type="checkbox" id="collapse-section4" checked aria-hidden="true"> <label for="collapse-section4" aria-hidden="true"><strong>V1.2.1 / 11-February-2022</strong></label>
<h2 id="main-changes">Main Changes</h2>
<ul>
<li>All source files: update disclaimer to add reference to the new license agreement.</li>
<li>Modified the address calculation in the BSP_LCD_FillRGBRect() function when USE_DMA2D_TO_FILL_RGB_RECT is enabled to suppress the display of a distorted shape instead of a rectangle when trying to draw a rectangle with a bigger height.</li>
<li>Cache maintained operation is included in the BSP_LCD_FillRGBRect() function to solve the display issue when USE_DMA2D_TO_FILL_RGB_RECT is enabled.</li>
<li>Fix supported latency type and delete Deep power feature for external RAM.</li>
<li>Add check on the audio OUT device to select the appropriate Output Device in the BSP_AUDIO_OUT_Init() function.</li>
<li>Fix Hard Fault in the BSP_AUDIO_IN_Init() function by adding the WM8994_Probe() function at the appropriate place.</li>
<li>Fix OSPI memory erasing issue in the BSP_OSPI_NOR_Erase_Block() function.</li>
</ul>
</div>
<div class="collapse">
<input type="checkbox" id="collapse-section3" aria-hidden="true"> <label for="collapse-section3" aria-hidden="true"><strong>V1.2.0 / 29-January-2021</strong></label>
<div>
<h2 id="main-changes-1">Main Changes</h2>
<ul>
<li>Minor typo fixes in comments</li>
</ul>
<h2 id="dependencies">Dependencies</h2>
Expand All @@ -57,7 +68,7 @@ <h2 id="dependencies">Dependencies</h2>
<div class="collapse">
<input type="checkbox" id="collapse-section2" aria-hidden="true"> <label for="collapse-section2" aria-hidden="true"><strong>V1.1.0 / 29-September-2020</strong></label>
<div>
<h2 id="main-changes-1">Main Changes</h2>
<h2 id="main-changes-2">Main Changes</h2>
<ul>
<li>Add License.md file</li>
</ul>
Expand All @@ -69,14 +80,12 @@ <h2 id="dependencies-1">Dependencies</h2>
</div>
<div class="collapse">
<input type="checkbox" id="collapse-section1" aria-hidden="true"> <label for="collapse-section1" aria-hidden="true"><strong>V1.0.0 / 19-May-2020</strong></label>
<div>
<h2 id="main-changes-2">Main Changes</h2>
<h2 id="main-changes-3">Main Changes</h2>
<ul>
<li>First release of STM32H735G-DK BSP drivers in line with STM32Cube BSP drivers development guidelines (UM2298)</li>
</ul>
</div>
</div>
</div>
</section>
</div>
<footer class="sticky">
For complete documentation on <mark>STM32 Microcontrollers</mark> , visit: <span style="font-color: blue;"><a href="http://www.st.com/STM32">www.st.com</a></span>
Expand Down
12 changes: 5 additions & 7 deletions Drivers/BSP/STM32H735G-DK/stm32h735g_discovery.c
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,12 @@
******************************************************************************
* @attention
*
* <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
* All rights reserved.</center></h2>
* Copyright (c) 2019 STMicroelectronics.
* All rights reserved.
*
* This software component is licensed by ST under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
* 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.
*
******************************************************************************
*/
Expand Down Expand Up @@ -617,4 +616,3 @@ static void USART1_MspDeInit(UART_HandleTypeDef *huart)
/**
* @}
*/
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
16 changes: 7 additions & 9 deletions Drivers/BSP/STM32H735G-DK/stm32h735g_discovery.h
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,12 @@
******************************************************************************
* @attention
*
* <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
* All rights reserved.</center></h2>
* Copyright (c) 2019 STMicroelectronics.
* All rights reserved.
*
* This software component is licensed by ST under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
* 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.
*
******************************************************************************
*/
Expand Down Expand Up @@ -140,11 +139,11 @@ typedef struct
#endif

/**
* @brief STM32H735G_DK BSP Driver version number V1.2.0
* @brief STM32H735G_DK BSP Driver version number V1.2.1
*/
#define STM32H735G_DK_BSP_VERSION_MAIN (uint32_t)(0x01) /*!< [31:24] main version */
#define STM32H735G_DK_BSP_VERSION_SUB1 (uint32_t)(0x02) /*!< [23:16] sub1 version */
#define STM32H735G_DK_BSP_VERSION_SUB2 (uint32_t)(0x00) /*!< [15:8] sub2 version */
#define STM32H735G_DK_BSP_VERSION_SUB2 (uint32_t)(0x01) /*!< [15:8] sub2 version */
#define STM32H735G_DK_BSP_VERSION_RC (uint32_t)(0x00) /*!< [7:0] release candidate */
#define STM32H735G_DK_BSP_VERSION ((STM32H735G_DK_BSP_VERSION_MAIN << 24)\
|(STM32H735G_DK_BSP_VERSION_SUB1 << 16)\
Expand Down Expand Up @@ -283,4 +282,3 @@ void BSP_PB_IRQHandler(Button_TypeDef Button);
}
#endif
#endif /* STM32H735G_DK_H */
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
68 changes: 42 additions & 26 deletions Drivers/BSP/STM32H735G-DK/stm32h735g_discovery_audio.c
Original file line number Diff line number Diff line change
Expand Up @@ -130,13 +130,12 @@
******************************************************************************
* @attention
*
* <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
* All rights reserved.</center></h2>
* Copyright (c) 2019 STMicroelectronics.
* All rights reserved.
*
* This software component is licensed by ST under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
* 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.
*
******************************************************************************
*/
Expand Down Expand Up @@ -428,7 +427,22 @@ int32_t BSP_AUDIO_OUT_Init(uint32_t Instance, BSP_AUDIO_Init_t* AudioInit)
WM8994_Init_t codec_init;
/* Fill codec_init structure */
codec_init.InputDevice = (Audio_In_Ctx[0].State == AUDIO_IN_STATE_RESET) ? WM8994_IN_NONE : WM8994_IN_LINE1;
codec_init.OutputDevice = WM8994_OUT_HEADPHONE;
switch (AudioInit->Device)
{
case AUDIO_OUT_DEVICE_SPK_HP:
codec_init.OutputDevice = WM8994_OUT_SPEAKER;
break;
case AUDIO_OUT_DEVICE_AUTO:
codec_init.OutputDevice = WM8994_OUT_AUTO;
break;
case AUDIO_OUT_DEVICE_SPEAKER:
codec_init.OutputDevice = WM8994_OUT_SPEAKER;
break;
case AUDIO_OUT_DEVICE_HEADPHONE:
default:
codec_init.OutputDevice = WM8994_OUT_HEADPHONE;
break;
}
codec_init.Frequency = AudioInit->SampleRate;
codec_init.Resolution = (AudioInit->BitsPerSample == AUDIO_RESOLUTION_32B) ? WM8994_RESOLUTION_32b : WM8994_RESOLUTION_16b;
/* Convert volume before sending to the codec */
Expand Down Expand Up @@ -1927,25 +1941,29 @@ int32_t BSP_AUDIO_IN_Init(uint32_t Instance, BSP_AUDIO_Init_t* AudioInit)
#if (USE_AUDIO_CODEC_WM8994 == 1)
if (ret == BSP_ERROR_NONE)
{
WM8994_Init_t codec_init;

/* Fill codec_init structure */
codec_init.OutputDevice = (Audio_Out_Ctx[0].State == AUDIO_OUT_STATE_RESET) ? WM8994_OUT_NONE : WM8994_OUT_HEADPHONE;
codec_init.Frequency = AudioInit->SampleRate;
codec_init.Resolution = (AudioInit->BitsPerSample == AUDIO_RESOLUTION_32B) ? WM8994_RESOLUTION_32b : WM8994_RESOLUTION_16b;
codec_init.InputDevice = (AudioInit->Device == AUDIO_IN_DEVICE_ANALOG_MIC) ? WM8994_IN_LINE1 : WM8994_IN_MIC2;

/* Convert volume before sending to the codec */
codec_init.Volume = VOLUME_IN_CONVERT(AudioInit->Volume);
/* Initialize the codec internal registers */
if(Audio_Drv->Init(Audio_CompObj, &codec_init) < 0)
{
ret = BSP_ERROR_COMPONENT_FAILURE;
}
else
if (WM8994_Probe() == BSP_ERROR_NONE)
{
/* Update audio in context state */
Audio_In_Ctx[Instance].State = AUDIO_IN_STATE_STOP;
WM8994_Init_t codec_init;

/* Fill codec_init structure */
codec_init.OutputDevice = (Audio_Out_Ctx[0].State == AUDIO_OUT_STATE_RESET) ? WM8994_OUT_NONE : WM8994_OUT_HEADPHONE;
codec_init.Frequency = AudioInit->SampleRate;
codec_init.Resolution = (AudioInit->BitsPerSample == AUDIO_RESOLUTION_32B) ? WM8994_RESOLUTION_32b : WM8994_RESOLUTION_16b;
codec_init.InputDevice = (AudioInit->Device == AUDIO_IN_DEVICE_ANALOG_MIC) ? WM8994_IN_LINE1 : WM8994_IN_MIC2;

/* Convert volume before sending to the codec */
codec_init.Volume = VOLUME_IN_CONVERT(AudioInit->Volume);
/* Initialize the codec internal registers */
if(Audio_Drv->Init(Audio_CompObj, &codec_init) < 0)
{
ret = BSP_ERROR_COMPONENT_FAILURE;
}
else
{
/* Update audio in context state */
Audio_In_Ctx[Instance].State = AUDIO_IN_STATE_STOP;
}
}
}
#endif /*USE_AUDIO_CODEC_WM8994 == 1)*/
Expand Down Expand Up @@ -4215,5 +4233,3 @@ static void DFSDM_FilterMspDeInit(DFSDM_Filter_HandleTypeDef *hDfsdmFilter)
/**
* @}
*/

/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
13 changes: 5 additions & 8 deletions Drivers/BSP/STM32H735G-DK/stm32h735g_discovery_audio.h
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,12 @@
******************************************************************************
* @attention
*
* <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
* All rights reserved.</center></h2>
* Copyright (c) 2019 STMicroelectronics.
* All rights reserved.
*
* This software component is licensed by ST under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
* 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.
*
******************************************************************************
*/
Expand Down Expand Up @@ -588,5 +587,3 @@ HAL_StatusTypeDef MX_SAI4_Block_A_Init(SAI_HandleTypeDef* hsai, MX_SAI_Config *M
#endif

#endif /* STM32H735G_DISCO_AUDIO_H */

/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
13 changes: 5 additions & 8 deletions Drivers/BSP/STM32H735G-DK/stm32h735g_discovery_bus.c
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,12 @@
******************************************************************************
* @attention
*
* <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
* All rights reserved.</center></h2>
* Copyright (c) 2019 STMicroelectronics.
* All rights reserved.
*
* This software component is licensed by ST under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
* 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.
*
******************************************************************************
*/
Expand Down Expand Up @@ -880,5 +879,3 @@ static int32_t I2C4_ReadReg(uint16_t DevAddr, uint16_t Reg, uint16_t MemAddSize,
/**
* @}
*/

/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Loading

0 comments on commit 91525b1

Please sign in to comment.