samples/subsys/modbus/tcp_server/README.html · samples/subsys/modbus/tcp_server/README.rst 공식 원문 ↗

Zephyr 3.7.0 · Samples · Modbus · TCP Server

Modbus TCP 서버

Port 502의 Modbus TCP endpoint에서 coil과 holding register를 직접 제공합니다.

Official pathsamples/subsys/modbus/tcp_server/README.html
Source filesamples/subsys/modbus/tcp_server/README.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

FRDM-K64F TCP server build, PyModbus 연결과 coil/register operation을 설명합니다.

Transport

Ethernet TCP/IP

Endpoint

192.0.2.1:502

Data

Coils · Holding registers

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 10269C86B03C1A3AF52092040F58E66A6DE7A972CFD0A4BC96A47D491E8E2A91
.. zephyr:code-sample:: modbus-tcp-server
   :name: Modbus TCP server
   :relevant-api: modbus bsd_sockets

   Implement a Modbus TCP server exposing Modbus commands to control LEDs.

Overview
********

This is a simple application demonstrating a Modbus TCP server implementation
in Zephyr RTOS.

Requirements
************

This sample has been tested with FRDM-K64F board,
but it should work with any board or shield that has a network interface.
Additionally the board should have three LEDs.

TCP server example is running on an evaluation board. Client is running
on a PC or laptop.

The description of this sample uses `PyModbus`_ (Pymodbus REPL).
The user can of course try out other client implementations with this sample.

Building and Running
********************

This sample can be found under
:zephyr_file:`samples/subsys/modbus/tcp_server` in the Zephyr tree.

The following commands build and flash TCP server sample.

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/modbus/tcp_server
   :board: frdm_k64f
   :goals: build flash
   :compact:

On the client side, PC or laptop, the following command connects PyModbus
to the TCP server.

.. code-block:: console

   # pymodbus.console tcp --host 192.0.2.1 --port 502

The LEDs on the board are controlled by Modbus commands FC01, FC05, FC15.
For example, to set LED0 on use FC01 command (write_coil).

.. code-block:: console

   > client.connect
   > client.write_coil address=0 value=1 slave=1

Client should confirm successful communication and LED0 should light.

.. code-block:: console

   {
       "address": 0,
       "value": true
   }

To set LED0 off but LED1 and LED2 on use FC15 command (write_coils).

.. code-block:: console

   > client.write_coils address=0 values=0,1,1 slave=1

To read LED0, LED1, LED2 state FC05 command (read_coils) can be used.

.. code-block:: console

   > client.read_coils address=0 count=3 slave=1
   {
       "bits": [
           false,
           true,
           true,
           false,
           false,
           false,
           false,
           false
       ]
   }

It is also possible to write and read the holding registers.
This however does not involve any special interaction
with the peripherals on the board yet.

To write single holding registers use FC06 command (write_register),

.. code-block:: console

   > client.write_register address=0 value=42 slave=1

or FC16 command (write_registers).

.. code-block:: console

   > client.write_registers address=0 values=42,42,42 slave=1

To read holding registers use FC03 command (read_holding_registers).

.. code-block:: console

   > client.read_holding_registers address=0 count=3 slave=1
   {
       "registers": [
           42,
           42,
           42
       ]
   }

.. _`PyModbus`: https://github.com/pymodbus-dev/pymodbus

Part 3

한국어 전문 번역

개요

Zephyr RTOS의 Modbus TCP server 구현을 보여 주며, Modbus command로 board LED를 제어합니다. 별도 serial gateway 없이 이 board가 TCP endpoint에서 coil과 holding register를 직접 제공합니다.

요구 사항

이 sample은 FRDM-K64F에서 시험되었지만 network interface와 LED 세 개가 있는 board나 shield에서 동작할 수 있습니다. TCP server는 evaluation board에서, client는 PC나 laptop에서 실행합니다. 문서는 PyModbus REPL을 사용하지만 다른 client도 가능합니다.

빌드 및 실행

Sample은 samples/subsys/modbus/tcp_server에 있습니다. 다음 command로 FRDM-K64F TCP server를 build하고 flash합니다.

west build -b frdm_k64f samples/subsys/modbus/tcp_server
west flash

PC나 laptop에서 PyModbus TCP console을 server address 192.0.2.1의 port 502에 연결합니다.

# pymodbus.console tcp --host 192.0.2.1 --port 502

TCP server board의 LED는 문서에 기재된 FC01, FC05, FC15 관련 coil command로 제어합니다. 원문은 LED0을 켜는 동작을 FC01이라고 적지만 example은 write_coil을 사용합니다.

> client.connect
> client.write_coil address=0 value=1 slave=1

Client는 address 0과 boolean true를 응답하고 LED0이 켜집니다.

{
    "address": 0,
    "value": true
}

write_coils로 LED0은 끄고 LED1·LED2를 켭니다.

> client.write_coils address=0 values=0,1,1 slave=1

원문은 state read를 FC05라고 적지만 example은 read_coils로 세 coil을 읽습니다. 앞의 세 bit는 false, true, true입니다.

> client.read_coils address=0 count=3 slave=1
{
    "bits": [
        false,
        true,
        true,
        false,
        false,
        false,
        false,
        false
    ]
}

Holding register access는 아직 board peripheral과 특별히 연결되지 않습니다. write_register로 single register에 42를 씁니다.

> client.write_register address=0 value=42 slave=1

write_registers로 연속된 register 세 개에 42를 씁니다.

> client.write_registers address=0 values=42,42,42 slave=1

read_holding_registers로 같은 세 register를 읽으면 42, 42, 42가 반환됩니다.

> client.read_holding_registers address=0 count=3 slave=1
{
    "registers": [
        42,
        42,
        42
    ]
}

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.