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.
For more information, see also Why is Xentral deprecating some modules (Legacy modules) and what does this mean for you?
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:
-
Connect the adapter box to a monitor, keyboard and mouse. Also, make sure that you have an internet connection.
-
Install the operating system and confirm the following message with OK.
-
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: