1 <sect1 id="serialPOS-howto">
2 <title>The serialPOS Driver</title>
5 This section talks about using LCDproc with a point of sale ("POS") character-display.
9 The <code>serialPOS</code> driver is currently working with the AEDEX emulation protocol,
10 but can be extended to work with various other protocols.
14 The driver should operate most character POS displays with a serial (RS-232) input.
15 Because these displays use a standardized protocol, if the protocol is
16 supported by your display, it should work as expected.
19 <table id="serialPOS-howto.status">
20 <title>serialPOS: Emulation Protocol Status</title>
24 <entry>Protocol</entry>
25 <entry>Display tested</entry>
26 <entry>Currently Supported</entry>
62 <entry>Logic Controls</entry>
68 <entry>Ultimate</entry>
77 <literal>(</literal>…<literal>)</literal>: Feature not tested.
80 <sect2 id="serialPOS-connections">
81 <title>Connecting The Display</title>
84 Connecting the display should consist of simply plugging it into your computer's
85 RS-232 port. Because these displays typically support full RS-232, no additional
86 wiring is needed. If your computer does not have such a port (many newer computers don't),
87 you can use a USB to serial adapter with the appropriate driver.
92 If your display supports a <emphasis>pass-through</emphasis> function,
93 but you do not have another RS-232 device connected to the pass-through port,
94 you may experience hangs if an improperly formatted command sneaks through.
95 This is because the display is waiting for the pass-through device to accept
96 the data and a blocking state is created within the device.
97 You can either connect another RS-232 device, or rewire the display to send the
98 pass-through commands back to your computer.
104 <!-- ## Serial POS driver ## -->
105 <sect2 id="serialPOS-config">
106 <title>Configuration in LCDd.conf</title>
108 <sect3 id="serialPOS-config-section">
109 <title>[serialPOS]</title>
115 <command>Device=</command>
116 <arg choice="plain"><replaceable>DEVICE</replaceable></arg>
119 Device to use in serial mode. Usual values are <filename>/dev/ttyS0</filename> or
120 <filename>/dev/cu.usbserial</filename>. Default is <filename>/dev/lcd</filename>.
126 <command>Size=</command>
128 <replaceable>WIDTH</replaceable>
130 <replaceable>HEIGHT</replaceable>
134 Specifies the size of the VFD in characters.
135 If not given, it defaults to <literal>16x2</literal>.
141 <command>Type=</command>
144 <arg choice="plain"><literal>IEE</literal></arg>
145 <arg choice="plain"><literal><emphasis>AEDEX</emphasis></literal></arg>
146 <arg choice="plain"><literal>Epson</literal></arg>
147 <arg choice="plain"><literal>Emax</literal></arg>
148 <arg choice="plain"><literal>IBM</literal></arg>
149 <arg choice="plain"><literal>LogicControls</literal></arg>
150 <arg choice="plain"><literal>Ultimate</literal></arg>
155 Set the communication protocol to use with the POS display.
156 If not specified it defaults to <literal>AEDEX</literal>.
157 Currently, only AEDEX is supported.
163 <command>Speed=</command>
166 <arg choice="plain"><literal>1200</literal></arg>
167 <arg choice="plain"><literal>2400</literal></arg>
168 <arg choice="plain"><literal><emphasis>9600</emphasis></literal></arg>
169 <arg choice="plain"><literal>19200</literal></arg>
170 <arg choice="plain"><literal>115200</literal></arg>
175 Set the the baud rate communication with the POS display.
176 If not given the default of <literal>9600</literal> is used.