ModbusAdapter.h
4.54 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/*****************************************************************************
* Copyright (c) 2022 Priva b.v.
*****************************************************************************/
#pragma once
#include "ConnectionConfig.h"
#include "IModbusAdapter.h"
#include "modbus.h"
// std
#include <memory>
#include <variant>
#include <vector>
/// @class The ModbusAdapter class represents a single modbus context. Each context will
/// result in an instance of this class. It is not intended to be
/// created directly but through a factory. The factory will create
/// the object and return the pointer to its interface.
class ModbusAdapter : public IModbusAdapter
{
public:
/*!
* Default constructor
*/
explicit ModbusAdapter();
/*!
* Default destructor
*/
virtual ~ModbusAdapter();
/*!
* Create a modbus connection, accepting a configuration object.
*/
bool ModbusConnect( const ConnectionConfig &config ) override;
/*!
* ModbusDisconnect
* Disconnect from the serial bus or the TCP connection, freeing its resources
*/
bool ModbusDisconnect() override;
/*!
* Read data from a modbus device given by its parameters.
* @param slaveId - The Id of the ModbusDevice.
* @param functionCode - The code describing the action we want to perform on the device.
* Given by an enum, provided by the modbus-stack.
* @param startAddress - Startaddres of the register we want to read.
* @param noOfItems - The number of items we expect back.
* @returns modbusData - A vector holding each register in an entry in the same order as they are received.
* Empty if no data was received.
*/
modbusData ModbusReadData( int slaveId, int functionCode, int startAddress, int noOfItems ) override;
/*!
* Read data from the holdregisters ( or keep-registers ) of a modbus device.
* @param slaveId - The Id of the ModbusDevice.
* @param startAddress - Startaddres of the register we want to read.
* @param noOfItems - The number of items we expect back.
* @returns modbusData - A vector holding each register in an entry in the same order as they are received.
* Empty if no data was received.
*/
modbusData ModbusReadHoldReg( int slaveId, int startAddress, int noOfItems ) override;
/*!
* Write data to the device.
* @param slaveId - The Id of the Modbus device
* @param funtionCode - The code describing the action we want to perform on the device
* given by an enum, provided by the modbus-stack.
* @param startAddress - Startaddres of the register we want to read.
* @param noOfItems - The number of items we expect to be written
* @param values - The values we want to write to the given device. Each vector-entry represents a single byte
* and they will be sent in sequence.
*/
void ModBusWriteData( int slaveId, int functionCode, int startAddress, int noOfItems, std::vector<int>values ) override;
/*!
* Indicates if this connection is alive.
* @returns True if alive, false if not.
*/
bool isConnected() const override;
/*!
* returns the translated error code coming from the modbus stack.
* @param errnum - error Number coming from the stack.
* @return The translated error as a string. Empty if not resolvable.
*/
std::string ErrorString( int errnum ) const override;
private: // Methods
bool ModbusConnectRTU( const std::string &serialport, int baud, char parity, int dataBits, int stopBits, int RTS, int timeOut );
bool ModbusConnectTCP( const std::string &ip, int port, int timeOut = -1 );
void InitBuffers();
void ClearBuffers();
private: // Members
ConnectionType connectionType { ConnectionType::CT_UNKNOWN }; ///> The type of connection this instance provides. Needed for administration
bool connected { false }; ///> Shows if the connection is still active.
modbus_t *modbus; ///> The actual low-level modbus instance as a raw-pointer. ( unique_pointer gives an error on this struct )
// Return value Buffers ( Room for improvement )
uint8_t *m_dest;
uint16_t *m_dest16;
};