[PC-1782] - Opta Family Electrical Terminals Cable Size (Documentation) (#2080)

* Content update (Opta's user manual)

* Content update (wiring specifications information)

* Content update (tech specs table update)

* Content update (datasheet revision table)

* Content update (datasheet)

* Content update (datasheet)

* Small format fix

---------

Co-authored-by: jcarolinares <[email protected]>

Author: canchebagur

content/hardware/07.opta/opta-family/opta/datasheet/datasheet.md

@@ -464,6 +464,23 @@ Arduino Opta® is designed for industrial standard machinery control as a PLC wi
 
 **Note:** The LED above the *User Programmable button* (Ref: 3D) is only available on Arduino Opta® WiFi (AFX00002).
 
+### Wiring Specifications
+
+Following Opta's wiring specifications is important to ensure proper connection and operation of its electrical terminals. The tables shown below provide recommendations for torque application, cable preparation, and accepted wire types of Opta's electrical terminals.
+
+#### Recommended Torque and Cable Preparation
+
+| **Torque** |     **Recommended Tool**     | **Stripping Length** |
+|:----------:|:----------------------------:|:--------------------:|
+|  0.80 Nm  | #1 Phillips-head screwdriver |         9 mm         |
+
+#### Accepted Wire Types
+
+|    **Wire Type**   | **Minimum Size** |           **Maximum Size**          |
+|:------------------:|:----------------:|:-----------------------------------:|
+|   Solid Conductor  | 0.5 mm² (20 AWG) |  6 mm² (10 AWG)/2x4 mm² (2x12 AWG)  |
+| Stranded Conductor | 0.5 mm² (20 AWG) | 4 mm² (12 AWG)/2x2.5 mm² (2x14 AWG) |
+
 ### Microcontroller
 The microcontroller is a dual-core *STM32H747XI*. The main processor is a *Cortex®-M7* running at up to 480 MHz and the second one is a Cortex®-M4 running at up to 240 MHz.
 
@@ -516,6 +533,8 @@ A pushbutton is accessible on the front panel of the Arduino Opta®. The functio
 ### Functional Earth
 To avoid and reduce electrical noise, Arduino Opta® has a *Functional Earth* connector (Ref: 3G) near the Ethernet connector. *Functional Earth*, not to be confused with *Ground*, helps the device to reduce electrical interferences in industrial environments, being crucial for having stable Fieldbus communications.
 
+<div style="page-break-after:always;"></div>
+
 ## Device Operation
 ### Getting Started - IDE
 If you want to program your Arduino Opta® while offline you need to install the Arduino® Desktop IDE **[1]**. To connect the Arduino Opta® to your computer, you will need a USB-C® cable.
@@ -537,8 +556,6 @@ Sample sketches for Arduino Opta® can be found either in the “Examples” men
 ### Online Resources
 Now that you have gone through the basics of what you can do with the device, you can explore the endless possibilities it provides by checking exciting projects on ProjectHub **[6]**, the Arduino® Library Reference **[7]** and the online store **[8]** where you will be able to complement your Arduino Opta® product with additional extensions, sensors and actuators.
 
-<div style="page-break-after: always;"></div>
-
 ## Mean Time Between Failure (MTBF)
 
 MTBF, which stands for Mean Time Between Failure, is calculated according to statistical device failures and indicates the reliability of a device.
@@ -553,9 +570,8 @@ The MTBF figure (in hours/years) for each Arduino Opta® variant can be found in
 
 ## Mechanical Information
 ### Product Dimensions
-![Arduino Opta® Outline. Dimensions are in mm](assets/opta_mechanical.svg)
 
-***Note: Terminals can be used with both solid and stranded core wire (min: 0.5 mm<sup>2</sup> / 20 AWG).***
+![Arduino Opta® Outline. Dimensions are in mm](assets/opta_mechanical.svg)
 
 ## Certifications
 
@@ -762,9 +778,10 @@ Hereby, Arduino S.r.l. declares that this product is in compliance with essentia
 
 ## Revision History
 
-| Date       | **Revision** |     **Changes**    |
-|------------|:------------:|:------------------:|
-| 07/02/2023 |       4      |  MTBF information  |
-| 16/05/2023 |       3      |    Legal updates   |
-| 13/04/2023 |       2      | Tech Specs Updates |
-| 02/03/2023 |       1      |    First Release   |
+|  **Date**  | **Revision** |      **Changes**      |
+|:----------:|:------------:|:---------------------:|
+| 24/07/2024 |       5      | Wiring specifications |
+| 07/02/2023 |       4      |    MTBF information   |
+| 16/05/2023 |       3      |     Legal updates     |
+| 13/04/2023 |       2      |   Tech Specs Updates  |
+| 02/03/2023 |       1      |     First Release     |

content/hardware/07.opta/opta-family/opta/downloads/AFX00001-AFX00002-AFX00003-datasheet.pdf

@@ -46,3 +46,12 @@ Secure element: ATECC608B
 Programming:
   Arduino programming language: Via Arduino IDEs, Arduino CLI, Arduino Web Editor
   IEC-61131-3: Ladder Diagram (LD), Function Block Diagram (FBD), Sequential Function Chart (SFC), Structured Text (ST), Instruction List (IL)
+Wiring Specifications:
+  Recommended torque: 0.80 Nm
+  Recommended tool: "#1 Phillips-headscrewdriver"
+  Stripping length: 9 mm
+  Wire type:
+    Solid conductor minimum size: 0.5 mm² (20 AWG)
+    Solid conductor maximum size: 6 mm² (10 AWG)/2x4 mm² (2x12 AWG)
+    Stranded conductor minimum size: 0.5 mm² (20 AWG)
+    Stranded conductor maximum size: 4 mm² (12 AWG)/2x2.5 mm² (2x14 AWG)

content/hardware/07.opta/opta-family/opta/tech-specs.yml

@@ -189,6 +189,23 @@ Opta™ has an **onboard USB®-C port** that can be used for programming the dev
 
 This user manual section covers Opta's electrical terminals, showing their main hardware and software characteristics. Opta™ has 12 electrical terminals, four of which can be used for the power supply of the device, and eight of them can be used as digital/analog inputs.
 
+### Wiring Specifications
+
+Following Opta's wiring specifications is important to ensure proper connection and operation of its electrical terminals. The tables shown below provide recommendations for torque application, cable preparation, and accepted wire types of Opta's electrical terminals. 
+
+#### Recommended Torque and Cable Preparation
+
+| **Torque** |     **Recommended Tool**     | **Stripping Length** |
+|:----------:|:----------------------------:|:--------------------:|
+|  0.80 Nm  | #1 Phillips-head screwdriver |         9 mm         |
+
+#### Accepted Wire Types
+
+|    **Wire Type**   | **Minimum Size** |           **Maximum Size**          |
+|:------------------:|:----------------:|:-----------------------------------:|
+|   Solid Conductor  | 0.5 mm² (20 AWG) |  6 mm² (10 AWG)/2x4 mm² (2x12 AWG)  |
+| Stranded Conductor | 0.5 mm² (20 AWG) | 4 mm² (12 AWG)/2x2.5 mm² (2x14 AWG) |
+
 ### Power Supply
 
 As shown in the image below, the first four terminals, from left to right, are Opta's power supply terminals; two are marked with `+` signs and two with `-` signs. An external +12 VDC to +24 VDC power supply can be connected to these terminals.