commit | 36c6dfa5a71a6bf6b9b5396be3cb697930cd9654 | [log] [tgz] |
---|---|---|
author | Benjamin Gordon <bmgordon@chromium.org> | Wed Apr 27 15:39:19 2022 |
committer | Chromeos LUCI <chromeos-scoped@luci-project-accounts.iam.gserviceaccount.com> | Mon May 02 15:07:04 2022 |
tree | fe351a0dfb8970b8409c89570484c8e4b77488b2 | |
parent | 7c54946911f91329ec2cc17cbdb5c07c539f71d5 [diff] |
virtual-usb-printer: Add new IPP-USB descriptors The new descriptors are a copy of the existing ippusb_printer.json with modifications that will trigger Chrome's Epson-specific rotation logic. Will be used with a new tast test to cover this behavior. BUG=b:199521284 TEST=emerge-zork virtual-usb-printer Change-Id: I3a5f039a0cc58f8b04a21bd16a060929d08b4e0b Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/virtual-usb-printer/+/3610214 Reviewed-by: Paul Moy <pmoy@chromium.org> Commit-Queue: Benjamin Gordon <bmgordon@chromium.org> Tested-by: Benjamin Gordon <bmgordon@chromium.org>
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.
This project was created in order to make on-device tests which check for any regressions in the native USB printing system.
As of https://crrev.com/c/3093381, virtual-usb-printer
is built and installed by default on all test images that support it.
If for some reason you need to build it yourself, you can USE=usbip
when building packages for your board - i.e.
USE="usbip" ./build_packages --board=$BOARD
virtual-usb-printer
relies on usbip
to manifest as a virtual USB device. Most test images seem to come with this built-in by default. If you need to build your own kernel with usbip
support, make sure to build with CONFIG_USBIP_CORE
and CONFIG_USBIP_VHCI_HCD
.virtual-usb-printer
can behave like
For ease of human operation, start virtual-usb-printer
via its Upstart unit. Pass the appropriate arguments to the invocation as needed.
For example, to start and connect the virtual-usb-printer
as an IPP-over-USB printer, issue
start virtual-usb-printer USB_DESCRIPTORS=ippusb_printer.json IPP_ATTRIBUTES=ipp_attributes.json
Consult the Upstart config file to see the arguments understood in this context.
virtual-usb-printer
sends its output to the system log.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--record_doc_path
- full path to the file used to record documents received from print jobs--output_log_dir
- directory path specifying where scan settings will be loggedRefer to these existing tast tests for examples of how to use the virtual-usb-printer
to test the Chromium OS printing stack.