ngscopeclient 0.1-dev+51fbda87c
SCPISocketTransport.h
Go to the documentation of this file.
1/***********************************************************************************************************************
2* *
3* libscopehal *
4* *
5* Copyright (c) 2012-2024 Andrew D. Zonenberg and contributors *
6* All rights reserved. *
7* *
8* Redistribution and use in source and binary forms, with or without modification, are permitted provided that the *
9* following conditions are met: *
10* *
11* * Redistributions of source code must retain the above copyright notice, this list of conditions, and the *
12* following disclaimer. *
13* *
14* * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the *
15* following disclaimer in the documentation and/or other materials provided with the distribution. *
16* *
17* * Neither the name of the author nor the names of any contributors may be used to endorse or promote products *
18* derived from this software without specific prior written permission. *
19* *
20* THIS SOFTWARE IS PROVIDED BY THE AUTHORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED *
21* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL *
22* THE AUTHORS BE HELD LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES *
23* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR *
24* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT *
25* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE *
26* POSSIBILITY OF SUCH DAMAGE. *
27* *
28***********************************************************************************************************************/
29
37#ifndef SCPISocketTransport_h
38#define SCPISocketTransport_h
39
40#include "../xptools/Socket.h"
41
48{
49public:
50 SCPISocketTransport(const std::string& args);
51 SCPISocketTransport(const std::string& hostname, unsigned short port);
52 virtual ~SCPISocketTransport();
53
54 virtual std::string GetConnectionString() override;
55 static std::string GetTransportName();
56
57 virtual void FlushRXBuffer(void) override;
58 virtual bool SendCommand(const std::string& cmd) override;
59 virtual std::string ReadReply(bool endOnSemicolon = true, std::function<void(float)> progress = nullptr) override;
60 virtual size_t ReadRawData(size_t len, unsigned char* buf, std::function<void(float)> progress = nullptr) override;
61 virtual void SendRawData(size_t len, const unsigned char* buf) override;
62
63 virtual bool IsCommandBatchingSupported() override;
64 virtual bool IsConnected() override;
65
66 TRANSPORT_INITPROC(SCPISocketTransport)
67
68
69 const std::string& GetHostname()
70 { return m_hostname; }
71
73 unsigned short GetPort()
74 { return m_port; }
75
82 void SetTimeouts(unsigned int txUs, unsigned int rxUs)
83 {
84 m_socket.SetTxTimeout(txUs);
85 m_socket.SetRxTimeout(rxUs);
86 }
87
88protected:
89
90 void SharedCtorInit();
91
94
96 std::string m_hostname;
97
99 unsigned short m_port;
100};
101
102#endif
Transport that moves SCPI data over a single TCP socket with no framing.
Definition: SCPISocketTransport.h:48
unsigned short GetPort()
Returns the port number of the connected instrument.
Definition: SCPISocketTransport.h:73
void SetTimeouts(unsigned int txUs, unsigned int rxUs)
Sets timeouts for the connection.
Definition: SCPISocketTransport.h:82
Socket m_socket
The socket for commands.
Definition: SCPISocketTransport.h:93
static std::string GetTransportName()
Returns the constant transport name "lan".
Definition: SCPISocketTransport.cpp:128
void SharedCtorInit()
Helper function that actually opens the socket connection.
Definition: SCPISocketTransport.cpp:87
const std::string & GetHostname()
Returns the hostname of the connected instrument.
Definition: SCPISocketTransport.h:69
unsigned short m_port
TCP port number of the instrument.
Definition: SCPISocketTransport.h:99
std::string m_hostname
IP or hostname of the instrument.
Definition: SCPISocketTransport.h:96
Abstraction of a transport layer for moving SCPI data between endpoints.
Definition: SCPITransport.h:47
Class representing a network socket.
Definition: Socket.h:63