Arduino PLC IDE - Launch (Tutorials + Software Page) (#713)

* Software: Add PLC-IDE page [PC-1038] (#209)

* Update paragraph (#228)

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

* PLC IDE Tutorials [PC-1041, PC-1003] (#219)

* PLC IDE setup guide [PC-974] (#172)

Co-authored-by: Ali Jahangiri <[email protected]>
Co-authored-by: Fr4ng <[email protected]>
Co-authored-by: BenjaminDannegård <[email protected]>

* Fix naming

* PLC IDE: Programming with IEC standard languages introdution [PC-975] (#174)

Co-authored-by: BenjaminDannegard <[email protected]>
Co-authored-by: Fr4ng <[email protected]>

* Move setup tutorial to correct folder

* Fix and align metadata

* Create Pin Mapping for PMC on the Arduino PLC IDE [PC-1002] (#189)

Co-authored-by: Julián Caro Linares <[email protected]>

* Empty-Commit

* PLC IDE + PMC, Pin Map tutorial: Small tweaking [PC-1050] (#225)

* Small tweaking

* Minor rewording

* Pin Map bold

* Tweak explanation

* map table bold

* Update content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/plc-ide-pin-mapping/content.md

Co-authored-by: Julián Caro Linares <[email protected]>

* Re-order, rename headings

* Title case

* Update content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/plc-ide-pin-mapping/content.md

Co-authored-by: Julián Caro Linares <[email protected]>

* Requirements rewording

Co-authored-by: Julián Caro Linares <[email protected]>

* Add symlinks to the software page

* Update license and PLC IDE links

* Add 2 executables info

* PLC-IDE CAN set up [PC-1000] (#227)

* First commit

* Lint and remove tags

* Fix typo

* Apply suggestions from code review

Co-authored-by: Julián Caro Linares <[email protected]>

* Fix typo, title case and next-step paragraph

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

* Add paragraph from feedback

* Hide settings list

Co-authored-by: Julián Caro Linares <[email protected]>

* PLC-IDE ModBus set up [PC-1001] (#215)

* First commit

* Add screenshot

* MD fixes

* Lint fix and added RTU naming

* Lint fix

* PLC IDE + PMC ModBus: tutorial fix (#226)

* Added ModBus TCP

* Add modbus node configration

* MD fixes

* assets fix

* Empty-Commit

* Fix overview

* Add TCP and move Parametrization section

* Add ethernet note

* ModBus capitalization

* Add software metadata

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

* Add symlinks

Co-authored-by: Ali Jahangiri <[email protected]>
Co-authored-by: Fr4ng <[email protected]>
Co-authored-by: BenjaminDannegård <[email protected]>
Co-authored-by: Julián Caro Linares <[email protected]>
Co-authored-by: canchebagur <[email protected]>

* PLC IDE launch, fixes (#229)

* Fix software metadata

* Update CAN tutorial

* Fix ModBus tutorial

Co-authored-by: Pablo Marquínez Ferrándiz <[email protected]>
Co-authored-by: Sebastian Romero <[email protected]>
Co-authored-by: Ali Jahangiri <[email protected]>
Co-authored-by: Fr4ng <[email protected]>
Co-authored-by: BenjaminDannegård <[email protected]>
Co-authored-by: Julián Caro Linares <[email protected]>
Co-authored-by: canchebagur <[email protected]>

Author: 8 people

content/hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control/tutorials/can-setup/assets/CAN-configuration-add-catalog.png

@@ -0,0 +1,141 @@
+---
+title: 'CAN Bus Setup with Arduino PLC IDE'
+description: 'This tutorial will show you how to set up the CAN bus communication with the Arduino PLC IDE.'
+tags:
+  - PLC
+  - CAN
+author: 'Pablo Marquínez'
+hardware:
+  - hardware/05.pro-solutions/solutions-and-kits/portenta-machine-control
+software:
+  - plc-ide
+---
+
+## Overview
+
+The Arduino Portenta Machine Control has the **TJA1049T** CAN transceiver which allows to use the **Controller Area Network (CAN) protocol** communication.
+
+### What Is CAN
+
+CAN is the acronym used for Controlled Area Network. This protocol was developed to be used on automotive and industrial applications to communicate with precise and critical demanding sensors. 
+
+The main advantages of the CAN bus protocol are:
+
+* **Reduced wiring:** The CAN communication only uses two wires, creating a bus communication where all the devices of the network are connected. This is a huge advantage for industrial applications, like the automotive one, where we can connect all the electronic components of a car to the same network using only two wires, saving cost, materials, and simplifying the programming and manufacturing process.
+
+* **Fast speed communication:** The CAN protocol is one of the most used communication protocols in the industry not only for its simplicity but also for its speed rates.
+
+* **Strength and reliability:** Thanks to the twisted pair cables and the differential signal between them, the CAN bus protocol protects the data against electrical noise in industrial environments keeping the critical information safe and without data losses.
+
+Structure of a CAN network:
+* **Main device:** Main controller or orchestrator of the communication. It interacts with the rest of the devices on the network, sending and receiving data from them. It usually is a controller device like the Portenta Machine control.
+* **Node or ECU (Electronic Control Unit):** Devices capable of interacting on the data bus. Although every device on the network can listen to the data that is being transferred on the bus each device has an unique number (ID) to communicate with that is included in every message, ignoring the messages that do not match their ID. However, all the nodes have access to the messages of the network, being possible for a node to read and use the data from another node if necessary.
+
+CAN has built-in error detection so the application can handle its own errors in case of data loss (like CRC).
+
+## Goals
+
+- Set up the Portenta Machine Control with the Arduino PLC IDE
+- Configure the CAN communication inside the IDE
+
+## Required Hardware and Software
+
+- [Arduino Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control) board
+- [Arduino PLC IDE](../../software/plc-ide) license
+
+## Set Up
+
+### Software
+
+In order to configure the Portenta Machine Control you will need to connect to the device through the Arduino PLC IDE:
+
+1. Connect the device to the computer through USB
+2. Click "Connects to the target" button on the PLC IDE
+
+***The device needs to be activated with a license, check the steps on the [PLC IDE Set-up tutorial](./plc-ide-setup-license)***
+
+### Hardware
+
+In order to use the CAN communication, you will need to:
+1. Supply the board with 24V DC, through the 24VIn and GND
+2. Connecting the CANH, CANL, and GND with a CAN Device
+
+![Header pinout for CAN communication](assets/PMC-CAN-pins.svg)
+
+## Enable The CAN Communication
+
+Inside the Arduino PLC IDE navigate to the left side panel and click on the "Resources" tab.
+
+![Arduino PLC IDE Resources panel, -> CANopen CAN0](assets/CAN-configuration.png)
+
+### CANopen Configuration
+
+To configure in depth the settings you need to add the **Generic CANopen device** from the item's catalog.
+
+![Add Items to CANopen's resource](assets/CAN-configuration-add.png)
+
+![Item from the catalogue](assets/CAN-configuration-add-catalog.png)
+
+Once the **Generic CANOpen device** has been added you can customize the configuration to comply your needs.
+
+![CANopen configuration window](assets/CAN-configuration-general.png)
+
+<!--
+Below, you will find an enumeration of the options located in each of the CAN configuration tabs and windows.
+
+#### Network Settings Tabs
+
+* Node number
+* Node Guard Period(ms)
+* Life time factor
+* Boot time elapsed
+* Wait boot-up message
+* Node heartbeat producer time
+* Node heartbeat consumer time
+* Master heartbeat consumer time
+* Mandatory
+* Identify Object Check
+
+#### PDO Mapping
+
+* PDO Auto Mapping
+
+#### PDO Tx Communication Settings Tab
+Modes:
+* User Defined Mode
+* Sync Mode
+* Event mode
+* Cyclic mode
+
+#### PDO Rx Communication Settings Tab
+Modes:
+* User Defined Mode
+* Sync Mode
+* Evemt Mode
+-->
+
+### Parametrization Tab
+
+![CANopen objects mapping table](assets/CAN-configuration-parametrization.png)
+
+This window allows to create objects and set the addresses, this is called a mapped variable table.
+
+### PDO Tables
+
+This table customize the PDO (Process Data Object) dictionary, so you will set the variables for the information that you want to have usually cause they are time-critical, any device can overwrite those addresses, so it acts like shared variables.
+
+You can edit the table by adding, removing new variables, you can also assign and unassign existing variables on your programs (Global Variables) to this table.
+
+#### PDO Tx Input Tab
+
+![CANopen PDO Tx configuration](assets/CAN-configuration-pdo-tx.png)
+
+#### PDO Rx Output Tab
+
+![CANopen PDO Rx configuration](assets/CAN-configuration-pdo-rx.png)
+
+### Next Steps
+
+Now that you have completed the setup of the Portenta Machine Control and its CAN bus communication with the Arduino PLC IDE, you can continue with:
+- Plug a CAN sensor to your device and get its data.
+- Expand your CAN bus network with more nodes sending and receiving messages from each one of them.