Skip to content

Latest commit

 

History

History
122 lines (76 loc) · 3.7 KB

README.md

File metadata and controls

122 lines (76 loc) · 3.7 KB
Raw

Cyberdeck Setup Guide

This guide provides step-by-step instructions for configuring your Cyberdeck, including setting up the LCD display orientation, enabling Bluetooth keyboard functionality, and increasing the terminal font size.

Parts used

1. Change the Rotation of the LCD Display Video

The following instructions are from this thread. Thanks RPi Community!

To rotate the LCD display to a horizontal orientation:

  1. Open the cmdline.txt file located in /boot/firmware/:

    sudo nano /boot/firmware/cmdline.txt

  2. Add or update the following parameter:

    video=HDMI-A-1:480x1920@60,rotate=270

  3. Ensure the entire line in the file looks similar to this:

    console=serial0,115200 console=tty1 root=PARTUUID=247a1fd9-02 rootfstype=ext4 fsck.repair=yes rootwait cfg80211.ieee80211_regdom=US video=HDMI-A-1:480x1920@60,rotate=270

    Note: Replace PARTUUID and other parameters with those already present in your file.

  4. Save the file and exit.

  5. Reboot the system for the changes to take effect:

    sudo reboot

2. Set Up the Bluetooth Keyboard

Why Use expect Instead of Plain Bash?

The bluetoothctl tool requires interactive commands for setting up and managing Bluetooth devices. The default-agent command, in particular, does not succeed in plain bash scripts because it reports "No agent is registered" even when the command sequence is correct. This happens because bluetoothctl expects a live session where the agent is explicitly registered (agent on) before setting it as the default agent.

Using expect allows us to simulate these interactions programmatically, ensuring that:

  1. The agent is successfully registered (agent on).
  2. The default-agent command succeeds in setting the registered agent.

This makes it possible to automate Bluetooth keyboard pairing and reconnection processes reliably.

Create a Script to Manage Bluetooth Keyboard

  1. Create the script file:

    sudo nano /usr/local/bin/enable-default-agent-and-pair.sh

  2. Copy the script from the scripts/enable-default-agent-and-pair.sh file included in this project.

  3. Make the script executable:

    sudo chmod +x /usr/local/bin/enable-default-agent-and-pair.sh

Automate the Script with Systemd

  1. Copy the keyboard-monitor.service and keyboard-monitor.timer files from the systemd/ directory into /etc/systemd/system/:

    sudo cp systemd/keyboard-monitor.* /etc/systemd/system/

  2. Enable and start the timer:

    sudo systemctl daemon-reload
sudo systemctl enable keyboard-monitor.timer
sudo systemctl start keyboard-monitor.timer

3. Increase the Terminal Font Size

To increase the font size in the terminal:

For Console (TTY, Non-Graphical Terminal)

  1. Run the following command:

    sudo dpkg-reconfigure console-setup

  2. Follow the prompts:

    • Select UTF-8 as the character set.
    • Choose Terminus as the font.
    • Select 16x32 as the font size.

  3. Reboot to apply changes.

Verification

  • Reboot the system and verify that the LCD is oriented correctly.
  • Turn the Bluetooth keyboard off and on to confirm it reconnects automatically.
  • Check the terminal font size to ensure readability.