Plugin/Source/ThirdParty/include/SenseGlove/Connect/Connection.hpp

/**
 * @file
 *
 * @author  Max Lammers <max@senseglove.com>
 * @author  Mamadou Babaei <mamadou@senseglove.com>
 *
 * @section LICENSE
 *
 * Copyright (c) 2020 - 2023 SenseGlove
 *
 * @section DESCRIPTION
 *
 * An abstract parent class for communication lines with Sense Glove Devices.
 * We use this to allow us to add more forms of communication to the
 * Sense Glove later on.
 */


#pragma once

#include <memory>
#include <string>

#include "ExitCodes.hpp"
#include "Platform.hpp"
#include "PortInfo.hpp" /* Do not forward declare this, or else we'll encounter LINK2019 build error on MSVC */

namespace SGConnect
{
    /// <summary> Testing State of connection </summary>
    enum class EConnectionTestingState : uint8_t
    {
        /* Connection needs testing. */
        NeedsTesting = 0,

        /* Connection is testing. */
        Testing,

        /* The connection test is completed. */
        TestingCompleted,
    };

    class Connection;
}// namespace SGConnect

///<summary> Parent class for any connection with which our Sense Glove can exchange data. </summary>
class SGConnect::Connection
{
public:
    /* Communication Constants */

    ///<summary> Indicates a new command </summary>
    static char GetCmdOpen();

    ///<summary> Indicates the end of a command summary>
    static char GetCmdClose();

    ///<summary> Indicates a new sensor data packet </summary>
    static char GetSDataOpen();

    ///<summary> Indicates the end of a sensor data packet </summary>
    static char GetSDataClose();

    /// <summary>  </summary>
    static char GetResetByte();

    /// <summary>  / </summary>
    static char GetIdleByte();

    ///<summary> Command to request ID from a device </summary>
    static const std::string& GetIdRequest();

    ///<summary> Command to request device-specific constants </summary>
    static const std::string& GetConstRequest();

    ///<summary> Command to start sensor steaming (Legacy Mode) </summary>
    static const std::string& GetStartSensors();

    ///<summary> Command to end sensor steaming (Legacy Mode) </summary>
    static const std::string& GetEndSensors();

    ///<summary> Default command to request sensor data (Ping-Pong mode) </summary>
    static const std::string& GetPingCmd();

private:
    struct Impl;
    std::unique_ptr<Impl> Pimpl;

protected:
    Connection();
    explicit Connection(const PortInfo& intendedPort);

public:
    /**
     * The copy constructor.
     */
    Connection(const Connection& rhs);

    /**
     * The move constructor.
     */
    Connection(Connection&& rhs) noexcept;

public:
    virtual ~Connection();

public:
    /**
     * The copy assignment operator.
     */
    Connection& operator=(const Connection& rhs);

    /**
     * The move assignment operator.
     */
    Connection& operator=(Connection&& rhs) noexcept;

public:
    /* Connections / Disconnections */

    ///<summary> Returns true if this connection is active and can send/receive data. </summary>
    virtual bool IsConnected() = 0;

    ///<summary> Connect this instance to a specific port. </summary>
    virtual int32_t Connect(bool bWithReadThread) = 0;

    ///<summary> Disconnect this port from its connection and unmanaged resources. </summary>
    virtual int32_t Disconnect(EExitCode exitCode) = 0;

    /// <summary>  </summary>
    /// <returns></returns>
    SG_NODISCARD virtual const PortInfo& GetPortInfo() const;

    /// <summary> Return communications address </summary>
    /// <returns></returns>
    SG_NODISCARD virtual const std::string& GetAddress() const;

    /* I/O */

    ///<summary> Send a command string through this connection to the Device. </summary>
    virtual int32_t SendToDevice(const std::string& cmd, bool hapticCmd) = 0;

    ///<summary> Access the last received sensor data packet from this device. </summary>
    SG_NODISCARD virtual const std::string& GetLastData() const;

    ///<summary> Access the last received command from this device. </summary>
    SG_NODISCARD virtual const std::string& GetLastCmd() const;

    ///<summary> Access the last received sensor data packet from this device. </summary>
    virtual void ResetCmd();

    ///<summary> Access the last received command from this device. </summary>
    virtual void ResetData();

    SG_NODISCARD virtual int32_t GetPacketId() const;

    /* Packets Per Second */

    SG_NODISCARD int32_t GetPacketsReceived() const;
    void ResetPacketsReceived();

    SG_NODISCARD int32_t GetPacketsSent() const;
    void ResetPacketsSent();

    void ResetPackets();

    SG_NODISCARD bool IsLinked() const;
    void SetLinked(bool bLinked);

    SG_NODISCARD EConnectionTestingState GetTestingState() const;
    void SetTestingState(EConnectionTestingState testingState);

protected:
    void IncrementPacketsReceived();
    void IncrementPacketsSent();
    void IncrementSDataPacket();
    void ResetSDataPacket();

    PortInfo& GetIntendedPort();
};