summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/README.indilib-drivers52
1 files changed, 21 insertions, 31 deletions
diff --git a/Documentation/README.indilib-drivers b/Documentation/README.indilib-drivers
index ff703ad..2baa735 100644
--- a/Documentation/README.indilib-drivers
+++ b/Documentation/README.indilib-drivers
@@ -1,55 +1,42 @@
INDILIB 3rd PARTY DRIVERS INSTALLATION GUIDE
-0. Login as root or use sudo.
+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 layman to manage overlays if don't have this tool already.
-sudo emerge -v app-portage/layman
+1. Install overlay using one of these methods:
-2. Add brancik-overlay.xml file to the /etc/layman/overlays directory with the following content:
+a. Using app-portage/layman (emerge if it is not installed)
-sudo nano -w /etc/layman/overlays/brancik-overlay.xml
+layman -o https://dev.brancik.cz/git/brancik-overlay/tree/overlay.xml -f -a brancik-overlay
-<?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>
+b. using provided repos.conf
-Or you can use layman-overlay-maker tool if you have >=app-portage/layman-2.0.0 installed.
+curl -sL https://dev.brancik.cz/git/brancik-overlay/tree/repos.conf > /etc/portage/repos.conf/brancik-overlay.conf
-More info about Gentoo overlays and their management can be found on http://wiki.gentoo.org/wiki/Layman and in layman man pages.
+2. Sync the ebuild using emaint sync -r brancik-overlay
-3. Add overlay:
-
-sudo layman -f -a brancik-overlay
-
-4. To install all available indilib drivers simply use provided portage set:
+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.
-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:
+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
- aagcloudwatcherng
+ - ahpcorrelator
- aok
- apogee
- armadillo
- asi
+ - asi-power
+ - astrolink4
+ - astromechfoc
- atik
- avalon
- beefocus
+ - celestronaux
- dreamfocuser
- dsi
- duino
@@ -69,14 +56,17 @@ Available USE flags (Note that only 3rd party drivers are present. All other dri
- nexdome
- nexstarevo
- nightscape
+ - pentax
- qhy
- qsi
+ - rtklib
- rtlsdr
- sbig
- shelyak
- spectracyber
- ssag
- starbook
+ - sv305
- sx
- talon6
- toupbase
@@ -95,19 +85,19 @@ 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
+5. 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.
+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 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:
+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).
+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