summaryrefslogtreecommitdiff
path: root/README.indilib-drivers
blob: 5983583602c4708a6c6c848d65baf64daabb97cf (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
INDILIB 3rd PARTY DRIVERS INSTALLATION GUIDE

0. Login as root or use sudo.

1. Install layman to manage overlays if don't have this tool already.
sudo emerge -v app-portage/layman

2. Add brancik-overlay.xml file to the /etc/layman/overlays directory wit the following content:

sudo nano -w /etc/layman/overlays/brancik-overlay.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE repositories SYSTEM "/dtd/repositories.dtd">
<repositories xmlns="" version="1.0">
<repo quality="experimental" status="official">
        <name>brancik-overlay</name>
        <description>Ctibor Brancik's overlay</description>
        <homepage>http://git.brancik.cz</homepage>
        <owner type="project">
                <email>ctibor@brancik.cz</email>
                <name>Ctibor Brančík</name>
        </owner>
        <source type="git">git://git.brancik.cz/gentoo-overlay.git</source>
</repo>
</repositories>

Or you can use layman-overlay-maker tool if you have >=app-portage/layman-2.0.0.

More info about Gentoo overlays and their management can be found on http://wiki.gentoo.org/wiki/Layman and in layman man pages.

3. Add overlay:

sudo layman -f -a brancik-overlay

4. To install all available indilib drivers simply use provided portage set:

sudo emerge -v @indilib-drivers

5. If you want to install only drivers for the devices you use (as is the Gentoo way), you have to set appropriate USE flags:

Available USE flags (note that only 3rd party drivers are present, with exception of indi-qhy-old. All other drivers are installed by sci-libs/indilib itself):
  - aagcloudwatcher
  - apogee
  - asicam
  - duino
  - eqmod
  - fishcamp
  - fli
  - gphoto2
  - maxdomeii
  - meadedsi
  - qhy
  - qsi
  - sbig
  - spectracyber
  - sx
  - tess

nano -w /etc/portage/package.use/indilib

#Enable drivers USE flag which pulls sci-libs/indilib-drivers as dependency

sci-libs/indilib drivers

# To install indi_gphoto_ccd, indi_qhy_ccd and indi_sbig_ccd.
# sci-libs/indilib-drivers is a meta ebuild and works similar to x11-base/xorg-drivers package.

sci-libs/indilib-drivers gphoto2 qhy sbig
sudo emerge sci-libs/indilib::brancik-overlay

6. Note that ebuilds for stable release of indilib drivers (currently 0.9.9) are keyworded unstable (~amd64, ~x86 specifically) and live source ebuilds are all masked by package.mask. You will have to unmask them during installation (use emerge with --autounmask-write option). See official docs if you do not know this means exactly.

I have tested all the drivers and they compile OK at least on amd64 and arm. Whether they work with your device is up to you to discover :-) I will try to maintain ebuilds as the time goes by and my spare time allows me.

Known problems:

Firmware for sbig (sci-libs/sbig) won't cross emerge if the host machine belongs to different ARCH.

The overlay also includes ebuilds for sci-astronomy/lin_guider, sci-astronomy/ccd, sci-astronomy/qastrocam-g2 and sci-astronomy/open-phd-guiding (version 1 and 2 directly from svn).

I hope someone will find this useful and please report any bugs with the ebuilds or compilation failures.