[PC-1602] Multiple changes on Opta (#1805)

jcarolinares · TaddyHC · web-flow · commit 63ac1c819a48 · 2024-03-11T20:05:08.000+01:00
* Multiple changes on Opta

* Small but important fixes and improvements detected after Docs 2.0 web launch

* Update content/hardware/07.opta/opta-family/opta/tutorials/02.getting-started-with-rs485/content.md

Co-authored-by: TaddyHC &lt;94547080+TaddyHC@users.noreply.github.com&gt;

* Update content/hardware/07.opta/opta-family/opta/tutorials/02.getting-started-with-rs485/content.md

Co-authored-by: TaddyHC &lt;94547080+TaddyHC@users.noreply.github.com&gt;

* Update content/hardware/07.opta/opta-family/opta/tutorials/03.getting-started-with-modbus-rtu/content.md

Co-authored-by: TaddyHC &lt;94547080+TaddyHC@users.noreply.github.com&gt;

* Apply suggestions from code review

Suggestion from Taddy's review added

Co-authored-by: TaddyHC &lt;94547080+TaddyHC@users.noreply.github.com&gt;

---------

Co-authored-by: TaddyHC &lt;94547080+TaddyHC@users.noreply.github.com&gt;
diff --git a/content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/pmc-opta-temp-ctrl/content.md b/content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/pmc-opta-temp-ctrl/content.md
@@ -43,9 +43,9 @@ The system will send the temperature values from the Portenta Machine Control to
 ### Hardware Requirements
 
 - [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control) (x1)
-- [Opta™ with RS-485](https://store.arduino.cc/collections/home-industrial-automation) (x1)
-- Micro-USB cable (x1)
-- USB-C® cable (x1)
+Opta™ PLC with RS-485 support: [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
+- [Micro-USB cable](https://store.arduino.cc/products/usb-cable-type-a-male-to-micro-type-b-male) (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - PT100 RTD (x1)
 
 ### Software Requirements
diff --git a/content/hardware/07.opta/opta-family/opta/product.md b/content/hardware/07.opta/opta-family/opta/product.md
@@ -4,7 +4,7 @@ url_shop: https://store.arduino.cc/collections/pro-family
 url_guide: /tutorials/opta/user-manual
 primary_button_url: /tutorials/opta/user-manual
 primary_button_title:  User Manual
-secondary_button_url: /software/plc-ide/tutorials/plc-ide-setup-license
+secondary_button_url: /software/plc-ide/
 secondary_button_title: PLC IDE Guide
 core: arduino:mbed_opta
 certifications: [CE, UL, FCC, UKCA]
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/01.user-manual/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/01.user-manual/content.md
@@ -21,12 +21,14 @@ software:
 
 This user manual will provide a comprehensive overview of Opta™, covering its major hardware and software elements. With this user manual, you will learn how to set up, configure, and use all the main features of an Opta™ device. 
 
+![ ](hero-banner.png)
+
 ## Hardware and Software Requirements
 
 ### Hardware Requirements
 
 - [Opta™ Lite](https://store.arduino.cc/products/opta-lite), [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
-- USB-C® cable (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - +12-24 VDC/0.5 A power supply (x1)
 
 ### Software Requirements
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/02.getting-started-with-rs485/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/02.getting-started-with-rs485/content.md
@@ -29,10 +29,10 @@ This tutorial will show the steps to connect two Opta™ devices via RS-485 and
 
 ### Required Hardware and Software
 
-- Opta™ PLC with RS-485 support (x2)
-- 12-24VDC/1A power supply (x1)
+- Opta™ PLC with RS-485 support: [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x2)
+- 12-24 VDC / 1 A power supply (x1)
 - 24AWG twisted-pair cable (used for electrical connections)
-- USB-C® cable (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - [Arduino IDE 1.8.10+](https://www.arduino.cc/en/software), [Arduino IDE 2](https://www.arduino.cc/en/software), or [Arduino Web Editor](https://create.arduino.cc/editor)
 - [ArduinoRS485 library](https://www.arduino.cc/reference/en/libraries/arduinors485/)
 - [RS-485 example code](assets/Opta_RS485_Example.zip)
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/03.getting-started-with-modbus-rtu/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/03.getting-started-with-modbus-rtu/content.md
@@ -36,12 +36,12 @@ The Modbus RTU protocol is one of the protocols available within Opta™. In thi
 
 ### Hardware Requirements
 
-- Opta™ PLC with RS-485 support (x2)
-- 12VDC/1A DIN rail power supply (x1)
-- USB-C® cable (x1)
-- Wire with either specification for RS-485 connection (x3):
-- STP/UTP 24-18AWG (Unterminated) 100-130Ω rated
-- STP/UTP 22-16AWG (Terminated) 100-130Ω rated
+- Opta™ PLC with RS-485 support: [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x2)
+- 12 VDC / 1 A DIN rail power supply (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
+- Wire with either specification for RS-485 connection (x3)
+- STP/UTP 24-18AWG (Unterminated) 100-130 Ω rated
+- STP/UTP 22-16AWG (Terminated) 100-130 Ω rated
 
 ### Software Requirements
 
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/04.getting-started-with-interrupts/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/04.getting-started-with-interrupts/content.md
@@ -31,7 +31,7 @@ The **interrupt**, a basic yet vital feature, is available on Opta™ to handle
 #### Hardware Requirements
 
 - [Opta™ Lite](https://store.arduino.cc/products/opta-lite), [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
-- USB-C® cable (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - +12-24 VDC/0.5 A power supply (x1)
 
 #### Software Requirements
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/06.opta-azure-iot-tutorial-en/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/06.opta-azure-iot-tutorial-en/content.md
@@ -29,8 +29,8 @@ This tutorial demonstrates the integration of Opta™ with Azure IoT. You will p
 
 ### Required Hardware
 
-- [Opta™](https://store.arduino.cc/collections/pro-family) (x1)
-- USB-C® cable (x1)
+- [Opta™ Lite](https://store.arduino.cc/products/opta-lite), [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 
 ### Required Software
 
@@ -208,7 +208,7 @@ In the code, it is set to 300,000 milliseconds or 5 minutes:
 ```
 You can customize the value in milliseconds to change the time interval between sending messages.
 
-In the **Azure_IoT_Hub_Opta.ino** file, you find a portion of code represented by the **generateTelemetry()** function at line 329, which is called to allow sending the message to Azure IoT:
+In the **Azure_IoT_Hub_Opta.ino** file, you will find a portion of code represented by the **generateTelemetry()** function at line 329, which is called to allow sending the message to Azure IoT:
 
 ![Opta™ Azure IoT Tutorial Sketch - Telemetry payload](assets/opta-azure-iot-tutorial-202627.png)
 
@@ -261,4 +261,4 @@ In conclusion to this tutorial, we have explored and customized a sample sketch
 - **Integration with Azure IoT Hub:** We illustrated the process of configuring the definitions in the `iot_configs.h` file, which manages Wi-Fi connection and communication with Azure IoT Hub.
 - **Code Customizations:** We provided guidance on further customizing the code, including adjusting the telemetry message sending interval and modifying the simulated data sent to Azure IoT.
 
-The tutorial provides a detailed guide to connect Opta™ to Azure IoT, allowing the secure and reliable transmission of data. This is just a starting point, and further customizations can be made based on the specific needs of the project. In case you want to dig deeper into the Azure IoT technology, check the [Azure IoT official documentation](https://learn.microsoft.com/en-us/azure/iot/).fSA
+The tutorial provides a detailed guide to connect Opta™ to Azure IoT, allowing the secure and reliable transmission of data. This is just a starting point, and further customizations can be made based on the specific needs of the project. In case you want to dig deeper into the Azure IoT technology, check the [Azure IoT official documentation](https://learn.microsoft.com/en-us/azure/iot/).
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/08.memory-partitioning/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/08.memory-partitioning/content.md
@@ -34,7 +34,7 @@ In this tutorial, we will learn how to partition the memory of an Opta™ device
 
 ### Hardware Requirements
 
-- [Opta™](https://store.arduino.cc/collections/pro-family) (x1)
+- [Opta™ Lite](https://store.arduino.cc/products/opta-lite), [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
 - USB-C® cable (x1)
 
 ### Software Requirements
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/10.opta-modbus-tcp-plc-ide/content.md
@@ -34,7 +34,7 @@ In this tutorial, you will learn how to implement Modbus TCP based communication
 ### Hardware Requirements
 
 - [Opta™](https://store.arduino.cc/collections/pro-family) (x2)
-- USB-C® cable (x2)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x2)
 - RJ-45 LAN cable (x3)
 - Ethernet Switch (Recommended) (x1)
 
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/13.energy-management-application-note/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/13.energy-management-application-note/content.md
@@ -43,14 +43,14 @@ Below is a visual representation of the intended application:
 
 ### Hardware Requirements
 
-- Opta™ PLC with RS-485 support (x1)
-- USB-C® cable (x1)
+- Opta™ PLC with RS-485 support: [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - 7M.24 Energy meter (x1)
 - Solar panel with respective system (Controller, battery, and inverter) or similar power system
-- Domestic appliance or devices of interest
+- Domestic appliances or devices of interest
 - RS-485 connection wire as recommended by the standard specification (x3):
-- STP/UTP 24-18AWG (Unterminated) 100-130Ω rated
-- STP/UTP 22-16AWG (Terminated) 100-130Ω rated
+- STP/UTP 24-18AWG (Unterminated) 100-130 Ω rated
+- STP/UTP 22-16AWG (Terminated) 100-130 Ω rated
 
 ### Software Requirements
 
@@ -87,7 +87,7 @@ The provided code showcases the capabilities of Opta™ as described earlier. It
 
 The code requires the inclusion of specific headers. These headers enable the RS-485 interface, the Modbus RTU protocol, the Arduino Cloud connection, and the scheduler. The scheduler oversees data exchange through the RS-485 interface using the Modbus RTU protocol. Moreover, it includes the parameters essential for stable communication, adhering to Modbus RTU standards.
 
-```arduino
+```arduino 
 #include "stm32h7xx_ll_gpio.h"
 #include "thingProperties.h"
 #include <ArduinoModbus.h>
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/14.tank-level-app-note/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/14.tank-level-app-note/content.md
@@ -46,16 +46,16 @@ The Big Tank has at least twice the capacity of the Small Tank in the experiment
 
 ### Hardware Requirements
 
-- Opta™ PLC with RS-485 support (x2)
-- USB-C® cable (x2)
+- Opta™ PLC with RS-485 support: [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x2)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x2)
 - Vertical float switch (x2)
 - Horizontal float switch (x2)
-- 12VDC NC 2/2-Way direct acting solenoid or motorized ball valve (x1)
-- 12VDC liquid pump (x1)
-- 12VDC DIN rail power supply (x1)
+- 12 VDC NC 2/2-Way direct-acting solenoid or motorized ball valve (x1)
+- 12 VDC liquid pump (x1)
+- 12 VDC DIN rail power supply (x1)
 - Recommended wire specification for RS-485 connection (x3):
-- STP/UTP 24-18AWG (Unterminated) 100-130Ω rated
-- STP/UTP 22-16AWG (Terminated) 100-130Ω rated
+- STP/UTP 24-18AWG (Unterminated) 100-130 Ω rated
+- STP/UTP 22-16AWG (Terminated) 100-130 Ω rated
 
 ### Software Requirements
 
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/15.home-automation-application-note/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/15.home-automation-application-note/content.md
@@ -39,15 +39,16 @@ This application note shows a home automation system based on an Opta™️, cap
 
 ### Hardware Requirements
 
-- Opta™️ PLC with wireless connectivity support (x1)
+- [Opta™️ PLC with wireless connectivity support](https://store.arduino.cc/products/opta-wifi) (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
+- 12 V / 30 RPM DC motor (x1)
 
-- USB-C® cable (x1)
-- 12V/30 RPM DC motor (x1)
 - Full-bridge motor driver (x1)
 - A 3D printed case for the DC motor and its driver (.stl files of the case can be downloaded here)
 - Normally Open (NO) Single Pole Double Throw (SPDT) limit switch (x2)
 - 24AWG twisted-pair cable (for electrical connections)
-- 12V/2A DC power supply (x1)
+- 12 V / 2 A DC power supply (x1)
+
 
 ### Software Requirements
 
diff --git a/content/hardware/07.opta/opta-family/opta/tutorials/16.mac-address/content.md b/content/hardware/07.opta/opta-family/opta/tutorials/16.mac-address/content.md
@@ -29,8 +29,8 @@ The Media Access Control (MAC) address is essential for computer networking and
 
 ### Hardware Requirements
 
-- [Opta™](https://store.arduino.cc/collections/pro-family) (any variant) (x1)
-- USB-C® cable (x1)
+- [Opta™ Lite](https://store.arduino.cc/products/opta-lite), [Opta™ RS485](https://store.arduino.cc/products/opta-rs485), or [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1) (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 
 ### Software Requirements
 
diff --git a/content/software/plc-ide/tutorials/plc-ide-cloud-support/content.md b/content/software/plc-ide/tutorials/plc-ide-cloud-support/content.md
@@ -30,7 +30,7 @@ In this comprehensive tutorial, you will learn how to integrate and utilize the
 ### Hardware Requirements
 
 - [Opta™ WiFi](https://store.arduino.cc/products/opta-wifi) (x1)
-- USB-C® cable (x1)
+- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
 - Analog sensor (Optional)
 
 ### Software Requirements
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
@@ -34,7 +34,7 @@ This tutorial will show you how to connect the Portenta Machine Control and Opta
 
 ## Required Hardware and Software
 
-- Board compatible with the Arduino PLC IDE (Portenta Machine Control or Opta™).
+- 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.
