YARH.IO M2

System & Software

Software packages

sudo apt install tmux vim mc -y

HyperPixel screen

curl -sSL https://get.pimoroni.com/hyperpixel4 | bash
hyperpixel4-rotate right

Turn off HyperPixel on shutdown

The original link: https://github.com/pimoroni/hyperpixel4/issues/3. Thank you Florian Mirkes.

# Create /etc/systemd/system/hyperpixel4-backlight.service and add the following:

[Unit]
Description=Sets up gpio-poweroff to handle Hyperpixel backlight upon shutdown/reboot
ConditionPathExists=/usr/bin/hyperpixel4-init
ConditionPathExists=/boot/overlays/gpio-poweroff.dtbo
ConditionPathExists=/usr/bin/dtoverlay
DefaultDependencies=no
Before=umount.target
[Service]
Type=oneshot
ExecStart=/bin/sh -c '/sbin/rmmod gpio-backlight;/usr/bin/dtoverlay /boot/overlays/gpio-poweroff.dtbo gpiopin=19 active_low=1'
[Install]
WantedBy=reboot.target halt.target poweroff.target

sudo systemctl enable hyperpixel4-backlight.service
sudo systemctl start hyperpixel4-backlight.service

Enable right-click for the Raspberry Pi touchscreen

The original article: https://fmirkes.github.io/articles/20190827.html. Thank you Philip Howard.

sudo apt install build-essential libevdev2 libevdev-dev -y
git clone 'https://github.com/PeterCxy/evdev-right-click-emulation.git'
cd 'evdev-right-click-emulation'
make all
sudo cp 'out/evdev-rce' '/usr/local/bin/'
sudo chmod +x '/usr/local/bin/evdev-rce'

# Add evdev-rce to startup
sudo usermod -G 'input' -a pi
echo 'uinput' | sudo tee -a /etc/modules

# Edit: /etc/udev/rules.d/99-uinput.rules
KERNEL=="uinput", MODE="0660", GROUP="input"

sudo udevadm control --reload-rules
sudo udevadm trigger

mkdir ~/.config/autostart

# Create: ~/.config/autostart/evdev-rce.desktop and add the following:

[Desktop Entry]
Version=1.0
Type=Application
Name=evdev-rce
GenericName=Enable long-press-to-right-click gesture
Exec=env LONG_CLICK_INTERVAL=500 LONG_CLICK_FUZZ=50 /usr/local/bin/evdev-rce
Terminal=true
StartupNotify=false

RTC

# Create: ~/.rtc-init.sh and add the following:
echo "ds1307 0x68" | sudo -E tee -a /sys/bus/i2c/devices/i2c-11/new_device

sudo chmod +x ~/.rtc-init.sh

# Create ~/.config/autostart/rtc-init.desktop and add the following:

[Desktop Entry]
Version=1.0
Type=Application
Name=rtc-init
GenericName=Initialize ds3231 RTC on non standard i2c-11 bus, address 0x68
Exec=sh /home/pi/.rtc-init.sh
Terminal=true
StartupNotify=false

Bluetooth Keyboard

To connect Bluetooth keyboard for the first time use Bluetooth icon on the menu bar and select Add device. Press hard the Blue Bluetooth button on the keyboard, blue light on the keyboard starts blinking. The keyboard icon and name Bluetooth Keyboard should appear in the Bluetooth devices list. Select and Pair. Enter the digits as prompted on the screen and press Enter key.

To connect Bluetooth keyboard after device reboot, wait until the system completely loaded and press Enter button, blue light on the keyboard start blinking. As soon as blue light turned off the keyboard connected and ready to use.

Remapping Keyboard

The keyboard used has no TAB key. Therefore the FN+Caps remapped to Tab.

# Edit: /usr/share/X11/xkb/symbols/pc and replace existing mapping for <CAPS> with the following one:
key <CAPS> { [ Tab, ISO_Left_Tab ] };

There are keys on the keyboard which can be used to simplify window control. FN+1 - switch between applications, FN+L - maximize current window, FN+0 - perform "sudo shutdown now".

# Edit: /etc/xdg/openbox/lxde-pi-rc.xml and add/replace the following under <keyboard> key:
<keybind key="XF86Mail">
   <action name="Maximize"/>
</keybind>
<keybind key="XF86HomePage">
   <action name="NextWindow"/>
</keybind>

sudo dpkg-reconfigure xkb-data