← Back to branch summary

~ubuntu-branches/ubuntu/trusty/argyll/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/spyd2en.html

  • Committer: Package Import Robot
  • Author(s): Artur Rona
  • Date: 2014-02-12 00:35:39 UTC
  • mfrom: (13.1.24 sid)
  • Revision ID: package-import@ubuntu.com-20140212003539-24tautzlitsiz61w
Tags: 1.5.1-5ubuntu1
https://launchpad.net/bugs/1275572
* Merge from Debian unstable. (LP: #1275572) Remaining changes:
  - debian/control:
    + Build-depend on libtiff-dev rather than libtiff4-dev.
  - debian/control, debian/patches/06_fix_udev_rule.patch:
    + Fix udev rules to actually work; ENV{ACL_MANAGE} has
      stopped working ages ago, and with logind it's now the
      "uaccess" tag. Dropping also consolekit from Recommends.
  - debian/patches/drop-usb-db.patch:
    + Use hwdb builtin, instead of the obsolete usb-db
      in the udev rules.
* debian/patches/05_ftbfs-underlinkage.diff:
  - Dropped change, no needed anymore.
* Refresh the patches.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/spyd2en.html
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html>
3
 
<head>
4
 
  <title>spyd2en</title>
5
 
  <meta http-equiv="content-type"
6
 
 content="text/html; charset=ISO-8859-1">
7
 
  <meta name="author" content="Graeme Gill">
8
 
</head>
9
 
<body>
10
 
<h2><b>spectro/spyd2en</b></h2>
11
 
<h3>Summary</h3>
12
 
A special purpose tool that enables the Spyder 2
13
 
colorimeter.<br>
14
 
<h3>Usage summary<br>
15
 
</h3>
16
 
<small><span style="font-family: monospace;">spyd2en [-v] [<span
17
 
 style="font-style: italic;">inputfile</span></span>]<br
18
 
 style="font-family: monospace;">
19
 
<span style="font-family: monospace;">&nbsp;-v level
20
 
&nbsp;&nbsp;&nbsp;&nbsp; Verbose<br>
21
 
&nbsp;-S d&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
22
 
Specify the install scope u = user (def.), l = local system]<br>
23
 
&nbsp;creates spyd2PLD.bin from vendor install files.<br
24
 
 style="font-family: monospace;">
25
 
</span><span style="font-family: monospace;"></span><span
26
 
 style="font-family: monospace;"></span></small><br>
27
 
<h3></h3>
28
 
<h3>Flags and Parameters</h3>
29
 
The <span style="font-style: italic;">inputfile</span> argument is
30
 
optional, and and can be used to specify the MSWindows setup.exe file
31
 
from the installation CD (or possibly downloaded from the manufacturers
32
 
website),
33
 
if spyd2en is unable to locate this file automatically on the CD.<br>
34
 
<br>
35
 
The <b>-v</b> parameter enables verbosity. This may be of use in
36
 
figuring out what went wrong if it doesn't work.<br>
37
 
<br>
38
 
The <span style="font-weight: bold;">-S</span> option allows
39
 
installing the PLD pattern file in a local system location, rather than
40
 
the default user accessible location. You may need to run this as
41
 
superuser using the "sudo" command on Linux systems.<span
42
 
 style="font-weight: bold;"><span style="font-weight: bold;"><span
43
 
 style="font-weight: bold;"></span></span></span><br>
44
 
<h3>Usage Details and Discussion</h3>
45
 
<span style="font-weight: bold;"></span>The Spyder 2 instrument cannot
46
 
function without the presence of the instrument vendors PLD firmware
47
 
pattern for the device. This firmware is not provided with
48
 
Argyll, since it has not been made available under a compatible license.<br>
49
 
<br>
50
 
The purchaser of a Spyder 2 instrument
51
 
should have received a copy of this firmware along with their
52
 
instrument from the original vendor, and <span
53
 
 style="font-weight: bold;">spyd2en</span> enables their instrument, by
54
 
locating the firmware in the users copy of the
55
 
instrument install files.<br>
56
 
<br>
57
 
On Microsoft Windows or Apple OS X platforms, <span
58
 
 style="font-weight: bold;">spyd2en</span> will look to
59
 
see if
60
 
the vendors drivers have been installed on the users machine, and
61
 
locate the firmware pattern from there. If the vendors drivers have
62
 
not been installed, or the user does not wish to install them, or no
63
 
vendors drivers are available for the users platform (i.e. Linux), then
64
 
<span style="font-weight: bold;">spyd2en</span> will also attempt to
65
 
locate the Spyder 2 installation CDROM, and make use of the firmware
66
 
pattern from there. In this case, the CDROM should be placed in a CD
67
 
drive prior to
68
 
running spyd2en. If your Linux system is not running
69
 
automount, or your automount is setup to mount CDROM's somewhere other
70
 
than <span style="font-style: italic;">/media</span>,<span
71
 
 style="font-style: italic;"> /mnt/cdrom</span>, <span
72
 
 style="font-style: italic;">/media/cdrom</span> or <span
73
 
 style="font-style: italic;">/cdrom</span>, then you will have to mount
74
 
the CDROM manually, and give spyd2en the path to the CDROM
75
 
setup/setup.exe
76
 
file as the argument <span style="font-style: italic;">inputfile</span>.<span
77
 
 style="font-weight: bold;"><br>
78
 
<br>
79
 
NOTE </span>that under OS X 10.6 (Snow Leopard) you may need to run
80
 
spyd2en as root to be able to mount the CDROM's ISO partition. The
81
 
simplest way of doing this is to use the "sudo" commands. e.g. "sudo
82
 
spyd2en", which will then ask you to enter the root password.<br>
83
 
<br>
84
 
If the instrument firmware pattern is successfully located, then
85
 
spyd2en will create a <span style="font-weight: bold;">spyd2PLD.bin</span>
86
 
file in a subdirectory of the users home directory, or if the <span
87
 
 style="font-weight: bold;">-S l</span> option is used, will store it
88
 
in a system wide location. (the <a
89
 
 href="http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html">XDG
90
 
Base
91
 
Directory
92
 
specifications</a> are used as a basis for storing the
93
 
file). Programs that access instruments such as&nbsp; <span
94
 
 style="font-weight: bold;">spotread</span>, <span
95
 
 style="font-weight: bold;">dispcal</span> and <span
96
 
 style="font-weight: bold;">dispread</span>, can then locate and load
97
 
the firmware into
98
 
the instrument.<br>
99
 
<br>
100
 
<span style="font-weight: bold;">Note</span> that the <span
101
 
 style="font-weight: bold;">spyd2PLD.bin</span> file created by spyd2en
102
 
contains the
103
 
proprietary
104
 
and copyrighted firmware provided by the instrument vendor, and while
105
 
the vendor has provided
106
 
the firmware to the end
107
 
user to facilitate the use of their purchased instrument, the
108
 
instrument vendor (typically) does not permit the user to distribute
109
 
such a file or
110
 
make copies for purposes other than making use of their own instrument.<br>
111
 
<br>
112
 
</body>
113
 
</html>