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

0. You have to add ebuild repository (overlay) on top of your standard portage tree. You can read about it on https://wiki.gentoo.org/wiki/Ebuild_repository.

1. Install overlay using one of these methods:

a. Using app-portage/layman (emerge if it is not installed)

layman -o https://dev.brancik.cz/git/brancik-overlay/tree/overlay.xml -f -a brancik-overlay

b. using provided repos.conf

curl -sL https://dev.brancik.cz/git/brancik-overlay/tree/repos.conf > /etc/portage/repos.conf/brancik-overlay.conf

2. Sync the ebuild using emaint sync -r brancik-overlay

3. 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.

4. 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-ng
	ahp-xc
	aok
	apogee
	armadillo
	astrolink4
	astromechfoc
	asi
	atik
	avalon
	beefocus
	bresserexos2
	celestronaux
	dreamfocuser
	dsi
	duino
	eqmod
	ffmv
	fishcamp
	fli
	gige
	gphoto2
	gpsd
	gpsnmea
	inovaplx
	limesdr
	maxdomeii
	mgen
	mi
	nexdome
	nightscape
	orion-ssg3
	pentax
	playerone
	qhy
	qsi
	rtklib
	sbig
	shelyak
	spectracyber
	starbook
	starbook-ten
	sv305
	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

5. Note that ebuilds for stable release of indilib drivers 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.

6. 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 will try to maintain ebuilds as the time goes by and my spare time allows me.

7. 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) and sci-astronomy/siril (useful tool for astrophotography) and some other software.

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