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サーバーには4つのテーブル（table ）があり、それぞれに一意のaddress フィールドがあります。このフィールドを使用して、目的のフィールドからdata を読み取ります。各テーブルの詳細については、QModbusDataUnit::RegisterType を参照してください。addressがマップ範囲外である場合、またはレジスタタイプが定義されていない場合は、false を返します。

QModbusDataUnit::RegisterType およびsetData()も参照してください 。

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

この信号は、ModbusクライアントがModbusサーバーに1つ以上のデータフィールドを書き込んだ際に発信されます。この信号には、書き込まれたフィールドに関する情報が含まれています：

• 書き込まれたレジスタタイプ（table ）、
• address 書き込まれた最初のフィールドのxml-ph-0000@deepl.internal、
• および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 Application Protocol Specification 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サーバーには4つのテーブル（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)

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()も参照してください 。