print-cli/orangepi5plus.md

Installation

Installing Print-CLI on a Raspberry Pi is a quite simple process but requires some time installing the required packages. This guide will help you to install Print-CLI on a Raspberry Pi.

Estimated time: 30-60 minutes

Step 1: Install the Raspberry Pi OS

Before we start, make sure you have created a bootable SD card with the Ubuntu Server 22.04 LTS 64-bit image. The simplest way is to use the Raspberry Pi Imager which enables you to select an Ubuntu image when flashing your SD card.

Recommended configuration:

• OS: Orange Pi 1.2.0 Jammy with Linux 5.10.160-rockchip-rk3588
• Username: orangepi

Step 2: Install Required Packages

Tested Printers:

• EPSON ET-2750 Series with driver: Epson Expression ET-2750 EcoTank - CUPS+Gutenprint v5.3.3 (color)
• EPSON ET-2860 Series with driver: Epson Expression ET-2750 EcoTank - CUPS+Gutenprint v5.3.3 (color)

Next, we need to install the required packages for Print-CLI to work. Run the following commands and grab a coffee while the packages are being installed (it may take a while):

sudo apt-get update
sudo add-apt-repository ppa:ondrej/php
sudo apt-get install -y git cups zip unzip supervisor \
  php-zip php-curl php-xml php-mbstring \
  printer-driver-gutenprint

Install Composer as usual:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Finally, add the Composer bin directory to your PATH, so you can run the print-cli command from anywhere:

echo 'export PATH="$PATH:$HOME/.config/composer/vendor/bin"' >> ~/.bashrc

Step 3: Ensure CUPS is Running

Now we need to ensure that the CUPS service is running. CUPS is the printing system used by Print-CLI to send print jobs to the printer. This is the most important step, so make sure you follow it carefully, otherwise, Print-CLI won't work as expected, and you won't be able to print anything.

sudo cupsctl --remote-admin --remote-any
sudo usermod -aG lpadmin orangepi
sudo /etc/init.d/cups restart

Make sure the CUPS service is running by visiting the following URL in your browser:

https://10.20.0.195:631/printers/

You should see a page with a list of printers. If you don't see any printers, you may need to add one manually.

Ensure that you can print a test page by clicking on the printer name and selecting "Print Test Page".

Find the Printer Address

To find the printer address, visit your Printers page in CUPS, and click on the printer name. The address in the browser should look like this:

https://10.20.0.195:631/printers/EPSON_ET_2720_Series

It contains the Name of the printer, which is the printer-name part. You can use this address in the configuration file for Print-CLI. In most cases, just replace the https with ipp and replace the ip to 127.0.0.1:

ipp://127.0.0.1:631/printers/EPSON_ET_2720_Series

Step 4: Install Print-CLI

So far, we have installed all the required packages and ensured that CUPS is running. Now we can install Print-CLI using Composer, the PHP package manager. Run the following command to install Print-CLI globally:

composer global require anikeen/print-cli

You can also use the same command to update Print-CLI to the latest version:

composer global require anikeen/print-cli

Step 5: Configure Print-CLI

With the latest version, you can automatically create your /home/orangepi/print-cli.yml with:

print-cli init

To test the configuration, run the following command:

print-cli serve

If everything is configured correctly, you should see the following output:

Starting service...
Reading configuration...
Service started!

You can exit the service by pressing Ctrl+C.

Step 6: Supervisor Configuration

To run Print-CLI as a service, we can use Supervisor. Supervisor is a process control system that allows you to monitor and control a number of processes on UNIX-like operating systems.

Create a new configuration file /etc/supervisor/conf.d/print-cli.conf:

print-cli init:supervisor | sudo tee /etc/supervisor/conf.d/print-cli.conf > /dev/null

Now, update Supervisor to read the new configuration file and start the Print-CLI service:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start print-cli

WLAN

https://www.makeuseof.com/connect-to-wifi-with-nmcli/

Printer Offsets

EPSON ET-2750 Series (with Gutenprint @ OrangePI)

Some other OS and drivers need other offsets.

{
    "badge": {
        "offset": {
            "y": 0,
            "x": 0
        }
    }
}

EPSON ET-2860 Series (Unconfirmed)

{
    "badge": {
        "offset": {
            "y": 0,
            "x": 0
        }
    }
}