QModbusServer Class

멤버 함수 문서

[explicit] QModbusServer::QModbusServer(QObject *parent = nullptr)

지정된 parent 으로 모드버스 서버를 구축합니다.

bool QModbusServer::data(QModbusDataUnit *newData) const

newData 에 지정된 레지스터 범위의 값을 반환합니다.

newData 유효한 레지스터 유형, 시작 주소 및 valueCount를 제공해야 합니다. 반환된 newData 에는 주어진 범위와 연관된 레지스터 값이 포함됩니다.

newData 에 유효한 레지스터 유형이 포함되어 있지만 시작 주소가 음수인 경우 전체 레지스터 맵이 반환되고 적절한 크기의 newData 이 반환됩니다.

setData()도 참조하세요 .

bool QModbusServer::data(QModbusDataUnit::RegisterType table, quint16 address, quint16 *data) const

모드버스 서버에 저장된 데이터를 읽습니다. 모드버스 서버에는 4개의 테이블(table)이 있으며, 각 테이블에는 고유한 address 필드가 있어 원하는 필드에서 data 를 읽는 데 사용됩니다. 다른 테이블에 대한 자세한 내용은 QModbusDataUnit::RegisterType 을 참조하세요. 주소가 맵 범위를 벗어나거나 등록 유형이 정의되지 않은 경우 false 을 반환합니다.

QModbusDataUnit::RegisterType 및 setData()도 참조하세요 .

[signal] void QModbusServer::dataWritten(QModbusDataUnit::RegisterType table, int address, int size)

이 신호는 모드버스 클라이언트가 하나 이상의 데이터 필드를 모드버스 서버에 썼을 때 발생합니다. 이 신호에는 기록된 필드에 대한 정보가 포함됩니다:

• 기록된 레지스터 유형 (table),
• address 작성된 첫 번째 필드의
• 및 address 에서부터 연속적으로 기록된 필드의 size 입니다.

값의 변경이 없어 기록할 필드가 변경되지 않은 경우에는 신호가 발생하지 않습니다.

[virtual protected] QModbusResponse QModbusServer::processPrivateRequest(const QModbusPdu &request)

이 기능은 사용자 지정 모드버스 서버에서 구현해야 합니다. 주어진 request 이 표준 모드버스 요청이 아닌 경우 processRequest()에 의해 호출됩니다.

이 함수를 덮어쓰면 모드버스 애플리케이션 프로토콜 사양 1.1b에 지정되지 않은 추가 기능 코드 및 하위 기능 코드를 처리할 수 있습니다. 재구현 시 이 함수를 다시 호출하여 사용자 지정 모드버스 구현이 처리하지 않는 모든 알 수 없는 기능 코드에 대해 예외 응답이 반환되도록 해야 합니다.

이 기본 구현에서는 request 함수 코드 및 오류 코드가 잘못된 함수로 설정된 QModbusExceptionResponse 을 반환합니다.

processRequest()도 참조하세요 .

[virtual protected] QModbusResponse QModbusServer::processRequest(const QModbusPdu &request)

모드버스 클라이언트 request 를 처리하고 모드버스 응답을 반환합니다. 이 함수는 요청의 성격에 따라 QModbusResponse 또는 QModbusExceptionResponse 을 반환합니다.

이 함수의 기본 구현은 모드버스 애플리케이션 프로토콜 사양 1.1b에 정의된 모든 표준 모드버스 기능 코드를 처리합니다. 사양에 포함되지 않은 다른 모든 Modbus 기능 코드는 processPrivateRequest()로 전달됩니다.

이 함수를 다시 구현하여 표준 모드버스 기능 코드 요청의 기본 처리를 덮어쓸 수 있습니다. 재정의는 해당 요청 유형을 처리하고 적절한 QModbusResponse 을 반환해야 합니다. 일반적인 이유는 데이터 값에 대한 기능 코드 요청을 필터링하여 읽기/쓰기 액세스를 제한하고 이더넷의 직렬 회선 진단 또는 Modbus Plus 전송 계층과 같은 특정 구현에서 원하지 않는 기능 코드를 제한하기 위한 것일 수 있습니다. 다른 모든 요청 유형은 이 기본 구현으로 전달되어야 합니다.

processPrivateRequest()도 참조하세요 .

[virtual] bool QModbusServer::processesBroadcast() const

전송 계층이 브로드캐스트를 처리해야 하는 경우 서브클래스는 이 함수를 구현해야 합니다. 그러면 구현은 현재 처리된 요청이 브로드캐스트 요청인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환해야 합니다. 기본 구현은 항상 false 를 반환합니다.

[virtual protected] bool QModbusServer::readData(QModbusDataUnit *newData) const

newData 에 지정된 등록 범위의 값을 읽고 newData 에 데이터를 다시 씁니다. 성공하면 true 를 반환하고 newData 가 0 이거나 newData 범위가 맵 범위를 벗어나거나 registerType()이 존재하지 않는 경우 false 을 반환합니다.

setMap() 및 writeData()도 참조하세요 .

int QModbusServer::serverAddress() const

이 모드버스 서버 인스턴스의 주소를 반환합니다.

setServerAddress()도 참조하세요 .

bool QModbusServer::setData(const QModbusDataUnit &newData)

newData 을 모드버스 서버 맵에 씁니다. newData 범위가 맵 범위를 벗어난 경우 false 을 반환합니다.

호출이 성공하면 dataWritten() 신호가 전송됩니다. 주소가 지정된 레지스터가 변경되지 않은 경우에는 신호가 발생하지 않습니다. newData 에 이미 레지스터와 정확히 동일한 값이 포함되어 있을 때 발생할 수 있습니다. 그럼에도 불구하고 이 함수는 이러한 경우 true 을 반환합니다.

data()도 참조하세요 .

bool QModbusServer::setData(QModbusDataUnit::RegisterType table, quint16 address, quint16 data)

모드버스 서버에 데이터를 씁니다. 모드버스 서버에는 4개의 테이블(table)이 있으며 각 테이블에는 고유한 address 필드가 있어 원하는 필드에 data 을 쓰는 데 사용됩니다. 주소가 지도 범위를 벗어난 경우 false 을 반환합니다.

호출에 성공하면 dataWritten() 신호가 전송됩니다. data 주소가 변경되지 않은 경우에는 신호가 발생하지 않습니다. 그럼에도 불구하고 이 함수는 이러한 경우 true 을 반환합니다.

QModbusDataUnit::RegisterType, data() 및 dataWritten()도 참조하세요 .

[virtual] bool QModbusServer::setMap(const QModbusDataUnitMap &map)

다른 모드버스 클라이언트의 요청에 대해 등록된 맵 구조를 map 로 설정합니다. 등록 값은 0으로 초기화됩니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

연결하기 전에 이 함수를 호출하지 않으면 항목이 0인 기본 레지스터가 설정됩니다.

void QModbusServer::setServerAddress(int serverAddress)

이 모드버스 서버 인스턴스의 주소를 serverAddress 로 설정합니다.

serverAddress()도 참조하세요 .

[virtual] bool QModbusServer::setValue(int option, const QVariant &newValue)

option 에 대해 newValue 을 설정하고 성공하면 true, 그렇지 않으면 false 을 반환합니다.

value()도 참조하세요 .

[virtual] QVariant QModbusServer::value(int option) const

option 값을 반환하거나 옵션이 설정되지 않은 경우 유효하지 않은 QVariant 값을 반환합니다.

setValue()도 참조하세요 .

[virtual protected] bool QModbusServer::writeData(const QModbusDataUnit &newData)

newData 을 모드버스 서버 맵에 씁니다. 성공하면 true, newData 범위가 맵 범위를 벗어나거나 registerType()이 존재하지 않으면 false 을 반환합니다.

setMap(), readData() 및 dataWritten()도 참조하세요 .