From b824d48688a06d4a4a5d738fb6439829627e9d31 Mon Sep 17 00:00:00 2001 From: "Spencer E. Olson" Date: Sat, 20 Jun 2026 10:06:56 -0600 Subject: [PATCH] add documentation for indi_gige_ccd driver --- .../docs/cameras/generic/aravis/aravis.md | 63 ++++++++++++++++++ .../docs/cameras/generic/aravis/aravis.webp | Bin 0 -> 2278 bytes .../docs/cameras/generic/aravis/aravis.yaml | 13 ++++ 3 files changed, 76 insertions(+) create mode 100644 src/content/docs/cameras/generic/aravis/aravis.md create mode 100644 src/content/docs/cameras/generic/aravis/aravis.webp create mode 100644 src/content/docs/cameras/generic/aravis/aravis.yaml diff --git a/src/content/docs/cameras/generic/aravis/aravis.md b/src/content/docs/cameras/generic/aravis/aravis.md new file mode 100644 index 0000000..e8c401b --- /dev/null +++ b/src/content/docs/cameras/generic/aravis/aravis.md @@ -0,0 +1,63 @@ +--- +title: GigE-Vision and USB3-Vision Cameras +categories: ["Cameras"] +description: All Aravis-supported cameras +thumbnail: ./aravis.webp +--- +Using the open source [Project Aravis](https://github.com/AravisProject/aravis) +GenICam library, INDI gains access to a large set of industrial machine-vision +cameras. Machine-vision cameras supported by Aravis implement the GenICam +(Generic Interface for Cameras) standard and commonly conform to the GigE-Vision +and USB3-Vision standards. + +GenICam (Generic Interface for Cameras) is a global machine vision standard that +decouples camera hardware interfaces (like GigE Vision or USB3 Vision) from +software applications. It provides a universal programming interface (API) so +that any compliant camera can be controlled by any software without needing +custom, manufacturer-specific drivers. + +From the Aravis documentation, +> Aravis is a GLib/GObject based library for video acquisition using Genicam +> cameras. It currently implements the gigabit ethernet and USB3 protocols used +> by industrial cameras. It also provides a basic ethernet camera simulator and +> a simple video viewer. + +## Features + +The driver supports both single-exposure image acquisition as well as image +streaming. The driver constructs a minimal set of controls provided and +accessed by the underlying +[Project Aravis](https://github.com/AravisProject/aravis) library. Currently, +controls for exposure, gain, subframing, and binning are supported. At least +some GenICam devices support the `DeviceTemperature` property. If a particular +camera includes the `DeviceTemperature` property, this is queried and inserted +into fits images. One should note that most GigE-Vision cameras do not provide +control of the temperature. + +Currently, this driver expects the camera to already have its PixelFormat +property to be set to Mono16. Changing the PixelFormat and other properties +must currently be done with Aravis tools directly while this INDI driver is +**NOT** connected to the camera. Further, while the INDI driver expects to +connect to the camera, the Aravis tools must be disconnected. Very easy +modifification of some camera features (including PixelFormat) can be +accomplished and tested with the arv-viewer-0.8 graphical interface. Somewhat easy +modification to all the other features of the camera can be done with the +arv-tool-0.8 command. Additionally, one can use +[Python](https://lazka.github.io/pgi-docs/Aravis-0.8/index.html) or other Aravis +[GLib/GObject-supported](https://aravisproject.github.io/aravis/aravis-stable/) +programming interfaces to interact with and control these cameras. + +## Supported Cameras + +Any GigE-Vision or USB3-Vision GenICam camera may be supported. [Project +Aravis](https://github.com/AravisProject/aravis) does keep a [list of cameras +known to work](https://github.com/AravisProject/aravis/wiki/TestedCameras), +though this appears to be somewhat out of date. Some cameras +tested with INDI and not documented on the list include [FLIR's Oryx +10GigE](https://www.teledynevisionsolutions.com/products/oryx-10gige), and +several other FLIR cameras (both GigE-Vision and USB3-Vision types). + +### Connecting to Camera + +Only cameras that are accessible when the INDI server launches will be available +for connecting. diff --git a/src/content/docs/cameras/generic/aravis/aravis.webp b/src/content/docs/cameras/generic/aravis/aravis.webp new file mode 100644 index 0000000000000000000000000000000000000000..56e2fc3e3c7c7247b8d5931bcba7ad73ecb81202 GIT binary patch literal 2278 zcmV2ubAjY3-}O9&%sPzB)1kfRc-QGM zYMVjbrN28H4?9j3*jy|RyXW7okfP+zaAJA5NfL_E)X5mv(e{?!N^gDFNgR&yxaqcu zw{xrD`xQ9D%jTzOKfC@|=v~?Lz_ zlhXxI*hiQzmgAg#+Xd@4Zv`J;Bh2UH_1}nEX}gK5`>F_!LLXRNPKkz;8C{L1eVTsB z>uyf8#Zk5(6kdm8R8>gZwAz!B3BfM^@+jWMQ7UYR)w_mEe6GtBtfHZ~7sAy|tB?q- z)7*D{wu?l3|9w~j-%NwOy7M%j%t0^4jn!+iVQw)pn37RrZoC#R^G3&!r)4~`*6PQR zVCjg($RN}WSq-{7=3y^Uo=`Za@J3 z{wcr!o>sM#S^Dr+!&&z)_YB2SFvbzR6k=#eBLUrce$O7dJayq5WOUU~_-T(IqoLYo z%b?qDEmr9gi`O)wdk36KS#~*~-Kb1EnRUES>AL;-e(ZPvgF<0!d4QuP6?_iNQliyc zLsMWJVM$w%cd49T$m`_w1nd#P49c0C6wDCe#W1)v-IA}-`ON{#`TRXkekU+BJ~shf zByK=6b+n0Zp#4z|dldH%_#0jjgd$ZZ+z~9Bo(FGt>dRMDYvW4YiKC=j|Sr*st} zXfWX|cgVRn$@%_awL9xAao$QWhut=(e0Q@M%B0I84@J7)rtXqR(3amp^kqCIMLK3v z1oWh;s*EtJ5qfveQem-+N$tAS=ZQ_ z+}LuVe-56RZAR#O0goNJW-ivKi3}Y^|mF4p!SwM^JgFc#3OD7#14a{0<6< z_xfUd>e<^8BFz#XzaT>cGq2x~cC1w{s)mhfz^aG_M`~xOXrHc81IyG+9h1Y(NUMI< z;uJ`6PfEOYPXoZ*Vhhwh+PJe7y(p{e>E^x3Ujv*ftGSPc3uh&S@^1K}!OSC3>T(k@ zMHsKF!-!|RiRl2il(pmodunmz2|Ie6nlm=U#O2n&`KQY(E*0=$(-<~oZAQfRc1J+~ zABM6P!UpNza1hFNJG#4;WT97CPf9SP10T{E_+Vnv-0N#e2s+c;bwK<13_XTHb6U<~ z3I;_9f{Iv-Coxtjz%L2NMeHUhbDMw{M;VQs0>HLv}KAl*Uyg zg*b^E$^Hd60Z$3&_hBs8kHAn_*ki-68`sLIN%Getke_;)5TC1+G^CSt_&G}^demi) z^4TDAV;+$@uVGPS7;`zcbh89T_+|p~+5#OEu99OU*%%Q<;ud~WP~@ZBqY#I^uHEz! zK@AJYZ!c__JQo`h3CGS@37k~?G8GlPm&g1SK#)aKbARlLzbSNoV(5x`G=U_HEV3GZ z5k2@>=?Qwk++Fo`wwyWwwOOdycHPDFUSi%*Y2cftffB%eK_U?n_- ztVIM}i%L{H-QVU2Rn5=BJo4zc+pBL55K0X0A*sE!VE42%QDR1CyK^YlxIMj?^ z=<}{7M}*NS$BL3#E4F!^_4akK##iQm6z#*s@~3ktkB9hC1Dn&>;jVJ98!}l%w^G~C zQix=7VK?++%^R8IB2z;BtiZp7l9+F}`$9H-NsurqBdUFcHwE@qIU=SVhO`7UTjcW?%sUV~>UQ{WM<^&R2 z>i+G#!7KRcLW@K!CHoNHeWW?=bY5*CR6LEHL%(*4REG#&lcDifF172E`_$)w8bM>s z;5k1EVn3)4y^y&Y{f&SBTfTV9y9Ri;LWz_Zql&kcZvhP0a7*+%vXw4LxIBmm{F4jq z3b@b^VTK9&vA|xP^Z-AgG~K`pH;@R=Nvo=Ky8^ChB3X5Yo6| zEI8sRtFt#IqV6mqPvmA2aX1P^f4>ebxhcn3>I0mOXFq