go-mcprotocol - GitLite

KO | EN

gitlite — search

#ai #llm #go #golang #rust #deep-learning #macos #windows #awesome #kubernetes #vue #security #mcp #open-source

go-mcprotocol

(★ 50)

MC Protocol(MELSEC Communication Protocol) client implementation for golang

File Explorer

Download Latest Version (.zip)

- - test.yml
- access_route.go
- client.go
- client_test.go
- code.go
- code_test.go
- response_parser.go
- response_parser_test.go
- station.go
- station_test.go
- mirror.go
.gitignore
go.mod
go.sum
LICENSE
README.md

# Installation Guide

1. Get the code

git clone https://github.com/future-architect/go-mcprotocol

Downloads the entire project code from GitHub to your computer.

cd go-mcprotocol

Moves into the project folder you just downloaded.

2. Go

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Go The Go compiler and toolchain.

go build ./...

Compiles the Go program into an executable.

go run .

Runs the Go program directly without a separate build step.

✅ If the build finishes without errors, it worked. If you used go run ., check the terminal output.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# go-mcprotocol

go-mcprotocol is a library for PLC (Programmable Logic Controller) access

## Project Status

**Work In Progress**

## Usage for Library

You can read plc register bellow codes.

```go
	client, _ := mcp.New3EClient(opts.Host, opts.Port, mcp.NewLocalStation())
	read, _ := client.Read("D", 100, 3)
	registerBinary, _ := mcp.NewParser().Do(read)

fmt.Println(string(registerBinary.Payload))
```

#### Health Check

```go
	if err := client.HealthCheck(); err != nil {
		log.Fatalf("failed health check for plc: %v", err)
	}
```

## Usage Tool

## Output file format

Format is CSV. Items are timestamp and Base64 encoded MC Protocol response.

```csv
2019-10-07T07:08:00.3623052Z,0AAA//8DAAwAAAAAAAAAAAAAAAAA
2019-10-07T07:08:00.8622182Z,0AAA//8DAAwAAAAAAAAAAAAAAAAA
2019-10-07T07:08:01.3616205Z,0AAA//8DAAwAAAAAAAAAAAAAAAAA
...
```

## Usage for tool

Collect the register valuesof PLC by MC Protocol(MELSEC Communication Protocol).
This tools is gather plc register data and dump local files.

### Examples

```bash
$ plcmirror -H <Your PLC Host> -P <Your PLC Port> --device D --offset 100 --num 10 --dir /var/log/plcmirror
```

### Options

```bash
> plcmirror -help
  Usage:
    plcmirror [OPTIONS]
  
  Application Options:
    /H, /host:      PLC hostname
    /P, /port:      Melsec communication protocol port number
    /D, /device:    Register name like D that is mirror target
    /O, /offset:    PLC register offset addr that is mirror target
    /N, /num:       number of device points
        /dir:       file output path (default: .)
    /I, /interval:  mirroring interval [milli sec] (default: 500)
  
  Help Options:
    /?              Show this help message
    /h, /help       Show this help message
```

# License
Apache 2