IEC 61850 MMSプロトコル

1. このウィンドウでは、論理ノードのSCL構造が表示され、構成内のナビゲーションが容易になります。また、データセットとレポートブロックも表示されます。略語は以下のとおりです。
   • IED - 構成で定義されたインテリジェント電子デバイス
   • AP - アクセスポイント
   • LD - 論理デバイス
   • LN - 論理ノード
   • DS - データセット
   • RP - レポートブロック
2. このウィンドウには、データセットとレポートブロックの詳細情報が表示されます。データセットに関する情報は、データセットを構成する要素で構成されます。レポートブロックに関する情報は、レポートされたデータセット、整合性期間、バッファリングオプション、トリガーオプション、その他のフィールドで構成されます。
3. 各論理ノードの詳細情報が表示されます。データオブジェクトとデータ属性に関する情報はここで表示および変更できます。
4. サービス応答項目を識別します。これらの値は、サーバーを識別する際にクライアントに返されます。
5. SCLファイルの相対パスまたは絶対パスがここに表示されます。SCLファイルへのパスが変更された場合は、ファイルを再度インポートしてサーバーパラメータを変更する代わりに、ここで変更できます。
6. 「構成を更新」チェックボックスは、構成が既にロードされている場合にのみ使用できます。このチェックボックスをオンにすると、既存の構成のバリエーション（つまり、いくつかの異なる信号を持つ構成）で、入力/出力の構成が同じ新しい.icdファイルをロードできるようになります。

• オブジェクト - データオブジェクトとデータ属性の名前
• タイプ - SCL ファイルで定義されたデータ オブジェクトのクラスとデータ属性のタイプ
• トリガー - データ属性のトリガーオプション。トリガーは、データ変更（dchg）、データ更新（dupd）、または品質変更（qchg）のいずれかで生成されます。トリガーオプションは、レポートが生成されるタイミングを定義します。
• 値 - データ属性の値
• 含める - 含めるが有効になっている場合、コンポーネント上に適切な信号端子が作成され、ユーザーはシミュレーション信号をMMSサーバーコンポーネントに接続できるようになります。
• 方向 - 信号端子の方向を指定します
• エイリアス - エイリアスが定義されていない場合、端末ラベルはLDname_LNname_DOname_DAnameというパターンに従って生成されます。エイリアスが定義されている場合、端末ラベルはエイリアスと同じになります。

• insMag > max - 範囲は高高、qは範囲外であり疑わしい
• max > instMag > hhLim - 範囲は高から高
• hhLim > instMag > hLim - 範囲は高い
• hLim > instMag > lLim - 範囲は正常です
• lLim > instMag > llLim - 範囲が低い
• llLim > instMag > min - 低-低の範囲
• min > instMag - 範囲は低低、qは範囲外であり疑わしい

• load_config(絶対ファイルパス)
  • 説明：
    • この関数は最初のステップとして使用できます。.icdファイルへの絶対パスを入力として受け取り、解析された設定を辞書形式で返します。
  • 入力:
    • absolute_file_path - .icd ファイルへの絶対ファイルパス。
  • 出力:
    • config - 特定の MMS サーバー コンポーネントに関するすべての必要な情報を保持する構成辞書。
• import_config(sch_model、item_handle)
  • 説明：
    • この関数は最初のステップとして使用できます。回路図モデルハンドルとMMSサーバーコンポーネントハンドルを入力として受け取り、必要な情報を抽出し、解析された構成を辞書形式で返します。
  • 入力:
    • sch_model - MMS サーバー コンポーネントを含む Typhoon HIL 回路図。
    • item_handle - MMS サーバー スケマティック コンポーネントのハンドル。
  • 出力:
    • config - 特定の MMS サーバー コンポーネントに関するすべての必要な情報を保持する構成辞書。
• set_leafs(config, ied, leafs_to_include, set_val_leafs, values, direction, aliases)
  • 説明：
    • この関数は、次のステップとして使用できます。設定辞書、IEDの名前、入力と出力のリーフのリスト、初期値を設定するリーフのリスト、初期値のリスト、方向のリスト、エイリアスのリストを入力として受け取り、設定辞書に適用します。入力パラメータの有効性に応じてブール値を返します。
  • 入力:
    • config - 特定の MMS サーバー コンポーネントに関するすべての必要な情報を保持する構成辞書。
    • ied - 使用される IED の名前を表す Python 文字列。
    • leafs_to_include - 含めるリーフ (文字列) のリスト。
    • set_val_leafs - 初期値を設定するリーフ (文字列) のリスト。
    • values - 設定する初期値のリスト。
    • Directions - 含まれるリーフの方向 (文字列) のリスト。
    • aliases - 含まれるリーフのエイリアス (文字列) のリスト。
  • 出力:
    • valid - 入力パラメータの有効性に依存するブール値。
• export_config(config, ファイル名=なし, ファイルパス=なし)
  • 説明：
    • この関数はステップ1とステップ2の間に使用できます。適用された.icdファイルから使用可能なリーフを決定するのに役立ちます。設定辞書を必須入力として、ファイル名とファイルパスを任意入力として受け取り、使用可能なリーフを記述した.jsonファイルをエクスポートします。
  • 入力:
    • config - MMS サーバー コンポーネントに関するすべての必要な情報を保持する構成辞書。
    • file_name - 作成するファイルの名前。None を指定した場合、出力ファイル名は .icd ファイル名と一致します。
    • file_path - 作成されるファイルへのパス。None のままにした場合、この関数を呼び出したスクリプトのファイルパスにファイルが作成されます。
  • 出力:
    • この関数は、選択可能なリーフの辞書リストを含む.jsonファイルを作成します。ユーザーがどのリーフを選択できるか分からない場合に役立ちます。
• write_leaf_props_to_mms(config、sch_model、item_handle)
  • 説明：
    • この関数は3番目のステップとして使用できます。MMSサーバーコンポーネントに変更された構成を適用するために使用されます。入力として、構成辞書、回路図モデルハンドル、およびMMSサーバーコンポーネントハンドルを受け取ります。
  • 入力:
    • config - MMS サーバー コンポーネントに関するすべての必要な情報を保持する構成辞書。
    • sch_model - MMS サーバー コンポーネントを含む Typhoon HIL 回路図。
    • item_handle - MMS サーバー スケマティック コンポーネントのハンドル。

    from typhoon.api.iec_61850.mms_utils import load_config, set_leafs, \
        import_config, write_leaf_props_to_mms, export_config
    from typhoon.api.schematic_editor import SchematicAPI, 
    
    # Hepling function to get terminal names
    def get_terminal_name(path):
        path_parts = path.split("$")

        terminal_name = path_parts[2]
        for part in path_parts[3:]:
            terminal_name += f"_{part}"

        return terminal_name    

    mdl = SchematicAPI()
    chosen_leaves = ["E1$P1$E1Test$LLN0$Mod$origin$orCat", "E1$P1$E1Test$LLN0$Mod$ctlNum", "E1$P1$E1Test$LLN0$Mod$stVal", "E1$P1$E1Test$LLN0$Mod$q"]
    alias_list = ["orCat", "ctlNum", "stVal", "dU"]
    dir_list = ["in", "in", "out", "out"]
    value_list = [15, 155, "2 - blocked", "0000000000010"]    
    
    MODEL_NAME = "test_mms.tse"
    mdl.create_new_model(MODEL_NAME)
    mms_server = mdl.create_component("core/MMS Server", name="MMS Server1")
    
    # Load configuration from a .icd file to a dictionary
    mms_dict = load_config("C:/Program Files/Typhoon HIL Control Center 2025.1/examples/models/communication protocols/iec 61850 mms server/demo.icd")
    # Optional step to export a loaded configuration in order to understand the available leaves
    export_config(mms_dict)
    # Apply a new configuration to the configuration dictionary
    valid = set_leafs(mms_dict, "E1", chosen_leaves, chosen_leaves, value_list, dir_list, alias_list)

    if valid:
        # Apply modifications to the MMS Server component properties
        write_leaf_props_to_mms(mms_dict, mdl, mms_server)

        mdl.set_property_value(mdl.prop(mms_server, "server_ip"), "192.168.20.101")
        mdl.set_property_value(mdl.prop(mms_server, "server_netmask"), "255.255.255.0")
        mdl.set_property_value(mdl.prop(mms_server, "server_gateway_enable"), False)
        mdl.set_property_value(mdl.prop(mms_server, "server_gateway"), "")
        mdl.set_property_value(mdl.prop(mms_server, "vendor"), "Typhoon HIL MMS 1")
        mdl.set_property_value(mdl.prop(mms_server, "model_name"), "HIL 404")
        mdl.set_property_value(mdl.prop(mms_server, "revision"), "1.0")
        mdl.set_property_value(mdl.prop(mms_server, "execution_rate"), 0.0007)
        terminals = {}
        for leaf in chosen_leaves:
            terminals.update(
                {
                    leaf : get_terminal_name(leaf)
                }
            )
        
        # Create necessary scada inputs and probes
        scada_input1 = mdl.create_component(type_name="core/SCADA Input", name="scada_input1")
        scada_input2 = mdl.create_component(type_name="core/SCADA Input", name="scada_input2")
        probe1 = mdl.create_component(type_name="core/Probe", name="probe1")
        probe2 = mdl.create_component(type_name="core/Probe", name="probe2")
        
        # Connect inputs and outputs
        mdl.create_connection(mdl.term(scada_input1, "out"), mdl.term(mms_server1_test, terminals[
            chosen_leaves[0]]))
        mdl.create_connection(mdl.term(scada_input2, "out"),
                              mdl.term(mms_server1_test, terminals[chosen_leaves[1]]))

        mdl.create_connection(mdl.term(probe1, "in"),
                              mdl.term(mms_server1_test, terminals[chosen_leaves[2]]))
        mdl.create_connection(mdl.term(probe2, "in"),
                              mdl.term(mms_server1_test, terminals[chosen_leaves[3]]))

        mdl.save_as(MODEL_NAME)
        mdl.save()
        mdl.load(MODEL_NAME)
        mdl.compile()
        mdl.close_model()