yudaikitamura/mcpx

Английский

** Веб-сайт и документация: mcpx.yktmr.jp** — обзор, ссылка на API и руководство по протоколу MC.

McpX - это библиотека для связи с ПЛК Mitsubishi Electric по протоколу MC. Он имеет простой и простой в использовании API, позволяющий общаться, не беспокоясь о деталях протокола MC. Он работает на различных платформах, включая Linux, Windows и macOS.

Обновление с 0.x? Смотрите руководство по миграции.

##Установка

.NET CLI

Менеджер пакетов (Visual Studio)

Пример использования

Каждый метод имеет асинхронную версию, которая принимает CancellationToken:

C# и Visual Basic доступны здесь.

Настройки подключения

Перейдите McpXOptions в McpX.Connect / McpX.ConnectAsync, чтобы соответствовать параметрам PLC.

Недвижимость | Описание | Дефолт [править править код] Host | IP-адрес или имя хоста PLC | (обязательно) | Port | Номер порта (1-65535) | (обязательно) | [6] — удаленный пароль. Разблокирован и заблокирован на Dispose / DisposeAsync | null IsAscii true для кода ASCII, false для двоичного кода | false IsUdp``true для UDP, false для TCPfalse [18][править править вики-текст].

日本語 | English

Website & documentation: mcpx.yktmr.jp — overview, API reference, and an MC protocol guide.

McpX is a library for communicating with Mitsubishi Electric PLCs using the MC protocol.
It features a simple and easy-to-use API, allowing you to communicate without worrying about MC protocol details.
It runs on various platforms, including Linux, Windows, and macOS.

Upgrading from 0.x? See the migration guide.

Installation

.NET CLI

dotnet add package McpX

Package Manager(Visual Studio)

PM> NuGet\Install-Package McpX

Example Usage

using McpXLib;
using McpXLib.Enums;

// Connect to the PLC (TCP / binary code / 3E frame / MELSEC-Q/L series by default)
using var mcpx = McpX.Connect("192.168.12.88", 10000);

// Read 7000 points starting from M0 (requests over the limit are split automatically)
bool[] mArr = mcpx.BatchRead(Prefix.M, "0", 7000);

// Read 7000 words starting from D1000
short[] dArr = mcpx.BatchRead(Prefix.D, "1000", 7000);

// Write 1234 to D0-D1 and 5678 to D2-D3 as signed 32-bit integers
mcpx.BatchWrite(Prefix.D, "0", [1234, 5678]);

// Read a range and single devices together (ranges: batch access, single: random access)
short[] block = [];
int total = 0;
mcpx.Read(b => b
    .Add(Prefix.D, "400", 100, v => block = v)
    .Add(Prefix.D, "2000", v => total = v));

Every method has an async version that takes a CancellationToken:

await using var mcpx = await McpX.ConnectAsync("192.168.12.88", 10000, cancellationToken);
short d0 = await mcpx.ReadAsync(Prefix.D, "0", cancellationToken);

C# and Visual Basic samples are available here.

Connection Settings