/usr/include/libindi/indifocuserinterface.h is in libindi-dev 1.1.0-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | /*
Filter Interface
Copyright (C) 2011 Jasem Mutlaq (mutlaqja@ikarustech.com)
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef INDIFOCUSERINTERFACE_H
#define INDIFOCUSERINTERFACE_H
#include "indibase.h"
#include "indiapi.h"
/**
* \class INDI::FocuserInterface
\brief Provides interface to implement focuser functionality.
A focuser can be an independent device, or an embedded focuser within another device (e.g. Camera).
\e IMPORTANT: initFocuserProperties() must be called before any other function to initilize the focuser properties.
\e IMPORTANT: processFocuserNumber() and processFocuserSwitch() must be called in your driver's ISNewNumber() and ISNewSwitch functions recepectively.
\author Jasem Mutlaq
*/
class INDI::FocuserInterface
{
public:
enum FocusDirection { FOCUS_INWARD, FOCUS_OUTWARD };
/** \struct FocuserCapability
\brief Holds the capabilities of a focuser.
*/
typedef struct
{
/** Can the focuser move by absolute position? */
bool canAbsMove;
/** Can the focuser move by relative position? */
bool canRelMove;
/** Is it possible to abort focuser motion? */
bool canAbort;
/** Can the focuser move in different configurable speeds? */
bool variableSpeed;
} FocuserCapability;
/**
* @brief GetFocuserCapability returns the capability of the focuser
*/
FocuserCapability GetFocuserCapability() const { return capability;}
/**
* @brief SetFocuserCapability sets the focuser capabilities. All capabilities must be initialized.
* @param cap pointer to focuser capability struct.
*/
void SetFocuserCapability(FocuserCapability * cap);
protected:
FocuserInterface();
virtual ~FocuserInterface();
/** \brief Initilize focuser properties. It is recommended to call this function within initProperties() of your primary device
\param deviceName Name of the primary device
\param groupName Group or tab name to be used to define focuser properties.
*/
void initFocuserProperties(const char *deviceName, const char* groupName);
/** \brief Process focus number properties */
bool processFocuserNumber (const char *dev, const char *name, double values[], char *names[], int n);
/** \brief Process focus switch properties */
bool processFocuserSwitch (const char *dev, const char *name, ISState *states, char *names[], int n);
/**
* @brief SetFocuserSpeed Set Focuser speed
* @param speed focuser speed
* @return true if successful, false otherwise
*/
virtual bool SetFocuserSpeed(int speed);
/** \brief MoveFocuser the focuser in a particular direction with a specific speed for a finite duration.
\param dir Direction of focuser, either FOCUS_INWARD or FOCUS_OUTWARD.
\param speed Speed of focuser if supported by the focuser.
\param duration The timeout in milliseconds before the focus motion halts.
\return Return IPS_OK if motion is completed and focuser reached requested position. Return IPS_BUSY if focuser started motion to requested position and is in progress.
Return IPS_ALERT if there is an error.
*/
virtual IPState MoveFocuser(FocusDirection dir, int speed, uint16_t duration);
/** \brief MoveFocuser the focuser to an absolute position.
\param ticks The new position of the focuser.
\return Return IPS_OK if motion is completed and focuser reached requested position. Return IPS_BUSY if focuser started motion to requested position and is in progress.
Return IPS_ALERT if there is an error.
*/
virtual IPState MoveAbsFocuser(uint32_t ticks);
/** \brief MoveFocuser the focuser to an relative position.
\param dir Direction of focuser, either FOCUS_INWARD or FOCUS_OUTWARD.
\param ticks The relative ticks to move.
\return Return IPS_OK if motion is completed and focuser reached requested position. Return IPS_BUSY if focuser started motion to requested position and is in progress.
Return IPS_ALERT if there is an error.
*/
virtual IPState MoveRelFocuser(FocusDirection dir, uint32_t ticks);
/**
* @brief AbortFocuser all focus motion
* @return True if abort is successful, false otherwise.
*/
virtual bool AbortFocuser();
INumberVectorProperty FocusSpeedNP;
INumber FocusSpeedN[1];
ISwitchVectorProperty FocusMotionSP; // A Switch in the client interface to park the scope
ISwitch FocusMotionS[2];
INumberVectorProperty FocusTimerNP;
INumber FocusTimerN[1];
INumberVectorProperty FocusAbsPosNP;
INumber FocusAbsPosN[1];
INumberVectorProperty FocusRelPosNP;
INumber FocusRelPosN[1];
ISwitchVectorProperty AbortSP;
ISwitch AbortS[1];
FocuserCapability capability;
char focuserName[MAXINDIDEVICE];
double lastTimerValue;
};
#endif // INDIFOCUSERINTERFACE_H
|