MATLAB Examples

Using Ethernet Shield with Arduino® Hardware

This example shows how to use Simulink Support Package for Arduino hardware to receive and send TCP/IP or UDP messages using an Arduino with an Ethernet Shield.

Supported Hardware:

  • Arduino Leonardo
  • Arduino Mega 2560
  • Arduino Mega ADK
  • Arduino Uno
  • Arduino Due

Available versions of this example:

Arduino Mega 2560 board:

The provided model is pre-configured for Arduino Mega 2560 and can be run on any of the board listed in the "Supported Hardware" section, by changing the "Hardware board" parameter in the configuration parameters dialog box of the model as described in Task 1 of this example.

Contents

Introduction

Simulink Support Package for Arduino hardware enables you to create and run Simulink® models on Arduino board. The target includes a library of Simulink blocks for configuring and accessing Arduino sensors, actuators, and communication interfaces.

In this example you will learn how to create Simulink models receiving TCP/IP or UDP messages from a remote host and sending TCP/IP or UDP messages to a remote host, identified with a unique IP address and port number.

The host model uses the blocks from the Instrument Control Toolbox to send and receive TCP/IP or UDP messages to the target hardware.

Prerequisites

We recommend completing Getting Started with Arduino hardware example.

Required Hardware

To run this example you will need the following hardware:

  • Supported Arduino board
  • Ethernet Shield
  • USB cable
  • RJ45 cable (Straight/Cross) based on whether connecting to router/PC.

Connect the Ethernet Shield to Arduino Mega 2560 Board

In this task, you will connect your Ethernet Shield to the Arduino Mega 2560 board

1. Connect the Ethernet Shield on the Arduino Mega 2560 board.

2. Connect a USB cable from the PC to the Arduino Mega 2560 hardware.

For more details on connecting the Arduino Mega 2560 to Ethernet Shield, refer to Connecting Arduino Ethernet Shield to Arduino in the documentation.

Configure the Network Properties for the Host Machine and the Ethernet Shield

Refer to Configure network settings for Arduino Ethernet shield section of the documentation to configure the IP Address for the host machine and the Ethernet Shield.

Task 1 - Configure the Model for Supported Arduino Hardware

You will perform this task if your Arduino board is not Arduino Mega 2560 hardware.

In this task, you will configure the model for the supported Arduino board.

1. In your Simulink model, click Simulation > Model Configuration Parameters to open Configuration Parameters dialog.

2. Select the Hardware Implementation pane and select your required Arduino hardware from the Hardware board parameter list. Do not change any other settings.

3. Click OK.

Task 2 - Sending TCP/IP data with Arduino and Ethernet Shield

This example shows how to use Simulink Support Package for Arduino hardware to send TCP/IP messages using an Arduino board with an Ethernet Shield.

Models involved in the demo

1. Target model running on the Arduino hardware: Arduino TCP/IP Send

2. Simulink host model: TCP/IP Host Receive

Run the Model configured for the target on the hardware

1. Open the Arduino TCP/IP Send model.

2. Perform Task 1 if your Arduino board is not Arduino Mega 2560 hardware.

3. In your Simulink model, click the Deploy to Hardware button on the toolbar.

Run the host model to receive data from the target model

1. Open the TCP/IP Host Receive model. Double-click on the TCP/IP Receive block. Make sure that the port number is matching the Ethernet shield settings specified earlier to ensure that the data is received from the correct target hardware.

2. In the Simulink host model, click the Run button. The scope should display the data being sent from the target hardware.

Task 3 - Receiving TCP/IP Data with Arduino and Ethernet Shield

This task shows how to use Simulink Support Package for Arduino hardware to receive TCP/IP messages using an Arduino board with an Ethernet Shield.

Models involved in the demo

1. Target model running on the Arduino Mega 2560: Arduino TCP/IP Receive

2. Simulink host model: TCP/IP Host Send

Run the model configured for the target on the hardware

1. Open the Arduino TCP/IP Receive model.

2. Perform Task 1 if your Arduino board is not Arduino Mega 2560 hardware.

3. In your Simulink model, click the Deploy to Hardware button on the toolbar.

Run the host model to send data to the target model

1. Open the TCP/IP Host Send model. Double-click on the TCP/IP Send block. Make sure that the IP address and port number are matching the Ethernet shield settings specified earlier to ensure that the data is sent to the correct target hardware.

2. The target model running on Arduino hardware will receive data from TCP/IP and send it back to the serial port for monitoring and debugging. You can use a serial monitor or hyperterminal on the host machine to watch the serial data coming back from the target.

3. In the Simulink host model, click the Run button to start running the host model.

4. At this point, TCP/IP data is sent from the host to the target and serial data is sent back from the target to the host. You should be able to see the serial data on the host using a serial monitor or hyperterminal.

Task 4 - Sending UDP data with Arduino and Ethernet Shield

This example shows how to use Simulink Support Package for Arduino hardware to send UDP messages using an Arduino Mega 2560 board with an Ethernet Shield.

Models involved in the demo

1. Target model running on the Arduino hardware: Arduino UDP Send

2. Simulink host model: UDP Host receive

Run the Model configured for the target on the hardware

1. Open the Arduino UDP Send model.

2. Perform Task 1 if your Arduino board is not Arduino Mega 2560 hardware.

3. In your Simulink model, click the Deploy to Hardware button on the toolbar.

Run the host model to receive data from the target model

1. Open the UDP Host receive model. Double-click on the UDP Receive block. Make sure that the port number is matching the Ethernet shield settings specified earlier to ensure that the data is received from the correct target hardware.

2. In the Simulink host model, click the Run button. The scope should display the data being sent from the target hardware.

Task 5 - Receiving UDP Data with Arduino and Ethernet Shield

This task shows how to use Simulink Support Package for Arduino hardware to receive UDP messages using an Arduino board with an Ethernet Shield.

Models involved in the demo

1. Target model running on the Arduino hardware: Arduino UDP Receive

2. Simulink host model: UDP Host Send

Run the model configured for the target on the hardware

1. Open the Arduino UDP Receive model.

2. Perform Task 1 if your Arduino board is not Arduino Mega 2560 hardware.

3. In your Simulink model, click the Deploy to Hardware button on the toolbar.

Run the host model to send data to the target model

1. Open the UDP Host Send model. Double-click on the UDP Send block. Make sure that the IP address and port number are matching the Ethernet shield settings specified earlier to ensure that the data is sent to the correct target hardware.

2. The target model running on Arduino hardware will receive data from UDP and send it back to the serial port for monitoring and debugging. You can use a serial monitor or hyperterminal on the host machine to watch the serial data coming back from the target.

3. In the Simulink host model, click the Run button to start running the host model.

4. At this point, UDP data is sent from the host to the target and serial data is sent back from the target to the host. You should be able to see the serial data on the host using a serial monitor or hyperterminal.

Summary

This example showed you how to use Simulink Support Package for Arduino hardware to send TCP/IP or UDP messages to a remote host and to receive TCP/IP or UDP messages from a remote host using an Arduino board with an Ethernet Shield.