summaryrefslogtreecommitdiff
path: root/README
blob: 6ba4909c5cad42f1fe2570eb3c8ad1c5ba0194cc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
Epson Laser Printer Driver (ESC/Page) Manual

Copyright (C) Seiko Epson Corporation 2005-2012.

Contents
1  License Agreement
2  Revision History
3  Product Description
4  Installation and CUPS setting
    4.1  Installing
    4.2  Settings after installation
5  Printing
    5.1  Items to be set
    5.2  Details of setting items
    5.3  How to Set
    5.4  How to Print
6  How to build in non-LSB distribution
    6.1  For Redhat based distributions
    6.2  For Debian based distributions
    6.3  Other distributions

-------------------------------------------------------------------------------
1  License Agreement
-------------------------------------------------------------------------------
This software is covered by the GNU General Public License (GPL). 
Refer to the file "COPYING" for more information about the GPL.

-------------------------------------------------------------------------------
2  Revision History
-------------------------------------------------------------------------------
See ./NEWS.


-------------------------------------------------------------------------------
3  Product Description
-------------------------------------------------------------------------------
This software is a filter program used with the Common UNIX Printing
System (CUPS) on the Linux platform.
The software offers high quality printing with Seiko Epson Laser printers.

This software is based on LSB 3.2. It can be used in distribution supporting LSB 3.2 later.
If it is used in non-LSB distribution, you can use it by building from the source code.

-------------------------------------------------------------------------------
4  Installation and CUPS Setting
-------------------------------------------------------------------------------
4.1  Installation
	   Choose the appropriate command for your distribution from the list below
	   and execute it with root privileges.
	   Note: The following package name differs depending on the version
	   you are using.
	   For Redhat based distributions:
	   -----------------
	   # rpm -i epson-laser-printer-escpage-1.0.1-1lsb3.2.i486.rpm
	   -----------------
	   For Debian based distributions:
	   -----------------
	   # dpkg -i epson-laser-printer-escpage_1.0.1-1lsb3.2_i386.deb
	   -----------------

       Regarding the building the source code, refer to "6  How to build in non-LSB distribution".

4.2  Settings after installation
   CUPS must be set to enable use of this software.
   Before printing, be sure to carry out the following steps.

	4.2.1  Restart CUPS
	     Restart CUPS, to enable the installed filter.
	     Execute the following command with root privileges.

	     Example: With Red Hat Linux
	     -----------------
	     # /etc/init.d/cups restart
	     -----------------
	     With Debian GNU/Linux
	     -----------------
	     # /etc/init.d/cupsys restart
	     -----------------

	4.2.2  Add a printer

	  Using commands
	     Execute the following command with root privileges.
	     -----------------
	     # lpadmin -p [PRINTER_NAME] -v [DEVICE_URI] -P [PPD_FILE] -E
	     -----------------

	     Options: -p      Specifies the setting name of the printer
	                        -E      Enables the printer
	                        -v      Specifies the driver and connection
	                        -P      Specifies the setting file (PPD file)

	     Example: With the AL-M2010 printer 
	     -----------------
	     # lpadmin -p al-m2010 -v usb:/EPSON/AL-M2010 -P /opt/epson-laser-printer-escpage/ppds/Epson/Epson-AL-M2010-epson-laser-printer-en.ppd.gz -E
	     -----------------

	     For details of lpadmin, see lpadmin(8).


	  Using a browser
	     CUPS is provided with a CGI for settings so that you can set your printer
	     using a browser. To add a printer, follow the steps below.
	       Note: The following menu items might differ depending on the CUPS
	             version and the environment used.

	     (1) Turn on the printer, and please be connected to the PC with a USB cable.
	     (2) Connect to CUPS Server (Port: 631) with the browser
	         Example: When CUPS is on localhost, access the following URL.
	             -----------------
	             http://localhost:631/
	             -----------------
	     (3) Select "Add Printer"
	     (4) Enter a printer setting name in "Name", and select "Continue"
	          (Other items are not mandatory)
	     (5) In "Device", USB, and select "Continue"
	         Example: With the EP-901A printer, "Model" is displayed as follows.
	             -----------------
	             "AL-M2010 USB #1(AL-M2010)"
	             -----------------
	     (6) In "Model", set "EPSON AL-M2010 Printer Driver for Linux", and
	         select "Add Printer"
	         Example: With the AL-M2010 printer, "Model" is displayed as follows.
	             -----------------
	             "EPSON AL-M2010, EPSON AL-M2010 Printer Driver for Linux (en,en,ja,nl,fr,de,it,pt,es,ko,zh_CN,zh_TW)"
	             -----------------
	     (6') Instead of steps (6), specify the PPD file directly from "Browse"
	          Example: With the AL-M2010 printer, you would specify the following file.
	              -----------------
	              /opt/epson-laser-printer-escpage/ppds/Epson/Epson-AL-M2010-epson-laser-printer-en.ppd.gz
	              -----------------

This completes adding a printer for this software.


-------------------------------------------------------------------------------
5  Printing
-------------------------------------------------------------------------------
5.1  Items to be set
   The following items can be set with this software.

  * Paper size
        Select the paper size for your document.

   * Print quality
        Select the media type and its print quality for your printing.


5.2  Details of setting items
   Followings is a list of setting options available for this software.

   * The meaning of the list items
     - Keyword          Text string used when specifying an option
     - Browser display  Text string displayed in the browser window for CUPS settings
     - Explanation      An explanation of the setting

   Paper size
      Setting name for optional settings: PageSize or media
      Setting name in the browser: MediaSize

      Note: When adding multiple settings in the media option, put paper size
            at the beginning. For the media options, see the CUPS documentation.

   Print quality
      Setting name for optional settings: Quality
      Setting name in the browser: Quality


5.3  How to set

   There are three methods for print settings.

   * Using commands
        Use lpoptions. For details of the command, see lpoptions(1).

        Example: For the registered printer name al-m2010
            To specify page size = A4, quality = PLAIN_NORMAL
        -----------------
        $ lpoptions -p al-m2010 -o media=A4 -o quality=PLAIN_NORMAL
        -----------------

   * Use a browser
        Select "Configure Printer" from the printer window to display
        the setting window.

   * Specify options when printing
        As with lpoptions, set options with -o. For details of the commands,
        see lpr(1) and lp(1).

5.4  How to Print

   To print, as with the existing LPR, execute the lpr or lp commands.
   The formats that can be printed are as follows.

   * Postscript
   * PDF
   * Text
   * Various image files

   Example:
      When printing with the defaults
      -----------------
      $ lpr -P PRINTER_NAME <file>
      $ lp -d PRINTER_NAME <file>
      -----------------

      With printer_name = al-m2010, media = Legal
      -----------------
      $ lpr -P al-m2010 -o media=Letter <file>
      $ lp -d al-m2010 -o media=Letter <file>
      -----------------

The method of printing depends on the implementation of CUPS.
For more details, see the CUPS documentation.

-------------------------------------------------------------------------------
6  How to build in non-LSB distribution
-------------------------------------------------------------------------------
6.1  For Redhat based distributions
	6.1.1  Uncompress the src.rpm file
	   $ rpm2cpio epson-laser-printer-escpage-1.0.1-1lsb3.2.src.rpm | cpio -id
	   $ tar zxvf epson-laser-printer-escpage-1.0.1-1lsb3.2.tar.gz

	6.1.2  Configure and Create source tarball
	   $ cd epson-laser-printer-escpage-1.2.0
	   $ ./autoreconf -fi && ./configure --prefix=/usr && make dist

	6.1.3  Create the directory for RPM packages
	   $ mkdir -p ~/rpmbuild/SOURCES
	   $ mkdir -p ~/rpmbuild/SPECS
	   $ mkdir -p ~/rpmbuild/BUILD
	   $ mkdir -p ~/rpmbuild/RPMS
	   $ mkdir -p ~/rpmbuild/SRPMS
	   
	   You can specifiy the another directory in ~/.rpmmacros
	   
	6.1.4  Copy the source tarball and the spec file to the directory
	   $ cp epson-laser-printer-escpage-1.0.1.tar.gz ~/rpmbuild/SOURCES/.
	   $ cp epson-laser-printer-escpage.spec ~/rpmbuild/SPECS

	6.1.5  Create RPM package
	   $ cd ~/rpmbuild/SPECS
	   $ rpmbuild -ba --clean epson-laser-printer-escpage.spec


6.2  For Debian based distributions
	6.2.1  Uncompress the src.rpm file
	   $ rpm2cpio epson-laser-printer-escpage-1.0.1-1lsb3.2.src.rpm | cpio -id
	   $ tar zxvf epson-laser-printer-escpage-1.0.1-1lsb3.2.tar.gz

	6.2.2  Configure
	   $ cd epson-laser-printer-escpage-1.0.1
	   $ ./autoreconf -fi && ./configure --prefix=/usr

	6.2.3  Create DEB package
	   $ make
	   $ debuild -us -uc -b

6.3  For other distributions
	6.3.1  Uncompress the src.rpm file
	   $ rpm2cpio epson-inkjet-printer-escpage-1.0.1-1lsb3.2.src.rpm | cpio -id
	   $ tar zxvf epson-inkjet-printer-escpage-1.0.1-1lsb3.2.tar.gz

	6.3.2  Configure
	   $ cd epson-laser-printer-escpage-1.0.1
	   $ ./autoreconf -fi && ./configure --prefix=/usr

	The location of CUPS filter and ppd files are decided automatically,
	but you can specify with the follwing configure options.
	
	* "--with-cupsfilterdir"    The location of CUPS filter
	                            ex) /usr/lib/cups/filter
	                            
	* "--with-cupsppddir"       The location of PPD files
	                            ex) /usr/share/ppd/epson-laser-escpage-raster

	6.3.3  Make and Install
	   $ cd epson-laser-printer-escpage-1.0.1
	   $ make 
	   $ sudo make install


***End of file