Buy from US Buy from UK Buy from DE Buy from IT Buy from FR Buy from ES ここでご購入を!

In Lesson 1, we learned how to use the OSOYOO Basic Main board to make a simple web server and display “Hello World” in your remote browser. This uses a protocol called HTTP to exchange data with the remote client device (browser).

In this lesson, we will teach you to use a very simple and powerful protocol called UDP, which is commonly used for email service and control signal. We will use a cell phone app to turn on/off an LED in the IDE remotely through the UDP protocol.

OSOYOO Basic board x 1

OSOYOO ESP8266 Wi-Fi Shield x 1

USB cable x 1

LED x 1

200 ohm resistor x 1​

First, please insert the ESP8266 Wi-Fi Shield into your Basic Board

Make sure the jumper cap is connected from E_TX to D4 and E_RX to D5.

Then connect the long pin of the LED to D13 in the Wi-Fi shield through a 200 ohm resistor, and the short pin to GND. The circuit is shown below

Step A: Install the latest IDE (If you have IDE version after 1.1.16, please skip this step).

Download the IDE from, then install the software.

Step B: Connect the OSOYOO Basic Board to the computer via USB cable.

Step C: Open the IDE and choose the corresponding board type and port type for your project.

Step D: Download the sketch file from:

Unzip the downloaded file and enter the folder “esp8266-lesson2”.

Step E: In the IDE, click “File” ⇾ click “Open” ⇾ choose code “esp8266-lesson2” and load up the sketch onto your IDE.

In the sketch, find the following lines:

char ssid[] = "******"; // your network SSID (name)
char pass[] = "******"; // your network password
Please replace the "******" with your correct Wi-Fi SSID and password, otherwise your project 
cannot connect to the internet.

Step F: Now upload the sketch to the board and open your Serial Monitor. You can see that your router will assign an IP address to your IDE as following:

In the above example, “” is the IP address of my ESP8266 Wi-Fi Shield, and we need to set this IP address in our app in the next step.

Step G: Install the UDP send mobile app. You can use any UDP send app to run this lesson. In this lesson, we use the “OSOYOO IOT UDP Robot” app to make the test. In Google Play or Apple Store, please search for the keywords “OSOYOO IOT UDP Robot app”, and you will find a red icon app.(If you can not find this APP in Google Play,
you can directly download the APP from following link:

Make sure your cell phone is on the same local network as the Arduino. Open the app, click “Settings”, enter your Arduino IP address from Step F and port to “8888” in the settings

In the app UI screen, click “F1” button, your LED will turn on. Then click “F2” button, your LED will turn off.

After you click the cell phone button, the Arduino Serial monitor will also show your cell phone’s IP address as follows:

Please write down this IP address, as we will use it in the next lesson.

FAQs about the Wi-Fi UDP app and sketch code:

Q1) What happens when you press buttons in the OSOYOO Wi-Fi UDP Robot Car app?

A: When you press a button in the app, the app will send a single-letter message through the UDP protocol to the target device (in this example, our Wi-Fi Shield).

Button UDP message
F1 F
F2 G
F3 H
F4 I
F5 J
F6 K

Q2: How do you react to the app command?

A: In Our sample code (esp8266-lesson2.ino) lines 69 to 76, the switch statement handles the remote UDP command.

      switch (c)    //serial control instructions
        case 'F': digitalWrite(ledPin, HIGH) ;break; //TURN ON LED
        case 'G':digitalWrite(ledPin, LOW) ;break; //TURN OFF LED

In the above code lines, variable “c” is the message we got from the mobile app. If the message is “F”, it means the F1 key is pressed, and we should turn on the LED. If the message is “G”, it means F2 is pressed, and we need to turn off the LED.

Learn More about parts

No. Picture Product Name Link
1 OSOYOO basic board
2 OSOYOO Wi-Fi shield
3 Photoresistor Sensor Module
4 Water Level Detection Sensor
5 Sound Detection Sensor Module
6 Ultrasonic sensor
7 Servo motor
8 Active Buzzer Module
9 Temperature&Humidity Sensor
10 Relay Module
11 Gas Sensor Module
12 Digital Barometric Pressure Sensor Module
13 Infrared Sensor Module
14 LED(6 x White, 6 x Red, 6 x Yellow, 6 × Green)