Класс QModbusServer

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

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

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

Открытые функции

Сигналы

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

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

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

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

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

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

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

Параметры пользователя:

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

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

QModbusServer::QModbusServer(QObject *parent = nullptr)

Конструирует сервер Modbus со указанным parent.

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

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

• Тип регистра (table), который был записан,
• адрес address первого поля, которое было записано,
• и размер size последовательных полей, которые были записаны, начиная с address.

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

bool QModbusServer::data(QModbusDataUnit *newData) const

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

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

[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. Все остальные типы запросов должны передаваться в эту реализацию по умолчанию.

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

[virtual] bool QModbusServer::processesBroadcast() const

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

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

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

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

int QModbusServer::serverAddress() const

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

См. также 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 в противном случае.

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

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

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

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

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

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

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