nPM1300 and nPM1304: One button

The One button sample demonstrates how to support wake-up, shutdown, and user interactions of nPM1300 or nPM1304 using a single button connected to the PMIC’s SHPHLD/RESET pin.

Requirements

The sample supports the following development kits:

Hardware platforms

PCA

Board name

Board target

nRF9160 DK

PCA10090

nrf9160dk

nrf9160dk/nrf9160

nRF54LM20 DK

PCA10184

nrf54lm20dk

nrf54lm20dk/nrf54lm20b/cpuapp nrf54lm20dk/nrf54lm20a/cpuapp

nRF54L15 DK

PCA10156

nrf54l15dk

nrf54l15dk/nrf54l15/cpuapp

nRF54H20 DK

PCA10175

nrf54h20dk

nrf54h20dk/nrf54h20/cpuapp

nRF5340 DK

PCA10095

nrf5340dk

nrf5340dk/nrf5340/cpuapp

nRF52 DK

PCA10040

nrf52dk

nrf52dk/nrf52832

nRF52840 DK

PCA10056

nrf52840dk

nrf52840dk/nrf52840

The sample also requires an nPM1300 EK or an nPM1304 EK that you need to connect to the development kit as described in Wiring.

Overview

The PMIC’s SHPHLD/RESET button controls the device state. The sample controls an LED, load switch and PMIC power mode based on button press duration.

The PMIC’s GPIO3 pin is configured as an interrupt output, and is used to signal button press and USB detection events to the host.

Wiring

To connect your DK to the nPM1300 or nPM1304 EK, complete the following steps:

  1. Make the following connections on the EK:

    1. Remove all existing connections, including jumpers and USB-C cables.

    2. On the P1 pin header, connect VBATIN and VBAT pins with a jumper.

    3. On the P13 pin header, connect RSET1 and VSET1 pins with a jumper.

    4. On the P14 pin header, connect RSET2 and VSET2 pins with a jumper.

    5. On the P15 pin header, connect VOUT1 and LSIN1 pins with a jumper.

    6. On the P17 pin header, connect HOST and LED2 pins with a jumper.

    7. Connect a suitable battery to either the J2 or J1 connector. When using the nPM1304-EK, the J3 connector can also be used.

    With these connections the battery is powering the EK, the BUCK regulators are enabled, and the I/O reference voltage is supplied by a DK as described in the next step.

  2. Connect the chosen DK to the EK as in the following table:

    nPM1300/nPM1304 EK connections.

    PMIC EK pins

    nRF52 DK pins

    nRF52840 DK pins

    nRF5340 DK pins

    nRF54L15/nRF54LM20 DK pins

    nRF54H20 DK pins

    nRF9160 DK pins

    SDA

    P0.26

    P0.26

    P1.02

    P1.11

    P0.05

    P0.30

    SCL

    P0.27

    P0.27

    P1.03

    P1.12

    P0.00

    P0.31

    GPIO3

    P0.04

    P0.04

    P0.04

    P0.04

    P0.04

    P0.04

    VDDIO

    VDD

    VDD

    VDD

    VDDIO

    VDD_P0

    VDD

    GND

    GND

    GND

    GND

    GND

    GND

    GND

Note

When using the nRF54L15 DK, the PMIC GPIO3 interrupt pin assignment uses the DK’s BUTTON 3 pin.

Building and running

This sample can be found under samples/pmic/native/npm13xx_one_button in the nRF Connect SDK folder structure.

To build the sample, follow the instructions in Building an application for your preferred building environment. See also Programming an application for programming steps and Testing and optimization for general information about testing and debugging in the nRF Connect SDK.

Note

When building repository applications in the SDK repositories, building with sysbuild is enabled by default. If you work with out-of-tree freestanding applications, you need to manually pass the --sysbuild parameter to every build command or configure west to always use it.

To build this sample for either nPM1300 or nPM1304, you need to apply the respective extra DTC overlay. You can use either the nRF Connect for VS Code extension or the command line.

To apply an extra overlay, choose the respective file from the Extra Devicetree overlays drop-down menu

Testing

After programming the sample to your development kit, complete the following steps to test it:

  1. Connect the kit to the computer using a USB cable. The kit is assigned a serial port. Serial ports are referred to as COM ports on Windows, /dev/ttyACM devices on Linux, and /dev/tty devices on macOS. To list Nordic Semiconductor devices connected to your computer together with their serial ports, open a terminal and run the nrfutil device list command. Alternatively, check your operating system’s device manager or its equivalent.

  2. Connect to the kit with a terminal emulator (for example, the Serial Terminal app). See Testing and optimization for the required settings and steps.

If the initialization was successful, the terminal displays the following message with status information:

PMIC device ok

Different length button presses:

Duration

Log output

Outcome

< 1 sec

Short press

Sample flashes LED at 5 Hz, LDSW 1 enabled

1 - 5 sec

Medium press

Sample flashes LED at 1 Hz, LDSW 1 disabled

5 - 10 sec

Long press

PMIC enters ship mode provided J3 is not connected

> 10 sec

None

PMIC long press reset activates

Ship mode is the lowest power state of the PMIC. To exit ship mode, press the SHPHLD button or attach a USB cable to J3. In a production design, this powers off any device that is powered from a PMIC output.

The long press reset performs a full power cycle of the PMIC and resets all setting to powerup defaults. In a production design, this power cycles any device that is powered from a PMIC output.

When using a separately powered development kit, you must restart the application to reconfigure the PMIC after exiting the ship mode or long press reset.

Dependencies

The sample uses the following Zephyr libraries: