mcprotocol-udp 0.1.0

MITSUBISHI MC-Protocol Frame3E UDP/IP communication library

MITSUBISHI MC-Protocol Frame3E UDP/IP communication library

三菱 シーケンサの通信プロトコル MCプロトコル を使ってPythonからデバイスの値を読み書きする

Install

pip install mcprotocol

Constructor

MCProtcol3E(host, port, timeout)

Functions

read(memAddres, size, unitOfBit)

Device Area Read
memAddress = X, Y, M, L, F, V, B, D, W, TS, TC, TN, SS, SC, SN, CS, CC, CN, SB, SW, S ,DX, DY, SM, SD
size = 読出し点数
unionOfBit = True ＝ ビット単位 / False = ワード単位
Return: bytes()

write(memAddres, data, bitSize)

Memory Area Write
memAddress = X, Y, M, L, F, V, B, D, W, TS, TC, TN, SS, SC, SN, CS, CC, CN, SB, SW, S ,DX, DY, SM, SD
data = bytes()
bitSize = ビット数（ビット単位で書込みするときのみ指定）
Return: responce

RandomRead(worddevice, dworddevice)

Memory Area Random Read ワード単位、ダブルワード単位の不連続デバイスの読出し
memAddress = X, Y, M, L, F, V, B, D, W, TN, SN, CN, SB, SW, S ,DX, DY, SM, SD
worddevice = ワード読出しアドレス（カンマ区切り）
dworddvice = ダブルワード読出しアドレス（カンマ区切り）
Return: bytes()

MonitorSet(worddevice, dworddevice)

Monitor registration モニタするデバイスを登録
memAddress = X, Y, M, L, F, V, B, D, W, TN, SN, CN, SB, SW, S ,DX, DY, SM, SD
worddevice = ワード読出しアドレス（カンマ区切り）
dworddvice = ダブルワード読出しアドレス（カンマ区切り）
Return: responce

MonitorGet()

Monitor 登録したデバイスの値を読み出す
memAddress = X, Y, M, L, F, V, B, D, W, TN, SN, CN, SB, SW, S ,DX, DY, SM, SD
worddevice = ワード読出しアドレス（カンマ区切り）
dworddvice = ダブルワード読出しアドレス（カンマ区切り）
Return: bytes()

toBin(data)

data = mcp.read('M0', 16, True)  
print(mcp.toBin(data))          # convert bin

unionOfBitをビット単位で指定して読み出した値を文字列に変換
(M0) 1000010011000010 (M15)

WordToBin(data)

data = mcp.read('D0', 1, False)
print(mcp.WordToBin(data))          # convert word to bin

unionOfBitをワード単位で指定して読み出した値を文字列に変換
(15ビット目) 0100001100100001 (0ビット目)

toInt16(data)

読み出した値をInt16型のlistに変換

toInt32(data)

読み出した値をInt32型のlistに変換

toInt64(data)

読み出した値をInt64型のlistに変換

toUInt16(data)

読み出した値をUInt16型のlistに変換

toUInt32(data)

読み出した値をUInt32型のlistに変換

toUInt64(data)

読み出した値をUInt64型のlistに変換

toFloat(data)

読み出した値を単精度浮動小数点型のlistに変換
Convert to Float data

toDouble(data)

読み出した値を倍精度浮動小数点型のlistに変換

toString(data)

読み出した値を文字列に変換

Example

from mcprotocol import MCProtcol3E
import struct

'''
# MCProtocolの送受信ログが必要な場合はコメントを外してください
import logging

logging.basicConfig(
    filename="mcp.log",
    level=logging.DEBUG,
    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s"
)
'''

try:
    # example
    # set IPAddress,Port
    mcp = MCProtcol3E('192.168.250.41', 4999)

    # bits
    #data = mcp.read('M8000', 8, True)
    data = mcp.read('M0', 16, True)
    print(data)
    print(mcp.toBin(data))          # convert bin
    rcv = mcp.write('M100', data, 8)
    print(rcv)

    data = mcp.read('D0', 1, False)
    print(mcp.WordToBin(data))          # convert word to bin

    # numeric
    data = struct.pack('hhh', 123, 456, 789)
    rcv = mcp.write('D20', data)
    print(rcv)
    # float
    data = struct.pack('f', 1.23)
    rcv = mcp.write('D10020', data)
    print(rcv)
    # bits
    data = [0x11, 0x11, 0x10]
    rcv = mcp.write('M8100', data, 5)

    # RandomRead
    rcv = mcp.RandomRead('D0,TN0,M100,X20', 'D1500,Y160,M1111')
    print(rcv)
    print(mcp.toInt16(rcv[:8]))
    print(mcp.toInt32(rcv[8:]))

    # Monitor
    rcv = mcp.MonitorSet('D50, D55', 'D60, D64')
    print(rcv)
    rcv = mcp.MonitorGet()
    print(mcp.toInt16(rcv[:4]))
    print(mcp.toInt32(rcv[4:]))

except Exception as e:
    print(e)
    

説明サイト

https://osdes.com/python/plccomm/mcprotocol.html

Qiita記事

https://qiita.com/OkitaSystemDesign/items/97b7d27c0d53668baafc