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 を参照してください。アドレスがマップ範囲外であるか、レジスタ・タイプが定義されていない場合はfalse を返します。

QModbusDataUnit::RegisterType およびsetData()も参照のこと 。

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

このシグナルは、Modbusクライアントが1つ以上のフィールドのデータを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 サーバーには 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()も参照 。