.. zephyr:code-sample:: stm32_pm_gpio_wkup_src
   :name: GPIO as a wake-up pin source
   :relevant-api: sys_poweroff gpio_interface

   Use a GPIO as a wake-up pin source.

Overview
********

This sample is a minimum application to demonstrate using a wake-up pin with a GPIO as
a source to power on an STM32 SoC after Poweroff.

The system will power off automatically ``WAIT_TIME_US`` us after boot.
Press the user button designated in boards's devicetree overlay as "wkup-src" to power it on again.

.. _gpio-as-a-wkup-pin-src-sample-requirements:

Requirements
************

The SoC should support POWEROFF functionality & have a wake-up pin that corresponds
to the GPIO pin of a user button.
To support another board, add an overlay in boards folder.
Make sure that wake-up pins are configured in SoC dtsi file.

Building and Running
********************

Build and flash wkup_pins as follows, changing ``nucleo_u5a5zj_q`` for your board:

.. zephyr-app-commands::
   :zephyr-app: samples/boards/st/power_mgmt/wkup_pins
   :board: nucleo_u5a5zj_q
   :goals: build flash
   :compact:

After flashing, the LED in ON.
The LED will be turned off when the system is powered off.
Press the user button to power on the system again.