Skip to main content
Academy Community Sign in

Adapter Box

  • Updated

Legacy module

The module described in this article has been marked as a legacy module. This means the following:

  • We don't create new features for this module or fix any bugs.

  • The module is not available anymore in Xentral instances (demo or licensed) created after 28-Sep-2022. If you as a new user have special requirements that could only be fulfilled by this module, please contact our customer support team to discuss a solution.

The adapter box is a small server that serves as a connector between xentral and hardware. To connect xentral with an external device (label printer, scale, receipt printer, cash register displays etc.) you need an adapter box as a small "intermediate server".

For technical reasons, a Raspberry Pi up to version 3B is currently required.

Once you have the adapter box, you can configure it with the following steps:

  1. Connect the adapter box to a monitor, keyboard and mouse. Also, make sure that you have an internet connection.

    ZEBRA-9.png

  2. Install the operating system and confirm the following message with OK.

  3. Navigate to LX Terminal (taskbar dark icon) and enter the following commands. Then confirm each with the ENTER key:

    sudo apt-get --yes install libcurl3 php7.0-curl php7.0-cli php7.0-xml
sudo usermod -a -G lpadmin pi
sudo systemctl enable ssh
wget http://www.wawision.de/adapterbox.deb 
sudo dpkg -i adapterbox.deb
echo "Enter serial number followed by [ENTER]:"
read seriennummer
echo "<?php \$config['serial'] = '$seriennummer'; ?>" > /tmp/config.php
sudo mv /tmp/config.php /root/config.php
sudo halt

    With the exception of the last call, the echo commands are for illustrative purposes only.

    Important

    You can download the Debian file (.deb file) for the wget command from the GitHub download directory

If the execution of the script does not work, you may need to install and activate the PHP version and extensions.

Installation php

sudo apt -y install php php-common

Installation PHP-Extension

sudo apt -y install php-cli php-fpm php-json php-mysql php-zip php-gd  php-mbstring php-curl php-xml php-pear php-bcmath

Wait until you are prompted to enter a serial number. Enter a 9-digit number and confirm with the ENTER key - this serial number will be used later in xentral. The box will switch off automatically. After that the adapter box is configured and you can start with the next step.

Note

If your printer does not print, change the driver from cpcl to zpl (Zebra zb 230). More information can be found on these pages:

Related articles