ARDUINO IDE

Industrial Arduino IDE is the Original platform to program Arduino boards. This cross-platform application is available on Windows, macOS and Linux and under the GNU General Public License. Arduino IDE supports C and C++ code structuring.

Industrial Shields recommend using Arduino automation IDE to program Arduino Based PLC controllers, but any Arduino compatible software are compatible with Industrial Shields Controllers.

Apart from that, Industrial Shields bring the possibility to select your Arduino based industrial PLC into your Arduino IDE and compile your sketches
for the different PLC’s.

Download the Arduino IDE 1.8.6:

Windows Installer

MAC OSX

Install Industrial Shields units to Arduino IDE:

Industrialshields boards

POWER SUPPLY

All industrial Arduino PLC’s can be powered between 12-24V. Both, M-Duino family and Ardbox family, have a consumption between 700mA and 1500mA.

So, the recommended power supply is 2A or higher. Any Industrial power supply will be a good choice to power supply them.

REMEMBER: Out units are designed to be powered between 12-24V. Just powering them with the USB, the unit will not be able to perform their features. USB is just to program the PLC’s not to power them.

If for some reason you would like to use a power supply lower that 1,5A contact with Industrial Shields technical support to ensure that your system will complete your functionalities without any power issue.

Next is showed a simple diagram to see how to power supply any Industrial Shields unit.

SWITCH

Ardbox Analog has three different switch areas: LEFT ZONE, TOP ZONE and RIGHT ZONE.

Left Zone:

SWITCH	ON	OFF
I0.8 / RS-485 DE	I0.8	RS-485 DE
RS-485 DE / I0.8	RS-485 DE	I0.8
I0.9 / RS-485 RE	I0.9	RS-485 RE
RS-485 RE / I0.9	RS-485 RE	I0.9
SDA-PIN2 / I0.0	SDA - PIN2	I0.0
SCL-PIN3 / Q0.6	SCL - PIN3	Q0.6

6. I0.8 / RS-485 DE – If this switch is ON the RS-485 DE is activated, otherwise the I0.8 will be activated.

5. RS-485 DE / I0.8 – If this switch is ON the I0.8 is activated, otherwise the RS-485 DE will be activated.

Note* To work with RS-485 DE, switch number 6 at ON and number 5 at OFF.

4. I0.9 / RS-485 RE – If this switch is ON the RS-485 RE is activated, otherwise the I0.9 will be activated.

3. RS-485 RE / I0.9 – If this switch is ON the I0.9 is activated, otherwise the RS-485 RE will be activated.

Note* To work with RS-485 RE, switch number 4 at ON and number 3 at OFF.

2. SDA-D2/I0.0 – If this switch is ON the I0.0 is activated, otherwise the (I2C) SDA-D2 will be activated.

1. SCL-D3/Q0.6 – If this switch is ON the (I2C) SCL-D3 is activated, otherwise the (I2C) SDA-D2 will be activated.

Top Zone:

SWITCH	OFF	ON
Q0.8	RS485/RS232 HS	I0.3
RS*	I0.3	RS485/RS232 HS
Q0.9	RS485/RS232 HS	I0.2
RS*	I0.2	RS485/RS232 HS

1. Q0.8 / RS* - If this switch is ON the RS* is activated, otherwise the Q0.8 will be activated.

2. RS*/ Q0.8 - If this switch is ON the Q0.8 is activated, otherwise the RS* will be activated.

3. Q0.9 / RS* - If this switch is ON the RS* is activated, otherwise the Q0.9 will be activated.

4. RS* / Q0.9 - If this switch is ON the Q0.9 is activated, otherwise the RS* will be activated.

Note* RS * can be RS-485 or RS-232 depending on the jumper configuration you have chosen. To work with RS*, switches number 1 and 3 at ON and number 4 and 2 at OFF.

Right Zone

SWITCH	OFF	ON
H/F	FULL DUPLEX	HALF DUPLEX
Q0.6	ANALOG (A0.6)	DIGITAL (Q0.6)
Q0.5	ANALOG (A0.5)	DIGITAL (Q0.5)
Q0.4	ANALOG (A0.4)	DIGITAL (Q0.4)
Q0.3	ANALOG (A0.3)	DIGITAL (Q0.3)
Q0.2	ANALOG (A0.2)	DIGITAL (Q0.2)
Q0.1	ANALOG (A0.1)	DIGITAL (Q0.1)
Q0.0	ANALOG (A0.0)	DIGITAL (Q0.0)

RIGHT ZONE. The right zone configures the outputs. If the switch is set to “ON” the Q0.X will have the behaviour of a digital output. If it is set to “OFF” it will be analog. There is also a switch for switching between Half and Full Duplex. It is “ON” for Half Duplex and “OFF” for Full Duplex.

JUMPERS CONFIGURATION

The jumper zone makes the selection between using the RS-485 Full Duplex or the Analog Outputs. When purchase Ardbox Analog you must select if you want to use RS232 or RS485. Both units are the same, but they come as default with different jumper configuration.
As you can see in the prevous picture, Ardbox Analos has two jumper ZONEs.

Zone 1:

LEFT	RIGHT
RS-485	RS-485
D0	D1
RS-232	RS-232

This jumper makes the choosing between connecting MAX232 to pins 0,1 of the Arduino Leonardo or with the MAX485. In order to use the RS-232 Hardware Serial protocol both RS-232 must be connected to the D1/D0. In order to use the RS-485 Hardware Serial protocol both RS-485 must be connected to the D1/D0.

Zone 2:

LEFT	RIGHT
I0.2	I0.3
D4	D8
RS-232 SS	RS-232 SS

This jumper zone makes the choosing between connecting the inputs I0.2, I0.3 to pins 4 and 8 of the Arduino Leonardo respectively, or connect the RS-232 ports to activate the Software Serial RS-232. In order to use the inputs I0.2,I0.3 the jumper must be connected to the pins 4 and 8. So I0.2 must be connected with D4 and I0.3 must be connected to D8.

INPUTS
/OUTPUTS

ANALOG INPUTS

Voltage variation between –Vcc (or GND) and +Vcc, can take any value. An analog input provides a coded measurement in the form of a
digital value with an N-bit number. In Digital and Analog I/O there’s self insulation, so its posible to connect them in a different power supply
than 24 V.

Inputs: (8x) of 10x, Analog (0-10Vdc) configurable by Software.

TYPICAL CONNECTION

DIGITAL INPUTS

Voltage variation from –Vcc (or GND) to +Vcc, with no intermediate values. Two states: 0 (-Vcc or GND) and 1 (+Vcc). In Digital and Analog I/O there’s self insulation, so its posible to connect them in a different power supply than 24 V.

Inputs: (10x) Digital (5-24Vdc).

TYPICAL CONNECTION

- Digital Isolated Input

- Digital No Isolated Input

INTERRUPT INPUTS

Interrupt Service Rutine. A mechanism that allows a function to be associated with the occurance of a particular event. When the event
occurs the processor exits immediately from the normal flow of the program and runs the associated ISR function ignoring any other task.

Inputs: (1x) Interrupt Inputs (5-24Vdc). “Can work like Digital Input (24Vdc)”.

Ardbox Pin	Arduino Leornardo Pin	Switch
I0.0 (INT0)	2	SDA-D2/I0.0 at OFF Position

TYPICAL CONNECTION

EXAMPLE

In this example we activate INT0 using pin I0_0 from M-duino board. When there’s a change

#define INTERRUPT I0_0 //I0_3, I0_2, I0_1, I0_0 (Ardbox)

volatile bool state = false;

void setup() {
  pinMode(INTERRUPT, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(INTERRUPT), function_call_back, CHANGE);
}

void loop() {
  if (state == true){
    Serial.println("Interrupt activated");
    state = false;
  }
}

void function_call_back(){ //Change led state
  state = true;
}

ANALOG OUTPUTS

Voltage variation between –Vcc (or GND) and +Vcc, can take any value. An analog input provides a coded measurement in the form of a digital value with an N-bit number. In Digital and Analog I/O there’s self insulation, so its posible to connect them in a different power supply than 24 V.

Outputs: (7x) of 10x, Analog 0-10V output. configurables by Switch.

TYPICAL CONNECTION

DIGITAL OUTPUTS

Voltage variation from –Vcc (or GND) to +Vcc, with no intermediate values. Two states: 0 (-Vcc or GND) and 1 (+Vcc). In Digital and Analog I/O there’s self insulation, so its posible to connect them in a different power supply than 24 V.

Outputs: (10x) Digitals isolated (5 to 24Vdc)/ (6x) of 10x, PWM (5 to Vdc) configurables by Switch1.

TYPICAL CONNECTION

PWM OUTPUT

Pulse Width Modulation. Activate a digital output for a while and keep it off for the rest. The average output voltage, over time, will be equal to the desired analogue value. The frequency between pulse is the same while the pulse width is changed. Attention : A PWM Output gives a
Vcc value during a certain time. So, during a percent time is 5v and the rest of time is 0V. If we supply a device which needs 3v, we can damage
it.

Ardbox Pin	Arduino Pin
Q0.6	3
Q0.5	5
Q0.4	6
Q0.3	9
Q0.2	10
Q0.1	11
Q0.0	13

- Q0.0, Q0.1, Q0.2, Q0.3, Q0.4, Q0.5 and Q0.6 Digital/PWM out also as A0.0, A0.1, A0.2, A0.3, A0.4, A0.5 and A0.6 Analog out.

To use the Digital/PWM configuration pins (QX.X) you have to turn On the switch below:

The image below shows the PWM OUTPUT from Arduino (color blue 5V) and the PWM OUTPUT from the M-Duino or Ardbox board (color yellow 24V) :

TYPICAL CONNECTIONS

Module Pulses from Tools40 library

The Pulses module provides functions for starting and stopping a train of pulses at the desired frequency using PWM pins. The

startPulses(pin, frequency, precision) function starts the train of pulses at the specified frequency and precision. The default frequency is 1kHz and the default precision is 3.

pinMode(3,OUTPUT);
startPulses(3,2000,3);

The stopPulses(Pin) function stops the train of pulses.

stopPulses(3);

IMPORTANT: It is not possible to have different frequencies between the same TIMER Pin’s. Some outputs share the same timer, so they work at the
same frequency.

CAUTION!!! When the TIMER0 pins are used, all the time functions change their functionality as delay() , millis() , micros() , delayMicroseconds() and others.

Next it is showed recommended precision between different frequencies:

Precision	Frequency Range (Hz)
1	30 - 150
2	150 - 500
3	500 - 4k
4	4k - 32k
5	32k - 4

To have a high precision on the desired frequency, it is recommended to use the closer precision to the values of the previous table. Example Code

RS-485

RS-485 also known as TIA-485(-A), EIA-485, is a standard defining the electrical characteristics of drivers and receivers for use in serial communications systems. Electrical signaling is balanced, and multipoint systems are supported.

Our Arduino Based PLCs incorporate the integrated circuit MAX485.

MAX485 is a low-power and slew-rate-limited transceiver used for RS-485 communication . It works at a single +5V power supply and the rated current is 300 μA. Adopting half-duplex communication to implement the function of converting TTL level into
RS-485 level, it can achieve a maximum transmission rate of 2.5Mbps. MAX485 transceiver draws supply current of between 120μA and 500μA under the unloaded or fully loaded conditions when the driver is disabled.

There is internally installed a half duplex MAX485 and MAX485 transmitter . If you are working on full duplex you will use the
MAX485 half duplex to receive data and MAX485 transmitter to send the data.

Hardware

Switch configuration

In order to enable the Hardware Serial RS-485 the total configuration of the Ardbox Analog HF will be:

TOP ZONE:

SWITCH	MODE
I0.3	OFF
RS485 HS	ON
I0.2	OFF
RS485 HS	ON

Note: Having this setup, I0.2 & I0.3 are disabled.

LEFT ZONE:

SWITCH	MODE
DE-RS485	ON
D10 / A0.2 - Q0.2	OFF
RE-RS485	ON
D11 / A0.1 - Q1.1	OFF
SDA - D2 / I0.0	-
SCL - D3 / Q0.6	-

Note: In order to enable the RS-485 communication protocol it is necessary that the switches of the left zone are configured as it is showed in the table. The

ones marked with "-" mean that they don't affect the RS-485 protocol configuration.

Jumpers Configuration

In order to enable the Hardware Serial RS-485 the total configuration of the Ardbox Analog HF will be:

Available communications protocol & connections u sing this jumpers configuration :

Hardware Serial RS-485.
I2C * If I2C is active, I0.0 & I0.6 are disabled.
SPI
TTL
USB
Inputs: 8 out of 10 inputs, I0.0, I0.1 & I0.4 to I0.9. * If using I2C, I0.0 is also disabled.
Digital outputs: 9 of 10 outputs, Q0_2 is disabled. * If using I2C, Q0.6 is disabled.
Analog Outputs: 5 of 6 outputs. A0_2 is disabled * If using I2C A0.6 is disabled.

Software

IMPORTANT: Make sure to download the Arduino based PLC boards for Arduino IDE.

Software Configuration:

Once the hardware configuration is done, it's possible to proceed with the software configuration and also its usage. Firstable it's
necessary to include the RS485.h library provided in our boards.

#include <RS485.h>

To check if the RS-485 port is working it is easy to use the serial monitor from the Arduino IDE using the right sentence inside the
setup() function:

Serial.begin(9600);

Then don’t forget to implement the proper initialization of your communication on the setup() function.

RS485.begin(38400);

NOTE: Check the velocity of transmission between the PLC and the Laptop and from the PLC to the device connected by RS-485.

Example Codes

Basic RS-485 write example (send):

// Include Industrial Shields libraries
#include <RS485.h>

//// IMPORTANT: check switches configuration

////////////////////////////////////////////////////////////////////////////////////////////////////
void setup() {
  // Begin serial port
  Serial.begin(9600);

  // Begin RS485 port
  RS485.begin(38400);
}

////////////////////////////////////////////////////////////////////////////////////////////////////
void loop() {
  // Wait bytes in the serial port
  if (Serial.available()) {
    byte tx = Serial.read();

    // Echo the byte to the serial port again
    Serial.write(tx);

    // And send it to the RS-485 port
    RS485.write(tx);
  }
}

Basic RS-485 read example (receive):

// Include Industrial Shields libraries
#include <RS485.h>

//// IMPORTANT: check switches configuration

////////////////////////////////////////////////////////////////////////////////////////////////////
void setup() {
  // Begin serial port
  Serial.begin(9600);

  // Begin RS485 port
  RS485.begin(38400);
}
////////////////////////////////////////////////////////////////////////////////////////////////////
void loop() {
  // Print received byte when available
  if (RS485.available()) {
    byte rx = RS485.read();

    // Hexadecimal representation
    Serial.print("HEX: ");
    Serial.print(rx, HEX);

    // Decimal representation
    Serial.print(", DEC: ");
    Serial.println(rx, DEC);
  }
}

Basic RS-485 full-duplex example:

* Remember that to test the full duplex with your Ethernet PLC you must connect the A, B (receivers) to the Y, X(transmitters).

// Include Industrial Shields libraries
#include <RS485.h>
//// IMPORTANT: check switches configuration
//// IMPORTANT: Full duplex mode is only available when device supports it
////////////////////////////////////////////////////////////////////////////////////////////////////
void setup() {
  // Begin serial port
  Serial.begin(9600);
  // Begin RS485 port
  RS485.begin(38400, FULLDUPLEX);
}

////////////////////////////////////////////////////////////////////////////////////////////////////
void loop() {
  // Wait bytes from the RS-485
  if (RS485.available()) {
    byte tx = RS485.read();
    // In full-duplex mode it is possible to send and receive data
    // at the same time in a secure way
    RS485.write(tx);
    // Echo the byte to the serial port
    Serial.write(tx);
  }
}

RS-232

RS-232 protocol formally defines the signals connecting between DTE (Data Terminal Equipment) such as a computer terminal, and DCE (Data Circuit-terminating Equipment or Data Communication Equipment), such as a modem.

Our Arduino Based PLCs incorporate the integrated circuit MAX232 .

MAX232 converts signals from to TIA-232 (RS-232) serial port to signals suitable for use in TTL-compatible digital logic circuits. The MAX232 is a dual transmitter / dual receiver that is used to convert the RX, TX, CTS, RTS signals.

Hardware

IMPORTANT: Make sure that your Ethernet PLC is powered (12-24Vdc).

Switch configuration:

Technical Details

PLC Arduino Spartan 21 I/O Analog / Digital

Initial Installation

ARDUINO IDE

POWER SUPPLY

SWITCH

Left Zone:

Right Zone

JUMPERS CONFIGURATION

Zone 1:

Zone 2:

Inputs & Outputs

ANALOG INPUTS

DIGITAL INPUTS

INTERRUPT INPUTS

TYPICAL CONNECTION

ANALOG OUTPUTS

DIGITAL OUTPUTS

PWM OUTPUT

TYPICAL CONNECTIONS

Module Pulses from Tools40 library

Communications

RS-485

TOP ZONE:

LEFT ZONE:

Jumpers Configuration

Basic RS-485 full-duplex example:

RS-232

Hardware