diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.png
index 710b8c5734..58c59fb067 100644
Binary files a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.png and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.svg b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.svg
deleted file mode 100644
index 1519f08715..0000000000
--- a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/IdeDownloadPage.svg
+++ /dev/null
@@ -1,9 +0,0 @@
-
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/newProjectFullScreen.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/newProjectFullScreen.png
index b2744ced5d..d496e7c2da 100644
Binary files a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/newProjectFullScreen.png and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/newProjectFullScreen.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-1.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-1.png
new file mode 100644
index 0000000000..c2283ba88d
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-1.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-2.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-2.png
new file mode 100644
index 0000000000..64d5ea4ecb
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-2.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-3.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-3.png
new file mode 100644
index 0000000000..840f56413e
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-3.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-4.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-4.png
new file mode 100644
index 0000000000..20675995e0
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-4.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-5.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-5.png
new file mode 100644
index 0000000000..20db72ab14
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-5.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-6.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-6.png
new file mode 100644
index 0000000000..83ee7460a5
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-6.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-7.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-7.png
new file mode 100644
index 0000000000..04f531b25c
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/plcide-install-7.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/runtime.png b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/runtime.png
new file mode 100644
index 0000000000..e7e0c0f1b2
Binary files /dev/null and b/content/software/plc-ide/tutorials/plc-ide-setup-license/assets/runtime.png differ
diff --git a/content/software/plc-ide/tutorials/plc-ide-setup-license/content.md b/content/software/plc-ide/tutorials/plc-ide-setup-license/content.md
index 9957cf790d..55fe43ad25 100644
--- a/content/software/plc-ide/tutorials/plc-ide-setup-license/content.md
+++ b/content/software/plc-ide/tutorials/plc-ide-setup-license/content.md
@@ -1,6 +1,6 @@
---
beta: true
-title: Arduino PLC IDE Setup & Device License Activation
+title: Arduino® PLC IDE Setup & Device License Activation
difficulty: beginner
tags:
- PLC
@@ -10,6 +10,7 @@ author: 'Pablo Marquínez'
hardware:
- hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control
- hardware/07.opta/opta-family/opta
+ - hardware/07.opta/opta-family/opta-digital-exp
software:
- ide-v1
- ide-v2
@@ -18,7 +19,7 @@ software:
## Overview
-The **Arduino PLC IDE** offers the possibility to use **IEC IEC61131-3** programming languages (LD, SFC, FBD, ST, IL) with the **Portenta Machine Control and Opta™**. The PLC IDE offers a wide set of standard features commonly used in industrial automation.
+The **Arduino PLC IDE** offers the possibility to use **IEC IEC61131-3** programming languages (LD, SFC, FBD, ST, IL) with the **Portenta Machine Control and Opta™**. The PLC IDE offers a comprehensive set of standard features commonly used in industrial automation.
@@ -26,102 +27,130 @@ This tutorial will show you how to connect the Portenta Machine Control and Opta
## Goals
-- Install the Arduino PLC IDE and the Arduino PLC IDE Tools
+- Set up the Arduino PLC IDE using the Arduino PLC IDE installer
- Download the PLC IDE bootloader to the board
-- Connect the computer to your device through the IDE
+- Establish a connection between your computer and the device using the PLC IDE
- Activate the device license
-- Test the connection
+- Verify the connection between the devices
-## Required Hardware and Software
+## Hardware and Software Requirements
-- Board compatible with the Arduino PLC IDE ([Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control) or [Opta™](https://store.arduino.cc/collections/pro-family)).
-- Arduino PLC IDE ([Official Website](https://www.arduino.cc/pro/software-plc-ide)).
-- If you have a Portenta Machine Control, you will need a unique PLC IDE License key for your device. Get your license key [here](https://store.arduino.cc/products/plc-key-portenta-machine-control).
-- 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™)__ to know more.
+### Hardware Requirements
+
+Board compatible with the Arduino PLC IDE:
+- [Opta™](https://store-usa.arduino.cc/collections/opta-family)
+- [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control)
+
+The following accessories are needed:
+- [USB-C® cable for Opta™](https://store-usa.arduino.cc/products/usb-cable2in1-type-c) (x1)
+- [Micro-USB cable for Portenta Machine Control](https://store.arduino.cc/products/usb-2-0-cable-type-a-micro) (x1)
+
+### Software Requirements
+
+- Arduino PLC IDE [Official Website](https://www.arduino.cc/pro/software-plc-ide)
+- If you have a [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control), you will need a unique PLC IDE License key for your device. Get your license key [here](https://store.arduino.cc/products/plc-key-portenta-machine-control).
+- If you have an [Opta™](https://store-usa.arduino.cc/collections/opta-family), you do not need any license key to activate your product. Go to section [__License Activation With Pre-Licensed Products (Opta™)__](#6-license-activation-with-pre-licensed-products-opta™) to know more.
- [Arduino IDE 1.8.10+](https://www.arduino.cc/en/software), [Arduino IDE 2](https://www.arduino.cc/en/software), [Arduino Web Editor](https://create.arduino.cc/editor) or any program with a serial monitor in case you need to retrieve the _Hardware-ID_ of your device.
***To get the Arduino PLC IDE and the PLC IDE License for your device, please visit the [Arduino software page](https://www.arduino.cc/en/software) and the [store page](https://store.arduino.cc/plc-key-portenta-machine-control).***
## Instructions
-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 software files. You will need two following executables:
+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`.
-* Arduino PLC IDE Tools
-* Arduino PLC IDE
-
-
+
The software requires **Windows 10** or a newer operating system version for the x64 architecture.
-The first executable file packages all the required drivers, libraries, and cores that you will need. The second executable will install the IDE software. The continuing sections will help you install the Arduino PLC IDE software properly.
+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.
+
+### 1. Arduino PLC IDE Setup
+
+When you download the Arduino PLC IDE installer, the file naming scheme is as follows:
+
+`Arduino-PLC-IDE-Installer_X.X.X_Windows_64bit`
-### 1. Arduino PLC IDE Tools Setup
+If you have the correct IDE software, its name should include the version format `X.X.X`. For instance, a version example might look like `1.0.6`. Thus, a complete installer name should resemble the following:
-For a proper Arduino PLC IDE setup, you will need to install all the required tools before IDE software setup.
+`Arduino-PLC-IDE-Installer_1.0.6_Windows_64bit`
-When you download the Arduino PLC IDE Tools executable, the file naming scheme is as follows:
+Run the Arduino PLC IDE installer after verifying that the installer naming scheme follows the above software nomenclature. It helps ensure the software package is legitimate and the latest version available.
-`Arduino-PLC-IDE-Tools_X.X.X_Windows_64bit`
+***During the installation, you may notice several terminal windows opening automatically. These are necessary for the installation process to load all required resources onto your computer successfully, so there is no need to be concerned.***
-If you have got the correct tool package, it should follow the previous naming scheme with the `X.X.X` that represents the version of the tool package. Once you have verified and downloaded the Arduino PLC IDE Tools executable, run the installer and follow the installation instructions.
+The installation process starts with a window that prompts you to begin. Click **Install** to proceed:
-Once the installation has finished, all the required drivers, libraries, and Arduino cores will be installed and ready to be used. Your computer is now ready to install the Arduino PLC IDE.
+
-***It is possible that during the installation, some terminal windows will pop by the installation program. Do not worry about it, these windows are required by the program to install all the tools that your computer needs.***
+The installation will begin with the **PLC IDE Tools**. Click **Next** to continue:
-### 2. Arduino PLC IDE Setup
+
-When you download the Arduino PLC IDE executable, the file naming scheme is as follows:
+Select a directory for installing the **PLC IDE Tools** and then click **Next**:
-`Setup_Arduino PLC IDE_X.X.X.X_{ReleaseDate}`
+
-If you have the correct IDE software, its name should include the version format `X.X.X.X`, with the associated release date in the `{ReleaseDate}` field. For instance, a release date might look like `20230329`.
+Click **Install** to install the **PLC IDE Tools** in the chosen directory:
-Run the Arduino PLC IDE installer after you have installed the Arduino PLC IDE Tools. If you have not installed the PLC IDE tools, please check [Arduino PLC IDE Tools Setup section](#1-arduino-plc-ide-tools-setup) before proceeding as it needs to have the tools set before IDE software installation.
+
-Follow the installation instructions and finish the IDE setup process.
+Following the **PLC IDE Tools** installation, set up the **PLC IDE software** by choosing an installation directory and following the instructions:
-***If you have any problem, try rebooting your computer to ensure that all the drivers, libraries, and dependencies are applied and up to date.***
+
-Once the setup is complete, open the Arduino PLC IDE program, and the welcome screen will greet you.
+A confirmation window will indicate the completion of the **PLC IDE software** installation:
+
+
+
+Once the installation is finished, a message will appear confirming the successful setup. Click **Close** to exit the installer:
+
+
+
+***If you encounter any issues, restarting your computer can help ensure that all drivers, libraries, and dependencies are properly integrated and updated with the IDE installation.***
+
+Open the Arduino PLC IDE program, and the welcome screen will greet you.
-The following sections will guide you to create a project, download the runtime, and properly interface the Portenta Machine Control or Opta™ with its dedicated license activation procedure.
+The following sections will guide you through creating a project, downloading the runtime, and properly interfacing the Portenta Machine Control or Opta™ with its dedicated license activation procedure.
-### 3. Project Setup
+### 2. Project Setup
-Create a new project by clicking the middle **New project ...** button or **File > New Project**
+Create a new project by clicking the middle **New project ...** button or **File > New Project**.
-After creating the project, there are some new windows on the screen, click on the left panel and switch it to the **Resources tab**, inside the window on the tree structure. Now click on your board and it will open the **Boards configuration page**.
+After creating the project, there are some new windows on the screen; click on the left panel and switch it to the **Resources tab** inside the window on the tree structure. Now click on your board, it will open the **Boards configuration page**.
-### 4. Download the Runtime
+### 3. Download the Runtime
+
+The board needs to run a specific program (runtime) to interact with the **PLC IDE**. Go to the **"Other"** section below the **"Device Info"** block.
+
+Plug your device to the computer, select your board's Serial Port, and click the **Download** button.
-The board needs to run a specific program (runtime) in order to interact with the **PLC IDE**. Go to the **"Other"** section below the **"Device Info"** block.
+
-Plug your device to the computer, select the Serial Port of your board and click the **Download** button.
+***Download the runtime every time you update the PLC IDE from a previous version.***
-***The device will show up two Serial Ports, the default one (generally with the lowest number) is the usual Serial Port, the secondary one (usually with the highest number) is a virtual port for Modbus communication from the device to your computer. Take note of the port number assigned to the secondary port (virtual port for Modbus) as it will be needed in a second step.***
+***The device will show two Serial Ports: the default (generally with the lowest number) is the usual Serial Port. The secondary one (usually with the highest number) is a virtual port for Modbus communication from the device to your computer. Please take note of the port number assigned to the secondary port (virtual port for Modbus), as it will be needed in a second step.***
-If during the download procedure the following message appears, double-tap the reset button using the tip of a pen or a similar pointed object. The LED above the reset button will start blinking indicating that the Opta™ is ready to be flashed with a new firmware. Click the **Download** button to start the process again.
+If the following message appears during the download procedure, double-tap the reset button using the tip of a pen or a similar pointed object. The LED above the reset button for Opta™ or the Digital Outputs LEDs for Portenta Machine control will start blinking, indicating that the device is ready to be flashed with new firmware. Click the **Download** button to begin the process again.
-### 5. Connect to the Device
+### 4. Connect to the Device
After the runtime is up and running, set up the communication by going to **On-line > Set up communication**.
-On the new pop-up window open the properties of the Modbus protocol.
+On the new popup window, open the properties of the Modbus protocol.
-Make sure the Modbus protocol is using the secondary Serial port number, the Modbus Virtual port you took note of before. Press OK.
+Ensure the Modbus protocol uses the secondary Serial port number, the Modbus Virtual port you noted before. Press OK.
@@ -129,12 +158,11 @@ Click OK to save the settings and press the connect button on **On-line > Connec
-### 6. License Activation with Product Key (Portenta Machine Control)
+### 5. License Activation with Product Key (Portenta Machine Control)
-If the communication is successful the main panel will show the license section to be filled in and a status indicator.
+If the communication is successful, the main panel will show the license section to be filled in and a status indicator.
#### Online Activation
-
To use your product license, paste the key in the blank next to **Product Key** and press the **Activate** button.
@@ -144,12 +172,11 @@ After you click the **Activate** button, the IDE will bind the license to the ha
-Once the product has been activated, it is recommended to get the **Hardware-ID** of your device.
+Once the product has been activated, getting the **Hardware-ID** of your device is recommended.
#### Offline Activation
-
-To activate the product **Offline**, deselect the "Online" slider and the scenario below will show up:
+To activate the product **Offline**, deselect the "Online" slider, and the scenario below will show up:
@@ -157,31 +184,31 @@ Follow the instructions provided using our Contact [form](https://www.arduino.cc
Once you receive the **Activation file**, drag and drop the file in the dashed rectangle or select it from the folder where it is stored to complete your Offline Activation.
-### 7. License Activation with Pre-Licensed Products (Opta™)
+### 6. License Activation with Pre-Licensed Products (Opta™)
When a product is **Pre-licensed**, the following scenario will be displayed:
-By clicking the **Activate PLC Runtime** button, the product activation will be completed and the PLC **Status** will be set as OK:
+Make sure your device is already connected to the computer and click the **Activate PLC Runtime** button, the product activation will be completed, and the PLC **Status** will be set as OK:
-Now the product is ready to be used with the PLC IDE.
+Now, the product is ready to be used with the PLC IDE.
-### 8. Activation Recovery
+### 7. Activation Recovery
In case the hardware is being reflashed and the key got lost, the license can be recovered just by clicking the "**Forgot your Product Key?**" button:
-The IDE will then connect to a server, validate the hardware and recover the activation, showing a confirmation pop-up when done:
+The IDE will then connect to a server, validate the hardware, and recover the activation, showing a confirmation popup when done:
-### 9. Getting the Hardware-ID of Your Device
+### 8. Getting the Hardware-ID of Your Device
-To do it follow the next steps:
+The hardware ID of your device is an important number to save in case you have problems with the divide or your PLC IDE license. To get the unique Hardware-ID of your device, follow the next steps:
- Be sure that your device is disconnected from the Arduino PLC IDE
- Open the **Arduino IDE** software
@@ -189,24 +216,24 @@ To do it follow the next steps:
- Go to **Tools** > **Port** to select the proper port (the default one shown before in the PLC IDE inside the **Arduino PMC Configuration** > **Other** section)
- Go to **Tools** > **Serial Monitor** and reset the board. Look at the end of the boot report to find the "Hardware-ID" and store it in a safe place.
-### 10. Download a Program
+### 9. Download a Program
Let's download and run the first program on your device. We are going to use the default program that is included in a project: a counter.
-Double-click on the file _main_ inside the _Project_ to see the counter program. To download that program to your PLC, it is needed to compile the program and send it to the target device.
+Double-click on the file _main_ inside the _Project_ to see the counter program. To download that program to your PLC, you must compile it and send it to the target device.
-### 11. Communication Test
+### 10. Communication Test
-Open the **Watch** window by clicking on "View > Tool Windows > Watch", it will attach a new window on the right side called **Watch**. This window shows the real-time variables value.
+Open the **Watch** window by clicking "View > Tool Windows > Watch". It will attach a new window on the right side called **Watch**. This window shows the real-time variables value.
-To add a new variable to be watched you can click the **Insert new item** button inside the window, it will open a popup window, on the name label insert "cnt", and on the location "main", click OK and it will add the variable `cnt` from the `main` program on the table or drag and drop the `cnt` variable from the **Project** tree or from the **Main** program.
+To add a variable to be watched, click the **Insert new item** button inside the window. It will open a popup window; on the name label, insert "cnt" and click OK on the location "main". It will add the variable `cnt` from the `main` program on the table or drag and drop the `cnt` variable from the **Project** tree or from the **Main** program.
-Select the **Watch** window and click on the **Start/Stop watch button** unless the value of the variable is already getting updated.
+Select the **Watch** window and click on the **Start/Stop watch button** unless the variable's value is already getting updated.
## Conclusions
-In this tutorial, we went through how to set up the Portenta Machine Control or Opta™ with the Arduino IDE lab, learned how to connect the board to the program through Modbus, activate the hardware license of your product, and create a simple sketch with one variable that went compiled and downloaded inside the board. Finally, we learned how to see the values of the variables in real-time using the **Watch** window.
+In this tutorial, we went through how to set up the Portenta Machine Control or Opta™ with the Arduino IDE lab, learned how to connect the board to the program through Modbus, activate the hardware license of your product, and create a simple sketch with one variable that went compiled and downloaded inside the board. Finally, we learned how to see the values of the variables in real time using the **Watch** window.
-Now that your board is up and running with the Arduino PLC IDE, you can start to create your own professional solutions.
\ No newline at end of file
+You can create professional solutions now that your board is running with the Arduino PLC IDE.
\ No newline at end of file