API リファレンス

public T Read<T>(Prefix prefix, string address) where T : unmanaged;
public async Task<T> ReadAsync<T>(Prefix prefix, string address) where T : unmanaged;

short d0 = mcpx.Read<short>(Prefix.D, "0");
bool  m0 = await mcpx.ReadAsync<bool>(Prefix.M, "0");

public T[] BatchRead<T>(Prefix prefix, string address, ushort length) where T : unmanaged;
public async Task<T[]> BatchReadAsync<T>(Prefix prefix, string address, ushort length) where T : unmanaged;

bool[] mArr = mcpx.BatchRead<bool>(Prefix.M, "0", 7000);
int[]  dArr = await mcpx.BatchReadAsync<int>(Prefix.D, "1000", 500);

public void Write<T>(Prefix prefix, string address, T value) where T : unmanaged;
public async Task WriteAsync<T>(Prefix prefix, string address, T value) where T : unmanaged;

mcpx.Write<short>(Prefix.D, "0", 42);
await mcpx.WriteAsync<bool>(Prefix.M, "0", true);

public T[] BatchWrite<T>(Prefix prefix, string address, T[] values) where T : unmanaged;
public async Task<T[]> BatchWriteAsync<T>(Prefix prefix, string address, T[] values) where T : unmanaged;

mcpx.BatchWrite<short>(Prefix.D, "0", new short[] { 1, 2, 3 });

public void Read(Action<ReadBuilder> build);
public async Task ReadAsync(Action<ReadBuilder> build);

short[] block = [];
int     total = 0;
bool    m10   = false;

// 点数あり → 一括アクセス（BatchRead）
// 点数なし → ランダムアクセス（RandomRead）
mcpx.Read(b => b
    .Add<short>(Prefix.D, "400", 100, v => block = v)
    .Add<int>(Prefix.D,   "2000",     v => total = v)
    .Add<bool>(Prefix.M,  "10",       v => m10   = v));

public void Write(Action<WriteBuilder> build);
public async Task WriteAsync(Action<WriteBuilder> build);

// 配列 → 一括アクセス（BatchWrite）
// 単一の値 → ランダムアクセス（RandomWrite）
await mcpx.WriteAsync(b => b
    .Add<short>(Prefix.D, "500", new short[] { 1, 2, 3 })
    .Add<int>(Prefix.D,   "2000", 1234)
    .Add<bool>(Prefix.M,  "20",   true));

public void BlockRead(Action<BlockReadBuilder> build);
public async Task BlockReadAsync(Action<BlockReadBuilder> build);

short[] d100 = [];
int[]   d500 = [];
bool[]  m0   = [];

// 3 つの範囲を 1 回の交信（0406）で読み出し
mcpx.BlockRead(b => b
    .Add<short>(Prefix.D, "100", 10, v => d100 = v)
    .Add<int>(Prefix.D,   "500", 4,  v => d500 = v)
    .Add<bool>(Prefix.M,  "0",   32, v => m0   = v));

public void BlockWrite(Action<BlockWriteBuilder> build);
public async Task BlockWriteAsync(Action<BlockWriteBuilder> build);

// 3 つの範囲を 1 回の交信（1406）で書き込み。bool は 16 の倍数で指定
await mcpx.BlockWriteAsync(b => b
    .Add<short>(Prefix.D, "100", new short[] { 1, 2, 3 })
    .Add<int>(Prefix.D,   "500", new[] { 1000, 2000 })
    .Add<bool>(Prefix.M,  "0",   new bool[16]));

public void RandomRead(Action<RandomReadBuilder> build);
public async Task RandomReadAsync(Action<RandomReadBuilder> build);

short d0 = 0;
bool  m0 = false;
float d100 = 0;

mcpx.RandomRead(b => b
    .Add<short>(Prefix.D, "0",   v => d0   = v)
    .Add<bool>(Prefix.M,  "0",   v => m0   = v)
    .Add<float>(Prefix.D, "100", v => d100 = v));

public void RandomWrite(Action<RandomWriteBuilder> build);
public async Task RandomWriteAsync(Action<RandomWriteBuilder> build);

mcpx.RandomWrite(b => b
    .Add<short>(Prefix.D, "0",   123)
    .Add<bool>(Prefix.M,  "0",   true)
    .Add<uint>(Prefix.D,  "100", 456));

public MonitorSession MonitorRegist(Action<MonitorBuilder> build);
public async Task<MonitorSession> MonitorRegistAsync(Action<MonitorBuilder> build);

short d0 = 0;
bool  m0 = false;

// 登録は一度だけ（0801）
var session = mcpx.MonitorRegist(b => b
    .Add<short>(Prefix.D, "0", v => d0 = v)
    .Add<bool>(Prefix.M,  "0", v => m0 = v));

// あとは何度でも読み出し（0802）
session.Read();
session.Read();

public void RemoteRun(bool force = false, RemoteRunClearMode clearMode = RemoteRunClearMode.None);
public Task RemoteRunAsync(bool force = false, RemoteRunClearMode clearMode = RemoteRunClearMode.None);

mcpx.RemoteRun();

// 他の機器からの STOP 中でも実行し、ラッチ範囲外をクリアして RUN
await mcpx.RemoteRunAsync(force: true, clearMode: RemoteRunClearMode.OutsideLatch);

public void RemoteStop();
public Task RemoteStopAsync();

public void RemotePause(bool force = false);
public Task RemotePauseAsync(bool force = false);

mcpx.RemoteStop();
mcpx.RemotePause();

public void RemoteLatchClear();
public Task RemoteLatchClearAsync();

// ラッチクリアは STOP 状態で実行
mcpx.RemoteStop();
mcpx.RemoteLatchClear();

public void RemoteReset(int reconnectTimeoutMilliseconds = 30000);
public async Task RemoteResetAsync(int reconnectTimeoutMilliseconds = 30000);

mcpx.RemoteStop();
mcpx.RemoteReset();

// リセット後は自動で再接続するので、同じインスタンスで続けて通信できる
short d0 = mcpx.Read<short>(Prefix.D, "0");

public string ReadString(Prefix prefix, string address, ushort length);
public async Task<string> ReadStringAsync(Prefix prefix, string address, ushort length);

string label = mcpx.ReadString(Prefix.D, "100", 10);

public void WriteString(Prefix prefix, string address, string value);
public async Task WriteStringAsync(Prefix prefix, string address, string value);

mcpx.WriteString(Prefix.D, "100", "McpX");

public override void Dispose();