Summary

FreedomBox/UniLeipzigPractical is the documentation of a freedom box related practical course at the AKSW Research Group at the University of Leipzig (in german).

The original course page is available at http://bis.informatik.uni-leipzig.de/de/Lehre/1213/WS/LV/DSSNP The practical will be organized in 3-4 hackaktons and a lot of work between these sessions. The idea of the practical is to extend the freedombox with semantic technologies.



History

Hardware

This is our practical hardware, the OLinuXino (actually, we use the WIFI version of it)

https://www.olimex.com/Products/OLinuXino/A13/A13-OLinuXino-WIFI/

User's manual

Software

Basic Installation

Basic Configuration

Time

Network

This section describes how to setup the network connection of your device. Out goal is to have a roaming tolerant setup where the box is reachable from outside despite any odd ISP configurations.

Network Manager

  1. Find the name of your wifi device with iwconfig (wlanX)
  2. run "apt-get install network-manager"
  3. Copy all your configured Wifis from your desktop or laptop to your board (e.g. via SD-Card) You may find them in /etc/NetworkManager/system-connections and that is the same place, where it has to go in the board.
  4. Make sure all files in /etc/NetworkManager/system-connections have owner root:root and only read and write rights for the owner.
  5. Make sure your wifi device (wlanX) does not appear in /etc/network/interfaces

  6. Restart your board (power off - wait - power on)

Further reading: http://wiki.debian.org/NetworkManager

Network Access for non-root Users

# groupadd -g 3003 aid_inet
# adduser <username> aid_inet

This is cause by the enabled kernel option: CONFIG_ANDROID_PARANOID_NETWORK (another reason for a new kernel)

Source: http://forums.debian.net/viewtopic.php?f=5&t=62151

Usability

Shell

For the bash users among us I think it would be helpfully to enable the tab auto completion. You can find the instructions here: http://www.simplylinux.ch/bash-completion-fuer-debian

The tutor of this practical suggests to use zsh:-) which has much better completion options as well as a lot of other nice features.

qemu Emulation

todo clemens

connectivity

With the new kernel #Kernel_compilation it is possible to install and run miredo which is an IPv6 tunnel service. With the IPv6 address you can reach your device from everywhere.

How to provide a stable WebID over standard networks?

How to provide a stable WebID over p2p, crypto networks?

DSSN

dssn.js

DSSN implementation for node.js

xodx

Xodx is running on the system. You can get the current develop branch from the git repository. Additionally you have to install a web server (I recommend nginx) and a triplestore (best choice is virtuoso).

To get nginx running with php fast cgi you should follow this tutorial. You can find the necessary scripts in my gist. To get xodx running you can adopt the server configuration for OntoWiki.

So far I had no success in accessing xodx with my IPv4 address but it works with IPv6 (as you can see it is next generation software :-D )

Kernel compilation

Because the kernel in our current image doesn't support the GPIO (all these pins) and IPv6 I'm trying to build a new kernel for us. Our Debian system is using the unofficial armhf debian port which uses the advantages of the floating point unit on the chip.

Preparations

First you have to check out the kernel sources from linux-sunxi@github or download the tar-ball and extract it.

Second you have to download the Toolchain and extract it and add the bin/-Folder to your $PATH.

And you need mkimage for uboot

sudo apt-get install uboot-mkimage

Configure and Compile the Kernel

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- a13_defconfig
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig
  1. load the default configuration for our board
  2. adjust the setting e.g. enable "Device Drivers > Misc devices > An ugly sun4i gpio driver", "Networking support > Networking options > TCP/IP networking > The IPv6 protocol" and "Device Drivers > Network device support > Universal TUN/TAP device driver support"

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j16 uImage modules
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- INSTALL_MOD_PATH=output modules_install

If you just want to exchange the kernel of your system which is already on the SD-card you just have to mount both partitions and move the uImage to the boot partition and the module to the root-fs.

cp <kernelsources>/arch/arm/boot/uImage /{mnt|media}/<boot-partition>
cp -r <kernelsources>/output/lib/modules/3.0.42 /{mnt|media}/<root-partition>/lib/modules/

If you want to build a whole new image with a new kernel you have to read the following sources.

Sources and further reading:


CategoryFreedomBox