Linux

Prerequisites

To install SDK you need, a 64-bit version of one of these supported OS versions:
Ubuntu
  • Ubuntu 16.04 (xenial)
  • Ubuntu 18.04 (bionic)
  • Ubuntu 20.04 (focal)
Debian
  • Debian 8 (Jessie)
  • Debian 9 (Stretch)
  • Debian 10 (Buster)
CentOS
  • CentOS 7
  • CentOS 8
SDK is supported onx86_64or(amd64)architectures.

Available packages

regula-reader

Core SDK for support of optical and RFID reader devices

regula-reader-dev

Resources for developers:
  • documentation
  • examples
  • headers
Documentation and examples can be found in the folder
1
/usr/share/regula
Copied!

regula-reader-service

A local web service to communicate with reader devices via JavaScript calls using the Socket.IO library. You can view an example web page by opening http://localhost:3000/. The source code of the page can be found in
1
/usr/share/regula/Examples/LocalServiceExample
Copied!

Install SDK

Install using the repository

Ubuntu
Debian
CentOS

Set up the repository

1. Update the apt package index and install packages to allow apt using the repository over HTTPS:
1
sudo apt-get update
Copied!
1
sudo apt-get install -y \
2
apt-transport-https \
3
ca-certificates \
4
curl \
5
gnupg-agent \
6
software-properties-common
Copied!
2. Add Regula official GPG key:
1
curl -fsSL https://downloads.regulaforensics.com/repo/ubuntu/regula.gpg | sudo apt-key add -
Copied!
3. Use the following command to set up the stable repository.
1
sudo add-apt-repository \
2
"deb [arch=amd64] https://downloads.regulaforensics.com/repo/ubuntu \
3
$(lsb_release -cs) \
4
stable"
Copied!

Install SDK

1. Update the apt package index and install the latest version of SDK, or go to the next step to install a specific version:
1
sudo apt-get update
Copied!
1
sudo apt-get install regula-reader
Copied!
2. To install a specific version of SDK, list the available versions in the repo, then select and install the required version:
a. List the versions available in your repo:
1
apt-cache madison regula-reader
Copied!
b. Install a specific version using the version string from the second column
1
sudo apt-get install regula-reader=<VERSION>
Copied!

Set up the repository

1. Update the apt package index and install packages to allow apt using the repository over HTTPS:
1
sudo apt-get update
Copied!
1
sudo apt-get install -y \
2
apt-transport-https \
3
ca-certificates \
4
curl \
5
gnupg-agent \
6
software-properties-common
Copied!
2. Add Regula official GPG key:
1
curl -fsSL https://downloads.regulaforensics.com/repo/debian/regula.gpg | sudo apt-key add -
Copied!
3. Use the following command to set up the stable repository.
1
sudo add-apt-repository \
2
"deb [arch=amd64] https://downloads.regulaforensics.com/repo/debian \
3
$(lsb_release -cs) \
4
stable"
Copied!

Install SDK

1. Update the apt package index and install the latest version of SDK, or go to the next step to install a specific version:
1
sudo apt-get update
Copied!
1
sudo apt-get install regula-reader
Copied!
2. To install a specific version of SDK, list the available versions in the repo, then select and install the required version:
a. List the versions available in your repo:
1
apt-cache madison regula-reader
Copied!
b. Install a specific version using the version string from the second column
1
sudo apt-get install regula-reader=<VERSION>
Copied!

Set up the repository

Install the yum-utils package (which provides the yum-config-manager utility) and set up the stable repository.
1
sudo yum install -y yum-utils
Copied!
1
sudo yum-config-manager \
2
--add-repo \
3
https://downloads.regulaforensics.com/repo/centos/regula.repo
Copied!

Install SDK

1. Install the latest version of SDK or go to the next step to install a specific version:
1
sudo yum install regula-reader
Copied!
2. To install a specific version of SDK, list the available versions in the repo, then select and install the required version:
a. List the versions available in your repo:
1
sudo yum list regula-reader --showduplicates | sort -r
Copied!
b. Install a specific version by its fully qualified package name
1
sudo yum install regula-reader-<VERSION>
Copied!

Install from a package

Ubuntu
Debian
CentOS
Note: Regula packages require the following dependencies to be installed before SDK is downloaded: debconf (>= 0.2.26), libusb-1.0-0 (>= 2:1.0.20), udev, pcscd, libccid
  1. 1.
    Open https://downloads.regulaforensics.com/repo/ubuntu/pool/stable/r/, browse the required package dir and download the .deb file for the SDK version you want to install
    1
    wget https://downloads.regulaforensics.com/repo/ubuntu/pool/stable/r/regula-reader/<package>.deb
    Copied!
  2. 2.
    Install SDK
    1
    sudo dpkg -i <package>.deb
    Copied!
Note: Regula packages require the following dependencies to be installed before SDK is downloaded: debconf (>= 0.2.26), libusb-1.0-0 (>= 2:1.0.20), udev, pcscd, libccid
  1. 1.
    Open https://downloads.regulaforensics.com/repo/debian/pool/stable/r/regula-reader/, browse the required package dir and download the .deb file for the SDK version you want to install
    1
    wget https://downloads.regulaforensics.com/repo/debian/pool/stable/r/regula-reader/<package>.deb
    Copied!
  2. 2.
    Install SDK
    1
    sudo dpkg -i <package>.deb
    Copied!
Note: Regula packages require the following dependencies to be installed before SDK is downloaded: libusb, pcsc-lite
  1. 1.
    Open https://downloads.regulaforensics.com/repo/centos/x86_64/stable/Packages/ and download the .rpm file for the SDK version you want to install
    1
    wget https://downloads.regulaforensics.com/repo/centos/x86_64/stable/Packages/<package>.rpm
    Copied!
  2. 2.
    Install SDK
    1
    sudo rpm -ivh <package>.rpm
    Copied!
Last modified 1yr ago