Power Off and Wake Up using GPIO Key Button

This section describes how to set up GPIO key button for power off and wake up purpose.

1. Hardware Set-up
2. Available Keys
3. SW Set-up (1) Ubuntu
4. SW Set-up (2) Android
5. Troubleshooting

The brief set-up flow is as following.

1. Connect a tab button to the pin port you want to use
2. Set GPIO number using boot.ini
3. Compiling and flash the modified kernel dts : This part is only needed on ANDROID.

First, You need to prepare a tab switch that are connected to two lines.
Red line is for Power Button and another Gray line is for the active level line (Ground or 3.3V Power).

For example, we will use Pin#29 of 40pin expansion connector.

The pin is assigned to GPIOX.BIT0 and its GPIO number is #228.
Connect the red line to Pin#29.

Its default pin pulled status is high and switch active will be Low, so you should connect the gray line of tab switch to Ground (GND), Pin#30.

Here are the available key examples using 40-pin connector and 7-pin connector.
You can find the pin assign examples for Red Line and Gray Line.

(1) J2 - 2×20 pins

(2) J7 - 1×7 pins

You can find the detailed information about 40-pin and 7-pin connectors in the following link.
Expansion Connectors

You can assign GPIO number with env gpiopower in boot.ini.

## gpio power key : J2 (2x20) Pin#29 , GPIOX.BIT0
setenv gpiopower "228"
...
...
 
## Add gpiopower like "setenv bootargs ${bootargs} gpiopower=${gpiopower}"
setenv bootargs "root=UUID=e139ce78-9841-40fe-8823-96a304a09859 rootwait ro ${condev} no_console_suspend hdmimode=${m} ${cmode} m_bpp=${m_bpp} vout=${vout} fsck.repair=yes net.ifnames=0 elevator=noop disablehpd=${hpd} max_freq=${max_freq} maxcpus=${maxcpus} monitor_onoff=${monitor_onoff} disableuhs=${disableuhs} mmc_removable=${mmc_removable} usbmulticam=${usbmulticam} ${hid_quirks} gpiopower=${gpiopower}"

To set poweroff event with this GPIO power button, acpi service is used.

$ sudo apt-get install acpid

After acpid installation, a default file of powerbtn.sh under /etc/acpi/ will be generated.
You need to replace it with a new powerbtn.sh as following.

$ sudo mv /etc/acpi/powerbtn.sh /etc/acpi/powerbtn.sh.bak
$ sudo vi /etc/acpi/powerbtn.sh

#!/bin/sh
# /etc/acpi/powerbtn.sh
# Initiates a shutdown when the power putton has been
# pressed.
 
# Shuts down as soon as power button is pressed on NUC
/sbin/shutdown -h now "Power button pressed"
exit 0

$ sudo chmod a+x /etc/acpi/powerbtn.sh

$ sudo systemctl enable acpid.service
$ sudo systemctl start acpid.service

Please uncomment the line, HandlePowerKey=poweroff.

$ sudo vi /etc/systemd/logind.conf

Here are the samples for Ubuntu 16.04 and Ubuntu 18.04.

• logind.conf with Ubuntu 16.04

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.
#
# Entries in this file show the compile time defaults.
# You can change settings by editing this file.
# Defaults can be restored by simply deleting this file.
#
# See logind.conf(5) for details.
 
[Login]
#NAutoVTs=6
#ReserveVT=6
#KillUserProcesses=no
#KillOnlyUsers=
#KillExcludeUsers=root
#InhibitDelayMaxSec=5
HandlePowerKey=poweroff
#HandleSuspendKey=suspend
#HandleHibernateKey=hibernate
#HandleLidSwitch=suspend
#HandleLidSwitchDocked=ignore
#PowerKeyIgnoreInhibited=no
#SuspendKeyIgnoreInhibited=no
#HibernateKeyIgnoreInhibited=no
#LidSwitchIgnoreInhibited=yes
#HoldoffTimeoutSec=30s
#IdleAction=ignore
#IdleActionSec=30min
#RuntimeDirectorySize=10%
#RemoveIPC=yes
#UserTasksMax=12288

• logind.conf with Ubuntu 18.04

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.
#
# Entries in this file show the compile time defaults.
# You can change settings by editing this file.
# Defaults can be restored by simply deleting this file.
#
# See logind.conf(5) for details.
 
[Login]
#NAutoVTs=6
#ReserveVT=6
#KillUserProcesses=no
#KillOnlyUsers=
#KillExcludeUsers=root
#InhibitDelayMaxSec=5
HandlePowerKey=poweroff
#HandleSuspendKey=suspend
#HandleHibernateKey=hibernate
#HandleLidSwitch=suspend
#HandleLidSwitchDocked=ignore
#PowerKeyIgnoreInhibited=no
#SuspendKeyIgnoreInhibited=no
#HibernateKeyIgnoreInhibited=no
#LidSwitchIgnoreInhibited=yes
#HoldoffTimeoutSec=30s
#IdleAction=ignore
#IdleActionSec=30min
#RuntimeDirectorySize=10%
#RemoveIPC=yes
#InhibitorsMax=8192
#SessionsMax=8192
#UserTasksMax=33%

To wake-up after power off, long-pressing over 2 seconds is needed.

In case of Android, you have to modify the dts file to activate gpio key functionality.

C2 Android DTS

<kernel_path>/arch/arm64/boot/dts/meson64_odroidc2.dts

...
gpio_keypad{
    .
    status = "okay";
    .
};
...

After compiling the dts file, you can flash the dtb file to the board.

In kernel:

$ make odroidc2_defconfig
$ make dtbs
$ fastboot flash dtb arch/arm64/boot/dts/meson64_odroidc2.dtb
$ fastboot reboot

You have to flash dtbs file when board it is in u-boot fastboot mode.

In board:

$ reboot fastboot

In Android boot.ini, you can find a “gpiopower” example. Uncomment “gpiopower” part and modify the number with the number you want to use.

## gpio power key : J2 (2x20) Pin#29 , GPIOX.BIT0
setenv gpiopower "228"

In Android, you don't need to set any menu for power button actions but it's already defined as following.

One short power key event is used for sleep, and with long key event, you can handle options of power off/reboot.
With Android Marshmallow v2.4 or higher version, it's available to enter power off using long-pressing (5 sec).

And to wake-up after power off, long-pressing over 2 seconds is needed.

It's needed to modify and re-build dts file to use some ports that acts as Active High.
Please add gpio_high_z in gpio_keypad part.

<kernel_path>/arch/arm64/boot/dts/meson64_odroidc2.dts

gpio_keypad{
    .
    gpio_high_z = <1>;
    .
};

https://forum.odroid.com/viewtopic.php?f=137&t=27602#p195995

https://forum.odroid.com/viewtopic.php?f=136&t=27636

https://forum.odroid.com/viewtopic.php?f=136&t=30923