summaryrefslogtreecommitdiff
path: root/Documentation/README.indilib-drivers
blob: ff703ad753ae9abf90e9bcc00e168cde22c334dc (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
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 with 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>https://dev.brancik.cz/git/brancik-overlay/</homepage>
        <owner type="project">
                <email>ctibor@brancik.cz</email>
                <name>Ctibor Brančík</name>
        </owner>
        <source type="git">https://git.brancik.cz/brancik-overlay.git</source>
</repo>
</repositories>

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

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 or

sudo emerge -v @indilib-drivers-live if you want bleeding edge drivers straight from git repository. Note that you have to install indilib from git too.

5. If you want to install only drivers for the devices you use (yeah, that is the Gentoo way, isn't it?), you have to set appropriate USE flags:

Available USE flags (Note that only 3rd party drivers are present. All other drivers are installed by sci-libs/indilib itself):
  - aagcloudwatcher
  - aagcloudwatcherng
  - aok
  - apogee
  - armadillo
  - asi
  - atik
  - avalon
  - beefocus
  - dreamfocuser
  - dsi
  - duino
  - eqmod
  - ffmv
  - fishcamp
  - fli
  - gige
  - gphoto2
  - gpsd
  - gpsnmea
  - inovaplx
  - limesdr
  - maxdomeii
  - mgen
  - mi
  - nexdome
  - nexstarevo
  - nightscape
  - qhy
  - qsi
  - rtlsdr
  - sbig
  - shelyak
  - spectracyber
  - ssag
  - starbook
  - sx
  - talon6
  - toupbase
  - webcam

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 1.8.3) 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.

7. You can use provided init script in /etc/init.d/indiserver and respective configuration file in /etc/conf.d/indiserver to set indiserver to start automatically.

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.

8. Known problems:

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

Firmware for QHY cameras (sci-libs/libqhy) won't cross emerge for armv7a CHOST, because provided binary is only for armv6, which confuses compiler. It can be emerged on RaspberryPi directly 

9. The overlay also includes ebuild for sci-astronomy/open-phd-guiding (version 2 directly from git).

I hope someone will find this useful and please report any bugs with the ebuilds or compilation failures to the forum: http://indilib.org/forum/general/566-my-gentoo-overlay-with-indilib-3rd-party-drivers