Julian Review updates

Author: mcmchris

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

@@ -1,7 +1,7 @@
 ---
 title: 'Modbus TCP with Portenta Machine Control & Opta™'
 difficulty: intermediate
-description: "Modbus TCP communication on a real industrial application using a Portenta Machine Control, Opta™, a temperature sensor, and the Arduino® PLC IDE."
+description: "Learn to use Modbus TCP communication on a real industrial application using a Portenta Machine Control, Opta™, a temperature sensor, and the Arduino® PLC IDE."
 tags:
   - Thermocouple
   - IEC-61131-3
@@ -17,18 +17,20 @@ software:
   - plc-ide
 ---
 
-## Overview
+## Overview & Video Tutorial
 
-In this tutorial, a Portenta Machine Control and an Opta micro PLC will be used as **server** and **client** respectively to share temperature information through Modbus TCP using the PLC IDE. The server will do the measurements using a type K thermocouple and the client will activate its relay outputs when a certain threshold is reached.
+In this tutorial, a Portenta Machine Control and an Opta™ micro PLC will be used as **server** and **client** respectively to share temperature information through Modbus TCP using the PLC IDE. The server will do the measurements using a type K thermocouple and the client will activate its relay outputs when a certain threshold is reached.
 
-Here is a detailed guide in video format if you are a visual learner.
+We have prepared a detailed guide in video format in case you are a visual learner.
 
 <iframe width="100%" height="480" src="https://www.youtube.com/embed/reBrbCq86uQ?si=q0EkR-B8bR0MeF5p" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
+If you prefer to follow the tutorial in a written format, or need to review the steps and code done in the video tutorial, in the following sections you will find a step-by-step guide explaining how the temperature measurement and Modbus communication between both devices were done.
+
 ## Goals
 
 - Learn how to measure temperature with the Portenta Machine Control using a thermocouple and the PLC IDE
-- Learn how to use the Modbus protocol over TCP/IP using the PLC IDE
+- Discover how to use the Modbus protocol over TCP/IP using the PLC IDE
 - Leverage Arduino Pro products for real industrial applications 
 
 ## Hardware and Software Requirements
@@ -39,7 +41,7 @@ Here is a detailed guide in video format if you are a visual learner.
 - Type K thermocouple (x1)
 - Ethernet cables (x2)
 - Wired internet access
-- 24 VDC Power Supply (x2)
+- 24 VDC/0.5 A power supply (x2)
 ### Software
 - The [Arduino PLC IDE](https://www.arduino.cc/pro/software-plc-ide) (including Arduino PLC IDE Tools)
 - [Portenta Machine Control - PLC IDE Activation](https://store-usa.arduino.cc/products/plc-key-portenta-machine-control?queryID=undefined&selectedStore=us)
@@ -50,21 +52,21 @@ Here is a detailed guide in video format if you are a visual learner.
 
 ![Real Application Wiring Setup](assets/Wiring-white-small.png)
 
-- In the __Portenta Machine Control__, connect the thermocouple terminals to TP0 and TN0 respectively. The 24 VDC power supply to the 24-volt input and GND. 
+- In the __Portenta Machine Control__: connect the thermocouple terminals to TP0 and TN0 respectively and the 24 VDC power supply to the 24-volt input and GND. 
 
-- In the __Opta micro PLC__, connect the power supply to the respective inputs on the screw terminals.
+- In the __Opta™ micro PLC__: connect the power supply to the respective inputs on the screw terminals.
 
-- Connect both the PMC and the Opta to your router using ethernet cables.
+- Connect both the Portenta Machine Control and the Opta™ to your local network using ethernet cables.
 
 ### Portenta Machine Control Setup
 
 After downloading the [PLC IDE](https://www.arduino.cc/pro/software-plc-ide), open it and create a __new project__ for the Portenta Machine Control.
 
-![New project for the PMC](assets/new-project.png)
+![New project for the Portenta Machine Control](assets/new-project.png)
 
 A license is needed for this product to be used with the PLC IDE, you can buy it directly from the [Arduino store](https://store-usa.arduino.cc/products/plc-key-portenta-machine-control), and it will include the **product key** to activate the device. 
 
-Connect the PMC to the computer using a micro USB cable, the board needs to run a specific program (runtime) in order to interact with the **PLC IDE**. To flash it, select the device serial port and click on download.
+Connect the Machine Control to the computer using a micro USB cable, the board needs to run a specific program (runtime) in order to interact with the **PLC IDE**. To flash it, select the device serial port and click on download.
 
 ![Runtime program download](assets/runtime.png)
 
@@ -81,7 +83,7 @@ The device will show its activation status, in this case, **No License** as it i
 
 ![Activation process](assets/activate.png)
 
-After that, the status should say **OK**, and now you are ready to start programming the Portenta Machine Control with the PLC IDE.
+After the activation, the status should say **OK**. Now you are ready to start programming the Portenta Machine Control with the PLC IDE.
 
 To learn more about the PLC IDE first setup, continue reading this [detailed guide](https://docs.arduino.cc/software/plc-ide/tutorials/plc-ide-setup-license/#6-license-activation-with-product-key-portenta-machine-control).
 
@@ -90,9 +92,9 @@ For the Modbus TCP configuration, on the **resources tab** go to the **Ethernet*
 
 ![Modbus set to slave mode](assets/slave-mode.png)
 
-Now, go to the **sketch editor** and uncomment the library and setup function code lines. As the IP, we must use the same as the Portenta Machine Control, as it is connected to your router, you can find it on its configurations. 
+Go to the **sketch editor** and uncomment the library and setup function code lines. As the IP, we must use the same as the Portenta Machine Control, as it is connected to your local network, you can find it on its configurations. 
 
-In this case, the following configurations are used.
+In this case, the following configurations are used:
 
 ```arduino
 // Enable usage of EtherClass, to set static IP address and other
@@ -102,7 +104,7 @@ arduino::EthernetClass eth(&m_netInterface);
 void setup()
 {
 	// Configure static IP address
-	IPAddress ip(10, 0, 0, 157);    // PMC IP address
+	IPAddress ip(10, 0, 0, 157);    // Portenta Machine Control IP address
 	IPAddress dns(10, 0, 0, 1);     // gateway IP address
 	IPAddress gateway(10, 0, 0, 1); // gateway IP address
 	IPAddress subnet(255, 255, 255, 0); 
@@ -113,15 +115,15 @@ void setup()
 ```
 ![Network settings for Modbus TCP](assets/ip-setup.png)
 
-Now, create the variable that will be shared with the temperature sensor data in the network. For this, we go to **status variables** and click on **Add**. Configure it as follows:
+Now create the variable that will be shared with the temperature sensor data in the network. Go to **status variables** and click on **Add**. Configure it as follows:
 
 - Name: `temp_send`
 - Address: `25000`
 - PLC type: `REAL`
 
 ![Temperature variable setup](assets/var-setup.png)
 
-Next, go to **Temperature probes** and select the sensor type, for this tutorial, enable the **thermocouple** connected to the first channel by setting it to true.
+Next go to **Temperature probes** and select the sensor type, for this tutorial, enable the **thermocouple** connected to the first channel by setting it to true.
 
 ![Temperature probe configuration](assets/probe-setup.png)
 
@@ -137,13 +139,13 @@ To check if everything is okay, click on compile, and if no error is shown, you
 
 ![Project compiled with no errors](assets/compile.png)
 
-Once uploaded, click on the **Connect** button again. Now, you can monitor the **temp_send** variable in the **Watch** window dragging and dropping it from the __Global shared__ variables in the project tab.
+Once uploaded, click on the **Connect** button again. Now you can monitor the **temp_send** variable in the **Watch** window dragging and dropping it from the __Global shared__ variables in the project tab.
 
-You should see the temperature value measured by the sensor.
+You should see the temperature value measured by the sensor inside the "Watch" window.
 
-![Live temperature measurement on the PMC](assets/temp-check.gif)
+![Live temperature measurement on the Machine Control](assets/temp-check.gif)
 
-### Opta Micro PLC Setup
+### Opta™ Micro PLC Setup
 
 Now the server is configured, create a new project, this time for the Opta™ micro PLC that will be the Client or Master.
 
@@ -164,7 +166,9 @@ Now, in the upper left corner, click on the **Connect** button and wait for the
 
 ![Connecting the board](assets/connected-opta.png)
 
-***The Opta™ doesn’t need any license activation to be used with the PLC IDE***
+***The Opta™ is Pre-Licensed so you don't have to buy any license to use it with the PLC IDE***
+
+If the Opta status says **No License**, click on the **Activate PLC runtime** button to activate it. Learn more about this case in this [guide](https://docs.arduino.cc/tutorials/portenta-machine-control/plc-ide-setup-license/#7-license-activation-with-pre-licensed-products-opta).
 
 #### Modbus TCP - Client
 
@@ -176,27 +180,27 @@ In the **Ethernet** tab, enable the Modbus TCP Master mode.
 
 Then right-click on the **Ethernet** tab, click on **Add** and select the _Generic Modbus device_.
 
-![Modbus Device Configuration 1](assets/modbus-device.png)
+![Modbus Device Configuration - Step 1](assets/modbus-device.png)
 
 On the `Generic Modbus_1` device settings, enter the Server IP, the one from the Portenta Machine Control.
 
-![Modbus Device Configuration 2](assets/modbus-device-2.png)
+![Modbus Device Configuration - Step 2](assets/modbus-device-2.png)
 
 Right-click on the device and add the **FC-04 Modbus** function that will let us read the server input registers. 
 
-![Modbus Device Configuration 3](assets/modbus-device-3.png)
+![Modbus Device Configuration - Step 3](assets/modbus-device-3.png)
 
-Now, click on the function and in the general settings, enter the shared variable address that you defined earlier in the server, `25000` in this case.
+Now click on the function and in the general settings, enter the shared variable address that you defined earlier in the server, `25000` in this case.
 
-![Modbus Device Configuration 4](assets/modbus-device-4.png)
+![Modbus Device Configuration - Step 4](assets/modbus-device-4.png)
 
 In the Input Register tab, create a label for it, which could be `temp_reg`.
 
 ![Label the register](assets/modbus-device-5.png)
 
-Now, go to the **sketch editor** and uncomment the library and setup function code lines. As the IP, we must use the same as the Opta™. 
+Go to the **sketch editor** and uncomment the library and setup function code lines. As the IP, we must use the same as the Opta™. 
 
-In this case, the following configurations are used.
+In this case the following configurations are used:
 
 ```arduino
 // Enable usage of EtherClass, to set static IP address and other
@@ -217,15 +221,15 @@ void setup()
 ```
 ![Network settings for Modbus TCP](assets/ip-setup-opta.png)
 
-Finally, define the Opta™ outputs behavior in function of the temperature read from the Portenta Machine Control. For this, go to the **resources tab > Relay Outputs** and give a variable name to each relay, in this case, call them `relay_1`, 2, 3 and 4 respectively.
+Finally, define the Opta™ outputs behavior in function of the temperature read from the Portenta Machine Control. To do this, go to the **resources tab > Relay Outputs** and give a variable name to each relay, in this case, call them `relay_1`, `relay_2`, `relay_3` and `relay_4` respectively.
 
 ![Outputs definitions](assets/outputs-opta.png)
 
-The same with the LED outputs, `LED1`, 2, 3 and 4.
+The same with the LED outputs, `LED1`, `LED2`, `LED3` and `LED4`.
 
 ![LEDs definitions](assets/led-opta.png)
 
-Now, go to the main code in the Project tab. Create a variable by right-clicking on the local variables window and then **insert**, call it **temp_local** and _integer_ as the type.
+Now go to the main code in the Project tab. Create a variable by right-clicking on the local variables window and then **insert**, call it **temp_local** and _integer_ as the type.
 
 ![Create a local variable](assets/variable-opta.png)
 
@@ -277,12 +281,21 @@ With the final code written, compile the project and upload it the the Opta™ m
 
 You can leave each device connected separately to the internet router or connect them together directly with one ethernet cable. The first option will let you update the preferred device remotely as you can access it through the local network.
 
-Now, you can expose the temperature sensor to some heat and monitor it from the PLC IDE. The Opta™ relay outputs and LEDs will close and turn on when the temperature surpasses the programmed thresholds respectively.
+Now you can expose the temperature sensor to some heat and monitor it from the PLC IDE. The Opta™ relay outputs and LEDs will close and turn on when the temperature surpasses the programmed thresholds respectively.
 
 ![Testing the project](assets/final.gif)
 
-#### Conclusion 
+### Conclusion 
 
 In this tutorial you learned how to communicate two Arduino PRO products using the Modbus TCP protocol, demonstrating a simple application of sharing temperature data to control a device's outputs.
 
-As you can notice, the configuration process is very straightforward and the results were as expected. 
+As you can notice, the configuration process is very straightforward and the results were as expected, being a good starting point to adapt the work done here to create your own professional solution.
+
+#### Next Steps
+
+Extend your knowledge about the Portenta Machine Control, PLC IDE and the variety of industrial protocols it supports by following these tutorials:
+
+- [Programming Introduction with Arduino PLC IDE](https://docs.arduino.cc/tutorials/portenta-machine-control/plc-programming-introduction/)
+- [Tank Thermoregulation with Portenta Machine Control & Opta™](https://docs.arduino.cc/tutorials/portenta-machine-control/pmc-opta-temp-ctrl/)
+- [Connect an RTD/Thermocouple to the Portenta Machine Control](https://docs.arduino.cc/tutorials/portenta-machine-control/rtd-thermocouple-pmc/)
+- [Arduino PLC IDE Setup & Device License Activation](https://docs.arduino.cc/tutorials/portenta-machine-control/plc-ide-setup-license/)