Skip to content

Commit

Permalink
[board] Add NUCLEO-H723ZG BSP
Browse files Browse the repository at this point in the history
  • Loading branch information
chris-durand authored and salkinium committed Jul 15, 2021
1 parent a495194 commit c84e72e
Show file tree
Hide file tree
Showing 5 changed files with 269 additions and 3 deletions.
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -509,20 +509,21 @@ We have out-of-box support for many development boards including documentation.
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-g431rb">NUCLEO-G431RB</a></td>
</tr><tr>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-g474re">NUCLEO-G474RE</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-h723zg">NUCLEO-H723ZG</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-h743zi">NUCLEO-H743ZI</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l031k6">NUCLEO-L031K6</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l152re">NUCLEO-L152RE</a></td>
</tr><tr>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l152re">NUCLEO-L152RE</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l432kc">NUCLEO-L432KC</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l452re">NUCLEO-L452RE</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l476rg">NUCLEO-L476RG</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l496zg-p">NUCLEO-L496ZG-P</a></td>
</tr><tr>
<td align="center"><a href="https://modm.io/reference/module/modm-board-nucleo-l496zg-p">NUCLEO-L496ZG-P</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-olimexino-stm32">OLIMEXINO-STM32</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-raspberrypi">Raspberry Pi</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-samd21-mini">SAMD21-MINI</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-stm32_f4ve">STM32-F4VE</a></td>
</tr><tr>
<td align="center"><a href="https://modm.io/reference/module/modm-board-stm32_f4ve">STM32-F4VE</a></td>
<td align="center"><a href="https://modm.io/reference/module/modm-board-stm32f030_demo">STM32F030-DEMO</a></td>
</tr>
</table>
Expand Down
183 changes: 183 additions & 0 deletions src/modm/board/nucleo_h723zg/board.hpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,183 @@
/*
* Copyright (c) 2021, Christopher Durand
* Copyright (c) 2021, Niklas Hauser
*
* This file is part of the modm project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
// ----------------------------------------------------------------------------

#pragma once

#include <modm/platform.hpp>
#include <modm/architecture/interface/clock.hpp>
#include <modm/debug/logger.hpp>

using namespace modm::platform;

/// @ingroup modm_board_nucleo_h723zg
/// @{
#define MODM_BOARD_HAS_LOGGER

namespace Board
{
using namespace modm::literals;

/// STM32H723ZG running at 500MHz from PLL clock generated from 8 MHz HSE
struct SystemClock
{
// Max 550MHz
static constexpr uint32_t SysClk = 550_MHz;
// Max 550MHz
static constexpr uint32_t Hclk = SysClk / 1; // D1CPRE
static constexpr uint32_t Frequency = Hclk;
// Max 275MHz
static constexpr uint32_t Ahb = Hclk / 2; // HPRE
static constexpr uint32_t Ahb1 = Ahb;
static constexpr uint32_t Ahb2 = Ahb;
static constexpr uint32_t Ahb3 = Ahb;
static constexpr uint32_t Ahb4 = Ahb;
// Max 137.5MHz
static constexpr uint32_t Apb1 = Ahb / 2; // D2PPRE1
static constexpr uint32_t Apb2 = Ahb / 2; // D2PPRE2
static constexpr uint32_t Apb3 = Ahb / 2; // D1PPRE
static constexpr uint32_t Apb4 = Ahb / 2; // D3PPRE

static constexpr uint32_t Adc1 = Ahb1;
static constexpr uint32_t Adc2 = Ahb1;
static constexpr uint32_t Adc3 = Ahb4;

static constexpr uint32_t Dac1 = Apb1;

static constexpr uint32_t Spi1 = Apb2;
static constexpr uint32_t Spi2 = Apb1;
static constexpr uint32_t Spi3 = Apb1;
static constexpr uint32_t Spi4 = Apb2;
static constexpr uint32_t Spi5 = Apb2;
static constexpr uint32_t Spi6 = Apb4;

static constexpr uint32_t Usart1 = Apb2;
static constexpr uint32_t Usart2 = Apb1;
static constexpr uint32_t Usart3 = Apb1;
static constexpr uint32_t Uart4 = Apb1;
static constexpr uint32_t Uart5 = Apb1;
static constexpr uint32_t Usart6 = Apb2;
static constexpr uint32_t Uart7 = Apb1;
static constexpr uint32_t Uart8 = Apb1;
static constexpr uint32_t Uart9 = Apb2;
static constexpr uint32_t Usart10 = Apb2;

static constexpr uint32_t LpUart1 = Apb4;

static constexpr uint32_t Can1 = Apb1;
static constexpr uint32_t Can2 = Apb1;

static constexpr uint32_t I2c1 = Apb1;
static constexpr uint32_t I2c2 = Apb1;
static constexpr uint32_t I2c3 = Apb1;
static constexpr uint32_t I2c4 = Apb4;
static constexpr uint32_t I2c5 = Apb1;

static constexpr uint32_t Apb1Timer = Apb1 * 2;
static constexpr uint32_t Apb2Timer = Apb2 * 2;
static constexpr uint32_t Timer1 = Apb2Timer;
static constexpr uint32_t Timer2 = Apb1Timer;
static constexpr uint32_t Timer3 = Apb1Timer;
static constexpr uint32_t Timer4 = Apb1Timer;
static constexpr uint32_t Timer5 = Apb1Timer;
static constexpr uint32_t Timer6 = Apb1Timer;
static constexpr uint32_t Timer7 = Apb1Timer;
static constexpr uint32_t Timer8 = Apb2Timer;
static constexpr uint32_t Timer12 = Apb1Timer;
static constexpr uint32_t Timer13 = Apb1Timer;
static constexpr uint32_t Timer14 = Apb1Timer;
static constexpr uint32_t Timer15 = Apb2Timer;
static constexpr uint32_t Timer16 = Apb2Timer;
static constexpr uint32_t Timer17 = Apb2Timer;
static constexpr uint32_t Timer23 = Apb1Timer;
static constexpr uint32_t Timer24 = Apb1Timer;

static constexpr uint32_t Usb = Ahb1;

static bool inline
enable()
{
// Switch core supply voltage to maximum level
// Required for running at 550 MHz
Rcc::setVoltageScaling(Rcc::VoltageScaling::Scale0);

Rcc::enableExternalClock(); // 8 MHz
const Rcc::PllFactors pllFactors1{
.range = Rcc::PllInputRange::MHz1_2,
.pllM = 4, // 8 MHz / 4 = 2 MHz
.pllN = 275, // 2 MHz * 275 = 550 MHz
.pllP = 1, // 500 MHz / 1 = 550 MHz
.pllQ = 2, // 500 MHz / 2 = 275 MHz
.pllR = 2, // 500 MHz / 2 = 275 MHz
};
Rcc::enablePll1(Rcc::PllSource::Hse, pllFactors1);
Rcc::setFlashLatency<Ahb>();

// max. 275MHz
Rcc::setAhbPrescaler(Rcc::AhbPrescaler::Div2);
// max. 137.5MHz on Apb clocks
Rcc::setApb1Prescaler(Rcc::Apb1Prescaler::Div2);
Rcc::setApb2Prescaler(Rcc::Apb2Prescaler::Div2);
Rcc::setApb3Prescaler(Rcc::Apb3Prescaler::Div2);
Rcc::setApb4Prescaler(Rcc::Apb4Prescaler::Div2);

// update clock frequencies
Rcc::updateCoreFrequency<Frequency>();
// switch system clock to pll
Rcc::enableSystemClock(Rcc::SystemClockSource::Pll1P);

return true;
}

};

// Arduino Footprint
#include "nucleo144_arduino.hpp"

using Button = GpioInputC13;

using LedGreen = GpioOutputB0;
using LedYellow = GpioOutputE1;
using LedRed = GpioOutputB14;
using Leds = SoftwareGpioPort< LedRed, LedYellow, LedGreen >;

namespace stlink
{
using Tx = GpioOutputD8;
using Rx = GpioInputD9;
using Uart = Usart3;
}

using LoggerDevice = modm::IODeviceWrapper< stlink::Uart, modm::IOBuffer::BlockIfFull >;


inline void
initialize()
{
SystemClock::enable();
SysTickTimer::initialize<SystemClock>();

stlink::Uart::connect<stlink::Tx::Tx, stlink::Rx::Rx>();
stlink::Uart::initialize<SystemClock, 115200_Bd>();

LedGreen::setOutput(modm::Gpio::Low);
LedYellow::setOutput(modm::Gpio::Low);
LedRed::setOutput(modm::Gpio::Low);

Button::setInput();
Button::setInputTrigger(Gpio::InputTrigger::RisingEdge);
Button::enableExternalInterrupt();
// Button::enableExternalInterruptVector(12);
}

}
/// @}

16 changes: 16 additions & 0 deletions src/modm/board/nucleo_h723zg/board.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
<library>
<repositories>
<repository>
<path>../../../../repo.lb</path>
</repository>
</repositories>

<options>
<option name="modm:target">stm32h723zgt6</option>

<option name="modm:platform:uart:3:buffer.tx">2048</option>
</options>
<modules>
<module>modm:board:nucleo-h723zg</module>
</modules>
</library>
45 changes: 45 additions & 0 deletions src/modm/board/nucleo_h723zg/module.lb
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
#
# Copyright (c) 2016-2018, Niklas Hauser
# Copyright (c) 2017, Fabian Greif
#
# This file is part of the modm project.
#
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
# -----------------------------------------------------------------------------

def init(module):
module.name = ":board:nucleo-h723zg"
module.description = """\
# NUCLEO-H723ZG
[Nucleo kit for STM32H723ZG](https://www.st.com/en/evaluation-tools/nucleo-h723zg.html)
"""

def prepare(module, options):
if not options[":target"].partname.startswith("stm32h723zgt"):
return False

module.depends(
":debug",
":architecture:clock",
":platform:core",
":platform:gpio",
":platform:clock",
":platform:uart:3")

return True

def build(env):
env.outbasepath = "modm/src/modm/board"
env.substitutions = {
"with_logger": True,
"with_assert": env.has_module(":architecture:assert")
}
env.template("../board.cpp.in", "board.cpp")
env.copy('.')
env.copy("../nucleo144_arduino.hpp", "nucleo144_arduino.hpp")
env.collect(":build:openocd.source", "board/st_nucleo_h743zi.cfg");
21 changes: 21 additions & 0 deletions src/modm/board/nucleo_h723zg/startup.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
/*
* Copyright (c) 2021, Christopher Durand
*
* This file is part of the modm project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
// ----------------------------------------------------------------------------

#include <modm/platform.hpp>

using namespace modm::platform;

extern "C" void
modm_initialize_platform(void)
{
// Configure internal voltage regulator
Rcc::configurePowerSource(Rcc::PowerSource::Ldo);
}

0 comments on commit c84e72e

Please sign in to comment.