Using PLC IDE With Arduino Cloud

Overview

The Arduino PLC IDE offers multiple possibilities to expand the connectivity of your industrial applications. Integrating the PLC IDE with the Arduino Cloud allows you to create advanced HMI for your professional solutions that can be controlled in real time in multiple ways and on multiple devices.

This tutorial will guide you through integrating and using the Arduino Cloud with the Arduino PLC IDE. You will learn to connect your compatible devices and create a compact, Cloud-connected application using Opta™.

Goals

• Understand how the Arduino Cloud and the PLC IDE work together for seamless data exchange.
• Learn how to set up the workspace environment on the PLC IDE for use with the Arduino Cloud.
• Program a device using Opta™ as an example of integrating the PLC IDE and Arduino Cloud.

Hardware and Software Requirements

Hardware Requirements

• Opta™ WiFi (x1)
• USB-C® cable (x1)
• Analog sensor (Optional)

Software Requirements

• Arduino PLC IDE Installer

• 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.

• The Arduino Cloud will be required to perform remote actuation and status monitoring via Wi-Fi® connectivity using the sketch provided in the following section. If you do not have an account, you can create one for free inside cloud.arduino.cc.

• To ensure optimal Wi-Fi® connectivity on Opta™, please use the

  WiFiFirmwareUpdater

  to update to the latest network firmware version. This can be done by going to

  Examples -> STM32H747_System -> WiFiFirmwareUpdater

  on Arduino IDE 2.X. Additionally, please ensure that you have the latest Arduino Mbed OS Opta Boards version, which can be checked under

  Boards Manager

  .

• PLC IDE & Arduino Cloud integration example project file compatible with Opta™

This tutorial requires the latest version of the PLC IDE ( >= v 1.0.6 ). You can get the latest versions here. If it is your first time using the Arduino PLC IDE, we highly recommend you begin with Arduino PLC IDE Setup & Device License Activation tutorial.

PLC IDE & Arduino Cloud Integration

In this tutorial, we will use two separate platforms: the Arduino PLC IDE and the Arduino Cloud. Each tool brings unique features and capabilities that are required to our workflow.

• The Arduino PLC IDE integrates the capability to use IEC IEC61131-3 programming languages, which are Ladder Diagram (LD), Sequential Function Chart (SFC), Function Block Diagram (FBD), Structured Text (ST), and Instruction List (IL). All these languages can be used with Opta™.

  These PRO solutions include a wide set of standard features to develop industrial automation or advanced applications. You can find more tutorials related to the PLC IDE at the Arduino documentation page, and the latest version of the software can be downloaded here.

• The IoT Cloud is a platform that allows users to deploy IoT applications with ease and control parameters at any given moment. The platform provides robust security characteristics, of which Opta™ takes advantage to provide secure industrial application deployments. You can find more about Arduino Cloud here.

Understanding the Process

The PLC IDE supports seamless integration with Arduino Cloud, enabling IoT capabilities for its compatible devices. Thanks to this feature, the application field can be expanded with the needed security elements, ensuring stable industrial operations.

The structure comprises two elements:

• The PLC IDE defines the device program with its connectivity settings and designed tasks.
• The Arduino Cloud processes the exchange of information with the Arduino layer of the PRO solution devices.

The device is programmed in two layers: The PLC main execution program and the Arduino sketch. To communicate and interchange data safely between these two different program layers, the PLC IDE uses

Shared variables

The functions of each layer are:

• The PLC program layer will manage internal communication and data handling. It can be programmed to read sensor information obtained via selected Modbus protocol or available I/O pins and then, use that data to send to or receive from the Arduino sketch layer.

• The Arduino sketch will handle data exchange between the PLC program layer and the Arduino Cloud platform. The methods are PLCOut.varname and PLCIn.varname, which are used to access the shared variables. For the purpose of the tutorial and to easily classify these methods, we will replace the

  varname

  with the

  Shared_variable

  tag.

Therefore, the PLCOut.Shared_Variable and PLCIn.Shared_Variable methods manage the shared variables that facilitate the communication between the two systems:

• PLCOut.Shared_Variable: This variable refers to the data sent from the PLC program layer to the Arduino sketch layer, which will be sent to the Arduino Cloud.

  In other words, it represents the outputs from the PLC program. It could be sensor readings, status information, or any other data the PLC program is designed to generate and share.

• PLCIn.Shared_Variable: This variable refers to the data sent to the PLC from the Arduino sketch layer received from the Arduino Cloud platform.

  These are inputs for the PLC program. It could be commands, configuration data, or other information the Arduino Cloud system sends to control or interact with the PLC.

In most industrial IoT applications, the PLC program layer will directly control machinery or processes based on its programming. At the same time, the Arduino Cloud platform will be used as an HMI for operators, analytics, and remote control capabilities. The

Shared_Variables

Example Implementation

A demonstrative example will be used to show how both features are integrated. The example will consist of an Arduino Cloud dashboard and a PLC IDE project file configured for an Opta™ device.

Opta™ will be programmed to execute the following actions:

• Send analog readings and counter values from the device to the Arduino Cloud.
• The user programmable LED of Opta™ will be controlled via an interactive button found within the Arduino Cloud dashboard, which can later be designed to trigger certain actions.

The following diagram shows the main steps to connect Opta™ to the Arduino Cloud using the PLC IDE. In the following sections, you will find detailed instructions on how to perform all these steps.

The example implementation comprises the following sequence:

1. Setting up the Arduino Cloud
2. Setting up the PLC IDE
   1. Shared variables configuration
   2. Analog port & user programmable LED configuration
   3. Library management
3. Setting up the Arduino Cloud dashboard
4. System integration test

Setting Up the Arduino Cloud

We will begin by configuring the Arduino Cloud with Opta™ to create a Thing. It will have Opta™ registered with Cloud variables and a dashboard configured to perform different actions.

To learn more about how to use the Arduino Cloud, please take a look at Getting Started With the Arduino Cloud tutorial.

The following Cloud variables will be created:

The Cloud variables will subsequently be linked to the

Shared variables

analog01

counter

0

Once the Arduino Cloud Thing has been created successfully, we will have something similar to the following image:

We can now extract the code that will serve as the base for the Arduino sketch for Opta™ in the PLC IDE. The code can be accessed by going to the full editor. It will require some lines from the

ThingProperties.h

Please follow:

Things -> "Opta PLC IDE Cloud" Thing -> Sketch -> Open full editor

The base sketch of the example will be as follows:

1#include <ArduinoIoTCloud.h>
2#include <Arduino_ConnectionHandler.h>
3
4const char SSID[]     = "SECRET_SSID";    // Network SSID (name)
5const char PASS[]     = "SECRET_OPTIONAL_PASS";    // Network password (use for WPA, or use as key for WEP)
6
7void onCloudButtonChange();
8
9float analog01;
10int counter;
11bool cloudButton;
12
13WiFiConnectionHandler ArduinoIoTPreferredConnection(SSID, PASS);
14
15void setup() {
16  // Initialize serial and wait for port to open:
17  Serial.begin(9600);
18  // This delay gives the chance to wait for a Serial Monitor without blocking if none is found
19  delay(1500); 
20
21  // Defined in thingProperties.h
22  initProperties();
23
24  // Connect to Arduino Cloud
25  ArduinoCloud.begin(ArduinoIoTPreferredConnection);
26  
27  /*
28     The following function allows you to obtain more information
29     related to the state of network and IoT Cloud connection and errors
30     the higher number the more granular information you’ll get.
31     The default is 0 (only errors).
32     Maximum is 4
33 */
34  setDebugMessageLevel(2);
35  ArduinoCloud.printDebugInfo();
36}
37
38void loop() {
39  ArduinoCloud.update();
40  // Your code here 
41}
42
43void initProperties(){
44  ArduinoCloud.addProperty(analog01, READ, ON_CHANGE, NULL);
45  ArduinoCloud.addProperty(counter, READ, ON_CHANGE, NULL);
46  ArduinoCloud.addProperty(cloudButton, READWRITE, ON_CHANGE, onCloudButtonChange);
47}
48
49/*
50  Since CloudButton is READ_WRITE variable, onCloudButtonChange() is
51  executed every time a new value is received from IoT Cloud.
52*/
53void onCloudButtonChange()  {
54  // Add your code here to act upon CloudButton change
55}

Save this example template for later. We will now proceed with a demonstrative example to show you how to set up the PLC IDE to be connected to the Arduino Cloud "Thing" we just created.

Setting Up the PLC IDE

Before continuing with the PLC IDE configuration with Opta™, please remember to have the latest PLC IDE with its corresponding tools stated within Software Requirements.

The PLC IDE configuration will be important in establishing successful communication with the Arduino Cloud. It will require setting onboard features and the communication protocol for Opta™ as usual. However, a proper 'Shared variables' setting will define the communication outcome with the Arduino Cloud.

Thus, you will learn to configure the 'Shared variables' based on the peripherals and tasks you may assign to Opta™.

Shared Variables Configuration

The successful communication between Opta™ configured with PLC IDE and Arduino Cloud relies on the

Shared variables

Shared variables

Resources > Opta > Shared variables

The Inputs define the variables that will capture the data from the Arduino Cloud through the local Arduino sketch to Opta™ PLC main program runtime. The Arduino Cloud will send the compilation of variables accordingly.

Subsequently, the user programmable LED will be controlled via the Arduino Cloud dashboard. We will define a variable to be assigned later to update the LED state variable accordingly.

The

in_cloudButton

in

The Outputs define the variables that Opta™ will send to Arduino Cloud. It is the compilation of variables that you would want to monitor within the Arduino Cloud dashboard.

The analog port reading and the counter value of Opta™ are the information that we want to display on the Arduino Cloud dashboard. It can be programmed to use Modbus-compatible devices and use its information for further development.

The following table shows the variables added to the

Shared outputs

The shared output variables are indicated with an

out

• out_analog01

  : Analog port number one reading

• out_counter

  : Counter value

The same variable name is used to maintain variable relationship and simplicity with the Cloud variables we have previously defined here.

Depending on the project's development requirements, you can add all the variables that will be used to exchange information with the Arduino Cloud.

We will now configure the Opta™ device's features to link all these shared variables.

Analog Port Configuration

The analog port is configured using the following properties:

Resources > Opta > Local IO Mapping > Programmable Inputs

Opta™ has 8x I/O ports that can be programmed as analog or digital. You will select port number one and assign the

analog01

The

Programmable inputs mapping

You can also change the analog resolution between 12, 14, or 16 bits if needed.

User Programmable LED Configuration

The user programmable LED of Opta™ is configurable under

Resources > Opta > Local IO Mapping > LED Outputs

In this case, the

userLed

userLed

in_cloudButton

Library Components

The Library section is where you can find various pre-written codes or functions specific to PLC operations. It could include libraries for handling several industrial protocols, dealing with specific types of I/O, or even specialized functions for certain control systems. It makes the development process more efficient by providing ready-to-use codes, saving time and effort.

In the context of the PLC IDE, the libraries will need to be added manually under the

Sketch Libraries

Once the libraries are in place within

Sketch Libraries

These libraries are indexed. Thus, they are certified to guarantee optimized performance and reliability. Leveraging them will speed up your development process and increase the robustness of your applications for industrial environments. It may seem like an extra step, but it will help you keep code cleaner, more reliable, and more maintainable.

For more information about managing libraries inside PLC IDE, please have a look at "Library Management" section from the Programming Introduction with Arduino PLC IDE.

Arduino Sketch

We can now build the Arduino sketch that will be used to establish communication with the Arduino Cloud and manage data traffic. The base sketch will be needed and can be found as discussed in the 'Setting Up the Arduino Cloud' section.

Most of the code will keep the same structure contrary to the

loop()

onCloudButtonChange()

PLCOut.Shared_Variable

PLCIn.Shared_Variable

Beginning with the

loop()

1void loop() {
2  ArduinoCloud.update();
3   
4  analog01 = PLCOut.out_analog01;
5  counter = PLCOut.out_counter;
6}

The

loop()

analog01

counter

out_analog01

out_counter

PLCOut

This means that the PLC program, which captures the analog port reading and updates the counter value, is defined to bring the data to the Arduino sketch layer and update the Cloud variables accordingly. The Arduino Cloud dashboard then displays updated information after the

ArduinoCloud.update()

analog01

counter

The

onCloudButtonChange()

1/*
2  Since CloudButton is READ_WRITE variable, onCloudButtonChange() is
3  executed every time a new value is received from IoT Cloud.
4*/
5void onCloudButtonChange()  {
6  // Add your code here to act upon CloudButton change
7  PLCIn.in_cloudButton = cloudButton;
8}

The process involves assigning the updated Cloud variable value to the

PLCIn.in_cloudButton

PLCIn

in_cloudButton

Consequently, you will have an Opta™ constantly exchanging information with the Arduino Cloud. The complete code for the Arduino sketch is as follows:

1#include <ArduinoIoTCloud.h>
2#include <Arduino_ConnectionHandler.h>
3
4const char SSID[]     = "NETWORK_SSID";    // Network SSID (name)
5const char PASS[]     = "NETWORK_PASS";    // Network password (use for WPA, or use as key for WEP)
6
7void onCloudButtonChange();
8
9bool cloudButton;
10float analog01;
11int counter;
12
13WiFiConnectionHandler ArduinoIoTPreferredConnection(SSID, PASS);
14
15void setup() {
16  // Initialize serial and wait for port to open:
17  Serial.begin(9600);
18  // This delay gives the chance to wait for a Serial Monitor without blocking if none is found
19  delay(1500); 
20
21  // Defined in thingProperties.h
22  initProperties();
23
24  // Connect to Arduino Cloud
25  ArduinoCloud.begin(ArduinoIoTPreferredConnection);
26  
27  /*
28     The following function allows you to obtain more information
29     related to the state of network and IoT Cloud connection and errors
30     the higher number the more granular information you’ll get.
31     The default is 0 (only errors).
32     Maximum is 4
33 */
34  setDebugMessageLevel(2);
35  ArduinoCloud.printDebugInfo();
36}
37
38void loop() {
39  ArduinoCloud.update();
40  
41  analog01 = PLCOut.out_analog01;
42  counter = PLCOut.out_counter;
43}
44
45void initProperties(){
46  ArduinoCloud.addProperty(cloudButton, READWRITE, ON_CHANGE, onCloudButtonChange);
47  ArduinoCloud.addProperty(counter, READ, ON_CHANGE, NULL);
48  ArduinoCloud.addProperty(analog01, READ, ON_CHANGE, NULL);
49}
50
51/*
52  Since CloudButton is READ_WRITE variable, onCloudButtonChange() is
53  executed every time a new value is received from IoT Cloud.
54*/
55void onCloudButtonChange()  {
56  // Add your code here to act upon CloudButton change
57  PLCIn.in_cloudButton = cloudButton;
58}

The

NETWORK_SSID

NETWORK_PASS

NETWORK_SSID

NETWORK_PASS

PLC Program

The Arduino sketch is ready, and now we need a PLC program that will control the onboard features of Opta™ and data readings.

The PLC program will do the following processes:

• Run a linear counter and store to

  cnt

  , and pass the data to

  out_counter

  (Shared variables)
• Reset counter value when it reaches 2500 in its value
• Update the user programmable LED state of Opta™ based on

  in_cloudButton

  (Shared variables)
• Update analog reading on the port number one defined to

  analog01

  and pass it to

  out_analog01

  (Shared variables)

The following code delivers the previous tasks:

1cnt := cnt + 1;
2out_counter := cnt;
3
4IF out_counter >= 2500 THEN
5    cnt := 0;
6END_IF;
7
8userLed := in_cloudButton;
9
10out_analog01 := analog01;

With this PLC program, we are all set to configure the Opta™ device's internal processes and use Arduino Sketch to establish a connection with the Arduino Cloud.

We will set the present PLC program as a 'Fast Task' for good practice. It can be done by adding the

main

Tasks -> Fast

Project

Arduino Cloud Dashboard

The Arduino Cloud dashboard can be designed to your preference. The following image shows a dashboard example that allows for controlling the user programmable LED and displaying information received from Opta™.

More information about Arduino Cloud & how to create dashboards can be found here.

Testing PLC IDE with Arduino Cloud

The complete example project file for PLC IDE can be downloaded here. It is ready to use with Opta™ in the instance at the preferred workspace.

The first compilation process may take some time to finish. Depending on the environment and hardware, it can take around 7 minutes or more.

Once we have successfully configured Opta™ with PLC IDE and established communication with the Arduino Cloud dashboard, we have the following tasks in action:

• The Arduino Cloud dashboard displays the analog port number one reading and counter value of the connected Opta™
• The user programmable LED of Opta™ can be controlled using the button found within the Arduino Cloud dashboard

The animation below shows a simple active desktop dashboard:

The mobile dashboard is also available if on-demand monitoring and actuation is needed:

If Opta™ fails to communicate with the Arduino Cloud after configuration, please use the

WiFiFirmwareUpdater

Conclusion

You have now set an Opta™ using PLC IDE and successfully connected to the Arduino Cloud platform. You learned how these tools integrate and can be used to create a simple interface allowing you to oversee the Opta™ device's status. Now that you are more familiar with the PLC IDE and Arduino Cloud environment, you have the base to create HMI interfaces that can be used to control and monitor your Industrial Arduino Pro devices.

Next Steps

As you progress, feel free to dig into the vast Arduino ecosystem. To better understand the Arduino PLC IDE, consider reviewing the available tutorials.

Support

If you encounter any issues or have questions while working with the PLC IDE or Arduino Cloud, we provide various support resources to help you find answers and solutions.

Help Center

Explore our Help Center, which offers a comprehensive collection of articles and guides for the PLC IDE or Arduino Cloud. The Arduino Help Center is designed to provide in-depth technical assistance and help you make the most of your device.

• Arduino help center page

Forum

Join our community forum to connect with other PLC IDE and Arduino Cloud users, share your experiences, and ask questions. The forum is an excellent place to learn from others, discuss issues, and discover new ideas and projects related to PLC IDE and Arduino Cloud.

• The PLC IDE and Arduino Cloud in the Arduino Forum

Contact Us

Please get in touch with our support team if you need personalized assistance or have questions not covered by the help and support resources described before. We're happy to help you with any issues or inquiries about the PLC IDE and Arduino Cloud.

• Contact us page