Skip to content

Commit 3bcd9c8

Browse files
authored
Merge pull request #2371 from arduino/sync/taddy/plcide-resources-version107-update
[PXCT-108] PLC IDE: Documentation Resources Update for 1.0.7 Version
2 parents 08cc78d + 3e3d3d6 commit 3bcd9c8

34 files changed

+119
-252
lines changed

Diff for: content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/pmc-modbus-tcp-plc-ide/content.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ With this overview complete, we can now create an example.
9090

9191
### Setting Up the Arduino PLC IDE
9292

93-
To get the Arduino PLC IDE software, go to the [official software website ](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`**.
93+
To get the Arduino PLC IDE software, go to the [official software website](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`**.
9494

9595
![Arduino PLC IDE Software Download Section](assets/plcide_software_download.png)
9696

@@ -122,7 +122,7 @@ We highly recommend reviewing [this tutorial](https://docs.arduino.cc/tutorials/
122122

123123
#### Portenta Machine Control Basic Configuration
124124

125-
Identify the IP address assigned to each Portenta Machine Control device to establish Modbus TCP communication. Connecting the Portenta Machine Control to a computer via an RJ-45 cable and an Ethernet port with standard settings will automatically assign an IP address from an external *DHCP* server. Tools like this [scanner](https://angryip.org/) can be useful for locating these auto-assigned IP addresses.
125+
Identify the IP address assigned to each Portenta Machine Control device to establish Modbus TCP communication. Connecting the Portenta Machine Control to a network infrastructure via an RJ-45 cable and an Ethernet port with standard settings will automatically assign an IP address from an external *DHCP* server. Tools like this [scanner](https://angryip.org/) can be useful for locating these auto-assigned IP addresses.
126126

127127
You can also assign a custom IP address to the Portenta Machine Control using the **Ethernet.begin()** method. This is helpful when you need specific addresses because of operational needs. To do this, we will use the sketch available in the `Resources` tab of the PLC IDE. The image below provides an overview of the setup options within the sketch.
128128

Diff for: content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/pmc-opta-modbus-tcp/content.md

+5-10
Original file line numberDiff line numberDiff line change
@@ -204,20 +204,15 @@ Go to the **sketch editor** and uncomment the library and setup function code li
204204
In this case the following configurations are used:
205205

206206
```arduino
207-
// Enable usage of EtherClass, to set static IP address and other
208-
#include <PortentaEthernet.h>
209-
arduino::EthernetClass eth(&m_netInterface);
210-
211207
void setup()
212208
{
213209
// Configure static IP address
214-
IPAddress ip(10, 0, 0, 227); // Opta IP address
215-
IPAddress dns(10, 0, 0, 1); // gateway IP address
216-
IPAddress gateway(10, 0, 0, 1); // gateway IP address
217-
IPAddress subnet(255, 255, 255, 0);
210+
IPAddress ip(10, 0, 0, 227);
211+
IPAddress dns(10, 0, 0, 1);
212+
IPAddress gateway(10, 0, 0, 1);
213+
IPAddress subnet(255, 255, 255, 0);
218214
// If cable is not connected this will block the start of PLC with about 60s of timeout!
219-
eth.begin(ip, dns, gateway, subnet);
220-
215+
Ethernet.begin(ip, dns, gateway, subnet);
221216
}
222217
```
223218
![Network settings for Modbus TCP](assets/ip-setup-opta.png)

Diff for: content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/assets/opta_plcide_hardware_connection.svg

-33
This file was deleted.

Diff for: content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/assets/opta_plcide_hardware_connection_eth.svg

-43
This file was deleted.

Diff for: content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/assets/opta_plcide_modbustcp_overview.svg

-49
This file was deleted.

Diff for: content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/assets/plcide_software_download.svg

-9
This file was deleted.

Diff for: content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/content.md

+92-87
Large diffs are not rendered by default.
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading

Diff for: content/software/plc-ide/tutorials/05.modbus-setup/content.md

+20-19
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,9 @@ The Arduino Portenta Machine Control (PMC) is a fully-centralized, low-power, in
2929
In order to configure the Portenta Machine Control you will need to connect to the device through the Arduino PLC IDE.
3030

3131
1. Connect the device to the computer through USB
32-
2. Click "Connect to the target" button on the PLC IDE
32+
2. Click **Connect to the target** button on the PLC IDE
3333

34-
***The device needs to be activated with a license, check the steps on the [PLC IDE Set-up tutorial](./plc-ide-setup-license)***
34+
***The device needs to be activated with a license, check the steps on the [PLC IDE Set-up tutorial](./plc-ide-setup-license).***
3535

3636
***Both Modbus RTU and Modbus TCP can run at the same time in parallel***
3737

@@ -41,9 +41,9 @@ In order to configure the Portenta Machine Control you will need to connect to t
4141

4242
### Modbus RTU Configuration
4343

44-
Inside the Arduino PLC IDE navigate to the left side panel and click on the "Resources" tab.
44+
Inside the Arduino PLC IDE navigate to the left side panel and click on the **Resources** tab.
4545

46-
To configure the Modbus communication click on the "RS485 Serialport" label, it will open a new window in the middle to customize:
46+
To configure the Modbus communication click on the **RS485 Serialport** label, it will open a new window in the middle to customize:
4747

4848
![Arduino PLC IDE Resources panel, -> RS-485 settings](assets/PLC-IDE-ModBus.png)
4949

@@ -54,15 +54,12 @@ Then you can attach some functions to the Generic Modbus item, they will appear
5454
![Modbus catalog select new item](assets/modbusCatalog-add-prompt.png)
5555

5656
#### Mode
57-
<br></br>
5857

5958
* Not used
6059
* Modbus RTU Master
6160
* Modbus RTU Slave
6261

6362
#### Baud Rate
64-
<br></br>
65-
6663

6764
Baud rate, options:
6865
* 600
@@ -76,28 +73,26 @@ Baud rate, options:
7673
* 115200
7774

7875
#### Serial Mode
79-
<br></br>
8076

81-
| Name | Parity | data bits | stop bits |
82-
| ------- | ----------- | --------- | ----------|
83-
| N, 8, 1 | No parity | 8 | 1 |
84-
| E, 8, 1 | Even parity | 8 | 1 |
85-
| O, 8, 1 | Odd parity | 8 | 2 |
86-
| N, 8, 2 | No parity | 8 | 2 |
87-
| O, 8, 2 | Odd parity | 8 | 2 |
77+
| **Name** | **Parity** | **data bits** | **stop bits** |
78+
|----------|-------------|---------------|---------------|
79+
| N, 8, 1 | No parity | 8 | 1 |
80+
| E, 8, 1 | Even parity | 8 | 1 |
81+
| O, 8, 1 | Odd parity | 8 | 2 |
82+
| N, 8, 2 | No parity | 8 | 2 |
83+
| O, 8, 2 | Odd parity | 8 | 2 |
8884

8985
#### Slave Settings
90-
<br></br>
9186

9287
(Only available on slave mode)
9388

9489
* Modbus address
9590
Address of the device: from 1 to 247. It can not be repeated within the same Modbus net.
9691

9792
#### Modbus Node Configuration
98-
<br></br>
9993

100-
Once you have configured your device as a **Modbus Master** you can attach some blocks to configure it, you can see them while you have the **RS485 SerialPort** on the **Catalog Tile Window**
94+
Once you have configured your device as a **Modbus Master** you can attach some blocks to configure it, you can see them while you have the **RS485 SerialPort** on the **Catalog Tile Window**:
95+
10196
![Modbus catalog](assets/modBusCatalog.png)
10297

10398
* Generic Modbus
@@ -127,11 +122,14 @@ Then you can attach some functions to the Generic Modbus item, they will appear
127122
Settings:
128123
* Name
129124
* IP address
125+
* Modbus address
130126
* Minimum polling time
127+
* Address type
131128

132129
## Modbus Parametrization
133130

134-
On the Generic
131+
On the Generic:
132+
135133
![Generic Modbus Parametrization Tab](assets/modbusParametrization.png)
136134

137135
## Modbus Devices Functions (Modbus FC)
@@ -146,13 +144,16 @@ On the Generic
146144
* Modbus FC-16: Write multiple registers
147145

148146
To configure the block you can click on it and it will show the configuration panel on the main window.
147+
149148
![Modbus item catalog](assets/genericModbus-catalog.png)
150149

151150
Inside each of the "devices" (functions) you can set its:
151+
152152
**General**
153153
* Start address
154154
* Polling time
155155
* Time Out
156+
* Oneshot variable
156157

157158
![Modbus item general configuration](assets/genericModbus-catalog-setting-general.png)
158159

0 commit comments

Comments
 (0)