Skip to content
Permalink
Browse files

boards: arm: Add nucleo for nucleo_g071rb board

This patch adds support for the STM32 nucleo_g071rb board
 from STMicroelectronics.

Signed-off-by: Philippe Retornaz <philippe@shapescale.com>
Signed-off-by: Francois Ramu <francois.ramu@st.com>
  • Loading branch information...
FRASTM authored and MaureenHelm committed Jul 1, 2019
1 parent 26c38a4 commit 9f6a28742d3073f969a01498eac229ebe9edd60b
@@ -0,0 +1,7 @@
# SPDX-License-Identifier: Apache-2.0

if(CONFIG_PINMUX)
zephyr_library()
zephyr_library_sources(pinmux.c)
zephyr_library_include_directories(${ZEPHYR_BASE}/drivers)
endif()
@@ -0,0 +1,11 @@
# Kconfig - STM32 Nucleo-64 development board with STM32G071RB MCU configuration
#
# Copyright (c) 2019 Philippe Retornaz <philippe@shapescale.com>
# Copyright (c) 2019 STMicroelectronics
#
# SPDX-License-Identifier: Apache-2.0
#

config BOARD_NUCLEO_G071RB
bool "NUCLEO-64 G071RB Development Board"
depends on SOC_STM32G071XX
@@ -0,0 +1,21 @@
# Kconfig - STM32 Nucleo-64 development board with STM32G071RB MCU
#
# Copyright (c) 2019 Philippe Retornaz <philippe@shapescale.com>
# Copyright (c) 2019 STMicroelectronics
#
# SPDX-License-Identifier: Apache-2.0
#

if BOARD_NUCLEO_G071RB

config BOARD
default "nucleo_g071rb"

if UART_CONSOLE

config UART_2
default y

endif # UART_CONSOLE

endif # BOARD_NUCLEO_G071RB
@@ -0,0 +1,4 @@
# SPDX-License-Identifier: Apache-2.0
board_runner_args(pyocd "--target=stm32g071rb")

include(${ZEPHYR_BASE}/boards/common/pyocd.board.cmake)
Binary file not shown.
@@ -0,0 +1,179 @@
.. _nucleo_g071rb_board:

ST Nucleo G071RB
################

Overview
********
The Nucleo G071RB board features an ARM Cortex-M0+ based STM32G071RB MCU
with a wide range of connectivity support and configurations. Here are
some highlights of the Nucleo G071RB board:

- STM32 microcontroller in QFP64 package
- Two types of extension resources:

- Arduino Uno V3 connectivity
- ST morpho extension pin headers for full access to all STM32 I/Os

- On-board ST-LINK/V2-1 debugger/programmer with SWD connector
- Flexible board power supply:

- USB VBUS or external source(3.3V, 5V, 7 - 12V)
- Power management access point

- Three LEDs: USB communication (LD1), user LED (LD4), power LED (LD3)
- Two push-buttons: USER and RESET

.. image:: img/nucleo_g071rb.jpg
:width: 500px
:height: 367px
:align: center
:alt: Nucleo G071RB

More information about the board can be found at the `Nucleo G071RB website`_.

Hardware
********
Nucleo G071RB provides the following hardware components:

- STM32 microcontroller in LQFP64 package
- Two types of extension resources:

- Arduino* Uno V3 connectivity
- ST morpho extension pin headers for full access to all STM32 I/Os

- ARM* mbed*
- On-board ST-LINK/V2-1 debugger/programmer with SWD connector:

- Selection-mode switch to use the kit as a standalone ST-LINK/V2-1

- Flexible board power supply:

- USB VBUS or external source (3.3V, 5V, 7 - 12V)
- Power management access point

- Three LEDs:

- USB communication (LD1), user LED (LD4), power LED (LD3)

- Two push-buttons: USER and RESET
- USB re-enumeration capability. Three different interfaces supported on USB:

- Virtual COM port
- Mass storage
- Debug port

- Support of wide choice of Integrated Development Environments (IDEs) including:

- IAR
- ARM Keil
- GCC-based IDEs

More information about STM32G071RB can be found here:

- `G071RB on www.st.com`_
- `STM32G071 reference manual`_


Supported Features
==================

The Zephyr nucleo_g071rb board configuration supports the following hardware features:

+-----------+------------+-------------------------------------+
| Interface | Controller | Driver/Component |
+===========+============+=====================================+
| NVIC | on-chip | nested vector interrupt controller |
+-----------+------------+-------------------------------------+
| UART | on-chip | serial port-polling; |
| | | serial port-interrupt |
+-----------+------------+-------------------------------------+
| PINMUX | on-chip | pinmux |
+-----------+------------+-------------------------------------+
| GPIO | on-chip | gpio |
+-----------+------------+-------------------------------------+
| CLOCK | on-chip | reset and clock control |
+-----------+------------+-------------------------------------+

Other hardware features are not yet supported in this Zephyr port.

The default configuration can be found in the defconfig file:
``boards/arm/nucleo_g071rb/nucleo_g071rb_defconfig``

Connections and IOs
===================

Each of the GPIO pins can be configured by software as output (push-pull or open-drain), as
input (with or without pull-up or pull-down), or as peripheral alternate function. Most of the
GPIO pins are shared with digital or analog alternate functions. All GPIOs are high current
capable except for analog inputs.

Default Zephyr Peripheral Mapping:
----------------------------------

- UART_1 TX/RX : PC4/PC5
- UART_2 TX/RX : PA2/PA3 (ST-Link Virtual Port Com)
- USER_PB : PC13
- LD4 : PA5

For mode details please refer to `STM32 Nucleo-64 board User Manual`_.

Programming and Debugging
*************************

Applications for the ``nucleo_g071rb`` board configuration can be built and
flashed in the usual way (see :ref:`build_an_application` and
:ref:`application_run` for more details).

Flashing
========

Nucleo G071RB board includes an ST-LINK/V2-1 embedded debug tool interface.
This interface is not yet supported by the openocd version included in the Zephyr SDK.
Instead, support can be enabled on pyocd by adding "pack" support with
the following pyocd command:

.. code-block:: console

$ pyocd pack --install stm32g071rb

Flashing an application to Nucleo G071RB
----------------------------------------

Here is an example for the :ref:`blinky-sample` application.

.. zephyr-app-commands::
:zephyr-app: samples/basic/blinky
:board: nucleo_g071rb
:goals: build flash

You will see the LED blinking every second.

Debugging
=========

You can debug an application in the usual way. Here is an example for the
:ref:`hello_world` application.

.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: nucleo_g071rb
:maybe-skip-config:
:goals: debug

References
**********

.. target-notes::

.. _Nucleo G071RB website:
http://www.st.com/en/evaluation-tools/nucleo-g071rb.html

.. _STM32G071 reference manual:
http://www.st.com/resource/en/reference_manual/dm00371828.pdf

.. _STM32 Nucleo-64 board User Manual:
http://www.st.com/resource/en/user_manual/dm00452640.pdf

.. _G071RB on www.st.com:
http://www.st.com/en/microcontrollers/stm32g071rb.html
@@ -0,0 +1,49 @@
/*
* Copyright (c) 2019 Philippe Retornaz <philippe@shapescale.com>
* Copyright (c) 2019 STMicroelectronics
*
* SPDX-License-Identifier: Apache-2.0
*/

/dts-v1/;
#include <st/g0/stm32g071Xb.dtsi>

/ {
model = "STMicroelectronics STM32G071RB-NUCLEO board";
compatible = "st,stm32g071rb-nucleo", "st,stm32g071";

chosen {
zephyr,console = &usart2;
zephyr,shell-uart = &usart2;
zephyr,sram = &sram0;
zephyr,flash = &flash0;
};

leds {
compatible = "gpio-leds";
green_led_1: led_4 {
gpios = <&gpioa 5 GPIO_INT_ACTIVE_LOW>;
label = "User LD4";
};
};

gpio_keys {
compatible = "gpio-keys";
user_button: button {
label = "User";
gpios = <&gpioa 0 GPIO_INT_ACTIVE_LOW>;
};
};

aliases {
led0 = &green_led_1;
sw0 = &user_button;
};
};

&usart2 {
current-speed = <115200>;
pinctrl-0 = <&usart2_pins_a>;
pinctrl-names = "default";
status = "ok";
};
@@ -0,0 +1,13 @@
identifier: nucleo_g071rb
name: NUCLEO-G071RB
type: mcu
arch: arm
toolchain:
- zephyr
- gnuarmemb
- xtools
ram: 36
flash: 128
supported:
- uart
- gpio
@@ -0,0 +1,37 @@
# Zephyr Kernel Configuration
CONFIG_ARM=y
CONFIG_SOC_SERIES_STM32G0X=y
CONFIG_SOC_STM32G071XX=y
CONFIG_CORTEX_M_SYSTICK=y
CONFIG_BOARD_NUCLEO_G071RB=y

# 64MHz system clock
CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC=64000000

# Serial Drivers
CONFIG_SERIAL=y
CONFIG_UART_INTERRUPT_DRIVEN=y
# enable console
CONFIG_CONSOLE=y
CONFIG_UART_CONSOLE=y

# Pinmux Driver
CONFIG_PINMUX=y

# GPIO Controller
CONFIG_GPIO=y

# Clock configuration
CONFIG_CLOCK_CONTROL=y
# SYSCLK selection
CONFIG_CLOCK_STM32_SYSCLK_SRC_PLL=y
# PLL configuration
CONFIG_CLOCK_STM32_PLL_SRC_HSI=y
# produce 64MHz clock at PLL output
CONFIG_CLOCK_STM32_PLL_M_DIVISOR=1
CONFIG_CLOCK_STM32_PLL_N_MULTIPLIER=8
CONFIG_CLOCK_STM32_PLL_P_DIVISOR=2
CONFIG_CLOCK_STM32_PLL_Q_DIVISOR=2
CONFIG_CLOCK_STM32_PLL_R_DIVISOR=2
CONFIG_CLOCK_STM32_AHB_PRESCALER=1
CONFIG_CLOCK_STM32_APB1_PRESCALER=1
@@ -0,0 +1,34 @@
/*
* Copyright (c) 2019 Philippe Retornaz <philippe@shapescale.com>
* Copyright (c) 2019 STMicroelectronics
*
* SPDX-License-Identifier: Apache-2.0
*/

#include <kernel.h>
#include <device.h>
#include <init.h>
#include <pinmux.h>
#include <sys_io.h>

#include <pinmux/stm32/pinmux_stm32.h>

/* pin assignments for NUCLEO-G071RB board */
static const struct pin_config pinconf[] = {
#ifdef CONFIG_UART_2
{STM32_PIN_PA2, STM32G0_PINMUX_FUNC_PA2_USART2_TX},
{STM32_PIN_PA3, STM32G0_PINMUX_FUNC_PA3_USART2_RX},
#endif /* CONFIG_UART_2 */
};

static int pinmux_stm32_init(struct device *port)
{
ARG_UNUSED(port);

stm32_setup_pins(pinconf, ARRAY_SIZE(pinconf));

return 0;
}

SYS_INIT(pinmux_stm32_init, PRE_KERNEL_1,
CONFIG_PINMUX_STM32_DEVICE_INITIALIZATION_PRIORITY);

0 comments on commit 9f6a287

Please sign in to comment.
You can’t perform that action at this time.