AdsDevice.h

// SPDX-License-Identifier: MIT
#pragma once
 
#include "AdsException.h"
#include "AdsDef.h"
#include "wrap_endian.h"
#include <cstdint>
#include <functional>
#include <memory>
 
static const size_t DEVICE_NAME_LENGTH = 16;
 
struct DeviceInfo {
    char name[DEVICE_NAME_LENGTH];
 
    AdsVersion version;
};
 
struct AdsDeviceState {
    ADSSTATE ads;
    ADSSTATE device;
};
 
template<class T>
struct ResourceDeleter {
    ResourceDeleter(const std::function<long(T)> func)
        : FreeResource(func)
    {}
 
    void operator()(T* resource) noexcept
    {
        FreeResource(*resource);
        delete resource;
    }
private:
    const std::function<long(T)> FreeResource;
};
template<typename T>
using AdsResource = std::unique_ptr<T, ResourceDeleter<T> >;
 
using AdsHandle = AdsResource<uint32_t>;
 
struct AdsDevice {
    AdsDevice(const std::string& ipV4, AmsNetId netId, uint16_t port);
 
    DeviceInfo GetDeviceInfo() const;
 
    AdsHandle GetHandle(uint32_t offset) const;
 
    AdsHandle GetHandle(const std::string& symbolName) const;
 
    AdsHandle GetHandle(uint32_t                     indexGroup,
                        uint32_t                     indexOffset,
                        const AdsNotificationAttrib& notificationAttributes,
                        PAdsNotificationFuncEx       callback,
                        uint32_t                     hUser) const;
 
    AdsHandle OpenFile(const std::string& filename, uint32_t flags) const;
 
    long GetLocalPort() const;
 
    AdsDeviceState GetState() const;
    void SetState(const ADSSTATE AdsState, const ADSSTATE DeviceState) const;
 
    uint32_t GetTimeout() const;
    void SetTimeout(const uint32_t timeout) const;
 
    long ReadReqEx2(uint32_t group, uint32_t offset, size_t length, void* buffer, uint32_t* bytesRead) const;
    long ReadWriteReqEx2(uint32_t    indexGroup,
                         uint32_t    indexOffset,
                         size_t      readLength,
                         void*       readData,
                         size_t    writeLength,
                         const void* writeData,
                         uint32_t*   bytesRead) const;
    long WriteReqEx(uint32_t group, uint32_t offset, size_t length, const void* buffer) const;
 
    AdsResource<const AmsNetId> m_NetId;
    const AmsAddr m_Addr;
private:
    AdsResource<const long> m_LocalPort;
    long CloseFile(uint32_t handle) const;
    long DeleteNotificationHandle(uint32_t handle) const;
    long DeleteSymbolHandle(uint32_t handle) const;
};