.. zephyr:board:: nucleo_g0b1re Overview ******** The Nucleo G0B1RE board features an ARM Cortex-M0+ based STM32G0B1RE MCU with a wide range of connectivity support and configurations. Here are some highlights of the Nucleo G0B1RE board: - STM32 microcontroller in QFP64 package - Board connectors: - 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: - 5V_USB_STLK from ST-Link USB connector - VIN (7 - 12V) from ARDUINO connector or ST morpho connector - E5V from ST morpho connector - 5V_USB_CHG from ST-LINK USB connector - 3.3V on ARDUINO connector or ST morpho connector - Three LEDs: USB communication (LD1), user LED (LD4), power LED (LD3) - Two push-buttons: USER and RESET - 32.768 kHz crystal oscillator More information about the board can be found at the `Nucleo G0B1RE website`_. Hardware ******** Nucleo G0B1RE provides the following hardware components: - STM32G0B1RE in LQFP64 package - ARM 32-bit Cortex-M0+ CPU - 64 MHz max CPU frequency - Voltage range from 1.7 V to 3.6 V - 512 KB Flash - 144 kB SRAM - 32-bit timers(1) - 16-bit timers(11) - watchdogs(2) - systick(1) - Calendar RTC with alarm and periodic wakeup - I2C(3) - USART(6) - LPUART(2) - 32 Mbit/s SPI(3) multiplexed with I2S(2) - HDMI_CEC(1) - USB 2.0 FS device (crystal-less) and host controller(1) - USB Type-C Power Delivery controller - CAN FD(2) - GPIO (up to 94) with external interrupt capability - Tamper Pins(3) - 12-bit ADC with 16 channels - 12-bit DAC with 2 channels(2) - Analog Comparator(3) - 12-channel DMA More information about STM32G0B1RE can be found here: - `G0B1RE on www.st.com`_ - `STM32G0B1 reference manual`_ Supported Features ================== The Zephyr nucleo_g0b1re board configuration supports the following hardware features: +-----------+------------+-------------------------------------+ | Interface | Controller | Driver/Component | +===========+============+=====================================+ | MPU | on-chip | arm memory protection unit | +-----------+------------+-------------------------------------+ | NVIC | on-chip | nested vector interrupt controller | +-----------+------------+-------------------------------------+ | UART | on-chip | serial port-polling; | | | | serial port-interrupt | +-----------+------------+-------------------------------------+ | PINMUX | on-chip | pinmux | +-----------+------------+-------------------------------------+ | GPIO | on-chip | gpio | +-----------+------------+-------------------------------------+ | I2C | on-chip | i2c | +-----------+------------+-------------------------------------+ | SPI | on-chip | spi | +-----------+------------+-------------------------------------+ | CLOCK | on-chip | reset and clock control | +-----------+------------+-------------------------------------+ | COUNTER | on-chip | rtc | +-----------+------------+-------------------------------------+ | WATCHDOG | on-chip | independent watchdog | +-----------+------------+-------------------------------------+ | PWM | on-chip | pwm | +-----------+------------+-------------------------------------+ | ADC | on-chip | adc | +-----------+------------+-------------------------------------+ | DAC | on-chip | dac | +-----------+------------+-------------------------------------+ | die-temp | on-chip | die temperature sensor | +-----------+------------+-------------------------------------+ | FDCAN | on-chip | CAN controller | +-----------+------------+-------------------------------------+ Other hardware features are not yet supported in this Zephyr port. The default configuration can be found in the defconfig file: :zephyr_file:`boards/st/nucleo_g0b1re/nucleo_g0b1re_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) - I2C1 SCL/SDA : PB8/PB9 (Arduino I2C) - I2C2 SCL/SDA : PA11/PA12 - SPI1 NSS/SCK/MISO/MOSI : PB0/PA5/PA6/PA7 (Arduino SPI) - SPI2 NSS/SCK/MISO/MOSI : PB12/PB13/PB14/PB15 - USER_PB : PC13 - LD4 : PA5 - PWM : PA6 - ADC1 IN0 : PA0 - ADC1 IN1 : PA1 - DAC1_OUT1 : PA4 - FDCAN1 RX/TX: PA11/PA12 - FDCAN2 RX/TX: PB0/PB1 For more details please refer to `STM32 Nucleo-64 board User Manual`_. Programming and Debugging ************************* Nucleo G0B1RE board includes an ST-LINK/V2-1 embedded debug tool interface. Applications for the ``nucleo_g0b1re`` board configuration can be built and flashed in the usual way (see :ref:`build_an_application` and :ref:`application_run` for more details). Flashing ======== The board is configured to be flashed using west `STM32CubeProgrammer`_ runner, so its :ref:`installation ` is required. Alternatively, OpenOCD, JLink, or pyOCD can also be used to flash the board using the ``--runner`` (or ``-r``) option: .. code-block:: console $ west flash --runner openocd $ west flash --runner jlink $ west flash --runner pyocd For STM32G0 support pyocd needs additional target information, which can be installed by adding "pack" support with the following pyocd command: .. code-block:: console $ pyocd pack --update $ pyocd pack --install stm32g0 Flashing an application to Nucleo G0B1RE ---------------------------------------- Here is an example for the :zephyr:code-sample:`blinky` application. .. zephyr-app-commands:: :zephyr-app: samples/basic/blinky :board: nucleo_g0b1re :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 :zephyr:code-sample:`hello_world` application. .. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_g0b1re :maybe-skip-config: :goals: debug References ********** .. target-notes:: .. _Nucleo G0B1RE website: https://www.st.com/en/evaluation-tools/nucleo-g0b1re.html .. _STM32G0B1 reference manual: https://www.st.com/resource/en/reference_manual/dm00371828.pdf .. _STM32 Nucleo-64 board User Manual: https://www.st.com/resource/en/user_manual/dm00452640.pdf .. _G0B1RE on www.st.com: https://www.st.com/en/microcontrollers/stm32g0b1re.html .. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html