Pyra Unofficial Quick Reference


jedi23

Very Active Member
Joined
Aug 11, 2020
Messages
203
I wrote a little guide helping beginners and serving as a quick reference because many useful information are scattered throughout different places like the Forum, the Wiki (where you also find the manual) or the FAQ sections (both in the Wiki and the Forum thread).

I would also like to add any source where these topics are usually described. This can be weblinks or a reference to the user manual, etc.
If I miss such a reference and you know where it is officially described, please let me know.

If some sources may contain wrong or missing information it will be mentioned here and it should be good to correct or amend the according source. Because the official manual and the Wiki should preferrably be the best source for information.

This guide has only the purpose to
- help improving the official sources
- help beginners who wants to get all information needed to setup and operate their hardware in one single document
- having a quick reference to quickly find a solution to a problem or question

Sections beginning with !? provide extra information for linux beginners, but even experienced users may find some useful stuff here.

And of course I am happy to amend this guide with the help of your feedback :)


Pyra Unofficial Quick Reference
----------------------------------------------------

------

Buttons and nubs:

-The shoulder buttons represent the Shift (L1), CTRL (R1), AltGr (R2) and Fn (L2) keys.

-At desktop use, the nubs have the following functions:
- left nub movement moves the mouse cursor.
-> Click the nub for a left mouse button click.
- right nub movement is divided into four functions:
- left and right movement are for left and right mouse button click.
- up and down movement are for PgUp and PgDn
-> Click the nub for a right mouse button click.

It may sound complicated at the beginning but you really get used to it! Some functions seem redundant, but there are situations where it makes sense to have serveral ways to do a task. An Example: to select a text, it's easier to move the right nub carefully to the left position and then move the left nub to mark the desired text. Using only the left nub to mark texts or files is also possible but it's more difficult to press the nub and move it at the same time. After your texts or files have been marked, you can press R1+c and R1+v to copy and paste it.

------

Shortcuts:

- Terminal: press CTRL (R1) + Meta (Pyra) to access the bash via MATE Terminal. (It's my favorite shortcut :) )
- File Manager: AltGr (R2) + Home (A)

- own shortcuts: navigate to System/Preferences/Hardware/Keyboard Shortcuts

TIP: I recommend to add a shortcut for the text editor:
click on +Add
Name: Text Editor
Command: pluma
Double click on your new entry and assign a nice shortcut like CTRL (R1) + T for example.

------

First run:

The first thing to do after the configuration wizard is completed and the device restarted, is to connect to the internet and do a system update.
Click on the network icon in the task bar and select your network. Open a Terminal window and write
$ sudo apt update && sudo apt upgrade

TIP: You can disable bluetooth to save some battery if you don't need it.

You surely want to install a web browser. One of the fastest browsers for the Pyra is Vivaldi, which is not included in the debian repositories and has to be downloaded sperately. (https://repo.vivaldi.com/archive/deb/pool/main/)
Then navigate to the folder and run
$ sudo dpkg -i vi... (hit tab to get the full file name)

TIP: Keep the deb-file in case you want to setup a second OS on SD card!

TIP: Get used to switching browser tabs with CTRL (R1) + PgUP (Y) or PgDn (X) and keep in mind that you can use the F11 key to switch the browser to fullscreen mode. On a small handheld device, this will greatly improve your browsing experience!

And of course you should install the DBP Installer!

It's best to install all games or apps available on the DBP repository via the DBP Installer made by sebt3 because it also installs all additionally needed Debian packages and dependencies to ensure that your apps run nice and smooth.
It's also recommended to use a dedicated SD card in the right slot where you also have all your additional files like Appdata and Roms, etc. placed.
To do that, follow the section "11. Where do I put .dbp files from the repository on the SD Card?"
(https://pyra-handheld.com/boards/threads/first-information-for-new-pyra-owners-faq.99302/)
The sentence "We do NOT have a package download manager like PNDManager on the Pandora yet, so you need to download and copy them there manually." is deprecated, obviously ;)

Of course, you have to put at least the .dbp file of the DBP Installer manually to /dragonbox/packages. But after that, the DBP Installer is mounted automatically and can be accessed via the System Tools folder in the main menu.

Let the fun begin!

------

Bash auto-completion:

!?While typing folder names, you can save time using the auto-completion feature by pressing the tab key anytime. Pressing tab (this key will be your best friend in the linux world) after writing /d completes the command to /dev/. If there is more then one possibility to complete, a list of all possibilities is shown after you hit tab a second time.

On some distributions like Ubuntu, auto-completion also works for commands and syntax or even package names. For Debian somehow, this feature is deactivated by default.

To enable auto-completion, type
$ sudo apt install bash-completion
and restart the bash. Now typing sudo apt in<tab> completes to "sudo apt install " and and the package name will complete the same way.

If you don't know the package name at all and want to look for a category or genre, remember this command from the wiki:
$ apt-cache search shooter

This is extremely useful, since you just can't know all the package names or lib/version suffixes!

------

Second OS on SD card:

A very handy feature of the Pyra is the possibility to load a second OS instance via the left SD slot, where you can experiment to your heart's content without the risk of damaging your main system on the eMMC. Another possibility is to run the SD OS underclocked to save battery while running mostly non-demanding applications and use the main OS for more demanding tasks.

First get an image here: https://packages.pyra-handheld.com/images/

!? the images called "pyra-#-install.img.7z" will flash your eMMC so choose "pyra-#.img.7z" from the buster folder. Debian 10 "Buster" is the most recent debian distibution for the Pyra at the moment. Use Etcher (https://www.balena.io/etcher) to flash the image.

After you flashed the image, the first thing you want is to expand your linux root partition.

Basically you follow the steps from the manual, chapter "On extending the F2FS root partition of the pyra-bootable SD card"
(https://pyra-handheld.com/wiki/inde...S_root_partition_of_the_pyra-bootable_SD_card).
However, since these steps never resulted in freezing my Pyra you can try expanding the root partition directly on your Pyra. To do that, first put the SD card into the right slot, so that the main OS from the eMMC boots again.

While following the instructions keep in mind to use the correct device names (mmcblk5 and mmcblk5p2) and change the commands accordingly!
And before you can perform steps 5 and 6 from the manual, you have to
$ sudo umount /dev/mmcblk5p2

Now you can shutdown your Pyra and finally put the SD card in the left slot whenever you want to use this OS.
And don't forget to update this Debian OS as well ;)

TIP: You can access your personal files like downloads, etc. from your main OS via the folder path /media/<YOUR SD CARD USERNAME>/rootfs/home/<YOUR EMMC USERNAME>/
It's convenient to make a shortcut on your Desktop or a Bookmark in your File Manager.

TIP: Change the desktop background from your SD OS.
Because in rare cases the Pyra just boots the main OS from the eMMC. This helps to prevent unwanted changes to your main OS because you may believe your SD OS booted.

IMPORTANT: The Pyra sometimes doesn't like to boot from SD card. When only the back logo turns green and nothing else happens, hold the power button for 8s, wait a few minutes and try again. In my case it strangely occurs only at second boot attemps when the previous session was shut down not long ago...
(see https://pyra-handheld.com/boards/threads/os-on-sd-card-only-booted-once.99775/)

------

Downgrade and update-prevention of packages:

Very recently there was a case where an apt upgrade of a package called udisks2 caused the problem that the Pyra couldn't mount SD cards anymore (https://pyra-handheld.com/boards/threads/unable-to-mount-sd-card-after-apt-upgrade.99839/)
While the problem is solved by now and it is safe to update this package, it shows that sometimes it can be helpful to switch back to older package version.

I add the solution from user rSl for reference:

apt-cache showpkg <package-name> lists all available versions.
for downgrading you could try: apt install udisks2=old_version_number_here libudisks2-0=old_version_number_here
apt-mark hold <package-name> "holds" the package at the current version, preventing automatic upgrades.

To find older pkg versions available in the repositories, these commands are helpful as well:
$ apt list -a <pkgname>
$ apt-cache madison <pkgname>

------

About the current browser situation on Debian 10 Buster

The latest official supported browser with current security patches is Firefox ESR 115.
The latest working Firefox feature-wise is Firefox 117.0.1. Since the download links seem to be removed, I repacked my installation to a deb file.
You can download it here, but keep in mind this is a deprecated version without recent security patches!

For Debian 11 Bullseye or 12 Bookworm there are current Firefox non-ESR builds available:
For Bullseye, get the file called firefox_xxx.x.x+build1-0ubuntu0.20.04.1~mt1_armhf.deb

------

Technical issues:

- After booting, the USB devices may not work. You have to reboot until they work. I googled for ways to restart the USB stack and tried different proposed solutions but none of them worked.

- The Pyra OS doesn't support rebooting at the moment. If you need to reboot, turn the device off and on again. (source?)

- Plenty more :D
 
Last edited:
This is a community project, by definition everything is official.

Opening another source of information because the others are too scattered, yee obvious xkcd joke.
It is however pretty helpful to cover temporal problems like that udisk bug in such a thread because that simply doesnt fit any other place.
 
Thanks for this! I learned a bunch! I had no clue about the bash-completion package. That by itself is a huge help.

I also didn't know the udisks2 issue was solved until I read your post. Maybe it would be good to mention that you can "apt-mark unhold" the package to start upgrading it again.
 
TIP: You can disable bluetooth to save some battery if you don't need it.
What is a tip withot content ... I found nothing here ;-)

Edit /etc/bluetooth/main.conf as sudoer ... change the last line to AutoEnable=false.

In Terminal do...

gsettings set org.blueman.plugins.powermanager auto-power-on false

or use dconf-editor to do this.

Blueman-widget is present after restart but Bluetooth is disabled by default.
 
Do starting a disabled-by-default bt from the applet crashes the applet ?
 
Do starting a disabled-by-default bt from the applet crashes the applet ?

There is no disabled-by-default bt or setting in the applet. You can disable bluetooth on every session manually or remove the applet from autostart... or have I overview / missunderstand something?
 
If the applet is activated, but with bt deactivated, does the plugin crash when bt is activated ?
 
No, I can activate bt if I need and deactivate if not. Normally I not use bt so deactivate on startup is what I like. ;-)
 
Yeah, I just made the change Raik suggested, and I can re-enable BT with no issues.

This was a great tip! I rarely use BT, too, so this will save me clicks and battery.
 
  • Like
Reactions: rSl
Put Bookworm on my SD and wanted to change some stuff via vi. Unfortunately the keyboard-mapping for the colon : isn't working on my device (with buster no issue).
Since I needed that colon: press CTRL-SHIFT-u, then you should see an underscored u. Now enter the hex-code for the colon (which is 3a) and finally press enter.
You should now have the colon.
 
I found an even easier solution.
While testing Dosbox, it wasn't possible to write the colon or the underscore, even in Buster! A quick google showed the solution:
Just use the minus or semicolon keys, while holding the Shift key.
So Fn + Shift (L1) + ";" or "-" does the trick! This makes using Bullseye or Bookworm way more convenient!

Edit: Bytemare shared how to fix the issue with a script
 
Last edited:
Some advices on the Hardware:
- Please avoid Pocket Carrying the Pyra whyle you drive heavyer Bicycles ..
- If you got an early Pyra and got the issue that its shuts down when you put it gently on an Table or Couch, you might still have Contact Issues on the Batterie Contacts, they are too short:
Solution: Gently Bend the Contacts on the Pyra Board a bit "up" (torwards the Batterie), this is something which will also done in "Assemply" by EvilDragon for new Pyrae. but please be carefull to not break them (its metall which only can get bend a certain times..)
 
Inside the battery cover, I also glued a piece of melamine foam. That helps, too!
 
  • Like
Reactions: rSl
I will share a way to get more recent packages in Buster from the buster-backports and the buster-backports-sloppy repositories.
Generally, it is no good idea to just upgrade all packages to the backports versions. It should be done in specific cases where you need one app with a newer version than your Debian installation provides by default. But I think it is worth a try on a Pyra running Buster.

- First, read some basics about backports https://backports.debian.org/Instructions/

- Be aware of the risks, make sure you have a backup of your important files or the whole system image.

- sudo apt update && sudo apt upgrade

- To add Backports to the sources.list:
$ sudo nano /etc/apt/sources.list
and include
deb http://deb.debian.org/debian/ buster-backports main contrib non-free
STRG+O to save, STRG+X to close

- Now you can upgrade ALL packages that are provided in the backports repository
$ sudo apt update && sudo apt upgrade -t buster-backports
That's it!

You can downgrade any package (suspectedly) making problems to the original versions.
First check, if it is available in buster-updates:
$ sudo apt install <pkg>/buster-updates
otherwise
$ sudo apt install <pkg>/buster

if anything works fine, you can also include
deb http://deb.debian.org/debian/ buster-backports-sloppy main contrib non-free
to the sources.list as well and upgrade with
sudo apt update && sudo apt upgrade -t buster-backports-sloppy

If you only intend to upgrade specific apps, you can do this with
$ sudo apt install -t buster-backports(-sloppy) <pkg>

I made good exprience with it since over a year now and only one backports related issue occured: one package needed to be reverted back to the original version. It was libcurl3-gnutls, so 'sudo apt install libcurl3-gnutls/buster' did the downgrade.
Curl 7.74 breaks git http operations, so it wasn't possible to download git repositories anymore. This bug was fixed in curl 7.76 but in backports it's still v7.74. The mentioned downgrade solves the issue.
There is a script that successfully compiles and installs curl 7.76, but libcurl3-gnutls stays v7.74 and hence does not solve the issue.
 
Last edited:
Since there will be a few new happy Pyra owners soon, I will update this guide regarding the current browser situation on Debian 10 Buster.

The latest working Vivaldi is 6.2.3105.58.
After the installation however, Vivaldi will get updated whenever you run a 'sudo apt get upgrade' and won't start anymore.
To prevent this, delete the Vivalidi repo from your system:
$ sudo rm /etc/apt/sources.list.d/vivaldi.list

The latest official supported browser with current security patches is Firefox ESR 115.
The latest working Firefox feature-wise is Firefox 117.0.1. Since the download links seem to be removed, I repacked my installation to a deb file.
You can download it here, but keep in mind this is a deprecated version without recent security patches!

For Debian 11 Bullseye or 12 Bookworm there are current Firefox non-ESR builds available:
For Bullseye, get the file called firefox_xxx.x.x+build1-0ubuntu0.20.04.1~mt1_armhf.deb
 
Last edited:
Back
Top