~jolting/c2esp/trunk

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
TOPICS
------
    * INSTALLATION
    * UBUNTU NOTES  
    * DEBIAN NOTES
    * UNINSTALLING
    * BUG REPORTS
    * DEVELOPER AND DEBUGGING TIPS

INSTALLATION
------------
The general procedure will be like this (see below for details for different distros):

Download:
	You download the compressed archive file

Unpack:
	You uncompress the archive to get several files required to install the driver.
	(This is one of those files, so you have probably done that already)

(Optional) Install packages needed for this driver to work:
	You may need to install some packages before you can install the driver.
	Most distros have some package manager that you use to do this.
 
(Optional) Uninstall:
	If you have already installed a previous version of this driver, it might be helpful to uninstall it.
	If not, ignore this step.

Compile:
	You need to convert the program, written in c, into something your computer can run.
	Compiling will be done by a command like "make"

Install driver,  PPD files, and extra files:
	Various files need to be copied to folders where the system can find them.
	This will be done with a command like "make install"

Restart cups:
	cups is the printing system, having installed the files of this driver, you restart cups so that it knows about the new driver.
	This will be done with a command like "make cups"

Create printers:
	This is where you tell cups about the new printer.

Then it should be possible to print.


Detailed versions follow for different distros:

UBUNTU NOTES  
------------
(in the following NN in the filename c2espNN means the 2 digits of the release no)
(so for release 0.4, you would type c2esp04 )

Download:
	You download the compressed archive file from http://sourceforge.net/projects/cupsdriverkodak/
	It is usually convenient to store the dowloaded file on the desktop.

Unpack:
	You uncompress the archive to get several files required to install the driver.
	If you double click on the dowloaded .tar.gz file, the archive manager should open. 
	Use the extract button to extract files from the archive.
	The goal is to get a folder called something like c2esp04 (the last 2 digits depend on the version of the driver)in some place you specify, for example in your home folder.
	This folder should contain the files in the archive.

(Optional) Install packages needed for this driver to work:
	You may need to install some packages if you do not already have them, before you can install the driver.
	I'm assuming you know how to do that (with synaptic package manager, in Menu: System/Administration).
	You will need the following:
		build-essential
		cups
		libcups2-dev
		libcupsimage2-dev

You need to open a terminal for the following steps:
	Menu: Applications/Accessories/Terminal
	When the terminal starts you will be in your home folder. You need to navigate to the folder where you unpacked the driver.
	(in the following NN in the filename c2espNN means the 2 digits of the release no)
	(so for release 0.4, you would type c2esp04 )
	For example (in this example "$" represents the prompt, you type what follows the $:
		$ cd c2espNN
 
(Optional) Uninstall:
	If you have already installed a previous version of this driver, it might be helpful to uninstall it.
	If not, ignore this step.
	To uninstall, you type:
		$ sudo make uninstall
	The sudo indicates that you want to do some kind of system modification that you would normally be prevented from doing.
	So you get asked for the password the first time you use sudo.

Compile:
	You need to convert the program, written in c, into something your computer can run.
	To compile, you type:
		$ make
	You may get messages suggesting you need to install some package (see the (Optional) Install packages section above)
	You may get some warnings, you can probably ignore those.
	You may get some error messages, if so it's unlikely you can continue.

Install driver,  PPD files, and extra files:
	Various files need to be copied to folders where the system can find them.
	To install, you type:
		$ sudo make install
	The sudo indicates that you want to do some kind of system modification that you would normally be prevented from doing.
	So you get asked for the password the first time you use sudo.

Restart cups:
	cups is the printing system, having installed the files of this driver, you restart cups so that it knows about the new driver.
	To restart cups, you type:
		$ sudo make cups

Create printers:
	This is where you tell cups about the new printer.
	Turn the printer on.
	Menu: System/Administration/Printing
	A printer configuration window should open.
	Click the "new" button, and wait while the system searches for printers, you should get a "Select device" window.
	Navigate to the printer (network printer or USB printer). 
	I find I have to wait for several seconds after clicking on a network printer for it to be highlighted.
	If you are setting up a new version of c2esp, you may have more than one version of the printer to choose from.
	From c2esp11 and later there is more than one ppd file: model 5200 has no duplex, model 5500 has duplex.
	Select the file that best matches your printer model.
	Click "Forward" and wait again for the "Describe printer" window.
	Change the names if you wish, and click the "Apply" button.
	Print test page if you wish, but you might do this first:
	If you right click the newly created printer in the printer configuration window, you can set up some properties like:
		Colour or b/w, resolution, paper size etc. (under printer options)
	I generally make 2 printers, one colour and one b/w.

Then it should be possible for you to print.


DEBIAN NOTES
------------
	BEWARE, THESE DEBIAN NOTES ARE JUST A GUESS THEY ARE UNTESTED.

    Install build-essential,  cupsys FIRST:
	$ su
	# apt-get install build-essential
	# apt-get install cupsys

	$ wget -O c2espNN.tar.gz http://<address of file>
        $ tar zxf c2espNN.tar.gz
        $ cd c2espNN
        $ make
        $ su
        # make install
	$ firefox http://localhost:631


UNINSTALLING
------------
    This will uninstall everything from your system.

    $ su
    # make uninstall

BUG REPORTS
-----------

DEVELOPER AND DEBUGGING TIPS
----------------------------
	c2esp creates some files in /tmp
	KodakPrintLog - may help to identify where c2esp goes wrong
	KodakPrintFile - a copy of what gets sent to the printer
	RasForComp.pbm - the raster data, before it gets compressed and sent to the printer

	In /etc/cups/cupsd.conf
	Change LogLevel warn to LogLevel debug to get much more information in /var/log/cups/error_log
	
	If you compile with the flag -g you can subsequently use the debugger gdb to locate run time errors.
	But I'm not sure how you do this when c2esp is generally launched by cups and not run directly by the user.