Google Git
Sign in
chromium / chromiumos / third_party / virtual-usb-printer / 88efaa9296b52289fda9899e7789cad342d000a0
commit88efaa9296b52289fda9899e7789cad342d000a0[log] [tgz]
authorKeigo Oka <oka@chromium.org>Tue May 21 09:16:40 2019
committerchrome-bot <chrome-bot@chromium.org>Tue May 28 17:44:27 2019
tree82b331f9bb144d518d30a378974d84e88c13d383
parentafbe0b1c43e6e7fbf8e9f010bee357839ba785d2 [diff]
virtual-usb-printer: migarte the package to use GN

TEST=See the change this CL depends on.
BUG=chromium:953642

Cq-Depend: chromium:1621232
Change-Id: I4d224d24448fc86c558d30e24489ccac83e8fc1a
Reviewed-on: https://chromium-review.googlesource.com/1621584
Commit-Ready: Keigo Oka <oka@chromium.org>
Tested-by: Keigo Oka <oka@chromium.org>
Legacy-Commit-Queue: Commit Bot <commit-bot@chromium.org>
Reviewed-by: Tatsuhisa Yamaguchi <yamaguchi@chromium.org>
Reviewed-by: Keigo Oka <oka@chromium.org>
2 files changed
tree: 82b331f9bb144d518d30a378974d84e88c13d383
  1. config/
  2. tools/
  3. BUILD.gn
  4. cups_constants.cc
  5. cups_constants.h
  6. device_descriptors.cc
  7. device_descriptors.h
  8. ipp_test.cc
  9. ipp_util.cc
  10. ipp_util.h
  11. LICENSE
  12. load_config.cc
  13. load_config.h
  14. load_config_test.cc
  15. op_commands.cc
  16. op_commands.h
  17. README.md
  18. server.cc
  19. server.h
  20. smart_buffer.cc
  21. smart_buffer.h
  22. smart_buffer_test.cc
  23. usb_printer.cc
  24. usb_printer.h
  25. usbip.cc
  26. usbip.h
  27. usbip_constants.h
  28. value_util.cc
  29. value_util.h
  30. virtual_usb_printer.cc
README.md

Virtual USB Printer

Virtual USB Printer provides a server which can be used with USBIP in order to emulate a USB printing device and bind it to the system as if it were physically connected to a USB port.

Virtual USB Printer supports both regular USB printers as well as IPP-over-USB devices.

Motivation

This project was created in order to make on-device tests which check for any regressions in the native USB printing system.

Requirements

  • USBIP - userspace program for binding virtual device to system
  • USBIP kernel modules:
    • CONFIG_USBIP_CORE
    • CONFIG_USBIP_VHCI_HCD
  • Linux Kernel v4.14 - USBIP currently only works on this kernel version

In order to actually “connect” the virtual printer to the system the USBIP program is used.

USBIP is typically used to export real USB devices over a network so that other systems on the network can bind them and treat them as connected devices.

For the purposes of the virtual printer, only the client portion of USBIP is required so that the virtual device can be bound to the system.

How to Use

Run the virtual-usb-printer program:

virtual-usb-printer --descriptors_path=<path>

(Optional) Check the list of exported printers with USBIP:

usbip list -r localhost

Should return something like this:

Exportable USB devices
======================
 - localhost
        1-1: Canon, Inc. : unknown product (04a9:27e8)
           : /sys/devices/pci0000:00/0000:00:01.2/usb1/1-1
           : (Defined at Interface level) (00/00/00)
           : 0 - Printer / Printer Bidirectional (07/01/02)

Bind the virtual printer to the system:

usbip attach -r localhost -b 1-1

Once the device has been attached it should appear in the list of connected USB devices (lsusb), and can be used with the native printing system in Chrome OS.

Configuration

The printer's USB descriptors and defined IPP attributes can be configured using a JSON file and are loaded at run-time using command line flags. Example configurations can be found in the config/ directory.

The configuration files can be loaded with the following flags:

  • --descriptors_path - full path to the JSON file which defines the USB descriptors
  • --attributes_path - full path to the JSON file which defines the supported IPP attributes
    • Only needed for IPP-over-USB printer configurations
  • --record_doc_path - full path to the file used to record documents received from print jobs