Prisirah

Fairly simple. Just connect the CABLE-IDC40-15cm to the A20‑OLinuXino‑MICRO and the LCD display. If you have the A20-ENC plexyglass enclosure, make sure to get 4 additional nuts because the ones inlcuded are too short. Also be careful not to break the thin part of the plexyglass near the LCD connector. If you have the A20-ENC and the A13‑LCD7‑TS²³ you can glue²⁴ the nuts on the back of the display to get a nice raw device (see also Figure 3). For details read the official manual²⁵.

A little bit more tricky. Make sure you plug in 5V only! ²⁶ Be very careful with the LCD cable (likely you will break one). Try to get it right on the first try, so you don't have to remove it again (see also Figure 4). If you have the nice A10-OLinuXino-LIME-BOX you may have to play with the board direction, at some point everthing should just fit. To get the cable out of the box you have to file off a notch.

For details read the official manual²⁵.

For your convenience there is a pre-built compressed Prisirah disk image (including U-Boots) you can write to your SD card. The image can also be used for a self-hosted build (it can build itself). The following assumes you use some Linux system.

for now take a look at the output of³⁵:

$ git clone https://www.karme.de/git/prisirah-image-builder \
 && cd prisirah-image-builder && ./prisirah-image-builder --help

Insert your microSDHC card and power on.³⁶ Keep your stylus ready to calibrate the touchscreen (s.a. Figure 5). The first boot at the moment is very slow so please be really patient.³⁷

After waiting some time your initial password for the user "prisirah" will be displayed. Maybe setup your wireless network (s.a. Figure 6).³⁸

If the network is up, you can use the initial password to login via SSH and change your password³⁹:

$ ssh -t prisirah@prisirah.local passwd

It is recommended to setup key-based authentication. If you don't have a SSH key pair yet, create one using something like²⁰:

$ ssh-keygen -t rsa -b 4096

or

$ ssh-keygen -t ed25519

To copy your public SSH key to the Prisirah do:

$ ssh-copy-id prisirah@prisirah.local

If you verified key-based login works, best disable SSH password login alltogether:

$ ssh -t prisirah@prisirah.local sudo \
   sh -c    \
    "'sed -i \
         \"s/^#PasswordAuthentication yes/PasswordAuthentication no/\" \
          /etc/ssh/sshd_config \
      && service ssh reload && echo ok'"

Verify you can't login with password.

To add a friend (s.a. Figure 7) you have to exchange friend codes and add each other in the "add friend" menu.

WARNING: at the moment you should only add real friends, as you grant remote access to your Prisirah.⁴⁰

For each friend a user friend»FRIENDCODE« is created and "traditional Unix permissions" and access control lists (ACLs) apply.

To get photos onto your frame just plug in some USB mass storage device (USB flash drive, digital camera, …) or if you did set up remote access (see 5.3.4) use SSH/SFTP maybe via some nice front-end. If you use GNOME, KDE, Xfce, MATE, Cinnamon or similar on your "normal computer(s)", the Prisirah should show up in the network folder.³⁹ If you want to access your Prisirah on the go from your laptop you might wish to install Tor and netcat-openbsd on your computer and adjust your SSH configuration. On a Debian(-based) distribution you would do something like:

$ apt-get install tor netcat-openbsd

then add something like:

Host *.onion
     IdentityFile ~/.ssh/id_rsa
     ProxyCommand nc.openbsd -X 5 -x 127.0.0.1:9050 %h %p

to your ~/.ssh/config.

The A20‑OLinuXino‑MICRO also has a second SD card slot where you could insert a SD card with photos to import.⁴¹

All image files you put into prisirah.local:/home/prisirah/share/all will be shared with all friends. They will show up in «FRIENDCODE».onion:/home/friend«YOURFRIENDCODE»/all. If you want to share some photos only with a specific friend you copy them to prisirah.local:/home/prisirah/share/«FRIENDCODE» and they will show up in «FRIENDCODE».onion:/home/friend«YOURFRIENDCODE»/«FRIENDCODE».

You can place relative symlinks in /home/prisirah/share to serve as aliases / pet names.

Yes, unfortunetely there is a bug in unattended-upgrades. You may have to run the update manually. First check if you are hit by the bug:

$ LC_ALL=C sudo unattended-upgrade -v
Initial blacklisted packages: 
Initial whitelisted packages: 
Starting unattended upgrades script
Allowed origins are: ['origin=Debian,n=jessie', 'origin=karme.de,n=jessie']
Cache has broken packages, exiting
Cache has broken packages, exiting

If the output contains "Cache has broken packages, exiting" you run:

$ sudo sh -c "apt-get update && apt-get -f dist-upgrade"

Yes, unfortunately there was a bug. To fix it you either can update to Prisirah image version >= 0.15 or if you have a working Debian(-based) system⁴³ you can try to fix the boot script as follows. Before you start insert your SD card into your card reader. Basically we want to insert the kernel version to use at some point of the boot script. Therefore we have to edit "boot.cmd" and reprocess it to a "boot.scr". One possible way to do that:

$ { test -d /media/boot \
 && sudo apt-get install u-boot-tools \
 && grep -q 'load mmc 0 0x43000000 dtb/${fdtfile}' /media/boot/boot.cmd \
 && sudo sed -i 's,load mmc 0 0x43000000 dtb/${fdtfile},'\
'load mmc 0 0x43000000 dtb/3.16.0-4-armmp-lpae/\${fdtfile},' \
        /media/boot/boot.cmd \
 && sudo mkimage -C none -A arm -T script -d /media/boot/boot.cmd \
    /media/boot/boot.scr \
 && sync && umount /media/boot \
 && echo 'ok, that worked' ; } || echo 'Sorry, mail me'

If it doesn't help, please mail me.

Please let me know! For now I don't have a solution other than power off and on again (please use the menu to power off!).