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 dm0 = kcpx.Read<short>(Prefix.DM, "0");
float dm2 = kcpx.Read<float>(Prefix.DM, "2");

// MR1015 = チャンネル 10 のビット 15
bool mr = await kcpx.ReadAsync<bool>(Prefix.MR, "1015");

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;

// 3000 点を 1000 点ずつ 3 回の RDS に自動分割
bool[] mrArr = kcpx.BatchRead<bool>(Prefix.MR, "0", 3000);

// int（.L）は 1 コマンド 500 点まで → 2 回に分割
int[] dmArr = await kcpx.BatchReadAsync<int>(Prefix.DM, "1000", 1000);

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;

kcpx.Write<short>(Prefix.DM, "0", -1234);
kcpx.Write(Prefix.DM, "2", 3.14f);
await kcpx.WriteAsync(Prefix.MR, "0", true);

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

// DM0〜DM1 に 1234、DM2〜DM3 に 5678 を符号付き 32 ビットで書込み
kcpx.BatchWrite<int>(Prefix.DM, "0", [1234, 5678]);

var values = Enumerable.Range(0, 2000).Select(i => (ushort)i).ToArray();
await kcpx.BatchWriteAsync(Prefix.DM, "11000", values);

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

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

// 点数あり → 連続読出し（RDS）
// 点数なし → 単一読出し（RD）
kcpx.Read(b => b
    .Add<short>(Prefix.DM, "400", 100, v => block = v)
    .Add<int>(Prefix.DM,   "2000",     v => total = v)
    .Add<bool>(Prefix.MR,  "10",       v => mr10  = v));

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

// 配列 → 連続書込み（WRS）
// 単一の値 → 単一書込み（WR）
await kcpx.WriteAsync(b => b
    .Add<short>(Prefix.DM, "17100", [1, 2, 3])
    .Add(Prefix.DM,        "17110", 123456)
    .Add(Prefix.MR,        "50010", true));

public TimerCounterValue ReadTimerCounter(Prefix prefix, string address);
public async Task<TimerCounterValue> ReadTimerCounterAsync(Prefix prefix, string address);

public TimerCounterValue[] BatchReadTimerCounter(Prefix prefix, string address, ushort length);
public async Task<TimerCounterValue[]> BatchReadTimerCounterAsync(Prefix prefix, string address, ushort length);

TimerCounterValue t0 = kcpx.ReadTimerCounter(Prefix.T, "0");
Console.WriteLine($"{t0.Contact} {t0.Current} {t0.Set}");

TimerCounterValue[] cs = await kcpx.BatchReadTimerCounterAsync(Prefix.C, "0", 200);

// 現在値だけ・接点だけなら TC / TS / CC / CS や bool で読める
uint tc0 = kcpx.Read<uint>(Prefix.TC, "0");
bool t0Contact = kcpx.Read<bool>(Prefix.T, "0");

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

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

// T0 の設定値を 50 に変更（WS）
kcpx.WriteSetValue<uint>(Prefix.T, "0", 50);

await kcpx.BatchWriteSetValueAsync<uint>(Prefix.C, "0", [10, 20, 30]);

public void ForceSet(Prefix prefix, string address);
public async Task ForceSetAsync(Prefix prefix, string address);

public void ForceReset(Prefix prefix, string address);
public async Task ForceResetAsync(Prefix prefix, string address);

kcpx.ForceSet(Prefix.MR, "50001");
await kcpx.ForceResetAsync(Prefix.MR, "50001");

public void BatchForceSet(Prefix prefix, string address, ushort count);
public async Task BatchForceSetAsync(Prefix prefix, string address, ushort count);

public void BatchForceReset(Prefix prefix, string address, ushort count);
public async Task BatchForceResetAsync(Prefix prefix, string address, ushort count);

// 40 点 → 16 + 16 + 8 点の 3 回の STS / RSS に分割
kcpx.BatchForceSet(Prefix.MR, "0", 40);
await kcpx.BatchForceResetAsync(Prefix.MR, "0", 40);

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

short dm0  = 0;
bool  mr0  = false;

// 登録は一度だけ（MBS / MWS）
var session = kcpx.MonitorRegist(m => m
    .Add<short>(Prefix.DM, "0", v => dm0 = v)
    .Add<bool>(Prefix.MR,  "0", v => mr0 = v));

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

public OperatingMode ReadOperatingMode();
public async Task<OperatingMode> ReadOperatingModeAsync();

public void ChangeOperatingMode(OperatingMode mode);
public async Task ChangeOperatingModeAsync(OperatingMode mode);

kcpx.ChangeOperatingMode(OperatingMode.Run);

// RUN への移行には数十ミリ秒かかる場合があるので、必要なら確認して待つ
while (kcpx.ReadOperatingMode() != OperatingMode.Run)
{
    await Task.Delay(10);
}

public T[] ContinuousRead<T>(Prefix prefix, string address, ushort length) where T : unmanaged;
public void ContinuousWrite<T>(Prefix prefix, string address, T[] values) where T : unmanaged;
public TimerCounterValue[] ContinuousReadTimerCounter(Prefix prefix, string address, ushort length);
public void ContinuousWriteSetValue<T>(Prefix prefix, string address, T[] values) where T : unmanaged;
public void ContinuousForceSet(Prefix prefix, string address, byte count);
public void ContinuousForceReset(Prefix prefix, string address, byte count);
// + ～Async

// 1 回のコマンドで送信。上限を超えると ArgumentOutOfRangeException
ushort[] dm = kcpx.ContinuousRead<ushort>(Prefix.DM, "0", 1000);
kcpx.ContinuousForceSet(Prefix.R, "100", 16);

public virtual void Dispose();