gemini_flatpanel.h

Go to the documentation of this file.

#pragma once
 
#include "defaultdevice.h"
#include "connectionplugins/connectionserial.h"
#include "indilightboxinterface.h"
#include "indidustcapinterface.h"
#include "gemini_flatpanel_adapters.h"
#include <memory>
 
#define GEMINI_DEVICE_ID 99
 
namespace Connection
{
class Serial;
}
 
// Forward declaration for the adapter
class GeminiFlatpanelAdapter;
 
class GeminiFlatpanel : public INDI::DefaultDevice, public INDI::LightBoxInterface, public INDI::DustCapInterface
{
    public:
        GeminiFlatpanel();
        virtual ~GeminiFlatpanel() = default;
        virtual const char *getDefaultName() override;
 
        void ISGetProperties(const char *deviceName) override;
        virtual bool ISNewSwitch(const char *dev, const char *name, ISState *states, char *names[], int n) override;
        virtual bool ISNewNumber(const char *dev, const char *name, double values[], char *names[], int n) override;
        virtual bool ISNewText(const char *dev, const char *name, char *texts[], char *names[], int n) override;
        virtual bool ISSnoopDevice(XMLEle *root) override;
 
    protected:
        bool initProperties() override;
        bool updateProperties() override;
        bool saveConfigItems(FILE *fp) override;
        void initStatusProperties();
        void initLimitsProperties();
 
        void TimerHit() override;
 
        // From LightBoxInterface
        bool SetLightBoxBrightness(uint16_t value) override;
        bool EnableLightBox(bool enable) override;
 
        // From DustCapInterface
        virtual IPState ParkCap() override;
        virtual IPState UnParkCap() override;
        virtual IPState AbortCap() override;
 
        // UI interactions
        void startConfiguration();
        void endConfiguration();
        bool validateOperation();
        bool validateCalibrationOperation(int direction);
        void onMove(int direction);
        void onSetPosition(int direction);
        void cleanupSwitch(INDI::PropertySwitch &currentSwitch, int switchIndex);
        void onBeepChange();
 
    private:
        // Serial connection
        bool Handshake();
        int PortFD{-1};
 
        Connection::Serial *serialConnection{nullptr};
 
        // Adapter for firmware-specific functionality
        std::unique_ptr<GeminiFlatpanelAdapter> adapter;
 
        // Note: Simulation state now managed by GeminiFlatpanelSimulationAdapter
 
        // Device revision
        int deviceRevision{-1};
        char commandTerminator{'\n'};
 
        // State variables
        int prevCoverStatus{-1};
        int prevLightStatus{-1};
        int prevMotorStatus{-1};
        int prevBrightness{-1};
        int configStatus{GEMINI_CONFIG_NOTREADY};
 
        // Devices that support a Low/High brightness mode (Rev2/Lite) no longer expose a
        // separate BRIGHTNESS_MODE switch. Instead, LightIntensityNP's range is doubled
        // (0-255 = Low, 256-511 = High) and SetLightBoxBrightness() decodes which half was
        // requested -- previewing the single-continuous-range behavior Gemini has said
        // they plan to move the firmware to (see indilib/indi#2487). Tracked purely
        // in-memory since the firmware exposes no way to read back the active mode.
        int brightnessMode{GEMINI_BRIGHTNESS_MODE_LOW};
 
        // State update methods
        bool updateCoverStatus(char coverStatus);
        bool updateLightStatus(char lightStatus);
        bool updateMotorStatus(char motorStatus);
        bool updateBrightness(int brightness);
        void updateConfigStatus();
 
        // Commands
        bool sendCommand(const char *command, char *response, int timeout = SERIAL_TIMEOUT_SEC);
        bool pingRevision1();
        bool pingRevision2();
        bool getFirmwareVersion(int *version);
        bool getConfigStatus();
        bool getBrightness(int *const brightness);
        bool setBrightness(int value);
        bool lightOn();
        bool lightOff();
        bool openCover();
        bool closeCover();
        bool getStatus(int *const coverStatus, int *const lightStatus, int *const motorStatus);
        bool move(uint16_t value, int direction);
        bool setClosePosition();
        bool setOpenPosition();
        bool setBeep(bool enable);
        bool setBrightnessMode(int mode);
        bool applyUnifiedBrightness(int unifiedValue, bool forceMode);
 
        // Helper functions
        bool extractIntValue(const char *response, int startPos, int *value);
        bool formatCommand(char commandLetter, char *commandString, int value = NO_VALUE);
 
        // Status properties
        enum
        {
            STATUS_COVER,
            STATUS_LIGHT,
            STATUS_MOTOR,
            STATUS_N
        };
        INDI::PropertyText StatusTP{STATUS_N};
        INDI::PropertyText ConfigurationTP{1};
        INDI::PropertySwitch BeepSP{2};
 
        // Limit properties
        enum
        {
            MOVEMENT_LIMITS_45,
            MOVEMENT_LIMITS_10,
            MOVEMENT_LIMITS_01,
            MOVEMENT_LIMITS_N
        };
        INDI::PropertySwitch ClosedPositionSP{MOVEMENT_LIMITS_N};
        INDI::PropertySwitch SetClosedSP{1};
        INDI::PropertySwitch OpenPositionSP{MOVEMENT_LIMITS_N};
        INDI::PropertySwitch SetOpenSP{1};
        INDI::PropertySwitch ConfigureSP{1};
 
        // Device selection property
        enum
        {
            DEVICE_AUTO,
            DEVICE_REV1,
            DEVICE_REV2,
            DEVICE_LITE,
            DEVICE_PRO,
            DEVICE_N
        };
        INDI::PropertySwitch DeviceTypeSP{DEVICE_N};
};