← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/Installing_Linux.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/Installing_Linux.html
42
42
    used of the PC speaker driver, which can be done by adding the
43
43
    command <span style="font-weight: bold;">/sbin/modprobe pcspkr </span>to
44
44
 
 
45
 
 
46
 
45
47
    the <span style="font-weight: bold;">/etc/rc.local</span> startup
46
48
    script. You may also have to run <span style="font-weight: bold;">xset
47
49
 
 
50
 
 
51
 
48
52
      b 100 1000 100</span> in your local setup, if you are running in
49
53
    an X11 environment. You can check that the system bell is operating
50
54
    by doing an "echo ^G", where ^G is ctrl-G.<br>
180
184
    may then need to add yourself to that group.<br>
181
185
    <br>
182
186
    <span style="font-weight: bold;"></span>Copy the file <span
183
 
      style="font-weight: bold;">libusb1/</span><span
184
 
      style="font-weight: bold;">55-Argyll.rules</span> from the binary
185
 
    or source distribution into <span style="font-weight: bold;">/etc/udev/rules.d/55-Argyll.rules</span>
 
187
      style="font-weight: bold;">usb/</span><span style="font-weight:
 
188
      bold;">55-Argyll.rules</span> from the binary or source
 
189
    distribution into <span style="font-weight: bold;">/etc/udev/rules.d/55-Argyll.rules</span>
186
190
    with&nbsp;owner root, group root, permissions 644.<br>
187
191
    (There may already be a file that handles some of the color
188
192
    instruments as part of your installation. You need to check though
192
196
    that uses a udev that doesn't recognize the syntax used in
193
197
    55-Argyll.rules, or that doesn't have rules to create the libusb
194
198
    /dev/bus/usb/00X/00Y device entries, you should install the <span
195
 
      style="font-weight: bold;">libusb1/45-Argyll.rules</span> file
 
199
      style="font-weight: bold;">usb/45-Argyll.rules</span> file
196
200
    instead.<br>
197
201
    <br>
198
202
    On recent systems the new rules file will be notices as soon as you
200
204
    On older systems you may need to run <b>/sbin/udevtrigger</b>,&nbsp;
201
205
 
202
206
 
 
207
 
 
208
 
203
209
    <b>/sbin/udevcontrol reload_rules</b> or&nbsp; <span
204
210
      style="font-weight: bold;">/sbin/udevstart</span> or reboot to get
205
211
    the new file noticed.<br>
215
221
    <br>
216
222
    # Recognize the color measurement devices<br>
217
223
    <br>
 
224
    # Colorimtre HCFR<br>
 
225
    ATTRS{idVendor}=="04db", ATTRS{idProduct}=="005b",
 
226
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
227
    <br>
 
228
    <br>
 
229
    # MonacoOPTIX (Same as i1 Display 1)<br>
 
230
    ATTRS{idVendor}=="0670", ATTRS{idProduct}=="0001",
 
231
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
232
    <br>
 
233
    <br>
 
234
    # HueyL (not tested)<br>
 
235
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="5001",
 
236
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
237
    <br>
 
238
    # HueyL (not tested)<br>
 
239
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="5010",
 
240
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
241
    <br>
 
242
    # i1Display 3<br>
 
243
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="5020",
 
244
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
245
    <br>
 
246
    # ColorMunki Smile<br>
 
247
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="6003",
 
248
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
249
    <br>
218
250
    # DTP20<br>
219
251
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="d020",
220
252
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
227
259
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="d094",
228
260
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
229
261
    <br>
230
 
    # MonacoOPTIX (Same as i1 Display 1)<br>
231
 
    ATTRS{idVendor}=="0670", ATTRS{idProduct}=="0001",
 
262
    <br>
 
263
    # i1Pro<br>
 
264
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2000",
 
265
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
266
    <br>
 
267
    # i1Monitor<br>
 
268
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2001",
232
269
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
233
270
    <br>
234
271
    # i1Display<br>
235
272
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2003",
236
273
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
237
274
    <br>
238
 
    # i1Display 3<br>
239
 
    ATTRS{idVendor}=="0765", ATTRS{idProduct}=="5020",
240
 
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
241
 
    <br>
242
 
    # i1Monitor<br>
243
 
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2001",
244
 
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
245
 
    <br>
246
 
    # i1Pro<br>
247
 
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2000",
 
275
    # i1 io table (not tested)<br>
 
276
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2004",
 
277
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
278
    <br>
 
279
    # Huey<br>
 
280
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2005",
 
281
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
282
    <br>
 
283
    # i1 iSis (not tested)<br>
 
284
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2006",
248
285
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
249
286
    <br>
250
287
    # ColorMunki<br>
251
288
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2007",
252
289
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
253
290
    <br>
254
 
    # Colorimtre HCFR<br>
255
 
    ATTRS{idVendor}=="04db", ATTRS{idProduct}=="005b",
 
291
    <br>
 
292
    # Spyder 1<br>
 
293
    ATTRS{idVendor}=="085c", ATTRS{idProduct}=="0100",
256
294
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
257
295
    <br>
258
296
    # Spyder 2<br>
267
305
    ATTRS{idVendor}=="085c", ATTRS{idProduct}=="0400",
268
306
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
269
307
    <br>
270
 
    # Huey<br>
271
 
    ATTRS{idVendor}=="0971", ATTRS{idProduct}=="2005",
272
 
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
273
 
    <br>
274
 
    # Let udev-acl and ConsoleKit manage these devices, if applicable<br>
275
 
    TEST=="/lib/udev/udev-acl", TEST=="/var/run/ConsoleKit/database",
 
308
    <br>
 
309
    # ColorHug, old and new<br>
 
310
    ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="f8da",
 
311
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
312
    ATTRS{idVendor}=="273f", ATTRS{idProduct}=="1001",
 
313
    ENV{COLOR_MEASUREMENT_DEVICE}="1"<br>
 
314
    <br>
 
315
    <br>
 
316
    # Let udev-acl manage these devices, if it's available<br>
 
317
    TEST=="/var/run/ConsoleKit/database",
276
318
    ENV{COLOR_MEASUREMENT_DEVICE}=="*?", ENV{ACL_MANAGE}="1"<br>
277
319
    <br>
278
 
    # Otherwise, restrict access to members of the plugdev group<br>
 
320
    # Otherwise, restrict access to members of the plugdev group,<br>
 
321
    # which the user may have to add to the system.<br>
279
322
    ENV{COLOR_MEASUREMENT_DEVICE}=="*?", ENV{ACL_MANAGE}!="*?",
280
323
    MODE="660", GROUP="plugdev"<br>
281
324
    <br>
342
385
instruments
343
386
 
344
387
 
 
388
 
 
389
 
345
390
        access using hotplug:<br>
346
391
      </span></h5>
347
392
    Under <span style="font-weight: bold;">much older versions of Linux</span>,
351
396
    your system.<br>
352
397
    <br>
353
398
    Assuming we want to configure for all Argyll supported USB
354
 
    instruments, copy the file <span style="font-weight: bold;">libusb1/</span><span
 
399
    instruments, copy the file <span style="font-weight: bold;">usb/</span><span
355
400
      style="font-weight: bold;">Argyll.usermap</span> from the binary
356
401
    or source distribution into&nbsp; <span style="font-weight: bold;">/etc/hotplug/usb/Argyll.usermap</span>
357
402
    with owner root, group root, permissions 644.<span
399
444
    Argyll 0x0003 0x0971 0x2007 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00
400
445
    0x00 0x00000000<br>
401
446
    #<br>
 
447
    # ColorMunki Smile<br>
 
448
    Argyll 0x0003 0x0765 0x6003 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00
 
449
    0x00 0x00000000<br>
 
450
    #<br>
402
451
    # Colorimtre HCFR<br>
403
452
    Argyll 0x0003 0x04DB 0x005B 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00
404
453
    0x00 0x00000000<br>
418
467
    # Huey<br>
419
468
    Argyll 0x0003 0x0971 0x2005 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00
420
469
    0x00 0x00000000<br>
 
470
    #<br>
 
471
    # ColorHug<br>
 
472
    Argyll 0x0003 0x04D8 0xF8DA 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00
 
473
    0x00 0x00000000<br>
 
474
    Argyll 0x0003 0x273F 0x1001 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00
 
475
    0x00 0x00000000<br>
421
476
    &nbsp;&nbsp;&nbsp; ----------------- cut here ---------------------<br>
422
477
    <br>
423
478
    &nbsp;(For even older versions, append the lines above to <span
424
479
      style="font-weight: bold;">/etc/hotplug/usb.usermap</span>, and
425
480
    you may have to run <span style="font-weight: bold;">update-usb.usermap</span>)<br>
426
481
    <br>
427
 
    Then copy the file <span style="font-weight: bold;">libusb1/</span><span
 
482
    Then copy the file <span style="font-weight: bold;">usb/</span><span
428
483
      style="font-weight: bold;">Argyll</span> from the binary or source
429
484
    distribution into <span style="font-weight: bold;">/etc/hotplug/usb/Argyll</span>
430
485
    with owner root, group root, permissions 744.<span
463
518
    plugdev yourusernamehere".<br>
464
519
    &nbsp;If this doesn't work you will have to run "id yourusername" to
465
520
    list the current suplemental<br>
466
 
    &nbsp;groups, and add them plus plugdev using just "usermod -G
 
521
    &nbsp;groups, and add plugdev using just "usermod -G
467
522
    group1,group2,... yourusername")<br>
468
523
    <br>
469
524
    You may find that the <span style="font-weight: bold;">plugdev</span>
485
540
instruments
486
541
 
487
542
 
 
543
 
 
544
 
488
545
        access:</span><br>
489
546
    </h5>
490
547
    If you have a serial instrument then you may find that by default
509
566
    plugdev yourusernamehere".<br>
510
567
    &nbsp;If this doesn't work you will have to run "id yourusername" to
511
568
    list the current suplemental<br>
512
 
    &nbsp;groups, and add them plus plugdev using just "usermod -G
 
569
    &nbsp;groups, and add a tty or uucp group using just "usermod -G
513
570
    group1,group2,... yourusername")<br>
514
571
    <br>
515
 
    You may have to log out and then in again for the groups to become
 
572
    You may have to log out and then in again for the group to become
516
573
    effecive.<span style="font-weight: bold;"><br>
517
574
    </span>
518
575
    <p>&nbsp; <br>