DSRemoteConnect Library Documentation

Introduction

DSRemoteConnect is a C++ library that provides remote connectivity to Dewesoft measurement applications. It supports two connection types:

• DCOM: For local/remote Windows applications using Microsoft's Distributed Component Object Model
• NET: For network-based connections using TCP/IP protocols

Key Features

• Remote control of Dewesoft measurement sessions
• Real-time data acquisition from measurement channels
• Setup file loading and management
• Channel enumeration and property access
• Control channel writing capabilities
• Cross-platform support (Windows primary, with network support for other platforms)

Basic Usage

Basic Connection and Data Reading

#include "DSRemoteConnect.h"
 
int main() {
    DSXInstanceHandle instance;
    
    // Create instance for NET connection
    dsconCreateInstance(&instance, DSX_CONNECTION_TYPE_NET);
    
    // Connect to Dewesoft (localhost:8999:8001 = telnet_port:data_port)
    dsconConnect(instance, "localhost:8999:8001");
    
    // Load measurement setup
    dsconLoadSetup(instance, "C:\\path\\to\\setup.dxs");
    
    // Get channel count
    size_t channelCount;
    dsconGetChannelCount(instance, &channelCount);
    
    // Enumerate channels
    ChannelIdList channelList;
    dsconEnumerateChannels(instance, &channelList, &channelCount);
    
    // Create channel instance for first channel
    ChannelInstanceHandle channel;
    dsconCreateChannelInstance(instance, channelList[0], &channel);
    
    // Start measurement
    dsconStartMeasurement(instance);
    
    // Read data in loop
    double* data = new double[1000];
    double* timestamps = new double[1000];
    size_t dataCount = 1000;
    
    while (measurement_active) {
        if (dsconChannelReadScalarData_2(channel, data, timestamps, &dataCount) == DSX_NO_ERROR) {
            // Process data...
        }
    }
    
    // Cleanup
    dsconStopMeasurement(instance);
    dsconFreeChannelInstance(channel);
    dsconFreeEnumerateChannels(instance, &channelList);
    dsconDisconnect(instance);
    dsconDestroyInstance(instance);
    
    delete[] data;
    delete[] timestamps;
    
    return 0;
}

DCOM Connection Example

// For DCOM connections (local Dewesoft instance)
DSXInstanceHandle instance;
dsconCreateInstance(&instance, DSX_CONNECTION_TYPE_DCOM);
dsconConnect(instance, ""); // Empty string for local DCOM

Error Handling

All functions return DX_ERROR_CODE values. Always check return codes:

int result = dsconStartMeasurement(instance);
if (result != DSX_NO_ERROR) {
    printf("Failed to start measurement: error code %d\n", result);
    // Handle error...
}

Threading Considerations

• The library is not thread-safe by default
• Use proper synchronization when accessing from multiple threads
• Data reading functions can be called from different threads than control functions

Memory Management

• Always call dsconFreeChannelInstance() for created channel instances
• Always call dsconFreeEnumerateChannels() after dsconEnumerateChannels()
• Always call dsconDestroyInstance() for created instances
• Manage your own data buffers (arrays passed to read functions)