Core (real-time) Framework v0.1 - Installation Instructions

From wiki.gpii
Jump to: navigation, search

This page only applies to v0.1 (2012) of the GPII framework - please see: Setting Up Your Development Environment for more current instructions

This release supports two platforms: Windows 7 and Fedora Linux with Gnome 3. Installation instructions can be found below.

Fedora 17


  • Fedora 17 needs to be installed. Installation requires super-user privileges.

Installation Instructions

Ensure pre-requisites

sudo yum install kernel-devel kernel-headers dkms gcc gcc-c++ \
  git openssl-devel glib-devel glib2-devel gtk3-devel \
  pcsc-lite-devel pcsc-lite pcsc-perl

Install node

sudo yum localinstall --nogpgcheck
sudo yum install nodejs nodejs-devel nodejs-gyp nodejs-doc nodejs-debuginfo
sudo ln -s /usr/bin/node /usr/bin/nodejs 

Install RFID listener

(only required if you want to use a RFID listener on the system)

Go to the location where you want to install the GPII

Clone the GPII PCSC Tools Repository

git clone
cd linux-rfid-user-listener

Compile and install

make all
sudo make install

Final step is to start a daemon running in the background and the scanner

Start first daemon and then scanner:

sudo /usr/sbin/pcscd

Install and run GPII Personalization Framework

Make sure you're in the directory where you want to install the GPII.

From the command line:

# Clone the GPII Linux repository:
git clone git://
cd linux
git checkout origin/v0.1

# Build the Framework:

# Start up the Personalization Framework:

Running the framework in general

After having followed the above steps, you will have installed the GPII and it should be running on the machine. In general (for example after a reboot), you would have to do the following steps:

To starts GPII, go to the GPII install dir, then:

cd linux

To enable the RFID listener, go to the GPII install dir, then:

cd linux-rfid-user-listener
sudo /usr/sbin/pcscd

Windows Installation Instructions


  • Node

Building and Starting

  • Open up cmd.exe (Start > Run > cmd.exe)
  • Create a GPII directory
    • mkdir c:\gpii (or wherever you prefer)
    • cd c:\gpii
  • Clone the GPII Windows repository and make sure we got the correct version
    • git clone git://
    • cd windows
    • git checkout origin/v0.1
  • Compile the GPII Windows native code (run the following command from the Windows/DOS shell):
    • build.cmd
  • Start the GPII Framework and the USB Listener (from the Windows/DOS shell - not the Git Bash sell - while in the gpii\windows folder):
    • start.cmd

Setup and Configuration

  • On Windows 7, the GPII can't currently kill applications using taskill unless you:
    • Go into Control Panel > User Accounts and Family Safety > User Accounts > User Account Control Settings
    • Set the notification level to "Never notify"

RFID Listener

The RFID is currently at an experimental state and only available as an exe. It can be found here:


Once you start the system (by using the start.cmd/ scripts), you can test it without USB by navigating your browser to the following URLs:

http://localhost:8081/user/sammy/login (This will run the windows magnifier which can be exited with the WindowsKey + Esc)


To test the USB listener create a file '.gpii-user-token.txt' in the root of a USB memory stick containing the text "sammy" (no quotes). Insert the stick to login and remove it to logout.