Sync inav to Gitea

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,37 @@
+---
+name: 'Issue report'
+about: 'Create a report to help us improve the quality of our software'
+title: ''
+labels: ''
+assignees: ''
+---
+
+**Caution**
+
+The Issues are strictly limited for the reporting of problem encountered with the software provided in this project.
+For any other problem related to the STM32 product, the performance, the hardware characteristics and boards, the tools the environment in general, please post your report to the **ST Community** in the STM32 MCUs dedicated [page](https://community.st.com/s/topic/0TO0X000000BSqSWAW/stm32-mcus).
+
+**Describe the set-up**
+
+ * The board (either ST RPN reference or your custom board)
+ * IDE or at least the compiler and its version
+
+**Describe the bug (skip if none)**
+
+A clear and concise description of what the bug is.
+
+**How to reproduce the bug (skip if none)**
+
+1. Indicate the global behavior of your application project
+2. List the modules that you suspect to be the cause of the problem (Drivers, BSP, MW...)
+3. Describe the use case that generates the problem
+4. How we can reproduce the problem
+
+
+**Additional context**
+
+If you have a first analysis, an enhancement, a fix or a patch, thank you to share your proposal.
+
+**Screenshots**
+
+If applicable, add screenshots to help explain your problem.

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+## IMPORTANT INFORMATION
+
+### Contributor License Agreement (CLA)
+* The Pull Request feature will be considered by STMicroelectronics after the signature of a **Contributor License Agreement (CLA)** by the submitter.
+* If you did not sign such agreement, please follow the steps mentioned in the [CONTRIBUTING.md](https://github.com/STMicroelectronics/stm32h7xx-nucleo/blob/main/CONTRIBUTING.md) file.

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/CODE_OF_CONDUCT.md

@@ -0,0 +1,73 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team via this [link](https://www.st.com/content/st_com/en/contact-us.html).
+All complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 1.4,
+available [here](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html).
+
+For answers to common questions about this code of conduct, refer to the FAQ section [here](https://www.contributor-covenant.org/faq).

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+## Contributing guide
+
+This guide serves as a checklist before contributing to this repository. It mainly focuses on the steps to follow to submit an issue or a pull-request.
+
+### 1. Issues
+
+#### 1.1 Before opening an issue
+
+Please check the following points before posting an issue:
+* Make sure you are using the latest commit (major releases are tagged, but corrections are available as new commits).
+* Make sure your issue is a question/feedback/suggestions **related to** the software provided in this repository. Otherwise, please refer to section [3](CONTRIBUTING.md#3.-support-requests-and-questions) below.
+* Make sure your issue is not already reported/fixed on GitHub or discussed on a previous issue. Please refer to this [dashboard](https://github.com/orgs/STMicroelectronics/projects/2) for the list of issues and pull-requests. Do not forget to browse into the **closed** issues.
+
+#### 1.2 Posting the issue
+
+When you have checked the previous points, create a new report from the **Issues** tab of this repository. A template is available [here](issues/new/choose) to help you report the issue you are facing or the enhancement you would like to propose.
+
+### 2. Pull Requests
+
+#### 2.1 Before opening a pull-request
+
+STMicrolectronics is happy to receive contributions from the community, based on an initial Contributor License Agreement (CLA) procedure.
+
+* If you are an individual writing original source code and you are sure **you own the intellectual property**, then you need to sign an Individual [CLA](https://cla.st.com).
+* If you work for a company that wants also to allow you to contribute with your work, your company needs to provide a Corporate [CLA](https://cla.st.com) mentioning your GitHub account name.
+* If you are not sure that a CLA (Individual or Corporate) has been signed for your GitHub account you can check the [CLA](https://cla.st.com) dedicated page.
+
+Please note that:
+* The Corporate CLA will always take precedence over the Individual CLA.
+* One CLA submission is sufficient, for any project proposed by STMicroelectronics.
+
+#### 2.2 How to proceed
+
+* We recommend to engage first a communication thru an issue, in order to present your proposal, just to confirm that it corresponds to STMicroelectronics' domain or scope.
+* Then fork the project to your GitHub account to further develop your contribution. Please use the latest commit version.
+* Please, submit one pull-request per new feature or proposal. This will ease the analysis and the final merge if accepted.
+
+### 3. Support requests and questions
+
+For support requests or any other question related to the product, the tools, the environment, you can submit a post to the **ST Community** on the appropriate topic [page](https://community.st.com/s/topiccatalog).

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/LICENSE.md

@@ -0,0 +1,11 @@
+Copyright 2019 STMicroelectronics. All rights reserved.
+
+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.

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/README.md

@@ -0,0 +1,36 @@
+# BSP STM32H7XX-NUCLEO Component
+
+![latest tag](https://img.shields.io/github/v/tag/STMicroelectronics/stm32h7xx-nucleo.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 **stm32h7xx-nucleo** MCU component repository is one element of the **STM32CubeH7** MCU embedded software package, providing the **STM32H7XX-NUCLEO** 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/stm32h7xx-nucleo/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)
+
+## Troubleshooting
+
+Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) guide.

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/Release_Notes.html

@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="pandoc" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
+  <title>Release Notes for STM32H7xx_Nucleo 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>
+  <link rel="stylesheet" href="_htmresc/mini-st_2020.css" />
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<div class="row">
+<div class="col-sm-12 col-lg-4">
+<center>
+<h1 id="release-notes-for-stm32h7xx_nucleo-bsp-drivers"><strong>Release Notes for STM32H7xx_Nucleo BSP Drivers</strong></h1>
+<p>Copyright © 2019 STMicroelectronics<br />
+</p>
+<a href="https://www.st.com" class="logo"><img src="_htmresc/st_logo_2020.png" alt="ST logo" /></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>
+<div class="collapse">
+<input type="checkbox" id="collapse-section7" checked aria-hidden="true"> <label for="collapse-section7" aria-hidden="true"><strong>V1.3.3 / 29-August-2024</strong></label>
+<div>
+<h2 id="main-changes">Main Changes</h2>
+<ul>
+<li>Add missing defines for Nucleo USE_NUCLEO_H755ZI_Q and USE_NUCLEO_H753ZI in stm32h7xx_nucleo.h.</li>
+</ul>
+</div>
+</div>
+<div class="collapse">
+<input type="checkbox" id="collapse-section6" aria-hidden="true"> <label for="collapse-section6" aria-hidden="true"><strong>V1.3.2 / 19-February-2024</strong></label>
+<div>
+<h2 id="main-changes-1">Main Changes</h2>
+<ul>
+<li>Apply new release notes format.</li>
+</ul>
+</div>
+</div>
+<div class="collapse">
+<input type="checkbox" id="collapse-section5" aria-hidden="true"> <label for="collapse-section5" aria-hidden="true"><strong>V1.3.1 / 11-February-2022</strong></label>
+<div>
+<h2 id="main-changes-2">Main Changes</h2>
+<ul>
+<li>All source files: update disclaimer to add reference to the new license agreement.</li>
+</ul>
+</div>
+</div>
+<div class="collapse">
+<input type="checkbox" id="collapse-section4" aria-hidden="true"> <label for="collapse-section4" aria-hidden="true"><strong>V1.3.0 / 29-January-2021</strong></label>
+<div>
+<h2 id="main-changes-3">Main Changes</h2>
+<ul>
+<li>Minor typo fixes in comments</li>
+</ul>
+<h2 id="dependencies">Dependencies</h2>
+<p>This software release is compatible with:</p>
+<ul>
+<li>BSP common drivers <strong>V7.0.0</strong> or above</li>
+</ul>
+</div>
+</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-September-2020</strong></label>
+<div>
+<h2 id="main-changes-4">Main Changes</h2>
+<ul>
+<li>Add License.md file</li>
+</ul>
+<h2 id="dependencies-1">Dependencies</h2>
+<p>This software release is compatible with:</p>
+<ul>
+<li>BSP common drivers <strong>V7.0.0</strong> or above</li>
+<li>STM32H7xx HAL drivers <strong>V1.9.0</strong> or above</li>
+</ul>
+</div>
+</div>
+<div class="collapse">
+<input type="checkbox" id="collapse-section2" aria-hidden="true"> <label for="collapse-section2" aria-hidden="true"><strong>V1.1.0 / 03-April-2020</strong></label>
+<div>
+<h2 id="main-changes-5">Main Changes</h2>
+<ul>
+<li>Official release of STM32H7xx_Nucleo BSP drivers to support NUCLEO-H723ZG board</li>
+</ul>
+<h2 id="dependencies-2">Dependencies</h2>
+<p>This software release is compatible with:</p>
+<ul>
+<li>BSP common drivers <strong>V7.0.0</strong> or above</li>
+<li>STM32H7xx HAL drivers <strong>V1.9.0</strong></li>
+</ul>
+</div>
+</div>
+<div class="collapse">
+<input type="checkbox" id="collapse-section1" aria-hidden="true"> <label for="collapse-section1" aria-hidden="true"><strong>V1.0.0 / 30-October-2019</strong></label>
+<div>
+<h2 id="main-changes-6">Main Changes</h2>
+<ul>
+<li>First official release of STM32H7xx_Nucleo BSP drivers in line with STM32Cube BSP drivers development guidelines (UM2298)</li>
+</ul>
+<h2 id="dependencies-3">Dependencies</h2>
+<p>This software release is compatible with:</p>
+<ul>
+<li>BSP common drivers <strong>V6.0.0</strong> or above</li>
+<li>STM32H7xx HAL drivers <strong>V1.7.0</strong></li>
+</ul>
+</div>
+</div>
+</div>
+</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>
+</footer>
+</body>
+</html>

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/SECURITY.md

@@ -0,0 +1,31 @@
+# Report potential product security vulnerabilities
+
+ST places a high priority on security, and our Product Security Incident
+Response Team (PSIRT) is committed to rapidly addressing potential security
+vulnerabilities affecting our products. PSIRT's long history and vast experience
+in security allows ST to perform clear analyses and provide appropriate guidance
+on mitigations and solutions when applicable.
+
+If you wish to report potential security vulnerabilities regarding our products,
+**please do not report them through public GitHub issues.** Instead, we
+encourage you to report them to our ST PSIRT following the process described at:
+**https://www.st.com/content/st_com/en/security/report-vulnerabilities.html**
+
+### IMPORTANT - READ CAREFULLY:
+
+STMicroelectronics International N.V., on behalf of itself, its affiliates and
+subsidiaries, (collectively “ST”) takes all potential security vulnerability
+reports or other related communications (“Report(s)”) seriously. In order to
+review Your Report (the terms “You” and “Yours” include your employer, and all
+affiliates, subsidiaries and related persons or entities) and take actions as
+deemed appropriate, ST requires that we have the rights and Your permission to
+do so.
+
+As such, by submitting Your Report to ST, You agree that You have the right to
+do so, and You grant to ST the rights to use the Report for purposes related to
+security vulnerability analysis, testing, correction, patching, reporting and
+any other related purpose or function.
+
+By submitting Your Report, You agree that ST’s
+[Privacy Policy](https://www.st.com/content/st_com/en/common/privacy-portal.html)
+applies to all related communications.

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/stm32h7xx_nucleo.c

@@ -0,0 +1,690 @@
+/**
+  ******************************************************************************
+  * @file    stm32h7xx_nucleo.c
+  * @author  MCD Application Team
+  * @brief   This file provides set of firmware functions to manage:
+  *          - LEDs and push-button available on STM32H7xx-Nucleo Kit
+  *            from STMicroelectronics
+  ******************************************************************************
+  * @attention
+  *
+  * Copyright (c) 2018 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.
+  *
+  ******************************************************************************
+  */
+
+/* Includes ------------------------------------------------------------------*/
+#include "stm32h7xx_nucleo.h"
+
+/** @addtogroup BSP
+  * @{
+  */
+
+/** @addtogroup STM32H7XX_NUCLEO
+  * @{
+  */
+
+/** @addtogroup STM32H7XX_NUCLEO_LOW_LEVEL
+  * @brief This file provides set of firmware functions to manage Leds and push-button
+  *        available on STM32H7xx-Nucleo Kit from STMicroelectronics.
+  * @{
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Private_Defines LOW LEVEL Private Defines
+  * @{
+  */
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Private_TypesDefinitions LOW LEVEL Private Typedef
+  * @{
+  */
+typedef void (* BSP_EXTI_LineCallback) (void);
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Exported_Variables LOW LEVEL Exported Variables
+  * @{
+  */
+EXTI_HandleTypeDef hpb_exti[BUTTONn];
+#if (USE_BSP_COM_FEATURE > 0)
+UART_HandleTypeDef hcom_uart[COMn];
+USART_TypeDef* COM_USART[COMn]   = {COM1_UART};
+#endif
+/**
+  * @}
+  */
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Private_Variables LOW LEVEL Private Variables
+  * @{
+  */
+static GPIO_TypeDef* LED_PORT[LEDn] = {LED1_GPIO_PORT,
+                                       LED2_GPIO_PORT,
+                                       LED3_GPIO_PORT};
+
+static const uint16_t LED_PIN[LEDn] = {LED1_PIN,
+                                       LED2_PIN,
+                                       LED3_PIN};
+
+static GPIO_TypeDef* BUTTON_PORT[BUTTONn] = {BUTTON_USER_GPIO_PORT};
+static const uint16_t BUTTON_PIN[BUTTONn] = {BUTTON_USER_PIN};
+static const IRQn_Type BUTTON_IRQn[BUTTONn] = {BUTTON_USER_EXTI_IRQn};
+
+
+
+#if (USE_BSP_COM_FEATURE > 0)
+  #if (USE_COM_LOG > 0)
+     static COM_TypeDef COM_ActiveLogPort = COM1;
+  #endif
+  #if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
+     static uint32_t IsComMspCbValid[COMn] = {0};
+  #endif
+#endif
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Private_FunctionPrototypes LOW LEVEL Private functions Prototypes
+  * @{
+  */
+static void BUTTON_USER_EXTI_Callback(void);
+#if (USE_BSP_COM_FEATURE > 0)
+static void COM1_MspInit(UART_HandleTypeDef *huart);
+static void COM1_MspDeInit(UART_HandleTypeDef *huart);
+#endif
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Exported_Functions LOW LEVEL Exported Functions
+  * @{
+  */
+
+/**
+  * @brief  This method returns the STM32H7XX NUCLEO BSP Driver revision
+  * @retval version: 0xXYZR (8bits for each decimal, R for RC)
+  */
+int32_t BSP_GetVersion(void)
+{
+  return (int32_t)STM32H7XX_NUCLEO_BSP_VERSION;
+}
+
+/**
+  * @brief  Configures LED GPIO.
+  * @param  Led Specifies the Led to be configured.
+  *   This parameter can be one of following parameters:
+  *     @arg  LED1
+  *     @arg  LED2
+  *     @arg  LED3
+  * @retval BSP status
+  */
+int32_t BSP_LED_Init(Led_TypeDef Led)
+{
+  int32_t ret = BSP_ERROR_NONE;
+  GPIO_InitTypeDef  gpio_init_structure;
+
+  if((Led != LED1) && (Led != LED2) && (Led != LED3))
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    /* Enable the GPIO LED Clock */
+    if(Led == LED1)
+    {
+      LED1_GPIO_CLK_ENABLE();
+    }
+    else if(Led == LED2)
+    {
+      LED2_GPIO_CLK_ENABLE();
+    }
+    else
+    {
+      LED3_GPIO_CLK_ENABLE();
+    }
+    /* Configure the GPIO_LED pin */
+    gpio_init_structure.Pin   = LED_PIN[Led];
+    gpio_init_structure.Mode  = GPIO_MODE_OUTPUT_PP;
+    gpio_init_structure.Pull  = GPIO_NOPULL;
+    gpio_init_structure.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
+
+    HAL_GPIO_Init(LED_PORT[Led], &gpio_init_structure);
+    HAL_GPIO_WritePin(LED_PORT[Led], LED_PIN[Led], GPIO_PIN_RESET);
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  DeInit LEDs.
+  * @param  Led LED to be de-init.
+  *   This parameter can be one of the following values:
+  *     @arg  LED1
+  *     @arg  LED2
+  *     @arg  LED3
+  * @note Led DeInit does not disable the GPIO clock nor disable the Mfx
+  * @retval BSP status
+  */
+int32_t BSP_LED_DeInit(Led_TypeDef Led)
+{
+  int32_t ret = BSP_ERROR_NONE;
+  GPIO_InitTypeDef  gpio_init_structure;
+
+  if((Led != LED1) && (Led != LED2) && (Led != LED3))
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    /* Turn off LED */
+    HAL_GPIO_WritePin(LED_PORT[Led], LED_PIN[Led], GPIO_PIN_RESET);
+    /* DeInit the GPIO_LED pin */
+    gpio_init_structure.Pin = LED_PIN[Led];
+    HAL_GPIO_DeInit(LED_PORT[Led], gpio_init_structure.Pin);
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  Turns selected LED On.
+  * @param  Led Specifies the Led to be set on.
+  *   This parameter can be one of following parameters:
+  *     @arg  LED1
+  *     @arg  LED2
+  *     @arg  LED3
+  * @retval BSP status
+  */
+int32_t BSP_LED_On(Led_TypeDef Led)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if((Led != LED1) && (Led != LED2) && (Led != LED3))
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    HAL_GPIO_WritePin(LED_PORT[Led], LED_PIN[Led], GPIO_PIN_SET);
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  Turns selected LED Off.
+  * @param  Led: Specifies the Led to be set off.
+  *   This parameter can be one of following parameters:
+  *     @arg  LED1
+  *     @arg  LED2
+  *     @arg  LED3
+  * @retval BSP status
+  */
+int32_t BSP_LED_Off(Led_TypeDef Led)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if((Led != LED1) && (Led != LED2) && (Led != LED3))
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    HAL_GPIO_WritePin(LED_PORT[Led], LED_PIN[Led], GPIO_PIN_RESET);
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  Toggles the selected LED.
+  * @param  Led Specifies the Led to be toggled.
+  *   This parameter can be one of following parameters:
+  *     @arg  LED1
+  *     @arg  LED2
+  *     @arg  LED3
+  * @retval BSP status
+  */
+int32_t BSP_LED_Toggle(Led_TypeDef Led)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if((Led != LED1) && (Led != LED2) && (Led != LED3))
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    HAL_GPIO_TogglePin(LED_PORT[Led], LED_PIN[Led]);
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  Get the state of the selected LED.
+  * @param  Led LED to get its state
+  *   This parameter can be one of following parameters:
+  *     @arg  LED1
+  *     @arg  LED2
+  *     @arg  LED3
+  * @retval LED status
+  */
+int32_t BSP_LED_GetState (Led_TypeDef Led)
+{
+  int32_t ret;
+
+  if((Led != LED1) && (Led != LED2) && (Led != LED3))
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    ret = (int32_t)HAL_GPIO_ReadPin (LED_PORT [Led], LED_PIN [Led]);
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  Configures button GPIO and EXTI Line.
+  * @param  Button Button to be configured
+  *          This parameter can be one of the following values:
+  *            @arg  BUTTON_USER: Wakeup Push Button
+  * @param  ButtonMode Button mode
+  *          This parameter can be one of the following values:
+  *            @arg  BUTTON_MODE_GPIO: Button will be used as simple IO
+  *            @arg  BUTTON_MODE_EXTI: Button will be connected to EXTI line
+  *                                    with interrupt generation capability
+  */
+int32_t BSP_PB_Init(Button_TypeDef Button, ButtonMode_TypeDef ButtonMode)
+{
+  GPIO_InitTypeDef gpio_init_structure;
+  static BSP_EXTI_LineCallback ButtonCallback[BUTTONn] = {BUTTON_USER_EXTI_Callback};
+  static uint32_t  BSP_BUTTON_PRIO [BUTTONn] = {BSP_BUTTON_USER_IT_PRIORITY};
+  static const uint32_t BUTTON_EXTI_LINE[BUTTONn] = {BUTTON_USER_EXTI_LINE};
+
+  /* Enable the BUTTON clock */
+  BUTTON_USER_GPIO_CLK_ENABLE();
+
+  gpio_init_structure.Pin = BUTTON_PIN [Button];
+  gpio_init_structure.Pull = GPIO_PULLDOWN;
+  gpio_init_structure.Speed = GPIO_SPEED_FREQ_HIGH;
+
+  if(ButtonMode == BUTTON_MODE_GPIO)
+  {
+    /* Configure Button pin as input */
+    gpio_init_structure.Mode = GPIO_MODE_INPUT;
+    HAL_GPIO_Init(BUTTON_PORT [Button], &gpio_init_structure);
+  }
+  else /* (ButtonMode == BUTTON_MODE_EXTI) */
+  {
+    /* Configure Button pin as input with External interrupt */
+    gpio_init_structure.Mode = GPIO_MODE_IT_RISING;
+
+    HAL_GPIO_Init(BUTTON_PORT[Button], &gpio_init_structure);
+
+    (void)HAL_EXTI_GetHandle(&hpb_exti[Button], BUTTON_EXTI_LINE[Button]);
+    (void)HAL_EXTI_RegisterCallback(&hpb_exti[Button],  HAL_EXTI_COMMON_CB_ID, ButtonCallback[Button]);
+
+    /* Enable and set Button EXTI Interrupt to the lowest priority */
+    HAL_NVIC_SetPriority((BUTTON_IRQn[Button]), BSP_BUTTON_PRIO[Button], 0x00);
+    HAL_NVIC_EnableIRQ((BUTTON_IRQn[Button]));
+  }
+
+  return BSP_ERROR_NONE;
+}
+
+/**
+  * @brief  Push Button DeInit.
+  * @param  Button Button to be configured
+  *          This parameter can be one of the following values:
+  *            @arg  BUTTON_USER: Wakeup Push Button
+  * @note PB DeInit does not disable the GPIO clock
+  */
+int32_t BSP_PB_DeInit(Button_TypeDef Button)
+{
+  GPIO_InitTypeDef gpio_init_structure;
+
+  gpio_init_structure.Pin = BUTTON_PIN[Button];
+  HAL_NVIC_DisableIRQ((IRQn_Type)(BUTTON_IRQn[Button]));
+  HAL_GPIO_DeInit(BUTTON_PORT[Button], gpio_init_structure.Pin);
+
+  return BSP_ERROR_NONE;
+}
+
+/**
+  * @brief  Returns the selected button state.
+  * @param  Button Button to be checked
+  *          This parameter can be one of the following values:
+  *            @arg  BUTTON_USER: Wakeup Push Button
+  * @retval The Button GPIO pin value (GPIO_PIN_RESET = button pressed)
+  */
+int32_t BSP_PB_GetState(Button_TypeDef Button)
+{
+  return (int32_t)HAL_GPIO_ReadPin(BUTTON_PORT[Button], BUTTON_PIN[Button]);
+}
+
+/**
+  * @brief  BSP Button IRQ handler
+  * @param  Button Can only be BUTTON_USER
+  * @retval None
+  */
+void BSP_PB_IRQHandler(Button_TypeDef Button)
+{
+  HAL_EXTI_IRQHandler(&hpb_exti[Button]);
+}
+
+/**
+  * @brief  BSP Push Button callback
+  * @param  Button Specifies the pin connected EXTI line
+  * @retval None
+  */
+__weak void BSP_PB_Callback(Button_TypeDef Button)
+{
+  /* Prevent unused argument(s) compilation warning */
+  UNUSED(Button);
+
+  /* This function should be implemented by the user application.
+     It is called into this driver when an event on Button is triggered. */
+}
+
+#if (USE_BSP_COM_FEATURE > 0)
+/**
+  * @brief  Configures COM port.
+  * @param  COM COM port to be configured.
+  *          This parameter can be COM1
+  * @param  COM_Init Pointer to a UART_HandleTypeDef structure that contains the
+  *                  configuration information for the specified USART peripheral.
+  * @retval BSP error code
+  */
+int32_t BSP_COM_Init(COM_TypeDef COM, COM_InitTypeDef *COM_Init)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if(COM >= COMn)
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+#if (USE_HAL_UART_REGISTER_CALLBACKS == 0)
+    /* Init the UART Msp */
+    COM1_MspInit(&hcom_uart[COM]);
+#else
+    if(IsComMspCbValid[COM] == 0U)
+    {
+      if(BSP_COM_RegisterDefaultMspCallbacks(COM) != BSP_ERROR_NONE)
+      {
+        return BSP_ERROR_MSP_FAILURE;
+      }
+    }
+#endif
+
+    if(MX_USART3_Init(&hcom_uart[COM], COM_Init) != HAL_OK)
+    {
+      ret = BSP_ERROR_PERIPH_FAILURE;
+    }
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  DeInit COM port.
+  * @param  COM COM port to be configured.
+  *          This parameter can be COM1
+  * @retval BSP status
+  */
+int32_t BSP_COM_DeInit(COM_TypeDef COM)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if(COM >= COMn)
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    /* USART configuration */
+    hcom_uart[COM].Instance = COM_USART[COM];
+
+#if (USE_HAL_UART_REGISTER_CALLBACKS == 0)
+    COM1_MspDeInit(&hcom_uart[COM]);
+#endif /* (USE_HAL_UART_REGISTER_CALLBACKS == 0) */
+
+    if(HAL_UART_DeInit(&hcom_uart[COM]) != HAL_OK)
+    {
+      ret = BSP_ERROR_PERIPH_FAILURE;
+    }
+  }
+
+  return ret;
+}
+
+/**
+  * @brief  Configures COM port.
+  * @param  huart USART handle
+  * @param  COM_Init Pointer to a UART_HandleTypeDef structure that contains the
+  *                  configuration information for the specified USART peripheral.
+  * @retval HAL error code
+  */
+__weak HAL_StatusTypeDef MX_USART3_Init(UART_HandleTypeDef *huart, MX_UART_InitTypeDef *COM_Init)
+{
+  /* USART configuration */
+ huart->Instance          = COM_USART[COM1];
+ huart->Init.BaudRate     = COM_Init->BaudRate;
+ huart->Init.Mode         = UART_MODE_TX_RX;
+ huart->Init.Parity       = (uint32_t)COM_Init->Parity;
+ huart->Init.WordLength   = (uint32_t)COM_Init->WordLength;
+ huart->Init.StopBits     = (uint32_t)COM_Init->StopBits;
+ huart->Init.HwFlowCtl    = (uint32_t)COM_Init->HwFlowCtl;
+ huart->Init.OverSampling = UART_OVERSAMPLING_8;
+
+ return HAL_UART_Init(huart);
+}
+
+#if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
+/**
+  * @brief Register Default COM Msp Callbacks
+  * @param  COM COM port to be configured.
+  *          This parameter can be COM1
+  * @retval BSP status
+  */
+int32_t BSP_COM_RegisterDefaultMspCallbacks(COM_TypeDef COM)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if(COM >= COMn)
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    __HAL_UART_RESET_HANDLE_STATE(&hcom_uart[COM]);
+
+    /* Register default MspInit/MspDeInit Callback */
+    if(HAL_UART_RegisterCallback(&hcom_uart[COM], HAL_UART_MSPINIT_CB_ID, COM1_MspInit) != HAL_OK)
+    {
+      ret = BSP_ERROR_PERIPH_FAILURE;
+    }
+    else if(HAL_UART_RegisterCallback(&hcom_uart[COM], HAL_UART_MSPDEINIT_CB_ID, COM1_MspDeInit) != HAL_OK)
+    {
+      ret = BSP_ERROR_PERIPH_FAILURE;
+    }
+    else
+    {
+      IsComMspCbValid[COM] = 1U;
+    }
+  }
+
+  /* BSP status */
+  return ret;
+}
+
+/**
+  * @brief Register COM Msp Callback registering
+  * @param  COM COM port to be configured.
+  *          This parameter can be COM1
+  * @param Callbacks     pointer to COM1 MspInit/MspDeInit callback functions
+  * @retval BSP status
+  */
+int32_t BSP_COM_RegisterMspCallbacks(COM_TypeDef COM , BSP_COM_Cb_t *Callback)
+{
+  int32_t ret = BSP_ERROR_NONE;
+
+  if(COM >= COMn)
+  {
+    ret = BSP_ERROR_WRONG_PARAM;
+  }
+  else
+  {
+    __HAL_UART_RESET_HANDLE_STATE(&hcom_uart[COM]);
+
+    /* Register MspInit/MspDeInit Callbacks */
+    if(HAL_UART_RegisterCallback(&hcom_uart[COM], HAL_UART_MSPINIT_CB_ID, Callback->pMspInitCb) != HAL_OK)
+    {
+      ret = BSP_ERROR_PERIPH_FAILURE;
+    }
+    else if(HAL_UART_RegisterCallback(&hcom_uart[COM], HAL_UART_MSPDEINIT_CB_ID, Callback->pMspDeInitCb) != HAL_OK)
+    {
+      ret = BSP_ERROR_PERIPH_FAILURE;
+    }
+    else
+    {
+      IsComMspCbValid[COM] = 1U;
+    }
+  }
+  /* BSP status */
+  return ret;
+}
+#endif /* USE_HAL_UART_REGISTER_CALLBACKS */
+
+#if (USE_COM_LOG > 0)
+/**
+  * @brief  Select the active COM port.
+  * @param  COM COM port to be activated.
+  *          This parameter can be COM1
+  * @retval BSP status
+  */
+int32_t BSP_COM_SelectLogPort(COM_TypeDef COM)
+{
+  if(COM_ActiveLogPort != COM)
+  {
+    COM_ActiveLogPort = COM;
+  }
+  return BSP_ERROR_NONE;
+}
+
+/**
+  * @brief  Redirect console output to COM
+  */
+ #ifdef __GNUC__
+ int __io_putchar (int ch)
+ #else
+ int fputc (int ch, FILE *f)
+ #endif /* __GNUC__ */
+{
+  HAL_UART_Transmit (&hcom_uart [COM_ActiveLogPort], (uint8_t *) &ch, 1, COM_POLL_TIMEOUT);
+  return ch;
+}
+#endif /* USE_COM_LOG */
+#endif /* USE_BSP_COM_FEATURE */
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Private_Functions LOW LEVEL Private functions
+  * @{
+  */
+/**
+  * @brief  Key EXTI line detection callbacks.
+  * @retval BSP status
+  */
+static void BUTTON_USER_EXTI_Callback(void)
+{
+  BSP_PB_Callback(BUTTON_USER);
+}
+
+#if (USE_BSP_COM_FEATURE > 0)
+/**
+  * @brief  Initializes UART MSP.
+  * @param  huart UART handle
+  * @retval BSP status
+  */
+static void COM1_MspInit(UART_HandleTypeDef *huart)
+{
+  GPIO_InitTypeDef gpio_init_structure;
+
+  /* Prevent unused argument(s) compilation warning */
+  UNUSED(huart);
+
+  /* Enable GPIO clock */
+  COM1_TX_GPIO_CLK_ENABLE();
+  COM1_RX_GPIO_CLK_ENABLE();
+
+  /* Enable USART clock */
+  COM1_CLK_ENABLE();
+
+  /* Configure USART Tx as alternate function */
+  gpio_init_structure.Pin = COM1_TX_PIN;
+  gpio_init_structure.Mode = GPIO_MODE_AF_PP;
+  gpio_init_structure.Speed = GPIO_SPEED_FREQ_HIGH;
+  gpio_init_structure.Pull = GPIO_PULLUP;
+  gpio_init_structure.Alternate = COM1_TX_AF;
+  HAL_GPIO_Init(COM1_TX_GPIO_PORT, &gpio_init_structure);
+
+  /* Configure USART Rx as alternate function */
+  gpio_init_structure.Pin = COM1_RX_PIN;
+  gpio_init_structure.Mode = GPIO_MODE_AF_PP;
+  gpio_init_structure.Alternate = COM1_RX_AF;
+  HAL_GPIO_Init(COM1_RX_GPIO_PORT, &gpio_init_structure);
+}
+
+/**
+  * @brief  Initialize USART3 Msp part
+  * @param  huart UART handle
+  * @retval BSP status
+  */
+static void COM1_MspDeInit(UART_HandleTypeDef *huart)
+{
+  GPIO_InitTypeDef          gpio_init_structure;
+
+  /* Prevent unused argument(s) compilation warning */
+  UNUSED(huart);
+
+  /* COM GPIO pin configuration */
+  gpio_init_structure.Pin  = COM1_TX_PIN;
+  HAL_GPIO_DeInit(COM1_TX_GPIO_PORT, gpio_init_structure.Pin);
+
+  gpio_init_structure.Pin  = COM1_RX_PIN;
+  HAL_GPIO_DeInit(COM1_RX_GPIO_PORT, gpio_init_structure.Pin);
+
+  /* Disable USART clock */
+  COM1_CLK_DISABLE();
+}
+#endif /* USE_BSP_COM_FEATURE */
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/stm32h7xx_nucleo.h

@@ -0,0 +1,339 @@
+/**
+  ******************************************************************************
+  * @file    stm32h7xx_nucleo.h
+  * @author  MCD Application Team
+  * @brief   This file contains definitions for:
+  *          - LEDs and push-button available on STM32H7xx-Nucleo Kit
+  *            from STMicroelectronics
+  ******************************************************************************
+  * @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.
+  *
+  ******************************************************************************
+  */
+
+/* Define to prevent recursive inclusion -------------------------------------*/
+#ifndef STM32H7XX_NUCLEO_H
+#define STM32H7XX_NUCLEO_H
+
+#ifdef __cplusplus
+ extern "C" {
+#endif
+
+/* Includes ------------------------------------------------------------------*/
+#include "stm32h7xx_nucleo_conf.h"
+#include "stm32h7xx_nucleo_errno.h"
+
+#if (USE_BSP_COM_FEATURE > 0)
+  #if (USE_COM_LOG > 0)
+    #ifndef __GNUC__
+      #include <stdio.h>
+    #endif
+  #endif
+#endif
+
+/** @addtogroup BSP
+  * @{
+  */
+
+/** @defgroup STM32H7XX_NUCLEO STM32H7XX_NUCLEO
+  * @{
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL LOW LEVEL
+  * @{
+  */
+
+/**
+  * @brief Define for STM32H7XX_NUCLEO board
+  */
+#if !defined (USE_STM32H7XX_NUCLEO)
+ #define USE_STM32H7XX_NUCLEO
+#endif
+
+#if !defined (USE_NUCLEO_144)
+ #error "Board Pin number not defined!! Add USE_NUCLEO_144 define within stm32h7xx_nucleo_conf.h file"
+#endif
+
+#if !defined (USE_NUCLEO_H745ZI_Q) && !defined (USE_NUCLEO_H755ZI_Q) && !defined (USE_NUCLEO_H743ZI) &&\
+     !defined (USE_NUCLEO_H753ZI) && !defined (USE_NUCLEO_H743ZI2) && !defined (USE_NUCLEO_H7A3ZI_Q) &&\
+     !defined (USE_NUCLEO_H723ZG)
+ #error "Board Part number not defined!! Add one of the following defines within stm32h7xx_nucleo_conf.h file:\
+         USE_NUCLEO_H745ZI_Q, USE_NUCLEO_H755ZI_Q, USE_NUCLEO_H743ZI, USE_NUCLEO_H753ZI, USE_NUCLEO_H743ZI2,\
+         USE_NUCLEO_H7A3ZI_Q or USE_NUCLEO_H723ZG"
+#endif
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Exported_Types LOW LEVEL Exported Types
+  * @{
+  */
+#if defined (USE_NUCLEO_H745ZI_Q) || defined (USE_NUCLEO_H755ZI_Q) || defined (USE_NUCLEO_H743ZI2) ||\
+    defined (USE_NUCLEO_H7A3ZI_Q) || defined (USE_NUCLEO_H723ZG)
+typedef enum
+{
+  LED1 = 0,
+  LED_GREEN = LED1,
+  LED2 = 1,
+  LED_YELLOW = LED2,
+  LED3 = 2,
+  LED_RED = LED3,
+  LEDn
+}Led_TypeDef;
+#else /* USE_NUCLEO_H743ZI || USE_NUCLEO_H753ZI */
+typedef enum
+{
+  LED1 = 0,
+  LED_GREEN = LED1,
+  LED2 = 1,
+  LED_BLUE = LED2,
+  LED3 = 2,
+  LED_RED = LED3,
+  LEDn
+}Led_TypeDef;
+#endif
+
+typedef enum
+{
+  BUTTON_USER = 0U,
+  BUTTONn
+}Button_TypeDef;
+
+typedef enum
+{
+  BUTTON_MODE_GPIO = 0,
+  BUTTON_MODE_EXTI = 1
+}ButtonMode_TypeDef;
+
+#if (USE_BSP_COM_FEATURE > 0)
+typedef enum
+{
+  COM1 = 0U,
+  COMn
+}COM_TypeDef;
+
+typedef enum
+{
+ COM_STOPBITS_1     =   UART_STOPBITS_1,
+ COM_STOPBITS_2     =   UART_STOPBITS_2,
+}COM_StopBitsTypeDef;
+
+typedef enum
+{
+ COM_PARITY_NONE     =  UART_PARITY_NONE,
+ COM_PARITY_EVEN     =  UART_PARITY_EVEN,
+ COM_PARITY_ODD      =  UART_PARITY_ODD,
+}COM_ParityTypeDef;
+
+typedef enum
+{
+ COM_HWCONTROL_NONE    =  UART_HWCONTROL_NONE,
+ COM_HWCONTROL_RTS     =  UART_HWCONTROL_RTS,
+ COM_HWCONTROL_CTS     =  UART_HWCONTROL_CTS,
+ COM_HWCONTROL_RTS_CTS =  UART_HWCONTROL_RTS_CTS,
+}COM_HwFlowCtlTypeDef;
+
+typedef enum
+{
+  COM_WORDLENGTH_7B = UART_WORDLENGTH_7B,
+  COM_WORDLENGTH_8B = UART_WORDLENGTH_8B,
+  COM_WORDLENGTH_9B = UART_WORDLENGTH_9B,
+}COM_WordLengthTypeDef;
+
+typedef struct
+{
+  uint32_t               BaudRate;
+  COM_WordLengthTypeDef  WordLength;
+  COM_StopBitsTypeDef    StopBits;
+  COM_ParityTypeDef      Parity;
+  COM_HwFlowCtlTypeDef   HwFlowCtl;
+}COM_InitTypeDef;
+
+#if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
+typedef struct
+{
+  void (* pMspInitCb)(UART_HandleTypeDef *);
+  void (* pMspDeInitCb)(UART_HandleTypeDef *);
+}BSP_COM_Cb_t;
+#endif /* (USE_HAL_UART_REGISTER_CALLBACKS == 1) */
+
+#define MX_UART_InitTypeDef COM_InitTypeDef
+#endif
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Exported_Constants LOW LEVEL Exported Constants
+  * @{
+  */
+
+/**
+  * @brief STM32H7XX NUCLEO BSP Driver version number
+  */
+#define STM32H7XX_NUCLEO_BSP_VERSION_MAIN   (0x01U) /*!< [31:24] main version */
+#define STM32H7XX_NUCLEO_BSP_VERSION_SUB1   (0x03U) /*!< [23:16] sub1 version */
+#define STM32H7XX_NUCLEO_BSP_VERSION_SUB2   (0x03U) /*!< [15:8]  sub2 version */
+#define STM32H7XX_NUCLEO_BSP_VERSION_RC     (0x00U) /*!< [7:0]  release candidate */
+#define STM32H7XX_NUCLEO_BSP_VERSION        ((STM32H7XX_NUCLEO_BSP_VERSION_MAIN << 24)\
+                                            |(STM32H7XX_NUCLEO_BSP_VERSION_SUB1 << 16)\
+                                            |(STM32H7XX_NUCLEO_BSP_VERSION_SUB2 << 8 )\
+                                            |(STM32H7XX_NUCLEO_BSP_VERSION_RC))
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_LED LOW LEVEL LED
+  * @{
+  */
+#define LEDn                                    3U
+
+#define LED1_PIN                                GPIO_PIN_0
+#define LED1_GPIO_PORT                          GPIOB
+#define LED1_GPIO_CLK_ENABLE()                  __HAL_RCC_GPIOB_CLK_ENABLE()
+#define LED1_GPIO_CLK_DISABLE()                 __HAL_RCC_GPIOB_CLK_DISABLE()
+
+#if defined (USE_NUCLEO_H745ZI_Q) || defined (USE_NUCLEO_H755ZI_Q) || defined (USE_NUCLEO_H743ZI2) ||\
+    defined (USE_NUCLEO_H7A3ZI_Q) || defined (USE_NUCLEO_H723ZG)
+#define LED2_PIN                                GPIO_PIN_1
+#define LED2_GPIO_PORT                          GPIOE
+#define LED2_GPIO_CLK_ENABLE()                  __HAL_RCC_GPIOE_CLK_ENABLE()
+#define LED2_GPIO_CLK_DISABLE()                 __HAL_RCC_GPIOE_CLK_DISABLE()
+#else /* USE_NUCLEO_H743ZI || USE_NUCLEO_H753ZI */
+#define LED2_PIN                                GPIO_PIN_7
+#define LED2_GPIO_PORT                          GPIOB
+#define LED2_GPIO_CLK_ENABLE()                  __HAL_RCC_GPIOB_CLK_ENABLE()
+#define LED2_GPIO_CLK_DISABLE()                 __HAL_RCC_GPIOB_CLK_DISABLE()
+#endif
+
+#define LED3_PIN                                GPIO_PIN_14
+#define LED3_GPIO_PORT                          GPIOB
+#define LED3_GPIO_CLK_ENABLE()                  __HAL_RCC_GPIOB_CLK_ENABLE()
+#define LED3_GPIO_CLK_DISABLE()                 __HAL_RCC_GPIOB_CLK_DISABLE()
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_BUTTON LOW LEVEL BUTTON
+  * @{
+  */
+/* Button state */
+#define BUTTON_RELEASED                    0U
+#define BUTTON_PRESSED                     1U
+#define BUTTONn                            1U
+
+/**
+ * @brief Key push-button
+ */
+#define BUTTON_USER_PIN                       GPIO_PIN_13
+#define BUTTON_USER_GPIO_PORT                 GPIOC
+#define BUTTON_USER_GPIO_CLK_ENABLE()         __HAL_RCC_GPIOC_CLK_ENABLE()
+#define BUTTON_USER_GPIO_CLK_DISABLE()        __HAL_RCC_GPIOC_CLK_DISABLE()
+#define BUTTON_USER_EXTI_IRQn                 EXTI15_10_IRQn
+#define BUTTON_USER_EXTI_LINE                 EXTI_LINE_13
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_COM LOW LEVEL COM
+  * @{
+  */
+/**
+ * @brief Definition for COM port1, connected to USART3
+ */
+#if (USE_BSP_COM_FEATURE > 0)
+
+#define COMn                          1U
+#define COM1_UART                     USART3
+#define COM1_CLK_ENABLE()             __HAL_RCC_USART3_CLK_ENABLE()
+#define COM1_CLK_DISABLE()            __HAL_RCC_USART3_CLK_DISABLE()
+
+#define COM1_TX_PIN                   GPIO_PIN_8
+#define COM1_TX_GPIO_PORT             GPIOD
+#define COM1_TX_GPIO_CLK_ENABLE()     __HAL_RCC_GPIOD_CLK_ENABLE()
+#define COM1_TX_GPIO_CLK_DISABLE()    __HAL_RCC_GPIOD_CLK_DISABLE()
+#define COM1_TX_AF                    GPIO_AF7_USART3
+
+#define COM1_RX_PIN                   GPIO_PIN_9
+#define COM1_RX_GPIO_PORT             GPIOD
+#define COM1_RX_GPIO_CLK_ENABLE()     __HAL_RCC_GPIOD_CLK_ENABLE()
+#define COM1_RX_GPIO_CLK_DISABLE()    __HAL_RCC_GPIOD_CLK_DISABLE()
+#define COM1_RX_AF                    GPIO_AF7_USART3
+#define COM_POLL_TIMEOUT             1000
+#endif
+
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+
+/** @addtogroup STM32H7XX_NUCLEO_LOW_LEVEL_Exported_Variables
+  * @{
+  */
+extern EXTI_HandleTypeDef hpb_exti[];
+#if (USE_BSP_COM_FEATURE > 0)
+extern UART_HandleTypeDef hcom_uart[];
+extern USART_TypeDef* COM_USART[];
+#endif
+
+/**
+  * @}
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_LOW_LEVEL_Exported_FunctionsPrototypes LOW LEVEL Exported Functions Prototypes
+  * @{
+  */
+int32_t  BSP_GetVersion(void);
+int32_t  BSP_LED_Init(Led_TypeDef Led);
+int32_t  BSP_LED_DeInit(Led_TypeDef Led);
+int32_t  BSP_LED_On(Led_TypeDef Led);
+int32_t  BSP_LED_Off(Led_TypeDef Led);
+int32_t  BSP_LED_Toggle(Led_TypeDef Led);
+int32_t  BSP_LED_GetState (Led_TypeDef Led);
+int32_t  BSP_PB_Init(Button_TypeDef Button, ButtonMode_TypeDef ButtonMode);
+int32_t  BSP_PB_DeInit(Button_TypeDef Button);
+int32_t  BSP_PB_GetState(Button_TypeDef Button);
+void     BSP_PB_IRQHandler(Button_TypeDef Button);
+void     BSP_PB_Callback(Button_TypeDef Button);
+
+#if (USE_BSP_COM_FEATURE > 0)
+int32_t  BSP_COM_Init(COM_TypeDef COM, COM_InitTypeDef *COM_Init);
+int32_t  BSP_COM_DeInit(COM_TypeDef COM);
+#if (USE_COM_LOG > 0)
+int32_t  BSP_COM_SelectLogPort (COM_TypeDef COM);
+#endif
+
+#if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
+int32_t BSP_COM_RegisterDefaultMspCallbacks(COM_TypeDef COM);
+int32_t BSP_COM_RegisterMspCallbacks(COM_TypeDef COM , BSP_COM_Cb_t *Callback);
+#endif /* USE_HAL_UART_REGISTER_CALLBACKS */
+HAL_StatusTypeDef MX_USART3_Init(UART_HandleTypeDef *huart, MX_UART_InitTypeDef *COM_Init);
+#endif /* USE_BSP_COM_FEATURE */
+
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* STM32H7XX_NUCLEO_H */

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/stm32h7xx_nucleo_conf_template.h

@@ -0,0 +1,77 @@
+/** 
+  ******************************************************************************
+  * @file    stm32h7xx_nucleo_conf.h
+  * @author  MCD Application Team
+  * @brief   STM32H7xx_Nuleo board configuration file.
+  ******************************************************************************
+  * @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.
+  *
+  ******************************************************************************  
+  */ 
+  
+/* Define to prevent recursive inclusion -------------------------------------*/
+#ifndef STM32H7XX_NUCLEO_CONF_H
+#define STM32H7XX_NUCLEO_CONF_H
+
+#ifdef __cplusplus
+ extern "C" {
+#endif
+
+/* Includes ------------------------------------------------------------------*/
+#include "stm32h7xx_hal.h"
+
+/** @addtogroup BSP
+  * @{
+  */
+  
+/** @addtogroup STM32H7XX_NUCLEO
+  * @{
+  */
+
+/** @defgroup STM32H7XX_NUCLEO_CONFIG Config
+  * @{
+  */ 
+  
+/** @defgroup STM32H7XX_NUCLEO_CONFIG_Exported_Constants Exported Constants
+  * @{
+  */ 
+/* Nucleo pin and part number defines */
+#define USE_NUCLEO_144
+#define USE_NUCLEO_H7A3ZI_Q
+
+/* COM define */
+#define USE_COM_LOG                         0U
+#define USE_BSP_COM_FEATURE                 0U
+
+/* IRQ priorities */
+#define BSP_BUTTON_USER_IT_PRIORITY         15U
+
+#define BUS_SPI1_BAUDRATE                   18000000
+/**
+  * @}
+  */
+
+/**
+  * @}
+  */
+  
+/**
+  * @}
+  */
+  
+/**
+  * @}
+  */
+   
+#ifdef __cplusplus
+}
+#endif
+  
+#endif /* STM32H7XX_NUCLEO_CONF_H */

lib/main/STM32H7/Drivers/BSP/STM32H7xx_Nucleo/stm32h7xx_nucleo_errno.h

@@ -0,0 +1,45 @@
+/** 
+  ******************************************************************************
+  * @file    stm32h7xx_nucleo_errno.h
+  * @author  MCD Application Team
+  * @brief   Error Code.
+  ******************************************************************************
+  * @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.
+  *
+  ******************************************************************************  
+  */ 
+  
+/* Define to prevent recursive inclusion -------------------------------------*/
+#ifndef STM32H7XX_NUCLEO_ERRNO_H
+#define STM32H7XX_NUCLEO_ERRNO_H
+
+#ifdef __cplusplus
+ extern "C" {
+#endif
+
+/* Common Error codes */
+#define BSP_ERROR_NONE                    0
+#define BSP_ERROR_NO_INIT                -1
+#define BSP_ERROR_WRONG_PARAM            -2
+#define BSP_ERROR_BUSY                   -3
+#define BSP_ERROR_PERIPH_FAILURE         -4
+#define BSP_ERROR_COMPONENT_FAILURE      -5
+#define BSP_ERROR_UNKNOWN_FAILURE        -6
+#define BSP_ERROR_UNKNOWN_COMPONENT      -7 
+#define BSP_ERROR_BUS_FAILURE            -8 
+#define BSP_ERROR_CLOCK_FAILURE          -9  
+#define BSP_ERROR_MSP_FAILURE            -10  
+#define BSP_ERROR_FEATURE_NOT_SUPPORTED  -11
+
+#ifdef __cplusplus
+}
+#endif
+   
+#endif /* STM32H7XX_NUCLEO_ERRNO_H */