snsopush/GrabBag
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
GrabBag/Module/ModbusTCPServer/README.md

207 lines
4.9 KiB
Markdown
Raw Permalink Normal View History

提交初始模块代码
2025-06-08 12:48:04 +08:00
# Modbus TCP <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>libmodbus<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Modbus TCP<43><50><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʵ<EFBFBD>֣<EFBFBD><D6A3>ṩ<EFBFBD><E1B9A9><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Modbus TCP<43><50><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ܺͻص<CDBB><D8B5><EFBFBD><EFBFBD>ơ<EFBFBD>
## <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- <20><><EFBFBD><EFBFBD>libmodbus<75><73><EFBFBD>ȶ<EFBFBD>ʵ<EFBFBD><CAB5>
- ֧<>ֶ<EFBFBD><D6B6>ͻ<EFBFBD><CDBB>˲<EFBFBD><CBB2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Modbus<75><73><EFBFBD><EFBFBD><EFBFBD><EFBFBD>֧<EFBFBD><D6A7>
- д<><D0B4><EFBFBD><EFBFBD><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD>ƣ<EFBFBD>֧<EFBFBD><D6A7>Ӧ<EFBFBD>ò<EFBFBD><C3B2><EFBFBD><EFBFBD><EFBFBD><EFBFBD>뷴<EFBFBD><EBB7B4>
- <20>̰߳<DFB3>ȫ<EFBFBD><C8AB><EFBFBD><EFBFBD><EFBFBD>ݷ<EFBFBD><DDB7>ʺ͸<CABA><CDB8>½ӿ<C2BD>
- <20><>ƽ̨֧<CCA8>֣<EFBFBD>Windows/Linux<75><78>
## ֧<>ֵ<EFBFBD>Modbus<75><73><EFBFBD><EFBFBD>
### <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Զ<EFBFBD><D4B6><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- <20><>ȡ<EFBFBD><C8A1>Ȧ<EFBFBD><C8A6>0x01<30><31>
- <20><>ȡ<EFBFBD><C8A1>ɢ<EFBFBD><C9A2><EFBFBD>루0x02<30><32>
- <20><>ȡ<EFBFBD><C8A1><EFBFBD>ּĴ<D6BC><C4B4><EFBFBD><EFBFBD><EFBFBD>0x03<30><33>
- <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>0x04<30><34>
### д<><D0B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>֧<EFBFBD>ֻص<D6BB><D8B5><EFBFBD>
- д<><D0B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȧ<EFBFBD><C8A6>0x05<30><35>
- д<><D0B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ּĴ<D6BC><C4B4><EFBFBD><EFBFBD><EFBFBD>0x06<30><36>
- д<><D0B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȧ<EFBFBD><C8A6>0x0F<30><46>
- д<><D0B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ּĴ<D6BC><C4B4><EFBFBD><EFBFBD><EFBFBD>0x10<31><30>
## API<50>ӿ<EFBFBD>
### <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
```cpp
#include "ModbusTCPServer.h"
ModbusTCPServer server;
// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
if (server.start(502, 10)) {
// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɹ<EFBFBD>
}
// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
server.stop();
```
### <20><><EFBFBD><EFBFBD>д<EFBFBD><D0B4><EFBFBD><EFBFBD><EFBFBD>ص<EFBFBD>
```cpp
// <20><><EFBFBD><EFBFBD>д<EFBFBD><D0B4>Ȧ<EFBFBD>ص<EFBFBD>
server.setWriteCoilsCallback([](uint8_t unitId, uint16_t address, uint16_t quantity, const uint8_t* values) -> ModbusTCPServer::ErrorCode {
// <20><><EFBFBD><EFBFBD>д<EFBFBD><D0B4>Ȧ<EFBFBD><C8A6><EFBFBD><EFBFBD>
// unitId: <20><>ԪID
// address: <20><>ʼ<EFBFBD><CABC>ַ
// quantity: <20><><EFBFBD><EFBFBD>
// values: д<><D0B4><EFBFBD><EFBFBD>ֵ
// <20><><EFBFBD>ش<EFBFBD><D8B4><EFBFBD><EFBFBD><EFBFBD>
return ModbusTCPServer::ErrorCode::SUCCESS;
});
// <20><><EFBFBD><EFBFBD>д<EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD>ص<EFBFBD>
server.setWriteRegistersCallback([](uint8_t unitId, uint16_t address, uint16_t quantity, const uint16_t* values) -> ModbusTCPServer::ErrorCode {
// <20><><EFBFBD><EFBFBD>д<EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><D6B7>Χ<EFBFBD><CEA7>Ȩ<EFBFBD>޵<EFBFBD>
if (address >= 1000 && address < 2000) {
// <20><><EFBFBD><EFBFBD>д<EFBFBD><D0B4>
return ModbusTCPServer::ErrorCode::SUCCESS;
} else {
// <20>ܾ<EFBFBD>д<EFBFBD><D0B4> - <20>Ƿ<EFBFBD><C7B7><EFBFBD>ַ
return ModbusTCPServer::ErrorCode::ILLEGAL_DATA_ADDRESS;
}
});
```
### <20><><EFBFBD>ݸ<EFBFBD><DDB8>½ӿ<C2BD>
```cpp
// <20><><EFBFBD>µ<EFBFBD><C2B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
server.updateCoil(0, true);
server.updateHoldingRegister(100, 1234);
server.updateDiscreteInput(50, false);
server.updateInputRegister(200, 5678);
// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
std::vector<bool> coils = {true, false, true, false};
server.updateCoils(0, coils);
std::vector<uint16_t> registers = {1000, 2000, 3000};
server.updateHoldingRegisters(100, registers);
```
## <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>֧<EFBFBD>ֱ<EFBFBD>׼<EFBFBD><EFBFBD>Modbus<EFBFBD>쳣<EFBFBD><EFBFBD><EFBFBD>룺
```cpp
enum class ErrorCode {
SUCCESS = 0, // <20>ɹ<EFBFBD>
ILLEGAL_FUNCTION = 1, // <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
ILLEGAL_DATA_ADDRESS = 2, // <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD>ݵ<EFBFBD>ַ
ILLEGAL_DATA_VALUE = 3, // <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>ֵ
SERVER_FAILURE = 4, // <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
ACKNOWLEDGE = 5, // ȷ<><C8B7>
SERVER_BUSY = 6, // <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>æ
NEGATIVE_ACKNOWLEDGE = 7, // <20><><EFBFBD><EFBFBD>ȷ<EFBFBD><C8B7>
MEMORY_PARITY = 8, // <20>ڴ<EFBFBD><DAB4><EFBFBD>żУ<C5BC><D0A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
GATEWAY_PATH_UNAVAILABLE = 10, // <20><><EFBFBD><EFBFBD>·<EFBFBD><C2B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
GATEWAY_TARGET_FAILED = 11 // <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD>豸<EFBFBD><E8B1B8>Ӧʧ<D3A6><CAA7>
};
```
## <20><><EFBFBD><EFBFBD>ʹ<EFBFBD><CAB9>ʾ<EFBFBD><CABE>
```cpp
#include "ModbusTCPServer.h"
#include <iostream>
#include <thread>
#include <chrono>
int main() {
ModbusTCPServer server;
// <20><><EFBFBD><EFBFBD>д<EFBFBD><D0B4><EFBFBD><EFBFBD><EFBFBD>ص<EFBFBD>
server.setWriteCoilsCallback([](uint8_t unitId, uint16_t address, uint16_t quantity, const uint8_t* values) {
std::cout << "д<><D0B4>Ȧ<EFBFBD><C8A6><EFBFBD><EFBFBD> - <20><>ԪID: " << (int)unitId
<< ", <20><>ַ: " << address
<< ", <20><><EFBFBD><EFBFBD>: " << quantity << std::endl;
return ModbusTCPServer::ErrorCode::SUCCESS;
});
server.setWriteRegistersCallback([](uint8_t unitId, uint16_t address, uint16_t quantity, const uint16_t* values) {
std::cout << "д<>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> - <20><>ԪID: " << (int)unitId
<< ", <20><>ַ: " << address
<< ", <20><><EFBFBD><EFBFBD>: " << quantity << std::endl;
// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><D6B7>Χ
if (address < 1000) {
return ModbusTCPServer::ErrorCode::ILLEGAL_DATA_ADDRESS;
}
return ModbusTCPServer::ErrorCode::SUCCESS;
});
// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
if (!server.start(502, 10)) {
std::cerr << "<22><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʧ<EFBFBD><CAA7>: " << server.getLastError() << std::endl;
return -1;
}
std::cout << "Modbus TCP<43><50><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>˿<EFBFBD>: 502" << std::endl;
// <20><><EFBFBD>ڸ<EFBFBD><DAB8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
for (int i = 0; i < 100; ++i) {
server.updateHoldingRegister(1000, i);
server.updateCoil(0, i % 2 == 0);
std::this_thread::sleep_for(std::chrono::seconds(1));
}
// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
server.stop();
std::cout << "<22><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ֹͣ" << std::endl;
return 0;
}
```
## <20><><EFBFBD><EFBFBD>˵<EFBFBD><CBB5>
### <20><><EFBFBD><EFBFBD>
- Qt 5.x <20><><EFBFBD><EFBFBD><EFBFBD>߰汾
- C++17 <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- libmodbusԴ<73>루<EFBFBD>Ѱ<EFBFBD><D1B0><EFBFBD><EFBFBD><EFBFBD>VrNetsģ<73><C4A3><EFBFBD>У<EFBFBD>
### <20><><EFBFBD><EFBFBD>
```bash
qmake ModbusTCPServer.pro
make
```
### ʹ<><CAB9>
<EFBFBD><EFBFBD>ģ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϊ<EFBFBD><EFBFBD>̬<EFBFBD>⣬<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD>а<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
```pro
LIBS += -L../Module/ModbusTCPServer -lModbusTCPServer
INCLUDEPATH += ../Module/ModbusTCPServer/Inc
```
## <20><><EFBFBD><EFBFBD>˵<EFBFBD><CBB5>
### <20><><EFBFBD>ͻ<EFBFBD><CDBB><EFBFBD>֧<EFBFBD><D6A7>
- ֧<><D6A7>ͬʱ<CDAC><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͻ<EFBFBD><CDBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- ʹ<><CAB9>select<63>¼<EFBFBD><C2BC><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD>̴߳<DFB3><CCB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>пͻ<D0BF><CDBB><EFBFBD>
- <20><>Ч<EFBFBD><D0A7><EFBFBD><EFBFBD>Դ<EFBFBD><D4B4><EFBFBD>ã<EFBFBD><C3A3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̹߳<DFB3><CCB9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- <20>̰߳<DFB3>ȫ<EFBFBD><C8AB><EFBFBD><EFBFBD><EFBFBD>ݷ<EFBFBD><DDB7><EFBFBD>
### <20><><EFBFBD>ݴ洢
- <20>ڲ<EFBFBD>ʹ<EFBFBD><CAB9>libmodbus<75><73>mapping<6E>ṹ<EFBFBD>洢<EFBFBD><E6B4A2><EFBFBD><EFBFBD>
- ֧<><D6A7>10000<30><30><EFBFBD><EFBFBD>Ȧ<EFBFBD><C8A6><EFBFBD><EFBFBD>ɢ<EFBFBD><C9A2><EFBFBD>롢<EFBFBD><EBA1A2><EFBFBD>ּĴ<D6BC><C4B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD>
- <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݲ<EFBFBD><DDB2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̰߳<DFB3>ȫ<EFBFBD><C8AB>
### <20>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD>
- д<><D0B4><EFBFBD><EFBFBD><EFBFBD>ᴥ<EFBFBD><E1B4A5><EFBFBD>û<EFBFBD><C3BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ļص<C4BB><D8B5><EFBFBD><EFBFBD><EFBFBD>
- <20>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Է<EFBFBD><D4B7>ش<EFBFBD><D8B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ܾ<EFBFBD>д<EFBFBD><D0B4><EFBFBD><EFBFBD>
- ֧<><D6A7><EFBFBD>첽<EFBFBD><ECB2BD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>֤
### <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- <20><><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>״̬<D7B4><CCAC><EFBFBD><EFBFBD>
- ֧<>ֱ<EFBFBD>׼Modbus<75>쳣<EFBFBD><ECB3A3><EFBFBD><EFBFBD>
- <20><>ϸ<EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>Ϣ<EFBFBD><CFA2>ȡ<EFBFBD>ӿ<EFBFBD>
Reference in New Issue Copy Permalink