Skip to content

Commit 80e7346

Browse files
committed
Tutorial content fitment update
1 parent ab9b41c commit 80e7346

File tree

3 files changed

+31
-44
lines changed

3 files changed

+31
-44
lines changed

content/hardware/07.opta/opta-family/opta/tutorials/opta-modbus-rtu-plc-ide/assets/plcide_software_download.svg

-9
This file was deleted.

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

+31-35
Original file line numberDiff line numberDiff line change
@@ -34,15 +34,14 @@ In this tutorial, you will learn how to implement Modbus RTU-based communication
3434
### Hardware Requirements
3535

3636
- [Opta™](https://store.arduino.cc/collections/pro-family) (x2)
37-
- USB-C® cable (x2)
37+
- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x2)
3838
- Wire 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

44-
- [Arduino PLC IDE Tools](https://www.arduino.cc/en/software#arduino-plc-ide)
45-
- [Arduino PLC IDE software](https://www.arduino.cc/en/software#arduino-plc-ide)
44+
- [Arduino PLC IDE Installer](https://www.arduino.cc/en/software#arduino-plc-ide)
4645
- 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.
4746
- [Opta™ Modbus RTU PLC IDE Project Example File](assets/ModbusRTU_Opta_Example.zip)
4847

@@ -67,14 +66,14 @@ The following diagram illustrates a concise visualization of how Opta™ is conf
6766
The entire procedure is divided into three distinct stages:
6867

6968
* __Modbus RTU Configuration__ is the foundational step in initializing the Opta™ device with Modbus RTU and other intrinsic properties.
70-
71-
The Modbus RTU role, Client or Server, is assigned to the Opta™ device during this stage. It includes the 'Baud rate' and 'Serial Mode' configurations, essential for Modbus RTU communication.
72-
73-
Based on the device setting within the Modbus RTU, either the 'Status variables' are delineated, or the Modbus node is defined to determine the communicating devices using this protocol.
69+
 
70+
The Modbus RTU role, Client or Server, is assigned to the Opta™ device during this stage. It includes the 'Baud rate' and 'Serial Mode' configurations, which are essential for Modbus RTU communication.
71+
 
72+
Based on the device setting within the Modbus RTU, either the 'Status variables' are delineated, or the Modbus node is defined to determine the communicating devices using this protocol.
7473

7574
* __PLC Program__, established after device setup, is based on Modbus RTU and additional features. A significant advantage of this phase is the elimination of intricate configurations or specific programming tied to Modbus RTU within the PLC code.
76-
77-
The procedure is designed for ease of use. By simply using predefined variables in the PLC code, the system handles data transfer through Modbus RTU. This approach benefits from the device's prior setup, minimizing repetitive tasks and promoting effective communication.
75+
 
76+
The procedure is designed for ease of use. By simply using predefined variables in the PLC code, the system handles data transfer through Modbus RTU. This approach benefits from the device's prior setup, minimizing repetitive tasks and promoting effective communication.
7877

7978
* __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.
8079

@@ -88,16 +87,13 @@ We can now delve into the specifics after providing an overview of the entire pr
8887

8988
### Setting Up the Arduino PLC IDE
9089

91-
Access the Arduino PLC IDE software by following [Arduino PLC IDE official website](https://www.arduino.cc/pro/software-plc-ide). You will have to download two executable files for proper software installation:
90+
To get the Arduino PLC IDE software, go to the [official software website of the Arduino PLC IDE](https://www.arduino.cc/pro/software-plc-ide) and choose to download the PLC IDE installer file. The software is named `Arduino PLC IDE Installer`.
9291

93-
- [Arduino PLC IDE Tools](https://www.arduino.cc/en/software#arduino-plc-ide)
94-
- [Arduino PLC IDE](https://www.arduino.cc/en/software#arduino-plc-ide)
92+
![Arduino PLC IDE Software Download Section](assets/plcide_software_download.png)
9593

96-
![Arduino PLC IDE Software Download Section](assets/plcide_software_download.svg)
94+
The software requires **Windows 10** or a newer operating system version for the x64 architecture.
9795

98-
The **Arduino PLC IDE Tools** will provide all the required drivers, libraries, and cores for development, while the **Arduino PLC IDE** will install the IDE software.
99-
100-
Install the Arduino PLC IDE Tools before the Arduino PLC IDE to avoid potential problems related to old libraries and drivers.
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.
10197

10298
***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.***
10399

@@ -129,9 +125,9 @@ The PLC IDE software provides the option to set Opta™ as either a Modbus RTU C
129125

130126
Opta™ set as a Modbus RTU Client will provide 'Baud Rate' and 'Serial Mode' settings. The baud rate is available from 600 b/s to 115200 b/s. The serial mode offers a set of options conformed with the following elements:
131127

132-
- Parity: No Parity, Even Parity, Odd Parity
133-
- Data Bits: 8 Data Bits (Only option for Data Bits)
134-
- Stop Bits: 1 - 2 Stop Bits
128+
- **Parity**: No Parity, Even Parity, Odd Parity
129+
- **Data Bits**: 8 Data Bits (Only option for Data Bits)
130+
- **Stop Bits**: 1 - 2 Stop Bits
135131

136132
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`.
137133

@@ -179,9 +175,9 @@ The following sections will demonstrate how to set up each Opta™ according to
179175

180176
To set Opta™ as a Modbus RTU Server, navigate to the `RS485 SerialPort` tab in the PLC IDE's `Resources` panel. A window named `Modbus Configuration` will open, and we must select the `Modbus RTU Slave` option. For the tutorial example, we will use the following properties for server Opta™:
181177

182-
- Baud Rate: 19200 b/s
183-
- Serial Mode: N,8,1 (No parity, 8 data bits, 1 stop bit)
184-
- Slave settings (Modbus address): 10
178+
- **Baud Rate**: 19200 b/s
179+
- **Serial Mode**: N,8,1 (No parity, 8 data bits, 1 stop bit)
180+
- **Slave settings (Modbus address)**: 10
185181

186182
![Arduino PLC IDE - Opta™ Modbus RTU Server Configuration](assets/opta_plcide_server_modbusMainConfig.png)
187183

@@ -193,9 +189,9 @@ The following image shows the `Status variables (volatile)` window. Here, we wil
193189

194190
The `cnt` status variable uses the following parameters:
195191

196-
* Address: 25000 (dec) / 0x61A8 (hex)
197-
* Name: cnt
198-
* PLC type: INT
192+
* **Address**: 25000 (dec) / 0x61A8 (hex)
193+
* **Name**: cnt
194+
* **PLC type**: INT
199195

200196
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™.
201197

@@ -227,20 +223,20 @@ Upon completing these steps, you will have successfully configured an Opta™ de
227223

228224
To set Opta™ as a Modbus RTU Client, navigate to the `RS485 SerialPort` tab in the PLC IDE's `Resources` panel. The `Modbus Configuration` panel will open, and we must select the `Modbus RTU Master` option. For the tutorial example, we will use the following properties for client Opta™:
229225

230-
- Baud Rate: 19200 b/s
231-
- Serial Mode: N,8,1 (No parity, 8 data bits, 1 stop bit)
226+
- **Baud Rate**: 19200 b/s
227+
- **Serial Mode**: N,8,1 (No parity, 8 data bits, 1 stop bit)
232228

233229
![Arduino PLC IDE - Opta™ Modbus RTU Client Configuration](assets/opta_plcide_client_modbusMainConfig.png)
234230

235231
Alternative values can be used per requirements if needed.
236232

237233
To establish communication with a configured Modbus RTU Server on an Opta™ device, add a Modbus node by right-clicking the `RS485 SerialPort` tab in the `Resources` panel. After right-clicking, select the 'Add' option that appears. This action will allow you to introduce a 'Generic Modbus' node into the configuration. For this example, configure the node with the following parameters:
238234

239-
* Name: Opta_RTU_1
240-
* Modbus address: 10
241-
* Minimum polling time: 1 ms
242-
* Address type: Modbus
243-
* Swap words mode: Little-endian compliant (No words swapping)
235+
* **Name**: Opta_RTU_1
236+
* **Modbus address**: 10
237+
* **Minimum polling time**: 1 ms
238+
* **Address type**: Modbus
239+
* **Swap words mode**: Little-endian compliant (No words swapping)
244240

245241
For these settings, follow the configuration pattern used for the Modbus RTU Server Opta™. The most essential detail to set is the Modbus address. Ensure this address matches the one given to the server Opta™ or any other compatible device should you add more nodes. The setup should resemble the image provided:
246242

@@ -252,9 +248,9 @@ Once you have established the Modbus node for the client Opta™, it is time to
252248

253249
To retrieve counter information from the server Opta™, select the 'Modbus FC-04 (Read Input Registers)' function. The 'General' tab needs to be configured with the following parameters to ensure correct data access:
254250

255-
* Start address: 25000
256-
* Polling time: 0 ms (Continuous Read)
257-
* Timeout: 1000 ms
251+
* **Start address**: 25000
252+
* **Polling time**: 0 ms (Continuous Read)
253+
* **Timeout**: 1000 ms
258254

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

0 commit comments

Comments
 (0)