Skip to content

Commit 623f08b

Browse files
committed
Tutorial content post review update
1 parent 80e7346 commit 623f08b

File tree

1 file changed

+22
-22
lines changed
  • content/hardware/07.opta/opta-family/opta/tutorials/opta-modbus-rtu-plc-ide

1 file changed

+22
-22
lines changed

content/hardware/07.opta/opta-family/opta/tutorials/opta-modbus-rtu-plc-ide/content.md

+22-22
Original file line numberDiff line numberDiff line change
@@ -27,39 +27,39 @@ In this tutorial, you will learn how to implement Modbus RTU-based communication
2727

2828
- Learn how to configure the workspace environment to work with Modbus RTU using Arduino PLC IDE.
2929
- Learn how to configure Modbus RTU for Opta™ using Arduino PLC IDE.
30-
- Learn how to verify that Opta™ has been correctly set up using a Modbus RTU communication example.
30+
- Learn to verify that Opta™ has been correctly set up using a Modbus RTU communication example.
3131

3232
## Required Hardware and Software
3333

3434
### Hardware Requirements
3535

3636
- [Opta™](https://store.arduino.cc/collections/pro-family) (x2)
3737
- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x2)
38-
- Wire with either specification for RS-485 connection (x3):
38+
- Cable with either specification for RS-485 connection (x3):
3939
- STP/UTP 24-18AWG (Unterminated) 100-130Ω rated
4040
- STP/UTP 22-16AWG (Terminated) 100-130Ω rated
4141

4242
### Software Requirements
4343

4444
- [Arduino PLC IDE Installer](https://www.arduino.cc/en/software#arduino-plc-ide)
45-
- If you have an Opta™, you do not need any license key to activate your product. Go to section [__License Activation With Pre-Licensed Products (Opta™)__](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license#7-license-activation-with-pre-licensed-products-opta) to know more.
45+
- If you have an Opta™, you do not need any license key to activate your product. Learn more about this in [License Activation With Pre-Licensed Products (Opta™)](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license#7-license-activation-with-pre-licensed-products-opta).
4646
- [Opta™ Modbus RTU PLC IDE Project Example File](assets/ModbusRTU_Opta_Example.zip)
4747

4848
## Modbus Protocol
4949

50-
Modbus is a client/server architecture-based serial communication protocol that is open and free of licensing restrictions. It is commonly employed in industrial electrical equipment, particularly in Building Management Systems (BMS) and Industrial Automation Systems (IAS).
50+
Modbus is an open, client/server architecture-based serial communication protocol free of licensing restrictions. It is commonly employed in industrial electrical equipment, particularly in Building Management Systems (BMS) and Industrial Automation Systems (IAS).
5151

52-
It was released by Modicon (now Schneider Electric) in 1979. It has since become the de facto industry standard for industrial electronic devices when communicating with PLCs.
52+
It was released by Modicon (now Schneider Electric) in 1979. Since then, it has become the de facto industry standard for industrial electronic devices communicating with PLCs.
5353

5454
In Supervisory Control and Data Acquisition (SCADA) systems, a Remote Terminal Unit (RTU) and a supervisory device are frequently connected via the Modbus communication protocol. Modbus messages have a straightforward 16-bit format and a Cyclic-Redundant Checksum (CRC) when communicating with electronic equipment.
5555

56-
***For more information regarding the Modbus RTU protocol implementation on an Opta™, it may interest you to check out ["Getting Started with Modbus RTU on Opta™"](https://docs.arduino.cc/tutorials/opta/getting-started-with-modbus-rtu) tutorial.***
56+
***For more information regarding the Modbus RTU protocol implementation on an Opta™, you may want to check out the [the "Getting Started with Modbus RTU on Opta™"](https://docs.arduino.cc/tutorials/opta/getting-started-with-modbus-rtu) tutorial.***
5757

5858
## Modbus RTU & PLC IDE
5959

60-
This tutorial will guide you through setting up two Opta™ devices with Modbus RTU using the Arduino PLC IDE. The present tutorial will help us understand the overall process of implementation.
60+
This tutorial will guide you through setting up two Opta™ devices with Modbus RTU using the Arduino PLC IDE and help us understand the overall implementation process.
6161

62-
The following diagram illustrates a concise visualization of how Opta™ is configured and deployed with Modbus RTU:
62+
The following diagram illustrates how Opta™ is configured and deployed with Modbus RTU:
6363

6464
![Modbus RTU Implementation with Arduino PLC IDE](assets/plcide_modbus_rtu_process.png)
6565

@@ -77,7 +77,7 @@ The entire procedure is divided into three distinct stages:
7777

7878
* __System Operation__ represents the anticipated outcome post the Modbus RTU configuration and the execution of the PLC program based on the developer's designed logic. Consequently, we can observe the device communicating with other devices through Modbus RTU.
7979

80-
The diagram presented shows the uniformity of the Modbus RTU setup across devices like Opta™ and Portenta Machine Control using the PLC IDE. One main advantage of this system is its adaptability. Regardless of the specifics of the Modbus RTU setup, the PLC program consistently performs effectively. Its design ensures that it can be used in many different environments.
80+
The diagram presented shows the uniformity of the Modbus RTU setup across devices like Opta™ and the Portenta Machine Control using the PLC IDE. One main advantage of this system is its adaptability. Regardless of the specifics of the Modbus RTU setup, the PLC program consistently performs effectively. Its design ensures that it can be used in many different environments.
8181

8282
In addition, when developing the PLC code, there is no limitation to a single language. The system adheres to the IEC61131-3 standard, allowing one to select from the languages outlined in this standard. It ensures a balance between user convenience and accurate code development.
8383

@@ -93,13 +93,13 @@ To get the Arduino PLC IDE software, go to the [official software website of the
9393

9494
The software requires **Windows 10** or a newer operating system version for the x64 architecture.
9595

96-
The Arduino PLC IDE installer contains the IDE and all the required drivers, libraries, and cores. The continuing sections will help you install the Arduino PLC IDE software properly.
96+
The Arduino PLC IDE installer contains the IDE and all the required drivers, libraries, and cores. The following sections will help you install the software properly.
9797

9898
***For more details regarding Arduino PLC IDE setup, please take a look at [Arduino PLC IDE Setup and Board's License Activation](https://docs.arduino.cc/tutorials/portenta-machine-control/plc-ide-setup-license) tutorial.***
9999

100100
### Hardware Setup
101101

102-
The two Opta™ devices will communicate using Modbus RTU. It is enabled by using the RS-485 interface for both devices. The following image shows the connection diagram to work with two Opta™ devices.
102+
The two Opta™ devices will communicate using Modbus RTU, which is enabled by using the RS-485 interface for both devices. The following image shows the connection diagram for working with two Opta™ devices.
103103

104104
![RS-485 interface between Opta™ devices for Modbus RTU](assets/opta_rtu_plcide_hardware_connection.png)
105105

@@ -109,9 +109,9 @@ The Modbus RTU communication network can be scaled up by integrating additional
109109

110110
### Workspace Pre-Configuration
111111

112-
Some considerations must be considered beforehand to properly enable and use Modbus RTU on Opta™ using PLC IDE for appropriate Modbus RTU operation. The following subsections will help briefly explain such aspects.
112+
Some considerations must be made before properly enabling and using Modbus RTU on Opta™ using PLC IDE for appropriate Modbus RTU operation. The following subsections will explain such aspects.
113113

114-
***It is recommendable to check out [this tutorial](https://docs.arduino.cc/tutorials/portenta-machine-control/plc-ide-setup-license#3-project-setup) to familiarize with Arduino PLC IDE environment.***
114+
***Check out [this tutorial](https://docs.arduino.cc/tutorials/portenta-machine-control/plc-ide-setup-license#3-project-setup) to familiarize yourself with the Arduino PLC IDE environment.***
115115

116116
#### Opta™ Basic Configuration
117117

@@ -131,7 +131,7 @@ Opta™ set as a Modbus RTU Client will provide 'Baud Rate' and 'Serial Mode' se
131131

132132
On the other hand, Opta™ set as a Modbus RTU Server requires an additional configuration called 'Slave Settings'. It will ask you to define the Modbus address with a range between `1 .. 247`.
133133

134-
If you decide to disable Modbus RTU for Opta™, you can select the option 'none'. It will hide every Modbus RTU configuration parameter, turning off the protocol mode for Opta™.
134+
If you disable Modbus RTU for Opta™, you can select the option `none`. This option hides every Modbus RTU configuration parameter, turning off the protocol mode for Opta™.
135135

136136
#### General Modbus Node Configuration
137137

@@ -151,13 +151,13 @@ This information will help identify and correctly communicate with the target de
151151

152152
#### PLC IDE Modbus Custom Editor
153153

154-
The Modbus Custom Editor allows you to define a Modbus node with pre-defined parameters and variables. It can be later added using the 'Add' option under 'RS485 SerialPort'.
154+
The Modbus Custom Editor allows you to define a Modbus node with predefined parameters and variables. You can later add it using the `Add` option under `RS485 SerialPort`.
155155

156156
To open the Modbus Custom Editor window, go to `Tools -> Run Modbus Custom Editor` on PLC IDE.
157157

158158
![Arduino PLC IDE - Modbus Custom Editor Configuration](assets/opta_plcide_customModbus.png)
159159

160-
It is a helpful feature to have frequently deployed device configurations stored that are compatible with the Modbus protocol.
160+
It is helpful to have frequently deployed device configurations stored that are compatible with the Modbus protocol.
161161

162162
### Project Overview
163163

@@ -167,7 +167,7 @@ The example project will slightly modify its default example code to incorporate
167167

168168
Based on the counter data it receives from the "Modbus RTU Server Opta™," the "Modbus RTU Client Opta™" will activate the relay and the status LED. Using the role-specific sections, you may learn how to configure the Modbus RTU role for each Opta™ device.
169169

170-
You may access the entire example project [here](assets/ModbusRTU_Opta_Example.zip) if you want to test it immediately. Every setting and component is ready to be assembled and uploaded to the corresponding Opta™.
170+
You may access the entire example project [here](assets/ModbusRTU_Opta_Example.zip) to test it immediately. Every setting and component is ready to be assembled and uploaded to the corresponding Opta™.
171171

172172
The following sections will demonstrate how to set up each Opta™ according to its function in a Modbus RTU connection.
173173

@@ -183,7 +183,7 @@ To set Opta™ as a Modbus RTU Server, navigate to the `RS485 SerialPort` tab in
183183

184184
Alternative values can be used per requirements if needed.
185185

186-
The following image shows the `Status variables (volatile)` window. Here, we will define the `cnt` variable, assigning its access address and datatype for Modbus RTU transmission.
186+
The following image shows the `Status variables (volatile)` window. Here, we will define the `cnt` variable and assign its access address and datatype for Modbus RTU transmission.
187187

188188
![Arduino PLC IDE - Opta™ Server Status Variable](assets/opta_plcide_server_statVar.png)
189189

@@ -193,7 +193,7 @@ The `cnt` status variable uses the following parameters:
193193
* **Name**: cnt
194194
* **PLC type**: INT
195195

196-
With these settings ready, you need to go to `Resources -> Opta`, select the corresponding port, and begin the `Manual sketch download` process. Then you need to go to `On-line -> Set up Communication` and activate Modbus RTU with the higher USB port number assigned for Opta™.
196+
With these settings ready, you **must go** to `Resources -> Opta,` select the corresponding port, and begin the `Manual sketch download` process. Then you **must go** to `On-line -> Set up Communication` and activate Modbus RTU with the higher USB port number assigned for Opta™.
197197

198198
![Arduino PLC IDE - Device Connection Procedure (Modbus TCP Server Opta™)](assets/opta_plcide_device_connection.gif)
199199

@@ -254,7 +254,7 @@ To retrieve counter information from the server Opta™, select the 'Modbus FC-0
254254

255255
![Arduino PLC IDE - Opta™ Client Modbus Function of the Node](assets/opta_plcide_client_modbusFunctionConfig.png)
256256

257-
Subsequently, you need to define a variable to store the counter data retrieved from the server Opta™. To do this, navigate to the Modbus function configuration interface's `Input Reg.` tab. Introduce a variable named `counter_rec` to capture the data transmitted through the protocol.
257+
Subsequently, you must define a variable to store the counter data retrieved from the server Opta™. To do this, navigate to the Modbus function configuration interface's `Input Reg.` tab. Introduce a variable named `counter_rec` to capture the data transmitted through the protocol.
258258

259259
The following image shows a visual representation of the anticipated configuration:
260260

@@ -309,7 +309,7 @@ IF counter >= 2500 THEN
309309
END_IF;
310310
```
311311

312-
The variable `counter` serves as a global reference for the client Opta™. While `counter_rec` is the Modbus-specific variable that stores data fetched from the server Opta™. This variable was defined during configuring the 'Read Input Registers' Modbus function.
312+
The variable `counter` serves as a global reference for the client Opta™. At the same time, `counter_rec` is the Modbus-specific variable that stores data fetched from the server Opta™. This variable was defined when configuring the `Read Input Registers` Modbus function.
313313

314314
Upon successful compilation and downloading of the main PLC code, the complete interface for the client Opta™ should resemble the image provided below:
315315

@@ -341,6 +341,6 @@ In this tutorial, you have learned to configure the workspace environment to wor
341341

342342
### Next Steps
343343

344-
Now that you have learned to implement the Modbus RTU between Opta™ devices using Arduino PLC IDE try adding additional Modbus RTU compatible devices and create a Modbus RTU communication network.
344+
Now that you have learned to implement the Modbus RTU between Opta™ devices using Arduino PLC IDE try adding additional Modbus RTU-compatible devices and creating a Modbus RTU communication network.
345345

346346
Further, explore the possibilities by combining the Opta™ device's onboard features with the Modbus RTU communication network and deploy it as an enhancement solution for industrial management systems.

0 commit comments

Comments
 (0)