Documentation

Getting started with WiFi on Arduino® Hardware

This example shows how to use Simulink Support Package for Arduino hardware to receive and send TCP/IP or UDP messages over WiFi using Arduino boards.

Supported Board:

  • Arduino Leonardo

  • Arduino Mega 2560

  • Arduino Mega ADK

  • Arduino Uno

  • Arduino Due

  • Arduino MKR1000

Available versions of this example:

Arduino Mega 2560 board with WiFi Shield:

The provided model is pre-configured for Arduino Mega 2560 with a WiFi Shield. It 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.

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

  • WiFi Shield / ESP8266

  • USB cable

Note that Arduino MKR1000 has an on-board WiFi chip so no need to connect a WiFi Shield or ESP8266.

Configuring WiFi hardware

In this task, you will configure the WiFi hardware. The WiFi functionality can be used with Simulink Support Package for Arduino hardware by either of the following:

Arduino board with WiFi Shield

1. Connect the WiFi Shield on the Arduino board.

2. Connect a USB cable from the PC to the Arduino board.

For more details on connecting the Arduino to WiFi Shield, refer to Connect Arduino WiFi Shield to Arduino Hardware in the documentation.

Arduino board with ESP8266

1. Connect the ESP8266 to the Arduino board.

2. Connect a USB cable from the PC to the Arduino board.

For more details on connecting the Arduino to ESP8266, refer to Connect ESP8266 to Arduino Hardware in the documentation.

Arduino MKR1000 board

1. Connect a USB cable from the PC to the Arduino MKR1000 board.

The Arduino MKR1000 has an on-board WiFi chip. It can be used directly without any additional WiFi hardware.

Configure Network Properties for Host Machine and WiFi hardware

For configuring the IP Address for the host machine and the WiFi hardware refer the following sections :

Configure Network Settings for WiFi

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 over WiFi using Arduino Hardware

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

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 IP address and port number are matching the WiFi 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 (a ramp signal and a pulse) being sent from the target hardware.

Task 3 - Receiving TCP/IP Data over WiFi with Arduino Hardware

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

Models involved in the demo

1. Target model running on the Arduino hardware: 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 WiFi settings earlier specified to ensure that the data is sent to the correct target hardware.

2. The target model running on Arduino board 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. Note that the WiFi TCP /IP Receive block is operating in blocking mode as Advanced > Wait until data received checkbox is checked. So when there is no incoming data you can see print statements in serial monitor or hyperterminal are slower.

4. 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 print statements in serial monitor or hyperterminal as soon as the target receives data i.e. no blocking.

Task 4 - Sending UDP Data over WiFi using Arduino Hardware

This example shows how to use Simulink Support Package for Arduino hardware to send UDP messages over WiFi using an Arduino board.

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 WiFi 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 (a ramp signal and a pulse) being sent from the target hardware.

Task 5 - Receiving UDP Data over WiFi using Arduino Hardware

This task shows how to use Simulink Support Package for Arduino hardware to receive UDP messages over WiFi using an Arduino board.

Models involved in the demo

1. Target model running on the Arduino Mega 2560: Arduino Mega 2560 UDP Receive.

2. Simulink host model: UDP Host Send.

Run the model configured for the target on the hardware

1. Open the Arduino Mega 2560 UDP Receive model.

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

3. In your Simulink model, click the Run button on the toolbar to run the model in External mode.

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 WiFi settings specified earlier to ensure that the data is sent to the correct target hardware.

2. The target model running on the Arduino hardware will receive data from UDP. In External mode you can see the data and size displayed on the Display blocks. Initially when no data is received Data and Size both are 0.

3. In the Simulink host model, click the Run button to start running the host model. Note that this model sends an array of int16 values.

4. At this point, UDP data is sent from the host to the target. You can see that the Data and Size output values changing corresponding to the received data.

Summary

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

Was this topic helpful?