Technical docs about sono project
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

5.4 KiB

Printer Configuration Manual

Preface & Disclaimer

This document is created as a guide manual for setup and configuration of the thermal printer (Sony UP-D898MD) installed on the ultrasound device. It's probable that steps mentioned in this document work for other models (e.g. X898MD or D898) but there is absolutely no guarantee that it will work.

The complete process is described in the following two sections (Setup & Printer Configuration).

Setup

To install the drivers we will use CUPS (Common Unix Printing System) project and Gutenprint project$^1$.

There are several steps to install these:

  1. Install cups
  2. Make sure cups-filters and cups-filters-common-driver is installed
  3. Install libcups2-dev
  4. Install Gutenprint
  5. Restart CUPS service

Install Cups

It's possible to install cups using apt package manager:

sudo apt install cups

This command will install the CUPS project and needed dependencies. In case of missing some, we will enter commands in the next section.

Dependencies

To install dependencies for the cups and gutenprint enter the following command:

sudo apt install cups-filters cups-filters-core-drivers libcups2-dev

Install Gutenprint drivers

After we installed required dependencies, we should install appropriate drivers. Support for this specific model is added in Gutenprint v5.3.4 and this is not provided by the package manager. To install this specific model first we should get the source code:

# you can get the archive's from the link provided for Gutenprint
wget https://downloads.sourceforge.net/gimp-print/gutenprint-5.3.4.tar.xz

After that we should decompress the archives (if the format is different than tar.xz you might want to use another command):

tar -xvf gutenprint-5.3.4.tar.xz

And after that we should enter these commands to build and install the project:

cd gutenprint-5.3.4/
./configure && make
sudo make install

After the installation, we should restart the cups service to work properly with newly added drivers and backends:

sudo systemctl restart cups

Printer Configuration

Using web interface

After we setup CUPS and drivers, we can now add our printer. Follow these steps to add the printer$^2$:

  1. Open //localhost:631 in a browser. It should bring CUPS dashboard.
  2. Click on "Administration" tab.
  3. Click on "Add Printer" button (It's located in printers section). It may prompt you for username and password. Enter the current user of the system (or any sudoer user) and it's password.
  4. In front of "Local Printers" choose the printer (Sony UP-D898MD_X898MD or something similar)$^3$ and click "Continue".
  5. Choose name and description of the device on default and click "Continue". (Sony_UP-D898MD_X898MD for both) $^4$.
  6. From the "Model" list select the devices mode (i.e. Sony UP-D898MD - CUPS+Gutenprint v5.3.4 (en)). If the option is not available make sure manufacture is detected correctly (i.e. Sony) and you restarted CUPS service after you installed Gutenprint. Click "Add Printer".
  7. In the "Set Printer Options" page DO NOT CHANGE any setting and click on "Set Default Options".
  8. After a while you will be redirected to the printers page. To test the printer is set up correctly, under "Maintenance" dropdown click on "Print Test Page". At this moment printer should start to print the test page. It'll look like this.

Using CLI

It is also possible to configure the printer using command-line. To add the printer using cli first we should find the driver and device uri.

To find driver:

lpinfo -m | grep D898MD

and the output is something like:

gutenprint.5.3://sony-upd898md/expert Sony UP-D898MD - CUPS+Gutenprint v5.3.4

and note that we only will use the part gutenprint.5.3://sony-upd898md/expert.

To find the device uri:

lpinfo -v | grep sony

and the output is something like:

direct gutenprint53+usb://sony-upd898/6063080

and note that we only will use the gutenprint53+usb://sony-upd898/6063080 part without the direct (which is a information tag beside our device uri).

Now we can add the printer (note that we use Sony_UP-D898MD_X898MD as the name of our device):

lpadmin -p Sony_UP-D898MD_X898MD -E -v gutenprint53+usb://sony-upd898/6063080 -m gutenprint.5.3://sony-upd898md/expert

and this will add the printer to our system.

Footnotes

[1] It's probable that Gutenprint project does not support a special manufacture/model. It's also probable that a special version of it doesn't provide the support (as our exact model support is added to the project since V5.3.4).

[2] These instructions are related to CUPS V2.4.X and the interface may has changed.

[3] If there is no option representing your printer, double check that the printer is ON and its cable is connected to the device (On connection of the USB cable the printer makes a beep sound). Also check if the printer say READY in its display and the the display background is green.

[4] As this document is being written, choosing printer in the software relied on the correct name of it and does not use MID:PID of the USB. Changing it to another thing make broke the functionality.