View source | Discuss this page | Page history | Printable version   
Main Page
Upload file
What links here
Recent changes

PDF Books
Show collection (0 pages)
Collections help


Retail:How to add new USB devices



The Openbravo Hardware manager can discover and configure automatically USB receipt printers and customer displays. The list of know USB devices can be configured to add new devices. The new USB devices configuration must go in a file named META-INF/usbdevices.xml, packaged in a .jar file and placed in the folder /libext.


The configuration file META-INF/usbdevices.xml has one entry for each receipt printer and customer display supported with the following syntax:

For receipt printers:

<printer name="epson TM-T88" id= "04b8:0202" classname="com.openbravo.pos.printer.escpos.USBDevicePrinterEpson"/>

For customer displays:

<display name="ld9000 Logic-Controls" id= "0fa8:a090" classname="com.openbravo.pos.printer.escpos.USBDeviceDisplayLD9000"/>

Where there are defined the following attributes:


The following example is the base META-INF/usbdevices.xml that goes in the Hardware Manager package to support the printers Epson TM-T88V, Star Micronics TSP-100 and the customer display Logic Controls LD9000:

<?xml version="1.0" encoding="UTF-8"?>
    <printer name="epson TM-T88" id= "04b8:0202" classname="com.openbravo.pos.printer.escpos.USBDevicePrinterEpson"/>
    <printer name="star TSP-100" id= "0519:0003" classname="com.openbravo.pos.printer.escpos.USBDevicePrinterStar"/>
    <display name="ld9000 Logic-Controls" id= "0fa8:a090" classname="com.openbravo.pos.printer.escpos.USBDeviceDisplayLD9000"/>

Package and Install

The file META-INF/usbdevices.xml must be packaged in a .jar file. To do this create a new usbdevices.xml file in a subfolder named META-INF. To package it execute the following instruction from the command line:

jar cvf myusbdevices.jar .

This instruction creates a new file named usbdevices.jar that contains the usbdevices.xml inside a folder META-INF.

To install just copy the file usbdevices.jar into the subfolder /libext of the installed Hardware Manager, and restart the application.

Retrieved from ""

This page has been accessed 2,441 times. This page was last modified on 22 September 2014, at 11:50. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.