QModbusServer Class

멤버 함수 문서

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

지정된 parent 를 사용하여 Modbus 서버를 생성합니다.

bool QModbusServer::data(QModbusDataUnit *newData) const

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

newData 유효한 레지스터 유형, 시작 주소 및 valueCount를 반드시 지정해야 합니다. 반환된 newData 에는 지정된 범위에 해당하는 레지스터 값들이 포함됩니다.

newData 에 유효한 레지스터 유형이 포함되어 있지만 시작 주소가 음수인 경우, 전체 레지스터 맵이 반환되며 ` newData `의 크기는 이에 맞게 조정됩니다.

setData()도 참조하십시오 .

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

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

QModbusDataUnit::RegisterType 및 setData()함수도 참조하십시오 .

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

이 신호는 Modbus 클라이언트가 Modbus 서버에 하나 이상의 데이터 필드를 기록한 경우 전송됩니다. 이 신호에는 기록된 필드에 대한 정보가 포함되어 있습니다:

• 쓰여진 레지스터 유형(table),
• address 쓰여진 첫 번째 필드의 레지스터 번호,
• address 부터 시작하여 순차적으로 기록된 필드의 size.

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

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

이 함수는 사용자 정의 Modbus 서버에서 구현해야 합니다. 지정된 함수 코드( request )가 표준 Modbus 요청이 아닌 경우, ` processRequest()`에 의해 이 함수가 호출됩니다.

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

이 기본 구현은 request 함수 코드와 오류 코드를 '불법 함수'로 설정한 QModbusExceptionResponse 를 반환합니다.

processRequest()도 참조하십시오 .

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

Modbus 클라이언트 request 를 처리하고 Modbus 응답을 반환합니다. 이 함수는 요청의 유형에 따라 QModbusResponse 또는 QModbusExceptionResponse 를 반환합니다.

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

이 함수를 재구현하여 표준 Modbus 기능 코드 요청에 대한 기본 처리를 재정의할 수 있습니다. 재정의된 함수는 해당 요청 유형을 처리하고 적절한 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

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

setServerAddress()도 참조하십시오 .

bool QModbusServer::setData(const QModbusDataUnit &newData)

Modbus 서버 맵에 ` newData `를 기록합니다. ` newData ` 범위가 맵 범위를 벗어날 경우 ` false `를 반환합니다.

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

data()도 참조하십시오 .

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

Modbus 서버에 데이터를 기록합니다. Modbus 서버에는 네 개의 테이블(table)이 있으며, 각 테이블에는 고유한 address 필드가 있어, 이를 통해 data 를 원하는 필드에 기록할 수 있습니다. 주소가 맵 범위를 벗어날 경우 false 를 반환합니다.

호출이 성공하면 dataWritten() 신호가 발생합니다. data 가 변경되지 않은 경우에는 신호가 발생하지 않는다는 점에 유의하십시오. 그럼에도 불구하고 이 함수는 이러한 경우에도 true 를 반환합니다.

QModbusDataUnit::RegisterType, data(), dataWritten()도 참조하십시오 .

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

다른 ModBus 클라이언트로부터의 요청에 대해 등록된 맵 구조를 ` map`로 설정합니다. 레지스터 값은 0으로 초기화됩니다. 성공 시 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

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

void QModbusServer::setServerAddress(int serverAddress)

이 Modbus 서버 인스턴스의 주소를 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)

Modbus 서버 맵에 ` newData `를 기록합니다. 성공 시 ` true `를 반환하고, ` newData ` 범위가 맵 범위를 벗어났거나 `registerType()`이 존재하지 않는 경우 ` false `를 반환합니다.

setMap(), readData(), dataWritten()도 참조하십시오 .