Класс QModbusServer

Класс QModbusServer — это интерфейс для получения и обработки запросов Modbus. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Функции публичного доступа

• 7 функций публичного доступа унаследовано от QModbusDevice
• 32 функций публичного доступа унаследовано от QObject

Сигналы

• 2 сигнала унаследовано от QModbusDevice
• 2 сигнала унаследовано от QObject

Защищённые функции

• 4 защищённых функции унаследовано от QModbusDevice
• 9 защищённых функций унаследовано от QObject

Дополнительные унаследованные члены

• 1 свойство унаследовано от QObject
• 1 общедоступный слот унаследован от QObject
• 11 статических общедоступных членов унаследовано от QObject

Подробное описание

Класс QModbusServer — это интерфейс для получения и обработки запросов Modbus.

В сетях Modbus может быть несколько серверов Modbus. К серверам Modbus обращаются/из них считывают данные клиенты Modbus, представленные классом QModbusClient. Класс QModbusServer взаимодействует с серверной частью Modbus, предоставляя удобный API для пользователей.

Документация типов членов

перечисление QModbusServer::Option

Каждый сервер Modbus имеет набор значений, каждое со своим вариантом.

Общие варианты (и связанные типы):

Варианты для пользователей:

Для пользовательских вариантов разработчик должен сам решить, какие типы использовать и убедиться, что компоненты используют правильные типы при доступе и установке значений.

Документация функций членов

QModbusServer::QModbusServer(QObject *parent = nullptr)

Создаёт сервер Modbus со указанным parent.

bool QModbusServer::data(QModbusDataUnit *newData) const

Возвращает значения в диапазоне регистров, заданном newData.

newData должен содержать допустимый тип регистра, начальный адрес и значениеCount. Возвращаемый 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 register, int address, int size)

Этот сигнал испускается, когда клиент Modbus записал одно или несколько полей данных в сервер Modbus. Сигнал содержит информацию о записанных полях:

• тип записанного регистра register,
• адрес первого записанного поля address,
• и размер последовательных записанных полей, начиная с address, size.

Сигнал не испускается, если записываемые поля не изменились из-за отсутствия изменения значения.

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

Эта функция должна быть реализована пользовательскими серверами Modbus. Она вызывается функцией processRequest(), если заданный request не является стандартным запросом Modbus.

Переопределение этой функции позволяет обрабатывать дополнительные коды функций и подкоды функций, не указанные в спецификации протокола Modbus Application Protocol 1.1b. Реализации должны повторно вызвать эту функцию, чтобы гарантировать, что для всех неизвестных кодов функций, которые пользовательская реализация Modbus не обрабатывает, возвращается ответ с ошибкой.

Эта реализация по умолчанию возвращает QModbusExceptionResponse с кодом функции request и кодом ошибки, установленным в нелегальную функцию.

См. также processRequest().

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

Обрабатывает запрос клиента Modbus request и возвращает ответ Modbus. Эта функция возвращает QModbusResponse или QModbusExceptionResponse в зависимости от природы запроса.

Реализация по умолчанию этой функции обрабатывает все стандартные коды функций Modbus, как определено в спецификации протокола Modbus Application Protocol 1.1b. Все другие коды функций Modbus, не включенные в спецификацию, передаются функции processPrivateRequest().

Стандартная обработка запросов с использованием стандартных кодов функций Modbus может быть переопределена путём переопределения этой функции. Переопределение должно обрабатывать тип запроса и возвращать соответствующий QModbusResponse. Общей причиной может быть фильтрация запросов кода функций для значений данных, чтобы ограничить чтение/запись и коды функций, не требуемые в конкретных реализациях, таких как диагностика последовательной линии в сетях Ethernet или транспортные слои Modbus Plus.

Примечание: Эта функция не должна переопределяться для предоставления пользовательской реализации для типов запросов Modbus, не соответствующих стандарту.

См. также processPrivateRequest().

[virtual] bool QModbusServer::processesBroadcast() const

Подклассы должны реализовать эту функцию, если транспортный слой должен обрабатывать широковещательные запросы. Реализация должна возвращать true , если текущий обрабатываемый запрос является широковещательным; в противном случае false. Реализация по умолчанию всегда возвращает false.

Примечание: Значение возвращаемое этой функцией имеет смысл только изнутри функций processRequest() или processPrivateRequest(), в противном случае она только сообщит, что последний обработанный запрос был широковещательным.

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

Читает значения в диапазоне регистров, заданном newData, и записывает данные обратно в newData. Возвращает true при успехе или false , если newData 0, диапазон newData выходит за пределы диапазона карты, или регистр типа registerType() не существует.

Примечание: Подклассы, реализующие чтение из другого хранилища, отличного от стандартного, также должны реализовать setMap() и writeData().

См. также setMap() и writeData().

int QModbusServer::serverAddress() const

Возвращает адрес этого экземпляра сервера Mobus.

См. также setServerAddress().

bool QModbusServer::setData(const QModbusDataUnit &newData)

Записывает newData в карту сервера Modbus. Возвращает false если диапазон newData выходит за пределы диапазона карты.

Если вызов был успешен, испускается сигнал 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. Значения регистров инициализируются нулём. Возвращает true при успехе; в противном случае false.

Если эта функция не вызвана перед подключением, настраивается по умолчанию регистр с нулевыми записями.

Примечание: Вызов этой функции отбрасывает любые значения регистров, которые были установлены ранее.

void QModbusServer::setServerAddress(int serverAddress)

Устанавливает адрес для этого экземпляра сервера Modbus в serverAddress.

См. также serverAddress().

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

Устанавливает newValue для option и возвращает true при успехе; false в противном случае.

Примечание: Если тип, связанный с опцией, quint8 или quint16 и тип newValue больше, данные будут усечены или преобразование не удастся.

См. также value().

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

Возвращает значение для option или недействительное значение QVariant, если параметр не задан.

См. также setValue().

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

Записывает newData в карту сервера Modbus. Возвращает true при успехе или false если диапазон newData выходит за пределы диапазона карты или registerType() не существует.

Примечание: Подклассы, реализующие запись в другой хранилище, помимо стандартного, также должны реализовывать setMap() и readData(). Сигнал dataWritten() также необходимо вызывать в реализации функций.

См. также setMap(), readData(), и dataWritten().