API: 要求と完了の約束を決める
APIは、呼出側が要求する動作に名前を付けます。開始するWorkと完了結果を確認するWorkを定め、宣言した現場I/Oは呼出位置で結び付けます。
現行言語:ds2 v2;2026年11月17日改訂
サンプルは実I/Oを使わず、論理時間で動作します。最初にシステム境界とCallの順序を確認し、実機への接続は別途設定してください。
要求後の五つの異なる出来事をたどる
カフェでは抽出要求の送信、受理、抽出装置の起動、結果観測、呼出側の完了認定を分けます。Clamp.Lockも同じです。受理の記録は開始許可の検査を通ったことを示し、クランプ位置を測りません。観測契約と今回の実行でCall完了を判断します。
commandとobserveが別Workなら両識別子を表示します。命令Workが終わっても、APIは後続の観測対象を待つことがあります。出力解除も別の出来事で、パルスは先に終わり、latchは論理完了後も残り得ます。経路全体を単に「完了」とせず、出来事ごとに診断します。
開始ボタンが緑なら動作も完了ですか。
緑が送信、受理、実行、完了のどれを意味するか確認し、該当記録と観測を調べます。Lock後の加工Callには今回の有効な完了が必要です。画面の色はAPI結果や実機移動の証明を代替できません。
モデルが表す意味
commandは開始対象、observeは完了観測の対象です。短縮宣言では一つのWork、または開始から終端までの範囲を参照できます。APIはシステムに属し、それを使う個々のCallとは区別します。設備の動作定義を再利用し、呼出位置に宣言した現場アドレス、型、期待値を結び付けます。
出力と検出の方針
action normal [T] | 許可された実行中はON、正常FinishでOFFです。T付きでは正常Finish確定後、実時間Tだけ保持してからOFFにします。 |
|---|---|
action pulse [T] | 実行回ごとに一回だけ出力します。最初の有効出力確定から、Tなしなら一出力区間、TありならTです。パルス終了確認も完了条件で、センサーが先に成立しても完了を待ちます。 |
action latch | 承認された起動意図をFinish後も保持します。承認Reset、対向<|>動作、安全遮断で解除または阻止します。条件復旧だけでは再出力せず、当該実行・遮断世代の明示的な再開が必要です。 |
sensing normal [T] | 期待値一致を即時、または有効な一致サンプルがT連続した後に認めます。最初の一致サンプルの経過時間は0です。 |
sensing latch T | 現在実行での有効検出を記憶し、最後の生入力変化または有効性回復からT連続安定を要求します。現在の生値が期待値と異なっていても認定可能で、normalとは異なります。 |
sensing virtual [T] | 明示したモデル・開ループ遅延を使います。実運転の物理センサー確認証拠ではありません。検出成立だけではWork時間、必要Call完了、現在の許可条件を代替しません。 |
関係を読む
DS2 v2で記述する
以下の例は、一つの出力アドレスにtrueを要求し、一つの入力アドレスでtrueを期待するバインディングです。input比較は==、STガード式は=や<>を使います。例のアドレスは、実機接続前に確認済みの設備マッピングへ置き換える必要があります。
構文の断片: 完全なプロジェクトではありません
api Move = Motion.Forward;
// Caller work body:
Device.Move {
output bool at "%QX0.0" = true;
input bool at "%IX0.0" == true;
}API定義と呼出位置を区別する
ClampはLockをAPIとして宣言し、ControllerのProcessPartはClamp.Lockで使用します。定義は提供する動作と結果の観測方法を、Callは作業内の要求位置を定めます。制御側の図でも、CallがAPIを参照し、その公開境界の先に設備Workがある関係を示します。
API名と説明された動作を対応させます。Lockの名称や完了境界を変えたら、その呼出側も調べます。翻訳した表示名は画面を読むために使い、モデルのAPI識別子は意図した定義を参照し続けるようにします。
開始対象と完了観測対象を決める
単一WorkのAPIではcommandとobserveが同じWorkです。長い動作では、一つのWorkを開始し、後続の終端Workを観測できます。例えば制御側のAPIが処理の入口を開始し、出口で完了を確認する場合、入口Workだけが完了しても公開動作の完了にはなりません。
完了がどの実行に属するかも記録します。開始Workと観測Workが異なる場合、起動の記録と観測完了は特に別の事実です。観測名が同じという理由で、前の製品や別の呼出側の結果を現在のCallの完了に使いません。
論理要求を決めてからI/Oを結び付ける
まずLockがクランプを閉じる要求であり、何を固定の証拠とするか決めます。その後に呼出位置へ出力と入力を宣言し、制御チャネル、型、期待値、信号極性を一緒に点検します。出力アドレスだけでは書込先しか分からず、その値が固定を意味する理由も必要です。
設備インスタンスについて文書化したマッピングを使います。未定のアドレスやセンサーは、未確定の接続要件として残します。架空のタグで埋めたり、時間だけのモデルを実センサーループの試験として説明したりしません。
出力方針と検出方針を分けて読む
actionは受理された動作の出力方法、sensingは期待入力を有効な検出として認める方法です。出力をどれだけ保持するかと、観測をいつ認めるかは別の問いです。Work時間、必要な子の結果、現在の許可と合わせて読みます。センサー値の成立だけで、他の完了条件がなくなるわけではありません。
方針表はnormal、pulse、latch、virtualの違いを説明します。設備に必要な動作を先に決め、実行プロファイルの対応を確認します。対応する名前へ置き換えたまま別の動作を期待すると、モデルの意味が変わります。
繰返し呼出しと応答欠落を確認する
Lock Callの成功後、次の回で使える状態へどう戻るか確認します。宣言されたリセットや対向動作、完了受信をたどります。論理的な再準備とクランプを開く物理動作を区別し、実際に開く必要があれば、空の補助Workへ隠さず動作をモデル化して呼び出します。
遅れて来る応答と、来ない応答を検査します。呼出側はプロファイルの実際の待機、失敗、未対応結果を報告します。閉じたクランプの絵は、期待入力や当該Callの結果記録を代替しません。
要求から結果までの経路を確認する
Clamp.LockのAPI宣言、対象システムのインスタンス、command Work、observe Workをそれぞれ探します。バインディングがあれば確認し、呼出側を満たした実行結果まで示します。表示名が自然でも、実際の対象が違う場合をこの方法で見つけられます。
- commandの完了で必ずCallも完了しますか。そのAPIの観測と現在のCallの他の完了条件まで満たす場合だけです。
- 入力アドレスがあればセンサー試験を証明できますか。いいえ、実行記録で実サンプル、接続、試験プロファイルを確認する必要があります。
一つの命令値を送り、観測結果を判定する
要求ごとに注入量を測り、目標100 mLを受ける説明用ミルク装置を考えます。許容結果を境界を含む98〜102 mLと仮定します。これは説明用契約で、レシピや精度の主張ではありません。送信する100と観測する100は別データで、同じ信号チャネルである必要もありません。
単一値、許容値集合、連続範囲では受け入れる観測が異なります。接続前にスカラー型、単位、スケールも合わせます。未定・無効なデータを都合のよいゼロにしません。表は値条件だけの比較で、時間、有効性、実行所有の要件も別に適用します。
| 測定量 | 100と一致 | 集合{98, 100, 102} | 範囲[98, 102] |
|---|---|---|---|
| 97 mL | 不一致 | 不一致 | 不一致 |
| 98 mL | 不一致 | 一致 | 一致 |
| 99 mL | 不一致 | 不一致 | 一致 |
| 100 mL | 一致 | 一致 | 一致 |
| 103 mL | 不一致 | 不一致 | 不一致 |
センサーが既に期待値なら、新要求も完了ですか。
値だけでは判断しません。開始許可、今回の有効な結果、前回からの保持結果を区別します。勝手な新規エッジも要求せず、宣言契約に従います。測定識別、有効性、現在のCall記録で解釈を支えます。
受け側装置から出力時間を決める
装置は短いトリガー、維持する命令、論理完了後も残る起動を要求し得ます。実際の契約にactionを合わせます。正常完了でaction normalは駆動を終え、明示した延長はFinish後も残れます。pulseは実行ごとに一回で、終了確認も完了条件です。latchは許可された解除・遮断条件まで起動を保持します。
方針は受信チャネルの物理的意味を変えません。接続によってはfalseも有効な作動指令です。ON/OFFは起動意図であり、共通の電気極性ではありません。解除値と許可喪失時の動作を記録し、許可復帰だけで安全遮断した保持出力を再起動できると説明しません。
| 必要な動作 | 確認する方針 | 分けて見る出来事 |
|---|---|---|
| 正常完了まで駆動 | action normal | 入力の成立 |
| Finish後T保持 | action normal T | 完了後の延長終了 |
| 起動パルス一回 | action pulse [T] | パルス終了と結果観測 |
| 受理起動を保持 | action latch | 許可された解除と安全遮断 |
Finishなら出力も必ず解除済みですか。
actionと解除規則を読みます。延長やlatchは論理完了後も残れ、pulseは結果待ち中に先に終わることがあります。Work状態、出力意図、送信値、物理観測を別記録で比較し、相互に代用しません。
観測を完了根拠に認める方法を選ぶ
期待入力が一瞬現れてから変わる場合、sensing normal Tは最初の一致サンプルを0として有効な一致のT連続を求めます。sensing latch Tは今回の有効検出を記憶し、最後の生入力変化・有効性回復からの安定区間を確認します。同じ波形でも認定が異なり得ます。
予想動作時間、出力方針の時間、検出成立時間を分けます。モデル用virtual遅延は明示したセンサー代替で、実測ではありません。安定一致、短い一致、無効サンプル、二回目の要求を試し、実時刻と実行識別子を記録します。
| 問い | 方針 | 必要な根拠 |
|---|---|---|
| 現在の期待入力は有効か | sensing normal | 有効な一致観測 |
| 一致がT連続で有効か | sensing normal T | 連続した有効一致 |
| 検出記憶と安定条件を満たしたか | sensing latch T | 今回の検出と定義した安定 |
| モデル遅延による完了か | sensing virtual [T] | 明示した時間と仮想の表示 |
命令せずに同じ観測を読めますか。
observeに基づく条件は装置へ命令せず許可を検査できます。カップの有無確認と、配置動作を呼んで結果を待つことは別です。観測共有と出力所有の共有も区別し、読取経路と動作要求を明示します。
実行前の確認
各Callについて、設備インスタンス、開始Work、観測Work、今回の期待結果を確認します。実I/Oではアドレスの担当、型、極性も確認し、繰返し運転を示す前に再準備経路を点検します。
図は言語の契約を説明します。実機動作、PLC実行、設備安全の証明ではありません。モデル検査と実機試験の結果は別々に記録します。
言語文法と実行契約 · DS2-SPEC-V2.0
先頭へ戻る